前言¶
在 DeepSeek Harness (DSH) 的 Web GUI 環境中開發智能體時，開發者往往需要查看當前會話工作區（cwd）內的文件上下文。原生界面缺乏直接的文件樹瀏覽能力，需要依賴外部終端或文件管理器。dsh-workspace-files-explorer 插件爲 DSH Web GUI 補充了這一功能，通過一個浮層面板提供文件樹瀏覽與預覽能力。
核心功能¶
該插件主要包含以下功能：
-
浮層面板與交互
- 面板註冊在
shell.overlay，默認停靠在右上角。 - 支持拖拽標題欄移動面板，拖拽右下角調整大小（尺寸範圍 400-1400x280-900）。
- 提供關閉與刷新按鈕。
- 在會話標題欄動作區註冊“工作區文件”按鈕，用於切換面板顯隱。
- 面板註冊在
-
文件樹展示
- 支持目錄優先排序、懶加載展開。
- 隱藏文件（點開頭文件）會淡化顯示。
- 顯示文件大小。
- 單目錄超過 500 項時會顯示截斷提示，並提供一鍵刷新。
-
預覽能力
- 代碼預覽：支持 30+ 種語言（如 JS/TS/Python/Go/Rust 等），帶有行號、輕量級語法高亮。主題隨系統深淺色自動適配。超長文件會被截斷。
- Markdown 預覽：支持渲染標題、列表、表格、引用、鏈接、代碼塊。渲染前會對 HTML 進行轉義，鏈接僅允許
http/https協議並強制添加rel="noopener noreferrer"。
安裝與啓用¶
推薦使用安裝方式以獲得持久化體驗。
dsh plugin --profile web add github:YZz-S/dsh-workspace-files-explorer
安裝後，插件會自動生效，“工作區文件”按鈕將出現在會話標題欄動作區。
若需臨時測試，也可以使用動態加載方式。在 dsh Web GUI 會話中調用 cordis_define，將 host.js 內容粘貼爲 code.host，將 client.js 內容粘貼爲 code.client，隨後調用 cordis_run 激活。
注意事項¶
- 權限與安全：插件僅讀取當前會話工作區內的文件和目錄列表，不發起外部網絡請求，不執行文件寫入，不收集遙測數據。所有路徑訪問均需通過
fs.contains驗證。渲染內容前會對 HTML 進行轉義，防止 XSS 注入。 - 文件限制：二進制文件或文本超過 256 KB 時僅顯示提示，無法預覽。語法高亮爲內置輕量級實現，非完整的語義高亮。
- 會話依賴：面板默認跟隨當前會話，切換會話時工作區根目錄會自動重置。
- 動態插件限制：通過
cordis_define加載的動態插件僅存活於當前進程。重啓 DSH 後需重新運行定義命令才能使用。
總結¶
該插件爲 DSH Web 開發者提供了一個輕量、安全的本地文件瀏覽方案，通過浮層面板和會話綁定，能夠快速定位並預覽當前上下文文件，輔助代碼調試與智能體開發。
- GitHub: https://github.com/YZz-S/dsh-workspace-files-explorer
- DSH 插件目錄: https://www.skillhub.cn/plugins/YZz-S/dsh-workspace-files-explorer
