跨窗提醒 Aisland-SJL/dsh-reminder

dsh-reminder 🔔

English · 简体中文

DeepSeek Harness 的跨窗口提醒插件 —— 你在别的窗口干活时，任务完成或等待你批准的那一刻，它会拍拍你的肩膀。Codex / WorkBuddy 风格。

✨ 功能

| 🎯 | 功能 | 说明 |
| 🟢 | 完成提醒 | 每轮结束弹出「任务已完成」，带会话 · 耗时和绿色对勾图标 |
| 🟡 | 批准提醒 | 弹出「等待你批准」，带工具名和琥珀色警示图标 |
| 🎯 | 任意窗口都能弹 | 你在别的应用里干活也照样提醒 |
| 🖱️ | 点击返回 | 点一下就把 DSH 窗口拉到前台，并打开对应会话 |
| ⏱️ | 自动消失 | 3-5 秒后消失（可调） |
| 🎵 | 轻柔提示音 | 两声柔和的音（D4→A4），不吓人 |
| 🔁 | 去重 | 同一个事件绝不弹两次 |
| 🛡️ | 只提醒，不代劳 | 绝不替你批准 |

🤔 为什么做这个

- 😴 没人喊你批准 —— 你不在的时候智能体一直等着；现在有琥珀色弹窗告诉你
- 👀 没人告诉你干完了 —— 以前没有完成信号；现在有绿色弹窗告诉你

🚀 快速开始

1. 安装：dsh plugin --profile web add <dsh-reminder>（或 npm i dsh-reminder），在配置档的 bundle 列表里注册 dsh-reminder，重启 DSH web 进程
2. 授权：设置 → 提醒 → 「启用并测试通知」→ 允许 —— 测试弹窗立刻就到
3. 开用：切到别的窗口干活，弹窗自己来找你

⚙️ 设置

| 设置项 | 默认值 | 说明 |
| 通知权限 | 未设置 | 一键授权 + 测试弹窗 |
| 批准提醒 | 开 | 关掉 = 不弹批准提醒 |
| 完成提醒 | 开 | 关掉 = 不弹完成提醒 |
| 停留时长 | 3-5 秒 | 自动消失前的秒数 |
| 失败提醒 | 关（预留） | 计划在 v0.3 提供 |

🏗️ 架构

一个包同时提供 host 端 Cordis 插件和 web 客户端：

- host：注册设置命名空间，外加插件自有的 Typert Remote（reminder/getSettings · updateSettings）—— 插件命名空间不在 web 设置白名单内
- client：订阅会话列表和对话快照（turn/end、approval/requested 通过 mux 流送达），用 Notification API 弹窗，配 Web Audio 提示音
- 只读：绝不改动 DSH 核心行为

🔧 开发

pnpm install
pnpm run typecheck # tsc --noEmit
pnpm test # node tests/unit/.test.cjs (16 tests)
pnpm run build # esbuild: host ESM + single-file client CJS (ModuleLoader handshake) + tsc d.ts

- 产物：lib/index.js（host ESM）、lib/client.js（client）、lib/types/（.d.ts）
- 离线开发：不新增依赖；@deepseek-ai/ 类型和本地 esbuild/typescript 来自 03_local/codes（不在 git 里）

⚠️ 已知限制

- Chrome 页面通知不支持 actions（只有 ServiceWorker 持久通知才支持）——用自动关闭或悬停时出现的 ✕ 来关掉
- 权限必须由用户手势触发才能申请（浏览器策略）——设置按钮点一下就能搞定
- 提示音要在第一次点击后才会解锁（自动播放策略）

📄 许可证

MIT