工作区分组 burningg/dsh-workspace-categories

dsh-workspace-categories

给 DeepSeek Harness 的工作区加分类。 把平铺的项目列表分成自定义分组，直接在侧边栏按分类浏览，拖一下就能改归类；顺手用 Ctrl+Tab 在最近会话之间来回切。

Category groups for DeepSeek Harness workspaces. Split a flat project list into named sections, browse them right in the sidebar, re-file by drag and drop, and hop between recent chats with Ctrl+Tab.

DeepSeek Harness 0.2.x · Web / Desktop · MIT

Listed on dsh-plugin.org

它解决什么

Harness 的侧边栏默认只有「工作区」这一层：项目一多就平铺成一条长列表，找东西只能靠记名字。这个插件在工作区之上再加一层自定义分类，让列表变成

▾ 产品 3 📁 项目一 12 📁 项目二 4 📁 项目三 1 ▾ 研发 2 📁 项目四 8 📁 项目五 2 ▾ 归档 3 📁 项目六 6 📁 项目七 3 📁 项目八 2 ▾ 未分类 2

分类和文件夹层级无关，可以任意组合；同一分类内的顺序仍由 Harness 的工作区顺序决定。

功能

- 分类侧边栏：分组头可折叠，工作区行显示会话数，展开后是会话列表（标题 + 相对时间）
- 一键收起：侧边栏工具栏的收起按钮一次折叠全部分类和分类下的工作区，只留分组标题；要看内容就点单个分组或工作区的箭头逐层展开（只做收起，没有一键展开）
- 两种归类方式：把工作区行拖到别的分组，或在分类管理面板里用下拉框选
- 分类管理面板：新建 / 重命名 / 删除分类，一眼看到每个分类下有哪些工作区
- 三层视觉区分：分类是一条中性的分组底 + 14px 加粗，工作区是正文色 14px，会话再小一号、用次级灰并缩进挂在工作区下面，一眼能看出谁属于谁；分类名默认用正文色，想要配色可以在外观里打开「分类名用强调色」或给「分组底色」选个颜色
- 可调外观：面板工具栏的「外观」里能分别调三层的字号、工作区 / 会话的文字颜色、分组 / 卡片 / 面板底色，还能切换分类名是否用强调色；每个分类的颜色点直接点开改，一键恢复默认
- 搜索：按工作区名、路径、会话标题过滤
- 最近会话切换：像编辑器切标签页那样按 Ctrl+Tab（macOS 上是 Control+Tab）在最近打开的会话之间跳：按住修饰键连按 Tab 翻列表，松开就切过去；Shift+Tab 反着走，Esc 放弃
- 用 VS Code 打开：工作区 ⋯ 菜单里一键把该工作区目录交给本机 VS Code。宿主先按系统登记的「能打开文件夹」应用列表找 VS Code（macOS 走 Launch Services，所以装在 /Applications 之外也能找到），找不到再退回宿主自带的 open-in-app 启动目录；路径由宿主校验通过后才启动，没装 VS Code 会直接提示而不是静默失败
- 保留的操作：打开工作区 / 打开会话 / 新开对话 / 工作区 ⋯ 菜单（打开所属目录、用 VS Code 打开、重命名、删除工作区）/ 添加工作区（系统目录框）/ 归档会话 / 搜索

安装

这是一个 Harness bundle（dsh.bundle.patch + 浏览器半），一条命令从 GitHub 源码安装：

dsh plugin --profile web add github:burningg/dsh-workspace-categories

也可以手工写进 profile 的依赖后启用：

~/.dsh/profiles/<profile>/package.json → dependencies
"@burningg/dsh-workspace-categories": "github:burningg/dsh-workspace-categories"

启用后侧边栏图标栏会出现「工作区分类」，左侧列表在有至少一个分类后自动变成分组视图。

装完要重启 DSH。 插件的包路径在进程启动时就已确定，安装或更换来源后必须重启才会生效。

