dsh-sidebar-focus

左侧工作区的排序与展开，按「有没有在跑」来决定。五条规则，每条一个开关，位置在 插件页 → 点开 dsh-sidebar-focus 之后的详情页里（在描述与行列表之间）。

安装

dsh plugin --profile web add dsh-sidebar-focus

还没上 npm 时用 GitHub 源：

dsh plugin --profile web add github:wjingshan/dsh-sidebar-focus

装完刷新页面即可 —— 本插件是纯客户端（宿主半身是空的），不需要重启 dsh web。

它做什么

开关	默认	作用
置顶正在运行的工作区	开	有会话在跑、或正在等你的工作区排到列表最前。只影响显示，你手动拖出来的工作区顺序从不被改写
自动展开正在运行的工作区	开	有会话在跑、或正在等你的工作区自动展开。宿主本身只在「当前会话所在的工作区」上这么做，这条把它扩展到所有在跑的工作区
置顶正在进行的会话	开	运行中与等待你处理的会话排到所属工作区的最前
收起没有运行的工作区	开	没有会话在跑的工作区保持折叠
保留未读完成提醒	开	含「已完成未查看」的工作区不自动折叠，避免刚跑完的会话被收起来

交互语义：什么时候它不接管

自动折叠最烦人的失败模式是「你点开、它立刻折回去」。所以两侧都留了 意图豁免：

• 你亲手展开一个空闲工作区 → 它保持展开，插件不再碰它，直到这个工作区重新变忙再变闲；
• 你亲手折叠一个正在运行的工作区 → 它保持折叠，插件不替你展开，同样直到忙碌状态再次变化。

豁免只在本次页面会话内有效，刷新后回到规则本身。判断依据是 aria-expanded 上不是本插件 写出的翻转——所以「搜索结果跳转」「新建会话」这类宿主自己的展开，也被当成你的意图而保留。

另外两条不参与自动折叠的例外：

• 未分组（Ungrouped）永不折叠：那是散落会话的收容所，不是谁主动选的工作区；
• 当前选中会话所在的工作区保持展开：否则切换会话会落到一个被折起来的组上 （宿主的自动展开只对「没有存过状态」的组生效，而本插件会写状态）。

做法，以及为什么

• 排序不移动 DOM：列表列原本是 overflow-y:auto 的块容器，order 对它无效；插件先把它变成 flex 列（[data-wsf-rank-tree]），再用 order 给忙碌工作区 / 活动会话排名。DOM 节点从不移动， 所以 React 的 reconciliation 与内置的 FLIP 行动画都不受影响。
  • 排序是纯展示：不写 Workspace.sessionIds，也不碰你手动排序的结果。
• 折叠是一次状态写入：折叠的组根本不渲染会话行（宿主的 deriveGroups 对折叠组返回空 sessions），所以 DOM 层做不到，必须改展开状态本身。写入走宿主自己的视图 store： ctx.get('uiWorkspace').view.setGroupExpanded(key, expanded)，键就是工作区 id。
• 「有没有在跑」不能只读行：只看 DOM 的判据在这里必然出错——组一折起来就没有行可读，于是 「里面有会话开始跑了」永远看不见，那个工作区会一直关着（用户报过：正在运行的工作区被折叠，打不开）。 忙碌判定因此改为读 Session 状态快照 useSessionStatus（running / pendingInteraction / completionUnread，与三条判据一一对应）加 Workspace 成员表 useWorkspaces （items[].sessionIds 说明哪些会话属于哪个工作区）。这两个事实与「有没有渲染成一行」无关， 折叠态照样成立，所以折叠中的工作区一旦开工就会被看见并展开。 两个 hook 由挂在 shell.overlay 上的零渲染桥接组件发布给 watcher（选它只因为那个席位永远挂载）。 行仍然照读——行级标记要用，快照未就绪时也要回退；两个来源取并集，任一见到在跑就不许关。
• 所有开关都是开关：关闭时对应的 data-wsf-* 标记会被移除，CSS 规则随之失效，侧栏回到原生 布局与原生折叠行为——不做「半开」状态。

