前言¶
在使用 DeepSeek Harness（DSH）开发智能体时，Agent 经常需要人工介入：工具越权需要授权确认、模型向你提问或提交计划待确认、以及一轮任务跑完。如果这些时刻你不盯着界面，对话就会一直挂着。dsh-desktop-notify 插件通过系统级通知（Windows 下为系统 toast）捕获这三种状态，让你在处理其他任务时也能第一时间获知并处理。
它是什么¶
dsh-desktop-notify 是由 AFAP 维护的客户端插件。它通过只读观测 DSH 官方的状态源，将待处理的交互状态转化为浏览器的 Notification API 通知。
核心功能¶
- 三类提醒：支持工具授权确认（
approval）、提问与计划评审（question/plan-review）、以及任务完成（会话转空闲）。 - 系统级通知：由浏览器发出（Windows 显示为系统 toast），无需常驻后台程序。
- 点击直达：点击通知可将窗口拉到前台，并自动滚动到对应的待处理卡片。
- 失焦补发：默认仅在 DSH 不在前台时提醒，切走窗口后会补发压下的通知。
- 子代理降噪：完成提醒仅针对宿主会话列表，子代理运行完毕不弹。
- 去重与自清理：同一请求只通知一次，回答后对应通知自动关闭。
- 零依赖与零占用：无外部 npm 依赖、不注册 HTTP 路由，侧边栏不新增入口，只在设置页提供一节配置。
安装与启用¶
插件通过命令行安装，刷新页面后生效。
dsh plugin --profile web add github:AFAP/dsh-desktop-notify
安装完成后：
- 打开「设置」→ 左侧「桌面通知」。
- 点「开启权限」，在浏览器弹窗里允许通知。
- 点「发送测试通知」验证通道。
使用说明¶
通知触发场景¶
- 工具授权确认：工具请求越权执行（如写入被沙箱拒绝）。
- 提问/计划评审：模型向你提问或提交计划待确认。
- 任务完成：宿主会话列表里的会话由运行转为空闲。
行为细节¶
- 自动关闭：在界面上回答完问题或点掉授权后，对应通知会自动关闭。
- 前台抑制：默认开启「仅在 DSH 不在前台时提醒」，当你正看着界面时不会打扰。
注意事项¶
- 环境要求：需要 DeepSeek Harness 0.1.7-alpha.1 或更高版本。页面必须是安全上下文（
https或localhost），浏览器才提供 Notification API。 - 权限管理：需要浏览器通知权限，且页面必须是安全上下文（https 或 localhost）。设置只存浏览器
localStorage，不上传任何数据。 - 安全设计：插件只读观测官方状态源，不接管任何链路，不发送网络请求，不读取会话日志，无凭证、无密钥。
- 隐私：通知正文可能出现在锁屏或通知中心，内容包含工具名、请求原因、会话标题。
结语¶
该插件通过系统级通知减少了 Agent 开发过程中对界面的依赖，适合需要多任务处理或长时间运行 Agent 的场景。
