在使用 DeepSeek Harness 進行開發或交互時，調整右側邊欄寬度以查看隱藏的上下文或工具是常見操作。若頻繁切換不同類型的內容頁籤（如引導頁、文件頁、文檔頁），手動調整寬度會消耗額外精力。dsh-sidebar-size 插件旨在解決這一問題，它通過記憶和恢復側邊欄尺寸，減少重複操作。
核心功能¶
該插件主要提供以下能力：
- 按頁籤類型分別記憶：插件記錄當前活動頁籤的類型，並在下次打開同類內容時恢復對應的右側邊欄寬度。記憶與具體文件或會話無關，是全局共享的。
- 繼承機制：當特定類型沒有記錄時，插件會沿繼承鏈查找上級內容頁的記錄，直到找到有效記錄或回退到 DSH 默認尺寸。需注意，繼承僅影響顯示，不會爲未經過用戶拖拽的內容頁創建記錄。
- 統一寬度模式：可關閉“按顯示內容區分尺寸”開關，使所有內容共用同一份寬度記錄。
- 狀態與日誌：在設置頁中，用戶可以查看插件運行狀態、當前活動頁籤、側邊欄尺寸及其來源（本類型記錄/繼承自上級/DSH 默認）。此外，支持一鍵導出運行日誌以便排查問題。
- 數據遷移：支持數據的導出與導入（預覽後確認），便於在不同環境間遷移配置。
安裝與啓用¶
安裝需通過 DSH 的插件安裝入口，使用官方 CLI 的子命令形式。安裝成功並重啓桌面端後，設置頁會出現「側邊欄尺寸」分組。
方式一：使用發行包（推薦）
從本倉庫的 Releases 頁面下載對應版本的 .tgz 文件（例如 dsh-sidebar-size-0.1.1.tgz），將安裝命令中的 <包名或路徑> 替換爲該文件的本地路徑即可。
plugin --profile desktop add <本地文件路徑.tgz>
方式二：使用源碼
克隆本倉庫後，需先安裝依賴並構建，再以倉庫目錄作爲路徑安裝。構建需要 Node 24 與 pnpm 11（版本號見 package.json）。
pnpm install
pnpm build
plugin --profile desktop add <本倉庫目錄>
配置與使用¶
安裝完成後，在 DSH 設置頁找到「側邊欄尺寸」分組進行配置：
- 總開關：控制插件是否生效。關閉後不再記錄、記憶或調整寬度，側邊欄寬度恢復爲 DSH 默認值，但設置入口仍可重新開啓。
- 按顯示內容區分尺寸：默認開啓。開啓時，每個頁籤類型分別記錄右側邊欄尺寸；關閉時，所有內容共用同一尺寸記錄。切換此設置時，新舊數據互不覆蓋。
- 已保存的寬度：下拉選擇已記錄的頁籤類型，可查看或修改該類型的記錄數值。
- 重置側邊欄尺寸數據：二次確認後清除插件保存的全部寬度數據，並將當前側邊欄恢復爲默認尺寸。
此外，設置頁還提供數據遷移功能，支持導出當前數據和導入（需預覽確認）。
兼容性與注意事項¶
- 實測兼容：基於 DSH 桌面端 v0.2.0-rc.2（本體）及
dsh-better-sidebarv0.24.1 的實測組合通過。 - 理論兼容：與同一版本線（v0.2.0-rc.x）的其它 DSH 本體或本體+插件組合，以及 DSH Web 形態理論上兼容。插件不修改宿主文件，僅讀寫自身數據。
- 未實測情形：浮窗（浮動面板）、拖動過程中切換內容或改動開關、分欄焦點切換，以及上述理論兼容列表中的組合未逐一實測，不能保證行爲完全符合預期。
- 穩定性與維護：DeepSeek Harness 本體版本更新時，本插件功能可能失效。異常結束進程（強制關閉而非正常退出）可能丟失最近一次尺寸提交的數據。
- 依賴聲明：本插件由第三方開發，與 DeepSeek 官方無隸屬、贊助或背書關係，以 MIT 許可證發佈。
