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

快速上手

dsh-minimal-vision

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-tool-vision

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

— 源: plugins.install

常见问题

安装后必须立即配置才能用吗？

必须。需要在「设置 → Vision」里填入 API 地址、视觉模型 ID 和 API Key 才会生效；测试连接只发最小文本请求，不会真正上传图片（src/connection-test.js:31-35 / src/client.js:287-306）。

支持哪些图片和文档格式？

图片支持 PNG/JPEG/WebP/GIF，文档支持 PDF/DOC/DOCX/PPT/PPTX。文档本身不会直接发到视觉接口，需要先用 Bash 把它们导出成图片再传给 dsh-vision（src/image.js:8-14 / src/file-upload-api.js:8 / src/injector.js:15）。

一次最多能传几张图？

单次 dsh-vision 调用最多接受 4 张图片，单张不超过 20 MB（src/analyze.js:6,60 / src/upload-api.js:8）；文档单文件上限 100 MB（src/file-upload-api.js:7）。

上传后附件存在哪里，会被上传到云端吗？

图片和文档都会落到本地 $DSH_HOME/cache/dsh-tool-vision/ 缓存目录，只有 Agent 显式调用 dsh-vision analyze 时才会把图片送到已配置的视觉服务，文档始终只在本地（README.md:43-46）。

能在原生 Windows PowerShell 上跑吗？

当前版本不支持。已在 Ubuntu 和 WSL2 下测试通过，Windows 用户需要先在 WSL2 内安装并运行 DSH 和本插件，原生 PowerShell 支持尚未推出（README.md:49）。

跟官方的视觉能力有什么区别？

本插件不会把视觉模型注册为新的聊天模型，也不会改写极简模式的 system prompt；视觉说明与附件路径作为一条折叠上下文随用户消息一起进入，原有两个工具 persistent-bash 和 str_replace_editor 保持不变（README.md:21-31 / presets/vision-assist/agent.cordis.yml:1-2）。

怎么排查环境是否正常？

插件自带 dsh-vision-doctor 脚本，会检查 profile 安装包、启动器、Node 运行时、CLI 路径和预设文件是否存在并可执行（scripts/doctor.mjs:12-58）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.6
• Node: >=20

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则