轮次完成通知 king-shao/dsh-turn-notifier

dsh-turn-notifier

DeepSeek Harness 宿主插件。每轮对话正常结束时发送一条系统通知，标题为会话名称，正文为本轮回答的摘要。对话执行期间你可以去处理其他事务，靠这条通知获知完成状态。

通知内容

| 字段 | 取值 |
| 标题 | 会话名称；会话尚无标题时使用配置项 title |
| 副标题 | 完成 · <耗时> |
| 正文 | 本轮回答的摘要 |
| 图标 | 包内 assets/whale.png |

点击通知可激活应用窗口。

投递通道

插件按运行环境自动选择通道，两者不会同时投递。

| 通道 | 触发条件 | 说明 |
| client | 页面处于运行状态 | 由页面内的 Notification 接口投递，以 DeepSeek Harness 自身身份显示，不需要额外的系统授权 |
| native | 页面未运行 | macOS 优先使用 terminal-notifier，不可用时回退 osascript；Linux 使用 notify-send；Windows 使用 PowerShell 的 WinRT toast |

页面以 2 秒间隔轮询宿主，轮询请求同时作为页面在线的心跳。宿主在每轮完成时将 {会话名称, 耗时, 摘要} 记录于内存，页面通过 GET /dsh-turn-notifier/last.json?after=<seq> 获取新事件，图标通过 GET /dsh-turn-notifier/icon.png 获取；两个路由均只接受回环地址的请求。

行为规则

- 仅在 reason.kind === 'completed' 时通知。用户中断、执行出错、策略拦截以及达到 max-tokens 的轮次均不通知。
- 默认跳过子代理会话（header.origin === 'subagent'），避免单次提问产生多条通知。
- 摘要取自本轮最后一段包含文本的 assistant 消息：移除 Markdown 标记、折叠空白，按 summaryChars 截断，并尽量在句末标点处结束。
- 通知投递失败仅记录宿主日志，不影响会话本身。

安装

<profile> 为配置档名称：桌面应用通常为 desktop，命令行的 Web 组合通常为 web。

从 GitHub Release 安装
dsh plugin --profile <profile> add "https://github.com/king-shao/dsh-turn-notifier/releases/latest/download/dsh-turn-notifier.tgz"

本地开发：链接源码目录
dsh plugin --profile <profile> add "link:/path/to/dsh-turn-notifier"

本地构建产物
dsh plugin --profile <profile> add "/path/to/dsh-turn-notifier-<version>.tgz"

已发布到 npm 时按包名安装
dsh plugin --profile <profile> add dsh-turn-notifier

dsh plugin 会将依赖写入配置档的 package.json，并将 dsh-turn-notifier 加入 dsh.profile.bundles；插件自身的 cordis.patch.yml 负责插入 Loader 条目。

注入行与路由均在宿主启动时注册，安装或升级后需要重启宿主。

配置

配置项位于 cordis.patch.yml 的 config 字段。

| 键 | 默认值 | 说明 |
| title | DeepSeek Harness | 会话尚无标题时使用的通知标题 |
| summaryChars | 180 | 摘要长度上限，取值不小于 40 时生效 |
| skipSubagents | true | 是否跳过子代理会话 |
| minSeconds | 0 | 仅提醒耗时不低于该值的轮次 |
| preferClient | true | 页面在线时使用页面内通知，避免与原生通知重复 |
| sound | Glass | 原生通道提示音名称；false 为静音 |
| icon | auto | 通知图标：auto 使用包内图标，也可指定绝对路径，false 为不显示；旧名称 contentImage 仍可识别 |
| activate | com.deepseek.dsh | 点击原生通知时激活的应用 |
| backend | auto | terminal-notifier、osascript 或 auto；Windows 与 Linux 固定按平台选择 |
| logFile | ~/.dsh/turn-notifier.log | 每次投递记录一行 JSON；空字符串表示关闭 |

平台支持

插件由纯 JavaScript 实现，不含原生依赖，各平台均可通过 dsh plugin add 安装，无需编译或额外运行时。桌面应用与 dsh web（浏览器）均支持页面内通知；在浏览器中首次使用时需授权通知权限。

| 平台 | 页面在线 | 页面未运行 | 图标 |
| macOS | 应用自身通知 | terminal-notifier（可选）→ osascript | terminal-notifier 与页面内通知显示图标，osascript 不显示 |
| Windows 10/11 | 应用自身 toast | PowerShell WinRT toast | appLogoOverride |
| Linux | 应用自身通知 | notify-send | -i 参数 |

macOS 上的 terminal-notifier 为可选增强项，提供更完整的排版、点击激活与图标；未安装时回退至 osascript 的纯文本横幅。

诊断

tail -n 5 ~/.dsh/turn-notifier.log # 每次投递记录一行，channel 字段标明通道
curl -s http://<host>:<port>/dsh-turn-notifier/last.json # 最近一次完成事件

卸载

dsh plugin --profile <profile> remove dsh-turn-notifier
随后从配置档的 package.json 中移除 dsh.profile.bundles 内的 dsh-turn-notifier，并重启宿主。

打包与发布

npm pack # 生成 dsh-turn-notifier-<version>.tgz
npm publish # 发布前需将 package.json 的 name 改为自有名称或 scope

包内含：lib/index.js（宿主插件）、assets/whale.png（通知图标）、cordis.patch.yml（挂载声明）、icon.svg（插件管理器图标）、locale/{zh,en}.json（meta.title 与 meta.description）、README.md、LICENSE。

package.json 的 exports 暴露 .、./package.json、./locale/*.json 与 ./icon；dsh.bundle.patch 指向 patch 文件。

限制

- 原生通道依赖平台的通知服务与授权状态。未授予通知权限时，通知不会展示，仅记录日志；页面在线时不受此限制。
- Windows 原生通道借用 Windows PowerShell 的 AUMID 发送 toast，通知中心显示的应用名称为「Windows PowerShell」，而非 DeepSeek Harness。该通道要求 Windows 10/11 且存在 powershell.exe，缺失时尝试 pwsh.exe。
- Windows 不支持自定义提示音名称：sound: false 生成静音 toast，其他取值使用系统默认提示音。
- 页面轮询间隔为 2 秒，通知最多延迟约 2 秒。
- 宿主进程未运行时不会产生通知。

许可

MIT。通知图标取自 DeepSeek Harness 应用图标，属于 DeepSeek 品牌素材；再分发或公开发布前请自行确认授权范围。