dsh-vision-router

为纯文本 DSH 会话模型提供“👁 识图”模式和 14 个常驻视觉工具：看图问答、定位、检测、裁剪、像素对比、取色、OCR、SVG 描摹、抠图、HTML 截图和长截图 OCR。可选桌面截屏是第 15 个工具。视觉链按顺序尝试用户模型、可选的本地 Ollama/LM Studio、自定义 HTTP 端点，最后是内置的匿名 OVH 免费模型。

• 独立 DSH Web Profile（必需）：使用 DSH 0.2.0-rc.2 的独立 web Profile 和可丢弃工作区；本站只做了静态审阅，首次加载、发图和卸载需要使用者自己验收。
• DSH 0.1.5-rc.1 及以上或 0.2.0-rc.2 及以上（必需）：2.3.0 不再支持 DSH 0.1.5 以下版本和 0.2.0-rc.1；旧 Host 请先升级 DSH，或继续使用旧版插件。
• Node.js ^22.19.0 或 >=24（必需）：与 package.json 的 engines 一致；宿主侧需要能解析 sharp 0.35.3 及以上版本。
• 系统 Chrome、Chromium 或 Edge（可选）：只有 vision_html_screenshot 需要；插件使用 puppeteer-core，不会自动下载浏览器。
• Tesseract（可选）：vision_ocr 默认是 auto 引擎：本地 Tesseract 不可用或结果为空时会回退视觉模型，图片可能因此出网。
• 本地 Ollama 或 LM Studio 视觉模型（可选）：如果要求图片不离开本机，需要本地视觉后端，同时开启 localOnlyVision。

本页命令固定使用 DSH 0.2.0-rc.2，与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录；新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到

web Profile

DSH 基线

0.2.0-rc.2

安装来源

npm 预构建包（锁定版本）

固定目标

[email protected]

2.3.0 的 DSH peer 为 >=0.1.5-rc.1 <0.2.0-0 || >=0.2.0-rc.2 <0.3.0-0，本页固定 DSH 0.2.0-rc.2；不支持 0.2.0-rc.1 与 0.1.5 以下版本。仅静态复核，未在本站运行验证。

• DSH 版本组合来源 1 ↗（外部链接，在新标签页打开）
• DSH 版本组合来源 2 ↗（外部链接，在新标签页打开）

1. 01
   检查 Node.js 与 pnpm

   DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：

   环境检查复制命令

   node --version && pnpm --version

2. 02
   安装到 Web Profile

   这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。

   npm 预构建包（锁定版本）复制命令

   npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected]

3. 03
   确认 Bundle 已进入配置

   安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 dsh-vision-router或对应 Bundle 层。

   检查配置复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

4. 04
   启动并完成最小验证

   启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。

   启动 DSH Web复制命令

   npx --yes @deepseek-ai/[email protected] web

npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-vision-router

设置 → Vision Router（常规 / 识图策略 / 本地与设备 / 高级 / 诊断）

作者推荐的主要配置入口，可设置视觉模型链、仅本地视觉、Auto 路由授权、本地后端和桌面截屏开关。

独立 Profile 的 cordis.patch.yml 中已有的 vision-router 行

高级部署时按 id 覆盖 config；DSH patch 会整段替换 config，所以要同时保留 progressiveTools: false。

<workspace>/.dsh-vision-router/artifacts 与 DSH_HOME/logs、cache/vision-router

核对插件产物、日志和能力测评缓存的位置，测试结束后清理。

npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected]

- id: vision-router
  config:
    progressiveTools: false
    localOnlyVision: true
    localOllama:
      enabled: true
      baseURL: 'http://127.0.0.1:11434/v1'
      model: 'qwen2.5vl'

- id: modules
  name: '@deepseek-ai/dsh-client-modules'
  inject: [webServer]
- id: connection
  name: '@deepseek-ai/dsh-client-connection'
  inject: [webRuntime, webServer]
- insert:
    - id: vision-router
      name: dsh-vision-router
      config:
        progressiveTools: false
