侧栏标签灯 luzonghao/dsh-sidebar-light

dsh-sidebar-light

给侧栏加上 Workspaces | Tags 两个 Tab、给每个工作区一行状态灯，并给会话加上标签。
纯客户端 DSH 插件（无 Host 行为），中英双语。

已改名：本插件原名 Workspace Light（dsh-workspace-light）。若你装的是旧名，请先移除旧 bundle 再装新名；标签与未读标记会自动迁移（跨代回落 sidebar-light → workspace-light → green-light）。

装上即用

不需要任何设置：侧栏头部直接出现 Workspaces | Tags。

- Tags Tab：标签树（标签名以 / 分段自动成树）、计数、状态灯、搜索、视图选项、双击重命名、删除（行内二次确认）、拖拽排序。
- 头部按钮沿用宿主自己的那三个（搜索 / 视图选项 / 新建）——Tags 下点击它们会转向标签的行为，因此两个 Tab 用的是同一组按钮，不是"画得像"。
- 系统按钮区：Logo 下方那行改为 [Plugins] [Automation tasks] [群议] … [刷新]，左侧是各插件面板入口、右侧是刷新，全部纯图标 + Tooltip。

状态灯

| 状态灯 | 含义 | 优先级 |
| 🟡 | 该工作区有会话在等你（提问 / 待批准） | 1（最高） |
| 🔄 | 有会话正在执行（转圈） | 2 |
| 🟢 | 有会话已完成但你没看过 | 3 |
| ⏰ | 只剩定时任务 | 4（最低） |

优先级与宿主自身的规则一致，因此不会与你已经看到的点相矛盾。

树形模式下逐级穿透：父级会汇总全部子孙工作区的状态 —— 折叠起来也照样生效（判据取自宿主自己的分组状态，而不是"当前可见的缩进"）。

标签

- 层级只是命名层级，不是继承：把 test/test1 贴到会话上不等于贴了 test。
选中某个标签只列出显式贴上它的会话，右侧数字也是它自己的用量；隐式中间层级（没有对应标签记录）自然为空。状态灯仍按子树聚合。
- 视图选项（与宿主 Workspaces 的 View options 对齐，选择在同一会话内记住）： 分组 标签树 / 单列表；排序 手动（可拖拽）/ 最近更新 / 按名称 / 按使用次数； 筛选会话 隐藏已归档 / 全部（显示已归档）/ 仅显示已归档。
- 重命名：点行内的铅笔按钮，或双击标签名，就地改名（回车确认 / Esc 取消）；空名字/纯空白会保持原样，改成 a/b 会直接建立层级。改成 a/b 会直接建立层级；已贴到会话上的标签不受影响（关联按 id）。
- 删除：点垃圾桶后该行变为红色「删除」+「取消」，点「删除」才真正删除；点外部 / Esc / 切换 Tab 都会取消。删除标签不会删除任何会话。
- 会话行标签按钮：鼠标移到会话行，最右侧出现标签按钮（原生 pin / archive 已隐藏，这两个动作仍在「⋯」菜单里）。已贴标签的行常显并带数量。
- 刷新页面：系统按钮区右侧的刷新按钮；⌘R 由本插件接管（见下）。

快捷键

| 组合 | 动作 |
| ⌘1 | sidebar-light.tabWorkspaces —— 切到 Workspaces Tab |
| ⌘2 | sidebar-light.tabTags —— 切到 Tags Tab |
| ⌘D | sidebar-light.markUnread —— 把当前会话标为未读 |
| ⌘R | 刷新页面（本插件接管，走宿主快捷键系统的用户覆盖） |

插件注册两个 ctx.shortcuts 命令，都不带默认键（defaults: {}）：

- 注册期 parseShortcutDefinitions 会逐 profile 检查默认键重叠，同一 profile 下两条命令不能占同一组合；宿主内置的 page.refresh 已占 ⌘R，若插件再声明会直接抛 Conflicting or reserved shortcut default。
- 因此绑定只走用户覆盖（keybindings.json）。参考：

// ~/Library/Application Support/@deepseek-ai/dsh-desktop/keybindings.json
{
"schemaVersion": 2,
"profiles": {
"desktop:macos": {
"sidebar-light.markUnread": { "code": "KeyD", "modifiers": ["meta"] },
"sidebar-light.refresh": { "code": "KeyR", "modifiers": ["meta"] },
"sidebar-light.tabWorkspaces": { "code": "Digit1", "modifiers": ["meta"] },
"sidebar-light.tabTags": { "code": "Digit2", "modifiers": ["meta"] },
}
}
}

为什么刷新要注册成插件命令、而不是靠内置 page.refresh：宿主的快捷键服务会先于页面脚本捕获 ⌘R（它注册更早），而内置 page.refresh 在桌面端不生效 ——于是"⌘R 一直没反应"。改成注册 sidebar-light.refresh 并由用户覆盖绑定 ⌘R 后，宿主服务会转交到本命令，刷新才真正生效。

