dannyvan/dsh-file-drop
拖拽/点击上传任意非图片文件(PDF/Word/Excel/ZIP/文本)到输入框:桌面壳下直取 Finder 原始路径;无壳时上传到工作区并插入路径。
已收录
3
Ui
Bundle 已验证
功能介绍
拖拽/点击上传任意非图片文件(PDF/Word/Excel/ZIP/文本)到输入框:桌面壳下直取 Finder 原始路径;无壳时上传到工作区并插入路径。
适合
- 需要直接从输入框附加 PDF、Office 文件、压缩包、文本或其他非图片文件的 DSH 用户。
- 希望把 Finder 拖入文件直接解析为本地原始路径、无需上传的桌面壳用户。
- 可接受在浏览器中把文件上传到对话工作区作为兜底的用户。
- 需要多选文件或从窗口任意位置拖放文件的工作流。
不适合
- 图片附件工作流;该插件明确面向非图片文件。
- 浏览器兜底上传中单个文件超过 25 MB 的场景。
- 无权读取工作区外桌面原始路径的沙箱智能体。
README
dsh-file-drop · 拖拽上传任意文件
DeepSeek Harness 持久插件:支持拖拽 / 点击上传非图片文件(PDF / Word / Excel / ZIP / 文本等),把文件路径直接写入输入框草稿,agent 即可读取。
工作方式(三个入口共用一套逻辑)
| 入口 | 行为 |
|---|---|
| 拖拽到窗口任意位置 | 全屏高亮浮层 → 松手 → 获取文件 |
| 回形针按钮(输入框工具行左侧,28px 圆形原生风格) | 点击弹系统文件选择器(多选) |
| hover 气泡 | 「点击选择文件 · 也可把文件拖到窗口任意位置」,1.5s 自动消失,每次 hover 循环 |
处理顺序(按可用性优先):
-
桌面壳直取原始路径(Electron 壳
window.dshDesktop,webUtils.getPathForFile)—— 零上传,拿到 Finder 里的真实路径; -
拖拽自带路径(
text/uri-list,如 Obsidian 拖笔记); -
上传兜底(浏览器/无壳时)——
POST /api/dsh-file-drop保存到<会话工作区>/.dsh-drops/,返回工作区路径。
拖拽监听挂在 window 捕获阶段,先于 DSH 自带的 document 级图片拖拽处理拦截(stopPropagation),不会触发「不支持非图片格式」报错。
限制
- 单文件 ≤ 25MB(上传兜底路径;壳直取路径不受限)
- 文本类(md/txt/json/代码等)按文本直写;二进制(PDF/Word/Excel/ZIP 等)经 base64 解码写真实字节
- 壳直取路径指向工作区外文件时,agent 读取需要沙箱放行(workspace-write 模式下需权限配置)
文件结构
index.js Host half:POST /api/dsh-file-drop 保存路由(node fs 原生能力)
client.js Client half:回形针按钮 + 拖拽监听 + 状态徽标(__ModuleLoader__ 格式)
cordis.patch.yml 组合行(inject: webServer, sessions)
dsh.plugin.json 插件清单
安装(已安装,仅备查)
dsh plugin --profile web add "link:/Users/fanxiaokang/dsh-file-drop"
# 重启 dsh web 生效
配套桌面壳(可选,推荐)
~/dsh-desktop/:Electron 壳,npm start 启动。自动复用/拉起 dsh web(127.0.0.1:3080),
preload 注入 window.dshDesktop(getPathForFile + drainDroppedPaths),使拖拽直取 Finder 原始路径。
视觉引擎基准(modlens,2026-08 实测)
DSH 的 modlens_read_image 走 modlens 视觉桥;单次分析为一次结构化输出(summary/OCR/版面/语义/视觉/不确定项)。
| 引擎 | 完整流程耗时 | 结论 |
|---|---|---|
| 智谱 glm-4v-flash(国内直连,免费) | ~3.7s | ✅ 当前配置,最优 |
| 智谱 glm-4.6v | ~17s | ❌ 慢 4.6 倍 |
| 智谱 glm-4.5v | 失败 | ❌ 不返回符合 schema 的 JSON |
| Gemini 免费 key(海外) | 429 额度用尽 / 兜底 codex-cli ~14s | ❌ |
配置位置:~/.modlens/config.json(providers.openai → baseUrl=https://open.bigmodel.cn/api/paas/v4,model=glm-4v-flash)。
端到端等待(贴图→回复)≈ 读图 3.7s + 模型回复生成时间,后者通常是主要部分。
常见问题常见问题
在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:dannyvan/dsh-file-drop。命令会解析公开 package 元数据,并保持插件与本页展示的目录身份一致。
兼容性以页面上展示的 bundle 与 profile 状态为准。如果某个 profile 尚未检测到,请先保持禁用,并在生产启用前阅读仓库文档。
GitHub 链接和 activity 元数据是 release 与维护状态的来源。新版本发布后重新查看本页,确认目录已经观察到最新版本。