dsh-workplan

DSH PLUGIN工具与能力

仓库 abbaababa/dsh-workplan

工具与能力 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

自动任务分解 + 真实部门子 Agent + 「任务进度」面板,给 DeepSeek Harness 用;没有任何第三方运行时依赖。

一句话选型结论

按资料字段整理

dsh-workplan 是工具与能力类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类工具与能力 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 1 复刻 0 · 未关闭 issue 0
最近更新 2026-10-29 创建于 2026-10-28
README 11.8 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:abbaababa/dsh-workplan
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

工具与能力
字段来自项目仓库与公开索引,中文说明由本站标注

上游标签

deepseek-harnessdshdsh-plugintask-decompositionworkplan

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在工具与能力场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-workplan当前 L5 · 运行验证通过 低风险 1 未标注 有
huashu-design 未做沙盒验证 未标注 3.0 万 未标注 有
loopx 未做沙盒验证 未标注 6,233 未标注 无
agy-staff 未做沙盒验证 未标注 870 未标注 有
dsh-startup-screen 未做沙盒验证 未标注 633 未标注 有
minara-skills L4 · 沙盒安装通过 中风险 360 未标注 有

仓库档案

工具与能力
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方abbaababa仓库 dsh-workplan · 默认分支 main
分类工具与能力automation
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言未标注仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue1 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-28 · 2026-10-29最后推送 2026-10-29
本站收录2026-10-30首次进入本站目录的时间

README 全文

11.8 KB
作者原文,中文版优先;只做安全转义,不改内容

任务进度(dsh-workplan)

English (US) — plain-language guide: README.en.md

> 给 DeepSeek Harness(DSH) 加一个「先拆任务、再真的派人去做、最后让你一眼看懂进度」的能力。
>
> 不用装 App,不改 DSH 源码,不替换页面。 装上以后多三样东西:对话里的计划、真的部门子 Agent、左侧栏一个「任务进度」面板。


它到底做了什么(用大白话讲)

平时你给 AI 一个复杂任务,它经常「一边想一边做」,做到一半你才发现方向不对。

这个插件把节奏改成三拍:

  1. 先排计划:你发出任务后、AI 真正动手前,它先写一份计划——分几个阶段、每个阶段几件具体工作、每件工作交给哪个部门、怎么做、什么算做完、可能卡在哪。
  2. 计划先给你看:这份计划以「任务分解」的形式出现在对话里,包含每一步的依据与验收标准,而不是一句话糊过去。
  3. 真的派人去做:确认后,每一件具体工作交给一个真实的 DSH 子 Agent 去执行(最多 5 个同时跑),结果写回会话;你在左侧栏「任务进度」里随时能看到谁在做、做到哪、哪件卡住了。

计划不是装饰品:主 Agent 必须先派发、等到部门结果回来,才能继续往下答。

装之前你需要什么

要求 说明
DeepSeek Harness 官方 Web 版(dsh web / --profile web 跑的这套)
Node.js 22 或更高(node -v 自查)
网络 安装时需要能访问 npm registry

一键安装

dsh plugin --profile web add dsh-workplan@1.7.1

装完重启一次 DSH Web(或重新载入当前页面)让插件生效。

没有 dsh 命令的话,先确认它在 PATH 里;用 npx 起的 DSH 可以直接用完整路径调用同一个 dsh。

从源码安装(可选,想改代码时用)

git clone https://github.com/abbaababa/dsh-workplan.git
cd dsh-workplan
npm ci && npm run build
dsh plugin --profile web add "$(pwd)"

装好以后怎么用(小白版)

  1. 打开 DSH Web,随便发一个有实际目标的任务,例如「帮我把这个目录的测试补到 80% 覆盖」。
  2. 等一两秒,对话里会出现一块【任务分解】:阶段、子任务、部门、验收标准齐全。
  3. 你只需要正常对话;主 Agent 会按规则派发计划,遇到要拍板的地方会问你。
  4. 点左侧栏的「任务进度」,就能看到:
  • 顶部五个数字:几个任务 / 分配了多少件工作 / 做好了 / 正在做 / 卡住了;
  • 计划卡:分「进行中」「已结束」「已完成」三组,右上角是完成率。「已结束」= 这一轮已经停了(没有东西在跑)但计划还没做完,卡片会写清停在哪儿(预算用完 / 卡住了 / 还没开始),说一句「继续」即可接着推进;
  • 展开任意计划:每个阶段的进度、每件具体工作由哪个部门负责、当前状态。
  1. 进度数字背后的每一行,都来自同一份任务状态——不会再出现「显示 0 个正在做、但下面明明写着正在做」这种自相矛盾(1.4.3 专门修的就是这个,见下文)。

