前言¶
DeepSeek Harness（DSH）采用插件化架构扩展功能。在 Web 界面中管理多个工作区时，主侧边栏的会话列表容易变得杂乱。dsh-workspace-dock 插件在侧边栏左侧渲染一个 Dock 栏，以可视化和过滤工作区。它由 qschen86 维护，挂载在官方 sidebar.rail 槽位，通过服务注入实现，不修改任何内置文件。
核心功能¶
- 会话过滤：点击 Dock 栏中的图标，主侧边栏会过滤显示该工作区下的会话列表。
- 工作区菜单：再次点击已选中的图标（或右键点击），会打开菜单。菜单包含文件夹路径、复制路径、重命名、修改图标和归档选项。
- 状态徽章：
- 窄栏模式：显示数字徽章（运行中会话）或圆点徽章（待关注会话）。
- 展开模式：显示状态胶囊。
- 徽章统计基于会话归属（host canonical-cwd 索引），与侧边栏列表完全一致。
- 尺寸调整：可收起为窄栏（52px）或展开为宽栏（200px，显示名称）。双击 rail 空白处也可切换展开/收起状态。
- 自定义配置：支持为每个工作区自定义图标颜色与字形。图标设置持久化于浏览器本地。
- 首页入口：顶部 logo 提供首页入口与菜单。菜单包含 dsh 安装目录、复制路径和打开文件夹功能。
安装与启用¶
使用官方 CLI 安装插件：
dsh plugin --profile web add dsh-workspace-dock
安装后，运行以下命令验证配置：
dsh --profile web --dump-config
安装完成后需重启 dsh web（使主机配置生效）并刷新页面（使客户端配置生效）。
使用说明¶
- 切换状态：双击 rail 空白处，可在窄栏和宽栏之间切换。
- 打开菜单：右键点击图标，或再次点击已选中的图标，打开工作区菜单。
- 修改设置：在菜单中选择“修改图标”或“重命名”，可自定义工作区的视觉呈现和名称。修改会同步至主侧边栏等界面。
注意事项与兼容性¶
- 版本要求：已验证兼容 dsh 0.1.0-rc.6。
- 实现机制：纯槽位（slot）+ 服务注入实现，无任何内置文件改动。
- 数据存储：图标设置存储在浏览器本地。
结语¶
该插件通过在侧边栏左侧提供可视化的工作区 Dock 栏，增强了 DSH Web 界面管理会话的能力。它无需修改核心文件，且支持高度自定义。
