dsh-vision-tool
dsh 插件：视觉能力代理。将仅支持文本的主模型的图像理解请求路由到小型多模态模型；当活动模型声明支持多模态（inputModalities 包含 'image'）时，则完全退出。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:YJLTF/dsh-vision-tool#952abad48dba2dbe8a18bd08a44163798099cc3fVision Tool 以 dsh-vision-tool 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一个 DeepSeek Harness 插件：为纯文本主模型补上识图能力。它把图片理解委托给你配置的一个小参数多模态模型，再把结果以文本形式交还给主模型；当活跃模型自身支持图片输入时，插件完全退避，原生多模态体验不受任何影响。
DeepSeek Harness 的引擎依据模型声明的 inputModalities 做字节投影：路由不含 image 的模型（纯文本模型）永远收不到图片字节——用户贴进会话的截图，纯文本主模型是"看不见"的。此外，宿主在消息准入时会把带图消息对纯文本模型整条拒绝（MODEL_DOES_NOT_SUPPORT_IMAGES），文本模型连消息都收不到。本插件不碰请求消息改写，补上三条补偿路径：
llm.resolveModelInfo 服务方法，见下文实现说明），让贴图消息进入纯文本模型的会话；引擎仍按适配器真实元数据把图片字节投影为文本占位符，不会把图片字节发给文本模型。understand_image / list_conversation_images 工具——understand_image 不带 path 时自动检查会话中最近的一张图（正是"刚贴图"的典型场景），带 path 则读取指定文件；经 ctx.attachments.saveImages 入库 → ctx.llm.stream 向配置好的小参数多模态模型发起一次多模态请求 → 把回答以文本块返回，主模型据此继续推理。list_conversation_images 列出会话中出现过的全部图片供挑选。[image omitted because this model accepts text only; …] 占位符就意味着图片可用 understand_image 检查，且 prompt 必须是从当前任务和对话中提炼出的具体问题，而不是笼统的"描述这张图"。overrides > 适配器声明的 inputModalities（ctx.llm.resolveModelInfo，按 provider/model 路由缓存一次）> 保守默认（视作纯文本，与引擎投影行为一致）。判定为多模态的模型不注入任何指导；resolveModelInfo 尚未返回的该路由首轮会话按保守默认处理，此后按缓存判定。understand_image（不带 path），无需用户指明文件路径。prompt、不做"笼统描述"兜底；视觉模型系统提示要求"精确完整描述 + 逐字转录可见文本"。setSource），无需重启会话。remote.session.modelCatalog() 读取 dsh 的 Host 代模型目录，visionProvider / visionModel 直接从 dsh 已配置的模型里选，不建立第二套模型注册表；目录不可用时降级为手动输入。guidanceInjection 可单独关闭系统提示指导，只保留工具本身。在目标 dsh 环境里执行（<profile> 换成你的 profile 名）：
dsh plugin --profile <profile> add github:YJLTF/dsh-vision-tool
与 dsh 官方打包安装文档一致，有三点注意：
prepare 脚本构建出 lib/index.js。pnpm ≥ 10 默认拒绝为 git 依赖运行 prepare，首次 add 会失败——按 dsh 的提示，在 profile 的 pnpm-workspace.yaml 里放行后重试：
allowBuilds:
dsh-vision-tool: true
dsh plugin --profile <profile> add github:YJLTF/dsh-vision-tool#<commit-sha>
dsh.bundle（cordis.patch.yml + 挂载清单），dsh plugin add 安装后会自动作为 profile 层激活，无需手工改 patch 文件；若安装时日志出现 declares no dsh.bundle — installed as a plain dependency 警告，说明装到的是旧版本，请更新后重装。git clone https://github.com/YJLTF/dsh-vision-tool
cd dsh-vision-tool
pnpm install
pnpm build # tsdown（lib/index.js）+ tsc --emitDeclarationOnly（lib/types）+ 客户端 bundle（lib/client.js）
pnpm typecheck # Host 类型检查（typecheck:client 为浏览器半侧）
然后在 dsh 的 profile（例如 cordis.patch.yml）中以挂载任意树外插件 bundle 的方式挂载 lib/index.js。
两种方式产出的 Host 半侧完全相同；客户端 bundle（
lib/client.js）由scripts/build-client.mjs在本仓库内独立构建，随pnpm build/prepare一并产出。
settings → 命名空间 vision）| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
enabled | boolean | true | 总开关。关闭后指导不注入，两个识图工具都会拒绝执行。 |
visionProvider | string | '' | 小参数多模态模型的提供方路由（从 dsh 已配置模型中选）。 |
visionModel | string | '' | 小参数多模态模型的精确模型 id。 |
visionSystemPrompt | string | 内置 | 视觉模型每次调用遵循的系统提示词。 |
maxTokens | number | 2048 | 视觉调用最大输出 token 数（256–8192）。 |
guidanceInjection | boolean | true | 是否为纯文本模型注入识图指导。 |
overrides | {model, modality}[] | [] | 按模型显式声明模态；优先级高于适配器元数据（退避依据）。 |
推荐在 dsh web 端顶部 「插件」按钮 → 插件管理 → 已安装 → vision-tool 详情页的 "识图代理" 卡片中配置：卡片为暂存式编辑——改动后点 保存 一次写回（立即生效、无需重启），放弃 丢弃草稿。识图模型从下拉里选（列表即 dsh 已配置的全部模型，可用"刷新列表"重读），下方文本框同步显示当前选择；overrides 声明也可在卡片里增删。最小可用配置就是 provider / model 两项——任一为空时，understand_image 会报错提示"未配置视觉模型"，指导也不会注入。
必须的前置条件：所选的视觉模型要在 dsh 的模型配置（settings.yaml 的 provider models 列表）里声明图片输入能力，否则引擎会把发往视觉模型的请求中的图片字节一并投影掉——视觉模型只会看到一个 sha256: 占位符，无法真正识图：
llm-pi-ai:
providers:
<provider>:
models:
- id: <vision-model>
input: [text, image] # 关键：声明后引擎才放行图片字节
同理，overrides 中把某个模型标记为 image 也能达到同样效果（并触发本插件对该模型退避）。
配置完成后，在会话里直接贴图提问即可：纯文本主模型收到的图片是一个文本占位符，系统提示中的指导会告诉它占位符背后的图片可以检查——它会自主调用：
{ "prompt": "结合当前任务与对话的具体问题" }
（省略 path 时检查会话中最近的一张图；多图场景模型可先调 list_conversation_images 挑选。）工具返回视觉模型的文本回答，主模型据此继续推理。若你的主模型本身支持图片输入，装不装这个插件没有区别——准入不拦、指导不注入、消息不改写。
Host 半侧兼容 dsh 0.1.5-rc.2、0.1.6-alpha.1 与 0.1.6-alpha.2（peer 范围 ^0.1.6-alpha.1，基线 >=0.1.5-rc.2 <0.2.0，@deepseek-ai/cordis ^4.0.1）；0.1.6-alpha.2 起适配器声明的 inputModalities 才接入 resolveModelInfo，更早版本的适配器退避只认用户 overrides。Web 配置卡片基于插件管理页的 plugins.bundle.config 插槽，要求 dsh 0.1.6-alpha.2+（更早版本的设置页宿主不渲染该插槽，卡片不出现，但不影响 Host 半侧运行，配置可走 cordis.yml）。
准入放行：宿主在 session/prompt 准入时通过 llm.resolveModelInfo 服务方法判定模型能力，声明不含 image 的路由会收到 MODEL_DOES_NOT_SUPPORT_IMAGES 整条拒绝。本插件包装该服务方法，对这类路由在元数据中补报 image 能力使准入放行；而请求层的字节投影读取的是适配器自身元数据（不经过该方法），行为不变——纯文本模型的请求里图片仍是文本占位符。原生多模态路由不受影响，其它消费方（ACP、子代理等）最多元数据展示失真，行为上有投影兜底。插件卸载时恢复原方法；若服务门面不可写则跳过放行，其余功能不受影响。未来若 dsh 提供官方的准入开关，应迁移过去。
客户端 bundle:dsh web 通过模块加载器按 dsh.client 声明发现客户端插件，加载的是懒 CJS 包装格式（window.__ModuleLoader__.load({ id, factory: (require) => … })），@deepseek-ai/* 与 react 保持外部化、由加载器的 require 在启动模块图中解析。scripts/build-client.mjs 用 rolldown 复刻了这一输出形态：src/client 打包为 CJS、外部化官方依赖后套上包装写入 lib/client.js。卡片遵循插件管理页的键控 slot 契约（@deepseek-ai/dsh-client-ui-plugin-manager/client 声明的 plugins.bundle.config，以 bundle 包名为键，仅类型导入、不引入运行时依赖）。
src/meta.ts — 无依赖共享常量（命名空间 / 插件名 / 默认提示词），供两侧安全复用。src/config.ts — vision 命名空间的设置 schema。src/capability.ts — 模态判定（ctx.llm.resolveModelInfo + overrides）。src/tool-understand-image.ts — understand_image 工具。src/index.ts — Host apply：设置 + 工具 + 指导，按 agent 能力退避。src/client/ — 浏览器设置卡片（web UI）。scripts/build-client.mjs — 客户端 bundle 构建（ModuleLoader 包装格式）。