前言¶
在 DeepSeek Harness（DSH）的开发实践中，一次派发多个任务往往导致智能体无法深入，或者希望智能体干完一件事后自己找下一件事。dsh-todo-board 是一个给 DSH agent 的跨会话 TODO 板。它以右上角浮窗的形式存在，按工作目录分组，支持拖动排序。每条待办可以设定不同的执行模式，AI 完成后调用接口打勾，用户验收后勾选，真正了结任务。
安装与启用¶
安装命令如下。安装后必须重启 Profile（重新执行 dsh web）才会装载，因为插件是 host 组合里的一行，不是运行时热加载。
dsh plugin --profile web add dsh-todo-board
核心功能¶
执行模式
每条待办在新增时必须选一档（默认「提醒」），可独立选择「提醒」、「自动续跑」或「自动新开会话」。新增框里的「目录」决定这条待办归属哪个目录，留空则跟随当前会话的工作目录。派发顺序即面板里从上到下的顺序。
任务状态与双勾选
任务状态由实时会话列表推导，不落盘。每一行都有一个状态标签。左勾代表 AI 已完成（等待验收），右勾代表用户验收（真正了结）。只有右勾才会将任务从未完成列表移除，并进入下方独立的「已完成」列表。已完成的行不参与执行顺序。
界面与分组
面板是一个浮窗，支持折叠、缩放，位置和尺寸记在 localStorage。待办按工作目录分组，列表顺序即执行顺序。支持四种界面风格（票据/素白/紧凑/随主题）切换。
长任务规划
长任务可以拆成步骤，通过 /todo <目标> 命令或直接粘贴模板注入，一次调用写入整份计划、一次审批。
其他能力
- 图片附件：支持 Ctrl+V 粘贴截图，最多 4 张，派发时作为真正的图片发给模型。
- 定时执行：可设定本地时间到点才执行，列表里随时可改。
- 卡住自愈：派发失败会记录并按退避重试，绝不静默退休。
- 开发者日志：面板内可查看日志。
典型用法¶
- 右上角浮窗出现，输入待办内容，选择执行模式，点击「添加」。
- AI 执行时，完成后会调用
todo_board action=done给自己打左勾，然后自动查找同目录下一条未完成待办并继续执行。 - 用户验收后点击右勾，该行移入「已完成」列表。底部「清理已验收」可批量删除。
适用场景与注意¶
本插件适合需要精细化管理智能体任务进度的场景。使用前需注意：
- 版本要求：本插件 0.11.2 起要求 DSH ≥ 0.1.7-rc.2，并在 DSH 0.2.0-rc.2（桌面端）上验证。
- 权限限制：AI 改板子需经过 DSH 原生审批框，板子路由需浏览器会话凭据。
- 数据存储：板子是全局单文件（
${DSH_HOME}/todo-board/board.json），原子写入。
