idoall/dsh-notify

DSH Notify

为 DeepSeek Harness 提供页内任务通知：右上角浮层、铃铛历史、提示音，以及后台标签页标题闪动。

能做什么 ·
快速开始 ·
使用 ·
设置 ·
兼容性 ·
卸载 ·
更新记录

DSH Notify 是 DeepSeek Harness 社区插件，挂在官方侧边栏动作行与设置区块里，不修改 DSH 源码。

会话真正停下、运行失败、向你提问或请求审批时，当前页面右上角弹出浮层。goal 自动续跑、排队的下一轮不会每轮弹一次。侧边栏的铃铛保存历史：待处理/历史分栏、角标只数还在等你的条目，点一下跳回产生该通知的会话，提问与审批还能直接在浮层里回答。

一切都发生在你已经打开的这个页面里。没有 Service Worker、没有 Web Push、不做宿主机系统通知、也不需要安装任何 App——浏览器与操作系统通知矩阵是被故意删掉的：它们失败时对用户不可见（提交成功却永远看不到横幅），且无法跨平台做可靠。

能做什么

- 页内浮层：标题、正文、会话名、按类型着色的状态色、关闭按钮和倒计时条。点正文跳到该会话，点选项就地回答。
- 在浮层里回答：待回复的提问/审批会渲染与输入框一致的选项。在这里回答和在输入框里回答操作的是同一个待处理交互，两边实时同步。
- 铃铛历史：待处理/历史分栏、角标只数还在等你的提问和审批、每条带会话名与相对时间、分页、「全部标记已读」、待处理行的「已处理」，批量删除藏在「选择…」后面（没有任何破坏性操作是一点即中的）。
- 精确跳到那一轮：点一条通知会打开对应会话，并滚动到（短暂高亮）产生该通知的那一轮。
- 后台也能听见的提示音：用 WebAudio 在页面内合成（不带任何音频文件），也支持上传自定义音。页面隐藏时照样响——浏览器被别的应用挡住时，这是唯一能提醒到你的方式。
- 标签标题闪动：标签在后台且有未读时，标题加 🔔 前缀、favicon 交替成红点；你切回标签或未读清零就立刻停。
- 可信的已读状态：确认一条通知后，铃铛未读数立刻更新，而该行原地变成已读样式（二级边框 + 二级字色），只有重新打开列表时才移入「已读」——不会在你眼前跳来跳去。
- 按 profile 共享历史：记录存在 profile 自己的数据目录里。刷新页面、重启 DSH、或同一 Host 下换浏览器打开，看到的都是同一份历史。
- 噪声默认关：子任务与后台任务完成通知默认关闭（每个子代理、每个后台任务都会记一条，开久了很乱）。已读保留期限可选（一直保留 / 1 天 / 7 天 / 30 天后隐藏）。

快速开始

环境要求：

- 带 Web profile 的 DeepSeek Harness
- Node.js 20 或更新
- 已验证的 DSH 版本：0.1.5-rc.1（插件 0.1.0）

从 GitHub 装进 Web profile：

dsh plugin --profile web add "github:idoall/dsh-notify"

从本地克隆安装（本仓库的开发方式）：

git clone https://github.com/idoall/dsh-notify.git
cd dsh-notify
npm install
npm run build
dsh plugin --profile web add "link:$(pwd)"

重启 DSH，刷新 Web UI。客户端半边把铃铛挂到 sidebar.footer.action、设置卡片挂到 settings.section、浮层挂到 shell.overlay；宿主半边通过 cordis.patch.yml 挂载。

命名提醒：npm 上的 dsh-notify 属于另一位作者（一个 Windows 托盘通知插件）。本插件没有发布到 npm——请只按上面的 GitHub 或本地克隆方式安装，避免 dsh plugin add dsh-notify 装错成别人的插件。

使用

1. 跑一个任务。任务真正停下、失败或向你提问时，右上角出现浮层。铃铛角标只在还有待处理时出现。
2. 点浮层正文跳到对应会话；点选项就地回答；点 × 关闭（会标记为已读）。
3. 打开铃铛看历史。待处理行可以点「已处理」而不删除历史；点任意一条跳到它的会话与轮次；用「选择…」勾选后删除选中，或全部删除。
4. 切到别的标签继续干活：有待处理、或你离开期间新到的未读时标题会闪，任务完成时会响提示音——即使 DSH 页面在后台。
5. 一切都按 profile 持久化，刷新不会丢历史。

设置

设置 → 通知：

| 设置项 | 默认 | 作用 |
| --- | --- | --- |
| 已读通知保留 | 一直保留 | 从「已读」列表里隐藏更早的条目（1 / 7 / 30 天）。永远不会因此隐藏未读；宿主侧仍按容量上限淘汰最早的已读记录。 |
| Toast 位置 | 会话区右上 | 让浮层跟随会话栏右边缘——无论右侧栏展开还是收起都贴着会话区。 |
| 子任务 / 后台任务完成时通知 | 关 | 否则每个子代理、每个后台任务都会记一条（标题常常是命令行原文）。 |
| 页内提示音 | 开 | 每条新通知响一次，窗口不在最前也响。内置 chime / ping / alert / 静音，另可上传自定义音。 |
| 自测 | — | 只有一条通道，所以只有一张卡片；另有高级自测（持久历史、导航与未读、存储往返、去重）。页面加载不会自动发送测试。 |

自定义提示音上传到 profile 数据目录下的 /sounds/（不是插件安装目录），所以重装插件不会丢。上传上限 1 MB，仅支持 mp3 / m4a / aac / wav / ogg / flac；文件名必须是单段（不允许 ../ 或子目录）。

兼容性

当前发布：插件 0.1.1 已在 DeepSeek Harness 0.1.5-rc.1 上验证。

| 插件 | 已验证的 DeepSeek Harness |
| --- | --- |
| 0.1.1 | 0.1.5-rc.1 |
| 0.1.0 | 0.1.5-rc.1 |

更新的 DSH 版本不会自动声明兼容。若将来 DSH 变更导致插件失效，请停用或卸载它——不要去改 DSH 核心。

已在 macOS（Chrome 与 DSH 桌面壳）以及同一 Host 下的手机浏览器远程访问中验证。窄屏会自适应：浮层与历史面板变成全宽，且面板会被提升到浏览器顶层，fixed 的移动端侧栏无法再盖住它。

卸载

dsh plugin --profile web remove dsh-notify

卸载不会删除通知历史与已上传的提示音；它们在你自己 profile patch 指定的数据目录（config.dataDir）里。要清空就删掉那个目录。

开发

npm install
npm run verify     # typecheck + 测试 + 构建 + 打包检查
npm run test       # node --test test/*.test.js
npm run build      # dist/index.js、dist/client.js

仓库包含宿主半边（src/index.js、src/core.js、src/storage.js、src/sounds.js）、客户端半边（src/client.js）以及一套零依赖测试（test/）。dist/ 是构建产物，不入库。

许可证

MIT，见 LICENSE。