dsh-vision 使用指南

为 DeepSeek Harness 接入第三方识图模型：网页右下角配置面板发送图片自动识图并回传给模型，同时让模型能自己截图+识图。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add @linenxi-ctrl/dsh-vision

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

Windows：双击 uninstall.bat
macOS/Linux：运行 bash uninstall.sh
任意平台：node uninstall.mjs
发送图片识图：打开一个会话后，点右下角鲸鱼按钮 → 面板点「📤 发送图片」选图。识别期间右上角显示「外挂模型正在识图当中」，完成后自动把识别文本发回当前会话。
模型自主识图：直接对模型说「看看我现在屏幕上的报错」，模型会调用 screenshot 截图、再调用 recognize_image 识图并继续。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

需要准备什么才能用？

需要一个支持图片输入的模型 API（OpenAI、Anthropic、Gemini 或自建兼容服务），在网页右下角鲸鱼按钮的面板里填入 API 地址、密钥和模型名即可。

一定要装 npm 包吗？能不能离线用？

不必。仓库自带 install.bat/install.sh，安装脚本会自动从国内镜像下载免安装版 Node.js，免 pnpm 也能跑。

装好了为什么模型还是不会看图？

面板按钮（client）和识图服务（host）默认会一起挂载；如果只想要模型自己截图识图，还需要在 agent preset 的 agent.cordis.yml 里追加 lib/tool.js 的挂载行。

面板里的「发送图片」和 DeepSeek 默认拖图行为冲突吗？

不冲突。插件不拦截整页拖图，DeepSeek 原生的图片理解流程完全不受影响，只有面板里点「发送图片」才走外挂识图。

协议选 auto 还是手动指定好？

默认 auto 会按 API 地址自动探测（识别 anthropic / gemini / /responses 路径）。复杂场景下可以点「连接拉取」让插件列出 API 支持的模型并自动选协议。

怎么适配长尾接口？

把协议切到 custom，在「自定义请求模板」里按 {{model}}/{{prompt}}/{{image}}/{{dataUrl}}/{{mime}} 占位符拼 JSON 模板，并在「响应文本路径」里点号路径指到返回文本位置。

截图功能需要哪些系统组件？

Windows 需要 PowerShell（自带），macOS 自带 screencapture，Linux 需要安装 ImageMagick（提供 import 命令）。

怎么完全卸载？

npm 安装的先跑 dsh plugin --profile web remove，再跑仓库的 uninstall.mjs/uninstall.bat/uninstall.sh 一键清理客户端副本、agent preset 与 cordis.patch.yml 挂载。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则