前言¶

DeepSeek Harness (DSH) 採用插件化架構。dsh-better-sidebar 提供了側邊欄的基礎 UI，但默認的 Explorer 功能較爲受限，通常不具備文件系統的寫入能力。在開發或調試過程中，若需在對話上下文中直接管理文件、上傳素材或調整目錄結構，直接操作文件系統往往較爲繁瑣。dsh-sidebar-explorer-plus 爲 dsh-better-sidebar 增加了一個名爲「文件」的 Tab，通過 React 實現文件樹，並利用 Host 端 API 處理文件讀寫操作，從而在側邊欄內實現了完整的文件管理能力。

插件簡介¶

dsh-sidebar-explorer-plus 是一個 TypeScript/React 開發的文件管理插件，專爲 DeepSeek Harness 的 Web 側邊欄設計。

它通過 dsh-better-sidebar 的 ctx.betterSidebar.registerTab 服務註冊 Tab，不修改側邊欄底層源碼。其核心作用是補充 dsh-better-sidebar 自帶 Explorer 缺失的「寫」操作，允許用戶在側邊欄直接進行文件上傳、移動、重命名和刪除。

安裝¶

安裝前請確保環境滿足以下依賴：
* 運行中的 DSH Web Profile
* dsh-better-sidebar (版本 >= 0.4.0)
* Node.js 20 或更高版本

使用以下命令安裝：

dsh plugin --profile web add github:Wulabalabo/dsh-sidebar-Explorer-Plus

安裝完成後，需要重啓 dsh web，並在瀏覽器中進行硬刷新（Cmd/Ctrl + Shift + R）以加載新插件。

使用方法¶

1. 啓動 DSH Web，打開側邊欄。
2. 點擊側邊欄菜單中的「+」號，選擇「文件」。
3. 上傳文件/文件夾：直接將本地文件或文件夾拖拽到文件樹區域，插件會按原結構上傳。
4. 管理文件：在文件樹上右鍵可進行移動、重命名、刪除或創建文件夾操作。
5. 打開文件：點擊文件樹中的文件，會在側邊欄編輯器中打開。

配置與限制¶

插件默認單文件上傳限制爲 50 MiB。若需調整此限制，可在 profile 配置中添加 uploadLimit 字段。

- insert:
    - id: sidebar-explorer
      name: 'dsh-sidebar-explorer-plus'
      config:
        uploadLimit: 104857600   # 100 MB

注意事項：
* 刪除操作：刪除文件或文件夾是永久性的，且操作前會要求確認。
* 覆蓋與衝突：上傳文件時可以覆蓋同名文件；但在移動或重命名時，若目標路徑已存在，操作會被拒絕。
* 安全檢查：插件包含 Host/Origin 請求檢查、工作目錄檢查及上傳大小限制。當前的路徑檢查通過字符串比較實現，不解析符號鏈接或完全規範化路徑遍歷段，因此建議在可信工作區中運行。
* 構建依賴：插件倉庫中已包含構建產物（lib/ 目錄），通過 Git 安裝無需本地構建步驟。

總結¶

dsh-sidebar-explorer-plus 將文件系統操作能力直接集成到 DSH 側邊欄 UI 中，簡化了開發者在本地與工作區之間管理文件和素材的流程。

資源鏈接：
* GitHub 倉庫
* 社區目錄