工作区最近排序 easychen/dsh-workspace-recent-sort

dsh-workspace-recent-sort

npm：<https://www.npmjs.com/package/dsh-workspace-recent-sort> 仓库：<https://github.com/easychen/dsh-workspace-recent-sort>

DeepSeek Harness 侧边栏插件，包含三个相关行为：

1. 工作区分组跟随「最近更新」 —— 有更新会话的工作区会升到侧边栏顶部。
2. 工作区会话紧凑显示 —— 展开的工作区只显示最新一条会话；鼠标悬停时带动画显示接下来几条。
3. 重排后滚回原位 —— 自动排序移动分组时，侧边栏会把当前选中的会话滚回视野内。

排序和紧凑显示这两个行为，在 设置 → 工作区 / Workspaces 里各有开关。

要解决的问题

DSH 原生的 排序方式 → 最近更新 只对每个工作区内部的会话排序。工作区分组本身始终按宿主持久化的 workspaceIds 顺序渲染（也就是拖动文件夹产生的顺序）。所以一个刚有新会话的工作区，还是待在手动摆放的位置。

本插件不改动这个持久化顺序。它只改变浏览器的投影结果，而且只在下面两项同时选中时生效：

- 分组方式 = 工作区（按工作区）
- 排序方式 = 最近更新（最近更新）

行为

最近更新排序

- 工作区分组按各自真实会话中最新的 updatedAt 排序，最新的在前。已归档会话仍然计入；可见的归档行就是真实会话。
- 临时的空白会话（「新建会话」占位）和隐藏的子代理子项不算会话活动。
- 没有已加载会话的工作区排到底部。并列时保持宿主的相对顺序，所以结果是确定的。
- 切换到 手动排序、工作区树（按工作区树）或平铺列表，会立即恢复原生顺序。
- 不写入任何宿主状态：持久化的工作区顺序不变，不移动任何会话，也不发网络请求。最近更新 生效期间，工作区拖拽提交会被抑制，因为持久化重排在最近更新投影下看不见；要整理文件夹请切到 手动排序。
- 插件只包装侧边栏注册的 WorkspaceBrowser。工作区选择器、搜索结果、会话行、归档筛选、固定项和会话拖拽行为都保持原生。

紧凑会话

- 在 分组方式 → 工作区 下，展开的工作区默认只显示最新一条会话行，外加任何必须保持可操作的行。
- 悬停在 Workspace 标题栏或它可见的行上，接下来三个会话会动画展开（最新会话再加三个；有临时 New Session 行时，该行保持可见）。移开鼠标后重新收起。
- 当前选中的会话始终可见，即使它不是最新的那个。
- 正在运行回合、有运行中的子代理子项，或有待处理交互（审批 / 计划评审 / 提问）的行，永远不会被紧凑模式隐藏，即使同时有多个这样的行在运行。
- 展开其余 xx 个会话 / Show remaining … conversations 按钮在 Workspace 被悬停或键盘聚焦之前保持隐藏。
- Workspace 内的键盘焦点会展开它所有已渲染的行。点击 展开其余 xx 个会话 / Show remaining … conversations 会为该 Workspace 提升原生水位线；一旦渲染超过六行，悬停就会显示全部。
- 收起的 Workspace、Workspace Tree 模式和扁平列表保持原生行为。

滚动到选中的会话

任何 Workspace 重排改变分组顺序之后——自动的最近排序、切换排序模式，或手动拖动 workspace——插件会滚动侧边栏，让当前选中的会话可见。如果该行已经可见，block: "nearest" 不会改动滚动位置。

设置

Settings → 工作区 / Workspaces 提供两个开关：

| 开关 | 默认 | 作用 |
| 按最近更新排序工作区 | 开 | 启用最近排序投影。 |
| 工作区对话简约显示 | 开 | 启用单行紧凑显示和悬停展开。 |

设置保存在浏览器本地（localStorage 中的 dsh.workspace-recent-sort.settings.v1），所以不同浏览器可以用不同偏好。开关立即生效，无需刷新。

安装

从 npm 把已发布的 bundle 安装到 Web 配置档：

dsh plugin --profile web add dsh-workspace-recent-sort

或直接从 GitHub 安装：

dsh plugin --profile web add https://github.com/easychen/dsh-workspace-recent-sort.git

包声明了 dsh.bundle.patch，所以会作为活动配置档 bundle 安装。如有提示，重启 dsh web 并刷新 Web 页面。

本地开发时，改为链接检出目录：

cd ~/.dsh/profiles/web
pnpm add link:/absolute/path/to/dsh-workspace-recent-sort

然后确认配置档的 package.json 中 dsh.profile.bundles 包含 dsh-workspace-recent-sort。

卸载：

dsh plugin --profile web remove dsh-workspace-recent-sort

Plugins 页面 / bundle 安装器提供相同的安装和卸载操作。

兼容性

基于 DSH 0.2.1-rc.2 构建。原生 View-options 菜单没有用于分组排序的公开扩展槽，所以插件使用侧边栏注册自带的组件接缝：它把 entry.component 替换为一个包装组件，保留条目的 store、注入的服务、locale 和子槽授权。紧凑模式用 CSS 实现，作用域挂在 data 属性下，选择的是结构性的 data-row-key 属性，而不是哈希后的类名。如果识别不出侧边栏的结构，插件会保持原生组件不动，而不是让应用启动失败。

开发

node --test test/sort.test.mjs
npm pack --dry-run

浏览器端的打包产物是手写的，直接对接 DSH 模块加载器，所以不需要构建步骤。

维护者：npm 发布检查清单见 PUBLISHING.md。