前言¶
DeepSeek Harness（DSH）侧栏里往往同时挂着多个工作区。名称相近或项目一多，扫一眼很难区分「当前这条对应哪棵目录树」。改会话置顶、排序或模型配置并不能解决「视觉分组」问题；若只在本地记笔记，又和界面脱节。
下面介绍社区插件 dsh-workspace-colors（维护者 FranzLi347）：在 DSH v0.1.7-alpha.1 上，为每个工作区选一种预设颜色，显示在侧栏工作区行左侧色条和文件夹图标上。偏好保存在当前浏览器来源的 localStorage，不改动会话状态、置顶、排序、文件或模型请求。SkillHub 分类为「趣味换装」；仓库星标为 0（以目录页与 GitHub 为准）。
这是什么¶
dsh-workspace-colors 是给 DSH Web 客户端用的增量插件：通过公开插槽 sidebar.footer.action 注册「工作区颜色」入口，在设置旁打开面板，为当前工作区选择红、橙、绿、蓝、紫、粉或恢复默认。界面支持中文与英文。发行版本 0.1.0，许可证 MIT。
插件不替代 DSH 自带的工作区管理，只增加可识别的颜色标签，便于在「按工作区 / 工作区树分组」视图里快速定位。
核心功能¶
- 六种预设色 + 默认：只接受插件内置的六种颜色，不把存储内容当作任意 CSS，工作区 ID 在构造 CSS 选择器时会逐字符转义。
- 侧栏视觉：颜色体现在工作区行左侧色条与文件夹图标，适配深色 / 浅色主题。
- 浏览器本地持久化：按
workspaceId写入当前来源的localStorage，键名为dsh.workspace-colors.v1；刷新页面、工作区重命名后仍保留。 - 范围明确：不跨浏览器、设备或端口同步；无痕模式或存储被禁用时，当前页仍可设置，但浏览器可能不保存。
- 显示条件：在「按工作区」与「按工作区树分组」时有着色目标；单列表模式没有工作区行，因此不会出现色条。
- 实现说明：v0.1.7-alpha.1 没有工作区行颜色的官方扩展点，插件依赖该版本 DOM（如
data-row-key="workspace:<id>"与首个图标容器）。升级 DSH 后需重新验证兼容性。卸载插件会移除注入样式；已保存颜色保留，重装后可恢复。
安装与启用¶
插件以 tgz 发行包 安装到运行 DSH 的主机，需先把包下载到本机并替换为实际绝对路径。插件在 当前 DSH 进程权限 下加载；安装前应自行查看 GitHub 源码 与 MIT 许可证，确认可接受再安装。
Web 版 profile 为 web 时：
dsh plugin --profile web add /absolute/path/dsh-workspace-colors-0.1.0.tgz
若使用 npx 启动指定版本的 DSH：
npx @deepseek-ai/dsh@0.1.7-alpha.1 plugin --profile web add /absolute/path/dsh-workspace-colors-0.1.0.tgz
刷新 DSH 页面后，点击侧栏底部的「工作区颜色」按钮。若禁用了 HMR，需先重新启动 DSH。自定义 profile 用其名称替换命令中的 web。Electron 桌面版保留 desktop profile，由桌面应用管理插件，请在应用内插件安装界面填写包的绝对路径，不要用 CLI 修改 desktop。
典型用法¶
- 安装并刷新页面，确认侧栏底部出现工作区颜色入口（与设置相邻）。
- 选中要标记的工作区，打开面板，选择一种颜色或「默认」。
- 在分组视图下查看左侧色条与文件夹图标是否已更新。
- 需要完全清除偏好时，在浏览器开发者工具中删除
localStorage键dsh.workspace-colors.v1（仅影响当前来源）。
卸载命令：
dsh plugin --profile web remove dsh-workspace-colors
重新加载页面即可恢复未着色外观；localStorage 中的颜色数据仍保留，除非手动删除上述键。
适用场景与注意¶
适合：本地长期开多个 DSH 工作区、希望用颜色做轻量分组、且接受「仅当前浏览器、当前端口」保存设定的开发者。
注意：
- 目标 DSH 版本为 v0.1.7-alpha.1；其他版本未在 README 中声明兼容。
- 颜色不同步到云端或其他设备，换浏览器或清站点数据会丢失映射（工作区本身不受影响）。
- 社区目录 SkillHub 插件页 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，安装第三方包前请自行审计代码。
