工作区分组 shinelon/dsh-workspace-group-plugin

dsh-workspace-group-plugin

DeepSeek Harness（DSH）Web 客户端插件：在侧边栏工作区位置以自定义分组展示工作目录（原地遮蔽官方浏览区，一键切回官方视图）。

icon

功能

- 侧边栏分组视图：以 priority -1 遮蔽官方工作区浏览区（sidebar.workspaces single 槽），原地展示自定义分组树；官方浏览器条目保持注册。视图模式在设置 → 工作区视图中切换（参考「MCP 服务」的设置 section），切换立即生效、无需刷新。
- 自定义分组：区头「＋」新建分组（内联命名，创建后自动展开）；分组「⋯」重命名 / 删除；一个工作目录可属多个分组；不属于任何分组的目录进入「未分组」区。
- 菜单 + 拖拽管理：目录行直接拖到目标分组头移入、拖到「未分组」头移出、拖到同组/异组目录行上/下半排序（合法目标高亮官方放置线）；也可走「…」菜单「移动到分组… / 从分组移除」。
- 目录操作：「＋」开新会话、「⋯」重命名 / 删除（走官方 workspaces 服务）、「添加工作目录」经系统选择器注册。
- 会话浏览：展开目录显示其会话（过滤归档 / 空白 / subagent 行，运行中带状态点，置顶居前带图钉），点击会话跳转对话；会话「⋯」置顶 / 重命名（或双击标题）/ 分叉 / 归档，归档运行中会话弹出「停止并归档」横幅。
- 视图选项（官方同款滑杆菜单，持久化到浏览器）：分组方式（按分组 / 按工作区 / 按工作区树 / 单列表）、排序方式（手动 / 最近更新）、筛选会话（隐藏 / 全部 / 仅已归档）。
- 搜索：区头 🔍 展开搜索框（250ms 防抖走官方 sessions.search），结果显示所属工作区与内容片段，点击跳转；当前打开的会话与目录在树中高亮（selected/folderActive）。
- 持久化：分组数据存 /workspace-groups.json（尊重 DSH_HOME；默认 ~/.dsh），跨会话、跨重启保留；分组方式/排序/筛选/展开状态持久化到浏览器 localStorage。
- 中英文案：跟随 DSH 语言设置。

安装

前置：本机已安装 DSH ≥ 0.2.0-rc.1，插件目录已执行过 pnpm install && pnpm run build。

方式一（CLI，若 dsh 命令可用）：

dsh plugin --profile web add link:D:/dsh_space/dsh_plugins/dsh-workspace-group-plugin

方式二（手工，等效）：在 ~/.dsh/profiles/web/package.json 中：

- dsh.profile.bundles 数组加入 "@local/workspace-group-manager"
- dependencies 加入 "@local/workspace-group-manager": "link:D:/dsh_space/dsh_plugins/dsh-workspace-group-plugin"

然后 pnpm install --dir ~/.dsh/profiles/web，重启 DSH（bundle 名单变更需重启），刷新页面即生效。

开发

pnpm install # esbuild 已加入 allowBuilds；autoInstallPeers=false（peer 仅作引擎声明）
pnpm run typecheck # tsc --noEmit（client TSX，strict）
pnpm test # node --test（store / routes / loopback / group-move）
pnpm run build # esbuild 打包 client → lib/client.js（write:false + Node 落盘）

- 宿主半边（src/host/.js）是纯 ESM JS，免构建，改动后重启 DSH 生效；浏览器半边（src/client/.tsx）改动后 pnpm run build + 刷新页面即生效（bundle 按mtime 换版本，HMR 自动切换）。
- 插件以 link: 方式装入 web profile；只有 bundle 名单变更才需要重启 DSH。

架构速览

浏览器半边 src/client（TSX → esbuild → lib/client.js） index.tsx 注册 locale 词典；按模式遮蔽 sidebar.workspaces / 注册切回哨兵 region.tsx 侧栏分组视图：分组 → 工作目录 → 会话（官方类名 + 官方图标/Menu/Tooltip，指针拖拽 + dataTransfer 驱动放置，视图选项菜单） group-move.ts 拖拽移动矩阵（纯函数，可单测） primitives.ts loader require 访问 ui-primitives（图标/Menu/Tooltip） face.ts 注入面类型（api / nav / ws 三组动词） panel.tsx 共享样式与图标基元（history: 独立分组面板，现已并入侧栏视图） api.ts /workspace-group-manager/* envelope fetch（文档相对路径） locales.ts zh / en 词典（NS = workspace-group-manager，官方带点键名）宿主半边 src/host（纯 ESM JS，免构建） index.js cordis 插件入口（inject: ['webServer']） routes.js /workspace-group-manager 前缀路由：list/create/rename/delete/ add-members/remove-member/reorder-members/reorder-groups store.js JSON 存储层：容错加载、进程内队列串行写、temp+rename 原子落盘 loopback.js 回环信任栅栏（socket + Host + sec-fetch-site/Origin）

数据模型（workspace-groups.json）：

{ "version": 1, "groups": [ { "id": "uuid", "title": "dsh 插件", "paths": ["D:\\..."], "createdAt": "...", "updatedAt": "..." } ] }

成员按工作区 canonical path 存储（工作区删除重注册后 id 会变，路径稳定）；渲染时经全局 useWorkspaces 钩子把路径映射回工作区视图，映射不上的显示为置灰「未注册」行。

边界

- 遮蔽仅在分组模式生效；「使用官方视图」后官方浏览器逐项原样可用，分组数据与官方注册表完全解耦（官方数据零写入，仅调官方公开服务）。
- 官方 CSS 类名（YDXeBa_ / bhn1Oq_）与行结构按 0.1.7-rc.2 硬编码，升级 DSH 需复核。
- 分组数据为本机全局一份（不分 profile）；多标签并发写为 last-write-wins。
- 数据文件损坏时自动备份为 *.bak- 并以空数据启动，区头下方会显示提示。

License

MIT