前言¶

在 DeepSeek Harness（DSH）里跑智能体时，任务、备忘和跟进项往往分散在聊天窗口、工作区备注或外部工具之间。工作区会随项目切换或清空而变，侧边栏里若有一套不联网、本地落地的待办与笔记，按分组管理且能备份恢复，会比「记在脑子里」或临时 Markdown 更可复用。下面介绍社区插件 dsh-todo（维护者 lizhanzhan89），它作为客户端插件挂在 Harness 侧边栏，把待办和笔记放在同一面板里，按「项目」分块——此处的项目只是分组名称，不是代码工程。

这是什么¶

dsh-todo 是 Harness 侧边栏中的事项面板：待办与笔记合并展示，按项目分组，不联网、不需要账号。数据写在用户文稿目录，与当前工作区解耦，便于在切换或清空工作区后仍保留记录。插件包名为 @local/dsh-todo，侧边栏入口 id 为 todos；当前 package.json 中版本为 1.2.0，许可为 MIT（© 2026 lzz）。分类上属于 DSH 生态里的客户端插件，通过 Harness 自带的 webServer、connection（cookie 鉴权）与 Host 通信。

核心功能¶

资料中列出的能力如下，均以本地 JSON 为唯一数据源。

待办、笔记与截止日期¶

• 条目区分 todo 与 entry（笔记）；多行编辑时 Enter 换行，Ctrl/Cmd+Enter 保存，列表完整显示，编辑框最多三行。
• 待办可设 到期日（YYYY-MM-DD）：逾期标红、当天标蓝；另有「截止日期」视图，跨项目按日期列出全部未完成项。

项目、归档与排序¶

• 新建项目即新建一个分组名；删除项目时整组条目进入回收站。
• 归档：将导航里的项目行拖到归档区，项目离开看板但条目保留，可随时放回。
• 拖动排序：项目在导航行上拖；条目在行首握把上拖。数组顺序即显示顺序。

搜索、回收站与已完成¶

• 搜索就地隐藏不匹配内容。
• 删除先进回收站，可恢复原位。
• 支持「包含已完成」开关（对应数据里的 includeDone）。

备份与恢复¶

• 自动备份：每天第一次写入前，把上一份数据复制为 dsh-todo-YYYY-MM-DD.json，只保留最新 7 份。
• 手动备份：页面可「立即备份」，文件形如 manual-20261109-183000.json，永不自动清理，也可在页面上删除。
• 恢复：用所选备份完全覆盖当前内容（与「导入合并」不同）；确认前会把当前状态先存一份手动备份，恢复操作本身可撤销。

安装与启用¶

插件以本地 bundle 方式安装，命令须使用 README 原文形式（将 target 换成你机器上 dsh-todo 目录的绝对路径）：

plugin_manager: install_bundle  target=/绝对路径/dsh-todo

安装后通过侧边栏打开待办面板即可使用。卸载时使用：

plugin_manager: remove_bundle  target=@local/dsh-todo

卸载不会删除数据目录；若要清空，需手动删除 ~/Documents/dsh-todo/。

安全与权限：客户端插件随当前 DSH Host 进程运行，可读写你配置的数据路径。安装前建议在 GitHub 查看源码与 MIT 许可证，确认路径与备份策略符合你的环境。

数据存放与迁移¶

数据刻意放在文稿目录而非工作区，避免工作区清空或切换导致待办丢失。默认结构如下：

~/Documents/dsh-todo/
├── dsh-todo.json                      # 当前数据
└── backups/
    ├── manual-20261109-183000.json    # 手动备份
    └── dsh-todo-2026-11-09.json       # 自动备份（保留最新 7 份）

整个文件夹复制即可完整迁移。若需改用其他目录，在 cordis.patch.yml 中为插件配置 dataDir（相对路径按用户主目录解析），例如：

- id: dsh-todo
  name: '@local/dsh-todo'
  config:
    dataDir: /Users/me/OneDrive/dsh-todo

备份为纯 JSON，可直接查看或手工编辑。顶层字段包括 projects、todos、trash、includeDone；每次改动由 Client 将完整状态 POST 给 Host，写入采用临时文件再 rename，磁盘上始终是完整副本。

典型用法¶

1. 按分组管事项：在侧边栏 todos 中新建项目（分组），在同一项目下混合添加待办与笔记条目。
2. 跟截止日期：为待办设置 due 日期，用颜色区分逾期与当天，并在「截止日期」页查看跨项目待办。
3. 暂不需要看板的项目：拖到归档区，需要时再拖回导航。
4. 换机或防误删：依赖自动 7 日快照或手动备份；出问题则从备份恢复（恢复前会自动留一份当前状态的手动备份）。
5. 手工修数据：在 Host 未频繁写入时，可编辑 dsh-todo.json 或某份备份（须符合 README 中的 JSON 结构），理解 pickState() 白名单后避免新增未在白名单中的顶层字段被静默丢弃——该细节主要面向改源码的开发者。

适用场景与注意¶

适合：希望在 DSH 会话旁固定一块本地待办/笔记、不依赖云服务或账号的智能体开发者；需要按「分组」区分不同主题事项、又要与频繁切换的工作区隔离的场景。

注意：

• 插件不联网，多端同步需你自己复制数据目录或使用同步盘（配合 dataDir）。
• 日期存 YYYY-MM-DD，不要用时间戳或误用 toISOString() 以免跨时区滚日。
• 若自行修改 src/ 构建客户端，需 node build.mjs 后重启 Host 并刷新页面；面板标题旁版本号（如 v2026-11-09.2）用于确认加载的构建产物。

社区插件目录见 SkillHub 上的 dsh-todo 页；源码与完整说明以 GitHub 仓库 为准。DSH 生态强调「一切皆插件」，SkillHub 为独立社区站点，与 DeepSeek / 幻方无官方从属关系。