前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許在客戶端擴展功能。在智能體開發或代碼處理場景中，開發者通常需要頻繁查看文件結構、Git 變更記錄或代碼 Diff。dsh-flyout-sidebar 插件通過提供一個覆蓋整個會話區的側邊欄，以及支持彈出的獨立標籤頁，解決了在對話流中查看文件和代碼的需求。
這是什麼¶
這是一個 DSH 客戶端插件，提供可彈出式側邊欄。它由 oxlyn 維護，使用 MIT 許可證。核心價值在於將文件樹、Git 變更列表與代碼預覽集成在一個可拖拽、可彈出的面板中，並保證與主會話區的實時同步。
安裝與啓用¶
使用以下命令安裝插件：
dsh plugin --profile web add dsh-flyout-sidebar
安裝完成後，需要重啓 dsh web 並在瀏覽器中執行硬刷新（Cmd/Ctrl+Shift+R）以使圖標和麪板生效。可以通過以下命令驗證配置層是否正確加載：
dsh --profile web --dump-config | grep dsh-flyout-sidebar
核心功能¶
- 雙視圖模式：面板默認顯示文件樹視圖，支持一鍵切換到 Git 變更視圖。Git 變更列表會自動跟隨，顯示變更類型（M/A/D/R/U）及行數統計，支持懸停查看暫存狀態。
- 大面積預覽：預覽區會蓋住左側整個會話區域，提供充足的閱讀寬度。支持代碼軟換行、圖片滾輪縮放以及着色的 unified diff。
- 獨立彈出：面板左上角提供按鈕，可將側邊欄一鍵彈出爲獨立的瀏覽器標籤頁。該標籤頁可拖拽到另一塊顯示器，且與主面板通過
localStorage實時同步會話與主題。 - 系統集成：預覽欄支持在系統默認編輯器或 IDE 中打開當前文件。
使用示例¶
安裝並重啓後，驗證插件功能：
1. 點擊刷新按鈕，強制拉取 Git 變更列表的最新狀態。
2. 點擊文件列表中的某一項，查看着色的 unified diff。
3. 點擊面板左上角的彈出圖標，查看獨立標籤頁是否正確同步了當前會話和主題。
注意事項¶
- 工作區必須是一個 git 倉庫，否則 Git 變更視圖會顯示錯誤提示（文件樹視圖不受影響）。
- 代碼預覽功能依賴於瀏覽器的原生查找功能。
- 本地開發構建需要安裝
devDependencies。 - DSH profile 的 pnpm 供應鏈策略可能會暫緩安裝剛剛發佈的版本，導致需要等待一段時間才能更新。
