dsh-windows-notify

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

中文 | English

特性

• 每回合一条。去重键是 <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。

让 agent 帮你装（最省事）

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

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

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

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:。

手动挂到 profile（离线 / 开发用）

1. 把本仓库放到任意目录，例如 ~/.dsh/local-plugins/dsh-windows-notify。

2. 编辑 profile 的 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

⚠️ 不要再往 profile 的 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