前言¶
在 DeepSeek Harness（DSH）里跑多会话、长任务时，你往往切到别的窗口或标签页等模型写完。没有明确信号时，只能靠反复切回界面看是否还在转圈。系统通知是常见做法，但若在浏览器里用客户端状态猜「是否跑完」，在 DSH 0.2.x 一类版本里很容易静默失效：列表里的 running 不一定再给出 true → false 边沿，根级插件也未必能拿到每个会话的 binding()。
下面介绍社区插件 dsh-notify（维护者 SailingBoat-ovo），它走 DSH 文档化的 session/event 与稳定的 turn/end，在宿主侧感知完成、在浏览器侧弹通知，并带上 DeepSeek 鲸鱼图标和会话标题。
这是什么¶
dsh-notify 是 DSH 的 web / desktop 插件：当任意会话里一轮 AI 回复结束（turn/end）时，通过操作系统或浏览器的系统通知提醒你哪条任务已完成。在 SkillHub 社区目录中归类为「趣味换装」；仓库当前版本为 0.1.0，许可证 GPL-3.0-or-later。
插件分两半协作：宿主订阅会话日志的 session/event 并对 turn/end 反应；浏览器通过 Server-Sent Events（SSE）收到完成帧后弹出通知。会话标题来自宿主持有的会话 header，而不是 UI 投影。
核心功能¶
经 README 核实，行为如下：
- 触发范围：任意会话的每一轮结束都会通知，不限于当前前台会话。
- 文案：标题为「任务完成」；若该轮失败则为「任务出错」。正文为对应会话的标题。
- 图标：DeepSeek 黑鲸标记，由宿主提供
GET /dsh-notify/whale.svg，浏览器侧栅格化为 PNG（便于 Windows toast 使用位图）。 - 交互：点击通知可让外壳聚焦该会话。
- 连接：浏览器侧使用
EventSource订阅流，自带重连。
宿主暴露的 HTTP 路径（资料原文）：
| 路径 | 用途 |
|---|---|
GET /dsh-notify/stream |
完成事件的 text/event-stream |
GET /dsh-notify/completions |
最近的完成记录与当前序号 |
GET /dsh-notify/whale.svg |
鲸鱼图标 |
设置界面（设置 → 通用）会显示通知权限、「发一条测试通知」 按钮，以及连接状态，例如：
连接：已连接 · 已收到 3 条完成事件
安装与启用¶
按官方 README，分别对 web 与 desktop 配置安装（命令须完整照抄，装完后必须重启 DSH；宿主半边在启动时加载，只刷新页面不够）：
dsh plugin --profile web add github:SailingBoat-ovo/dsh-notify
dsh plugin --profile desktop add github:SailingBoat-ovo/dsh-notify
首次使用需在系统或浏览器中允许通知权限；可在上述设置页用测试按钮验证。
典型用法与排查¶
安装并重启后，正常使用 DSH 会话即可：无需额外配置项（资料中未列出独立配置文件字段）。当某会话 AI 轮次结束，应收到带鲸鱼图标的通知；点击即可回到该会话。
若异常，可按 README 区分两类情况：
- 测试按钮能弹、但「已收到」计数一直是 0：宿主插件未加载，应重启 DSH。
- 计数在涨、但没有弹窗：系统或浏览器在拦截通知，需在 OS / 浏览器通知设置里放行 DSH 或对应站点。
开发者在仓库内跑测试：
npm install
npm test
tests/host-test.mjs 与 tests/client-test.mjs 分别覆盖宿主事件映射、SSE 路由与客户端通知、权限与设置行等（断言数量见 README）。
适用场景与注意¶
适合：长时间等待模型输出、同时开多个 DSH 会话、希望用系统级提醒而不是盯界面的开发者。
注意：
- DSH 生态强调「一切皆插件」；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。
- 插件以当前 dsh 进程权限 运行，安装前请阅读 源码与许可证。
- 设计刻意避免依赖
sessions.list.byId[*].running或根级sessions.binding(id).session等私有内部行为；扩展应依赖session/event与turn/end（dsh-session包将订阅session/event作为持久化类插件的文档化接缝）。
结尾¶
dsh-notify 用宿主 + SSE 的稳定事件链，在 AI 轮次结束时弹出带 DeepSeek 鲸鱼图标的系统通知，并支持点击聚焦会话。需要安装命令与实现细节时，见社区目录页与 GitHub 仓库：
- 目录页：https://www.skillhub.cn/plugins/SailingBoat-ovo/dsh-notify
- 仓库：https://github.com/SailingBoat-ovo/dsh-notify
