工作区排序 mrbeandev/dsh-workspace-sorter

dsh-workspace-sorter

为 DeepSeek Harness 提供独立的工作区文件夹排序，在侧边栏已有的 View options 菜单里单独加一节 Workspace order。

- 源代码： github.com/mrbeandev/dsh-workspace-sorter
- npm 包： npmjs.com/package/dsh-workspace-sorter

目录： 为什么需要这个插件 ·安装 · 兼容性 ·开发 · 本地搭建 · 发布检查清单

为什么需要这个插件

DSH 原生的 Order by → Last updated 排的是每个工作区内部的会话，不是工作区文件夹本身。这个插件加了一个独立的排序选项，不会覆盖宿主保存的手动工作区顺序。

从 npm 安装

当前这份代码准备的是 0.1.3，包含运行中工作区文件夹发光、折叠工作区名称快速打开两项功能。本次改动尚未发布 0.1.3。请避开 0.1.0，它没通过隔离 GUI 启动测试。

dsh plugin --profile web add dsh-workspace-sorter

如果装过旧版 dsh-workspace-sort 插件，先禁用它，收尾手头的工作，需要时重启 DSH，再刷新实际的 DSH Web 页面。然后打开 Workspaces → View options → Workspace order。

卸载：

dsh plugin --profile web remove dsh-workspace-sorter

需要时重启并刷新。宿主的顺序不用恢复，只会留下浏览器偏好。

工作区名称快速打开

工作区折叠时，点击它的名称会展开，并按会话更新时间打开其中最新的未归档会话。临时的空白会话会跳过；空工作区就只是展开。点击箭头、文件夹图标或行的空白区域，保持原生「只展开/折叠」的行为。工作区操作按钮不受影响。点击已展开工作区的名称，保持原生折叠行为。带修饰键的点击不会触发自动跳转。这不会改变已保存的会话顺序。

运行中工作区指示

只要有成员会话在运行，工作区文件夹图标就会发绿光，工作区折叠时也一样。选中但空闲的会话不会触发发光。成员会话的子代理目录里列出的运行中子代理也算数。指示跟随 DSH 的实时会话状态存储，工作停止后自动清除。两种工作区排序选项下都能用。
光晕是常亮的（没有闪烁动画）。只有文件夹图标会获得颜色和阴影；原生行选中、标签、会话指示器都保持不变。它并不表示工作区只是被选中。实现和状态聚合都有单元测试；完整的 running → idle 转换仍需要真实智能体的浏览器测试。装上指示器包装后，侧边栏冒烟测试套件通过。

工作区顺序菜单

| 选项 | 效果 |
| Manual workspace order（默认） | 显示宿主保存的手动顺序。 |
| Last used workspace | 成员会话活动最新的排前面；空工作区排最后，并列时按手动顺序。 |

原生会话顺序选项保持独立。参见下面的限制。

0.1.3 候选版——本次变更未发布。 已发布的 0.1.0 在干净的 DSH 配置档里无法通过真实浏览器激活；不要启用它。修正后的候选版在 DSH 0.2.0-rc.2 上通过 10/10 项真实浏览器冒烟检查，以及 4/4 项卸载后检查。更广泛的共存与交互测试仍待进行。参见 RELEASE.md。

工作区独立排序位于 DeepSeek Harness 侧边栏现有的 View options 弹窗里，在会话顺序选项下方。

- Workspace order → Manual workspace order 保留宿主保存的顺序（默认）。
- Workspace order → Last used workspace 按工作区最新优先显示，依据其成员会话中最新的 updatedAt。空工作区排最后；并列时保留手动顺序。
- 会话排序、分组、归档过滤、固定、搜索、重命名和删除都保持原生。
- 偏好设置保存在浏览器本地，持久化为 dsh-workspace-sorter.order.v1。同一来源下会跨标签页同步。
- 不发网络请求，不涉及凭据、会话内容，也不对宿主工作区做持久更改。

兼容性与限制

为 DSH 0.2.0-rc.2 固定内部适配器。 原生视图选项菜单没有公开扩展槽位。本插件包装已注册的 WorkspaceBrowser 函数，转换返回的 ViewOptionsMenu，并投射出排序后的工作区快照。它保留原条目的注入服务、子槽位权限、语言环境和 store。它不修改已安装的 DSH bundle，也不操作 DOM。这是内部集成，不是稳定的公开菜单 API；适配器会等待原生注册，遇到不匹配的侧边栏组件就原样保留，而不是让应用启动失败。

「Last used」指的是最新的会话活动，不只是点击文件夹。活动包含已归档的会话。工作区树模式保留原生层级，并在其中应用排序。扁平模式下没有工作区列表可供重排。Last used 生效期间，工作区拖拽提交会被抑制；拖拽前请切换到 Manual。会话拖拽行为保持原生。原生拖拽提示仍然显示。
UI 新增内容有意只提供英文。发布前仍需完整的浏览器运行时/HMR 与共存测试。启用/禁用后必须完整刷新，因为适配器会更换实时组件入口；不承诺自动 HMR。

构建与测试

npm run check
npm pack

当 DSH_TEST_WORKSPACE_CLIENT 指向已安装的 dsh-client-ui-workspace/lib/client.js 产物时，会运行可选的已安装 bundle 形态检查。没有它时，这一项集成检查会被跳过，贡献者和 CI 无需私有 DSH 安装。这项检查只看形态，不看浏览器行为。

可编辑的客户端源码是 client/index.mjs。scripts/build.mjs 生成 lib/client.js，使用 GUI 的 React 单例，而不是打包 React。宿主 index.mjs 有意为空操作；cordis.patch.yml 注册这个双面包。不需要 Remote 或额外的服务命名空间。唯一注入的包是 @deepseek-ai/dsh-client-ui-workspace，它拥有侧边栏并提供自身依赖。

本地试用

先在一次性 web 配置档中测试打包好的 tarball。未经明确授权不要发布。

dsh plugin --profile web add /absolute/path/to/dsh-workspace-sorter-0.1.0.tgz

在常用配置档中启用之前，先禁用现有的 dsh-workspace-sort 插件（条目 workspace-sort）：它会每天独立覆盖宿主的手动顺序，会破坏这里 Manual 的含义。本包不会静默禁用其他插件。如果被要求，重启 DSH 并刷新实际的 DSH GUI。打开 Workspaces → View options → Workspace order。

验证手动/最近使用切换、新会话活动、重载持久化、窄/折叠侧边栏、工作区树/平铺分组、归档过滤器、搜索、会话拖拽、Manual 中的工作区拖拽，以及卸载 + 刷新。卸载只留下浏览器偏好；无需恢复宿主顺序。