前言¶
用 DeepSeek Harness（DSH）跑长任务时，窗口往往会被最小化或切到别的应用。对话跑完、或 AI 停在「允许」授权与 Plan 审批处等你操作时，如果没有可靠提醒，只能反复切回窗口查看，既打断手头工作，也容易让后台会话空等。
macOS 系统通知在前台应用聚焦时还会抑制横幅，即便 DSH 仍在前台但焦点在设置页等子界面，系统横幅也可能不出现。下面介绍的 dsh-completion-notifier 是维护者 zepeng-jin 发布的 客户端 类 DSH 插件：在任务完成或需要人工操作时，通过 macOS 系统通知、DSH 应用内浮窗和提示音提醒你，并在设置里集中管理行为。插件在 SkillHub 目录 与 GitHub 仓库 均可查阅；社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-completion-notifier 面向 DSH Desktop（macOS）用户，监听对话完成与「等待用户操作」类事件，再按你的配置弹出通知、播放声音，并可选择自动跳转到对应会话。它在 DSH「设置」中提供原生页面「完成通知与审批提醒」，无需改配置文件。项目采用 MIT 协议开源。
核心功能¶
以下能力均来自项目 README 说明。
任务完成提醒
对话或任务结束后，弹出带 DSH 鲸鱼图标的系统通知横幅并播放提示音；横幅可附带耗时统计与 AI 回复摘要。
DSH 应用内浮窗
在 DSH 窗口内使用时，于右上角滑出轻量浮窗，避免 macOS 在前台抑制系统横幅导致漏提醒。
前后台智能互斥分流
DSH 窗口内仅显示应用内浮窗；窗口最小化或切到其他软件时仅显示系统横幅，二者互斥，避免重复弹窗。
提醒时机
可选「全量提醒」（推荐）：无论是否在使用 DSH 都发声与通知；或「仅在未聚焦 / 后台时提醒」：正在看 DSH 窗口时不提醒，仅在后台时提醒。
等待操作提醒
AI 等待点击「允许」（权限审批）、审核 Plan 或回答选择题时发出提醒。
自动跳转到对应会话
可选开启：后台任务完成或等待审批时，DSH 自动切换到该会话。
点击通知直达会话
点击系统横幅或应用内浮窗后，激活窗口并切换到对应对话。
防打扰阈值
可设置最短耗时（默认 3 秒），短于阈值的轮次不通知；设为 0 秒则所有对话都提醒。
安装与启用¶
DSH 生态支持从插件市场或命令行安装插件；安装后插件随当前 DSH 进程运行，安装前建议浏览仓库源码与 LICENSE。
插件市场（推荐）¶
打开 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
安装完成后，在 DSH「设置」左侧打开 完成通知与审批提醒，按需打开总开关并调整下列选项。
设置选项¶
| 设置项 | 说明 | 默认值 |
|---|---|---|
| 启用完成通知 | 插件总开关，开启后对话完成时进行通知 | 开启 |
| 提醒时机 | 全量提醒（始终提醒）或 仅在未聚焦/后台时提醒 | 全量提醒 |
| 自动跳转到对应会话 | 后台任务完成或等审批时，自动将 DSH 视图切入该会话 | 关闭 |
| 前后台智能分流通知 | 在 DSH 窗口内只弹轻量应用内浮窗；窗口最小化或切走时只弹系统横幅，二者互斥 | 开启 |
| 完成提示音 | 任务跑完时播放的声音（内置 Glass、Ping、Hero、Pop 等） | Glass |
| 等待审批与 Plan 提交通知 | AI 暂停等待你授权、批准 Plan 或做选择时是否提醒 | 开启 |
| 最小提醒耗时阈值 (秒) | 只有单轮耗时超过该秒数才提醒，设为 0 秒提醒所有对话 | 3 秒 |
典型用法¶
1、安装插件并打开「启用完成通知」。
2、若常把 DSH 放在后台跑长任务，保持「提醒时机」为 全量提醒，并开启「等待审批与 Plan 提交通知」，避免 AI 停在授权或 Plan 处无人知晓。
3、若希望日常短问答不打扰，保留默认 最小提醒耗时阈值 3 秒；需要每条对话都提醒时改为 0 秒。
4、多会话并行时，可开启 自动跳转到对应会话，或在收到横幅 / 浮窗后点击通知直接切到该会话。
5、长时间前台使用 DSH 时，保持 前后台智能分流通知 开启，在窗口内依赖应用内浮窗接收完成与等待操作提醒。
适用场景与注意¶
适合谁
在 macOS 上使用 DSH Desktop、经常后台跑 Agent 或多会话并行，且需要完成态与「等人点允许 / 批 Plan」两类事件都能被可靠感知的使用者。
平台
插件描述与功能围绕 macOS 原生系统通知 与 DSH 客户端 UI；非 macOS 或未使用 DSH Desktop 的环境，README 未承诺同等行为。
权限与安全
插件以当前 DSH 进程权限运行；从插件市场或上述命令安装前，应在 GitHub 仓库核对源码与 MIT 许可证，并仅在信任维护者与代码的前提下启用。
结尾¶
dsh-completion-notifier 把「跑完了」和「在等你操作」两类状态从「靠人工轮询窗口」变成可配置的通知与声音，并通过前后台分流减少 macOS 抑制系统横幅带来的漏提醒。目录页：https://www.skillhub.cn/plugins/zepeng-jin/dsh-completion-notifier；源码与说明：https://github.com/zepeng-jin/dsh-completion-notifier。
