TerricSH/dsh-notify

@terricsh/dsh-notify

给 DeepSeek Harness 的桌面通知插件：把审批请求 / 任务完成 / 出错等事件发成操作系统桌面通知，通知正文注明工作区 + 项目，点击通知可直接跳转到 Web GUI 里对应的会话（显示该会话的讨论内容）。

跨平台：

| 平台 | 通知方式 | 点击跳转 |
|---|---|---|
| Windows | PowerShell toast | ✅ 原生（点击整条通知或「打开项目」按钮） |
| macOS | terminal-notifier，缺失时退回 osascript | ✅ 装了 terminal-notifier 时；否则正文附链接 |
| Linux | notify-send | ⚠️ 正文附链接，notify-send 不支持点击打开 URL |

仓库：https://github.com/TerricSH/dsh-notify

目录结构

dsh-notify/
├── package.json      # 包元数据 + dsh.client 清单（注册 Client 半边）
├── lib/
│   ├── index.js      # Host 插件：监听事件 + 发通知 + 生成深链 URL
│   └── client.js     # Client 插件：读 cookie 并打开对应会话
├── cordis.patch.example.yml
└── README.md

- Host 半边（lib/index.js）是 host 平面插件：它监听进程级事件
（approval/request、agent/status、agent/error）并读 webServer 端口。
- Client 半边（lib/client.js）通过 package.json 里的 dsh.client 清单
注册进 Web 客户端，负责深链跳转。

发布到 GitHub / npm

npm publish                 # 发布 @terricsh/dsh-notify 到 npm
git push origin main        # 源码托管到 GitHub

发布 @terricsh/dsh-notify 前，需先在 npm 上拥有 @terricsh 这个 scope
（npm org create terricsh 或直接 npm adduser 后用该 scope 发布即可）。

使用方法

两种安装方式二选一。装好后，当代理产生以下事件时会弹系统通知，点击通知
即可定位到 Web GUI 中对应会话（显示该会话的讨论内容）：

- 审批请求（需要你批准某操作时）
- 任务完成（一轮对话结束）
- 任务出错

方式 A：从 npm 安装（已发布后，推荐）

1. 装进 web profile：

dsh plugin --profile web add @terricsh/dsh-notify

2. 加 host 引用行（见 cordis.patch.example.yml），编辑
$DSH_HOME/profiles/web/cordis.patch.yml（默认是 []）：

- insert:
- id: notify-desktop
name: '@terricsh/dsh-notify'

也可放到 home 级 $DSH_HOME/cordis.patch.yml（对所有 profile 生效）。

3. 重启：

dsh web

方式 B：本地源码安装（未发布到 npm 时）

1. 把本仓库目录链进 profile 的 node_modules。Windows（PowerShell）：

New-Item -ItemType Directory -Force "$env:DSH_HOME\profiles\web\node_modules\@terricsh"
New-Item -ItemType Junction
-Path "$env:DSH_HOME\profiles\web\node_modules\@terricsh\dsh-notify"
-Target "E:\dsh\dsh-notify"   # 改成你的仓库绝对路径

macOS / Linux 用 ln -s 建软链接到对应位置即可。

2. 同样编辑 cordis.patch.yml 加上面的 insert 行。

3. 重启 dsh web。

注意事项

- 平面归属：本插件是 host 平面插件（监听全局事件 + 读端口），所以引用
行要加在 cordis.patch.yml（host patch），不要加进某个 agent 预设的
agent.cordis.yml。
- Client 打包：dsh.client 清单会被 web 插件表扫描并打进前端 bundle；
若改动 lib/client.js 后页面没变化，需要重建 Web 产物（或运行 dev:web
观察器）。
- 深链原理：通知点击打开 /open-session?session=，Host 路由
写入一个 120 秒短 cookie 后 302 跳回 /（复用/重载已有标签页），Client
半边读 cookie 后 sessions.open(id) 并清除 cookie。

从动态插件改写而来的差异

| 动态插件（cordis_define） | 本 npm 包 |
|---|---|
| code.host / code.client 字符串 | lib/index.js / lib/client.js 真实模块 |
| harness.handle + host.call 深链握手 | 重定向路由写短 cookie，Client 读 cookie |
| /open-session 重定向路由（302 回 /）| 保留，用 cookie 传会话 ID |
| 临时、重启即失 | 落盘、可发布、可持久安装 |