待办面板 DavidLee2026/dsh-plugin-todo-panel

待办面板（dsh-plugin-todo-panel）

一个给 DeepSeek Harness 右侧栏用的待办面板。它把 markdown 待办清单渲染成面板，每次勾选、改标签或删除都写回那个文件，一次只动一行。MIT。

把一份 markdown 待办清单，在 DSH（DeepSeek Harness）右侧栏里显示成面板：还剩几件、已经做完几件、每件放了多少天、按标签筛，勾选、改标签、删除、调顺序都直接改回那个文件。

为什么用文件当数据库：清单可以进 git、任何编辑器能改、别的工具和智能体也能直接读写，不会被锁进某个 app 的数据库里。

它做什么

- 右侧栏「＋」面板里一张入口卡片，点开就是「待办」标签页
- 顶部两个大数字并排：还有几件事没做、已经完成几件（完成数用成功色，勾掉一件就跳一下）
- 数字下面一条完成度进度条：完成占比和百分比，勾掉一件就往前挪
- 列表按清单里的顺序排，按住任意一条上下拖动就能换位置，直接写回文件
- 每条可打一个标签，标签写在行首：- [ ] #工作 内容（记于 09-22 · 来源：周会）
- 标签自带颜色：筛选条与每条上的胶囊共用同一个色点，一眼分得清工作、开发、生活
- 顶部一排标签筛选，点一个只看那一类，带件数
- 悬停出现 ✕ 删除，删完 8 秒内可撤销；撤销靠行数核对，清单被别人改过就拒绝
- 勾选／改标签／删除／换位置都只动目标那几行，其余字符原样保留
- 超过 30 天没动的用橙字和左侧警示竖线标出来，顶部还报一句超期件数
- 底部显示清单最后改动时间，每分钟自动重读一次
- 色值全部取自主题变量，跟着 DSH 的明暗主题走

它不做什么

- 不做多清单，一次只挂一份文件
- 不做优先级字段，想要什么顺序自己拖
- 删除不弹二次确认，靠 8 秒撤销兜底

安装

需要 DSH 0.2.x（实测于 0.2.0-rc.2）。

方式一，走 dsh plugin：

dsh plugin --profile web add github:DavidLee2026/dsh-plugin-todo-panel

然后在 $DSH_HOME/profiles/web/cordis.patch.yml 里给它配上数据文件（$DSH_HOME 是 DSH 的数据目录，profile 名按你实际用的填）。同 id 的覆盖会整段替换 config，所以这里只写要改的字段：

- id: dsh-plugin-todo-panel
config:
todoFile: /path/to/todo.md

安装后如果右侧栏里没有「待办」，重启一次 DSH。宿主侧代码必须重启才生效。

方式二，手动装（适合要改代码的人）：

ln -sfn "$PWD" "$DSH_HOME/profiles/web/node_modules/dsh-plugin-todo-panel"

- insert:
- id: dsh-plugin-todo-panel
name: 'dsh-plugin-todo-panel'
config:
todoFile: /path/to/todo.md

配置

| 键 | 默认 | 作用 |
| todoFile | <DSH_HOME>/todo/todo.md | 清单文件路径；文件缺失时面板会直接告诉你该配哪个键 |
| tags | 工作／生活／开发／学习／其他 | 标签集合与颜色，形如 [{ id: 工作, color: 'var(--dsw-static-blue-500)' }] |
| waitingPattern | ^待 | 正文以它开头就标成「待确认」，表示在等别人回话 |

清单格式

完整示例见 examples/todo.md。

进行中

- [ ] #工作 把这周的会议记录整理成三条结论（记于 09-22 · 来源：周会）
- [ ] 预约体检（记于 08-01 · 来源：提醒）

已完成（近期）

- [x] #生活 交房租（记于 09-01 · 来源：提醒）

