dsh-desktop-notify

使用

权限确认

1. 让窗口失去焦点（切到其他应用或最小化）。
2. 触发一次需要审批的工具操作。
3. 系统通知出现「拒绝 / 允许一次」；点击后工具立即继续或被拒。
4. 如果切回 DSH 窗口，通知会被关闭并改由应用内审批面板处理。

窗口在前台时不会弹通知，直接使用原生面板。

其他提醒

• 提问提醒：Agent 调用 ask_user_question 时通知；通知不接管问答，点击正文聚焦应用。
• 任务完成：根会话的 running → idle 转变触发。
• 错误提醒：根会话的 agent/error 触发；相同错误 2 秒内去重。

铃声

在「设置 → 通知提醒 → 通知铃声」选择：

• 系统提示音：Windows 使用 Notification.Default（可在「通知铃声」分组填写系统声音名覆盖）；macOS 使用 Bottle；Linux 尝试 canberra-gtk-play。
• 内置铃声：assets/notify.wav，原创双音提示音，通过平台播放器播放。
• 自定义音频文件：绝对路径。Windows 仅支持 .wav；macOS/Linux 取决于系统播放器。
• 静音：不播放铃声。

「试听」按钮会按当前模式实际播放一次。

配置项

配置文件位于 profile 的 cordis.patch.yml（设置页写入），entry id 为 desktop-notify：

字段	默认值	说明
enabled	true	插件总开关
approval.enabled	true	接管权限确认通知
approval.onlyWhenHidden	true	仅窗口不在前台时接管
approval.timeoutSeconds	30	通知等待上限（5–300）
events.question	true	提问提醒
events.turnEnd	true	任务完成提醒
events.errors	true	错误提醒
events.onlyWhenHidden	true	三类提醒仅后台
sound.mode	bundled	system / bundled / custom / none
sound.file	""	自定义音频绝对路径
sound.systemName	""	Windows/macOS 系统声音名覆盖
windows.appId	""	可选：手工指定 Windows AppUserModelID；留空自动读取已注册的 DeepSeek Harness.lnk
windows.duration	long	Windows toast 展示时长（short / long）；Windows 对带按钮的 toast 可能忽略该值
macos.customNotifierPath	""	可选定制 terminal-notifier
presence.staleSeconds	120	客户端在场状态过期时间
presence.idleSeconds	180	前台但无输入超过该秒数按离开处理；0 关闭