前言¶
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 生態理念是「一切皆插件」，安裝第三方包前請自行審計代碼。
