前言¶
在 DeepSeek Harness（DSH）裏同時開多個工作區會話時，默認側邊欄往往只顯示標題或簡單列表，很難一眼區分項目、哪些在跑任務、哪些該收起來。社區插件 dsh-sidebar-shelves 把每個會話收成兩行卡片，並補上工作區圖標、置頂、歸檔、狀態與任務計數，以及按最近輸入排序。下面介紹它做什麼、怎麼裝、用的時候要注意什麼。
這是什麼¶
dsh-sidebar-shelves 是面向 DSH Web 客戶端的插件，維護者爲 YL404（package.json 中作者爲 Han）。它替換並增強側邊欄裏的工作區/會話列表展示：每個會話一張兩行卡片，並在對話標題前顯示當前工作區圖標。插件聲明依賴 DeepSeek Harness >=0.2.1-rc.5 <0.3.0，客戶端目標平臺爲 web（見 engines.dsh 與 dsh.client.platform）。
核心功能¶
以下能力均來自項目 README 與 package.json 說明。
項目圖標（Project tiles）¶
每個 Workspace 對應一塊圖標：默認按名稱生成字母塊與配色；也可自選 emoji、顏色或方形圖片，並支持 Icon Composer 的 .icon 包。圖標文件通過 Host 的 workspace-files 遠程從當前工作區讀取，插件本身不發起網絡請求。
置頂與歸檔¶
置頂會話排在列表最前，置頂與歸檔相互獨立。可手動歸檔，或在設置裏選擇 3、7、14、30 天后自動歸檔；已歸檔會話進入底部「已歸檔」區域。
右鍵菜單與快捷鍵¶
在會話卡片上右鍵可：置頂、重命名、分叉、複製 Session ID、歸檔。鍵盤可用 Shift+F10 打開同一菜單。
狀態與活動計數¶
卡片上顯示運行中、等待中等狀態標記；若會話帶有終端，會顯示終端標記。每個會話還會展示運行中的後臺任務與子代理數量，數據由 Host 端從該會話的任務記錄摺疊彙總（Session projection），而非插件自行統計。
排序與界面一致性¶
列表按「最近輸入」排序，最新輸入的會話靠前。Composer 裏工作區菜單複用同一套圖標與同一順序。當前打開的會話，其工作區圖標會出現在對話標題緊前方（佔用 conversation.header.leading 等擴展位）。
狀態存放位置¶
| 狀態 | 位置 |
|---|---|
| 設置（圖標樣式、自動歸檔天數） | 瀏覽器 localStorage dsh:sidebar-shelves:settings |
| 置頂 | dsh:sidebar-shelves:pinned |
| 圖標選擇 | dsh:sidebar-shelves:icons |
| 任務計數 | Host 端 Session 投影，由 job 事件重建 |
插件不上報遙測；安裝前若關心權限與隱私，可對照上述存儲方式與「僅讀工作區文件、不聯網」的說明審閱源碼（MIT 許可證）。
安裝與啓用¶
CLI 安裝（資料原文命令，需使用 desktop profile）：
dsh plugin --profile desktop add dsh-sidebar-shelves
圖形界面：插件 → 安裝，輸入 dsh-sidebar-shelves 並確認。若安裝後列表中沒有該插件行，重啓應用後再看。
卸載：
dsh plugin --profile desktop remove dsh-sidebar-shelves
或在 Plugins 界面移除對應 bundle。
典型用法¶
安裝並重啓（如需要）後，側邊欄會以兩行卡片展示各會話。常見操作可按下面順序熟悉：
- 瀏覽列表：置頂項在最前，其餘按最近輸入排序；底部查看「已歸檔」。
- 右鍵某張卡片（或 Shift+F10）進行置頂、重命名、分叉、複製 Session ID 或歸檔。
- 在插件設置中調整圖標樣式（字母塊 / emoji / 顏色 / 圖片或
.icon）以及自動歸檔天數（3 / 7 / 14 / 30 天）。 - 打開某個會話後，在對話標題前確認工作區圖標是否與側邊欄一致；在輸入框的工作區菜單中，圖標與順序應與側邊欄一致。
無單獨「示例倉庫」或腳本；行爲以 Harness 桌面/Web 客戶端中的側邊欄與對話頭爲準。
適用場景與注意¶
適合誰： 經常在 DSH 裏切換多個工作區、需要一眼區分項目、管理長期會話列表、或關心後臺 job/subagent 數量的開發者。
兼容性： 插件註冊 sidebar.workspaces、conversation.hero.workspace、conversation.header.leading 三個擴展位。若有其他插件以更高優先級佔用同槽位，後者會覆蓋本插件；此時應卸載 dsh-sidebar-shelves 或調整插件優先級，避免界面行爲不一致。
安全與信任： 插件以當前 DSH 進程權限運行；它不聯網、不上報，但會讀寫瀏覽器 localStorage，並通過 Host 讀取工作區內的圖標文件。安裝前建議查看 GitHub 倉庫 源碼與 MIT 許可證，再決定是否啓用。
結尾¶
dsh-sidebar-shelves 把 DSH 側邊欄收成帶圖標、置頂、歸檔與任務信息的會話卡片，並與 Composer 工作區菜單、對話標題區對齊展示。社區目錄頁（與 DeepSeek / 幻方無官方從屬關係）見 SkillHub 插件頁；源碼與完整說明見 GitHub：YL404/dsh-sidebar-shelves。
