DSH（DeepSeek Harness）的設計理念是“一切皆插件”，默認的 Web UI 右側邊欄功能較爲基礎，無法滿足開發者對文件瀏覽、代碼編輯和源代碼控制的深度需求。dsh-solution-explorer 插件旨在通過 VS Code 風格的界面，接管 DSH Web GUI 的右側邊欄，爲智能體開發者提供一個集成了文件資源管理、多標籤編輯器和完整 Git 工作流的一站式解決方案。
插件定位¶
該插件由社區開發者 xiaoksio 維護，是一個全功能的右側邊欄替代方案。它將文件列表、源代碼控制視圖和編輯器集成在一起，通過一個多標籤頁的編輯器視圖統一管理所有文件操作和 Git 狀態。
核心功能¶
文件資源管理器¶
插件接管了默認的側邊欄，提供 VS Code 風格的文件樹視圖。支持展開/摺疊目錄，顯示基於文件類型的圖標，並利用 Git 狀態標記文件（綠色未跟蹤、黃色修改、灰色忽略）。此外，它支持基於 .gitignore 的過濾功能，並會通過顏色標記目錄的修改狀態。
源代碼控制¶
這是該插件的核心功能之一，支持完整的 Git 操作流程：
- 變更管理：支持暫存、取消暫存和丟棄（Discard）文件或補丁。
- 提交與 AI 輔助：提交時支持生成符合 Conventional Commits 規範的 AI 草稿（點擊 ✨ 圖標）。
- 差異視圖：提供並排的文件差異對比，支持在右側列中直接編輯代碼、合併行或暫存補丁。
- 提交圖：可視化的 Git 歷史視圖，顯示分支分叉線和合併線，支持點擊查看具體提交的文件變更和詳情。
- 同步與分支：支持 fetch、pull、push、sync（拉取並推送），以及分支切換、創建、重命名、刪除和合並操作。支持多倉庫切換。
- 衝突處理：自動檢測並列出合併衝突狀態。
編輯器與預覽¶
- 多標籤編輯器：在編輯器視圖中支持打開多個文件，涵蓋 15 種編程語言的語法高亮，且支持輸入時的實時重新高亮。
- 文件預覽：支持圖片、Markdown、HTML 和 PDF 的實時渲染預覽，支持縮放和平移操作。
- 保存：支持通過按鈕或快捷鍵
Ctrl+S保存文件修改。
終端與操作¶
- 多標籤終端：提供基於 ConPTY 的多標籤終端，支持拖拽調整大小，並在標籤頁關閉或連接斷開時自動清理進程。
- 可摺疊圖標欄：支持將面板摺疊爲窄圖標欄，點擊圖標即可切換打開對應的面板（資源管理器、搜索、源代碼控制、終端）。
- 右鍵菜單：提供文件和文件夾的上下文菜單，支持新建、刪除、複製、剪切、粘貼、複製路徑和“在資源管理器中顯示”等操作。
安裝與啓用¶
安裝該插件需要在具備 Web UI 側邊欄的會話環境中進行。
- 安裝插件
使用 DSH 命令行工具安裝：
dsh plugin --profile web add dsh-solution-explorer
- 激活
安裝完成後，在 DSH Web UI 中重新加載頁面，插件面板將作爲獨立的右側欄出現。當會話激活工作區時，面板會自動展開。
典型用法¶
- 編輯與保存：在文件資源管理器中打開文件，進行修改後按
Ctrl+S保存。 - AI 生成提交信息：在源代碼控制的變更列表中，點擊提交框旁邊的 ✨ 圖標，根據暫存的差異內容生成 AI 提交草稿。
- 快速預覽：雙擊圖片或 PDF 文件，即可在編輯器視圖中進行縮放和平移查看。
適用場景與注意事項¶
該插件適合需要頻繁進行文件讀寫、代碼編輯和 Git 操作的智能體開發場景，能夠顯著提升在 Web 界面下的開發體驗。
重要提示：
- 這是一個第三方社區插件，代碼會在本地機器上以當前 DSH 進程的權限運行。
- 插件擁有讀取、修改和刪除文件的能力，並且可以執行破壞性的 Git 操作（如丟棄變更、刪除文件）。
- 建議在使用前審查源代碼，並對重要工作做好備份。
- 使用 dsh plugin add github:xiaoksio/dsh-solution-explorer 安裝時，插件會自動在目標機器上構建 lib/ 目錄，無需手動操作。
總結¶
DSH Solution Explorer 通過復刻 VS Code 的核心體驗，解決了 DSH Web GUI 在本地文件管理和版本控制方面的不足。它將文件瀏覽、編輯和 Git 工具無縫集成，爲開發者提供了一個輕量級但功能完備的本地化開發環境。
