前言¶
在 DeepSeek Harness（DSH）裏做本地項目時，會話往往綁定一個工作目錄，但要在界面裏瀏覽目錄、改文件名、把某個路徑丟進聊天輸入框，仍常要切回系統文件管理器或手打路徑。DSH 社區裏已有各類客戶端擴展；DSH Folder Explorer（倉庫 wx-98/DSH-folder）把一塊 VSCode 風格的文件樹放進 Web/Desktop 右側欄，並在 Host 側提供受控的本地文件 API。下面介紹它是什麼、能做什麼，以及如何安裝與日常使用。
這是什麼¶
DSH Folder Explorer 是維護者 wx-98 發佈的 DSH 客戶端類插件（社區目錄：skillhub.cn 插件頁）。官方簡介：在 DSH 中提供 VSCode 式文件樹、類型圖標、文件操作，以及 Add to Chat（添加到對話）。
插件類型爲 Cordis 插件 bundle（Host 半邊 + Web Client 半邊），不是皮膚、TUI 或獨立桌面客戶端。Host 側 index.js 註冊 /folder-explorer/* 路由；瀏覽器側 client.js 在右側欄註冊 folder-explorer 標籤類型。無構建步驟、無 npm 運行時依賴。許可證 MIT。
核心功能¶
文件樹與圖標¶
打開任意本地文件夾後可在樹中懶加載瀏覽：目錄優先排序，隱藏文件可見。文件類型帶 VSCode 風格圖標（TypeScript、JavaScript、JSON、Markdown、圖片、壓縮包、Office、Shell、配置、鎖文件等）；常見目錄名（如 .git、node_modules、src、dist 等）有專屬文件夾圖標。圖標子集來自 MIT 許可的 Material Icon Theme（見倉庫 docs/THIRD_PARTY_NOTICES.md）。
自動刷新：Host 側 watch 變化後約 ≤2s 更新；不可用時輪詢降級約 ≤5s。切換標籤或預覽後保留展開、選中與滾動狀態，也可手動刷新。
文件操作與快捷鍵¶
右鍵菜單支持：複製絕對/相對路徑、行內重命名、新建文件/文件夾、刪除（二次確認後永久刪除）、複製/粘貼（衝突時可保留兩者、跳過或覆蓋）、在 Finder/資源管理器中顯示（依賴宿主 Session Remote，不可用時菜單隱藏）。
樹獲得焦點後可用鍵盤：↑/↓ 移動，→/← 展開摺疊，Enter 打開，F2 重命名，Delete 刪除，Cmd/Ctrl+C/V 複製粘貼，Esc 關閉浮層。單擊文件用 DSH 內置文檔預覽打開（工作區外的絕對路徑同樣可用）。
添加到對話¶
在文件樹右鍵、已打開文件的預覽頭部，或 tab 右鍵，可將文件/文件夾作爲 @ 引用寫入當前會話聊天輸入框（類似 Cursor）：不讀取文件內容、不自動發送、保留已有草稿。
界面與語言¶
中文/英文文案，跟隨宿主深色/淺色主題。
安裝與啓用¶
前置：DSH Web/Desktop 0.2.1-rc.5。插件聲明 dsh.bundle.patch 與 dsh.client，支持 GitHub、npm 與本地目錄安裝。
從 GitHub 安裝¶
GUI：Plugins → Add plugin → Install a third-party plugin → 填寫 github:wx-98/DSH-folder 或 https://github.com/wx-98/DSH-folder.git → 安裝後啓用 bundle 對應 row。
CLI（dsh 在 PATH 中）：
dsh plugin --profile <profile> add github:wx-98/DSH-folder
從 npm 安裝¶
包名 dsh-folder-explorer。README 記載 npm 已發佈 dsh-folder-explorer@0.2.0（2026-11-01）；package.json 中當前版本爲 0.2.1（2026-11-02 更新記錄）。
GUI：Plugins → Add plugin → 包名 dsh-folder-explorer。
CLI：
dsh plugin --profile <profile> add dsh-folder-explorer
本地開發安裝¶
在 DSH GUI：Plugins → Add plugin → 本地絕對路徑，填入插件倉庫目錄的絕對路徑。本地 link 安裝時，修改 client.js 可由 dsh-client-hmr 熱替換；Host 半邊改動需經 profile 重組生效。
典型用法¶
經過上面的安裝與啓用步驟後，可按 README 中的順序操作：
- 在右側欄標籤嚮導打開 Folder Explorer（或從標籤欄「+」選擇）；
- 默認根目錄爲當前會話工作目錄；工具欄 打開文件夾… 可切換到任意本地目錄（最近一次根會記住）；
- 單擊文件在右側預覽；目錄行單擊展開/摺疊；
- 右鍵打開行級菜單；需要把路徑交給模型時，用 添加到對話 寫入輸入框。
安全邊界與限制¶
每個文件操作先經 DSH 連接信任柵欄（Host/Origin 校驗 + 登錄 cookie）。路徑限定在用戶顯式打開的根目錄內，經規範化與 realpath 複覈，拒絕 .. 或符號鏈接逃逸。刪除需顯式確認；複製/移動不允許把目錄放進自身。變更在 Host 內串行執行，不產生模型可見事件。
注意：插件以當前 dsh 進程權限訪問磁盤；安裝前應自行查看源碼與 MIT 許可證，並確認只打開可信根目錄。
已知限制（README）：刪除不進廢紙簍；暫不支持拖拽移動、多選批量、全文搜索、跨根全局索引；目標 DSH 0.2.1-rc.5，升級後建議迴歸。更多設計說明見倉庫 docs/folder-explorer-plugin.md、docs/file-icons.md、docs/add-to-chat.md。
結尾¶
DSH Folder Explorer 把本地目錄瀏覽、常見文件操作和「@ 路徑進聊天」收進 DSH 右側欄，適合在 Harness 里長時間盯着一個項目目錄的開發者。社區插件目錄與 GitHub 相互獨立，並非 DeepSeek 官方應用商店。
- 目錄頁：https://www.skillhub.cn/plugins/wx-98/DSH-folder
- 源碼與 README：https://github.com/wx-98/DSH-folder
