DSH 官方 todo_write 的增强 fork:优先级标签、完整 markdown 清单结果,加上一张跟随当前会话、可拖动的浮动任务面板(README 标注 MIT)。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-20
许可证
NOASSERTION
01它能帮你完成什么?
在 DSH 会话里维护一份带优先级、能完整看到的任务清单,而不是官方那行计数
一个 `todo_write_plus` 工具:结果里带 high / medium / low 优先级,并把完整 markdown 清单回给模型
要把多步骤任务的计划写下来、让模型和用户都看得见的 DSH 用户
模型干活的时候顺手看进度,不用切到侧栏或另一个窗口
会话内自绘的浮窗:展开态 / 胶囊态、当前动作行、子代理行,发新消息时保留上一轮清单并淡化显示
在 dsh 桌面端跑长会话、希望计划一直贴在对话旁边的用户
在已经用了官方 todo_write 的桌面环境里加上面板,又不弄坏已有会话
并存方案:插件注册为 `todo_write_plus`,复用官方 `todo/write` 事件类型,两边写出的日志互相可读
桌面端 agent preset 已内置官方任务工具、无法直接替换的团队
02如何接入 DeepSeek Harness?
前置条件
- 一个 `dsh` CLI profile,或 dsh 桌面端(桌面端的安装命令 README 另给了走 `ELECTRON_RUN_AS_NODE` 的写法)
- Node.js ≥ 24 —— README 只在源码构建路径上声明了这个要求
安装步骤
- 01
CLI profile:`dsh plugin --profile <你的profile名> add @shuxidemosheng/dsh-todolist`,按包名安装无需 git 地址,且可以指定版本
$ dsh plugin --profile <你的profile名> add @shuxidemosheng/dsh-todolist
- 02
也可以走 git 通道:`dsh plugin --profile <你的profile名> add https://github.com/shuxidemosheng/dsh-todolist.git`,始终拉 main 最新
$ dsh plugin --profile <你的profile名> add https://github.com/shuxidemosheng/dsh-todolist.git
- 03
桌面端:侧边栏「插件」→ 添加插件 → 粘贴仓库地址或包名;安装失败会自动回滚(操作前先完全退出应用,含系统托盘)
- 04
装完或升级后重启客户端
验证接入成功
- 核对安装版本:`grep '"version"' ~/.dsh/profiles/desktop/node_modules/@shuxidemosheng/dsh-todolist/package.json`
03DSH 适配与能力边界
以 `dsh plugin add` 安装的原生 DSH 插件:宿主半注册增强版任务清单工具,客户端半在会话内绘制浮动任务面板
增强工具 `todo_write_plus`
任务条目,可选带 `high` / `medium` / `low` 的 `priority`→回给模型的完整 markdown 清单,以及会话日志里的一条 `todo/write` 事件
0.7.3 起参数改为规范化而非拒绝:空白 `content` 丢弃、重复内容加后缀、多余的 in_progress 降级为 pending调整结果会在工具结果里告知模型浮动任务面板
会话的 `todos` 投影→展开态(状态点 / 划线 / 优先级徽章 / 进度计数 / 进行中标记),点击切换到同一份清单的胶囊态优先级链
把拖动后的面板坐标写进 localStorage 的 `dsh-todo-plus.panelPos`,内容只有 `{x, y}`当前动作与子代理状态
会话节点流里已发出但还没返回结果的工具调用,`subagentCatalog` / `subagentTiming` 投影→两次清单写入之间的实时工具行;以及可折叠的子代理行,展开看名称、状态与已运行时长
轮次之间不断档
上一轮留下的清单→旧清单继续显示、淡化并标注「上一轮」,直到新清单写入才替换
可配置的纪律与工具名
`cordis.patch.yml` bundle 行里的 `allowParallelInProgress` 与 `toolName`→默认单活跃纪律;CLI profile 上禁用官方 `tool-todo` 行后,也可以把工具名改回 `todo_write`
04适合谁?何时不该用?
适合
- 要把多步骤任务的计划写下来、让模型和用户都看得见的 DSH 用户
- 在 dsh 桌面端跑长会话、希望计划一直贴在对话旁边的用户
- 桌面端 agent preset 已内置官方任务工具、无法直接替换的团队
不适合
- dsh 0.2.1-rc.2 起会在启动时校验插件的兼容性声明:0.7.3 及更早把 peer 锁死在 `0.2.0-rc.2`,在这些版本上会被判为不兼容而拒绝加载;0.7.4 起改用 `engines.dsh: ">=0.2.0-rc.2 <0.3.0"` 声明范围才恢复加载。
- dsh 0.2.2-rc.1 起,共享同一投影 key 的注册方必须声明相同的 `stateVersion` 与 `summary`。官方 `tool-todo` 显式写 `summary: false`,而 0.7.4 及更早的本插件没声明该字段,两者在桌面端 agent preset 共存时后注册的一方 `register()` 抛错,连带会话创建失败;0.7.5 对齐了官方定义。
- 裸包名安装走 npm registry,而 dsh 内置的 `minimumReleaseAge` 供应链策略会把刚发布的版本压进数天冷却期,此时裸包名解析到的是上一个「足够老」的版本,插件页卡片却仍显示 registry 最新版号。要立刻用新版就带版本号安装。
05兼容性、维护与安全提示
- dsh 0.2.1-rc.2 起会在启动时校验插件的兼容性声明:0.7.3 及更早把 peer 锁死在 `0.2.0-rc.2`,在这些版本上会被判为不兼容而拒绝加载;0.7.4 起改用 `engines.dsh: ">=0.2.0-rc.2 <0.3.0"` 声明范围才恢复加载。
- dsh 0.2.2-rc.1 起,共享同一投影 key 的注册方必须声明相同的 `stateVersion` 与 `summary`。官方 `tool-todo` 显式写 `summary: false`,而 0.7.4 及更早的本插件没声明该字段,两者在桌面端 agent preset 共存时后注册的一方 `register()` 抛错,连带会话创建失败;0.7.5 对齐了官方定义。
- 裸包名安装走 npm registry,而 dsh 内置的 `minimumReleaseAge` 供应链策略会把刚发布的版本压进数天冷却期,此时裸包名解析到的是上一个「足够老」的版本,插件页卡片却仍显示 registry 最新版号。要立刻用新版就带版本号安装。
- 面板只是 `todos` 投影的镜像:模型若只用正文汇报进度、没调工具,面板就停在旧状态,插件不会替它编进度。浮窗也只在会话界面出现,这是设计行为。
README 写 MIT,GitHub 识别为 NOASSERTION · 活跃维护(最新 release v0.8.0,2026-11-18)
06常见问题
怎么把它装进 DeepSeek Harness?
CLI profile 上执行 `dsh plugin --profile <你的profile名> add @shuxidemosheng/dsh-todolist`;README 也给了 git 直装和桌面端插件页两条路,本机自行构建 tgz 也能装。装完重启客户端。注意 dsh 的 `minimumReleaseAge` 冷却期内裸包名会解析到旧版,要最新版就带版本号安装,例如 `@shuxidemosheng/dsh-todolist@0.8.0`。
会不会和官方 todo_write 打架?
不会。桌面端注册的是 `todo_write_plus`,与官方 `todo_write` 并存;会话日志复用官方 `todo/write` 事件类型,两边写出的日志互相可读。工具名万一被占用(比如装了两份),本插件记日志后优雅让位,entry 仍正常激活,不会让 agent preset 审计失败。桌面端 agent preset 无法禁用官方 `tool-todo` 行,所以那里只能是共存而非替换。
面板停在已经做完的那一步不动,是什么原因?
浮窗和官方内联任务条读的是同一个 `todos` 投影,两边都停在同一处,说明之后没有清单写入被接受。先确认版本(冷却期可能装到旧版),再去「轨迹」标签页看 `todo_write_plus` 的调用记录:最后一次是红色报错说明写入被拒(0.7.2 及更早对同时标多个 in_progress 是硬拒绝),最后一次成功但没有后续调用说明模型只在正文里报了进度。0.7.3 起改为规范化处理,不会再「一拒就永久停摆」。
它会联网或写我的文件吗?
不会。宿主半与客户端半都是自包含产物,零运行时 npm 依赖;客户端半无任何网络请求、不用 `eval` / `innerHTML`,唯一的本地写入是 localStorage 里的面板坐标 `{x, y}`(key `dsh-todo-plus.panelPos`)。宿主半只注册工具与投影、向会话日志追加事件,不触文件系统与网络。
支持哪些 dsh 版本?
0.7.4 起用 `engines.dsh: ">=0.2.0-rc.2 <0.3.0"` 声明兼容范围,0.2.x 的 rc 升级不再被卡;0.7.5 又把投影注册对齐到 dsh 0.2.2-rc.1 要求的官方 `summary: false`。0.7.3 及更早把 peer 锁死在 `0.2.0-rc.2`,在 0.2.1-rc.2 及以上会被拒绝加载。
07相关的 DSH 工作流
dsh-tui
作者 ccch1mneyyy
DSH's officially top-recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方首推的 TUI 插件,高性能低占用,可爱像素鲸鱼,流畅鼠标交互,npm 一键安装
dsh-better-sidebar
作者 omdsh-dev
开放的侧边栏底座,支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 | Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-media-desk
作者 woniuniuniu
DeepSeek Harness 自媒体工作台插件:一句话记灵感,一键生成脚本、封面、配图和分镜
dsh-drawai
作者 fourzkw
DSH 右侧栏里的可编辑画布 —— 加上让模型直接改图的两个工具
08数据与来源
**DeepSeek Harness 任务清单插件 —— 官方 [`todo_write`](https://github.com/deepseek-ai/deepseek-harness) 的增强 fork**
- **模型侧**:注册增强版任务清单工具。是否建清单由模型根据任务复杂度自主判断(多步骤任务通常会建)
- 本插件在桌面端注册为 **`todo_write_plus`**,与官方 `todo_write` 并存,零冲突
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-20。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
