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

快速上手

dsh-vision-toolkit

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @anionex/dsh-vision-toolkit

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

— 源: plugins.install

关键要点

• 粘贴即可使用。 在 DSH Web 里粘贴图片，文本模型会自动切换到看图模式变体，不需要手动复制路径或更换模型。
• 无缝体验。 图片保留原生缩略图、会话记录和工作区路径；Web 可以预览产物，Headless 也能继续使用同一份结构化结果。
• 一行命令安装即用。 安装插件后默认使用内置免费 Gemini 3.7 Flash 视觉服务，不需要申请 API Key。
• 内置免费视觉。 安装后即可直接使用共享服务，每台机器每天有 300 张图 的免费额度。
• 带着意图去看图。 Agent 不只生成通用描述，而是围绕“报错在哪里”“按钮在哪”等当前任务提取证据。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后还需要自己申请视觉模型的 API Key 吗？

默认不需要。插件内置免费的 Gemini 3.7 Flash 视觉服务（vision.anionex.me），开箱即可粘贴图片提问；如果需要更高额度或私有端点，可在 Settings → 视觉工具 中替换为自备的 OpenAI/Anthropic 兼容服务。

在 Web 里粘贴图片，模型还是提示不支持图像输入怎么办？

通常是因为页面缓存或 Profile 没有切到带 (Vision Toolkit) 后缀的变体。重启 Web Profile 并刷新页面，确认当前模型已切换到 (Vision Toolkit) 变体；也可以把图片放进会话工作区，再通过 /vision-tools Skill 触发。

免费视觉服务返回 429 该如何处理？

这是共享容量临时耗尽。按错误响应里的 Retry-After 秒数等待后重试即可；如果经常触发，建议在 Settings 中替换为自备端点（Groq、自建 OpenAI 兼容网关均可）。

报错说图片过大或像素超限，如何处理？

错误会明确指出是字节限制（默认 4 MiB）还是像素限制（默认 2000 万）。先用 vision_crop 或外部工具裁剪/缩放图片后再调用视觉工具。

vision_html_screenshot 找不到 Chrome 怎么办？

安装 Chrome、Chromium 或 Edge 任一浏览器即可。只有 HTML 截图这一个工具受影响，其他 9 个视觉工具仍可正常使用。

是否支持视频、音频或摄像头输入？

当前版本不支持。本插件只处理静态图片（PNG/JPEG/GIF/WebP）和本地 HTML 截图，不会自动点击 GUI，也不做视频流、音频或摄像头采集。

插件的运行数据存放在哪里？

粘贴的图片存到会话工作区下的 .dsh-vision-toolkit/ 目录；插件隔离的 Python 虚拟环境与运行时缓存放在 $DSH_HOME/cache/dsh-vision-toolkit（DSH_HOME 未设置时回退到 ~/.dsh/cache/dsh-vision-toolkit）。

如何卸载或临时禁用这个插件？

卸载命令为 dsh plugin --profile web remove @anionex/dsh-vision-toolkit；如需临时关闭，可在 Profile patch 中设置 disabled: true，重启 Profile 即可生效。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.6
• Node: ^22.19.0 || >=24.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则