侧栏工作区标签 The-Focus-AI/dsh-plugin-sidebar-workspace-names

侧边栏工作区名称 — DeepSeek Harness

不用离开侧边栏的 _In one list_ 视图，就能看出会话属于哪个工作区。

┌──────────────────────────────────┐
│ Fix the sidebar labels 3h │
│ 📁 claude-usage-esp32 │
├──────────────────────────────────┤
│ Add the cost pill 2h │
│ 📁 focus-desk │
└──────────────────────────────────┘

平铺的会话列表把所有工作区的会话混在一起，光看标题看不出会话在哪儿。这个插件把所属工作区放到标题下面第二行，完整、不截断的名称则放进该行的悬停卡片。

启用插件前后的会话行对比

你会得到什么

- In one list（View options → Group by → In one list）把每个会话渲染成两行：上行是标题和相对时间，下行是工作区名称。
- 不属于任何已注册工作区的会话显示为 Ungrouped。
- 自动生成的默认工作区显示为本地化的「Default workspace」。
- Grouped 和 Workspace Tree 视图不变 —— 它们的工作区标题本来就写着工作区名称。
- 悬停某一行，悬停卡片里会显示完整的工作区名称，即使第二行不得不截断长名称。

安装

从 npm 安装：

dsh plugin --profile desktop add dsh-plugin-sidebar-workspace-names

也可以在桌面应用的 Plugins 页面安装。重启配置档，再刷新一次页面。

从仓库检出安装（无需构建，无依赖）：

git clone https://github.com/The-Focus-AI/dsh-plugin-sidebar-workspace-names
dsh plugin --profile desktop add ~/The-Focus-AI/dsh-plugin-sidebar-workspace-names

工作原理

它是一个普通的 Cordis 客户端插件包 —— 没有打补丁、没有 fork、没有 monkey-patch 任何 harness 源码：

- sidebar.workspaces.session.row.action 承载工作区标签。
- sidebar.session.row.hover 在悬停卡片里承载完整名称。
- 一小段样式表把平铺视图的会话行变成两行，并把每条规则限定在平铺列表内，因此分组视图保持原有的 32px 行高。

client.js 故意以纯 JavaScript 发布：harness 把客户端插件包作为 classic script 注入页面，所以文件原样进入 JS 引擎。没有构建步骤，浏览器里也不做运行时类型剥离。

已知限制

- 行 DOM 耦合。 标签的位置依赖 ui-workspace 的会话行（[data-row-key="session:…"]）和常驻的行操作条。这是装饰层面的约定，不是公开 API；engines.dsh 锁定了测试过的版本范围，harness 有变动时应当给插件升版本。
- 标签显示时，操作条自带的控件会被隐藏。 因为标签和 archive/pin 共用操作条，平铺行上这些按钮会被抑制，悬停时再出现；harness 若改动操作条的标记结构，可能让它们一直可见。
- 必须支持 :has()，扁平视图的作用域才能生效（Chromium 105+、Safari 15.4+）。不支持时，chip 会一直隐藏。
- 固定两行高度。 工作区名称超出该行时省略，悬停卡片显示完整名称。扁平视图里每行高 48px。
- 空白 New Session 行没有操作条，因此保持单行高度。
- 没有视觉测试。 测试套件只覆盖名称解析；布局是 CSS，作用在另一个包的 DOM 上。

开发

mise trust
mise install
mise test # node --test
npm pack --dry-run # verify the published file list

这个包没有运行时依赖，也没有构建步骤。

许可证

MIT — 见 LICENSE。