前言¶
在 DeepSeek Harness 中，有些模型路由以文字优先为主。如果任务中出现截图、配置图或界面图，就需要把图像交给外部视觉端点分析，再把结果以文本形式带回当前会话。
下面介绍 dsh-vision-bridge。它解决的问题是：在保留现有 Harness 模型列表和选择体验的前提下，让文字优先模型也能处理图像问题。
这是什么¶
dsh-vision-bridge 是一个 DeepSeek Harness 插件，仓库为 gxx182/dsh-vision-bridge，维护者为 GXX182，许可证为 MIT。
它的定位是把图像桥接到外部视觉 API，并只返回文本分析结果。
核心功能¶
下面列出已核实的能力：
- 为文字优先模型路由增加图像理解能力。
- 保留 Harness 模型列表，不重复生成提供者分组。
- 按模型显示眼镜开关；灰色表示桥接偏好关闭，蓝色表示开启。
- 点击眼镜只切换并记住偏好，不改变所选模型；点击模型名称才选择模型并应用偏好。
- 支持 Gemini 原生、OpenAI 兼容 Chat Completions/Responses，以及 Anthropic 兼容 Messages API。
- 视觉提供者返回有界文本分析，图像块不会直接转发给当前上游模型。
- 支持在 Settings 中添加、切换和删除多个隔离的视觉提供者配置。
- 悬停眼镜可查看执行图像理解的视觉提供者和模型。
- 对已声明支持图像输入的模型不显示桥接开关。
- 保留原始 Harness reasoning-effort 菜单。
- 通过
vision_bridge工具读取会话附件或显式 workspace 路径进行视觉分析。
安装前检查¶
先确认环境满足以下条件：
- DeepSeek Harness
0.1.0-rc.5或兼容0.1.x - Node.js
^22.19或>=24 - 上游模型路由支持 Harness tool calls
- 至少一个图像端点 API key
默认 profile 使用 GOOGLE_API_KEY、Gemini native endpoint 和 gemini-3.6-flash。
安装与启用¶
从 GitHub 安装时使用：
dsh plugin --profile web add "github:GXX182/dsh-vision-bridge#semver:*"
如果从源码安装，先构建，再安装到 web profile：
npm install
npm run build
dsh plugin --profile web add .
dsh --profile web --dump-config
dsh --profile web
经过上面的步骤后，可以在 web profile 的模型选择区域看到眼镜控件，并按模型切换桥接偏好。
配置视觉提供者¶
打开：
Settings → Plugins → Plugin configuration → Image understanding
每个提供者配置至少包含：
- 显示名
- HTTPS Base URL
- API 格式
- 凭据
- 已发现的图像模型
在添加、切换和删除多个隔离配置时，凭据应作为提供者配置的一部分管理。API keys 在 Host 端解析，不进入工具结果或浏览器响应。
典型用法¶
1、启用合适模型的眼镜后，点击模型名称选择该模型，再附加图片并提出视觉问题。
2、对 workspace 文件，可以使用类似提示：
Use
vision_bridgeto inspectscreens/settings.png. List the visible controls and validation errors.
3、Code Mode 可以调用：
await tools.vision_bridge(...)
省略图像参数时读取最新附件；也可以使用 attachment_ids 指定会话图像，或使用 image_paths 指定 workspace 文件。
安全与限制¶
需要注意：
- 仅接受 HTTPS provider endpoints。
- Provider requests send image bytes inline；不支持远程图像 URL 和文件/视频上传 API。
- Unknown Base URLs 默认按 OpenAI compatible 处理，除非显式设置
apiFormat。 - 图片内文本被视为不可信证据，不作为指令。
- 插件会强制每图、汇总图像、问题、响应、答案、token 和时间等限制。
该插件以当前 dsh 进程权限运行。安装前应检查源码与许可证；本文基于 MIT 许可证和上述已核实资料说明。
结尾¶
dsh-vision-bridge 的价值在于：不改变 Harness 模型列表，不直接转发图像块，也不把视觉结果混成模型选择变更，而是把图像分析收敛成可审查的文本结果。
社区目录是独立站点，与 DeepSeek 或幻方无官方从属关系，不应把它理解成官方应用商店。GitHub 仓库见：
https://github.com/GXX182/dsh-vision-bridge
目录页地址未在已核实资料中提供，因此不在此处列出。
