kongbaiming5/dsh-approval-alert

中文 | English

一个 DeepSeek Harness 插件：当 DSH 卡在「需要你授权」时，用 macOS 自带系统提示音提醒你。

覆盖范围

来源	例子
DSH 工具审批	沙箱升级、危险命令、写工作区外文件
DSH Agent 提问	ask_user_question、计划审阅 exit_plan_mode
macOS 系统权限弹窗	麦克风、摄像头、屏幕录制、辅助功能、自动化、文件与文件夹、完全磁盘访问
macOS 管理员密码弹窗	sudo、sfltool、安装器请求 system.privilege.admin 时弹出的「想要进行更改」密码框

macOS 权限弹窗只处理 TCC identity 为 com.deepseek.dsh / DeepSeek Harness 的请求，其他 App 的权限弹窗不会触发。

管理员密码弹窗走的是另一条链路（com.apple.Authorization / SecurityAgent），不属于 TCC，也不区分发起 App，所以单独有 watchPrivilegePrompts 开关。若同一个对话框同时命中两条链路，只响一次。

在 DSH 里怎么找到它

安装并启用 bundle 后：

1. 打开侧边栏 插件；
2. 在 已安装插件 里找到卡片 「授权提醒」（包名 dsh-approval-alert）；
3. 卡片右侧开关控制整个 bundle；点进卡片，里面的 approval-alert 行也有自己的开关；
4. 点行标题/配置按钮，打开 中文配置表单，保存后立即生效。

插件在 DSH 的 设置 → 内置插件 → 插件列表 里也会显示为 approval-alert，但那只是只读的运行状态；日常配置请用侧边栏「插件」里的表单。

提醒节奏

第一次在需要授权的瞬间立即响，之后：

第几次	距上一次
第 1 次	立即（0 秒）
第 2 次	25 秒后
第 3 次	20 秒后
第 4 次	15 秒后
第 5 次	10 秒后
第 6 次及以后	每次 5 秒后

• 每次提醒默认双响（间隔 0.38 秒），可在表单里调「每次响几声」。
• 你点允许/拒绝、回答问题，或系统弹窗返回结果后，立即停止。
• 多个请求共用一条节奏，全部处理完才停。
• macOS 权限弹窗另有 systemPromptTimeoutMs 安全上限（默认 10 分钟），防止日志漏掉结果时无限响。
• 管理员密码弹窗在点「取消」或输入密码通过后立即停，另有 privilegePromptTimeoutMs 上限（默认 3 分钟）。

安装

一键安装（从 GitHub 克隆）

git clone https://github.com/kongbaiming5/dsh-approval-alert.git
cd dsh-approval-alert
./scripts/install.sh desktop

脚本会：

1. 找到 dsh CLI（$DSH_BIN、PATH 或 macOS App 包内路径）；
2. 把当前目录作为本地包加入 $DSH_HOME/profiles/<profile>/package.json；
3. 把 dsh-approval-alert 加入 dsh.profile.bundles，让侧边栏「插件」识别它；
4. 如果检测到旧的「手动 insert」条目，会提示你删除，避免重复挂载。

如果 DSH 正在运行，bundle 列表变更通常需要重启一次 App；重启后即可在侧边栏「插件」看到「授权提醒」。

通过插件页安装

侧边栏 插件 → 添加插件 → 安装第三方插件，填入本仓库的本地绝对路径，安装完成后启用 bundle。配置表单同样会出现在「授权提醒」的详情页。

环境要求

• macOS 13 或更新版本（在 macOS 26 / Apple Silicon 上实测）。
• 带 profile 插件机制的 DeepSeek Harness（在 0.2.1-rc.2 上实测）。
• Node.js 20+ 仅用于跑测试；DSH 运行时自带 Node。

插件市场

• dsh.so 插件市场：已收录，见 dsh.so 插件页（页面上也有本 README 顶部的作者徽章）。
• DSH 社区插件目录：已向 awesome-dsh-plugin 提交收录 PR，合并后会出现在侧边栏 插件 → Discover / 插件市场，可搜索 「授权提醒」 或 dsh-approval-alert。

也可以直接从 GitHub 安装：

dsh plugin --profile desktop add github:kongbaiming5/dsh-approval-alert

市场目录由人工审核，PR 合并后通常一天内生效。没有 npm 包也能安装；最新 GitHub Release 附带预构建 tarball，市场会优先用它，跳过源码构建。

Web profile 也能正常启动；配置表单依赖插件管理器，因此在带插件管理器的 desktop profile 中显示。

配置表单

在「授权提醒」的配置页里可以改：

配置	默认	说明
启用授权提醒	开	总开关；关闭后所有来源都不响
提示音	Glass	macOS 系统音效名，或绝对音频路径
音量倍率	1	afplay -v 倍率；1 = 跟随当前系统输出音量
每次响几声	2	每次提醒双响；1–4
同时弹一条系统通知	开	首次提醒时弹通知
DSH 工具审批	开	审批请求
Agent 提问 / 计划审阅	开	ask_user_question、exit_plan_mode
macOS 系统权限弹窗	开	DSH 触发的 TCC 弹窗
系统弹窗安全上限	600000	毫秒；0 表示不自动停止
macOS 管理员密码弹窗	开	SecurityAgent 的提权表单（sudo、sfltool、安装器）
密码弹窗安全上限	180000	毫秒；点取消/通过后立即停
通知语言	zh	中文 / English
诊断日志文件	空	例如 /tmp/dsh-approval-alert.log

