dsh-workspace-running-dot

在左侧栏折叠的工作区分组行上显示一个运行中小圆点 —— 折叠起来以后也能一眼看出哪个工作区里还有会话在跑。

为什么需要它

侧栏「按工作区」分组时，工作区那一行折叠后就完全看不到里面的状态了。官方的运行中标记（进行中）只画在展开后的会话行上，而 deriveGroups() 在折叠时把 sessions 直接派生成 []，连节点都不生成。想确认哪个工作区还在跑，只能一层层展开。

它做了什么

只做一件事：读 ctx.sessions.list 与 ctx.workspaces.list 两个快照，算出每个工作区里正在运行的会话数，把结果画在该工作区分组行的标题右侧。

• 圆点里始终显示数字（1 就写「1」，3 就写「3」）—— 单跑一个时也一眼看出有几个
• 没有在跑 → 没有圆点
• 数字随会话结束实时减少，归零后圆点消失，不留残骸

子代理也算：主会话的轮次结束后子代理可能还在跑，这时官方侧栏靠 runningChildCount 单独补状态，本插件对齐了同一语义（读 projectionsBySession[id].values.subagentCatalog）。

反过来，子代理不会被单独数一次。子代理本身也是一条会话记录，会出现在 list.ids 里，但侧栏从不给它单独的行；不排掉的话，一个带子代理的会话会让圆点凭空多 1。判据必须走 subagentCatalog —— 实测真实快照的 summary 里没有 parentSessionId 字段（键只有 id / displayTitle / running / retainedBy / blank / updatedAt / formatStatus / projectionValues / title / cwd），拿它判会永远判不出来。

不属于任何工作区的会话单独归到「未分组」那一桶：官方把它们的 key 定成空串（buildGroup("", …)），行的 data-row-key 就是 workspace:。不统计这一桶的话，一个还没落进工作区的新会话跑起来时侧栏毫无动静。

改圆点颜色

打开「插件 → dsh-workspace-running-dot」，页面里有一块圆点颜色：6 个预设色 + 一个自定义取色器 + 「恢复默认」。

• 改动立刻生效，不用重启。
• 选中的颜色存在本机浏览器 localStorage 的 dsrwd.color 键里，只影响这个浏览器。
• 实现方式是把颜色写成根元素上的 CSS 变量 --dsrwd-dot-color，圆点样式读 var(--dsrwd-dot-color, var(--dsw-alias-state-business-primary, #3f7ff5))。用变量而不是 inline style，是因为圆点会被 MutationObserver 反复重画，写 inline style 每次都得重算。
• 未设置时跟随官方主题色 --dsw-alias-state-business-primary，主题切换会跟着变；一旦你手选过颜色，就以你的选择为准。
• 设置页是附加功能：注册它时整段用 try/catch 兜住。万一官方改了这个插槽的契约，坏的只是设置页，圆点本身照常工作。

为什么是 DOM 注入

查过 @deepseek-ai/dsh-client-ui-workspace/lib/client.js：sidebar.workspaces 的 children 只声明了 5 个口子（directoryFlow / session.menu.item / session.row.action / session.row.leading / session.row.hover），工作区分组行 ProjectRowItem 本身没有任何 slot。官方也没打算在那儿显示状态。「折叠后仍然可见的运行指示」在正规插槽层面无解，只能补 DOM。

代价：官方一旦改动分组行的结构，选择器就要跟着改。因此所有选择器都尽量靠 data-row-key / aria-* 而不是 CSS Modules 生成的 hash 类名（hIlkoa_ 前缀每次构建都可能变）。

实现要点

关注点	做法
锚点	[data-row-key^="workspace:"]，row-key 后半段就是 workspaceId
插入位置	projectText 之后、rowActions 之前 —— rowActions 是 display:none，只在 hover 时出现，放它后面圆点会随 hover 左右跳
观察	MutationObserver 挂在 body（subtree: true），折叠/展开/换视图都能触发重扫
防自激	扫描前 disconnect、扫描后重新 observe；只有真的改过节点才补排一帧
重绘节流	requestAnimationFrame，一帧最多扫一遍
数据订阅	sessions.list.subscribe + workspaces.list.subscribe，两者只在真变化时通知，不需要额外节流
颜色	根元素 CSS 变量 --dsrwd-dot-color，圆点样式读它；颜色偏好存 localStorage['dsrwd.color']
设置页	注册到官方 plugins.bundle.config 插槽（key 必须是包名），组件只做取色与写值
卸载	所有副作用挂在 ctx.effect 上：样式标签、观察器、订阅、已画的圆点、颜色变量全部回收

安装

克隆到本地任意位置，然后把它 link 进 profile：

git clone https://github.com/VisualStudioXu/dsh-workspace-running-dot.git

# 1. 装进 profile
cd ~/.dsh/profiles/desktop
#    package.json 的 dependencies 加：
#    "dsh-workspace-running-dot": "link:<克隆下来的绝对路径>"
#    并把它加进 dsh.profile.bundles 数组

# 2. 建链接（Windows 用 junction，bash 的 ln -s 在这里会退化成复制）
cd ~/.dsh/profiles/desktop/node_modules
cmd //c "mklink /J dsh-workspace-running-dot <克隆下来的绝对路径>"

# 3. 重启 DeepSeek Harness

验证

node scripts/20261025-test-dot.mjs

用最小 DOM 桩跑 17 条断言：单/多会话计数、空闲无圆点、插入位置、折叠态仍可见、归零后无残留、空数据不抛错、卸载清理干净，以及颜色的默认值/归一化/非法值回落/持久化读写。

PASS  ws-a 单会话：圆点显示 1
PASS  ws-b 三会话：圆点显示 3
PASS  ws-c 空闲：无圆点
PASS  未分组桶：只数散落会话，子代理不算（显示 1）
PASS  圆点插在 rowActions 之前
PASS  折叠状态（aria-expanded=false）下仍然有圆点
PASS  title 可读
PASS  归零后 ws-a 无残留
PASS  空数据不抛错、无圆点
PASS  默认色写入 --dsrwd-dot-color
PASS  读到已存颜色
PASS  三位 hex 归一化成六位
PASS  非法值回落默认色
PASS  大写 hex 归一化成小写
PASS  没有存过时用默认色
PASS  卸载后样式与圆点都被清掉
PASS  卸载后颜色变量也被清掉
ALL PASS

已知限制

• 依赖官方 DOM 结构，DSH 大版本升级后可能需要调整 dotAnchor() 与 ROW_SELECTOR。
• 只在「按工作区」和「按工作区树」两种分组下有意义；「单列表」视图没有分组行，插件不画任何东西（也不需要）。
• 圆点不可点击 —— 它是指示器，不是入口。要打开那个工作区仍然点分组行本身。

License

MIT