侧栏会话行状态灯:空闲蓝点、挂起灰空心(手动标记,或 5 天无对话自动)、归档灰实心;「视图选项 → 筛选会话」第一项可一键隐藏归档与挂起。原生待审批、进行中、有新结果灯保持不变。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-status-lamp
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:SpokAtom/dsh-status-lamp
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。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
给 DeepSeek Harness 侧栏会话行补一盏状态灯:空闲蓝点、挂起灰空心、归档灰实心,并在「视图选项」里提供一键隐藏已归档及挂起。待审批、进行中、有新结果继续用 DSH 原生灯,插件不接管。
English | 简体中文
为什么需要它
DSH 原生只用四种状态表达会话(待审批 / 进行中 / 有新结果 / 空闲),而侧栏里最需要区分的两种恰恰表达不出来:
- 空闲:行首什么都不画。
- 归档:行首整格留空,看起来和空闲一模一样。
于是「空闲、挂起、归档」在列表里长得一样,长尾会话越积越多,也没法一眼看出哪些该收起来。这个插件把三分法补回来,并让 5 天没对话的会话自动挂起。
| 不带插件 | 带插件 | |
|---|---|---|
| 空闲 | 什么都没有 | 🟦 蓝点 |
| 挂起(手动/自动) | 无法表达 | ⚪ 灰空心环 |
| 归档 | 与空闲无法区分 | ⚫ 灰实心点(时间右侧) |
| 待审批 / 进行中 / 有新结果 | DSH 原生灯 | 保持不变 |

