dsh-tab-alert:当智能体在后台响应时闪烁标签标题

前言

在使用 DeepSeek Harness(DSH)进行智能体开发时,对话可能需要较长时间才能完成一次 agent turn。如果浏览器标签页处于后台,用户很难及时感知响应已完成。这种延迟会导致用户频繁切换标签页,打断工作流。

dsh-tab-alert 旨在解决这一场景:当 agent turn 在后台完成时,通过闪烁标签标题来提示用户,返回标签页后立即停止闪烁,保持原有标题。

是什么

dsh-tab-alert 是一个 DSH 客户端插件,由维护者 vemoos-b 开发。它监听智能体 turn 的完成状态,当检测到当前标签页不可见且 turn 已完成时,将标签标题在 “New Message!” 和原标题之间循环切换;用户切回标签页后,闪烁立即停止。

核心行为

  • turn 运行中:标签标题保持不变。
  • turn 完成,标签页可见:不触发闪烁,用户已能看到变化。
  • turn 完成,标签页隐藏:标题在 “New Message!” 和原标题之间每秒切换一次。
  • 用户切回标签页:检测到 visibilitychange 事件后,闪烁立即停止,标题恢复原样。

检测逻辑

插件使用两种检测方式:

  1. 优先路径:通过 host client services 获取会话快照,检查 ctx.sessions.list.getSnapshot().byId[mainViewSessionId].running 状态。mainViewSessionId 通过 retainedBy.mainView > 0 解析。当 sessions.list 变化时触发回调,并在 2 秒内轮询作为后备。

  2. 降级路径:当服务不可用或记录缺少 running 字段时,检查 DOM 元素 [data-chat-flow-kind="turn-process"](基于 dsh-auto-collapse 合约)。

安装与启用

在终端执行以下命令安装插件:

# 从 npm 安装
dsh plugin add dsh-tab-alert

# 或从 GitHub 安装
dsh plugin add github:vemoos-b/dsh-tab-alert

安装完成后,在 DSH 的设置 → 插件中启用 dsh-tab-alert,并刷新 Web UI。

兼容性

  • DSH 0.2.0-rc.2(Web 客户端)
  • Node.js >= 22

插件采用 MIT 许可证。

适用场景与注意

本插件通过 DSH 进程权限运行,在安装前应检查源码与许可证。

适合需要长时间等待智能体响应的开发者或使用者,尤其是需要同时处理多个任务、标签页频繁切换的场景。

小结

dsh-tab-alert 通过闪烁标签标题的方式,让用户在后台响应完成时获得即时反馈。它不依赖额外配置,安装即用,适合作为 DSH 工作流中的轻量级通知组件。

更多详情与源码,请访问:
- 插件目录页:https://www.skillhub.cn/plugins/vemoos-b/dsh-tab-alert
- GitHub:https://github.com/vemoos-b/dsh-tab-alert

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye