插件简介
dsh-vision-router 是一个面向 DeepSeek Harness 的视觉能力增强插件,由 ysr666 开发并开源。其核心定位是给纯文本的 DeepSeek Harness Agent 装上"眼睛":内置一条完全免费的视觉推理链路(无需 API Key、无需 Python 环境),并提供 14 个像素级视觉工具,使 Agent 可以像调用普通工具一样完成看图问答、目标定位、裁剪、像素对比、取色、OCR、SVG 矢量化、抠图与截图等任务。
GitHub 数据:当前 Stars 1,039,综合评分 68.8(GitHub 分 68.8),最近更新 2026-08-30,开源协议 MIT。插件已通过 DeepSeek Harness Hub 兼容性验证(npm 包 dsh-vision-router@2.0.1 已发布,Node 引擎要求 ^22.19.0 || >=24.0.0,基线 Node 22.19 满足),状态为"可直接安装",运行需访问外部网络。
核心功能
免费视觉链路
默认内置 5 个 OVHcloud 匿名视觉模型作为兜底,免注册、免 Key,每个 IP 每模型约 2 次/分钟,独立限额合计约 10 次/分钟;用户自备视觉模型时优先调用,不配置也能开箱使用。
14 个像素级视觉工具
包括视觉描述(vision_describe)、目标定位(vision_ground)、裁剪(vision_crop)、像素差异对比(pixel diff)、取色(colors)、OCR、SVG 矢量化(SVG trace)、抠图(cutout)、屏幕截图等,全部基于 sharp / potrace / tesseract 与系统级能力实现,无需 Python 运行时。
识图如普通工具调用
与其他把图片"翻译成文字描述"再喂给模型的视觉插件不同,本插件将图像像素保留在视觉模型侧、把推理留在 DeepSeek 侧,"看图"变成一次普通工具调用,结果可定位、可验证、支持多步连续操作。通过输入框旁的「👁 识图」开关控制,开启后持续生效。
安装与配置
安装前需先安装 DSH CLI 引擎(npm install -g @deepseek-ai/dsh)。普通 npm/npx 安装只需一条命令:
npx @deepseek-ai/dsh plugin --profile web add dsh-vision-router
若从 DeepSeek Harness 源码仓库通过 pnpm 运行,使用工作区脚本:
pnpm dsh plugin --profile web add dsh-vision-router
Oh-DSH Desktop 用户需将 DSH_HOME 指向桌面端数据目录:
DSH_HOME=~/.ohdsh npx @deepseek-ai/dsh plugin --profile desktop add dsh-vision-router
安装后重启或重新加载 DSH Web 进程即可使用。设置与模型选择均通过 设置 → Vision Router 完成。
兼容性与避坑指南
网络要求
插件运行需访问外部网络/远程 API,部署在国内无外网环境时可能无法正常使用,这是最需要提前确认的前提。
Oh-DSH Desktop 版本冲突
Oh-DSH Desktop ≤ 0.1.5 内置的是 DSH 0.1.0-rc.5,安装 dsh-vision-router v1.4.1 及更早版本会导致运行时崩溃(报 configurable provider "deepseek-official" is already declared),务必安装 v1.4.2+。
插件加载方式混用
若 profile 中已通过 cordis.patch.yml 手动挂载过社区插件,不要再与 dsh plugin add/list 混用,否则可能造成插件重复注册,需先迁移到 bundle 管理方式。
pnpm v11 拦截新版本
pnpm v11 会静默拦下发布不足 24 小时的新版本(表现为 downloaded 0 / added 0),此时应显式安装目标版本,或运行 npx dsh-vision-router repair 修复。
UTF-8 BOM 启动报错
若 profile 的 package.json 被编辑器保存为 UTF-8 with BOM,dsh 启动会报 "Unexpected token ... is not valid JSON",可运行 npx dsh-vision-router repair --profile web 自动修复。
其他已知问题
从 v1.1.x 升级后可能报 sharp DLL 冲突(colourspace: parameter space not set),需删除 profile 下 node_modules/sharp 与 @img 后重启;与 dsh-web-ui 共存时需关闭"发送时改写图片为 describe-image 引用",否则图片会被提前改写。
适合人群
适合需要让 DeepSeek Harness 处理图片的开发者与重度用户,特别是:文档 OCR、截图分析、图像 QA、UI 自动化验证等场景。不适合无外网环境、或对图片能力有生产级稳定性要求的用户(免费视觉链路有速率限制)。
总结
dsh-vision-router 以"免费、免 Key、无 Python、一条命令"的方式补齐了 DeepSeek Harness 的视觉短板,是纯文本 Agent 快速获得识图能力的低成本方案。查看插件详情页了解更多:查看插件详情页
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页