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}

它解决什么

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 后再装）并重启即可恢复。

用法

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

和原生列表的关系

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`	插件图标

License

MIT

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

dsh-workspace-categories

Installazione

README