截图中的会话标题是作者自己的数据,与灯本身无关。
三种灯的含义
| 灯 | 状态 | 判定方式 | 渲染位置 |
|---|---|---|---|
| 🟦 蓝色实心点 | 空闲 | 原生主状态为 idle,且未被标记挂起 | 行首 16px 格 |
| ⚪ 灰色空心环 | 已挂起 | 手动标记,或最后活动距今 ≥ 5 天 | 行首 16px 格 |
| ⚫ 灰色实心点 | 已归档 | 会话在归档集合中 | 时间右侧(DSH 归档行行首硬编码留空) |
优先级:原生四态 > 挂起 > 空闲。挂起中的会话一旦开始运行,会被原生进行中环覆盖;产生未读结果时被绿点覆盖;恢复空闲后挂起环再出现。归档态独立展示,压过挂起态。
安装
前置:DSH 0.2.2-rc.1 或更新版本;知道实际运行的 profile 名(桌面版是 desktop,Web 版是 web)。
方式一:npm(推荐)
dsh plugin --profile desktop add dsh-status-lamp
方式二:GitHub(生产环境建议锁 commit)
dsh plugin --profile desktop add github:SpokAtom/dsh-status-lamp
# 锁定版本:dsh plugin --profile desktop add github:SpokAtom/dsh-status-lamp#<commit>
方式三:本地目录(开发用)
dsh plugin --profile desktop add "D:\path\to\dsh-status-lamp"
装完重启应用(desktop profile 只在启动时读 bundles);Web 端刷新页面即可。
验证安装:打开「插件」页,列表里应出现「状态灯」;回到对话,侧栏空闲会话行首应出现蓝点。
使用
1. 空闲蓝点(自动)
装好即生效,不需要配置。
2. 手动挂起 / 取消挂起
- 在侧栏找到目标会话行。
- 右键(或点行尾的「…」按钮)打开菜单。
- 选择「挂起会话」→ 行首变成灰空心环;再次打开菜单选择「取消挂起」→ 恢复蓝点。
「取消挂起」会记录一个唤醒时刻:5 天规则不会立刻把刚唤醒的会话重新挂起;等这个会话产生新对话后,规则自动重新生效。
3. 5 天无对话自动挂起
会话的最近活动时间(updatedAt)距今满 5 天时,自动变成灰空心环,不需要刷新页面——插件内部有一个分钟级时钟会重算。
阈值是一个常量,改完重新安装即可:
// client.js
const AUTO_PARK_MS = 5 * 24 * 60 * 60 * 1000; // 改成 7 天:7 * 24 * ...
4. 隐藏归档与挂起
- 点侧栏「工作区」标题栏的滑杆图标打开「视图选项」。
- 「筛选会话」分组的第一项就是「隐藏已归档及挂起」。
- 点一下:归档行与挂起行消失;再点一下恢复。
开关状态存在浏览器本地,重启应用后保持。
5. 归档灯
用 DSH 自带的归档功能即可(会话行菜单 → 归档)。归档行会显示灰实心点,位于相对时间左侧。
判定顺序
1. 原生待审批 / 计划待审 / 待问答 -> 原生琥珀点(本插件不介入)
2. 原生活跃(运行中 / 子代理运行中) -> 原生动画环(本插件不介入)
3. 原生未读完成 -> 原生绿点(本插件不介入)
4. 手动挂起标记 -> 灰空心环
5. 最后活动 ≥ 5 天且未被唤醒 -> 灰空心环
6. 其余 -> 蓝点
- 「最后活动」取 DSH 会话列表快照里的
updatedAt,不读会话正文。 - 手动挂起只影响视觉,不会阻止会话运行、也不会中断任务。
数据与配置
| 数据 | 位置 | 形状 |
|---|---|---|
| 挂起标记 / 唤醒时刻 | 浏览器 localStorage → dsh.status-lamp.parked.v2 |
{ "explicit": ["会话ID"], "awake": { "会话ID": 时间戳 } } |
| 过滤开关 | 浏览器 localStorage → dsh.status-lamp.filter.v1 |
hide 或 show |
| 阈值 | client.js 的 AUTO_PARK_MS |
修改后重新安装 |
示例(清空所有手动标记):
localStorage.removeItem('dsh.status-lamp.parked.v2')
兼容性
- 在 DSH 0.2.2-rc.1 / rc.3、
desktopprofile、Windows 上开发与验证。 package.json声明"engines": { "dsh": ">=0.2.2-rc.1" }。- 只用官方扩展点:
sidebar.session.row.leading、sidebar.session.row.trailing、会话行菜单(ctx.contextMenus)、Clientlocale/contextMenus/sessions服务。 - 过滤项属于 DOM 级增补:DSH 的「视图选项」菜单没有插件插槽,插件在该菜单打开时克隆一个原生菜单行插入「筛选会话」分组,并用自有样式表隐藏行。DSH 升级若改动菜单结构,这一项会静默消失(不会破坏原生 UI)。
故障排查
| 症状 | 可能原因 | 处理 |
|---|---|---|
| 侧栏没有蓝点 | 插件没启用 / 装到了别的 profile | 「插件」页确认「状态灯」为启用;确认装的是当前应用用的 profile |
| 挂起会话仍显示蓝点 | 该会话正在运行或有未读结果 | 属预期:原生状态优先,等它回到空闲 |
| 「视图选项」里没有「隐藏已归档及挂起」 | DSH 版本改了菜单结构(DOM 增补失效) | 升级插件;或先用原生「隐藏已归档」+ 行菜单手动挂起 |
| 勾选后列表没变化 | 当前视图没有归档/挂起会话 | 正常,没有可隐藏的行 |
| 重启后手动标记丢失 | 清理了站点数据 / 换了浏览器 | 手动标记是浏览器本地数据;自动挂起不受影响 |
| 工作区标题还在但下面空了 | 过滤只隐藏会话行,不隐藏分组 | 已知限制 |
权限与隐私
- 不发起任何网络请求,不上传任何内容。
- 不写 Host、不写会话日志;归档与时间事实都读 DSH 自己的列表快照。
- 只在本机浏览器存储里保存挂起标记与过滤开关。
开发
index.js Host 半区(空实现,仅让 bundle 成立)
client.js 全部逻辑:两个行席位、挂起菜单动作、视图选项过滤行
cordis.patch.yml bundle patch:插入 status-lamp 行
locale/{zh,en}.json 插件管理器里的标题与描述
docs/ 配图
DESIGN.md 设计说明与取舍
改完 client.js 后需要重装(link 安装不会热更新):
plugin_manager: remove_bundle dsh-status-lamp -> install_bundle "D:\dsh space\plugins\dsh-status-lamp"
License
MIT
链接
同类插件
zhu1090093659/dsh-web#packages/dsh-task-board★ 10458
侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。
zhu1090093659/dsh-web#packages/dsh-web-all★ 10458
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
ccch1mneyyy/dsh-TUI★ 7797
Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 7271
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
omdsh-dev/DSH-better-sidebar★ 5191
侧边栏完整工作台:内置文件渲染编辑、终端、Git 与子代理,支持三方插件注册新 Tab。
omdsh-dev/dsh-genui★ 1007
助手回复内渲染交互式 UI 组件:布局、图表、表单、测验、mermaid、3D 场景与回传事件循环。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。