全局待办提醒 Meltllsy/dsh-todo-reminder

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 首次启动时读走做迁移。

提醒音怎么走

1. 自定义音效文件优先：音频解锁后探测 /api/todo/sound，命中则解码使用。
2. 内置合成音兜底：没有文件 / 解码失败时用 WebAudio 现场合成四种音色。
3. 系统通知兜底：音频尚未解锁时，由系统通知自己出声。

音频解锁靠 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 <dir> # 检查指定目录（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 是各自独立的插件，互不依赖，可单独安装。