前言¶
在 DeepSeek Harness Desktop 里跑长任务时，完成、报错、待审批命令或待回答的问题往往发生在后台。如果只能切回应用里逐条处理，打断成本会很高。浏览器通知或第三方桥接可以补一层提醒，但审批细节、多题问答和回到正确会话，通常还要再打开 Desktop 自己找。
下面介绍社区插件 DSH Notify（仓库 realDGD/dsh-macos-notify），由 realDGD 维护，分类为客户端。它为官方 DeepSeek Harness Desktop 提供原生 macOS 通知、快捷审批、完整问答表单，以及菜单栏会话面板；点击通知可回到对应工作区与会话。项目由 DSH 插件与后台助手 DSH Notify.app 组成，助手随 Desktop 启停，不依赖浏览器、DSH Bridge 或额外模型服务。当前稳定版本为 v0.5.0（MIT 许可证）。
这是什么¶
DSH Notify 的定位是：把 Desktop 里需要人介入的状态，推到 macOS 系统通知和菜单栏，并在原生窗口里完成审批与整组问答。DSH 仍决定是否接受回答；先被接受的回答生效，已回答、取消或过期的请求会撤回，旧按钮不会重复执行。
核心功能¶
资料中列出的能力如下，可按场景对照使用。
| 能力 | 说明 |
|---|---|
| 原生通知 | 任务完成、报错、审批与问答提醒；点击可返回对应 DSH 会话。 |
| 快捷审批 | 在系统通知或菜单栏选择「允许一次」或「拒绝」；需核对命令时可打开审批详情。 |
| 完整问答 | 一条提醒打开整组问题，每题保留选项与独立文字输入，支持单选、多选与整批提交。 |
| 会话面板 | 菜单栏鱼图标：活动会话、嵌套子智能体、最近 5 条主会话，显示状态与任务进度。 |
| 上下文与代码 | 审批/问答相关上下文支持 Markdown、公式与代码；Shell/JSON 高亮，命令与参数自动换行。 |
| 语言 | 界面跟随 DSH 的中英文设置；会话名、题干、选项、回答和命令保留原文。 |
菜单栏上，有任务运行时鱼图标会旋转；待审批或问答为橙色，异常为红色，完成为绿色。关闭问答窗口或短暂断连会保留每题草稿；「清空回答」只清除选项和文字，不取消请求。草稿仅存于助手内存，DSH 确认已回答、取消或请求失效后清除；退出助手会丢弃未提交草稿。
环境与前提¶
- 系统：macOS 13 或更新版本。
- 客户端：官方 DeepSeek Harness Desktop；资料记载当前验证版本为
0.2.1-rc.1。 - 构建：通过 Desktop 安装会使用其内置 Node.js/pnpm；仅手动构建或开发才需另行准备 Node.js 22+。推荐安装前先执行 Apple Command Line Tools：
xcode-select --install
安装与启用¶
推荐在 DeepSeek Harness Desktop 内安装。v0.5.0 支持自动安装助手到 /Applications/DSH Notify.app；已有匹配助手会复用，升级会保留设置并备份旧版。
通过插件管理器（推荐）¶
- 打开 DSH Desktop，进入侧边栏 插件 → 添加插件。
- 粘贴以下地址，确认来源后安装：
github:realDGD/dsh-macos-notify
- 若提示构建脚本被阻止，核对此插件后点击 「允许这些脚本并重试」，等待安装完成。
- 启用 DSH Notify（英文界面为 Enable now）。保存当前任务，按 ⌘Q 退出 DSH Desktop 再重新打开（只关窗口不会退出应用）。助手随 Desktop 自动启动；系统在询问时允许 DSH Notify 的通知。
- 打开 设置 → DSH Notify，检查助手连接与通知权限，发送安全测试通知并点击，确认能打开对应会话。
终端命令（可选）¶
先在 Desktop 应用菜单中通过 管理 dsh 命令 / Manage dsh Command… 安装 dsh，在新终端执行：
dsh plugin --profile desktop add github:realDGD/dsh-macos-notify
安装后回到 Desktop 插件列表确认已启用，再按上文第 4、5 步重启与验证。Desktop 使用 desktop profile；勿与 --profile web 混用。
插件以当前 DSH 进程权限运行；安装前应阅读仓库源码与 MIT 许可证，并只在信任来源下允许构建脚本。
典型用法¶
菜单栏与会话¶
点击菜单栏鱼图标打开面板。活动区优先显示置顶、待处理或异常会话，其次是进行中的会话；最近区最多 5 条主会话。等待审批时可直接允许或拒绝；等待回答时打开完整问答。同一会话有多项请求时，通过「处理请求」菜单分别操作。右键鱼图标可打开 DSH、打开 DSH Notify 设置、隐藏菜单栏或退出 DSH。
审批¶
系统通知提供允许、拒绝和 「查看详情」。查看详情会打开审批详情窗口，展示请求原因、待执行命令、完整参数和相关上下文。「查看原文」和「复制原始参数」保留原始内容，显示格式不会改动真正提交给 DSH 的请求。
问答¶
点击通知中的 「打开完整问答」 打开完整问答窗口；每题有独立选项与文字输入，最后一次提交整组回答。在 DSH 中先回答后，通知中的旧请求会失效；通过「回到 DSH 会话」跳转成功后，问答窗口会自动关闭。
通知与静默¶
在 DSH Notify 设置中可分别开关提醒类型、系统提示音、子智能体结果、等待子智能体后汇总完成，以及查看当前会话时的静默提醒。关闭菜单栏显示后，通知与原生问答/审批窗口仍可用。
适用场景与注意¶
适合：主要在 Mac 上使用 DeepSeek Harness Desktop，希望任务完成、报错、审批和问答能在系统层处理，并需要从通知一键回到正确会话的用户。
边界与隐私（来自项目说明）：不增加网络监听、云服务或模型会话；原生助手与插件通过当前用户的私有本地文件交换数据。问答和审批内容在本地暂存以显示表单，不会随诊断导出。macOS 控制通知显示与专注模式；静默只影响提醒，不会自动批准、拒绝或回答。多个 Host 共用同一状态目录尚未验证；旧系统与 Intel 的实机支持见仓库 docs/compatibility.md。
升级与卸载：升级前保存任务、处理未提交草稿并关闭原生问答/审批窗口。当前插件管理器通过移除插件后重新添加安装新版。卸载时先在插件管理器中移除本插件，再从插件源码目录执行 bash macos/uninstall.sh，然后重启 Desktop。
结尾¶
DSH Notify 把 Desktop 里「需要人看一眼」的状态接到 macOS 原生通知与菜单栏，并在不离开系统 UI 的前提下完成审批与整组问答，同时保留回到具体会话的路径。社区目录页：realdgd/dsh-macos-notify；源码与 Releases：GitHub realDGD/dsh-macos-notify。
