前言¶
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