前言¶
DeepSeek Harness（DSH）在側邊欄裏自帶工作區與會話瀏覽：搜索、拖拽排序、上下文菜單都在同一套界面裏。當你同時在多個工作區之間切換、又只想盯住某一個工作區裏的會話時，默認側邊欄會把所有工作區平鋪展示，注意力容易被分散。社區插件 dsh-sidebar-home（維護者 fu-silent，分類：客戶端）在側邊欄面板行增加 Home 入口：先選工作區，再進入 Focus mode，側邊欄只展示當前工作區的會話，其餘工作區摺疊到底部；退出聚焦後，DSH 自帶的側邊欄工作區瀏覽器會原樣恢復，不做持久改寫。
這是什麼¶
dsh-sidebar-home 是面向 DeepSeek Harness 的社區客戶端插件（bundle 名 dsh-sidebar-home，當前版本 0.1.0，MIT 許可證）。它通過 DSH 的 Client 擴展點掛載：Host 側 index.js 爲空，瀏覽器側僅一個零依賴的 client.js，無構建步驟、無 npm 發行包、運行時無網絡請求與遙測。
一句話定位：從側邊欄 Home 挑選工作區，聚焦該工作區的聊天列表，退出後回到 DSH 出廠側邊欄行爲。
目錄頁：SkillHub — fu-silent/dsh-sidebar-home
源碼與說明：GitHub — fu-silent/dsh-sidebar-home
核心功能¶
下面介紹 README 中已列出的能力（未在資料中出現的不寫入正文）。
Home 入口與佈局¶
- 側邊欄面板行出現房屋圖標，打開 Home 頁：列出各工作區名稱、路徑、活躍/歸檔會話數、最近活動時間。
- 處於聚焦時，Home 頁顯示聚焦橫幅並提供退出操作。
- 兩種 Home 佈局：卡片網格 或 緊湊列表，選擇會在會話之間記住。
- Add workspace：通過宿主目錄選擇器選文件夾，插件註冊並進入該工作區。
Focus mode（聚焦模式）¶
聚焦某一工作區後，側邊欄只展示該工作區：
- 按會話標題搜索，並顯示匹配數量。
- Needs-attention 標記：Running、Waiting approval、Plan review、Waiting answer，以及未讀完成的 Completed。
- 置頂會話優先，帶 pin 標記；當前會話始終可見並滾動到視區內；其餘通過 show more 展開（默認展示最新 8 條等規則見 README「Limits」）。
- 歸檔會話開關；歸檔項在聚焦列表中可見，但須先在出廠瀏覽器中取消歸檔才能打開。
- + New session 在聚焦工作區新建聊天。
- 頁頭 Focus 藥丸與 Exit focus 按鈕。
其他工作區摺疊¶
側邊欄底部 Other workspaces (N) 可摺疊：可按工作區展開會話、直接進入某工作區、或通過 View all workspaces 回到 Home 全貌。
窄側邊欄與可逆性¶
側邊欄收窄時，窄軌上保留單個 Home 按鈕以重新展開側邊欄。退出聚焦會 dispose 替換用的 slot 註冊，出廠工作區瀏覽器（搜索、拖拽、菜單、視圖選項）不受影響。
語言與狀態¶
界面與元數據支持英文與簡體中文。插件狀態保存在瀏覽器 localStorage 鍵 dsh-sidebar-home:state:v1（聚焦、Home 佈局、歸檔開關、摺疊狀態等）。
安裝與啓用¶
發行物僅來自 GitHub，無 npm 包、無預構建產物；需要已可用的 DSH 安裝。README 註明在 DSH Desktop 0.2.1-rc.5（macOS） 上測試通過。package.json 聲明：
"engines": { "dsh": ">=0.2.1-rc.5 <0.3.0-0" }
不匹配的主機會拒絕安裝/激活；Windows 與 Linux 未在資料中驗證。
DSH Desktop（推薦）¶
- 打開 DeepSeek Harness Desktop，進入 Plugins 頁。
- 選擇 Add plugin，填寫 checkout 的絕對路徑，或 git 地址
github:fu-silent/dsh-sidebar-home。 - 安裝並選 Enable now，然後重載頁面（
Cmd+R/Ctrl+R）。側邊欄面板行應出現 Home 圖標。
若重載後仍無圖標，完全退出並重新打開應用一次，以便 DSH 加載新的 client 模塊。
獲取源碼時，README 給出的方式是：
git clone https://github.com/fu-silent/dsh-sidebar-home.git
再將上述目錄路徑用於 Desktop 的 Add plugin。
本地 dsh web（可選 CLI）¶
desktop profile 由 Desktop 應用保留，請用 Plugins 頁管理，不要用 CLI 改 desktop。
對本地 dsh web profile：
dsh plugin --profile web add /absolute/path/to/dsh-sidebar-home
然後重啓 dsh web 並重載頁面。路徑需指向插件目錄的絕對路徑。
通過 Agent 安裝¶
具備 DSH 插件管理權限的 Agent 可對 plugin_manager 調用 action: "install_bundle"，target 爲 /absolute/path/to/dsh-sidebar-home（也接受 git URL）；profile 變更需審批後重載頁面。移除時使用 remove_bundle，target 爲 dsh-sidebar-home。
更新與卸載¶
更新採用 移除再添加：DSH 每次安裝會加載新的 client 模塊代際。在 Plugins 頁移除 bundle，拉取新 checkout，再按路徑添加並重載（若仍顯示舊模塊，完全重啓應用）。
卸載會去掉 Home 入口與相關注冊，側邊欄恢復出廠瀏覽器；工作區與會話數據不被插件改動。若需清除插件本地偏好，刪除 localStorage 中的 dsh-sidebar-home:state:v1。
典型用法¶
- 安裝並啓用後，點擊側邊欄面板行的 Home（房屋圖標）。
- 在 Home 頁瀏覽工作區列表（可切換卡片/列表佈局），點擊某一工作區進入聚焦；或使用 Add workspace 註冊新目錄並進入。
- 聚焦期間在側邊欄搜索會話標題、處理帶 attention 標記的會話、置頂項、新建會話；需要全局出廠能力（重命名、pin、歸檔、fork、消息級搜索、拖拽排序、其他插件注入的行內控件等）時，點擊 Exit focus。
- 底部 Other workspaces 可快速切到其他工作區而不必先回 Home；View all workspaces 返回 Home 總覽。
- Home 進入工作區時打開該工作區的空白會話；聚焦期間若主面板可見會話變化，插件會自動跟隨該會話（資料中的唯一自動規則）。
聚焦模式的限制¶
Focus mode 會替換出廠的 sidebar.workspaces slot，因此在退出前以下能力不可用：會話/工作區上下文菜單、拖拽排序、視圖/排序/篩選、全局內容搜索（聚焦內搜索僅過濾會話標題）、以及其他插件注入出廠瀏覽器行的控件。退出後全部恢復。聚焦列表不會重排或寫入原生工作區/會話狀態。
實現要點（供排查用）¶
| 擴展點 | 用途 |
|---|---|
sidebar.panellist |
列表項 sidebar-home，order -10，Home 圖標 |
main |
keyed panel sidebar-home，Home 頁 |
sidebar.workspaces |
聚焦時單槽替換，負優先級；退出即 dispose |
數據來自標準 slot props（useWorkspaces、useSessions 等），不掃描 DOM、不寫 Host 文件。硬依賴僅爲 slots；locale、layout 等通過嵌套 ctx.inject 可選注入，缺失時插件保持惰性而非拖垮 Web 啓動。
適用場景與注意¶
適合：在 DSH Desktop 或 dsh web 上管理多個工作區、希望側邊欄臨時「只看我正在做的那個 workspace」的開發者；需要 Home 總覽會話規模與最近活動時再展開全貌。
注意：
- 社區獨立項目，與 DeepSeek / 幻方無從屬關係；DSH 仍爲 prerelease，插件擴展 Client slot，使用前請閱讀 README 的 Compatibility 與 failure modes。
- 插件以當前 DSH 進程/瀏覽器上下文運行；安裝前請自行查看 源碼倉庫 與 MIT 許可證。
- 0.2.1-rc.4 及更早、0.3.x 及更新在聲明範圍內不被支持；刻意豁免版本屬於自擔風險。
- SkillHub 目錄爲社區站點，不是官方應用商店。
結尾¶
dsh-sidebar-home 用 Home 面板選工作區、用 Focus mode 收窄側邊欄會話視圖，並在退出時完整歸還 DSH 自帶側邊欄——適合多工作區並行、又需要階段性「單工作區專注」的場景。
- 目錄頁：https://www.skillhub.cn/plugins/fu-silent/dsh-sidebar-home
- GitHub：https://github.com/fu-silent/dsh-sidebar-home
