DSH Task Suite
DSH 任务流水线:让主 Agent 只调度,后台 subagent 干活,交付前机器重跑测试。
把 Claude 的 task-* 任务体系移植到 DeepSeek Harness:一份 Markdown 任务池、一套状态机、主会话调度、后台 worker、机器验收,以及一个只读的可视化面板。
它不是又一个 todo list。它解决的是「AI 说完成了,但没人验证」的问题:
- 任务池在磁盘上:
.dsh/tasks/*.md,人可以直接看、直接改,不锁在某个数据库里。 - 主 Agent 不自己埋头做:只负责和需求方对话、排期、派活、验收。
- 后台 subagent 独立交付:每个任务在全新上下文里完成,避免长会话污染。
- 机器验收:重跑项目测试、比对开工基线、审计测试是否被改弱,不采信 worker 的自述。
- git 可选:git 仓库用 commit/worktree 验收;普通目录自动降级为文件快照模式。
| 维度 | 普通任务列表 | DSH 任务流水线 |
|---|---|---|
| 谁干活 | 主 Agent 自己做 | 后台 subagent,独立上下文 |
| 验收 | 人工看报告 | 机器重跑测试 + 改动归属 |
| 存储 | 依赖 git/数据库 | Markdown 文件,git 可选 |
| 可视化 | 简单列表 | 任务 / Agent / 指标 / 事件流 |
| 适用 | 个人 todo | 多任务连续交付 |
60 秒上手
task_init
task_add items=[{title: "给登录接口加限流", module: "backend", priority: "P1", acceptance: "pytest tests/test_auth.py 通过"}]
task_loop action=start max=3 hours=2
task_loop action=tick # 把返回的 worker_prompt 交给 subagent
# subagent 交付后:task_accept report="<报告块>" → task_confirm
然后从右侧栏 + 菜单或右下角 任务流水线 打开面板,看任务从「待开始」走到「待验证」。

上图是流程示意。下面是从真实会话截取的任务流水线面板:

面板包含任务池、Agent、指标和事件流;截图已裁掉本地工作区路径。更多状态截图待补录,规范见
docs/screenshots/README.md。
宣传画:自评 vs 机器验收 · 一条任务,四道关
安装
从 GitHub 源码安装(当前推荐):
dsh plugin --profile desktop add qiqll/dsh-task-suite
--profile必填:桌面版通常是desktop,Web 版是web;换成你实际使用的 profile 名。
npm 包发布后也可以直接按包名安装:
dsh plugin --profile desktop add dsh-task-suite
# Web profile 用 --profile web
桌面版也可以在 设置 → 插件 里搜索 dsh-task-suite 安装。
首次安装后必须完整退出并重新打开 DSH。 Web 客户端插件表在进程启动时组合,只刷新页面不会加载新插件的客户端部分;Host 工具和任务池不受影响。之后进入任意会话即可使用。
本地开发时把本目录 link: 到 profile 的依赖里;Host 代码可禁用/启用插件行热重载,客户端 UI 改动仍需重启一次。
Web 任务流水线
中文名:DSH 任务流水线。插件带一个只读面板,把任务池、当前 worker、门禁和运行指标集中到右侧栏。
打开方式(进入任意会话后):
- 右下角浮动按钮 任务流水线(最直接);
- 右侧栏顶部的 + 菜单 → 任务流水线。
面板每 5 秒刷新,包含:
- 循环状态:运行中 / 已停止 / 已叫停 / 空闲;
- 当前任务:
T-xxx、阶段、worker、已运行时间、快照/基线、门禁备注、inbox 数量; - 指标:完成率、一次通过率、7 日吞吐、中位周期(CLAIM → CONFIRM)、WIP、待验证;
- 任务清单:按状态筛选,点开看备注/依赖/验收标准;
- Agent:主 agent 与当前子 agent 的活动状态;
- 最近流水:运行日志里的 claim / done / confirm / reject / stop。
UI 依赖 dsh-better-sidebar,但它是软依赖:没有安装时任务工具、API、任务池全部正常,只是没有这个面板;Web 也不会因此启动失败。
数据来自插件注册的只读接口 GET /dsh-task-suite/state?sessionId=…&cwd=…,不会修改任务池。
插件市场
本插件按 awesome-dsh-plugin 的收录格式准备;市场卡片、安装与更新由该目录和 npm 版本驱动。
快速开始
task_init # 建 .dsh/tasks/(git 仓库里顺带写 .gitignore)
task_add items=[{title, module, priority, deps, acceptance, note}]
task_status # 全局视图 / 待决策 / 阻塞 / 流水
task_pick mode=manual task_id=T-001 # 手动单步,自己实施
task_accept report="<报告块>" # 机器验收
task_confirm task_id=T-001 conclusion="..." # 需求方确认后归档
自动循环(推荐):
task_loop action=start max=10 hours=8
task_loop action=tick # 返回 worker_prompt
# 把 worker_prompt 原样交给 subagent 工具;然后结束回合等完成通知
# 收到 worker 的最后一条消息后:
task_accept report="<整段报告块>"
# 通过 → 待验证;需求方确认 → task_confirm;不通过 → task_reject
task_loop action=tick # 派下一个
停机:task_loop action=stop reason="...";中途叫停:先 interrupt_agent 再
task_loop action=halt(保留提交,不回滚)。叫停后继续用 action=resume
(同一任务带断点重派),放回队列用 action=requeue。
状态与目录
.dsh/tasks/
├── backlog.md # 需求方入口:P0–P3 表、待决策、人工阻塞、ID 规则
├── dev-plan.md # AI 维护:当前批次、进行中、技术前置
├── dev-progress.md # 已完成归档(按月)
├── inbox/ # 需求方/调度方投递(task_*.json),merge 后移到 .merged/
└── auto/ # 运行时状态,整目录 gitignore
├── current.json # 当前任务:nonce / startSha / 脏文件 / 阶段
├── session.json # 循环会话:active / max / hours / done / noprog
├── run.log # 运行流水
├── STOP # 停机标记
└── snapshots/ # 非 git 模式:开工快照 + manifest(确认后删)
└── T-001-<nonce>/
├── manifest.json
└── files/
git 仓库里 task_init 会把 .dsh/tasks/ 加入 .gitignore;非 git 目录不创建 .gitignore。任务池是运行态,不进业务提交。
每个工作区独立一份池;默认不碰 Claude 的 .claude/ 池。
状态机:
待开始 → 进行中 → 待验证 → 已完成
└→ 阻塞 / 待决策 → 待开始
└→ 打回 → 进行中
同一时刻只允许一个「进行中」;P0 可中断(旧任务记断点)。
工具
| 工具 | 作用 | 关键参数 |
|---|---|---|
task_init |
初始化池 + .gitignore |
— |
task_add |
录入 1..N 条,自动判重/ID/依赖/验收 | items[], source |
task_status |
全局视图与下一步建议 | — |
task_list |
按状态/优先级/关键词筛选 | status, priority, query |
task_show |
单任务完整简报 | task_id |
task_pick |
认领任务;auto 返回 worker_prompt | mode(auto/manual), task_id, interrupt |
task_accept |
机器验收 worker 报告 | report, rollback |
task_confirm |
需求方确认 → 归档 | task_id, conclusion, gate |
task_reject |
需求方打回 → 待开始 | task_id, reason |
task_answer |
答复待决策/阻塞,回到待开始 | task_id, answer |
task_inbox |
投递需求/决策(worker 在跑时用) | type, text, title, ref |
task_merge |
立即合并 inbox | — |
task_loop |
循环状态机 | action, max, hours, reason |
task_verify |
只读重跑测试 + 基线比对 + 改弱审计 | test_cmd, start_sha |
task_audit |
只读审计提交归属/越界/脏文件/改弱 | start_sha, task_id |
task_loop 的 action:start / tick / stop / halt / resume / requeue / status。
Worker 报告契约
worker 最后一条消息只输出:
=== TASK-AUTO REPORT ===
NONCE: <current.json 的口令>
RESULT: DONE | NEEDS_DECISION | BLOCKED | BASELINE_RED | FAILED | GATE_PENDING_REVIEW
TASK: T-001
START_SHA: <开工 SHA>
COMMITS: <sha...>
TEST_CMD: <[cd dir &&] 单条测试命令 路径...>
TEST_RESULT: 基线 x passed, y failed → 交付后 z passed, w failed;既有失败:...
TEST_CHANGES: 仅新增 / 无改动 / 有修改(说明)
GATE: <code-reviewer H×n M×n;跳过原因;...>
ACCEPTANCE: <对照验收标准>
ASSUMPTIONS: — / ...
DECISION: — / 问题 / 选项 / 推荐
BLOCKER: — / ...
DERIVED:
- [P2] 标题 | 涉及文件 ... | 来源 ...
BRIEF:
给需求方的 1–3 句人话说明
=== END REPORT ===
task_accept 会校验 nonce、任务归属、阶段、提交信息里的任务 ID、脏文件、
测试范围与基线失败集合、测试是否被改弱、高风险路径;通过后把任务落到
「待验证」并生成衍生任务,失败则按 RESULT 进入待决策 / 阻塞 / 自动失败计数。
GATE_PENDING_REVIEW 时验收暂停在 review_pending:调度员自己看 start_sha..HEAD,
通过就再调用 task_accept 并传 review="pass: ..."(同一报告即可),验收继续;
不通过就把发现发回 worker 修复并重交。
两种基线模式
mode 默认 auto:能拿到 git HEAD 就用 git 模式,否则自动用文件模式;也可以强制 mode: file / mode: git。
| git 模式 | 文件模式(非 git 目录) | |
|---|---|---|
| 开工基线 | START_SHA |
auto/snapshots/<T-NNN>-<nonce>/ 全量快照 + manifest.json |
| 改动归属 | commit message 含任务 ID | 快照与当前目录的文件差异(新增/修改/删除) |
| 基线测试 | git worktree 回到 START_SHA |
快照复制到临时目录,回放开工时代码 |
| 回滚 | git reset --keep START_SHA + ref |
从快照恢复文件,恢复前再备份当前树 |
| 提交要求 | 每个 commit 带任务 ID | 不 commit;COMMITS: — |
| 局限 | 要求有 HEAD | 无法区分「谁改的」;快照占磁盘;依赖目录/构建产物被排除 |
快照默认排除 .git、node_modules、.venv/venv、__pycache__、dist/build、.dsh/tasks 等。项目很大时用 snapshotIgnore 排除更多目录,或调大 snapshotMaxBytes / snapshotMaxFiles。任务确认/打回后快照会删除,并默认只保留最近 10 份。
文件模式的 TEST_CMD、测试改弱审计、nonce、遗留文件检查与 git 模式完全一致;只是「提交归属」换成「快照差异归属」。
验收与防作弊
- nonce:每次 claim 生成一次性口令,旧报告/重复通知直接丢弃。
- 提交归属(git):
git log START_SHA..HEAD里每个 commit 的 message 必须含任务 ID;出现别人的 commit → 停下,不自动处理。 - 改动归属(文件):与开工快照比对,新增/修改/删除都列出;报告
CHANGES与实际不符会告警。 - 基线比对:当前测试失败时,在
git worktree的 START_SHA(git)或快照副本(文件)上重跑同一命令,只有「基线也失败」的用例才算既有失败;新失败 → 打回。 - 测试范围:
TEST_CMD必须是单条命令,禁止; | & $( > <与-k/--deselect/--ignore/--lf/--collect-only/--passWithNoTests; 改动/删除的测试文件必须落在命令路径参数覆盖范围内。 - 改弱审计:删除用例、移走文件、skip/xfail、注释断言、断言净减少、 测试配置 ignore 都会产生告警;DONE 带告警 → 转「待决策」。
- 高风险路径:认证、支付、迁移、部署、CI、依赖清单等;命中时要求报告写
GATE与ASSUMPTIONS,否则转人工 review。
配置
cordis.patch.yml 的 config 可覆盖:
| 键 | 默认 | 说明 |
|---|---|---|
stateDir |
.dsh/tasks |
相对项目根 |
testTimeoutSec |
900 |
单次测试超时 |
defaultMaxTasks |
10 |
循环最多交付数 |
defaultMaxHours |
8 |
循环最长小时数 |
maxNoprog |
3 |
连续无进展自动停机 |
maxDerivedPerParent |
3 |
单任务衍生上限 |
maxDerivedDepth |
2 |
衍生层级上限 |
mode |
auto |
auto / git / file;强制文件模式可让 git 仓库也走快照 |
snapshotIgnore |
[] |
额外排除的相对路径或 * glob |
snapshotMaxBytes |
536870912 |
单次快照体积上限(512MB) |
snapshotMaxFiles |
20000 |
单次快照文件数上限 |
snapshotKeep |
10 |
保留最近多少份快照 |
与 Claude 版的差异
- 状态目录是
.dsh/tasks/(DSH 独立运行态),不是.claude/。 - 调度用 DSH 的
subagent工具;没有内置心跳/cron,长循环可用schedule_create定时提醒主会话tick。 - 机器验收在原
verify_tests.sh/check_test_weakening.sh的基础上重写为 Node 实现,判定口径保持一致。 - 提供只读 Web 面板;
backlog.md仍是任务池的唯一事实来源。
开发自测
cd dsh-task-suite
node selftest.mjs
自测覆盖两种模式:
- git:建池/录入/解析、认领、报告解析、DONE 验收与归档、FAIL_NEW 基线比对、测试改弱、inbox、待决策、循环启停、halt/resume/requeue;
- 非 git:快照认领、快照差异归属、DONE 验收、FAIL_NEW 基线、测试改弱、失败回滚。
No comments yet. Be the first to write one.