dsh-completion-notifier
English Documentation | 中文说明
DeepSeek Harness (DSH) 原生任务完成通知与审批提醒插件。
在长任务跑完或 AI 等待你点击「允许」/ 审核 Plan 时，通过 macOS 系统通知横幅、DSH 应用内浮窗和提示音提醒你；支持全量提醒或仅在后台切走时提醒；可开启自动切换会话。
为什么做这个插件？
平时用 DSH 让 AI 跑复杂任务，动辄几分钟，我们通常会把窗口最小化去干别的事。但经常会遇到这几个尴尬场景：
- 不知道任务什么时候跑完：要么每隔一会儿切回来瞄一眼，要么忘了切回来，白白浪费时间。
- 在 DSH 窗口内反而收不到提醒：macOS 系统通知中心默认会对前台活动应用静默抑制横幅，如果你正在看设置或别的窗口，系统横幅根本不飘出来。
- AI 卡在半路干等：有时候 AI 刚跑两步就停下来等我们点击「允许」授权，或者在 Plan 模式下等我们「批准方案」。因为没发通知，窗口在后台一停就是半小时。
- 多任务跑完找不到会话：后台会话完成后，还得自己去左侧侧边栏茫茫多的列表里一个个翻找刚才跑的是哪个。
这个插件就是为了彻底解决这些日常使用中的烦恼。
主要功能
- 任务完成提醒：对话或任务跑完后，弹出系统通知横幅并播放提示音。横幅带 DSH 鲸鱼图标，附带耗时统计和 AI 回复的摘要。
- DSH 应用内浮窗通知 (前台 100% 可见)：专门解决 macOS 在前台使用时屏蔽系统横幅的问题。在 DSH 窗口右上角滑出轻量浮窗，无论何时都不漏通知。
- 前后台智能互斥分流：在 DSH 窗口内只弹轻量应用内浮窗；窗口最小化或切走时只弹系统横幅，二者互斥，绝不重复弹窗。
- 自由选择提醒时机：
- 全量提醒（推荐）：无论你当前是否在使用 DSH，都发出声音与通知；
- 仅在未聚焦 / 后台时提醒：当前正在看着 DSH 窗口时静默，只有窗口最小化或切到其他软件时才提醒。
- 自动跳转到对应会话：开启后，后台任务完成或停下来等待审批时，无需手动点击，DSH 自动切入该会话。
- 等待操作提醒：当 AI 停下来等待你点击「允许」（权限审批）、审核 Plan 计划或回答选择题时，会发出提醒，避免 AI 在后台干等。
- 点击横幅直达会话：点击系统通知横幅或应用内浮窗，窗口自动激活并直接切换到对应的会话。
- 防打扰阈值：可以设置最短耗时（默认 3 秒），日常简单问答不弹通知，只在真正耗时的长任务跑完时才提醒。
- 原生设置面板：在 DSH 的「设置」左侧菜单里有专属的「完成通知与审批提醒」页面，开关、提示音、阈值都能按需调整。
安装方法
方式一：在插件市场一键安装（推荐）
打开 DSH Desktop，进入 设置 → 插件市场，搜索 dsh-completion-notifier 或 通知，点击安装即可。
方式二：命令行安装
打开终端执行：
dsh plugin --profile web add dsh-completion-notifier
也可以直接通过 GitHub 地址安装：
dsh plugin --profile web add github:zepeng-jin/dsh-completion-notifier
方式三：本地开发
git clone https://github.com/zepeng-jin/dsh-completion-notifier.git
cd dsh-completion-notifier
dsh plugin --profile web add link:$(pwd)
设置选项
安装后在 DSH「设置」左侧边栏打开「完成通知与审批提醒」，可以调整以下选项：
| 设置项 | 说明 | 默认值 |
|---|---|---|
| 启用完成通知 | 插件总开关，开启后对话完成时进行通知 | 开启 |
| 提醒时机 | 全量提醒（始终提醒）或 仅在未聚焦/后台时提醒 | 全量提醒 |
| 自动跳转到对应会话 | 后台任务完成或等审批时，自动将 DSH 视图切入该会话 | 关闭 |
| 前后台智能分流通知 | 在 DSH 窗口内只弹轻量应用内浮窗；窗口最小化或切走时只弹系统横幅，二者互斥 | 开启 |
| 完成提示音 | 任务跑完时播放的声音（内置 Glass、Ping、Hero、Pop 等） | Glass |
| 等待审批与 Plan 提交通知 | AI 暂停等待你授权、批准 Plan 或做选择时是否提醒 | 开启 |
| 最小提醒耗时阈值 (秒) | 只有单轮耗时超过该秒数才提醒，设为 0 秒提醒所有对话 | 3 秒 |
开源协议
本项目采用 MIT License 授权。
