macOS 通知中心 ihodorchenko/dsh-macos-notifications

dsh-macos-notifications

一个 DeepSeek Harness 的 Host 插件，通过通知中心发送 macOS 原生通知。应用本身只通知自己的更新，不通知智能体的工作进展，这个插件补上了这块空白。

插件跑在 Host 进程里（Desktop 应用背后的 Node 运行时），监听持久化的 session/event 事件流，每条提醒都调用 osascript 发出。它从不写会话日志，也从不与模型通信。

什么情况会触发通知

| 时机 | 默认 | 通知内容 |
| 一轮对话结束 | 开 | Turn finished / Ход завершён |
| 一轮对话失败 | 开 | Turn failed + 错误信息 |
| 一轮对话触及 token 上限 | 开 | Token limit reached |
| 请求审批 | 开 | Approval needed · <tool> |
| 智能体提问（ask_user_question、exit_plan_mode） | 开 | Your answer is needed · <question> |

用户主动取消的轮次（aborted）、分叉的轮次、被中断的轮次都不发通知。子代理会话一律忽略，只有你真正看得见的会话才会响铃。通知正文带上会话标题；标题还没生成时，用工作区文件夹名。

配置

每个字段都可选；插件行的 config 映射会覆盖这些默认值。

| 字段 | 默认值 | 含义 |
| language | auto | en、ru 或 auto（跟随宿主语言环境）。 |
| sound | Glass | 任意 macOS 声音名，设为 null 则静音横幅。 |
| notifyOnTurnEnd | true | 一轮对话完成、失败或被阻塞时通知。 |
| notifyOnApproval | true | 智能体等待审批决定时通知。 |
| notifyOnQuestion | true | 智能体向用户提问时通知。 |

- id: macos-notifications
name: dsh-macos-notifications
config:
language: ru
sound: Ping
notifyOnTurnEnd: true
notifyOnApproval: true
notifyOnQuestion: true

安装

从 GitHub 安装（Plugins 页面管理的就是这种方式）。 让智能体安装这个 bundle，或者在 Plugins 页面使用下面的 spec：

git+https://github.com/ihodorchenko/dsh-macos-notifications.git

plugin_manager 工具的 install_bundle.target 接受同样的 spec。bundle 补丁会插入 macos-notifications 行；包本身自带 dsh.bundle.patch、语言环境元数据和图标。

从本地检出安装。 把 install_bundle 指向包的绝对目录，或者给配置档的包管理器传 link:<absolute directory>。

不用 Plugin Manager。 Loader 也接受直接写文件 URL 的插件行。把下面这段加到 $DSH_HOME/profiles/desktop/cordis.patch.yml（或你配置档的补丁文件）：

- insert:
- id: macos-notifications
name: 'file:///absolute/path/to/dsh-macos-notifications/index.js'
config:
language: ru
应用运行时直接保存文件即可：配置档的 HMR 监听器会重新组合已加载的插件，新行随即出现，无需重启。YAML 出错会被拒绝，原有配置继续运行。

macOS 权限

第一条通知会触发系统弹窗，询问是否允许发送通知的进程（实际是 osascript / Script Editor）。如果没弹出，打开 System Settings → Notifications，为 Script Editor（或 macOS 提示的那个条目）开启通知权限。这是脚本驱动通知的平台限制：没有 bundle identifier 可供注册，所以点击横幅不会让 Harness 窗口获得焦点。

更新与移动

file: 行不受 HMR 监听，因为文件位于配置档目录之外。修改 index.js 后，touch 一下 cordis.patch.yml，或重启应用，让模块重新导入。移动或删除 checkout 会让 file: 或 link: 安装失效；请从新路径重新安装 bundle。

文件

| 文件 | 作用 |
| index.js | 宿主插件：会话事件监听、消息渲染、osascript 调用 |
| cordis.patch.yml | Bundle 补丁，插入 macos-notifications 行 |
| locale/en.json、locale/ru.json | Plugin Manager 显示元数据 |
| icon.svg | 插件图标 |