Windows 回合通知 528085390/dsh-windows-notify

dsh-windows-notify

给 DeepSeek Harness 的 Windows 原生通知插件：每个回合结束时弹一条 WinRT toast，开关就在 DSH 设置页里，不用改配置文件。

特性

- 每回合一条。去重键是 <sessionId>#<turn>，同一个会话的第 2、3 回合都会弹（0.1.0 的 bug 见 CHANGELOG）。
- 开关在设置页。注册 settings.section（order 16），位于「插件」与「智能体预设」之间，改完立即生效，不用重启。
- 默认不吵。子代理会话的回合默认不弹（notifySubagents: false）。
- 零依赖。无构建步骤、无 npm 依赖、无 native 模块：宿主侧是一个 ESM 文件 + 一个 PowerShell 5.1 脚本，客户端侧是一个浏览器 ESM 文件。
- 可诊断。每回合一行日志（弹了 / 跳过 + 原因 + 真实 turn 号）。
- 插件页中英双语。locale/en.json + locale/zh.json 提供插件标题与描述，界面语言切到英文就显示英文；自带 icon.svg。

安装

要求：Windows 10 / 11（需要 Windows.UI.Notifications WinRT API）+ DSH >= 0.1.7-rc.1。

让智能体帮你装（最省事）

在 DSH 里新开一个会话，直接说：

帮我安装 https://github.com/528085390/dsh-windows-notify 这个插件

它会把这个地址写进配置档的 dependencies 和 dsh.profile.bundles，跑 pnpm install，然后提醒你重启 DSH。装了 DSH 命令行的环境里，等价于：

dsh plugin add https://github.com/528085390/dsh-windows-notify

图形界面 / 命令行

侧边栏 插件 → 添加插件，下面三种写法指向同一个仓库，任填一种：

https://github.com/528085390/dsh-windows-notify
git+https://github.com/528085390/dsh-windows-notify.git
github:528085390/dsh-windows-notify

命令行：dsh plugin add <上面任意一条>。

装完回到 插件 页把 dsh-windows-notify 这一项打开，然后重启 DSH —— 宿主半身在启动时 import，没有热重载。
想锁版本就加 #<commit>：https://github.com/528085390/dsh-windows-notify#<sha>。

为什么不能用包名安装

dsh plugin add <spec> 里，纯包名走 npm registry。本仓库没有发布到 npm，而 registry 上 dsh-windows-notify 这个名字属于另一位作者（Yxkzx，当前 1.0.2）——它同样是一个 DSH 通知插件、同样声明了 dsh.bundle.patch，所以装裸包名不会报错，只会静默装上别人的代码；两边包名还相同，会和本仓库的依赖记录撞在一起。

包名 ≠ 仓库名。要用包名安装，得先 npm publish；或者发布到自己的 scope（例如 @528085390/dsh-windows-notify），那要同时改 package.json 的 name 和 cordis.patch.yml 的 name:。

手动挂到配置档（离线 / 开发用）

1. 把本仓库放到任意目录，例如 ~/.dsh/local-plugins/dsh-windows-notify。
2. 编辑配置档的 package.json（桌面端是 ~/.dsh/profiles/desktop/package.json）：

{
"dependencies": {
"dsh-windows-notify": "file:../../local-plugins/dsh-windows-notify"
},
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-windows-notify"]
}
}
}

3. pnpm install（或让 DSH 自己装），然后重启 DSH。

插件自带的 cordis.patch.yml（package.json 的 dsh.bundle.patch）会插入 loader 行：

- insert:
- id: windows-notify
name: dsh-windows-notify
config:
enabled: true

⚠️ 不要再往配置档的 cordis.patch.yml 里手写同 id 的行，会双挂。
只写手挂行、不进 dependencies / bundles 的形态，重启后 boot 阶段解析不到包（实测日志里没有 plugin loaded）。

验证装上了

Get-Content "$HOME\.dsh\windows-notify.log" -Tail 5

应该能看到：

