dsh-approval-notify-macos

macOS 专用。Windows 用户请看另一位作者的 dsh-approval-notify（Windows toast 通知）。

DeepSeek Harness（dsh）插件：每当 dsh 需要你审批一个操作（例如沙箱升权、敏感工具调用）时，弹一条 macOS 系统通知，提醒你回到 dsh 窗口处理。

而当你正盯着 dsh 窗口时，审批框本来就看得见，插件会自动安静下来，不打扰你。

只提醒，不作答。 本插件不会批准、不会拒绝，也不会延迟或替代原有的审批流程——它只是在审批请求发生时“顺手喊你一声”。

它会做什么

监听 dsh 内置审批服务的 approval/request 事件（瀑布式事件，waterfall），排在最终应答者（桌面界面）前面；
发一条通知后立刻把请求原样交给下一个监听器，审批结果完全不受影响；
通知内容：
- 标题：DeepSeek Harness
- 副标题：⚠️ 有操作等你批准
- 正文：<工具名>：<原因>，例如 bash：允许本次操作使用 workspace-write 权限：…
  - 优先使用审批请求的本地化展示文案（displayReason），没有时退回原始原因（reason）；
  - 都没有时只写工具名；连工具名都没有时写 未知操作；
  - 换行折成空格、去掉首尾空白，最长 160 个字符（超出截断并以 … 结尾）。
通知会在以下情况被跳过：
- dsh 窗口在最前面——你已经看得到审批框了（可用 notifyWhenFocused: true 关闭这一行为）；
- 节流——默认 3 秒内只发第一条，连续弹出多个审批时不会刷屏。

它不会拦截审批、不会记录工具参数（审批请求本身也不携带参数），不会联网，不会读写你的其他文件。

安装

要求：macOS + DeepSeek Harness 桌面版（0.2.x）。插件零依赖。推荐顺手装上 terminal-notifier，点击通知就能切回 dsh：

brew install terminal-notifier

首次使用 terminal-notifier 时，需要在「系统设置 → 通知」里找到 terminal-notifier 并打开「允许通知」。不装也能用，插件会改用 osascript 发通知（点击不会跳转）。

1. 用 dsh 自带的命令行安装插件（桌面版 App 内置了 dsh 命令行，路径如下）：

DSH="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
"$DSH" plugin --profile desktop add dsh-approval-notify-macos

也可以直接从 GitHub 装：add github:lostxiaoq/dsh-approval-notify-macos。这时 dsh 可能会提示「git-hosted plugins build on install via their prepare script…allowBuilds」，本插件没有任何构建脚本，这条提示可以忽略。

2. 把插件加进启用列表：编辑 ~/.dsh/profiles/desktop/package.json，在 dsh.profile.bundles 数组末尾追加 "dsh-approval-notify-macos"：

"bundles": [
  "@deepseek-ai/dsh-base",
  "@deepseek-ai/dsh-web-app",
  "dsh-approval-notify-macos"
]

3. 重启 DeepSeek Harness。 之后每当 dsh 请求审批、而 dsh 窗口不在最前面时，就会收到通知。

想在 headless 模式（dsh --profile headless）里也启用，把上面两步里的 desktop 换成 headless 即可。

升级插件：先 "$DSH" plugin --profile desktop remove dsh-approval-notify-macos，再重新执行第 1、2 步（只重复 add 时 pnpm 可能沿用缓存里的旧代码）。

本插件的 cordis.patch.yml 只插入一行，不覆盖任何已有配置：

- insert:
    - id: approval-notify
      name: 'dsh-approval-notify-macos'

配置项

在 ~/.dsh/profiles/desktop/cordis.patch.yml（或你自己的被包含的配置文件）里，按 id 覆盖这一行的 config：

- id: approval-notify
  name: 'dsh-approval-notify-macos'
  config:
    sound: 'Ping'
    throttleMs: 5000
    notifyWhenFocused: false

也可以直接改本插件的 cordis.patch.yml，在 insert 的那一行里写 config。

字段	默认	含义
`sound`	`"Glass"`	提示音名称（macOS 系统声音，如 `Glass`、`Ping`、`Submarine`、`Hero`、`Funk`；即 `/System/Library/Sounds/*.aiff` 的文件名）
`throttleMs`	`3000`	节流间隔（毫秒）。间隔内只发第一条，其余跳过（不排队、不合并后补发）；设为 `0` 表示不节流
`notifyWhenFocused`	`false`	`true` 时即使 dsh 窗口在最前面也照发通知

通知是怎么发的

按优先级依次尝试：