- id: vision-router
  name: dsh-vision-router
  disabled: false
- id: attachment-local
  config:
    maxImageBytes: 20971520
    maxImagePixels: 100000000
    maxImageDimension: 10000
    normalizedImageMaxBytes: 20971520
    normalizedImageMaxPixels: 100000000
    normalizedImageMaxDimension: 10000

1. 安装后重启同一个 web Profile 的 DSH Web，让 Host 重新加载插件本体和 dsh.client 浏览器包。
2. 打开“设置 → Vision Router → 常规”，确认识图模型链，并决定是否开启“仅本地视觉”。默认链路会把图片匿名发送到 OVH。
3. 如果 Profile 里还残留 v0.x 手动写入的 `- insert: - id: vision-router` 块，先删除，避免出现 duplicate loader entry id。
4. Auto 路由和后台测评默认关闭（routingMode=ordered、backgroundBenchmarking=off）。选择 all 可能产生云端 API 费用，请按需单独开启。

1. 01
   查看组合配置中的 vision-router 行和 attachment-local 上限。

   复制验证命令复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

   期望结果：预期能看到 dsh-vision-router 插件行，以及 attachment-local 的 20971520 字节、1 亿像素上限。这是待执行的验收步骤，不是本站实测结果。

2. 02
   在聊天输入框旁开启“👁 识图”，上传一张不含敏感信息的小图，并要求调用 vision_describe。

   期望结果：预期返回图片描述。若开启了 localOnlyVision，且本地后端不可用，应明确报错，不能静默退回云端。

3. 03
   在“设置 → Vision Router”中对一行本地或测试模型点击“测试识图”。

   期望结果：预期只对该 provider/model 发出 1 次真实图片请求，并显示是否接收图片；本站未运行验证。

• 使用测试截图：vision_ground image="test.png" target="发送按钮"，再用 vision_crop 按返回的坐标裁剪核对。
• 使用两张本地设计图：vision_pixel_diff original="a.png" rebuilt="b.png"，查看差异率和热力图路径。

安装时自带的 bundle patch 会改写官方 modules、connection 行的 inject 依赖，并把 attachment-local 的图片准入上限放宽到 20MiB、1 亿像素、10000px。插件会注册 /_dsh/vision-router/* Web 路由，其中自更新、截屏授权、日志写入为仅本机可用。默认开启视觉工具和自动识图包装。桌面截屏默认关闭；开启后会调用系统截屏命令，或在 Windows 上调用 PowerShell。插件还会调用 tesseract、系统 Chrome（无头，阻止非本地请求），并可在用户点击后通过当前 DSH CLI 执行 plugin add 自更新。

数据存储：产物写入 <workspace>/.dsh-vision-router/artifacts；日志写入 DSH_HOME/logs/vision-router；能力测评、模型列表和图片输入判定缓存写入 DSH_HOME/cache/vision-router/*.json。设置由 DSH settings 服务持久化；API Key 只以 apiKeyEnv 引用名保存。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

安装时 peer 依赖不满足

2.3.0 只接受 DSH >=0.1.5-rc.1 <0.2.0-0 或 >=0.2.0-rc.2 <0.3.0-0；DSH 0.2.0-rc.1 和 0.1.4 及以下版本需要先升级 DSH。

设置了 proxy 后，部分请求仍然直连

上游 #623 尚未修复：后台能力测评和 exact-image-check 会绕过插件级 proxy/proxyHosts。代理环境下请保持 backgroundBenchmarking=off，或改用 Host 级 HTTPS_PROXY。

Desktop 设置页提示“远程设置通道不可用”，或模型列表出现两组“+ 自动识图”

这是 DSH 0.2.0-rc.2 Desktop 上的已知上游问题（#619、#620，未修复）。Web Profile 不受影响；请等待上游修复，不要自行修改插件文件。

像素工具报 colourspace: parameter space not set

Profile 中残留旧版 sharp。删除 <profile>/node_modules/sharp 和 @img 后重启，让插件回落到宿主的 sharp。