前言¶
DeepSeek Harness (DSH) 采用插件化架构，旨在扩展功能。内置的 todo_write 工具主要用于记录智能体在当前会话中的执行步骤，生命周期仅限于单次对话。当需要在跨会话之间管理个人待办事项，并保留交接说明时，dsh-followup-todo 插件提供了解决方案。
插件概览¶
本插件为用户提供一个跨会话的待办清单，而非智能体的任务清单。
* 核心价值：每条待办附带结构化的交接说明（context + inject），新会话可直接读取并开工。
* 维护者：Tiaoma123
* 分类：记忆
* 协议：MIT
核心设计：Context + Inject¶
每条待办包含两个自由文本字段，用于构建新会话的上下文：
* Context（背景）：记录已确定的事实、结论、文件路径或硬约束，不包含过程流水账。
* Inject（注入内容）：明确下一步动作、目标、验收标准，歧义处标记「待确认」。
点击面板中的「继续」或输入框上方的待办条，生成的交接 prompt 会自动填入输入框，使新会话开局即具备完整上下文。
安装与启用¶
本插件未发布至 npm，需通过 GitHub 直装。安装命令如下：
dsh plugin --profile <profile> add github:Tiaoma123/dsh-followup-todo
注意事项：
* 本包通过 cordis.patch.yml 自挂载，安装后即用，无需手动编辑配置文件。
* 不可重复挂载：重复挂载会导致路由冲突，启动时报错。若之前手动挂载过，请先删除旧配置。
模型工具¶
插件注册了 4 个模型工具，支持优先级管理（P0-P3）及归档功能。
- todo_add
- 新增待办。
- 参数：
title（必填）、priority（默认 P2）、context、inject、workspace（可选）。
- todo_list
- 查看清单。
- 参数：
filter（支持 open/done/all/archived）。
- todo_done
- 标记完成（条目保留在清单中）。
- todo_archive
- 标记完成并归档（移出活动视图，可通过 filter=archived 回查）。
浏览器端界面¶
仅在 Web 端生效，Headless Profile 无 UI。
* 会话头部按钮：显示未完成数量角标，点击展开悬浮面板。
* 悬浮面板：支持新增、勾选、归档、删除，可按优先级 P0-P3 选择，并切换过滤页签。
* 输入框待办条：显示待办数量与提示，展开后列出条目。点击条目将交接内容注入输入框。
数据存储¶
数据以 JSON 文件形式存储在用户目录下，按工作区分片：
* 路径格式：~/.dsh/followup-todos-<base64url(工作区绝对路径)>.json
* 用户可直接备份该文件。
与内置 todo_write 的区别¶
- 清单归属：内置工具属于 Agent，此插件属于用户。
- 生命周期：内置工具仅限当前会话，此插件支持跨会话、归档与回查。
- 存储位置：内置工具存储在会话上下文，此插件存储为独立 JSON 文件。
已知限制与安全说明¶
- HTTP 鉴权：新版本通过鉴权拦截未授权请求。老版本 DSH 退化为无鉴权，若将 Web 服务暴露至非回环地址，需自行增加访问控制。
- 数据同步：列表依靠 3 秒全局轮询刷新，非实时推送，多窗口可能存在短暂延迟。
- UI 限制：仅实现了 Web 界面，Headless Profile 无法使用可视化功能。
维护状态¶
个人自用项目，不承诺维护。使用 MIT 协议，可自由 Fork。