测试开关（见下文）：设置 DSH_APPROVAL_NOTIFY_LOG 时只写日志，不执行任何命令；
terminal-notifier：如果在 /opt/homebrew/bin/terminal-notifier、/usr/local/bin/terminal-notifier 或 dsh 进程的 PATH 里找到了它，就用它发：
```
terminal-notifier -title … -subtitle … -message … -sound <sound> -activate com.deepseek.dsh -group dsh-approval
```
-activate com.deepseek.dsh 表示点击通知会切回 dsh（推荐安装：brew install terminal-notifier，不装也能用，只是点击通知不会跳转）。
osascript：兜底 / 补发时使用 /usr/bin/osascript -e 'display notification … with title … subtitle … sound name …'。这种方式的局限性：
- 通知的 App 图标来自“脚本编辑器”（Script Editor）；
- 点击通知不会切回 dsh；
- 如果你的 macOS 对“脚本编辑器”关闭了通知权限，就看不到这一条通知。可以在「系统设置 → 通知 → 脚本编辑器」里打开。

失败补发：如果 terminal-notifier 启动失败（例如文件在但不可执行）、退出码非 0（例如没有通知权限时退出码 3）或超时，会改用 osascript 补发一次；退出码为 0 则不补发。osascript 也失败就算了，不再重试。补发同样在后台进行，不会等待、不会阻塞审批，也不会抛错。

所有命令都是异步执行、默认 5 秒超时（可用 DSH_APPROVAL_NOTIFY_TIMEOUT_MS 改，范围 100–60000 毫秒，超时用 SIGKILL 结束），且不经过 shell（参数以数组形式传入，天然免注入）。

前台检测

用 lsappinfo 判断当前最前面的 App：

lsappinfo info -only bundleid "$(lsappinfo front)"

解析出前台 App 的 bundle id，等于 com.deepseek.dsh 时就跳过本次通知。检测失败（命令不可用、输出格式变了、超时）时按**“不在前台”**处理——宁可多提醒一次，也不要漏掉。

测试开关（环境变量）

变量	作用
`DSH_APPROVAL_NOTIFY_LOG`	设为文件路径后，不真正发通知，而是往该文件追加一行 JSON：`{"title","subtitle","body","sound"}`
`DSH_APPROVAL_NOTIFY_FRONT`	模拟前台 App 的 bundle id。设置后不再调用 `lsappinfo`，用它判断“dsh 是否在前台”
`DSH_APPROVAL_NOTIFY_TN`	指定 terminal-notifier 的路径（通常指向假脚本）。设置后只用它，不再找默认位置；文件不存在视为没找到，直接走 osascript
`DSH_APPROVAL_NOTIFY_OSASCRIPT`	指定 osascript 的路径（默认 `/usr/bin/osascript`，通常指向假脚本）
`DSH_APPROVAL_NOTIFY_TIMEOUT_MS`	子进程超时毫秒数，取值夹在 `100`–`60000` 之间（非法值回退默认 5000）

手工试一下（不会弹任何系统通知）：

DSH_APPROVAL_NOTIFY_LOG=/tmp/approval.log \
DSH_APPROVAL_NOTIFY_FRONT=com.apple.finder \
node --input-type=module -e '
  import { apply } from "./lib/index.js";
  const regs = [];
  apply({ on: (name, fn) => regs.push(fn) }, { sound: "Ping" });
  await regs[0]({ toolName: "bash", reason: "需要联网" }, () => "delegated");
'
cat /tmp/approval.log
# {"title":"DeepSeek Harness","subtitle":"⚠️ 有操作等你批准","body":"bash：需要联网","sound":"Ping"}

开发与测试

node --test "tests/accept/*.test.mjs"

验收测试全部使用上面的测试开关（假命令脚本 + 日志模式），不会弹出系统通知。自己写测试或手工验证时请同样如此：要么设置 DSH_APPROVAL_NOTIFY_LOG，要么用假脚本指定 DSH_APPROVAL_NOTIFY_TN 和 DSH_APPROVAL_NOTIFY_OSASCRIPT，不要直接调用真实的 terminal-notifier 或 /usr/bin/osascript。

lib/index.js 的导出：

导出	说明
`apply(ctx, config = {})`	注册监听器（`ctx.on("approval/request", listener, { prepend: true })`）；节流状态属于这一次 `apply`
`buildNotification(req)`	由审批请求生成 `{ title, subtitle, body }`
`appleScriptFor(n)`	生成 `osascript -e` 用的 AppleScript 脚本（转义 `\` 和 `"`）
`default`	`{ apply }`

已知限制

只在 macOS 上有意义（lsappinfo、osascript、macOS 系统声音）。
“dsh 窗口在最前面”只在 dsh 桌面版（bundle id com.deepseek.dsh）下生效。
通知正文不包含工具参数（审批请求本身不携带参数）。
通知权限由 macOS 管理：如果终端通知被系统关闭，插件不会报错，只是你收不到。

怎么做出来的

需求规格（SPEC.md）和验收测试（tests/accept/）由 Claude 编写，插件代码由 DeepSeek Harness 自己（模型 DeepSeek-V4.1-Flash）实现，再由 Claude 审查并在真实的 dsh 里做端到端验证。

许可

MIT

dsh-approval-notify-macos

Install

Source

Tags

Creators

Readme

dsh-approval-notify-macos

它会做什么

安装

配置项

通知是怎么发的

前台检测

测试开关（环境变量）

开发与测试

已知限制

怎么做出来的

许可