工厂式三色信号灯:有对话在等你处理时亮红灯并蜂鸣,有对话在运行时亮黄灯,全部空闲时亮绿灯。它的 HTTP 路由没有 DSH 的访问检查,浏览器里打开的网页可以调用它们。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:YunJianFengYin/dsh-status-light
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
A factory-style stack light for the DeepSeek Harness Web UI: it merges the state of every conversation in the workspace into one light, and sounds a buzzer when a conversation is blocked on you.
把 Harness 里所有对话的状态做成一座工厂三色指示灯,悬浮在窗口右下角;有对话被提问 / 授权 / 计划审阅打断时亮红灯并蜂鸣。
Acoustic-Optical Alarm Display in Red Light / 红灯时声光报警展示
| 灯 | 含义 | 声音 |
|---|---|---|
| 红灯 | 至少有一个对话在等你:提问、授权(高权限操作)、计划审阅 | 单一频率(≈2.1 kHz)持续蜂鸣 1 秒、停 0.6 秒,循环 |
| 黄灯 | 有对话正在运行(没有在等你的) | 无声 |
| 绿灯 | 全部空闲 | 无声 |
多个对话合并规则:等待 > 运行 > 空闲,任何一个对话被中断(提问 / 授权)就整体显示红灯并响蜂鸣器。
外观按参考图绘制:白色顶盖、红/黄/绿三层皱纹透镜、6 mm 白色隔环、56 mm 白色灯体(无铭牌、无文字);只取图片里的灯头部分,不含立柱、万向节与底板。比例取自参考图(透镜 50×36、隔环 6、灯体 56)。
安装 / Install
本仓库是一个 Harness 插件包:package.json 声明了 dsh.bundle.patch → cordis.patch.yml,具备该清单才能被 dsh plugin add 安装;也可以直接把本目录作为插件包加进 Harness 的插件管理器。
- 需要 Harness 的 Web GUI:浏览器半注册在
shell.overlay槽位,Host 半提供/_dsh/status-light/state.json快照。 - 无第三方依赖,不需要构建步骤(
index.js为 Host 半,client.js为浏览器半)。 - 浏览器要求一次用户手势才允许出声:点一下页面任意处即可解锁;解锁前红灯只闪不响。
使用
- 悬停信号塔:显示每个对话的标题与等待原因。
- 左键或右键点击信号塔:打开「信号灯设置」面板,里面是蜂鸣器总开关、红灯音效的音量与音效文件、转绿提示音的音量与音效文件、信号塔大小(16–160 px),每个音效都有「试听」;点面板外面或按 Esc 关闭。
- 音效文件可以选任意浏览器能播放的音频(≤ 5 MB),不选就用内置的合成蜂鸣;「恢复默认」清掉已选文件。文件存在浏览器 IndexedDB(库名
dsh-status-light),开关、音量、大小存在localStorage。 - 设置记在浏览器
localStorage(dsh.status-light.muted、dsh.status-light.volume.alarm、dsh.status-light.volume.idle、dsh.status-light.size)。 - 进入空闲时绿灯先闪 3 下(亮 1.2 s、灭 0.5 s),然后转为常亮。
- 有对话从“运行中”变为空闲时会短促提示两声:
0.3 s 响 / 0.1 s 停 / 0.3 s 响,停 0.3 s 后再重复一次(共 4 声,约 1.7 秒);即使其他对话仍在运行(黄灯)也会响。静音时同红灯一样不出声。 /_dsh/status-light/probe是只读诊断端点:列出每个活动会话的待审批数与userQuestions投影,排查“该响没响”时用。
结构
index.js:Host 半。等待状态取自三处:会话日志里未配对的approval/asked(工具审批、沙箱升权——只要人类还在等就是待定)、userQuestions会话投影的active(定时提问、计划审阅)、ask_user_question工具的执行窗口(阻塞提问);再用sessionController.list()汇总运行状态,在/_dsh/status-light/state.json上提供只读快照。client.js:浏览器半。注册到shell.overlay槽位,轮询上面的快照,用 SVG 画信号塔并用 Web Audio 合成蜂鸣器音;右键(或左键)信号塔弹出设置面板。locale/en.json、locale/zh.json:插件管理器里显示的标题与说明。icon.svg:插件管理器使用的图标;assets/icon-256.png是市场卡片用的位图图标;assets/icon.ico是 Windows 快捷方式用的多尺寸图标。cordis.patch.yml:插件装载补丁(dsh.bundle.patch指向它)。
说明
- 状态快照只包含会话标题、等待类型与运行标志,不出本机。
- 蜂鸣器由 Web Audio 实时合成:固定 ≈2.1 kHz 方波过 3.2 kHz 低通,音量由滑块映射到增益,不依赖任何音频文件。
- 红灯随蜂鸣同步闪烁:响的 1 秒亮、静音的 0.6 秒灭(静音时仍按这个节奏闪,只是不出声)。
- 红灯对应“代理正卡在等你”:提问卡片关闭、你作答、或前台等待超时后,代理会继续干活,灯也随之回到黄/绿;这之后如果卡片还留着可补答,那属于“不再挡路”的提问。
License
GNU General Public License v3.0 only © 2026 YunJianFengYin
本插件以 GPL-3.0(仅版本 3,不含“或更高版本”条款)发布。
链接
同类插件
xmanrui/dsh-im★ 3648
通过二维码或机器人凭据将 IM 机器人接入 DeepSeek Harness(支持飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord 和 WhatsApp 共 9 种渠道)。
shaobeichen/dsh-pocket★ 3000
手机远程访问 DSH Web 界面:扫码即用局域网或公网(cloudflared 隧道)访问,实时同屏、移动端适配布局,带设置页管理。
c1overzz/dsh-bili-scroll★ 1421
让你的 DSH 自己刷 B站 —— 读字幕原文挑内容、写日报,遇到值得看的会发评论 @ 你。
OpenPetsHQ/openpets#dsh★ 1401
将 DeepSeek Harness 的生命周期状态、错误与审批请求,桥接到本地运行的 OpenPets 桌面伙伴。
inclusionAI/Avernet#deepseek-harness-channel-bcn★ 605
通过 WebSocket V2 将 DeepSeek Harness 接入 Avernet Bot 协作网络,支持自动注册、Agent 会话隔离、工具调用事件和多 Bot 路由工具。
zaofan-make/dsh-qqbot★ 260
QQ 官方机器人通道(tencent-connect/dsh-qqbot 的增强 fork):群/私聊ai陪聊、富媒体收发、表情包打标入库+检索发图、入群审批/禁言/群发、定时唤醒、QQ 远程审批与提问卡、互动按钮卡、多账号多实例、扩展接口、群友记忆注入、按消息价值唤醒省token、上下文自动压缩、悬浮球设置面板。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。