dsh-vision-router

环境要求

• 已安装 Node.js，可使用 npx（普通 npm/npx 安装方式）
• 已具备 DeepSeek Harness（DSH）CLI，或从源码 checkout 的 deepseek-harness 仓库
• DSH Web 使用 web profile
• 无需 Python，无需申请视觉 API key（内置免费视觉链）

安装与启动步骤

1. 1安装插件

   在终端执行这一条命令，把 dsh-vision-router 加到 web profile；这是官方推荐的安装路径。

   npx @deepseek-ai/dsh plugin --profile web add dsh-vision-router

   复制

2. 2源码方式安装

   如果从源码 checkout 运行 DSH 且 dsh 不在 PATH 上，用 pnpm 工作区脚本，先进入仓库目录。

   cd deepseek-harness
   pnpm dsh plugin --profile web add dsh-vision-router

   复制

3. 3验证是否装上

   用 dump-config 导出配置并 grep，能搜到 vision-router 就说明插件已登记进该 profile。

   npx @deepseek-ai/dsh --profile web --dump-config | grep vision-router

   复制

4. 4重载 DSH Web

   按你平时的方式启动或重载 DSH Web；若是长期运行的 Web 进程，需让它 reload 一次才能发现插件 bundle。

5. 5打开视觉开关

   在对话输入区启用“ Vision”控件，之后图片轮次就像普通工具调用轮次一样使用，可定位、可度量、可复现。

6. 6按需调整配置

   默认全部可选且开箱可用；优先在“Settings → Vision Router”里改，高级部署可用 profile 覆盖。

7. 7卸载（可选）

   想移除插件时执行对应的 remove 命令即可。

   npx @deepseek-ai/dsh plugin --profile web remove dsh-vision-router

   复制

关键配置

如何确认成功

执行 npx @deepseek-ai/dsh --profile web --dump-config | grep vision-router 能搜到条目，且 DSH Web 重载后设置中出现 Vision Router。

常见问题

注意事项

• 不要混用 legacy 手动插件行与 bundle 管理的 dsh plugin add / dsh plugin list，否则插件可能注册两次。
• 配置项全部可选、默认即可用，优先通过 Settings → Vision Router 修改，profile 覆盖留给高级部署。
• providers 链里不要放纯文本模型，必须是真正接受图片的模型。
• 某些配置（如 progressiveTools）属于启动时配置，改动需要重启 DSH。