纯打招呼、道谢、问「做到哪了」不会触发拆解,不会平白多出一堆子 Agent。

四个模型工具(你不用直接调用)

工具 作用
dsh_workplan_dispatch 派发当前计划,把结果写回会话。默认 mode:"wait" 等结束;mode:"async" 立刻返回、后台继续。重复调用是幂等的。
dsh_workplan_status 只读:问到哪了。重启或刷新后也能从会话记录重建。
dsh_workplan_update 主 Agent 核对结果、修正某个子任务状态与证据。带 expectedRevision 防覆盖,运行中默认拒绝(force:true 才覆盖)。子 Agent 不能调用。
dsh_workplan_cancel 取消还没派发的计划,不会伪造任何「已完成」。

在 plan 模式下只会给你看计划,dispatch 会被明确拦下并说明原因,不会偷偷开跑。

部门怎么协作(1.7.1 的真实能力)

计划里的每件工作都带一个部门标签(工程研发、研究分析、设计、产品、数据、质量验证、安全、运维、文档写作、运营、法务合规、财务)。标签决定提示词与统计口径,不是组织架构:

  • 部门之间不能直接对话;跨部门信息由主 Agent 转达,或落到双方都能读的工作区文件。但每个子 Agent 的提示词里会带上兄弟部门的只读一览(谁、做什么、产出什么、已完成摘要),需要协作就写进 needs,结果消息会汇总成「跨部门待转达」交给主 Agent 逐条处理。
  • 下游只看到 dependsOn 里上游的摘要与完整体检结果,看不到上游的完整对话。所以上游必须把「产物绝对路径 + 怎么验收」写进摘要;声明为 file 的产物会被逐个核实,缺失就不给下游解锁。
  • 子 Agent 在输出末尾回传结构化证据块(status / acceptance / artifacts / needs)。非空输出不再等于完成:partial、任一条验收失败、坏块都判受阻,只有全 pass 才可直接采信,其余在结果消息里标「未验证」等主 Agent 核对。
  • 阶段(stage)只是展示分组,不是执行门槛;真正决定先后的是 dependsOn。

完整的角色、数据契约、状态机、失败恢复与「改代码时必须同步的三处」,见 协作契约;12 个部门的职责与交接清单见 部门职责与交接约定。

预算、超时与续跑(知道这些就不会误以为卡死)

项 默认值 怎么改
单轮派发预算 20 分钟 DSH_WORKPLAN_TOTAL_TIMEOUT_MS
单个子 Agent 上限 15 分钟 DSH_WORKPLAN_CHILD_TIMEOUT_MS
子 Agent 无进展判定 5 分钟 DSH_WORKPLAN_IDLE_TIMEOUT_MS
自动续跑次数 4 次 DSH_WORKPLAN_MAX_RESUMES
并发子 Agent 5 个(固定) —

预算用尽不是失败:计划会变成「本轮预算用尽,可续跑」,已完成的不重跑,剩下的下次接着做。被判定卡住的子任务只卡它自己,不会拖垮整个计划;重试只会发生一次,第二次的提示词会带上一次的失败原因,不会原样重撞。

环境变量写在启动 DSH 的那个 shell 里,或者写进插件配置:

// cordis.patch.yml 里的 config 字段
{ "totalTimeoutMs": 1800000 }   // 30 分钟

安全与隐私(可以自己复核)

  • 没有第三方运行时依赖:dependencies 是空的;装出来的只有这个插件自己的 JS、配置、图标和说明。
  • 不写你的磁盘:源码里没有任何 writeFileSync / appendFileSync / mkdirSync(可 grep 验证);结果只写进 DSH 会话记录。
  • 不向外发数据:源码里没有 child_process、没有对外 fetch/http.request;唯一的一次 fetch 是浏览器端请求同源的 /dsh-workplan/plans。
  • 面板数据要登录:该路由走 DSH 自己的鉴权,未登录直接返回 401。
  • 图表库是本地自带:vendor/chart.umd.js(Chart.js 4.6.1,MIT)随包分发,不加载任何 CDN 脚本。

自己复核:

npm view dsh-workplan@latest dependencies     # 应为空
grep -RInE "writeFileSync|child_process|eval\(" src   # 应无命中
npm audit --omit=dev

1.5.0 改了什么(进度一眼可见)

1.5.0 只改展示层:把计划卡折叠态那行「本计划 0/8 做好了 + 一根 54×5px 的小条」换成图表组合。

