dsh-drop-to-path:把图片与文件以工作区路径交给纯文本模型

前言

在 DeepSeek Harness(DSH)里用纯文本模型(例如 deepseek)时,常见做法是截图后手动保存到工作区,再把路径敲进对话。DSH 原生的图片附件会走模型侧的多模态通道;纯文本模型在发送前会被 attachment-error 预检拦截,Composer 会提示「The current model does not support images; switch to a model that supports images.」

PDF、Office、压缩包、视频、音频等非图片文件,DSH 本身也不接受作为附件。社区里已有 dsh-drag-and-drop 等插件,但拖拽时插入的是已有文件的原始路径,不做复制,图片仍按附件发送,粘贴也不支持。

下面介绍 dsh-drop-to-path(维护者 loudMore,SkillHub 分类:模型推理)。它保留 DSH 原生附件 UI,在点击发送时才把图片和文件转为工作区路径,让纯文本模型通过 vision / 文档工具读取内容。配合 dsh-vision-toolkit 时,粘贴截图即可看图,无需手打路径。

这是什么

dsh-drop-to-path 是 DSH Web profile 插件(@dsh-external/dsh-drop-to-path,版本 0.1.0,MIT 许可证)。定位一句话:拖入或粘贴图片与各类文件,发送时自动上传至工作区并追加路径到消息正文,模型只收到纯文本,不触发图片附件预检。

GitHub 仓库:https://github.com/loudMore/dsh-drop-to-path
社区目录页:https://www.skillhub.cn/plugins/loudMore/dsh-drop-to-path

核心功能

绕过纯文本模型的图片预检

插件不向模型发送图片附件块,发送前把图片上传到 <workspace>/.drops/,路径追加到消息末尾。因此不会触发 dsh-host-apiproxyattachment-error 预检。

保留原生附件体验

  • 图片png / jpg / jpeg / webp / gif,上限 30MB):仍显示原生附件卡片,可预览、可移除。
  • 其他文件(文档、压缩包、视频、音频,上限 100MB):在附件栏显示带格式图标的方块 chip,悬停可见完整文件名,点 ✕ 可移除。

添加文件时 Composer 里不会出现路径文字;路径仅在点击发送时追加。

支持的文件类型

类型 扩展名 大小上限
图片 png jpg jpeg webp gif 30MB
文档 pdf doc docx xls xlsx ppt pptx txt md csv json 100MB
压缩包 zip 100MB
视频 mp4 mov webm mkv avi 100MB
音频 mp3 wav flac m4a 100MB

支持粘贴与拖拽,图片、文件及混合批次按顺序上传,最终合并为一段路径文本发送。上传失败会显示可见提示,不会静默吞掉消息。

与 dsh-vision-toolkit 配合

dsh-vision-toolkit 提供 vision_glancevision_pixel_diff 等 vision 工具,但工具入参是工作区文件路径。本插件负责「附件 → 路径」,vision-toolkit 负责「路径 → 看图 / OCR / 像素对比」。README 建议两者一起安装。

安装与启用

环境要求:DeepSeek Harness(Web profile)、Node.js、dsh CLI。

推荐通过 dsh plugin 安装:

dsh plugin --profile web add /path/to/dsh-drop-to-path

也可手动写入 package.json 依赖、dsh.profile.bundles,并将目录复制到 profiles/<name>/node_modules/@dsh-external/dsh-drop-to-path,详见仓库 README。

安装后需重启 Web profile(重新启动 launcher 或重启 dsh web)。无需额外配置项。

典型用法

  1. 像平时一样粘贴或拖入图片,附件卡片可预览、可移除;
  2. 拖入或粘贴 PDF、Office、zip、视频、音频等文件,附件栏出现格式方块;
  3. 输入消息(可选),点击发送——不会发送附件块,图片与文件上传至 .drops/,路径自动追加到消息;
  4. 若已安装 dsh-vision-toolkit,Agent 可通过 vision 工具读图,通过 PDF / 表格工具处理文档。

文件存放在 <workspace>/.drops/,可按需自行清理。

适用场景与注意

适合谁

  • 在 DSH 里使用纯文本模型,但需要频繁发送截图、PDF、表格、视频等;
  • 已安装或计划安装 dsh-vision-toolkit,希望实现「粘贴即看图」;
  • 需要比 dsh-drag-and-drop 更完整的粘贴 + 自动复制 + 非图片文件支持。

与 dsh-drag-and-drop 的区别

dsh-drag-and-drop 适合引用工作区里已有的文件路径;本插件适合发送新截图和新文件,并自动复制到工作区。两者可互补使用。

安全提示

插件以当前 DSH 进程权限运行,会向工作区写入文件。安装前请阅读源码与 MIT 许可证,确认行为符合预期。SkillHub 为独立社区目录,与 DeepSeek / 幻方无官方从属关系。

结尾

dsh-drop-to-path 把 DSH 原生附件 UI 与纯文本模型的路径式工具链衔接起来:图片保留预览体验,其他文件以方块 chip 展示,发送时统一转为工作区路径。对依赖 dsh-vision-toolkit 的开发者,它减少了「保存 → 手打路径」的重复操作。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