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> 为 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 会将依赖写入 profile 的 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

随后从 profile 的 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 品牌素材；再分发或公开发布前请自行确认授权范围。