@dsh-external/dsh-vision-bridge：DeepSeek Harness 插件

概览

@dsh-external/dsh-vision-bridge

源码级技术说明DeepSeek Harness vision bridge: session screenshots route by model capability. Image-capable models receive attachments inline; text-only models see the standard placeholder, and the bridge reads the image through a vision-language model — on demand via the vision_bridge_read tool or automatically via agent/pre-step context injection. 会话截图按模型能力自动分流：多模态模型原样直读；纯文本模型经 VLM 代读（tool/auto 双模式）。展开完整技术说明收起技术说明

DeepSeek Harness vision bridge: session screenshots route by model capability. Image-capable models receive attachments inline; text-only models see the standard placeholder, and the bridge reads the image through a vision-language model — on demand via the vision_bridge_read tool or automatically via agent/pre-step context injection. 会话截图按模型能力自动分流：多模态模型原样直读；纯文本模型经 VLM 代读（tool/auto 双模式）。

README / ZH

插件文档

目录摘要

dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。

在 GitHub 阅读完整 README

LIMITATIONS

已知限制

- **运行时缝依赖一个内部方法名**：它装饰的是 `llm.resolveModelInfo`。若未来内核改名，插件会打一行 error 并在体检区显示未生效（不静默），但需要按新内核适配。 - **代读不可用时不放行**：`seam.requireReader`（默认 true）在视觉 provider/凭证未配置时**不注入**，带图消息仍被硬拒绝。这是有意的——宁可明确拒绝，也不制造「消息发出去了但没人看图」。 - **旧机制已随缝让路**（0.3.0 起）：缝自证生效时，磁盘准入自愈与运行时探针都会跳过（探针返回第三态 `skipped`，不再产生 scratch 合成消息）；只有缝不可用/被关闭时，磁盘补丁那条通路才继续工作。 - **磁盘补丁仍是遗留通路**：缝不可用（例如内核改名）而磁盘补丁可用时，体检区仍按磁盘补丁判定，但缝那一行的 ✗ 会被汇总行隐藏——该部署形态今天不存在，登记于 `docs/VERIFY.md` §12 已知偏差。 - **凭证判据有 5 秒缓存**：撤销凭证后最长 5 秒内仍会注入（与「配置可用 ≠ 运行可用」同源）。 - **modlens 用户**：modlens 的粘贴接管与本品设计重叠（同为文本模型读图）。已装 modlens 时请在卡片体检区「一键关闭」其接管（或 profile patch 行 `pasteToPath: false`），否则贴图被它截走。modlens 其余能力（路径/URL 读图、全文 OCR）与本品分工并存。 - **回合取消只覆盖附件读取**：取消时 `readImageRequest`（附件字节读取）即时中止；经引擎 `analyze()` 公开 API 的 VLM HTTP 调用与重试退避**不可取消**（`AnalyzeParams` 不收 signal，包装层无法把信号传入引擎内部的 `adapter.call`，受不改库源码约束）。上游库为 analyze 增加 signal 透传后可根治。 - 8-hex 前缀为 32bit 空间，理论碰撞率低但非零；多命中时返回候选列表。 - **卡片位置随内核代际变化**：0.1.6 在「设置 → 插件」，0.1.7 在「内置插件 → 插件行详情页」的配置区（见上「设置」）。 - **0.1.6 客户端槽面未真机核验**：老代槽服务是否提供声明探测面与等声明面未验；若两者皆无，卡片将不挂载（留一条 warn），而改造前是直接注册老槽位。 - **两个文件先于双代兼容批超 500 行参考线**：`lib/client.js` 1636 行、`lib/index.js` 571 行；拆分（客户端需先验两代 chunk 装载面）登记为后续工作。 - `CHANGELOG.md` — 变更记录（v0.1.0 → v0.2 系列逐版本） - `docs/design.md` — 设计文档（§5 核心 / §10 设置 v1 / §11 卡片 v2 / §12 启动自愈+探针；含偏差记录） - `docs/design-v4-runtime-seam.md` — **运行时服务缝设计 v4.1**（当前生效的准入机制；含评审响应表） - `docs/VERIFY.md` — 人工验收清单（§8 卡片 v1 / §9 卡片 v2 / §10 自愈+探针 / **§12 运行时缝**） - `docs/review-design-v4*.md`、`docs/review-impl-v4*.md` — 四轮独立评审报告（设计 2 轮 + 实现 2 轮） - `docs/HANDOFF-2026-09-26.md` — **本次交付的交接状态**（做了什么 / 未做项 / 如何回退 / 命令备忘） - `vendor/vision-bridge/VENDOR.md` — 引擎库来源与指纹

@dsh-external/dsh-vision-bridge