dsh-free-vision 使用指南

为纯文本 DSH 模型补上看图能力：注册 image_understand 工具调用免费视觉 API（千问/豆包/硅基），并自带 show_image 把图片内联渲染进对话流。

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

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

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add dsh-free-vision

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

— 源: plugins.install

零 MCP 配置 — 不用改 cordis.patch.yml、运行时不用 npx：视觉引擎（luma-mcp）作为本包依赖内置，进程内启动
单个通用工具 — image_understand（可用 config.toolName 改名）注册到 ctx.tools，每次请求模型都能看到
免费优先、多提供商 — 千问 / 豆包 / 硅基流动免费档开箱即用；智谱 / 混元 / custom 可切换
每个 Provider 可覆盖 API Base URL — 内置 Provider 可指向代理、API Gateway、本地服务或任意 OpenAI 兼容端点，无需改成 custom
直连 — 子进程剥离代理环境变量，国内 API 直连（带代理会导致 502）

— 源: plugin_wiki.readme_zh (fallback readme_raw)

装完就能用吗？

需要先填一个 API Key：默认千问 Qwen3-VL-Flash 在阿里云百炼开通即送限免额度（key 通过 DASHSCOPE_API_KEY 或设置界面填入），保存后下一次调用立即生效，无需重启。

粘贴到对话里的图片，纯文本模型看得到吗？

默认开启"一步识别"（describeAtDispatch）：分发时插件先把图片描述文本直接塞给模型，模型在同一回合就能回答，无需再调工具；image_understand 仍然保留用于精确追问。

支持哪些视觉模型？都是免费的吗？

默认走千问/豆包/硅基流动三家有免费额度的模型（dsh/index.js:218-225, 索引.js 0），智谱、腾讯混元、自建 OpenAI 兼容端点按量计费；千问免费额度可分析约 19 万张 1MB 截图。

我能用国内代理 / 自建网关代替官方 API 地址吗？

可以。设置 → Free Vision 在每个提供商卡片下都能改 Base URL（baseURLs[provider]），留空自动回退官方地址；同时支持 QWEN_BASE_URL 等环境变量覆盖（dsh/index.js:228-245）。

安装时为什么要执行 patch-luma.mjs？

这是 npm 的 postinstall 钩子，会给依赖里的 luma-mcp 引擎打上幂等小补丁（仅在 [email protected] 上验证过）：让每个内置提供商都能读取 *_BASE_URL 环境变量，并避免 https://host/v1/v1 这种路径重复。

为什么国内 API 要走直连（不能挂代理）？

阿里云百炼、火山方舟、硅基流动都是国内端点，子进程会主动剥离 HTTP_PROXY/HTTPS_PROXY/ALL_PROXY 等代理变量；如果硬挂着代理，反而会拿到 502（dsh/index.js:121-124,310-316）。

工具名 image_understand 跟别人的插件冲突怎么办？

在高级设置里把 toolName 改成别的即可；show_image 工具名也支持改（showImageToolName），改完保存立即生效。

怎么完全卸载？

配置文件在 ~/.dsh/free-vision.json（自定义路径可由 DSH_FREE_VISION_CONFIG_PATH 覆盖），删掉即可清空 key/地址覆盖；插件本体用 dsh plugin --profile web remove dsh-free-vision 卸载。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

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

— 来源：通用规则