不要用 link: 装一个之后会被移动的目录。 link: 会把仓库的绝对路径写进 profile 依赖；之后移动或改名该目录，DSH 仍按旧路径读包，插件页就会报包元信息错误：Plugin metadata for @burningg/dsh-workspace-categories: Error: ENOENT: no such file or directory, scandir '<旧路径>/locale'。
换回 github: 安装（或用 dsh plugin --profile <profile> remove 后再装）并重启即可恢复。

用法

1. 点侧边栏的 工作区分类（文件夹 + 三个点的图标），打开分类管理
2. 新建分类，起个名字（例如 产品、研发、归档）
3. 回到侧边栏，把工作区行拖进对应分组；或在管理面板里用下拉框选
4. 列表太长时点侧边栏右上角的 收起（双箭头向上）：全部分类和工作区一起折起来，只留分组标题；之后点某个分组或工作区的箭头单独展开
5. 不想看分组时，把面板里的开关 「侧边栏按分类分组」 关掉，原生列表立刻回来
6. 嫌层级不够清楚就点工具栏的 外观：三层字号、工作区 / 会话颜色、各种底色都在那里，改完立刻生效；卡片左边的色点就是该分类的颜色
7. 想回到刚才那个对话，按住 Control（Windows 上是 Ctrl）连按 Tab：中间会浮出一张「最近会话」卡片，松开修饰键就切过去

最近会话切换

打开过的会话按使用顺序排一份历史，Ctrl+Tab 就在这份历史里走——和 VS Code 切标签页是同一个手感：

| 操作 | 结果 |
| 按住 Ctrl（macOS Control）再按 Tab | 浮出最近会话卡片，高亮落在上一个会话上 |
| 继续按 Tab / Shift+Tab | 在列表里向下 / 向上移动高亮 |
| 松开 Ctrl | 切到当前高亮的会话 |
| Esc | 关掉卡片，什么也不切 |
| 方向键 ↑ / ↓、PageUp / PageDown、Enter | 卡片打开时的等效操作 |
| 鼠标移动 / 点击 | 指针真的动过之后，悬停才改高亮；点击直接切过去 |

- 只接管 Ctrl+Tab 和 Ctrl+Shift+Tab 两个组合：普通 Tab、Cmd+Tab（系统应用切换）以及其它按键都原样放行；在输入框里打字也不受影响
- 顺序跟着主视图走：你在侧边栏、搜索或卡片里打开哪个会话，它就会被提到最前面；当前正在看的会话带一个「当前」标记
- 列表只显示还能打开的会话：已归档的不会出现，正在跑的那条左边是实心蓝点，还没起名的会话显示为「新对话」
- 每条显示标题、所属工作区、相对时间；标题、工作区、时间都实时读 Harness 自己的会话目录，改名或新消息立刻反映，插件不另存一份
- 历史上限 12 条；第一次使用时用「最近活跃」补齐，之后按你的实际切换顺序调整
- 只有一个能打开的会话时按 Ctrl+Tab 不会有反应（没有可切换的目标）
- 鼠标不动就不会抢高亮：卡片正好开在光标下面（比如鼠标停在屏幕中间）时，也仍然落在「当前会话的邻居」上；只有你自己移动鼠标，悬停才会接管高亮
- 分类面板右上角有个 Ctrl+Tab 小胶囊：鼠标停上去是这条提示，点它也能打开同一张卡片；宿主没提供会话目录时它不显示，功能也自动关闭（其余功能照常）

浏览器里的 Ctrl+Tab 由浏览器自己接管，网页拿不到这个组合（桌面版 DSH 是 Electron，可以正常用）。在浏览器里可以用面板右上角那个小胶囊打开同一张卡片；桌面端不受影响。

和原生列表的关系

Harness 的工作区浏览区（sidebar.workspaces）是一个单占位槽，原生组件只按工作区一层分组，没有插入分组的接口。所以本插件以 priority: -10 占住同一个槽位来渲染分组视图，并且：

