前言¶
在管理多個工作區時，工作區列表往往是一排排相似的標題。任務完成後，剛纔所在的 Session 很難再次找到——狀態點顯示爲空閒，而標題混雜其中。通過給 Session 添加自定義顏色，是讓列表中的某一行快速被識別的最直接方式。
插件定位¶
idoall/dsh-session-colors 是 DeepSeek Harness 的一個社區插件，遵循 MIT 許可證。它不修改 DSH 核心代碼，也不重寫任何 Session 或 Workspace 數據，僅維護一個簡單的映射關係：“Session ID → 一種顏色”。
核心能力¶
該插件在 Session 列表的側邊欄行中顯示顏色標記。以下是它的主要特性：
- 側邊欄標記：顏色條位於行首左側，刻意避開狀態點，確保“哪個任務已完成”的信息不會被遮擋。
- 系統級取色器：內置完整的顏色選擇器，支持飽和度/亮度場、色相和透明度滑塊、HEX 和 RGBA 輸入、以及瀏覽器支持的屏幕取色功能。
- 多端同步：顏色標記存儲在 Host 端，而非瀏覽器端。因此，在一臺設備上選擇的顏色會自動同步到其他設備（包括通過 LAN 或隧道訪問的設備）。
- 移動端適配：在手機端，側邊欄會變爲抽屜，顏色標記會跟隨抽屜一起顯示。
- 自動更新：頁面在重新可見時以及每 20 秒會重新讀取顏色標記，無需手動刷新。
- 非阻塞設計：顏色層是可點擊穿透的，且被限制在側邊欄滾動容器內，不會阻塞界面操作。如果無法連接存儲，控制區會顯示警告圖標和原因。
安裝與配置¶
安裝前請確保環境滿足要求：使用帶有 Web profile 的 DeepSeek Harness，以及 Node.js 20 或更高版本。
執行以下命令安裝插件：
dsh plugin --profile <profile> add @idoall/dsh-session-colors@latest
如果需要在配置中持久化存儲（重啓後不丟失），需要在 profile 的 cordis.patch.yml 中指定 dataDir。若未指定 dataDir，標記僅在 Host 進程存活期間有效。
安裝完成後，必須重啓 dsh web（因爲 Host 端僅在啓動時加載），隨後刷新 Web 界面即可生效。
使用步驟¶
- 打開需要標記的 Session。
- 點擊 Session 頭部工具欄中的顏色控制按鈕（未標記時顯示調色盤圖標，已標記時顯示當前顏色）。
- 在彈出的取色器中選擇顏色，或直接粘貼 HEX 值。顏色條會立即出現在該 Session 的側邊欄行中。
- 如需清除標記，再次打開取色器，點擊“Clear mark”按鈕，或選擇透明色塊。
注意事項¶
- 插件以當前 dsh 進程的權限運行，請確保信任插件來源。
- 由於標記存儲在 Host 端，修改顏色後通常無需刷新頁面即可看到變化（若未生效，可等待 20 秒或切換頁面再切回）。
相關鏈接¶
- GitHub: https://github.com/idoall/dsh-session-colors
- 插件目錄: https://www.skillhub.cn/plugins/idoall/dsh-session-colors
