工作区批量移除 theTd/dsh-workspace-batch

dsh-workspace-batch

English · 中文

一个 DeepSeek Harness Web 插件，一次移除侧边栏里的多个工作区。

入口在 Workspaces 标题栏最左侧，是 search / view options / add workspace 这一行里的第一个图标。

用法

勾选行 → Remove selected → Remove。

| 控件 | 作用 |
| 过滤框 | 匹配标题或路径；下面两个按钮只对过滤后的结果生效 |
| Select visible / Clear | 选中或清空当前过滤结果 |
| Select zero-session / Deselect zero-session | 选中未归档会话数为零的工作区 |

N sessions 徽标统计的是未归档会话。归档会保留工作区的会话槽位，所以显示 sessionIds.length 会让一个在侧边栏里看起来空空的工作区标出「46 sessions」。把鼠标悬停在徽标上，可以看到 N visible / M archived。

移除的是什么

只移除注册行 —— tables.workspaces 里的一行，加上 workspace.json 里 global.workspaceIds 的一项。效果和侧边栏行里的 ... → Delete 一样，只是你能一次勾选多个。

它不删除文件夹，不删除会话日志，也不停止正在运行的任务。唯一的副作用：该工作区名下的会话会落到侧边栏的 Ungrouped 下，仍然可以打开和搜索。

宿主没有「因为会话正在运行而拒绝」的拦截 —— 那是 archiveSession 的语义 —— 本插件也不会自己造一个。保护措施是对话框里的确认步骤。

安装

cd $HOME\.dsh\profiles\web
pnpm add -w "link:$HOME/.dsh/plugins/dsh-workspace-batch"

或者直接从本仓库安装 —— 公开仓库，私有仓库则需配置 git 凭据助手，例如 gh auth setup-git：

pnpm add -w "github:theTd/dsh-workspace-batch"

然后把 "dsh-workspace-batch" 加到 package.json 的 dsh.profile.bundles 里。配合 patchReload: live 和 dsh-client-hmr，配置档会把它交给已经打开的页面 —— 不用重启 dsh web。

卸载

cd $HOME\.dsh\profiles\web
pnpm remove dsh-workspace-batch

然后从 dsh.profile.bundles 里删掉对应条目。

开发

没有构建步骤：浏览器收到的就是 lib/client.js。保存它，dsh-client-hmr（每 500 ms 轮询 mtime/size）会在一秒内换上新版本 —— 不用刷新页面。

在隔离实例里试，别碰真实数据：

$env:DSH_HOME="$HOME\.dsh-verify"
dsh --profile web --port 3199 --no-open

| 文件 | 作用 |
| index.js | 宿主侧：空的 apply()，只为占一行 Loader 记录 |
| lib/client.js | 全部内容：标题栏入口、批量对话框、中英文字典 |
| cordis.patch.yml | 包补丁，一行 insert |

限制

- 入口是 portal 进标题栏的，不是插槽。 Workspaces 标题栏没有行内操作插槽；唯一的同级插槽 sidebar.workspaces.directoryFlow，就是目录选择流程的洞，占住它会让「添加工作区」点开本插件。所以走 portal，锚点用 [data-slot="sidebar.workspaces.directoryFlow"]（按槽位名标记，不依赖 CSS 哈希），用 MutationObserver 跟随重渲染，锚点缺失时回退到侧边栏页脚。最坏情况是未来 DSH 布局改动：按钮退回页脚。
- 字典只提供 en 和 zh；其他语言回退到 en。加一种语言就是往 DICTS 里加一个块。
- 不检查「路径是否还存在」：浏览器没有 stat。要做这件事，得在宿主半边加一条只读 HTTP 路由。
- 浏览器下限就是宿主的下限（React 18 + ESM）；插件不能比这更宽。

契约

不 require 任何内置 Client 包；只用三个公开接口：

- ctx.slots.inject / ctx.slots.register({ name, id, order, locale })
- ctx.workspaces.list.getSnapshot() / .subscribe(fn) / ctx.workspaces.delete(id)
- ctx.locale.register(ns, locale, dict) / ctx.locale.bind(ns)

