前言¶
在 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-apiproxy 的 attachment-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_glance、vision_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)。无需额外配置项。
典型用法¶
- 像平时一样粘贴或拖入图片,附件卡片可预览、可移除;
- 拖入或粘贴 PDF、Office、zip、视频、音频等文件,附件栏出现格式方块;
- 输入消息(可选),点击发送——不会发送附件块,图片与文件上传至
.drops/,路径自动追加到消息; - 若已安装 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 的开发者,它减少了「保存 → 手打路径」的重复操作。