前言¶
在 DeepSeek Harness (DSH) 的使用场景中，当智能体在后台运行或页面被最小化时，任务完成或需要人工介入（如审批、提问）的信号容易被忽略。dsh-ui-task-notify 解决了这个问题，它通过监听主机计算出的智能体状态，在特定条件下触发浏览器通知和系统提示音。
是什么¶
这是一个由 ivvan3016 维护的插件，属于联网工具类别。它不渲染额外 UI，也不发送 RPC，而是利用 DSH 客户端运行时已接收到的 host/session-status 和交互请求帧，向操作系统发出通知。
核心功能¶
该插件提供以下能力：
- 浏览器通知与系统提示：当智能体在页面隐藏状态下完成任务时，触发 Windows 浏览器通知和系统 Toast（包含系统提示音），即使浏览器窗口被最小化也能显示。
- 待处理交互提醒：当智能体处于等待状态（需要批准、回答问题或计划审查）时触发提醒。
- 状态反应：反应于主机计算的智能体状态（运行/空闲）。
- 可配置设置：通过插件配置卡片调整通知行为。
安装与启用¶
使用官方 npm 包进行安装。
dsh plugin --profile web add dsh-ui-task-notify
安装后，通过以下步骤启用并授权通知：
- 打开 设置 -> 插件 -> 插件配置。
- 找到 任务完成提醒 配置卡片。
- 在 系统通知 行点击 授权 按钮，向浏览器申请通知权限。
- 授权后，按钮状态变为“已授权”。当智能体完成工作或等待交互时，若页面处于隐藏状态，将弹出系统通知。
配置说明¶
在插件配置卡片中，可以通过布尔字段控制行为：
- enabled：总开关，设为
false时插件停止工作。 - onlyWhenHidden：仅在页面隐藏时提醒，默认
true。若设为false，页面可见时也会提醒。 - includeSubagents：是否包含子智能体完成时的通知，默认
false。 - interactionAlert：是否在等待交互（批准、问题、计划审查）时提醒，默认
true。
限制与注意¶
- 依赖 Notification API：需要浏览器支持通知 API。
- 标签页状态：已关闭或被丢弃的浏览器标签页无法触发通知，页面必须保持存活。
- 子智能体默认静音：默认不提醒子智能体的完成情况，需手动开启
includeSubagents。 - 无 KV Cache 影响：该插件不涉及 Prompt、消息或 KV Cache 的处理。
- Git 安装限制：通过 Git 安装时，
pnpm可能会阻止构建，需在pnpm-workspace.yaml中添加允许列表（具体见 GitHub 仓库说明）。
结尾¶
该插件适合需要在后台运行 DSH 任务并希望及时收到完成或待处理信号的开发者。通过系统通知，可以在不保持页面可见的情况下掌握任务进度。
