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

快速上手

deepseek-visionary

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @xlight-oss/visionary-dsh

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

— 源: plugins.install

关键要点

• visionary-zed-ext：Zed 扩展壳（仅 Zed 需要），按平台从 GitHub Releases 下载/缓存 visionary-server 并启动
• CLI：visionary-server login（可先 status --json 预检）
• MCP / DSH 原生工具：调用 deepseek_vision_login
• CLI：visionary-server vision <image> 识图（详见下文「CLI 工具」）
• MCP / DSH 原生工具：调用 deepseek_vision 传入图片路径 / base64 / data URI 即可识图

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后工具没出现在 DSH 工具列表里怎么办？

确认通过 dsh plugin --profile web add 安装成功，重启 DSH 后 5 个工具（deepseek_vision/ocr/status/login/logout）应出现在工具目录。可用 dsh --profile web --dump-config 确认 @xlight-oss/visionary-dsh 层已加载。

需要 DeepSeek API Key 吗？

不需要。本插件调用的是 DeepSeek 网页版视觉模型（chat.deepseek.com），通过浏览器自动登录复用网页端凭据，使用前需要先运行 deepseek_vision_login 完成登录。

纯文本模型为什么粘贴图片被拒绝？怎么开启？

文本模型原生不支持看图，DSH 宿主会以 MODEL_DOES_NOT_SUPPORT_IMAGES 拒绝。本插件的 visionary-image-bridge 默认开启（enabled: true），把图片落盘后改写为引导文本，由 agent 调用 deepseek_vision 完成分析。如被关闭，在设置 → Visionary 中重新打开即可。

图片和会话数据保存在哪里？会自动清理吗？

桥接会把粘贴图片保存到 ~/.deepseek-visionary/pasted（目录权限 0700，文件 0600），默认 7 天（retainHours: 168）后惰性清理。宿主附件库中的原始图片字节永久保留，不受清理影响。如需彻底删除图片需要清除对应会话。

如何卸载插件？

使用 dsh plugin --profile web remove @xlight-oss/visionary-dsh 卸载并重启 DSH。卸载后文本模型粘贴图片会恢复为被宿主拒绝的原行为。

deepseek_vision 报 CONTENT_EMPTY 错误？

这是上游二进制已知问题，已在 visionary-server ≥0.5.x 修复（不再因图片无 OCR 文字而中止）。请按 README 指引重新安装最新二进制。

支持哪些操作系统？

插件本体是跨平台 Node.js。visionary-server 二进制在 macOS、Linux、Windows 均提供安装脚本；Windows 下插件会额外解析 npm shim 定位真身 exe。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明（peerDependencies 锁定 dsh-tools/dsh-llm/dsh-attachment/dsh-settings ^0.1.0-rc.6，cordis ^4.0.1）
• Node: >=20
• Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则