前言¶
DeepSeek Harness（DSH）的理念是「一切皆插件」。對以純文本爲主交互的 Agent 來說，如果界面只有對話區，查看工作區文件、編輯文本、把文件路徑帶入消息會需要額外操作。
dsh-file-explorer 是 cxzrdxy 維護的一個 MIT 許可插件，給 DSH 的純文本 Agent 裝上一個「文件瀏覽器」：在右下角打開當前工作區目錄樹，並提供與「對話」「軌跡」平級的「預覽/編輯」頁籤，讓文件查看、文本編輯和路徑引用留在對話界面內完成。
這是什麼¶
一句話定位：給 DeepSeek Harness 的純文本 Agent 提供一個文件瀏覽器。
它面向使用 DSH Web profile 的開發者，解決的是在對話過程中快速查看工作區文件、預覽文本和圖片、編輯文本、新建或刪除文件，以及把文件路徑插入消息的問題。
核心功能¶
文件樹¶
- 通過右下角按鈕打開當前工作區目錄樹，可逐層展開。
- 文件樹根路徑跟隨當前會話 cwd，切換工作區後刷新。
- 當前工作區本身，也就是樹根目錄，不可刪除。
預覽與編輯¶
- 「預覽/編輯」頁籤與「對話」「軌跡」平級。
- 點擊文件後自動切到「預覽/編輯」頁籤。
- 文本文件可在預覽頁籤中編輯，支持保存 Ctrl+S、撤銷 Ctrl+Z、重做 Ctrl+Y。
- 在文件樹中雙擊文件可直接進入編輯模式。
- 可預覽文本文件和圖片；文本文件上限爲 512 KB，圖片上限爲 8 MB。
- 其他二進制文件只顯示大小提示，不預覽內容。
拖拽插入消息¶
- 支持把文件樹中的文件或目錄拖到消息輸入框，並自動插入文件路徑。
- 拖拽進消息框僅支持從文件樹節點拖出；瀏覽器無法獲取操作系統文件管理器中文件的絕對路徑。
新建與刪除¶
- 支持在工作區根目錄新建文件。
- 支持懸停目錄行後在該目錄內新建文件。
- 支持刪除文件或文件夾；文件夾刪除使用 DSH 原生風格確認彈窗並遞歸刪除。
- 服務端始終拒絕刪除文件系統根路徑。
- 未帶遞歸標誌時拒絕非空目錄。
- 新建文件拒絕重名覆蓋，並返回 409。
安全限制¶
插件提供同源校驗、路徑規範化、條目/字節上限等安全限制。刪除和新建操作也遵循上述限制，避免誤刪、誤覆蓋和越權訪問。
安裝與啓用¶
需要 DeepSeek Harness 的 Web profile 和 pnpm。下面列出的是資料中給出的本地路徑安裝方式：
git clone https://github.com/cxzrdxy/dsh-file-explorer.git
cd dsh-file-explorer
dsh plugin --profile web add file:.
安裝完成後，重啓 Web profile。包內已提交編譯好的 lib/，從 checkout 安裝不需要消費端構建。
典型用法¶
- 打開文件樹：點擊右下角按鈕。
- 查看文件：點擊某個文件後，自動切到「預覽/編輯」頁籤查看內容。
- 編輯文本：點擊「編輯」按鈕，或在文件樹裏雙擊該文件直接進入編輯模式。
- 保存文件：編輯完成後點擊「保存」或按 Ctrl+S。
- 引用文件路徑：把文件樹裏的文件拖到消息輸入框，鬆開後文件路徑自動插入消息文本。
- 在工作區根目錄新建文件：點擊面板頭部加號，輸入文件名後回車。
- 在指定目錄新建文件：懸停某個目錄行後，點擊該行右側加號，在該目錄內新建文件。
- 刪除文件：懸停文件行後點擊刪除按鈕，確認後刪除該文件。
- 刪除文件夾：懸停目錄行，樹根除外，點擊刪除按鈕，勾選確認後遞歸刪除該文件夾。
適用場景與注意¶
適合以下情況：
- 使用 DSH Web profile，希望在對話界面內直接查看工作區文件。
- 需要快速預覽文本、圖片，並編輯文本文件。
- 需要把文件路徑快速插入消息，減少手動輸入路徑。
- 需要在當前工作區內做輕量的新建、刪除操作。
需要注意：
- 插件以當前 dsh 進程權限運行，能夠訪問工作區文件並執行新建、刪除等操作。安裝前建議檢查源碼與許可證。
- 拖拽插入消息僅支持從文件樹節點拖出，不能從操作系統文件管理器拖入文件。
- 當前工作區本身不可刪除；服務端始終拒絕刪除文件系統根路徑。
- 未帶遞歸標誌時，刪除操作會拒絕非空目錄。
- 新建文件會拒絕重名覆蓋，並返回 409。
- 文本預覽上限爲 512 KB，圖片預覽上限爲 8 MB；其他二進制文件只顯示大小提示。
相關鏈接¶
- GitHub：https://github.com/cxzrdxy/dsh-file-explorer
- 目錄頁（插件線索地址）：https://www.skillhub.cn/plugins/cxzrdxy/dsh-file-explorer
