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