前言¶
DeepSeek Harness (DSH) 通過插件機制擴展 Web 界面功能。在智能體開發或調試場景中，如果需要訪問當前工作區之外的文件（如桌面、下載目錄或其他項目），手動輸入路徑既繁瑣又容易出錯。DSH File Picker 插件解決了這一痛點，它通過注入一個便攜式 Web GUI bundle，讓用戶可以直接在瀏覽器中瀏覽本地文件系統，並將選中的路徑作爲上下文提供給當前對話。
核心功能¶
該插件主要提供以下能力：
- 文件與目錄搜索：在本地 DSH 主機的任意目錄中搜索文件或目錄。
- 過濾機制：支持非遞歸、不區分大小寫的名稱過濾，僅作用於當前打開的目錄，不會遍歷子目錄。
- 路徑選擇：允許在單次操作中混合選擇文件和目錄（最多 32 個路徑），點擊“Apply”後將替換當前會話的路徑選擇。
安裝與啓用¶
安裝過程通過 npx 執行，無需編寫配置腳本。推薦使用固定版本標籤安裝：
npx --yes github:shaomingbo/dsh-file-picker#v0.2.3
該命令會自動編輯目標 profile（默認爲 web）的 package.json 中的 dependencies.dsh-file-picker 和 dsh.profile.bundles，以原子方式寫入清單，並運行 pnpm install --ignore-scripts。安裝期間 DSH 不會停止或重啓。
如需指定不同 profile 或使用本地代碼：
npx --yes github:shaomingbo/dsh-file-picker#v0.2.3 --profile lab
npx --yes github:shaomingbo/dsh-file-picker#v0.2.3 --source link:/path/to/dsh-file-picker
使用方法¶
啓用插件後，按以下步驟操作：
- 打開一個正常的 DSH Web 對話。
- 在 composer 工具欄中點擊 📁 圖標。
- 在彈出的文件瀏覽器中瀏覽主機文件系統，或使用搜索字段過濾當前目錄。
- 使用複選框選擇文件和目錄。點擊目錄名稱可進入下一級，點擊路徑欄的“Select this folder”可直接選中當前目錄。
- 點擊 Apply，然後發送下一個提示。模型將在對話上下文中收到包含
<selected_paths>的路徑信息，並可通過read、glob或grep等命令使用這些路徑。
適用場景與注意事項¶
- 適用場景：適合需要在 Web 界面中訪問本地任意目錄文件的智能體開發場景。
- 安全與隱私：插件僅返回路徑和條目類型，絕不讀取或上傳文件內容，也不遞歸掃描目錄。RPC 連接限制爲 localhost，防止遠程瀏覽器訪問。
- 限制：僅支持常規文件和目錄，設備文件和套接字無法被選中。每次應用新選擇會替換舊選擇，且選擇僅在當前 DSH 進程中有效，重啓進程後失效。
短結尾¶
DSH File Picker 爲 Web 界面提供了安全的本地文件訪問能力。通過標準的 npx 安裝流程和直觀的文件選擇器，它簡化了智能體與本地文件系統的交互方式。更多詳情與源碼，請參考 GitHub 倉庫 或 DSH 插件目錄。
