前言¶
DeepSeek Harness (DSH) 的官方輸入框僅支持圖片拖拽。拖入工程文件或文件夾會觸發錯誤提示,無法直接將文件路徑傳遞給 Agent。dsh-drag-path 插件通過攔截瀏覽器拖拽事件,在宿端(Node)按文件名和大小定位真實路徑,解決這一限制。
插件簡介¶
dsh-drag-path 是由 Rudyy898 維護的客戶端插件。它允許用戶將任意非圖片文件或文件夾拖入 DSH 網頁端,自動獲取並插入文件的真實絕對路徑,供 Agent 讀寫原文件。
核心功能¶
- 文件 & 文件夾都支持
- 真實絕對路徑
- 智能定位:優先工作區,再常用目錄(Downloads/Desktop/Documents/Home),使用
find和mdfind進行精確匹配和補充 - 同名多候選彈選擇器
- 支持粘貼文件
- 圖片拖拽不受影響
- 批量拖入
- 拖拽視覺反饋
- 支持 macOS 和 Windows 平臺
安裝¶
在終端執行以下命令:
dsh plugin --profile web add https://github.com/Rudyy898/dsh-drag-path
安裝完成後,重啓 dsh web 並刷新瀏覽器即可生效。
使用方法¶
直接從 Finder 或資源管理器把文件或文件夾拖到 DSH 頁面任意位置:
1. 唯一命中:絕對路徑直接插入輸入框。
2. 同名多候選:彈出選擇器,點選正確的路徑。
3. 找不到:插入文件名(控制台會有提示)。
工作原理¶
瀏覽器安全沙箱只暴露 File 對象(name/size/type),不提供絕對路徑。本插件通過 host 端(Node)按文件名+大小在文件系統裏定位。
* 定位策略:優先當前工作區,再常見目錄,最後全局兜底。
* 就近適配:批量拖入時,利用前一個已定位路徑作爲線索,加速同目錄文件的查找。
* 校驗方式:文件名精確匹配 + 大小校驗。
平臺支持¶
- macOS:使用
find精確名匹配 +mdfind(Spotlight)補充。 - Windows:使用 PowerShell
Get-ChildItem遞歸 +where全局查找,支持中文目錄名。
配置¶
無需配置。所有行爲開箱即用。
許可證與注意事項¶
- 許可證:MIT 許可證。
- 權限:插件以當前 dsh 進程權限運行,安裝前建議檢查源碼。
鏈接¶
- GitHub:https://github.com/Rudyy898/dsh-drag-path
- 插件目錄:https://www.skillhub.cn/plugins/Rudyy898/dsh-drag-path