前言¶
DeepSeek Harness (DSH) 的核心设计理念之一是「一切皆插件」。当主模型(如 deepseek-v4-flash)缺乏原生视觉输入能力时,需要通过插件桥接视觉模型。mimo-vision 旨在解决这一需求,为不具备视觉能力的主模型提供文本描述能力。
它是什么¶
mimo-vision 是一个为 DeepSeek Harness (DSH) 设计的原生插件,包名为 mimo-vision。它不是一个独立进程,而是 DSH 能力模型中的“一等公民”,利用 DSH 的基础设施来管理依赖、文件、凭证和子进程。
核心功能¶
- 工具注册: 注册
describe_image工具,供主模型调用。 - 视觉桥接: 将图片发送至 mimo-v2.5 系列多模态模型,将视觉信息转换为文本描述。
- 格式转码: 支持转码多种图片格式(SVG, TIFF, HEIC 等),确保视觉模型能正确解析。
- 路由策略: 支持路由至免费或付费 API,默认优先使用免费路由,失败后回退至付费路由。
安装与启用¶
前置条件:Node.js 版本需为 ^22.19 或 >=24,且 DSH 已能正常启动。
安装插件:
dsh plugin --profile web add mimo-vision
典型用法¶
使用 describe_image 工具描述图片。工具参数为 path(必填)和 question(可选)。
示例:
1. 告诉模型:“use describe_image to describe D:\photos\cat.png, focusing on what breed of cat it is”。
2. 模型会调用 describe_image 工具,获取猫咪品种的文本描述。
注意事项¶
- 运行机制: 插件不是独立进程,所有依赖、文件、凭证和子进程均通过 DSH 定义的
seams运行。 - 凭证配置: 需配置 OpenCode API Key。Key 的解析顺序为
OPENCODE_GO_API_KEY->OPENCODE_API_KEY。 - 卸载: 使用
dsh plugin --profile web remove mimo-vision移除,这会同时清理依赖和 bundle 层。
结语¶
mimo-vision 通过原生插件的方式,为 DSH 提供了轻量级的视觉能力。它利用 DSH 的基础设施处理文件和凭证,适合需要为不具备视觉能力的主模型增加描述能力的场景。