linfunss/dsh-win-notify

dsh-win-notify

用于 DeepSeek Harness 的 Windows 11 系统通知桥接插件。

CI

当某个工具操作需要用户确认以及当模型运行结束时，发送带品牌的系统 Toast 通知（DeepSeek 名称 + 鲸鱼图标 + 声音）——这样你就不必一直盯着 Harness 窗口了。

零运行时依赖。零构建步骤。纯 ESM JavaScript。

功能特性

| 场景 | 事件 | 标题 | 声音 |
| --- | --- | --- | --- |
| 需要用户确认 | approval/request（waterfall，仅观察） | 需要确认 | Notification.Looping.Alarm（循环播放） |
| 模型运行结束 | agent/status running → idle（已过滤子代理） | 运行完成 | Notification.Default |

DeepSeek 品牌，自愈式。 每次加载时，插件会：
1. 用纯 Node 重新生成 DeepSeek 鲸鱼图标（无需渲染库），并将其写入 %LOCALAPPDATA%\DeepSeekHarness\deepseek.ico；
2. 在 HKCU\Software\Classes\AppUserModelId\... 中（重新）注册 AppUserModelID DeepSeekAI.DeepSeekHarness，并附带显示名称和图标 URI。

Toast 通知通过 CreateToastNotifier(aumid) 发送，因此 Windows 会将其归属于 DeepSeek Harness 而非 PowerShell——正确的名称、正确的徽标、正确的声音。

注意：该图标是直接从官方 favicon 路径数据光栅化而来的，因为 librsvg（sharp 背后的渲染器）会将这个特定路径错误地缩放成一条细条。icon.mjs 中的扫描线光栅化器绕过了这个问题。

环境要求

- Windows 10/11（在其他平台上该插件为空操作）
- 带有 Web/桌面配置的 DeepSeek Harness（提供 @deepseek-ai/cordis peer）

安装

该包是一个标准的 DSH bundle：将其添加到你的配置文件的 dsh.profile.bundles 中，或手动插入该行。

方案 A —— 本地克隆（推荐用于开发）

git clone https://github.com//dsh-win-notify.git

然后从你的配置文件的 package.json（$DSH_HOME/profiles//package.json）中引用它：

{
"name": "dsh-profile-web",
"private": true,
"dependencies": {
"dsh-win-notify": "file:C:/path/to/dsh-win-notify"
}
}

安装并添加到 bundle 列表：

dsh plugin --profile web install
then add "dsh-win-notify" to dsh.profile.bundles in the profile package.json

方案 B —— npm（发布后）

dsh plugin --profile web add dsh-win-notify

方案 C —— git URL 依赖

"dependencies": {
"dsh-win-notify": "github:/dsh-win-notify"
}

然后在你的配置文件目录中运行 pnpm install（或 dsh plugin --profile web install）。

启用

将该包添加到配置文件的 dsh.profile.bundles 中（其 cordis.patch.yml 会插入 win-notify 行），或者你自己在配置文件的 cordis.patch.yml 中插入它：

- insert:
- id: win-notify
name: 'dsh-win-notify'

重启 DSH。现在你应该能在 设置 → 系统 → 通知 中看到 “DeepSeek Harness” 条目（确保其开关已打开；专注助手可能会静音 toast 通知）。

配置

所有字段均为可选：

- id: win-notify
name: 'dsh-win-notify'
config:
enabled: true                      # 默认：true
appName: DeepSeek Harness
aumid: DeepSeekAI.DeepSeekHarness
confirmationTitle: DeepSeek Harness · 需要确认
completionTitle: DeepSeek Harness · 运行完成
confirmationSound: Notification.Looping.Alarm
completionSound: Notification.Default

测试

node tests/icon.test.mjs      # 或：npm test

验证 ICO 结构、PNG 条目，以及鲸鱼图标确实能够渲染。

已知限制

- 系统通知设置必须允许 “DeepSeek Harness” 应用；专注助手可能会抑制 toast 通知。
- 在通知中心刷新之前，Windows 可能会缓存先前注册的图标（重启 DSH 以清除）。
- Toast 通知仅供参考；点击它们不会聚焦 Harness 窗口（未注册 ToastActivatorCLSID）。

许可证

MIT

中文说明

DeepSeek Harness 的 Windows 11 系统通知桥接插件：当工具操作需要用户确认、以及模型运行完成时，弹出带 DeepSeek 品牌（名称、鲸鱼图标、音效）的系统通知，不用一直盯着 Harness 窗口。

零运行时依赖、零构建步骤、纯 ESM JavaScript。

功能

| 场景 | 事件 | 标题 | 音效 |
| --- | --- | --- | --- |
| 需要用户确认 | approval/request（瀑布事件，仅旁观） | 需要确认 | Notification.Looping.Alarm（循环警报） |
| 模型运行完成 | agent/status running → idle（过滤子代理） | 运行完成 | Notification.Default（默认提示音） |

品牌自愈：每次加载时用纯 Node 重新生成 DeepSeek 鲸鱼图标（不依赖渲染库），写入 %LOCALAPPDATA%\DeepSeekHarness\deepseek.ico，并把 AppUserModelID DeepSeekAI.DeepSeekHarness 重新注册进 HKCU\Software\Classes\AppUserModelId\...（显示名 + 图标路径）。通知经 CreateToastNotifier(aumid) 发出，Windows 会将其归属为 DeepSeek Harness 而不是 PowerShell——名称、图标、音效都正确。

图标直接由官方 favicon 路径数据光栅化生成，因为 librsvg（sharp 底层）会把这条特定路径压扁成一条细线；icon.mjs 里的扫描线光栅化绕开了该缺陷。

安装

方式 A：本地 clone 后在 profile 的 package.json 里加 "dsh-win-notify": "file:...路径"，再 dsh plugin --profile  install。
方式 B：发布到 npm 后 dsh plugin --profile  add dsh-win-notify。
方式 C：git 依赖 "dsh-win-notify": "github:/dsh-win-notify" 后 pnpm install。

启用

把包加入 profile 的 dsh.profile.bundles（自带 cordis.patch.yml 会插入 win-notify 行），或在 profile 的 cordis.patch.yml 手动插入：

- insert:
- id: win-notify
name: 'dsh-win-notify'

重启 DSH。此时「设置 → 系统 → 通知」里会出现 DeepSeek Harness 条目（确保开关打开；专注助手可能静音）。

配置

全部可选：

- id: win-notify
name: 'dsh-win-notify'
config:
enabled: true
appName: DeepSeek Harness
aumid: DeepSeekAI.DeepSeekHarness
confirmationTitle: DeepSeek Harness · 需要确认
completionTitle: DeepSeek Harness · 运行完成
confirmationSound: Notification.Looping.Alarm
completionSound: Notification.Default

测试

node tests/icon.test.mjs      # 或 npm test

验证 ICO 结构、PNG 条目与鲸鱼渲染内容。

已知限制
- 需在系统通知设置中允许「DeepSeek Harness」；专注助手可能静音。
- Windows 可能缓存旧图标直到通知中心刷新（重启 DSH 可清除）。
- 通知仅作提示，点击不会聚焦 Harness 窗口（未注册 ToastActivatorCLSID）。

许可证

MIT