dsh-todo-reminder
DSH 的全局个人待办插件 —— 一份跟你所有会话、所有项目都无关的个人清单。
功能
- 全局面板：侧边栏「待办」入口打开，浮在页面中央（不再挂在会话列里）—— 任何会话下
打开都是同一份内容、同一个位置。新建（标题 / 备注 / 提醒时间 / 提醒样式 / 完成需确认）、
完成、删除；待办 / 已完成分区展示。Esc 或点空白处关闭。 - 右侧待办条（Dock）：窗口右缘常驻、可收起；收起时直接显示下一件要做的事
（到期时间 + 标题），逾期变红；展开可快速添加 / 勾完成 / 稍后提醒；可上下拖动，可关闭。 - 到期提醒：host 每 5 秒扫描到期任务，经 SSE 实时推到浏览器弹富 toast，动作有
「完成 / 稍后提醒（分钟数可自定义）/ 忽略」；切出到别的窗口时转成系统原生通知。 - 多种提醒样式：info（蓝）/ success（绿）/ warning（黄）/ danger（红，呼吸动画）。
- 提醒音：每种样式可单独开关响铃；音量、音色可调；可试听。
- 完成需确认：任务可开启，点「完成」先弹确认框。
- Agent 工具：todo_add / todo_list / todo_complete / todo_snooze / todo_delete。
> 本插件是原来那个「待办 + 会话提醒」二合一插件拆出来的待办模块。DSH 会话的
> 「跑完 / 提问 / 审批」提醒已经独立成 dsh-session-attention，两者数据、设置、
> 声效文件、接口全部独立，可单独安装、单独卸载。
安装
从 npm 装（推荐）：
dsh plugin --profile desktop add dsh-todo-reminder # 桌面端
dsh plugin --profile web add dsh-todo-reminder # 浏览器版
从源码装（仓库里已带构建产物 lib/，克隆后可直接指过去）：
git clone https://github.com/Meltllsy/dsh-todo-reminder.git
dsh plugin --profile desktop add link:<克隆目录>
> 改了源码想重新构建：npm install && npm run prepack（host 半 tsc → lib/，client 半 tsdown → lib/client.js）。
设置与数据
| 项 | 位置 |
|---|---|
| 数据文件 | $DSH_HOME/todo-reminder/todos.json（待办 + 提醒事件 + 设置，原子写） |
| 自定义提醒音 | $DSH_HOME/todo-reminder/sound.{mp3,wav,ogg,m4a} |
| HTTP 接口 | /api/todo/state、/api/todo/events（SSE）、/api/todo/sound、/api/todo/{add,update,delete,complete,snooze,dismiss-reminder,set-settings} |
拆分后 todos.json 里遗留的 settings.attention / settings.ball 由本插件忽略（不删）；
它们会被 dsh-session-attention 首次启动时读走做迁移。
提醒音怎么走
- 自定义音效文件优先：音频解锁后探测
/api/todo/sound，命中则解码使用。 - 内置合成音兜底：没有文件 / 解码失败时用 WebAudio 现场合成四种音色。
- 系统通知兜底：音频尚未解锁时，由系统通知自己出声。
音频解锁靠 document 上的手势监听自动完成（点 DSH 里任何地方即可）。页面内音效在前台/
后台都会响；页面完全关闭时不会响，那时只有系统通知，而浏览器通知只能用系统默认音。
构建
npm install # 只需一次
npm run prepack # host 半 tsc → lib/；client 半 tsdown → lib/client.js
host 半只依赖 node: 内置模块（自包含）；client 半经 tsdown 打包为 ModuleLoader 客户端，React 交给宿主运行时。
兼容性
本插件依赖 DSH 的一些内部点（服务名、事件名、DOM 类名、客户端包格式）。DSH 演进较快，
这些点在版本之间会变 —— 插件断掉往往不是插件自己的 bug，而是这里变了。所以仓库里带了一个自检脚本：
npm run check:compat # 检查本机已装的 DSH
node scripts/check-compat.mjs --from # 检查指定目录（CI 用）
实测结果：
| DSH 版本 | 结果 |
|---|---|
0.2.0-rc.2（当前） |
✅ 15/15 |
0.2.1-alpha.2（下一个） |
✅ 15/15 |
依赖点一览（断哪条、坏哪个功能，脚本输出里都写了）：
| 分类 | 依赖点 |
|---|---|
| 客户端 | __ModuleLoader__ 加载器格式、/plugins 资源路由 |
| 服务 | uiWorkspace.openSession、会话列表 byId 快照、host 的 webServer / systemPrompt |
| DOM | 类名含 sessionRow / newSession / centerCol |
| 事件 | session/event / turn/end / approval/asked / tool/call |
| 工具 | ask_user_question |
GitHub Actions 每周自动跑一次（含 alpha 版本），不通过就自动开 issue —— 所以 DSH 更新导致的不兼容
会被提前发现，而不是等用户先撞上。
> 与 dsh-session-attention 是各自独立的插件，互不依赖，可单独安装。
