Rudyy898/dsh-drag-path

dsh-drag-path

将工程文件/文件夹拖入 DeepSeek Harness，自动定位真实绝对路径并插入输入框

将非图片文件与文件夹拖入 DeepSeek Harness 网页——真实的绝对路径会落入你的输入框，不再有“仅允许图片”的限制。

✨ 像 Codex / Claude Code 一样——拖入任意格式的文件或文件夹，路径直接进输入框，不用一个个打字，Agent 立刻知道你在说哪个文件，开发效率拉满。

像 Codex / Claude Code 一样：拖入任意文件或文件夹（无格式限制），路径立即落入你的输入框——无需再手动输入路径。

这是什么 / 这是什么

DSH 官方输入框的拖拽只接受图片（PNG/JPG/WebP/GIF），拖入工程文件会弹「仅支持 PNG、JPG、WebP、GIF 格式的图片」，让你完全没法把代码、文档、配置文件拖给 Agent 看。

本插件解决这个问题：拖入任意非图片文件或文件夹，自动定位它的真实绝对路径并插入输入框——Agent 直接就能读写原文件，像 Codex 一样顺畅。

原生 DSH 输入框只接受图片拖拽。本插件会拦截非图片拖拽，定位文件在磁盘上的真实绝对路径，并将其插入输入框——这样 Agent 就能读写原始文件，就像 Codex 一样。

特性 / 特性

- 📁 文件 & 文件夹都支持 — 拖 .swift / .xlsx / .ipa / 目录… 都行
- 🎯 真实绝对路径 — 不是上传副本，Agent 操作的就是你的原文件
- 🔍 智能定位 — 优先当前工作区，再常见目录（Downloads/Desktop/Documents/Home），find 精确名匹配 + mdfind 补充 + 大小校验
- 📍 就近适配 — 批量拖入的同目录文件，用前一个已定位路径作线索，秒级命中
- 🧩 同名多候选弹选择器 — README.md 这种全盘同名文件，弹出候选列表让你点选（工作区内项高亮）
- 📋 支持粘贴文件 — 复制文件后 Ctrl+V 也能插入路径
- 🖼️ 图片不受影响 — 图片拖拽照常走官方流程
- 🔄 批量拖入 — 一次拖多个文件，逐个定位插入，换行分隔
- 👁️ 拖拽视觉反馈 — 拖文件到窗口时显示「松开以插入文件路径」提示条

安装 / 安装

dsh plugin --profile web add https://github.com/Rudyy898/dsh-drag-path

或从市场安装（若已收录）。重启 dsh web，刷新浏览器（⌘⇧R）即可生效。

或在收录后从插件市场安装。重启 dsh web 并强制刷新浏览器（⌘⇧R）。

使用 / 使用

直接从 Finder/资源管理器把文件或文件夹拖到 DSH 页面任意位置：

- 唯一命中 → 绝对路径直接插入输入框：/Users/you/Downloads/project.xlsx
- 同名多候选 → 弹出选择器，点选正确的路径
- 找不到 → 插入文件名（控制台有提示）

将任意文件或文件夹拖到 DSH 页面上：

- 唯一命中 → 插入绝对路径：/Users/you/Downloads/project.xlsx
- 名称冲突 → 弹出选择器列出候选，点击正确的那一个
- 未找到 → 插入文件名（控制台会记录原因）

原理 / 工作原理

浏览器拖拽 / 粘贴文件（File 对象：只有 name/size，没有路径）
│
▼
client capture 阶段拦截（官方 toast 被阻断，蒙版手动复位）
│  POST /api/drag-path/locate { fileName, sizeBytes, sessionId, hintPath }
▼
host 定位：会话工作区优先 → 常见目录 → Home；find 精确匹配 + mdfind 补充
│  就近适配：hintPath 同目录优先；目录直接采用 / 文件按大小校验
▼
唯一命中 → 插入绝对路径；多候选 → 弹选择器；无结果 → 文件名

为什么拿不到路径：浏览器安全沙箱只暴露 File 对象（name/size/type），不提供绝对路径——任何网页插件都无法直接从拖拽事件读取路径。本插件通过 host 端（Node）按文件名+大小在文件系统里定位，绕开了这个限制。

为什么浏览器拿不到路径：网页沙箱只暴露 File（name/size/type）——任何网页插件都无法获得绝对路径。本插件通过 host 端（Node）根据名称 + 大小在文件系统上定位文件。

目录结构 / 结构

dsh-drag-path/
├── package.json          # dsh.bundle + dsh.client 声明
├── cordis.patch.yml      # 插件装载补丁
├── lib/
│   ├── index.js          # host：/api/drag-path/locate 路由
│   ├── locate.js         # find + mdfind 定位逻辑
│   └── client.js         # 浏览器端 capture 拦截 + 候选选择器
└── README.md

平台支持 / Platforms

- 🍎 macOS — find 精确名匹配 + mdfind(Spotlight) 补充
- 🪟 Windows — PowerShell Get-ChildItem 递归 + where 全局；支持中文目录名（下载/桌面/文档）
- 搜索顺序：当前工作区 → 平台常见目录（下载/桌面/文档）→ 全局兜底

配置 / Configuration

无需配置。所有行为开箱即用。

No configuration needed.

许可证 / License

MIT

Made with ❤️ for the DSH community.