前言¶
在 DeepSeek Harness (DSH) 中，用戶通常在工作區組內進行會話置頂，但這些置頂會話仍會隨工作區切換、摺疊列表或列表滾動而消失。dsh-pinned-sessions 插件在側邊欄創建了一個專門的“置頂”會話組，位於工作區分組上方，將所有工作區的置頂會話集中展示，並提供原地搜索功能。
核心功能¶
該插件在側邊欄創建一個置頂會話組，其結構包括：
* 頭部： 34px 高度，包含輪廓釘圖標、計數和搜索按鈕。
* 列表： 下方爲 32px 的會話行，對應每個置頂會話。
* 信息展示： 顯示會話所屬工作區，以及運行（藍色）或完成（綠色）的狀態。
* 搜索過濾： 支持在組內原地搜索，過濾會話標題（不區分大小寫）。
* 摺疊與開關： 支持摺疊/展開列表；可通過“設置 -> 通用 -> 置頂會話區”開關控制顯示。
* 子會話過濾： 隱藏存檔的子代理會話。
安裝¶
使用以下命令安裝插件：
dsh plugin --profile <your-profile> add @vfvrpq/dsh-pinned-sessions
使用方式¶
- 置頂/取消置頂： 懸停會話行即可進行置頂或取消置頂。
- 打開會話： 點擊置頂會話行可打開會話。
- 摺疊/展開： 點擊置頂組標題可摺疊或展開列表。
- 搜索： 在搜索框輸入關鍵詞，支持不區分大小寫的標題匹配。
技術細節與注意¶
- 狀態管理： 插件不維護獨立狀態，完全依賴宿主的
workspaces.pinSession能力，置頂操作在任一位置生效，狀態即時同步。 - DOM 結構： 採用 portal 掛載方式，不會破壞原生組件的 DOM 結構。
- 錯誤處理： 若錨點消失，插件會渲染空內容而非報錯。
- 本地開發： 本地開發時，不要同時將插件添加到
dsh.profile.bundles和cordis.patch.yml，否則會導致重複安裝。
生態背景¶
DeepSeek Harness 遵循“一切皆插件”的理念。此插件由社區維護，與 DeepSeek 或幻方官方無從屬關係。
