在使用 DeepSeek Harness (DSH) 开发智能体时,切换标签页或离开电脑后,无法实时感知 Agent 是否已完成回复,或是否需要人工介入。dsh-task-feedback 插件通过 Favicon 小圆点提供这种状态反馈,并辅以音效提示,降低对人工查看的依赖。
插件定位¶
这是一个为 DeepSeek Harness 打造的会话状态反馈插件。由 Pudge1996 维护,采用 MIT 许可证。
核心功能¶
1. Favicon 小圆点实时回显
插件会监听会话状态,并在页面不可见时通过浏览器标签页的 Favicon 图标进行视觉提示。颜色与形状均可配置:
- 颜色状态:
- 绿色:当前任务已完成
- 蓝色:当前任务进行中或子代理正在运行
- 橙色:需要人工介入(等待审批、计划确认或回答问题等)
- 形状支持:小圆点 | 圆形 | 圆角矩形
- 触发逻辑:利用原生 Page Visibility API,仅在页面不可见时触发 Favicon 变更。若会话本身已处于空闲/完成状态,Favicon 保持默认小鲸鱼图标。
2. 音效提示
内置 12 个合成音效,通过 Web Audio API 实现,无外部依赖。支持以下配置:
- 音效区分:可分别为“任务已完成”和“需要你介入”选择不同音效。
- 播放时机:
- 始终播放:无论页面是否可见,只要状态变更即播放。
- 仅页面不可见时播放:仅在页面最小化或切走标签页时播放。
3. 技术实现
- 纯前端实现。
- 无自定义协议、无 host 命令、无 LLM 调用、不进会话日志。
- 接入 DSH 的 sessions 与 uiSession 标准服务获取任务运行状态。
安装与启用¶
使用官方插件安装命令:
dsh plugin --profile web add dsh-task-feedback
配置与使用¶
- 进入设置:在 DSH 界面中找到设置选项。
- 配置反馈:进入反馈设置页面。
- 调整参数:
- Favicon 形状:选择小圆点、圆形或圆角矩形。
- 音效作用域:选择“始终播放”或“仅页面不可见时播放”。
- 音效选择:为“任务已完成”和“需要你介入”分别挑选音效。
配置会持久化保存在 localStorage 中。
适用场景与注意¶
- 版本要求:从 DSH v0.1.2-alpha.1 开始适配。
- 模式限制:暂不支持
/goal模式。 - 权限提示:插件以当前 DSH 进程权限运行,安装前建议检查源码与许可证。
总结¶
dsh-task-feedback 通过 Favicon 和音效,解决了开发者在使用 DSH 时“人不在电脑旁如何感知状态”的问题。所有功能均在前端完成,不会干扰后台任务逻辑。