前言¶
DeepSeek Harness (DSH) 采用插件化架构，但在原生侧边栏管理中存在局限：工作区查找不便、归档操作不可逆、缺乏视觉定制。dsh-workspace-kit 是一个 Cordis Bundle 插件，由 ice5kysl 维护，旨在解决工作区管理痛点。它提供 ⌘K 快捷搜索、软归档机制、以及可拖拽排序和自定义样式的增强侧边栏。
核心功能¶
Spotlight 搜索与导航¶
插件将 Spotlight 调色板注册到 shell.overlay 插槽。按下 ⌘K 或 Ctrl+K 后，可以模糊搜索所有工作区和会话（包括未分组和已归档项）。
* 搜索归档项：输入时会匹配归档项目，结果带有 “Archived” 标识，支持恢复。
* 快捷操作：使用 ↑↓ 键导航，按 Enter 直接打开或跳转。
软归档机制¶
原生 DSH 的归档是系统级且不可逆的。该插件实现了「视图层」的软归档：
* 归档状态：归档的工作区从主列表中移除，移动到可折叠的 “Archived (N)” 区域。
* 恢复与删除：归档状态持久化存储（localStorage）。用户可以通过侧边栏行或 Spotlight 结果执行恢复或彻底删除操作。
* 数据安全：归档仅改变视图状态，不删除实际数据。
增强侧边栏¶
插件以低优先级（-1）注册到 sidebar.workspaces 插槽，替换原生侧边栏浏览器。
* 拖拽排序：支持拖拽工作区行以重新排序，或拖拽会话调整顺序。
* 侧边栏搜索：提供可展开的搜索框，支持按标题、路径过滤，以及基于内容的全文搜索（需 ≥2 字符）。
* 视觉定制：每行悬停时显示操作按钮。点击图标或颜色按钮，可在 32 个 SVG 图标和 9 种颜色中选择，用于区分工作区。
* 快速操作：悬停显示「新建会话」（针对活跃行）和「恢复」（针对归档行）。
* 一键切换：侧边栏底部提供按钮，可在「增强侧边栏」和「官方侧边栏」之间快速切换。
安装与启用¶
在已运行 DSH Web 的环境下，使用以下命令安装：
dsh plugin --profile web add dsh-workspace-kit
安装后，增强侧边栏和 Spotlight 搜索会自动生效。
典型用法¶
查找工作区¶
在会话中输入以下命令，或在 Spotlight 中输入：
* workspace_find pms
* /workspace-find pms
管理侧边栏¶
- 排序：拖拽工作区行，会话将切换到「手动」排序语义。
- 样式：悬停工作区行，点击图标或调色板图标进行自定义。
- 归档：点击行上的「···」菜单，选择归档或恢复。
技术细节与限制¶
架构设计¶
插件采用 Bundle 形式，包含两个「面」：
* Host (Node)：位于 lib/index.js。提供 workspace_find / workspace_list 模型工具，以及 /workspace-find / /workspace-list 斜杠命令（仅查询，写入操作在 GUI）。
* Browser (Client)：位于 lib/client.js。实现 Spotlight 调色板、软归档状态存储（localStorage）以及增强侧边栏。
本地化¶
- 浏览器端：优先读取
localStorage中的dsh.workspace-kit.locale，否则根据navigator.language推断（zh*为中文，否则为英文）。 - 主机端：优先读取环境变量
WSKIT_LOCALE，否则读取LC_ALL/LANG。
版本与限制¶
- 目标版本：
@deepseek-ai/dsh≥ 0.1.1-rc.2。 - 能力边界：v1 版本替换浏览器的能力边界在
known-limitations.md中有详细文档。
生态背景¶
DSH 强调「一切皆插件」。dsh-workspace-kit 发布在 npm，遵循 MIT 许可证。安装前请检查源码与许可证，确保符合项目规范。