保存通过 DSH 的插件配置机制写入 profile patch，不需要手动编辑 YAML。高级用户仍然可以直接编辑 $DSH_HOME/profiles/<profile>/cordis.patch.yml 里的 approval-alert 配置覆盖。

验证

声音链路

在配置表单里确认「启用授权提醒」为开，保存；触发一个 DSH 审批或系统权限弹窗。第一次应立即响，之后按 25/20/15/10/5 秒节奏重复。

macOS 权限弹窗（麦克风）

tccutil reset Microphone com.deepseek.dsh
ffmpeg -f avfoundation -i ":0" -t 0.5 -y /tmp/dsh-mic-test.wav

系统弹出「DeepSeek Harness 想访问麦克风」的同时，插件应立即响第一声；点允许/拒绝后停止。这个命令只重置 DSH 的麦克风授权状态，不影响其他 App。

DSH 工具审批

把会话权限策略切到 ask，让 Agent 申请更宽的沙箱权限。提示出现时立即响，点允许/拒绝后停止。

macOS 管理员密码弹窗

osascript -e 'do shell script "true" with administrator privileges'

弹出的「想要进行更改」密码框出现时立即响第一声；输入密码或点取消后停止。这个命令只用管理员权限执行 true，不改任何东西。

工作原理

• DSH 审批 / 提问：在 approval/request 和 user-questions/request 两个 Cordis waterfall 上注册前置监听器；开始提醒后调用 next()，不改变原来的审批/回答链路。
• macOS TCC 弹窗：后台运行一条只过滤 com.apple.TCC 的 log stream。匹配到 AUTHREQ_PROMPTING + com.deepseek.dsh 就开始提醒；匹配到对应的 AUTHREQ_RESULT 就停止。日志流退出时会自动重启。
• macOS 管理员密码弹窗：另起一条只过滤 SecurityAgent + com.apple.Authorization 的 log stream。Using modern UI / SC confirmation dialog detected 视为密码框出现，ExecuteWithPrivileges 的完成记录视为关闭。两条链路共用一个提醒引擎与同一个安全上限机制。
• 配置热更新：所有配置字段都是 volatile，表单保存后 Host 直接读取新值，不需要重启插件。
• 无网络、无凭据：只调用 afplay、log，通知回退时用 osascript。

通知说明

首次提醒时会尝试弹一条系统通知。通知优先使用 Electron 原生通知；当前 desktop Host 是纯 Node 进程，拿不到 Electron API，因此会退化为 osascript display notification，通知来源可能显示为「脚本编辑器 / Script Editor」。不需要通知就在表单里关掉，声音不受影响。

排查

现象	检查
插件页没有「授权提醒」	确认 dsh.profile.bundles 包含 dsh-approval-alert；重启一次 App；检查 profile 里是否还留着旧的「手动 insert」
有卡片但配置页打不开	确认 bundle 行 approval-alert 是开启状态；重新打开插件页
完全没声音	afplay /System/Library/Sounds/Glass.aiff；检查系统音量/静音；确认「启用授权提醒」和对应来源开关
macOS 弹窗不触发	log show --last 1m --predicate 'subsystem == "com.apple.TCC"' 看有没有 AUTHREQ_PROMPTING 和 com.deepseek.dsh；打开诊断日志看 tcc prompt
一直响不停	TCC 结果可能漏了；看诊断日志里有没有 tcc result；调小「系统弹窗安全上限」
密码弹窗不响	log show --last 1m --predicate 'process == "SecurityAgent" AND subsystem == "com.apple.Authorization"' 看有没有 Using modern UI、SC confirmation dialog detected；诊断日志看 privilege prompt / privilege resolve
密码弹窗响了不停	打开诊断日志确认有没有 privilege resolve reason=completed；没有就等 privilegePromptTimeoutMs 上限
通知显示「脚本编辑器」	当前 Host 的回退行为；关掉通知即可

安全与隐私

• 不发起网络请求，不读取凭据，不做遥测。
• TCC watcher 只读 com.apple.TCC 的 prompt/result 行，并过滤为 DSH 的 bundle identity；其他 App 的权限弹窗会被忽略。
• 密码弹窗 watcher 只读 SecurityAgent 在 com.apple.Authorization 子系统里的对话框生命周期行，不读取密码、不注入进程、不需要任何授权。
• 诊断日志只写本地事件名、服务名、PID 和计时；不调试时留空。
• 安装脚本只修改选定的 DSH profile，不改 App 包和系统设置。
• 文档里的 tccutil reset 是显式、可选的重新测试权限弹窗的方法。

开发与测试

npm test
# 或：
node --test test/core.test.mjs test/index.test.mjs test/tcc.test.mjs test/client.test.mjs

测试不需要安装依赖；使用假时钟、假进程、真实 TCC / SecurityAgent 日志行和假的模块加载器。25 个用例覆盖提醒节奏、TCC 解析、密码弹窗解析、监听器接入和浏览器配置页注册。

lib/core.js    节奏、afplay、通知
lib/tcc.js     TCC 与 SecurityAgent 日志流与解析
lib/index.js   Cordis Host 插件
lib/client.js  插件页中文配置表单
locale/        中文/英文显示名与描述
icon.svg       插件图标
test/          Node 内置 test runner 用例

License

MIT，见 LICENSE。