dsh-deepseek-vision 使用指南
为纯文本 DeepSeek 加贴图能力：注册视觉路由，把图片先由 VL 模型描述成文字再交给 DeepSeek，不换模型不改官方。
本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。
快速上手
dsh-deepseek-vision
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add dsh-deepseek-vision
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
装好之后需要做什么才能贴图？
安装后在 dsh 设置 → 插件 → 插件配置 打开 "DeepSeek + Vision（视觉语言桥接）" 卡片填好 VL 模型密钥（或在终端导出 QWEN_VL_API_KEY），然后在 Models 页面选择 DeepSeek + Vision provider，再在聊天窗口贴图即可。
卸载后含图的历史会话会怎么样？
含图会话切不回文本模型——官方按 inputModalities 准入拒绝，这是预期行为；新会话不受影响，重新安装本插件即可恢复。
VL 模型描述失败会怎么样？
默认是 fail-closed：描述失败会让整次请求以稳定错误码（IMAGE_TOO_LARGE / AUTH / TIMEOUT / TRANSPORT 等）终止，不会静默丢图；可设为 placeholder 降级为文字占位继续。
同一张图会被重复计费吗？
不会。按 attachmentId 在进程内做 LRU 缓存（默认 64 条），重试、会话压缩、后续轮次都复用同一份描述文字。
必须用 qwen3-vl-flash 吗？
不必。设置卡片里改 vl.baseURL 和 vl.model 即可换成任何 OpenAI 兼容 /chat/completions 网关，例如 vLLM 自部署、OpenRouter、LM Studio 等；复杂视觉推理可换 qwen-vl-max。
headless 模式能用吗？
能。网关路由在 web 和 headless 两个 profile 行为一致；只在 web 提供可视化设置卡片，headless 直接编辑 settings.yaml 即可。
是否锁定了官方 DSH 版本？
不锁定。官方 CLI 安装路径直接安装发布产物；无 CLI 复刻路径会在目标机用目标机的 dsh 重新构建，构建成功即兼容性证明。
— 源: plugin_wiki.faq_json
兼容性
- DSH: >=0.1.0-rc.6（兼容 rc.6 与 rc.7；构建锚点 0.1.0-rc.8 出处声明）
- Node: >=22.19.0
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。
— 来源：通用规则