前言¶
如果你在 DSH（DeepSeek Harness）里使用一个仅处理文本的 DeepSeek 主智能体，常见的麻烦是：聊天入口里想直接处理图片，又不希望绕开官方 DeepSeek adapter 的主会话逻辑。
dsh-deepseek-vision-router 就是针对这个场景的 DSH 插件。它先把图片送到已配置的视觉模型生成文字描述，再把描述交给 DeepSeek，同时让官方 DeepSeek adapter 继续负责主会话、推理、流式、工具和重试。下面介绍它的定位、能力、安装方式和使用路径。
这是什么¶
dsh-deepseek-vision-router 是 mochgolf 维护的 DSH 插件，定位是 Transparent image preprocessing route for DeepSeek Harness。
它解决的问题可以概括为：让 text-only 的 DeepSeek 主智能体从 DSH chat composer 直接接收图片，并通过一条单独的 deepseek-vision route 把图片转成文字描述，再进入 DeepSeek。
这不是原生多模态替代方案，而是一条图像预处理桥接路径。
核心功能¶
- 让 text-only 的 DeepSeek 主智能体直接从 DSH chat composer 接收图片。
- 新增单独的
deepseek-visionroute。 - 图片分析通过 DSH
Settings → Models中已有 provider 完成。 - 官方 DeepSeek adapter 继续负责主会话、reasoning、streaming、tools 和 retries。
- 插件只保存
visionProvider和visionModel到 DSH 的 native settings namespace。 - 配置变更对下一次图片请求生效，不需要重启。
- 支持在 DSH model menu 中选择
DeepSeek + Vision。 - 成功的图像描述使用 bounded、process-local cache。
- 描述在进入 DeepSeek 前会被标记为 untrusted image content。
- 插件不复制、不保存 provider endpoint 或 credential。
- 图片字节发送给配置的 vision provider；DeepSeek 收到的是结果文本描述，而不是像素。
安装与启用¶
先确认版本。已核实资料给出的兼容项是：
- DSH
0.1.0-rc.6 - Node.js
24+ mcp-vision-bridge0.2.7
其他版本可能可用，但资料说明未进行测试。
安装命令如下：
dsh plugin --profile web add github:mochgolf/dsh-deepseek-vision-router
执行后，在 DSH 的设置页配置视觉 provider 和 vision model，再在模型菜单中选择 DeepSeek + Vision。
典型用法¶
1、打开 Settings → Models，新增或复用一个 image-capable provider。
这一步只复用 DSH 已有的模型设置，不改变 provider 的管理方式。
2、打开 Settings → Plugins → DeepSeek Vision，选择刚才的 provider，并保存 vision model。
插件只保存两个设置项：
visionProvider
visionModel
3、填写 vision model。
vision model 字段默认是 mimo-v2.5，也可以填写所选 provider 暴露的任意 model ID。
4、在 DSH model menu 中选择 DeepSeek + Vision。
新会话可以将它作为 default provider；已存在会话会保留其 recorded provider，直到手动切换。
5、保存配置后，直接发送图片。
变更会在下一次图片请求时生效，不需要重启 DSH。
适用场景与注意¶
适合谁¶
- 你的 DSH 主智能体是 text-only 的 DeepSeek。
- 你已经在
Settings → Models中有可用的视觉 provider。 - 你希望图片先被描述成文本，再交给 DeepSeek 处理。
- 你希望官方 DeepSeek adapter 继续管理主会话、工具调用和重试逻辑。
注意¶
- 这是 preprocessing bridge，不是 native DeepSeek multimodality。
- 缓存是 bounded、process-local cache，不会在 DSH 重启后保留。
- 分析 prompt 来自
mcp-vision-bridge内部模块；上游目录变化可能需要同步做兼容处理。 - 图片会发送给配置好的 vision provider；DeepSeek 收到的是文本描述，不是像素。
- provider endpoint 和 credential 仍由 DSH
Settings → Models管理，插件只保存visionProvider与visionModel。 - 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- 已核实资料未显示许可证文本。
结尾¶
dsh-deepseek-vision-router 的价值在于把“图片进入 DeepSeek 文本主智能体”变成一条可控的 DSH 路由：官方 adapter 仍管理主对话，视觉分析走已配置 provider，插件只保存少量设置项。
GitHub 仓库：https://github.com/mochgolf/dsh-deepseek-vision-router
目录页地址：已核实资料未提供。
