前言¶
在 DeepSeek Harness(DSH)里,侧栏按 Workspace 名称把会话分组。同时开着多个项目时,列表往往看起来像一整块同样样式的块,要靠文字逐个辨认。社区插件 dsh-workspace-colors(维护者 Pourii83)在宿主之上加一层可逆能力:设置页、按 Workspace 存颜色、以及由插件自带的样式表给对应行上色,无需改 DSH 本体或 fork。
这是什么¶
dsh-workspace-colors 是持久化的 DSH 客户端插件(版本 1.0.0,MIT 许可证),为侧栏中每个 Workspace 指定自定义颜色,便于一眼区分项目。功能主要在浏览器端完成;Host 半部分(index.js)为空,不依赖 Host 状态。在 SkillHub 社区目录中归类为「趣味换装」。
核心功能¶
下面这些是 README 中已说明的能力:
- 每个 Workspace 一种颜色:仅 Workspace 标题行着色——行背景浅色、行首强调条、文件夹图标着色;其下会话行不受影响。
- 内置调色板:预设色加自定义
#rrggbb输入,不唤起操作系统颜色对话框。 - 设置页:路径为 Settings → Workspace colors,列出全部 Workspace 及当前颜色,支持单行 Reset 与 Reset all colors。
- 明暗主题:页面与行样式只使用宿主主题令牌(
--dsw-alias-*),随浅色/深色切换。 - 浏览器本地存储:颜色映射保存在本机
localStorage键dsh.workspace-colors.v1,与侧栏「每浏览器视图顺序」类似,跨页面重载与同 Web GUI 源的 Harness 重启仍保留;换源则从无颜色开始。 - 性能取向:选色经防抖写入、按帧合并渲染,通过 CSSOM 就地改规则而非整段替换样式表;禁用 bundle 时会移除样式表、设置页与导航图标。
着色依赖侧栏行上的稳定属性 data-row-key="workspace:<workspaceId>" 以及 dsh-client-ui-workspace 渲染的 folder/title 类名后缀。若未来 DSH 改动这些约定,设置页与已存颜色仍可用,但行可能不再着色,不会导致宿主崩溃。
安装与启用¶
插件以 bundle 形式安装。资料中的两种方式如下。
- 将仓库 checkout 到本地目录后,用插件管理器安装 bundle(
target指向该目录下的dsh-workspace-colors):
plugin_manager install_bundle (target: <path>/dsh-workspace-colors)
- 或在 Harness UI:Settings → Plugins,将目录作为 bundle 安装。
安装完成后,设置入口出现在 Settings → Workspace colors。卸载可使用 plugin_manager remove_bundle,会一并移除样式表、设置页与图标。
安装前建议自行阅读 GitHub 仓库 源码与 MIT 许可证;插件随当前 DSH 进程与 Web 客户端权限运行,只应安装你信任的来源。
典型用法¶
- 完成 bundle 安装后,打开 Settings → Workspace colors。
- 在列表中为每个 Workspace 从预设调色板选色,或在
#rrggbb字段输入自定义十六进制色。 - 保存后,侧栏对应 Workspace 标题行会显示背景 tint、行首色条与彩色文件夹图标。
- 需要恢复默认时,对单行点 Reset,或一次性 Reset all colors。
颜色只存在于当前浏览器、localStorage 中;换机器或清站点数据需重新配置。
适用场景与注意¶
适合谁:长期在同一个 DSH 实例里并行多个 Workspace(多仓库、多实验目录)的开发者,希望用颜色做视觉分组而不是只靠名称。
实现要点(便于排查):客户端逻辑在 client.js——从侧栏 slot 的 useWorkspaces 读取列表,向 settings.section 与 settings.section.icon 注入设置页与图标,并用自有样式表为 [data-row-key="workspace:<workspaceId>"] 行写规则。存储键为 dsh.workspace-colors.v1。
生态说明:DSH 采用「一切皆插件」思路;SkillHub 插件目录 为社区站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-workspace-colors 用本地颜色映射给侧栏 Workspace 行做轻量标识,不改 Host、不碰会话内容。需要进一步了解或提交 issue,可看目录页与源码仓库:
- 目录页:https://www.skillhub.cn/plugins/Pourii83/dsh-workspace-colors
- GitHub:https://github.com/Pourii83/dsh-workspace-colors