前言¶
在 DeepSeek Harness（DSH）裏同時開着多個會話時，待審批、剛跑完還沒點開、正在跑的任務往往分散在側欄裏，需要逐個找狀態點才能判斷優先級。側欄能看全列表，但切換頻繁時不夠直觀。dsh-session-float 是面向 DSH Web 界面的客戶端插件，在頁面上提供一塊可拖動的「靈動島」膠囊：收納時彙總活動會話數量，展開後按狀態分組列表並支持一鍵跳轉，底部還可列出最近空閒的歷史會話。下面介紹它的能力、安裝方式與典型用法。
這是什麼¶
dsh-session-float 由社區維護者 MorzerChimes 發佈（倉庫 MorzerChimes/dsh-session-float），歸類爲 DSH 客戶端插件，通過 Cordis patch 注入 Web 前端。它不替代側欄會話列表，而是在任意會話相關頁面上浮層展示「當前有多少活動在等你處理」，並與側欄狀態含義對齊。
狀態與側邊欄會話狀態點一致：
| 狀態 | 含義 |
|---|---|
| 待處理 | 會話在等你審批、審閱計劃或回答問題 |
| 已完成 | 會話運行結束，你還沒打開查看 |
| 進行中 | 會話正在運行 |
核心功能¶
收納態一覽¶
收納時顯示活動會話總數，以及待處理、已完成、進行中各自的數量；某項爲 0 時不顯示該狀態。可選兩種收納樣式：詳細（圖標 + 數字 + 文字）或簡略（數字寫在狀態圖標中心）。詳細模式下，若有進行中的會話，「活動」圓點會播放心跳動畫（v0.2.0）。
展開列表與跳轉¶
點擊膠囊展開面板。會話按 待處理 → 已完成 → 進行中 分組，組內按最近活動排序；當前打開的會話帶豎條標記。點擊列表中的會話即可直接切換過去。
歷史會話¶
面板底部列出最近活動過、當前空閒的會話，不計入活動數。有活動會話時歷史分組默認收攏，沒有活動時默認展開；先顯示 5 條，可「查看更多」，最多 15 條。
位置與展開方向¶
按住拖動可放到頁面任意位置，位置會被記住。停靠在左側時向右展開、向左收攏；在右側時向左展開、向右收攏。
外觀與收起¶
外觀可選淺色、深色（比 DSH 深色亮一級，便於區分）、或跟隨 DSH 當前主題（系統）。收起方式包括 Esc、收起按鈕、點擊會話項；也可選「點擊空白處收起」。展開、收起與數字變化帶過渡動畫，並遵循系統的「減少動態效果」設置。
僅在會話頁顯示¶
可在設置中開啓「僅在會話頁中顯示」。開啓後，在插件、自動化任務等非會話頁隱藏靈動島（v0.2.0 新增）。
安裝與啓用¶
需要 DeepSeek Harness 0.2.1-rc.2 及以上（與 package.json 中 engines.dsh 一致）。
安裝當前最新發布版：
dsh plugin --profile web add github:MorzerChimes/dsh-session-float
安裝指定版本（示例爲 v0.2.0）：
dsh plugin --profile web add github:MorzerChimes/dsh-session-float#v0.2.0
所有版本見倉庫 Tags。安裝後刷新 DSH Web 頁面；若未出現靈動島，可重啓 dsh web。
設置入口有兩處：展開面板頭部的齒輪，以及側欄 插件 → dsh-session-float 詳情頁。
卸載：
dsh plugin --profile web remove dsh-session-float
典型用法¶
- 完成上述
dsh plugin --profile web add並刷新或重啓 Web 後，在會話頁看到浮動膠囊。 - 看收納態數字判斷待處理、已完成、進行中的規模；需要處理時點擊展開，從待處理組選會話跳轉。
- 把膠囊拖到順手的一角；在右側停靠時面板會向左側展開，避免擋住主內容。
- 在設置裏切換詳細/簡略收納、主題、點擊空白收起、以及是否僅在會話頁顯示。
- 活動數歸零時展開歷史會話，通過「查看更多」回到最近用過的空閒會話。
界面支持中英文（首個版本 v0.1.0 已說明）。
適用場景與注意¶
適合經常在 DSH Web 裏並行多個智能體會話、需要快速掃一眼「誰在等我」並跳轉的開發者。它不跑服務端邏輯，依賴注入的 DSH 客戶端 UI 模塊（會話、工作區、主題、插件管理等）獲取狀態。
DSH 生態主張「一切皆插件」；社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。客戶端插件隨當前 dsh 進程在瀏覽器側執行，安裝前建議閱讀倉庫源碼與 MIT 許可（© Merlin Hermes）。勿在未審閱的情況下在生產環境盲目添加第三方插件。
結尾¶
dsh-session-float 把活動會話的彙總、分組列表、歷史回看和一鍵切換收進一塊可拖動的 Web 靈動島，與側欄狀態語義一致。需要安裝命令與更新記錄時，以 GitHub README 與 CHANGELOG.md 爲準。
