前言¶
在 DSH WebUI 中,拖入图片通常会作为 base64 附件发送。若当前会话使用的是纯文本模型,图片附件可能无法进入对话。cesaryike/dsh-image-to-path 是一个 DSH 插件,用于改变这个流程:它接管拖放/粘贴图片的动作,把图片保存到当前会话工作区,再把文件路径作为文本插入输入框,让纯文本模型也能拿到可传给工具的引用。
DSH 插件生态强调可扩展,这个插件由社区成员维护,许可证为 MIT。
这是什么¶
该插件面向 DSH Web Profile,解决“纯文本模型无法直接处理图片附件”的使用问题。它不改变多模态模型的原生图片通道,而是为纯文本模型提供路径化方案。
维护者为 cesaryike。README 中还列出了 DeepSeek AI(DSH agent)参与核心工程实现与修复。
核心功能¶
- 支持拖入或粘贴图片,并将图片保存到当前会话工作区。
- 以文件路径文本插入输入框,模型可以把路径交给任何工具处理。
- 自动检测当前模型能力:支持图片的模型走原生附件通道;纯文本模型走路径方案。
- 内容寻址去重,避免同一张图片重复落盘;工作区已有的图片直接原位引用。
- 上传过程包含图片魔数校验、服务端命名、原子写、10 MiB 上限和同源校验,无远程请求。
安装与启用¶
从 GitHub 安装时,使用以下命令:
dsh plugin --profile web add github:cesaryike/dsh-image-to-path
安装后重启 Web Profile 生效。
典型用法¶
1、在 DSH WebUI 中拖入或粘贴一张图片。
2、图片会保存到当前会话工作区的 dsh-image-to-path-uploads/ 目录。
3、输入框出现文件名芯片;发送时,模型收到完整路径。
4、上传目录可随时手动清理,不影响插件运行。
配置¶
可通过 profile 的 cordis.patch.yml,按行 id image-to-path 覆盖配置。
| 字段 | 默认 | 说明 |
|---|---|---|
subdir |
dsh-image-to-path-uploads |
保存子目录 |
maxImageBytes |
10485760 |
单图上限(10 MiB) |
interceptUnknownModels |
false |
未声明能力的模型是否按纯文本拦截 |
关于 interceptUnknownModels:默认关闭。开启后,对未声明能力的模型按纯文本拦截;但 provider 未注册或能力查询失败时仍 fail-open 并记录警告。
适用场景与注意¶
适合在 DSH Web Profile 中使用纯文本模型、但仍希望把图片以路径形式交给后续工具处理的场景。若当前模型本身支持图片,插件会走原生附件通道,不影响既有图片能力。
安装前建议先检查源码与 MIT 许可证。插件安装后会随 DSH Web Profile 运行,并以当前 dsh 进程权限处理拖入/粘贴的图片数据。
链接¶
仓库地址:cesaryike/dsh-image-to-path
目录页线索给出的地址为 skillhub.cn 插件页,该地址来自插件线索,访问前以实际站点内容为准。