前言¶
DeepSeek Harness (DSH) 的侧边栏处理会话和工作区两层结构的方式不同。会话在组内默认按 updated 排序，有新活动时会自动置顶。但工作区本身的顺序来自 workspaceIds 数组，即手动拖拽的顺序，不会响应实际工作内容。如果你希望“当前正在操作的项目浮到顶部”，只有工作区这一层是缺失的，dsh-workspace-promote 正是为了填补这一空白。
这是什么¶
dsh-workspace-promote 是一个 DSH host 插件，由 bobobo2026 维护。它的核心功能是：在你提交任务时，将对应的工作区置顶于侧边栏；一旦任务开始执行，侧边栏保持不动，直到下一次提交。
核心功能¶
- 提交任务时将工作区置顶。
- 任务执行期间不重排。
- 仅响应人类提交的 prompt (user/message 事件)，忽略插件事件和工具结果。
- 无状态文件，持久化修改
workspaceIds。 - 操作仅影响工作区顺序，不影响子会话或未分组会话。
安装与启用¶
安装命令如下：
dsh plugin --profile web add dsh-workspace-promote
安装完成后，需要重启 dsh web（host-plane 插件在启动时挂载）。
典型用法¶
- 提交任务后观察侧边栏，确认工作区是否已置顶。
- 查看
~/.dsh/workspace-promote.log验证触发情况。 - 重启 dsh web 以挂载插件。
审核日志¶
插件会将行为记录到 ~/.dsh/workspace-promote.log（遵循 DSH_HOME 路径）。这是一份追加日志，用于确认触发时机：
2026-09-15T09:31:44.809Z boot pid=49220 trigger=human-prompt-only
2026-09-15T09:33:11.770Z promote workspace=039cce9b-... session=session-1ee5c45f-... from=a6680e0c-...
适用场景与注意¶
- 适用场景：需要快速切换当前工作区的开发者。
- 注意：
- 与手动拖拽冲突：如果你手动将工作区 B 拖到顶部，然后提交任务 A，A 会再次置顶。
- 不影响子会话或未分组会话。
- MIT 许可证。
与其他插件的差异¶
它与 dsh-workspace-sort 的区别在于触发时机与状态管理：
- dsh-workspace-sort：按日排序后冻结，适合全天固定顺序。
- 本插件：在“用户提交动作”时触发并即时置顶，无状态文件，适合需要当前项目常驻顶部的场景。
短结尾¶
如果你需要当前正在操作的项目在侧边栏常驻顶部，可使用该插件。
