前言¶
在 DeepSeek Harness(DSH)里同时跑着多个智能体会话时,完成、失败或「等用户回复」往往不会立刻被你注意到。窗口最小化或切到别的应用后,更容易漏掉需要处理的会话。
下面介绍的 dsh-session-alerts 是社区维护的客户端插件(维护者 QYF1999,GitHub 仓库 QYF1999/dsh-session-alerts)。它不扩展工具链,而是在浏览器端根据会话状态给出任务栏数字角标、应用内状态角标、短提示音,以及在窗口处于后台时的 Windows 系统通知,帮助你把注意力拉回该打开的会话。
这是什么¶
dsh-session-alerts 的定位是:DeepSeek Harness 的会话状态提醒插件——在任务完成未读、执行失败、智能体等待你回答等场景下,用可见、可听的方式提示你。
该插件在 package.json 中声明为 dsh-client 的 web 端注入,依赖 @deepseek-ai/dsh-client-ui-session,不注册工具、不运行宿主侧代码,属于纯客户端 bundle。许可证为 MIT(README 与 package.json 一致)。当前资料中的发布版本为 1.0.0。
核心功能¶
以下能力均来自项目 README 与包描述,安装并启用后由客户端逻辑处理会话状态变化。
任务栏与应用内角标¶
- 已完成且未读的会话:任务栏显示数字角标(未读数量)。
- 会话失败:应用内显示红色
!角标(README 未将失败态映射到任务栏专用字形)。 - 智能体等待你的回答:应用内显示琥珀色
?角标。
应用内角标出现在右下角,点击可打开对应会话。
提示音与系统通知¶
- 每种状态切换时会播放短提示音(chime)。
- 当 Harness 窗口在后台时,在 Windows 上会弹出系统通知;通知图标与插件绘制的圆形图标一致。
平台与浏览器限制¶
README Notes 中说明:Chrome 对 PWA 任务栏角标仅支持数字或圆点,因此完成/失败/等待等状态字形主要出现在应用内和通知里,而不是完整复现在任务栏图标上。
首次在应用内点击时,会一次性请求通知权限(浏览器标准行为)。
安装与启用¶
可从 Harness 插件市场(需先添加列出该插件的索引源)安装,也可按 README 直接安装指定 bundle:
plugin_manager → install_bundle → dsh-session-alerts@1.0.0
安装前建议自行查看仓库源码与 MIT 许可证内容。插件随当前 DSH 客户端进程在浏览器中运行,权限边界与所用 Harness 实例一致,不宜在未审阅代码的情况下 blindly 安装第三方 bundle。
典型用法¶
官方 README 未给出单独的配置文件或 CLI 示例;启用方式即完成上述 install_bundle 后,由 dsh.client 配置自动注入(immediately: true,平台 web)。
可复现的验证步骤如下:
- 在 Harness 中安装
dsh-session-alerts@1.0.0并刷新或重启客户端。 - 在应用内任意位置点击一次,按需授予通知权限。
- 新建或运行会话:等待智能体进入「需用户回复」、故意触发失败、或让任务跑至完成且不立即点开,观察右下角角标、提示音,以及将窗口切到后台时的 Windows 通知。
- 点击右下角角标,确认会跳转到对应会话。
无需额外配置项即可按上述路径体验;资料中未列出其他 dsh 配置字段。
适用场景与注意¶
适合谁
- 经常在 Harness 里并行多个 agent 会话的开发者。
- 使用 Windows、且希望窗口在后台时仍收到系统通知的用户。
- 接受 PWA / Chrome 任务栏角标限制、主要依赖应用内角标区分失败与等待状态的用户。
注意事项
- 分类为客户端插件:不增加 MCP 式工具,也不改服务端行为。
- 任务栏数字侧重「已完成未读」计数;失败与等待的区分以应用内
!/?为主。 - 安装前请在 GitHub 阅读
client.js、cordis.patch.yml等实现,确认与您的安全策略一致。
结尾¶
dsh-session-alerts 把「会话要不要你管」这件事从后台日志里拉到任务栏数字、角落角标、提示音和系统通知上,适合作为 Harness 多会话工作流里的轻量提醒层。