- 只有 - [ ] 与 - [x] 开头的行会被当成待办
- ## 已完成… 这类二级标题下的条目算历史，不进未完成计数
- 行首 #标签 可省；标签必须是配置集合里的，认不得就原样留在正文里
- 尾注 （记于 MM-DD 可省；省了就不算天数，日期那行只显示标签
- 其余字符一律原样保留，包括加粗、来源、你自己加的备注

数据接口

| 方法 | 路径 | 作用 |
| GET | /dsh-plugin-todo-panel/api/state | 未完成条目（文件顺序）、已完成／总件数、标签计数、最近完成 |
| POST | /dsh-plugin-todo-panel/api/toggle | { line, raw, done } 勾选状态 |
| POST | /dsh-plugin-todo-panel/api/tag | { line, raw, tag } 改标签，tag: null 清空 |
| POST | /dsh-plugin-todo-panel/api/delete | { line, raw } 删一条，返回原文与位置 |
| POST | /dsh-plugin-todo-panel/api/restore | { index, text, expected_lines } 撤销删除 |
| POST | /dsh-plugin-todo-panel/api/move | { line, raw, before } 换位置，before 为目标行号，null 表示本节末尾 |

写接口都要带 x-dsh-plugin-todo-panel: 1 请求头（跨站请求带自定义头要先过预检，过不了就写不进来），并且核对行号与原文，对不上返回 409，界面自动重读，不会写错行。

几个设计取舍

- 写文件是「读全文、改一行、写临时文件、改名替换」，没有文件锁；多个写入排成队列串行做
- 不做二次确认，用 8 秒撤销加行数核对兜底
- 撤销窗口内文件被别人改过，宁可拒绝也不猜位置
- 换位置只允许在同一节（同一个二级标题下）里做，跨节会改变条目归属，接口直接拒绝
- 拖动不改任何一行内容，只把那一行整行搬走，搬回原位等于没动，不写文件

开发与测试

npm test

9 个用例，全部在临时目录里的副本上跑，不碰真实清单。

推送到公开仓库前跑一遍脱敏自检：

npm run privacy-check

它扫所有被 git 跟踪的文件，查个人主目录路径、邮箱、凭据串、内网地址；真名、家人称呼、内部目录名这类词放在仓库根目录的 .privacy-patterns（一行一个，已在 .gitignore 里），不进仓库。有命中就退出码 1。

改完按这张表让它生效：

| 改了哪 | 怎么生效 |
| lib/client.js | 碰一下 cordis.patch.yml（加一行注释即可）触发重新组合，再刷新页面 |
| lib/index.js | 必须重启 DSH：宿主侧代码受 Node 模块缓存保护，热重载拿到的是旧模块 |
| 清单文件本身 | 面板每分钟自动重读，也可点「刷新」 |

插件接口细节、主题变量与升级时要复核的字段，见 docs/plugin-internals.md。

与同类插件的区别

生态里已有的 todo 类插件，多数是「点条目把文字填进输入框」，或者维护自己的 JSON 文件。这个只做一件事：把你已经在用的那份 markdown 清单当唯一数据源，改动写回文件本身，所以清单可以进 git、可以被别的工具和 agent 直接读写。

已知边界

- 对着 DSH 0.2.0-rc.2 写的，用的是内部的 slot 与 tab 注册接口；DSH 升级后接口若变，这里要跟着改
- 面板读本地文件，单机单清单，没有同步
- 清单同时被手工编辑时，写操作返回 409 让界面重读
- 进度条和「已完成」大数字要宿主侧回 done_count / total_count；宿主侧代码没重启时这两个字段缺失，面板自动不画，也不拿「最近完成 8 条」凑数
- 换位置要宿主侧回 open_items（未完成条目按文件顺序）；旧 payload 下列表照旧显示，但拖动先关掉，重启后才可用
- 拖动用指针事件实现，靠鼠标；触屏上按住也能拖，但没有单独的拖动手柄

许可

MIT。