mywl6 / dsh-task-reminder

DSH 任务提醒插件（Task Reminder）

一个为 DeepSeek Harness (DSH) 设计的提醒插件：当一轮 AI 对话结束时、或 AI 向你提问需要你选择时，在页面右上角弹出提醒卡片并播放提示音，把注意力拉回工作台。

“该你操作了” —— 你最需要被提醒的那一刻。

功能

触发时机	监听的事件钩子	弹窗	提示音
该你操作了（AI 一轮结束 / 会话暂停）	agent/status → idle	绿色 “✔ 该你操作了”	上扬 “叮咚”
需要你选择/回答（AI 向你提问）	tools/result → ask_user_question	蓝色 “? 需要你选择”	清脆 “叮”
运行中的可自动纠错报错	——	不提醒（不打扰）	——

• 弹窗出现在右上角（shell.overlay 浮层，不遮挡对话内容）
• 每张卡片 10 秒后自动消失，也可手动点 × 关闭
• 提示音用 Web Audio API 生成，无需任何音频文件
• 不同事件不同声音，一听就知道该做什么

安装（复制粘贴即可）

这个插件是 动态 Cordis 插件，运行在 DSH 进程内，通过 DSH 自带的 cordis_* 工具注入。安装只需两步：

方式 A：让 AI 帮你装（最简单）

在任意 DSH 会话里对 AI 说：

请用本仓库 src/host.js 和 src/client.js 里的代码，通过 cordis_define / cordis_run 装一个任务提醒插件。

AI 会自动完成定义与运行。

方式 B：手动逐段复制

1. 打开任意 DSH 会话，调用 cordis_define 工具：
   • 把 src/host.js 的完整内容填入 Host 参数（code.host）
   • 把 src/client.js 的完整内容填入 Client 参数（code.client）
   • plugin 参数选择 new，填一个 3–6 位小写字母前缀（如 remind）
2. 拿到返回的 pluginId 和 packageId 后，调用 cordis_run（mode: "run"）激活。
3. 若提示 awaiting-approval，在页面上允许（Approve）即可。

工作原理

插件分两半：

• Host 半（src/host.js）：在 DSH 的 Node 进程里用 ctx.on(...) 监听事件钩子，把「该你操作了 / 需要你选择」转换成通知，压入内存队列，通过 harness.handle('poll', ...) 暴露给 Client。
• Client 半（src/client.js）：挂载到 shell.overlay 浮层，用 host.call('poll') 轮询通知，弹出卡片并用 Web Audio 生成提示音。

agent/status → idle      ─┐
                          ├─→ Host 队列 ──poll──→ Client 浮层弹窗 + 提示音
tools/result → 提问      ─┘

目录结构

dsh-task-reminder/
├── src/
│   ├── host.js        # Host 半：事件监听 + 通知队列
│   └── client.js      # Client 半：弹窗 + 提示音
├── reference/
│   └── formal-plugin.md  # 如何升级为正式插件包（monorepo 参考）
├── LICENSE            # MIT
└── README.md

注意事项

• 临时性：动态插件存活于当前 DSH 进程内；DSH 重启后需重新安装（见 reference/formal-plugin.md 了解如何持久化）。
• 声音授权：浏览器要求用户先与页面交互过一次才允许播放声音。首次安装后先点击一下页面即可。

License

MIT