dsh-plugin-system-notify
给 DeepSeek Harness 的 AI 一个工具，让它能给你发一条系统级通知（macOS 通知中心 / Windows Toast / Linux 桌面提醒）——窗口在后台或最小化时也能弹出，而且通知的归属是 DSH 本体。
AI 调用 system_notify
↓
通知横幅弹出
DeepSeek Harness 🔔
为什么通知由「DSH 本体」发出
这件事不是配置问题，是 macOS 的归属规则：通知归属发起它的那个应用，不是它的父进程。
| 做法 | 归属 | 结论 |
|---|
osascript display notification | 脚本编辑器（Script Editor） | ❌ /usr/bin/osascript 是脚本编辑器的 shim，换父进程也没用 |
临时 helper .app（带 DSH 图标） | 无 | ❌ 未正式签名的 bundle 无权发通知，系统直接丢弃 |
| 页面里的 Web Notification API | 承载页面的应用 | ✅ 桌面应用内即 DSH 本体 |
所以本插件不走脚本路线：Host 侧只负责「要发通知」这件事，真正弹出通知的是渲染 DSH 页面的那个进程。
实测归属（macOS 系统通知数据库 + 系统日志）：
record 22129 | com.deepseek.dsh
usernoted: id=n#dsh-app://app#dsh-system-notify-2, bundle=com.deepseek.dsh
NotificationCenter: addOrUpdate(...) listItem: com.deepseek.dsh:... alertStyle: banner
安装
# 在 DSH 里，用 plugin_manager 安装本仓库
plugin_manager install_bundle /path/to/dsh-plugin-system-notify
或者把依赖加进 profile 的 package.json：
{
"dependencies": {
"dsh-plugin-system-notify": "github:DRheEheAMGary/dsh-plugin-system-notify"
},
"dsh": {
"profile": {
"bundles": ["dsh-plugin-system-notify"]
}
}
}
工具
system_notify
| 参数 | 必填 | 说明 |
|---|
title | 是 | 通知标题，约 60 字符以内 |
body | 是 | 正文，一句话，约 120 字符以内 |
silent | 否 | 静音投递，默认 false |
返回：
{ "ok": true, "id": 1, "delivery": "delivered", "surface": "desktop" }
delivery: "delivered" —— 有窗口正在监听并已接手delivery: "queued" —— 暂无窗口连接，连上后立即补发surface: "desktop" | "browser" —— 实际由哪种界面弹出（决定通知归属）
结构
双半部插件：
- Host 半部（
index.js）注册 system_notify 工具，把每次请求放进收件箱（lib/hub.js），并开一条 GET /api/system-notify/inbox 长轮询路由（带 Host/Origin 与浏览器凭证校验）。
- Client 半部（
client.js）常驻一个长轮询请求；Host 一有通知立刻返回，页面随即用 new Notification(...) 弹出。
用长轮询而不是定时轮询：通知几乎即时，且空闲时不产生每秒一次的请求。
桌面窗口优先：客户端会声明自己是 desktop（DSH 桌面窗口）还是 browser（浏览器标签）。只有桌面窗口能给出 DSH 身份，所以它优先接手；浏览器标签只在没有桌面窗口时才接。
无权限的客户端不领通知：拿不到通知权限的页面不会去领取，否则通知会被「领走但弹不出来」，而 Host 还误报成功。它会先申请权限，拿到后才开始领取。
平台支持
| 平台 | 状态 |
|---|
| macOS | ✅ 已实测（归属 com.deepseek.dsh） |
| Windows | ⚠️ 理论可用，未实测 |
| Linux | ⚠️ 理论可用，未实测 |
插件本身不含任何平台相关代码（无 osascript / PowerShell / notify-send），走的是浏览器标准的 Web Notification API，由各平台的应用运行时翻译成本地通知。
Windows 上唯一的前提是应用有注册过的 AppUserModelID（由安装器写入开始菜单快捷方式）——如果 Toast 不弹，先在「设置 → 系统 → 通知」里看列表中有没有出现 DeepSeek Harness。另外专注助手/勿扰模式会拦截 Toast。
限制
- 需要至少一个 DSH 页面（桌面应用窗口或浏览器标签）处于打开状态；全部关闭时通知排队（最多 2 分钟），窗口连上后补发。
- 在浏览器标签里打开 Web GUI 时，通知归属是该浏览器，不是 DSH——这是平台决定的，绕不过去。
- 通知是单向的：不会把窗口切到前台，也不会等待用户回应。
License
MIT
