前言¶

在 DSH（DeepSeek Harness）中管理多個會話時，通過側邊欄標題的顏色即可快速判斷會話狀態是一種高效的方式。dsh-session-colorful-unread-pin-jobs 插件通過顏色漸變解決了這一需求，將“未讀運行中”、“未讀已完成”和“官方置頂”三種狀態直觀地呈現出來。

是什麼¶

這是一個由 enterhalf 維護的趣味換裝類插件。它不重複實現 DSH 官方已有的置頂與排序功能，而是通過讀取官方提供的置頂集合與未讀狀態，利用 DOM 觀察器爲會話標題添加行內樣式漸變。插件完全基於官方擴展點開發，不修改官方 bundle。

核心功能¶

1. 標題狀態染色
   會話標題會根據狀態顯示不同顏色的漸變：
   • 未讀 · 運行中：品牌藍漸變（讀取會話列表 store 的 running 標誌）。
   • 未讀 · 已完成：綠色漸變（會話回到空閒狀態）。
   • 置頂：黃色漸變（讀取官方置頂集合）。
   • 混合狀態：合成漸變，置頂色恆在最左，未讀色在最右。
2. 官方置頂集成
   插件只讀取官方的置頂集合，不寫入置頂數據。置頂功能完全依賴 DSH 官方菜單（“置頂會話”），卸載後不影響原有置頂狀態。
3. 未讀管理
   在設置中新增“會話未讀”分節。這裏列出全部未讀會話，支持逐條標記爲已讀，並提供“發送即清”開關（默認關閉）。
4. 零 bundle 改寫
   菜單條目通過官方插槽註冊，染色邏輯僅依賴 data-row-key 和標題 class 後綴 _title，不涉及對官方 client.js 的修改。

安裝與啓用¶

確保你的 DSH 版本 >= 0.1.7-alpha.2。安裝命令如下：

dsh plugin --profile web add dsh-session-colorful-unread-pin-jobs@latest

典型用法¶

安裝後，側邊欄會話標題會自動着色。你可以在會話行點擊“…”菜單，使用官方提供的“標記爲未讀/已讀”功能，或在設置頁面的“會話未讀”區域批量管理。

適用場景與注意¶

• 版本要求：必須使用 DSH >= 0.1.7-alpha.2，舊版沒有官方插槽與 data-row-key，UI 平面不會生效。
• 摺疊分組：摺疊的工作區分組內的會話行不會渲染，展開分組時觀察器會立即補畫顏色。
• 多標籤頁：當前打開的會話判定以列表 store 中 retainedBy.mainView 的持有者爲準，多標籤頁各自獨立。
• 主題適配：顏色依賴主題系統的品牌色變量，第三方主題若未通過該機制改色，染色可能不會跟隨。
• 未讀判定：自動未讀僅統計模型白名單事件（如 assistant/chunk），llm/retry 等不產生內容的異常事件不計。

短結尾¶

該插件通過顏色編碼大幅提升了側邊欄會話管理的視覺效率，且對官方行爲零侵入。更多細節與源碼可訪問 GitHub 倉庫。