dsh-vision-proxy 使用指南

让 DeepSeek Harness 在 DeepSeek 模型下也能发送图片：自动调用第三方视觉模型把图片转写成文字，再交给 DeepSeek 作答。

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

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

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add dsh-vision-proxy

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

— 源: plugins.install

绝不卡死。匿名端点强制 20 秒超时上限（免费档挂起也拖不住整轮对话）；匿名端点遇到 HTTP 429 立即失败（不做无意义的 Retry-After 等待）；刚失败（429/超时）的端点进入 60 秒冷却并被跳过。
多模型、多厂商。任何 OpenAI 兼容 VLM 端点都行——百炼/Qwen、QwenCloud 国际站、智谱、OpenRouter、本地 Ollama、或你自己的端点。每条 fallbackModels 都可以带各自独立的 baseURL/model，一个安装即可串联多家。
零配置本地路径。autoLocalOllama（默认开）启动时探测 http://localhost:11434，检测到 Ollama 就自动加入降级链——图片不出本机，免 key 免注册。
快速且明确的失败。没有 key 也没有本地 Ollama 时，转译在几秒内失败并给出可操作指引（配置 VISION_API_KEY / DASHSCOPE_API_KEY 或安装 Ollama）——绝不静默卡住。
有 key 自动提速。导出 VISION_API_KEY / DASHSCOPE_API_KEY 后自动走你配置的付费端点（默认百炼 qwen3.7-flash——快、便宜、不限速；百炼/QwenCloud/智谱/OpenRouter 或任意 OpenAI 兼容端点均可）；没有 key 的条目会被跳过而不是失败。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

安装后怎么验证生效？

执行 dsh --profile web --dump-config | grep dsh-vision-proxy 应看到恰好一个条目；重启 dsh web，模型选择器会出现"DeepSeek + 自动识图"选项。

没有 API key 能用吗？

可以。默认会探测本地 Ollama（http://localhost:11434），图片不出本机即可识图；Ollama 也没有时会在几秒内快速失败并给出配置指引，不会卡死。

Windows 下明明导出了环境变量却报"no API key"？

Windows 的 explorer.exe 会缓存旧环境变量，运行中的 dsh 读不到。把 apiKey 直接写进插件配置（profile 的 cordis.patch.yml），这是 Windows 上唯一可靠的方式。

pnpm ≥ 10 安装报 Ignored build scripts 怎么办？

在 profile 的 pnpm-workspace.yaml 加 allowBuilds: { dsh-vision-proxy: true, sharp: true }，然后重跑一次 dsh plugin --profile web add dsh-vision-proxy 完成注册。

转写结果丢失小字细节怎么办？

这是视觉模型本身的能力上限，不是插件 bug。可换成更强的模型（如 qwen3-vl-plus）或调大 maxTokens；密集 OCR 场景尤为明显。

图片数据会上传到哪？会被保存吗？

转写时图片以 base64 通过 HTTPS 发往配置或自动探测到的 VLM 端点。插件只做进程内缓存（按 SHA-256，200 条上限），不落盘。敏感图片请用本地 Ollama 或自建端点。

全部视觉端点都失败时整个对话会断吗？

默认不会。failureMode: placeholder（默认）会在原图位置插入"[图片转译失败: 原因]"占位文字，对话继续；失败的图片按内容哈希记 60 秒，期间不发起新网络请求。

哪些厂商或模型可选？

任何 OpenAI 兼容的视觉端点都行：默认走百炼 qwen3.7-flash，也支持 QwenCloud 国际站、智谱 glm-4.6v-flash、OpenRouter、本地 Ollama 等，可在 baseURL/model 中自由切换并通过 fallbackModels 串联多家。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

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

— 来源：通用规则