2026-10-20T07:46:11.212Z plugin loaded (config.enabled=true)
2026-10-20T07:46:13.134Z settings bridge ready at /api/dsh-windows-notify
2026-10-20T07:52:23.492Z toast session-bec4c0d4-...#3 exit=0 out=WINRT_OK

没有前两行 = 插件没加载，见 docs/troubleshooting.md。

使用

设置页（推荐）

设置 → 通知，可以调：

| 选项 | 默认 | 说明 |
| 启用通知 | 开 | 总开关，关掉后连测试通知也不弹 |
| 提示音 | 开 | toast 是否带声音 |
| 通知内容包含正文 | 开 | 关掉后正文固定为「本轮回答已完成」 |
| 摘要长度 | 80 | 正文最多取多少个字（20–300） |
| 标题前缀 | DeepSeek Harness | 标题格式是 <前缀> · <会话标题> |
| 子代理完成也通知 | 关 | 打开后子代理会话的回合也弹 |
| 发送测试通知 | — | 立刻弹一条，用来验证链路 |

命令行兜底

GUI 打不开时，插件目录里有 toggle.cmd（翻转开关）和 status.cmd（看当前值和最近日志）。
toggle.ps1 只改 enabled，不会冲掉设置页里调过的其它选项。

配置

选项的优先级：状态文件 > cordis 行 config > 内置默认，每个回合现读，所以改完立即生效。

状态文件 ~/.dsh/windows-notify.json：

{
"enabled": true,
"sound": true,
"includeText": true,
"notifySubagents": false,
"titlePrefix": "DeepSeek Harness",
"maxBodyChars": 80
}

字段类型与取值约束见 docs/bridge-protocol.md。

工作原理

- 宿主侧挂 agent/turn-stopping，用 powershell.exe（5.1）+ WinRT ToastNotificationManager 弹窗，AUMID 复用系统已注册的 PowerShell 快捷方式，不需要自建。
- 设置页通过一个同源 HTTP 桥读写选项（/api/dsh-windows-notify/*），不走 schemastery Config —— 原因见 docs/architecture.md。
- 客户端半身靠 package.json 的 dsh.client + exports["./client"] 被 DSH 自动发现，没有构建步骤。

细节：

- docs/architecture.md —— 事件流、去重键、子代理判定、客户端注册、生命周期
- docs/bridge-protocol.md —— HTTP 桥完整协议（路由、schema、状态码、同源守卫）
- docs/troubleshooting.md —— 9 个已知的坑与排查流程

目录结构

.
├── lib/
│ ├── index.js # 宿主半身：turn-stopping → toast，HTTP 桥 │ ├── client.js # 客户端半身：设置页「通知」分区 │ └── toast.ps1 # WinRT toast（纯 ASCII，PS 5.1） ├── locale/ │ ├── en.json # 插件页标题/描述（英文） │ └── zh.json # 插件页标题/描述（中文） ├── icon.svg # 插件页图标（导出为 ./icon，内联成 data URL） ├── cordis.patch.yml # bundle patch：插入 loader 行 ├── package.json # exports + dsh.client + dsh.bundle.patch ├── toggle.cmd/.ps1 # 命令行开关 ├── status.cmd/.ps1 # 命令行状态 + 最近日志 └── docs/

兼容性

| 项 | 要求 |
| 系统 | Windows 10 / 11（WinRT toast） |
| DSH | >= 0.1.7-rc.1（agent/turn-stopping、webServer、subprocess） |
| PowerShell | Windows PowerShell 5.1（C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe），不支持 pwsh 7 |
| Node | 跟随 DSH |

开发

没有构建步骤，改完 lib/client.js 刷新页面即可；改 lib/index.js（宿主）必须重启 DSH（模块在启动时 import，无热重载）。

语法检查
node --input-type=module -e "import('file:///C:/path/to/dsh-windows-notify/lib/index.js').then(m => console.log(Object.keys(m)))"

直接打一条测试通知（DSH 在跑的时候） curl.exe -s -X POST http://127.0.0.1:<port>/api/dsh-windows-notify/test

License

MIT © 2026 528085390