前言¶
DeepSeek Harness 的設計理念是“一切皆插件”。在開發智能體或調試代碼時，僅依賴對話窗口往往不夠，需要直接對工作區文件進行瀏覽和編輯。現有的操作流程可能較爲繁瑣，缺乏統一的文件管理入口。
這是什麼¶
@supanexus/dsh-plugin-file-explorer 是一個由 SupaNexus 維護的客戶端插件（MIT 許可）。它將文件瀏覽與編輯能力集成到 DeepSeek Harness 中。界面佈局保持左側爲官方對話列表，中間區域新增目錄樹與多標籤編輯器，用於固定當前會話的工作目錄。
核心功能¶
- 文件 Tab 與佈局：在會話頂部增加“文件”標籤頁，顯示目錄樹與編輯器分欄，當前會話工作目錄固定。
- 多標籤編輯：支持多標籤打開文件，未保存的文件會標記爲 dirty，使用
Ctrl/Cmd+S保存。 - Markdown 支持：支持在源碼模式與預覽模式間切換。
- 文件操作：支持新建、重命名、刪除文件（非空目錄無法刪除）。
- 鏈接集成：對話中的文件路徑鏈接可直接在編輯器中打開。
- 代碼編輯：優先使用 Monaco 編輯器（通過 jsDelivr CDN 加載），若加載失敗或超時，會自動降級爲純文本框。
安裝與啓用¶
- 執行安裝命令：
dsh plugin --profile web add github:supanexus/dsh-plugin-file-explorer#v0.1.0
- 安裝後必須完全重啓
dsh web（或 Desktop Host），然後使用打印的?token=地址打開。
典型用法¶
- 打開或新建一個會話。
- 點擊頂部“文件”標籤頁。
- 在左側目錄樹中瀏覽文件，雙擊文件即可在右側編輯器打開。
- 修改內容後，按
Ctrl/Cmd+S保存。 - 右鍵點擊樹節點，可進行新建、重命名或刪除操作。
注意事項與適用場景¶
- 外觀調整：編輯器工具欄中支持調整背景色、字號和方案。
- 配置項：可在設置 → 插件 → SupaNexus 文件瀏覽 中進行配置。例如設置瀏覽根目錄（默認爲當前進程工作目錄）或控制對話內文件鏈接是否在編輯器打開。
- 權限與安全：插件以當前 dsh 進程的權限運行，請確保在安裝前檢查源碼與許可證（MIT）。
- 適用場景：適合需要在對話中直接管理項目文件、調試代碼或維護多文件智能體的開發者。
該插件通過集成目錄樹與多標籤編輯器，簡化了 DeepSeek Harness 中的文件操作流程。更多細節請參考目錄頁或GitHub 倉庫。