样式用 --dsw-alias- 变量（每个都带字面量回退）；类名前缀 dswsb-。

DSH 浏览器插件：把侧边栏里堆积的 Workspace 一次性批量移除。

入口在工作区标题行最左侧，就是「搜索 / 视图选项 / 添加工作区」那一排的第一个图标。

用法

勾选 → 移除所选 → 确认移除。

| 控件 | 作用 |
| 筛选框 | 按标题或路径过滤；下面两个按钮只作用于当前筛选结果 |
| 全选可见 / 清空 | 全选或取消当前筛选结果 |
| 选零会话 / 取消零会话 | 选中未归档会话数为 0 的 |

行上的 N 个会话 是未归档数量。归档不清 Workspace 的会话槽位，直接显示 sessionIds.length 会把「46 个会话」挂在侧边栏里空无一物的 Workspace 上。
悬停徽标可看 N 可见 / M 归档。

它删什么

只删登记行：workspace.json 里 tables.workspaces 的一行 + global.workspaceIds 的一项。等价于侧边栏行尾 ... → Delete，只是能一次勾多个。

不删目录、不删会话日志、不结束任何任务。唯一副作用：原本挂在该 Workspace 下的会话会落到侧边栏 Ungrouped，仍可打开、可搜索。

宿主没有「会话正在运行所以拒绝删除」的闸门（那是 archiveSession 的语义），本插件也不发明一个；保护手段是对话框里的二次确认。

安装

cd $HOME\.dsh\profiles\web
pnpm add -w "link:$HOME/.dsh/plugins/dsh-workspace-batch"

或者直接从仓库装（公开仓可直接用；私有仓需要 git 凭据助手，例如 gh auth setup-git）：

pnpm add -w "github:theTd/dsh-workspace-batch"

再把 "dsh-workspace-batch" 加到 package.json 的 dsh.profile.bundles 末尾。
profile 的 patchReload: live + dsh-client-hmr 会把它送进已打开的页面，不用重启 dsh web。

卸载

cd $HOME\.dsh\profiles\web
pnpm remove dsh-workspace-batch

再从 dsh.profile.bundles 里删掉那一项。

开发

无构建步骤：lib/client.js 就是浏览器拿到的产物。改完保存，dsh-client-hmr 每 500ms 轮询 lib/client.js 的 mtime/size，1 秒内热替换，页面不用刷。

隔离实例里试，不碰真实数据：

$env:DSH_HOME="$HOME\.dsh-verify"
dsh --profile web --port 3199 --no-open

| 文件 | 作用 |
| index.js | 宿主半边，空的 apply()，只用来占住 Loader 一行 |
| lib/client.js | 全部逻辑：入口按钮 + 批量对话框 + en/zh 字典 |
| cordis.patch.yml | bundle patch，insert 一行 |

边界

- 入口是 portal 到标题行的，不是槽位。 工作区标题行没有行内动作槽位；同级唯一的 sidebar.workspaces.directoryFlow 是目录选择流程的洞，占住它会让「添加工作区」点开本插件。所以走 portal，锚点用 [data-slot="sidebar.workspaces.directoryFlow"] （按槽位名标记，不随 CSS 哈希变），MutationObserver 跟随重渲染，找不到锚点就退回侧边栏底部。DSH 改版搬动那个容器时最坏掉回底部，不会静默消失。
- 只带 en / zh 字典，其他语言回退到 en；加语言等于往 DICTS 加一块。
- 不检测「路径是否还存在」：浏览器侧没有 stat，要做需给宿主半边加只读 HTTP 路由。
- 浏览器下限就是宿主的下限（React 18 + ESM），不是本插件能决定的。

依赖的契约

不 require 任何内置 Client 包，只用三个公开面：

- ctx.slots.inject / ctx.slots.register({ name, id, order, locale })
- ctx.workspaces.list.getSnapshot() / .subscribe(fn) / ctx.workspaces.delete(id)
- ctx.locale.register(ns, locale, dict) / ctx.locale.bind(ns)

样式全部走 --dsw-alias- 变量（带字面量兜底），类名前缀 dswsb-。