位置 改前 改后
折叠中的计划卡 12px 灰字 + 迷你条 + 「0 卡住了」;百分比只在鼠标悬停的 title 里 44px 环形图 + 24px 百分比 + 本计划 X/Y 做好了 + 一行「现在在做什么」(卡住优先,带任务名)+ 8px 四段构成条 + 状态图例 + 阶段步进条
展开后的面板 一根计划级进度条 「分步进度」:每个阶段一行(名称、完成/总数、细条、状态),外加加权总体进度
0% 的计划 迷你条填充宽度为 0,轨道又与卡片底色用同一个 token,等于没有图 四层信号:加粗的环轨、24px「0%」、整条灰色的「还没开始」构成条、虚线阶段槽 + 当前阶段描边
0 个工作项的组头 未完成 0 / 已完成 0(完成率暂无数据) 整句删除,只留环上的 —;组内空态仍在(展开可见)

「卡住了」这类数字一个都没少,只是换了呈现:图例始终是 做好了 / 正在做 / 卡住了 / 还没开始 四项带数字。

怎么看到效果:插件的前端在 client.js 里,DSH Web 进程启动时加载它,所以先重启 DSH Web,再刷新 。不想改环境也能离线看对比:打开 docs/preview/progress-visual-1.5.0.html(npm run preview 可重新生成,它用同一份 CSS 渲染 1.4.3 与 1.5.0 的卡头)。

没有新增依赖,plan.ts / runtime.ts 无改动;回滚方式见 CHANGELOG.md。

1.4.3 修了什么(为什么值得升级)

1.4.3 是一次计数一致性修复:插件曾同时维护「实时任务状态」和「缓存的统计快照」两份真相,导致面板数字和实际状态对不上(截图里「0 个正在做」但下面有任务正在做,就是它)。

缺陷 表现 根因
D1 面板数字长时间不更新 统计只在整批子 Agent 跑完后才重算,运行期间冻结
D2 同一份数据里两个数字互相矛盾 计数来自缓存,部门聚合来自实时状态
D3 「还没开始」的任务却显示 100%、带着上一次的执行者 预算重置绕过了状态机,旧字段没清
D4 同一类失败,进度有时 100 有时 0 两处代码对「卡住」的进度语义不一致

修法是删掉缓存快照,只保留一份状态源:所有数字在序列化时由同一函数现场派生,并配了 7 条不变量 + 变异测试防止回退。完整报告:docs/fix-report-derived-counts-1.4.3.md。

常见问题

装完没反应?
先重启 DSH Web;再确认 ~/.dsh/profiles/web/package.json 的依赖里有 dsh-workplan。

面板一直是空的?
面板只显示当前会话的计划。换一个会话、或这个会话还没产生计划时是空的,这是正常的。

数字和以前不一样了?
1.4.3 之后数字来自真实状态而不是缓存,所以会比旧版本「更小、但更准」(旧版本的完成率经常虚高)。

子 Agent 卡住不动?
5 分钟没有任何新事件会被判定卡住并单独标红;对主 Agent 说「续跑这个计划」即可从受阻处继续。

卸载

dsh plugin --profile web remove dsh-workplan

开发与验证

npm ci
npm run check     # tsc --noEmit
npm test          # 全部测试(数量随版本变化,以命令输出与 CI 为准),含计数不变量与进度图表用例
npm run build     # 编译 src/*.ts → lib/*.js、client.js
npm run preview   # 重新生成 docs/preview 里的 1.4.3 / 1.5.0 卡头对比页

lib/ 与 client.js 是提交进仓库的构建产物,CI 会重建并校验二者无差异。

许可证

MIT,见 LICENSE。Chart.js 亦为 MIT。


English (US) — plain-language guide: README.en.md

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
dsh-workplan 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:abbaababa/dsh-workplan` 即可。

dsh-workplan 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-workplan 安全吗?

低风险。

dsh-workplan 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-workplan 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

工具与能力
按星标排序,可作替代方案

huashu-design

huashu-design

在 DeepSeek Harness 里说一句话,就能拿回可交付的设计:网页、App 原型、可编辑 PPTX、动画与信息图,自带 84 种风

未标注验证等级 3.0 万 星

loopx

loopx

LoopX 是面向长周期 Agent 的本地优先控制平面,作为 DSH plugin 为 DeepSeek Harness 提供持久目标、证

未标注验证等级 6,233 星

agy-staff

agy-staff

把 Google Antigravity CLI 作为快速 Gemini 员工接入 DSH,提供子代理侧边栏、编排模式与多种角色技能。

未标注验证等级 870 星

dsh-startup-screen

dsh-startup-screen

DeepSeek Harness 的启动界面与启动动画插件。

未标注验证等级 633 星

dsh-blender-plugin

dsh-blender-plugin

让 AI 模型通过直连 TCP 通道实时驱动 Blender 的 DSH plugin:15 个工具覆盖视口取帧、任意角度渲染、内循环搜索、

未标注验证等级 211 星

abbaababa 的其它插件

1 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。