前言¶
在 DeepSeek Harness（DSH）里交给 AI 的复杂任务，常见节奏是「边想边做」：做到一半才发现阶段划分不对、并行度不够，或者对话里口头说「我在做 A 和 B」，却看不到谁在跑、卡在哪。社区插件 dsh-workplan（维护者 abbaababa）把流程收成三拍：先产出可验收的任务分解，再派发真实的 DSH 子 Agent 执行，并在 Web 左侧栏用「任务进度」对齐同一份状态。它不装独立 App、不改 DSH 源码、不换页面；分类上属于工作流类插件，当前 npm 包版本 1.12.0，GitHub 仓库星标为 1（以目录页与仓库公开信息为准）。
这是什么¶
dsh-workplan 是给 DSH 官方 Web 版（dsh web / --profile web）用的插件：在对话里先出现【任务分解】（阶段、子任务、部门、验收标准），确认后由主 Agent 通过内置工具派发计划；最多 5 个子 Agent 并行，结果写回会话。简介里另一层表述是：安全相关说明按 ISO/IEC 15408:2026 的结构公开材料（安全目标、脆弱性评定、自评估、SBOM、安全策略、自动化测试等），不是声称「已通过 CC 认证」——没有证书编号就不该那样说；仓库 README 明确区分「对齐 2026 结构、公开自评证据」与第三方实验室评测。
- 目录页：https://www.skillhub.cn/plugins/abbaababa/dsh-workplan
- 源码与文档：https://github.com/abbaababa/dsh-workplan
- 许可证：MIT（见
package.json）
社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文只描述该插件在资料中写明的行为。
核心功能¶
计划优先的执行节奏¶
- 先排计划：发出有实际目标的任务后，主 Agent 在真正动手前先写计划——阶段、具体工作、负责部门、做法、验收标准、可能风险。
- 计划先给你看：以【任务分解】出现在对话里，带依据与验收标准，而不是一句话带过。
- 真的派人去做：每件具体工作交给真实的 DSH 子 Agent（最多 5 个并行）；主 Agent 须先派发并等待部门结果，才能继续往下答。纯打招呼、道谢、问进度不会触发拆解。
左侧栏「任务进度」¶
装好后在 DSH Web 左侧可打开「任务进度」，顶部有五类计数：任务数、已分配工作、做好、正在做、卡住。计划卡分「进行中」「已结束」「已完成」；展开可看阶段进度、部门与每项状态。README 说明 1.4.3 起统计来自单一状态源，避免面板数字与列表矛盾（例如显示 0 个正在做但下面仍有进行中项）。
九个模型工具（由主 Agent / 子 Agent 按规则调用）¶
使用者通常不直接调工具；它们定义了计划如何派发、查状态、改计划、上报阻塞等。摘要如下：
| 工具 | 作用 |
|---|---|
dsh_workplan_dispatch |
派发当前计划；mode:"wait" 默认等到结束，mode:"async" 后台继续；幂等 |
dsh_workplan_status |
只读进度；刷新后可从会话重建 |
dsh_workplan_update |
主 Agent 核对并修正子任务；带 expectedRevision；运行中默认需 force:true |
dsh_workplan_cancel |
取消未派发的计划 |
dsh_workplan_replan |
需求变更：cancel / replace / add，版本递增 |
dsh_workplan_escalate |
子 Agent 遇阻上报 |
dsh_workplan_instruct |
主 Agent 答复请示并下达指示 |
dsh_workplan_handoff |
跨部门需求：list / assign / resolve / close |
dsh_workplan_followup |
预算/超时中止但产物已落盘时的收尾说明 |
plan 模式下只展示计划，dispatch 会被拦下并说明原因，不会偷偷开跑。
部门标签与协作边界¶
计划项带部门标签（工程研发、研究分析、设计、产品、数据、质量验证、安全、运维、文档写作、运营、法务合规、财务等）。标签决定提示词与统计，不是真实组织架构：部门之间不能直接对话，跨部门信息由主 Agent 或工作区可读文件转达；依赖关系由 dependsOn 决定，阶段（stage）主要用于展示分组。细节见仓库 协作契约 与 部门职责。
预算、超时与续跑¶
| 项 | 默认值 | 环境变量 |
|---|---|---|
| 单轮派发预算 | 20 分钟 | DSH_WORKPLAN_TOTAL_TIMEOUT_MS |
| 单个子 Agent 上限 | 15 分钟 | DSH_WORKPLAN_CHILD_TIMEOUT_MS |
| 无进展判定 | 5 分钟 | DSH_WORKPLAN_IDLE_TIMEOUT_MS |
| 自动续跑次数 | 4 次 | DSH_WORKPLAN_MAX_RESUMES |
| 并发子 Agent | 5（固定） | — |
预算用尽时计划可标记为「本轮预算用尽，可续跑」，已完成项不重跑。也可在 cordis.patch.yml 的 config 里写例如 { "totalTimeoutMs": 1800000 }（30 分钟）。
安全与依赖（资料中的自述）¶
- 运行时
dependencies为空，无第三方运行时 npm 依赖。 - README 称源码中无
writeFileSync/child_process/ 对外fetch（面板仅同源请求/dsh-workplan/plans）；结果写入 DSH 会话记录。 - 图表使用随包分发的 Chart.js（
vendor/chart.umd.js），不加载 CDN。 - 独立复检与 470 项测试、
npm run verify等属于仓库自证流程；ATE 实验室见证、独立渗透等 CC 流程项 README 标明为固有残留，需认可实验室完成。
安装前若关心权限与数据边界，应自行阅读源码、SECURITY.md 与许可证，插件以当前 DSH 进程权限运行。
安装与启用¶
环境要求¶
| 要求 | 说明 |
|---|---|
| DeepSeek Harness | 官方 Web 版 |
| Node.js | 22 或更高（node -v） |
| 网络 | 安装时需访问 npm registry |
一键安装¶
下面命令来自仓库 README 原文：
dsh plugin --profile web add dsh-workplan@1.12.0
装完重启一次 DSH Web（或重新载入页面）使插件生效。若 PATH 中没有 dsh，需先确认 CLI 可用；用 npx 启动 DSH 时，可对同一 dsh 可执行文件使用上述命令。
典型用法¶
- 打开 DSH Web，发送有实际目标的任务，例如「帮我把这个目录的测试补到 80% 覆盖」。
- 稍等片刻，对话中出现【任务分解】：阶段、子任务、部门、验收标准齐全。
- 正常对话即可；主 Agent 按规则派发，需拍板时会提问。
- 点击左侧 「任务进度」 查看汇总数字与计划卡；若计划处于「已结束」但未做完，README 说明可说「继续」接着推进。
适用场景与注意¶
适合：多步骤、可拆成并行子任务、且希望在执行前看到验收标准的开发或分析类工作（在 DSH Web 内完成）。
注意：
- 仅针对 Web profile；需 Node ≥22。
- 子 Agent 并发上限为 5；长任务受默认 20 分钟单轮预算等限制，可通过环境变量或插件 config 调整。
- 安全证据包与自评估文档在仓库
docs/cc/等路径；这是公开材料与自测口径，不等于产品已获 CC 证书。 - 插件来自社区维护者，安装前请核对 GitHub 仓库 源码与 MIT 许可证，并理解其在 DSH 进程内的权限范围。
结尾¶
dsh-workplan 把 DSH Web 上的复杂任务改成「先分解、再真派子 Agent、进度可对照」的工作流，并用 ISO/IEC 15408:2026 结构的公开安全材料供自行核对。一键安装命令为 dsh plugin --profile web add dsh-workplan@1.12.0；更多细节见 SkillHub 目录页 与 GitHub README。
