kbpoyo/dsh-image-bridge
DSH 插件:让纯文本模型也能看图。Web 端直接粘贴图片即可发送,无需指定图片路径;模型自主调用视觉技能查看,多模态模型原生直通,零skill绑定。
Project Overview项目介绍
This is a native plugin built exclusively for DeepSeek Harness (DSH), designed to add image processing support to pure-text models that don't natively support image input within DSH. The recommended installation method is to run the DSH CLI command dsh plugin --profile web add @kbpoyo/dsh-image-bridge@0.1.0 directly from npm, then restart the running dsh web process to fully activate the plugin. For local development and debugging, users can also manually install the plugin by adding an entry to the cordis.patch.yml file of their DSH web profile, then restart DSH to load it properly.
After installation, the plugin works automatically based on the model type you select in your current DSH session. When you select a pure-text model, pasting or dragging an image into the input box will bring up a "Bridge Send Image" button, and even if you hit enter directly without clicking the button, the plugin will automatically rewrite the message to add the required bridge marker. When you switch to a multimodal model, the button hides automatically, and the plugin doesn't interfere with DSH's native image sending flow at all. This plugin is ideal for DSH users who need to process images with pure-text models that lack native image support.
The plugin is released under the permissive MIT open source license, and it has a few known limitations that users should be aware of before use. It does not support image bridging for messages sent from a parent agent to a subagent, since those messages don't go through the session.prompt entry that the plugin hooks into. It also can't bypass DSH's native restriction that prevents switching back to a pure-text model after a session has native images, so users need to compact the session or start a new one in that case. Temporary images are automatically cleaned up every 6 hours, with a 24 hour TTL and a 512MB total size limit to avoid filling up local disk space.
这是专为 DeepSeek Harness(DSH)开发的原生 Web 插件,核心作用是为 DSH 中不支持原生图片输入的纯文本大模型提供图片桥接能力,解决 DSH 原生会因纯文本模型不支持图片直接拒绝请求的问题。插件将传入图片存入会话工作区,把图片路径和处理指引以文本标记形式注入对话,由模型自主调用自身技能目录中的视觉类能力处理图片,插件本身不绑定任何具体视觉技能。
用户使用时只需在纯文本模型会话中粘贴或拖入图片,点击弹出的「桥接发送图片」按钮即可发送,就算不点按钮直接回车发送图片,也会自动触发桥接改写逻辑。切换到多模态模型后,按钮会自动隐藏,完全不干预原生图片发送流程,桥接产生的临时图片还会定时自动清理,无需用户手动管理。适合有需要用纯文本模型处理图片需求的 DSH 用户使用。
插件采用 MIT 许可证开源,支持通过 DSH 的 dsh plugin 命令一键从 npm 安装到 web profile,安装后重启 dsh web 即可生效,也支持手动本地调试安装。插件存在少量已知限制,比如不覆盖子代理传图场景,不会绕过 DSH 原生的会话模型切换限制,自定义模型需要正确配置能力上报才能正常显隐按钮。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-image-bridge(kbpoyo/dsh-image-bridge)
仓库:https://github.com/kbpoyo/dsh-image-bridge
本站详情页:https://www.yhbd.top/plugins/kbpoyo-dsh-image-bridge/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 5 · 最近提交 2026-08-14 · 主语言 JavaScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项
Compatibility兼容性
- DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
- External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
- Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册
Security安全性
- Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
- Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
- curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
- Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
- Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
- Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式
Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。
Or use CLI install (for developers)或使用命令行安装(适合开发者)
CLI Install命令行安装
dsh plugin --profile web add @kbpoyo/dsh-image-bridge@0.1.0
把 kbpoyo/dsh-image-bridge 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
dsh-image-bridge
DSH(DeepSeek Harness)Web 插件:为不支持原生图片输入的纯文本模型提供图片桥接能力,让纯文本模型也能"看图"。
纯文本模型无法直接接收图片(DSH 原生会以 MODEL_DOES_NOT_SUPPORT_IMAGES 拒绝)。本插件把图片落盘到会话工作区,以文本标记把图片路径与处理指引注入对话,由模型自主发现并调用其技能(skill)/工具(tool)目录中的视觉类能力(通用视觉问答 / OCR / grounding)来查看图片。插件不绑定任何具体技能或工具——能力发现完全由模型自行完成。
功能
- 一键桥接:纯文本模型下,输入框粘贴图片后出现「桥接发送图片」按钮,点击即可发送,模型能读到图片。
- 回车兜底:不点按钮、直接回车发送图片,也会在发送入口自动改写为桥接标记发送,与按钮等效。
- 多模态直通:多模态模型下按钮自动隐藏、图片原生发送,插件零干预。
- 即时感知:会话中切换模型,按钮立即显隐,不闪烁、不跳动。
- 自动清理:桥接产生的临时图片定时自动清理,无需手动管理。
安装
DSH 插件通过 dsh plugin 命令安装进 profile(dsh web 对应 web profile)。
方式一:从 npm 安装(推荐)
dsh plugin --profile web add @kbpoyo/dsh-image-bridge@0.1.0
装完重启 dsh web 即可生效。该命令会在 profile 中安装插件并自动挂载为配置层,无需手动编辑任何配置文件。
验证:重启后,纯文本模型会话中粘贴图片出现「桥接发送图片」按钮即生效;也可用 dsh --profile web --dump-config 确认插件配置层已挂载。
方式二:手动安装(本地调试用)
- 将本包放置到 DSH profile 的
node_modules/下(如~/.dsh/profiles/web/node_modules/@kbpoyo/dsh-image-bridge/); - 在 profile 的
cordis.patch.yml的- insert:列表追加:
- id: dsh-image-bridge
name: '@kbpoyo/dsh-image-bridge'
config: {}
- 重启 DSH(插件为启动期扫描加载)。
卸载
- npm 安装的:
dsh plugin --profile web remove @kbpoyo/dsh-image-bridge,然后重启dsh web。 - 手动安装的:删除
node_modules/@kbpoyo/dsh-image-bridge/目录,并移除cordis.patch.yml中对应的@kbpoyo/dsh-image-bridge行,然后重启。
使用说明
- 在会话中选择纯文本模型(如 deepseek-v4-flash);
- 粘贴或拖入图片,点击「桥接发送图片」按钮发送(直接回车发送也会自动桥接);
- 模型会自主调用其视觉类技能/工具(通用视觉问答 / OCR / grounding)查看图片并回答,无需你手动指定工具;
- 需要 OCR 时请在提问中明确说明(如「识别图中文字」),否则默认走通用视觉问答;
- 切换到多模态模型(如 mimo-v2.5)后按钮自动消失,图片原生直通。
工作原理
- 落盘:图片写入会话工作区的隐藏目录
<cwd>/.dsh-image-bridge/(点号开头,常规文件管理器不显示;文件名img-<时间戳>-<序号>.<ext>),发送前校验attachments.imageLimits(数量 / 类型 / 单张与总大小)。 - 文本化注入:原生图片被替换为三段文本标记:
[图片附件](路径 / 尺寸 / 类型)+[用户提问]+[处理指引](默认优先通用视觉问答,OCR 仅在用户明确要求或文字不清晰时使用)。 - 发送入口自动改写:宿主侧包装
session.prompt,纯文本模型下含图消息在原生门禁(MODEL_DOES_NOT_SUPPORT_IMAGES)之前改写为桥接标记;多模态模型直通;改写失败(如桥接目录不可写)回退原生行为,与按钮流程等效。 - 零技能绑定:插件不调用、不绑定任何具体技能/工具,由模型从自身目录自主发现视觉能力。
- 能力判定与切换感知:判定来源为客户端上报当前模型(与官方模型选择器同通路,最新鲜)→ 会话最近一次请求 → 默认模型;模型切换由事件驱动即时感知(订阅官方模型目录 store),另有图片挂载期间每 1s 的兜底轮询覆盖事件漏网场景(如跨标签页切换)。
- 自动清理:TTL 24 小时;总大小超过 512MB 时按最旧优先清理;每 6 小时巡检,插件卸载时清理超龄文件。
Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →
liustack/modlens
Alisa0808/vox-director
Anionex/agent-vision-toolkit
Anionex/dsh-vision-toolkit
shanliuling/dsh-image-gen
Clarklevis1995/dsh-mobile
zhaoolee/notes
ZSeven-W/dsh-crew