dsh-desktop-notify

中文 | English

给 Windows 上的 DeepSeek Harness 用的桌面提醒：需要你授权、向你提问、任务跑完、 出错、被中止时，屏幕角落弹出一张提醒卡片。点它，DSH 会自己浮到最前，并切到发出这条 提醒的那个对话。

它是为"你没在看 DSH"这个场景做的——你在别的窗口、看别的对话，或者全屏看视频。

仅 Windows。 不支持 macOS / Linux：整条链是 WinRT 通知 / PowerShell / Win32 窗口 激活。在其它系统上插件会加载但什么都不做。

覆盖哪些事件

该安静的时候它会安静：

环境要求

• Windows 10 / 11（x64）
• DeepSeek Harness 桌面版（profile 的宿主进程），0.1.7-rc.2 或兼容版本
• PowerShell 5.1 与 .NET Framework 4（Windows 自带）

没有 npm 依赖。除了想自己重建激活器（见下文）之外，没有构建步骤。

安装

这是一个 DSH bundle：一个声明了 cordis.patch.yml 条目的包。

方式一：插件管理器

在 DSH 里打开 设置 → 插件，用 spec 安装（git 简写或本地路径都行）：

github:VoodooB0Ys/dsh-desktop-notify

方式二：把本地检出 link 进 profile（本仓库开发时用的就是这个）

1. 把这个目录放到任意位置，例如 D:\tools\dsh-desktop-notify。

2. 编辑 %USERPROFILE%\.dsh\profiles\<profile>\package.json（<profile> 通常是 desktop，浏览器版是 web），加入：

   {
     "dependencies": {
       "dsh-desktop-notify": "link:D:/tools/dsh-desktop-notify"
     },
     "dsh": {
       "profile": {
         "bundles": [
           "dsh-desktop-notify"
         ]
       }
     }
   }

   原有条目保留不动——你只是往 dependencies 加一行、往 bundles 加一行。路径用正斜杠。

3. 装进 profile：

   cd %USERPROFILE%\.dsh\profiles\<profile>
   <自带 node> <自带 pnpm>/bin/pnpm.mjs install

   （桌面版自带 node/pnpm，在 %USERPROFILE%\.dsh\dsh-runtimes\ 下。）

4. 重启 Harness。 插件是在宿主启动过程中注册自己的路由的，热重载不够。

除此之外没有任何跟机器绑定的东西：插件里不存任何绝对路径，通知身份是运行时在 HKCU 里按当前用户创建的。

点击行为

点卡片会把目标对话 id 写进交接文件（%USERPROFILE%\.dsh\dsh-desktop-notify.activate）， 宿主轮询取走后让页面打开那个对话——等同于点侧边栏里那一行。同时把 DSH 窗口恢复并 短暂置顶 1.2 秒，这样即使被全屏视频盖住也能浮上来。

配置

默认值在本包的 cordis.patch.yml 里。要改就在你自己 profile 的 cordis.patch.yml 里加一段覆盖：

- id: desktop-notify
  name: dsh-desktop-notify
  config:
    channels:
      toast: false     # 是否另外发 Windows 系统通知（默认关，避免两条横幅叠一起）
      alert: true      # 提醒卡片（默认通道）
    classes:
      completion: false
    minTurnMs: 10000

如果你把 channels.toast 打开，插件会顺带注册它需要的 COM 激活器（见 《为什么点击需要 COM 激活器》）；关着的时候不注册任何东西。

排查

tail -f %USERPROFILE%\.dsh\dsh-desktop-notify.log            # 门与投递的判定
tail -f %USERPROFILE%\.dsh\dsh-desktop-notify.activate.log   # 点击与窗口唤前

每一步判定都会留痕：skip completion: user is looking at this conversation、 skip ...: deduped、skip ...: subagent session、card shown、card clicked。

快速确认宿主路由是否活着：

curl -X POST -H "content-type: application/json" -d "{\"focused\":true}" \
  http://127.0.0.1:<你的 dsh 端口>/dsh-desktop-notify/focus

返回 204 说明插件注册上了；405/404 说明没有——你正在跑的是旧宿主进程，重启它。

卸载

1. 从 profile 的 dependencies 和 bundles 里删掉 dsh-desktop-notify，在 profile 目录里跑一次 pnpm install，然后重启。
2. 可选：清掉它运行时创建的东西：

HKCU\Software\Classes\AppUserModelId\DeepSeekHarness.DesktopNotify
HKCU\Software\Classes\CLSID\{D7A1F0B2-3C4D-4E5F-9A0B-1C2D3E4F5A6B}   （只有用过 channels.toast 才会有）

为什么点击需要一个 COM 激活器

对未打包的 Windows 应用，两条看起来最直接的路实测都走不通——都是靠留痕判定，不是猜的：

激活器刻意编译成 winexe：控制台子系统每次点击都会闪一个黑框。用 .NET Framework 自带的编译器重建：

& "$env:WINDIR\Microsoft.NET\Framework64\v4.0.30319\csc.exe" -nologo -optimize+ `
  -target:winexe -platform:x64 -out:lib\dsh-notify-activator.exe lib\activator\NotifyActivator.cs

lib/register-activator.ps1 可以手动注册（并校验）COM 那半边。

已知限制

• 仅 Windows，x64。激活器是 .NET Framework 4 的 x64 二进制。
• 绑定 DSH ^0.1.7-rc.2 的事件与服务契约。DSH 内部版本之间会变；如果某个版本改名了 本插件订阅的事件，提醒就会失效。
• 首次安装必须重启宿主——路由是在启动过程中注册的。
• 卡片是我们自己的窗口，不是系统通知：不会进通知中心。想要通知中心里也留一份， 把 channels.toast 打开。
• 卡片不抢焦点、不进任务栏，但它是置顶窗口：如果还有别的东西也置顶，最终谁在上面由 系统按"最后显示"决定。

许可

MIT，见 LICENSE。