本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-image-bridge

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @kbpoyo/dsh-image-bridge

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 一键桥接：纯文本模型下，输入框粘贴图片后出现「桥接发送图片」按钮，点击即可发送，模型能读到图片。
• 回车兜底：不点按钮、直接回车发送图片，也会在发送入口自动改写为桥接标记发送，与按钮等效。
• 多模态直通：多模态模型下按钮自动隐藏、图片原生发送，插件零干预。
• 即时感知：会话中切换模型，按钮立即显隐，不闪烁、不跳动。
• 自动清理：桥接产生的临时图片定时自动清理，无需手动管理。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

装好之后必须先配置什么吗？

不需要。cordis.patch.yml 中 config 默认为空，npm 安装后重启 dsh web 即可生效；纯文本模型会话里粘贴图片会出现「桥接发送图片」按钮（cordis.patch.yml:1-5 / README.md:25-27）。

哪些图片格式和大小可以桥接？

跟随 attachments.imageLimits：支持 PNG / JPEG / WebP / GIF（其余类型回退为 .png），单张与总大小上限、单消息图片数均由宿主配置决定；按钮在 onClick 时按 limits 做完整校验（lib/index.js:35-43 / lib/index.js:214-236）。

桥接产生的临时图片存在哪里？会一直留在磁盘上吗？

落到当前会话工作区下的隐藏目录 <cwd>/.dsh-image-bridge/（点号开头，常规文件管理器不显示）；超过 24 小时或目录总大小超过 512 MB 时由插件按最旧优先清理，插件卸载时也会清理（lib/index.js:27-28 / lib/index.js:76-100 / README.md:76-79）。

切换到多模态模型后按钮会消失吗？

会。客户端订阅官方模型目录 store（事件驱动）并叠加 1 秒兜底轮询，切换瞬间按钮立即隐藏；多模态模型下图片直接走原生发送，插件不干预（lib/client.js:131-151 / README.md:12）。

桥接模型真的能"看到"图片吗？需要自己选视觉工具吗？

取决于模型自身目录里是否有视觉/OCR/grounding 类工具——插件只负责把图片送达并在文本标记里写明「先查看当前可用技能与工具再调用」。你不需要指定工具；如果模型目录里没有视觉能力，模型会如实告知（lib/index.js:151-159 / README.md:73）。

自定义供应商的纯文本模型下按钮一直显示怎么办？

适配器只在其模型声明含 input: ['text','image'] 时才会上报为多模态；自定义模型未声明 input 时一律上报为纯文本，插件忠实读取。要让按钮隐藏，需要在模型声明里补 input 字段或改用适配器托管目录（README.md:79-89）。

发送图片后能切回纯文本模型吗？

不能，这是 DSH 原生限制（会话日志含原生图片后禁止切回），需要 /compact 或开新会话；本插件不绕过此限制（README.md:81-82）。

父代理向子代理发图的桥接覆盖吗？

不覆盖。父代理向子代理发送的含图消息不经 session.prompt，仍走原生门禁 MODEL_DOES_NOT_SUPPORT_IMAGES（README.md:91 / lib/index.js:300-305）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.6
• Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则