返回目录

dsh-todolist

精选清单收录维护状态: 活跃

shuxidemosheng/dsh-todolist

DeepSeek Harness 任务清单插件:官方 todo_write 的增强 fork —— 优先级标签、完整清单渲染、可拖动的会话内浮动任务面板(位置记忆 / 双击复位 / 当前动作显示)

前往 GitHub项目主页
$ dsh plugin --profile <你的profile名> add @shuxidemosheng/dsh-todolist

105

星标

0

Fork

JavaScript

语言

NOASSERTION

许可证

2026-10-03

创建于

2026-11-18

最近推送

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 只在源码构建路径上声明了这个要求

安装步骤

  1. 01

    CLI profile:`dsh plugin --profile <你的profile名> add @shuxidemosheng/dsh-todolist`,按包名安装无需 git 地址,且可以指定版本

    $ dsh plugin --profile <你的profile名> add @shuxidemosheng/dsh-todolist

  2. 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

  3. 03

    桌面端:侧边栏「插件」→ 添加插件 → 粘贴仓库地址或包名;安装失败会自动回滚(操作前先完全退出应用,含系统托盘)

  4. 04

    装完或升级后重启客户端

验证接入成功

  • 核对安装版本:`grep '"version"' ~/.dsh/profiles/desktop/node_modules/@shuxidemosheng/dsh-todolist/package.json`

03DSH 适配与能力边界

DSH 适配原生运行时

以 `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` 投影的镜像:模型若只用正文汇报进度、没调工具,面板就停在旧状态,插件不会替它编进度。浮窗也只在会话界面出现,这是设计行为。
2026-10-032026-11-17v0.8.0

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 及以上会被拒绝加载。

08数据与来源

  • 作者声明github.com9fb01d20f250…

    **DeepSeek Harness 任务清单插件 —— 官方 [`todo_write`](https://github.com/deepseek-ai/deepseek-harness) 的增强 fork**

  • 作者声明github.com9fb01d20f250…

    - **模型侧**:注册增强版任务清单工具。是否建清单由模型根据任务复杂度自主判断(多步骤任务通常会建)

  • 作者声明github.com9fb01d20f250…

    - 本插件在桌面端注册为 **`todo_write_plus`**,与官方 `todo_write` 并存,零冲突

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-20。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。