前言¶
在 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 倉庫。
