前言¶
在 DeepSeek Harness（DSH）里同时开多个 Agent 会话时，某个会话可能在后台等你审批工具、回答提问或确认计划，而当前焦点在别的会话上。侧边栏里逐条看状态容易漏掉。下面介绍社区插件 dsh-traffic-light：在 Web UI 侧边栏左下角用三颗灯汇总全部会话的运行与等待情况，并在进入红灯或（可配置的）黄灯时蜂鸣提醒。
这是什么¶
dsh-traffic-light 由维护者 juntaoqian 发布，分类为客户端插件。它是纯前端实现：无第三方 npm 依赖、无构建步骤，不申请文件、网络或工具类 Host 权限。配色使用 DSH 主题 token，浅色与深色主题自动适配。作者在 DSH 0.2.1-rc.5（桌面版）上验证通过。
核心功能¶
三灯含义¶
- 绿灯：有会话在运行（默认「任一会话运行即绿灯」，可在设置里改为「全部会话都运行才绿灯」）。
- 红灯：任一会话存在待你处理的交互（
pendingInteraction非空，例如审批请求、ask_user_question、计划确认）。红灯那颗带呼吸闪烁。 - 黄灯：没有会话在运行，也没有会话在等待。
界面与汇总¶
左下角控件位于侧边栏底部、Settings 按钮上方，三颗灯横向排列，当前状态对应那颗点亮。插件汇总当前页面可见的会话集合（与侧边栏会话列表一致，含子会话）。红灯时可在灯旁显示等待数量角标；悬停可查看运行中、等待选择、会话总数。侧边栏展开时可显示状态文字；折叠成窄栏时只保留三颗灯。Windows 标题栏模式下若折叠侧边栏导致 DSH 隐藏整个侧栏脚部，灯会不可见，但蜂鸣仍工作。
蜂鸣与音效¶
状态切换时才会响，不会因重渲染或改设置重复响；页面刚打开时若已是红/黄，不会补响。进入红灯必响；红灯期间又多一个会话开始等待也会响（受总开关控制）。进入黄灯是否响由「回到空闲时也蜂鸣」控制，默认开。提供 6 种音效（经典蜂鸣、清脆铃音、短促提示、警报双响、低沉提示、上升三连音），切换时可试听；音量、时长、重复次数共用。浏览器要求至少一次用户手势后才能播放声音，点一下页面或按键后即可解锁。
设置页¶
安装后在 Settings → 红绿灯 可配置：显示控件、蜂鸣总开关、空闲时蜂鸣、音效、音量（默认 60%）、时长（默认 160 ms）、次数、绿灯判定、状态文字、等待角标等；另有试听与恢复默认。选项保存在浏览器 localStorage 的 dsh.traffic-light.options.v1，改动立即生效，重启后保留。界面文案跟随 DSH 语言（中英）。
安装与启用¶
前置环境为 DeepSeek Harness 桌面版或 dsh web，并依赖 DSH 的 Client slot 机制。
图形界面（推荐）¶
- 侧边栏打开 Plugins。
- 选择 Add plugin → Install a third-party plugin。
- 在包名处填写：
git+https://github.com/juntaoqian/dsh-traffic-light.git
- 点击 Install，确认 bundle 已 enabled。
- 查看侧边栏左下角；Settings 中应出现「红绿灯」页。
通过 Agent 安装¶
在 DSH 会话中说明使用 plugin_manager 的 install_bundle，target 为：
git+https://github.com/juntaoqian/dsh-traffic-light.git
卸载¶
在 Plugins 中找到 dsh-traffic-light 并 Remove，或使用 plugin_manager 的 remove_bundle。
若从 GitHub 安装时出现连接超时，README 建议重试、在 profile 的 cordis.patch.yml 中调大 pluginManager.githubConnectionTimeoutMs，或改用本地目录的 install_bundle（link 方式）安装；细节见仓库 README。
典型用法¶
安装并启用后无需额外命令：多会话并行时看左下角灯色即可。需要静音或改判定规则时进入 Settings → 红绿灯 调整。多窗口之间设置通过 storage 事件同步；同一页面两个座位共享同一 store。
状态与蜂鸣对应关系可概括为：
| 灯 | 何时亮 | 蜂鸣 |
|---|---|---|
| 红 | 任一会话有待处理交互 | 进入红灯响；红灯期间等待数增加也响（总开关） |
| 黄 | 无运行且无等待 | 进入黄灯时响（「回到空闲时也蜂鸣」，默认开） |
| 绿 | 有会话在运行（规则可配置） | 无 |
适用场景与注意¶
适合经常开多个 DSH 会话、希望一眼看到「有没有在跑、有没有在等我点选」的开发者。插件只通过宿主提供的 useSessionStatus 等标准 hook 读状态，不扫 DOM、不订阅私有事件。
安装前建议浏览 GitHub 仓库 源码与 MIT 许可证；客户端插件随 DSH Web UI 运行，权限模型以当前 DSH 进程与浏览器环境为准。若 DSH 大版本调整 slot 或 hook 名称（如 sidebar.footer.action、settings.section、shell.overlay、useSessionStatus），插件可能需要适配。社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-traffic-light 把多会话运行与等待状态收到侧边栏左下角，并用可配置的蜂鸣减少漏审。目录页：https://www.skillhub.cn/plugins/juntaoqian/dsh-traffic-light；源码与完整说明：https://github.com/juntaoqian/dsh-traffic-light。