依赖的宿主契约（实测于本 profile 的内置 dsh-client-ui-workspace）

事实	来源
会话列表是 div[role="tree"]	AnimatedRows.render
工作区行是 div[data-row-key="workspace:<key>"][role="treeitem"][aria-expanded]，其父元素即组的 section	renderGroup / ProjectRowItem
会话行是 div[data-row-key="session:<id>"][role="treeitem"][aria-selected]，第一个子元素是该行自己的状态槽	SessionNodeItem
状态点带 data-state ∈ {ongoing, warning, done, error, idle}	ui-primitives 的 StateDot
展开状态存在 dsh.workspace.view.v5，groupExpansion[key] 显式为 false 才折叠	createWorkspaceViewStore / deriveGroups
接口是 ctx.get('uiWorkspace').view.setGroupExpanded(key, expanded)	UiWorkspaceService 的 view 字段
折叠的组不渲染任何会话行，所以运行状态必须另有来源	deriveGroups 的 GroupNode.sessions
槽位标准钩子 useSessionStatus / useWorkspaces 提供状态快照与工作区成员	shell.overlay 的 standardProps
WorkspaceSnapshot.items[].sessionIds 是「谁属于哪个工作区」	dsh-api-workspace-controller 的 WorkspaceView / WorkspaceSnapshot

这些是构建产物的结构，不是文档化 API：宿主升级后如果结构变了，插件会安静地什么都不做 （data-wsf-* 标记无处可落），而不是弄坏侧栏。若 uiWorkspace.view.setGroupExpanded 不存在， 折叠会被整体关闭，并在该插件的详情页上显示告警、控制台打印原因——不会静默失败。

已知限制

• 不折叠未分组，理由见上；如果你要连它一起收，改 scanGroup 里的 key === '' 判断。
• 自动折叠写的是宿主自己的视图偏好：被自动折起来的工作区，其 groupExpansion[key] 会以 false 持久化。卸载本插件后它们会保持折叠——手动点开即可恢复，或在插件页里禁用这个包再刷新。
• 子工作区（树形分组）不参与置顶：子组在父组的 role="group" 容器里，不是列表列的直接子元素， order 在那里无效。会话级排序不受影响。
• 状态判定只读「运行中 ongoing」与「等待你 warning」；error 不参与。

验证状态

已验证：

• node --check 通过；manifest 解析通过；
• 安装返回 application: applied，profile 的 dependencies 与 dsh.profile.bundles 都已登记；
• 实时客户端注册已生效：plugins.bundle.config 席位上出现了 dsh-sidebar-focus 这个 key （cordis_inspect_query 可见）。插件页只在存在该 key 的注册时才渲染那块配置 （owner 的判据是 ledger.bundles.has(pkg.name)），所以这一条同时证明详情页里会出现这 5 个开关；
• 原先在「设置 → 通用」的 5 行已确认从 settings.general.item 移除，不会两处重复；
• 状态桥接已确认挂载：shell.overlay 的实时占用者里有 dsh-sidebar-focus.status-bridge， 而该席位的 standardProps 同时提供 useSessionStatus 与 useWorkspaces。

未验证（本机 GUI 需要启动令牌，agent 浏览器无法进入；按插件规范的验证边界，未用截图或模拟 DOM 冒充）：

• 视觉结果（置顶后的实际顺序、flex 化后的行高与间距、浅色/深色两套主题下的观感）；
• 五条规则在真实运行/空闲会话上的实际效果，尤其是这一条：在一个已折叠的工作区里启动会话， 它应当自动展开。我能证明的只到「判据已换成不依赖行渲染的快照」；真实会话的启动我驱动不了；
• 与内置 FLIP 行动画、拖拽排序的共存表现。

自查方式：刷新 Web 页面 → 打开一个正在跑的工作区（应自动展开并置顶）→ 打开一个空闲工作区 （应保持折叠，你手动展开后应保持展开）→ 控制台不应出现 [dsh-sidebar-focus] 开头的报错。