前言¶
在 DeepSeek Harness（DSH）裏調試代理任務時，常見需求是查看當前會話 workspace 裏的文件，確認代理創建或修改了哪些內容，並對文本文件做少量編輯。已有做法通常是切到終端、文本編輯器或外部 IDE。dsh-explorer-plugin 把這個能力放進 DSH Web GUI：側邊欄出現文件樹，點開文件後用 Monaco 編輯器查看和修改，語法高亮使用 VS Code TextMate 語法。
下面介紹它的功能、安裝方式和需要注意的限制。
這是什麼¶
dsh-explorer-plugin 由 dgadelha1 維護，許可證爲 MIT。它給 DSH Web GUI 增加一個 File Explorer 面板，提供 workspace 文件樹和 Monaco 編輯器。
已覈實的運行環境信息來自 README 測試環境：DeepSeek Harness 0.1.0-rc.7、pnpm 9.15.9、Node.js ≥ 20。資料要求 CLI dsh 與 pnpm 在 PATH 中；如果 pnpm 不在 PATH，資料提到可使用本地 shim 並前綴 PATH。
核心功能¶
文件瀏覽¶
- 打開、創建、重命名、複製、移動、刪除文件和文件夾。
- 文件樹支持按需加載。
- 可選顯示隱藏文件。
- 面板作爲應用網格中的真實列嵌入，可摺疊、可調整大小，並可移動到左側或右側。
Monaco 編輯器¶
- 提供行號、多標籤、撤銷 / 重做。
- 支持
Ctrl+S保存，並檢測外部衝突。 - 可選換行。
- 支持大文件與二進制文件處理。
- 使用 VS Code TextMate 語法爲 28 種語言提供代碼高亮。
代理聯動¶
- 通過 SSE 即時監聽文件變化；當代理創建或編輯文件時，文件樹會更新。
- 提供
Analisar和Corrigir快速操作，用於發送代理指令，並在修改前請求確認，不會未經批准修改文件。
多語言與安全¶
- 支持
pt/en/zh，並跟隨 GUI locale。 - 所有文件操作限制在會話 workspace。
- 具備 path traversal 與 symlink escape 防護。
- 路徑根由服務端驗證。
安裝與啓用¶
先確認 dsh 和 pnpm 可用。如果當前 workspace 使用本地 pnpm shim，可參考資料示例，把本地 shim 目錄加入 PATH 後再執行安裝命令：
PATH="$PWD/.bin:$PATH" dsh plugin --profile web add -w .
插件倉庫中的 vendor assets 已提交。只有在需要更新或重新 vendor 時，再執行：
node scripts/vendor.mjs
這一步需要網絡。
在插件 checkout 目錄中，使用 README 中的安裝命令：
dsh plugin --profile web add -w .
也可以使用絕對路徑執行：
dsh plugin --profile web add -w /caminho/absoluto/para/dsh-explorer-plugin
這裏的 -w 是必要參數。資料說明安裝 pnpm 依賴時必須使用 -w 或 --workspace-root，否則可能觸發 ERR_PNPM_ADDING_TO_ROOT。
安裝或變更服務端 bundle 後，需要重啓 dsh web。例如使用倉庫腳本：
scripts/restart-web.sh
如果只有客戶端修改，例如 lib/client.js 或 vendor/，資料說明可刷新瀏覽器頁面。
平臺腳本可用於安裝、校驗和移除：
scripts\install.bat
scripts/install.sh
scripts/install-macos.sh
經過上面的步驟後，打開 DSH GUI，例如：
http://127.0.0.1:3080
在側邊欄查看 File Explorer 面板。
典型用法¶
1、打開 DSH Web GUI，在側邊欄找到 File Explorer 面板。
2、查看當前會話 workspace 的文件樹，點開文本文件後用 Monaco 編輯器查看或修改。
3、保存文件時可按 Ctrl+S；編輯器會檢測外部衝突。
4、對某個文件使用 Analisar 或 Corrigir，發送代理指令；資料說明這類操作在修改前需要確認。
適用場景與注意¶
適合需要在 DSH Web GUI 內查看、管理當前會話 workspace，並對代理生成或修改的文件做快速編輯的開發者。它更適合放在日常 DSH 調試流程裏，而不是替代完整的本地 IDE。
安裝前需要注意：插件以當前 dsh 進程權限運行，安裝前應檢查源碼和許可證。該項目許可證爲 MIT。社區目錄只是插件發現站點，不是官方應用商店，也不代表與 DeepSeek / 幻方存在官方從屬關係。
鏈接¶
- GitHub：https://github.com/dgadelha1/dsh-explorer-plugin
- 插件目錄頁線索：https://www.skillhub.cn/plugins/dgadelha1/dsh-explorer-plugin（該 URL 來自插件線索，未在所抓資料中直接出現）