- 可一键关闭：面板里的开关会注销这次占位，原生列表立即恢复，无需刷新
- 零分类时自动让位：没有任何分类时插件不占位，列表保持原生
- 出错自动回退：组件渲染异常时插槽会让出单元格（abdicate），原生列表自动回来
- 行内操作和原生一致：鼠标移到工作区行上，右侧出现原生的 ⋯ 和「新开对话」两个按钮（16px、无背景、label-tertiary → 悬停 label-primary，间距 15px，都直接用 Harness 自带的图标和 Menu 组件）；⋯ 里是「打开所属目录」「用 VS Code 打开」「重命名」「删除工作区」：打开所属目录把工作区文件夹交给宿主桌面（macOS 是 Finder，Windows 是资源管理器，Linux 是默认文件管理器），路径由宿主重新校验后再打开；用 VS Code 打开走宿主登记的文件夹处理程序（macOS 是 Launch Services，Windows / Linux 是系统关联查询）挑出 VS Code 后启动，所以 VS Code 装在 ~/Applications、/Applications/develop 这类非标准位置也能找到，系统里没有登记时再退回宿主自带的 open-in-app 目录；重命名在行内直接改，删除会在行下展开一次确认。常显时那一格仍然显示会话数。

代价是原生浏览区内部的一些能力不再提供（它们没有对外接口）：会话置顶、会话右键菜单里的重命名 / 分叉 / 复制 ID、归档筛选、悬停卡片、拖拽排序、Mod+K 快捷键。需要它们时关掉开关即可。

数据

分类、归类关系、侧边栏开关和外观设置都存在当前页面的 localStorage（dsh.workspace-categories.v2，会从 v1 自动迁移）；最近会话的顺序单独存在 dsh.workspace-categories.mru.v1，里面只有会话 id：

- 不修改工作区注册、不移动文件、不改会话归属或工作目录
- 外观只写 CSS 变量（--wsc-cat-size / --wsc-ws-color / --wsc-cat-bg 等），不改 Harness 的主题
- 换浏览器或清站点数据会丢分类和最近会话顺序；工作区、会话本身不受影响

权限与外部服务

- 不联网：没有遥测、没有远程请求、不调用任何第三方 API；全部逻辑都在浏览器半
- 只写页面本地存储：分类、归类、开关、外观与最近会话顺序，都只存在当前页面的 localStorage
- 会启动本机程序的两处：「打开所属目录」和「用 VS Code 打开」。两者都由宿主（DSH）校验路径后再启动，插件自己拿不到也不执行命令
- 不碰磁盘：不移动、不删除、不改写任何项目文件；不改工作区注册与会话内容
- Host 半（index.js）是空的 apply()，不注册任何宿主服务、工具或网络端口

兼容性

面向 DeepSeek Harness 0.2.x 开发与验证：插件行加载、main / sidebar.panellist / sidebar.workspaces 三个扩展点的注册均已确认；最近会话卡片挂在 shell.overlay 上，数据读 sessions.list 与 workspaces.list 两个快照，宿主没有提供会话目录时这部分自动关闭。视觉上依赖 Harness 的 --dsw-alias- 主题令牌，浅色 / 深色主题通用；行高与字号取自 Harness 自带的 WorkspaceBrowser.module.css / Rows.module.css，以便和原生列表一致。

结构

| 文件 | 作用 |
| index.js | Host 侧空壳，只提供 Loader 行，让浏览器半可被组合下发 |
| client.js | 全部界面与状态：分类面板（main）、侧边栏图标（sidebar.panellist）、分类侧边栏（sidebar.workspaces）、最近会话卡片（shell.overlay） |
| cordis.patch.yml | 插入 workspace-categories 这一行 |
| locale/.json | 插件列表里的标题与描述 |
| icon.svg | 插件图标 |

许可证

MIT