
kbpoyo/dsh-image-bridge
50最近提交 2026年8月14日
dsh-image-bridge DSH 插件
本插件允许不支持原生图片输入的纯文本模型处理图片:将图片落盘到会话工作区,以文本标记注入对话,模型自主发现并调用其视觉技能(如通用视觉问答、OCR)来分析图片。多模态模型下自动隐藏桥接按钮,图片原生发送。
如何安装 dsh-image-bridge DSH 插件
dsh plugin --profile web add @kbpoyo/dsh-image-bridge@0.1.0复制不会执行命令。安装 dsh-image-bridge DSH 插件前请核对仓库和版本。
dsh-image-bridge DSH 插件数据来源
dsh-image-bridge DSH 插件快照日期:2026年8月16日
discovered
dsh-image-bridge DSH 插件能做什么
- 一键桥接:粘贴图片后点击「桥接发送图片」按钮发送给纯文本模型。
- 回车兜底:直接回车发送图片也会自动触发桥接。
- 多模态直通:多模态模型下按钮自动隐藏,图片原生直通发送。
- 即时切换感知:切换模型时按钮立即显隐,无闪烁。
- 自动清理:临时图片文件 24 小时自动清理,总大小超过 512MB 时按最旧优先清理。
dsh-image-bridge DSH 插件适合哪些场景
- 用户希望用纯文本模型(如 deepseek-v4-flash)描述图片,无需切换模型。
- 用户在纯文本模型会话中需要 OCR 识别文字,明确要求后模型调用 OCR 技能。
- 开发者测试自定义供应商模型,了解桥接行为与按钮显示逻辑。
- 用户频繁切换多模态与纯文本模型,希望图片处理无缝衔接。
- 管理员希望自动清理会话临时图片,节省磁盘空间。
dsh-image-bridge DSH 插件适合谁
- 需要使用纯文本模型但偶尔处理图片的 DSH 用户(例如出于成本或模型可用性考虑)。
- 配置自定义供应商模型的开发者或高级用户,需了解桥接限制。
dsh-image-bridge DSH 插件的限制
- 自定义供应商模型若未声明 `input: ['text', 'image']`,桥接按钮会始终显示——插件忠实读取适配器上报,无法判定其为视觉模型。
- DSH 原生限制:会话日志包含原生图片后无法切回纯文本模型,需 `/compact` 或新会话。
- 子代理(subagent)的图片消息不在桥接覆盖范围内,仍走原生门禁。
dsh-image-bridge DSH 插件的仓库 README 摘录
以下文字摘自 dsh-image-bridge DSH 插件的上游仓库 kbpoyo/dsh-image-bridge 的 README,版权归原作者,仅作引用。
DSH(DeepSeek Harness)Web 插件:为**不支持原生图片输入**的纯文本模型提供图片桥接能力,让纯文本模型也能"看图"。 纯文本模型无法直接接收图片(DSH 原生会以 `MODEL_DOES_NOT_SUPPORT_IMAGES` 拒绝)。本插件把图片落盘到会话工作区,以文本标记把图片路径与处理指引注入对话,由模型**自主发现并调用**其技能(skill)/工具(tool)目录中的视觉类能力(通用视觉问答 / OCR / grounding)来查看图片。**插件不绑定任何具体技能或工具**——能力发现完全由模型自行完成。 ## 功能 - **一键桥接**:纯文本模型下,输入框粘贴图片后出现「桥接发送图片」按钮,点击即可发送,模型能读到图片。 - **回车兜底**:不点按钮、直接回车发送图片,也会在发送入口自动改写为桥接标记发送,与按钮等效。 - **多模态直通**:多模态模型下按钮自动隐藏、图片原生发送,插件零干预。 - **即时感知**:会话中切换模型,按钮立即显隐,不闪烁、不跳动。 - **自动清理**:桥接产生的临时图片定时自动清理,无需手动管理。 ## 安装 DSH 插件通过 `dsh plugin` 命令安装进 **profile**(`dsh web` 对应 `web` profile)。 ### 方式一:从 npm 安装(推荐) ```sh dsh plugin --profile web add @kbpoyo/dsh-image-bridge@0.1.0 ``` 装完重启 `dsh web` 即可生效。该命令会在 profile 中安装插件并自动挂载为配置层,**无需手动编辑任何配置文件**。 验证:重启后,纯文本模型会话中粘贴图片出现「桥接发送图片」按钮即生效;也可用 `dsh --profile web --dump-config` 确认插件配置层已挂载。 ### 方式二:手动安装(本地调试用) 1. 将本包放置到 DSH profile 的 `node_modules/` 下(如 `~/.dsh/profiles/web/node_modules/@kbpoyo/dsh-image-bridge/`); 2. 在 profile 的 `cordis.patch.yml` 的 `- insert:` 列表追加: ```yaml - id: dsh-image-bridge name: '@kbpoyo/dsh-image-bridge' config: {} ``` 3. 重启 DSH(插件为启动期扫描加载)。 ## 卸载 - **npm 安装的**:`dsh plugin --profile web remove @kbpoyo/dsh-image-br
阅读完整 README仓库许可: MIT
dsh-image-bridge DSH 插件常见问题
粘贴图片后桥接按钮没有出现?
如果当前模型是多模态模型(支持图片),按钮会按设计隐藏。请确认会话模型名称。如果使用自定义供应商模型,需确保适配器声明了 `input: ['text','image']`,否则插件会将其视为纯文本模型并显示按钮。
直接回车发送图片会怎样?
直接回车发送图片也会自动触发桥接,与点击按钮等效。只有桥接失败时(如磁盘不可写)才会回退原生行为并报错。
模型真的能“看到”图片吗?
插件只负责将图片以文本标记送达,模型需要自身具备视觉技能(如通用视觉问答、OCR)才能分析图片。如果模型没有这些技能,它会如实告知。插件不保证所有模型都有视觉能力。
临时图片会一直留在磁盘上吗?
不会。图片存储在隐藏目录 `.dsh-image-bridge/` 中,24 小时自动清理。总大小超过 512MB 时按最旧优先清理。你也可以手动删除该目录,插件会在下次桥接时自动重建。
切换到多模态模型后桥接按钮仍然显示?
这通常是因为模型适配器未上报多模态能力(例如自定义供应商设置)。请在模型声明中添加 `input: ['text','image']`。切换后刷新页面可确保插件检测到变化。