前言¶
在 DeepSeek Harness（DSH）里，侧栏往往堆着多个工作区和会话。名称相似时，靠文字辨认成本不低；工作区与会话又挤在同一列表里，层级关系也不一定一眼能分清。社区插件 dsh-workspace-icons（维护者 Theembers，SkillHub 分类「趣味换装」）面向侧栏：在现有「重命名工作区」流程里选图标、为未单独设置的工作区与会话指定默认图标，并可关联 Iconify 图标库或上传自定义 SVG。它不新增侧栏入口，图标颜色跟随宿主主题。
这是什么¶
dsh-workspace-icons 是 DSH 的 Cordis 插件，当前版本 0.1.0，MIT 许可证。客户端注入侧栏与工作区相关模块；宿主侧负责配置持久化、REST 与 Iconify 代理。安装后，设置面板出现「工作区图标」导航项；「重命名工作区」弹窗内出现图标选择区。
核心功能¶
工作区图标¶
在「重命名工作区」弹窗中，于名称输入框下方选择图标，点「重命名」后名称与图标一并保存。只改图标时，插件会在名称未改动的情况下仍使「重命名」按钮可用。已设置的图标显示在工作区名称左侧。未单独设置的工作区可使用设置里的「默认工作区图标」。
会话默认图标¶
设置 → 会话图标，可为本地发起、非 IM 渠道的会话显示默认图标。已有 IM 渠道 logo/头像的会话（例如从微信、飞书发起的会话）保持渠道头像，插件主动让位。
层级样式¶
会话行相对工作区多缩进一级，并从工作区图标正下方垂一条竖直引导线，形成「工作区 → 会话」两级结构。该效果通过 DOM 装饰实现，依赖宿主侧栏当前 DOM 结构。
图标来源¶
- 73 个内置 Lucide 图标。
- 自定义 SVG 上传（单文件 ≤64KB）。
- 关联任意 Iconify 图标库：设置内嵌官方目录（
api.iconify.design/collections，README 写明共 276 个图标库），支持按前缀、名称、作者搜索，一键关联；关联后在各图标选择器的「图标库」页签内按库搜索选用。
图标不提供单独配色，与宿主侧栏其他图标同色；选中行时图标不随文字一起变深。
安装与启用¶
插件以当前 DSH 进程的权限运行，安装前建议阅读仓库源码与 LICENSE。
# 从 GitHub 安装到某个 profile（把 <profile> 换成 desktop / web / …）
dsh plugin --profile <profile> add github:Theembers/dsh-workspace-icons
# 然后重启对应的 DSH 进程
仓库已包含构建好的 lib/client.js，安装时无需本地构建。
由 Electron 应用托管的 profile（例如 desktop）可能被 CLI 拒绝写入（提示 profile is managed exclusively by the Electron application）。此时应在应用的插件管理界面安装，或按 README 说明手动修改该 profile 的 package.json 与 node_modules 软链。
兼容性：package.json 要求 DSH >=0.2.2-rc.1 <0.3.0-0，并基于 __ModuleLoader__ 客户端插件与 sidebar.workspaces 等槽位。
典型用法¶
- 给工作区设置图标：右键工作区 → 重命名 → 在输入框下方选择图标 → 点「重命名」。
- 默认工作区图标：设置（快捷键 ⌘, / ⌘⌥,）→ 工作区图标 → 默认工作区图标。
- 默认会话图标：设置 → 会话图标（仅对无 IM 渠道的会话生效）。
- 图标库：设置 → 工作区图标 → 图标库。浏览或搜索后点「关联图标库」；已关联库以标签显示，点标签切换搜索范围，点 × 解除关联（解除关联会清除所有引用该库的工作区与默认图标，接口返回
cleaned计数）。 - 自定义图标：设置 → 自定义图标 → 上传 SVG。
配置文件路径：
~/.dsh/dsh-workspace-icons/config.json
README 中的结构示例包括 libraries、customIcons、workspaceIcons、defaults 与 settings（如 showDefaultWorkspaceIcon、showDefaultSessionIcon）。图标引用支持 builtin、iconify、custom 三种 type。Iconify 元数据与缓存目录为 ~/.dsh/dsh-workspace-icons/cache/（24 小时）。
适用场景与注意¶
适合希望在 DSH 侧栏用图标区分工作区、统一本地会话视觉、并从 Iconify 扩展图标的用户。不适合期待在侧栏新增独立菜单项的场景——插件刻意复用重命名弹窗与设置页。
上游侧栏 DOM 或 React 结构变化时，可能需要插件更新选择器（README 提及 overlay-workspaces.js、rename-icon.js 等）。SkillHub 目录页与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；当前 GitHub 星标为 0，不代表功能完备性，仅作生态索引参考。
结尾¶
dsh-workspace-icons 把图标选择放进既有工作区重命名与设置流程，并补上一层工作区与会话的层级视觉。目录与安装说明见 SkillHub 插件页，源码与完整配置说明见 GitHub 仓库。