改键位需重启 DSH（桌面端没有文件监视器）。

目标会话如何确定：快捷键没有菜单上下文，故读宿主会话行的语义属性 ——
[data-row-key^="session:"][aria-selected="true"]（不是 CSS module 哈希类名）。
没有选中会话时返回 blocked（no session selected），不会误标。

⚠️ 命令 id 是用户可见契约（keybindings.json 以它为键）。改名会让已有绑定静默休眠。

语言：插件文案（含 Tags 视图选项菜单）跟随 DSH 的语言设置 —— 判定来源是宿主自己写的，因此你在 DSH 里切成中文，插件立即变中文（不需要重启，刷新即生效）。

两个 Tab 的胶囊本身带 Tooltip：悬停会显示对应组合（如 Tags (⌘2)）——若你在设置里改过键，提示会跟着变（读宿主绑定；读不到时显示出厂值）。

安装

dsh plugin --profile <你的profile> add \
https://github.com/luzonghao/dsh-sidebar-light/releases/latest/download/dsh-sidebar-light.tgz

新增 bundle 后需重启 DSH；此后改代码只需刷新页面。
其余装法（目录 / npm / git）、卸载、手工等价操作见 INSTALL.md。

为什么不容易随宿主升级而失效

状态灯不是手绘复刻宿主样式，而是克隆宿主自己的 StateDot 组件插入行内 ——尺寸、颜色、动画都来自宿主组件与其样式表。搜索框、菜单、头部按钮同样复用宿主自己的实现 （读它的类名 / 实测它的计算样式 / 直接使用它的按钮），因此 DSH 升级时本插件跟着走，而不是被打破。

插件对宿主只做三类事，且都有边界：

1. 往会话/工作区行里插入克隆来的状态灯与标签按钮；
2. 在 document.body 上挂自己的浮层（Tags 视图、菜单、刷新按钮），不进入宿主的 React 子树；
3. 需要给宿主"让位"时只写内联样式（可原值恢复），从不写 属性 —— 那会触发宿主重算布局（曾把主区域从 1402px 压到 546px，见 index.md §63）。

自检与诊断

node test/logic.test.mjs # 离线单测 173 例，不需要 DSH

插件还提供不依赖控制台的通道（桌面端没有控制台）：

- 刷新按钮：系统按钮区右侧；
- ⌥ 点击刷新按钮 = 把诊断（safety / probe / panel）复制到剪贴板；
- 错误会主动弹出：插件捕获到异常时，右下角直接显示错误文本（而不是只藏在 tooltip 里）。

__dshSidebarLight.probe() // 锚点 / 浮层 / 各元素 rect
__dshSidebarLight.safety() // 熔断状态与已捕获的错误
__dshSidebarLight.layoutSelfTest() // 逐个撤掉插件痕迹并测量主区宽度
__dshSidebarLight.surface('sidebarTab', false) // 临时关闭 Tags Tab（刷新后生效）

已知限制

- 样式瑕疵（Tags 的视图选项菜单）：为了让菜单与宿主观感一致，插件会克隆宿主自己的菜单 （结构、类名、图标、间距同源）。模板在你第一次打开 Workspaces → 视图选项时抓取；在那之前（或抓取失败时）会退回自绘菜单 + 实测样式，此时行高与分组标签的字号/间距可能与宿主略有差异。这是外观差异，不影响功能：分组 / 排序 / 筛选三项都可用。
想让它立刻用上克隆版本：打开一次 Workspaces 的视图选项即可。
- Tags Tab 的视图渲染在自己的浮层里（宿主没有"侧栏视图 Tab"插槽）。因此宿主若大幅改动侧栏 DOM 结构（类名/层级），该视图可能失效 —— 插件会退回不显示而不是留下空白侧栏。
- 归属取自 React 侧 useWorkspaces / sessionStatus，因此折叠的工作区组也会计入汇总；
- 标签与未读标记存在浏览器本地（localStorage；当前 Tab 存在 sessionStorage），不跨设备同步；
- 宿主的「⋯ 菜单」插槽若变更，菜单项会静默消失（指示灯不受影响）；
- 会话行已有宿主自己的状态点时，本插件不再叠加未读绿点（避免两个点）。

文档

| 文件 | 内容 |
| INSTALL.md | 安装 / 卸载 / 验证 / 发布 |
| CHANGELOG.md | 各版本要点 |
| index.md | 设计、决策与全部修订记录（含事故复盘与实现细节） |
| LICENSE | MIT |

免责

第三方插件，与 DeepSeek 官方无关。安装第三方 dsh 插件等于在本机以你的权限运行其代码 —— 请先读源码。