dsh-vision-toolkit

Vision Toolkit 0.1.46 为 DSH 纯文本模型提供 10 个视觉工具和图片输入变体：图片问答、OCR、定位、裁剪、SVG 描摹、像素差异、长截图 OCR、抠图、取色与本地 HTML 截图。

• DSH 版本组合（必需）：本页选用 DSH 0.2.0-rc.2、Node.js ^22.19 或 >=24；插件 peer 精确包含 0.2.0-rc.2，作者声明已验收，52DSH 未运行实测。
• 视觉 Provider 决策（必需）：默认使用作者自建的免费服务 vision.anionex.me；处理私有截图前改为自有或受信任的 OpenAI 兼容、Responses 或 Anthropic 端点。
• Python 3.11+ 或网络（可选）：无系统 Python 时首次使用会下载约 35 MB 的固定哈希 Python，并从腾讯云镜像或 PyPI 安装 Pillow、NumPy、vtracer。
• Chrome/Chromium/Edge（可选）：仅 vision_html_screenshot 需要；缺失时其他工具仍可用。
• 无敏感信息测试图片（必需）：先用公开截图验证，不上传账号、密钥、客户数据或内部系统画面。

本页命令固定使用 DSH 0.2.0-rc.2，与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录；新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到

web Profile

DSH 基线

0.2.0-rc.2

安装来源

npm 预构建包（锁定版本）

固定目标

@anionex/[email protected]

0.1.46 的 19 个 DSH peer 都明确包含 0.2.0-rc.2，本页固定 DSH 0.2.0-rc.2。仅静态复核，未在本站运行验证。

• DSH 版本组合来源 1 ↗（外部链接，在新标签页打开）
• DSH 版本组合来源 2 ↗（外部链接，在新标签页打开）

1. 01
   检查 Node.js 与 pnpm

   DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：

   环境检查复制命令

   node --version && pnpm --version

2. 02
   安装到 Web Profile

   这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。

   npm 预构建包（锁定版本）复制命令

   npx --yes @deepseek-ai/[email protected] plugin --profile web add @anionex/[email protected]

3. 03
   确认 Bundle 已进入配置

   安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 @anionex/dsh-vision-toolkit或对应 Bundle 层。

   检查配置复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

4. 04
   启动并完成最小验证

   启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。

   启动 DSH Web复制命令

   npx --yes @deepseek-ai/[email protected] web

npx --yes @deepseek-ai/[email protected] plugin --profile web remove @anionex/dsh-vision-toolkit

$DSH_HOME/profiles/<name>/cordis.patch.yml

插件 Bundle 行 id: vision-toolkit；可在同一行 config 中设置 provider、language、timeoutMs、allowedDirs、storageDir、imageInputVariants 等。

设置 → 视觉工具（Settings 命名空间 vision-toolkit）

Web 设置页编辑 Provider、协议、Credential、限制与运行时，并提供“测试视觉模型”。

DSH Credentials（provider.credential 引用名）

保存自有视觉服务 API Key；Settings 只保存引用名，不回显密钥。

<workspace>/.dsh-vision-toolkit/

默认产物、粘贴图片与临时文件目录；配置 storageDir 后改为共享根目录下 0700 私有子目录。

~/.dsh/cache/dsh-vision-toolkit/

隔离 Python 运行时、Artifact 签名密钥 artifact-access.key 与运行时缓存。

npx --yes @deepseek-ai/[email protected] plugin --profile web add @anionex/[email protected]
npx --yes @deepseek-ai/[email protected] --profile web --dump-config

- id: vision-toolkit
  config:
    provider:
      baseUrl: https://api.example.com/v1
      credential: MY_VISION_KEY
      model: your-vision-model
      protocol: openai

- id: vision-toolkit
  config:
    provider:
      protocol: responses
      reasoningEffort: medium

1. 重启 DSH Web 并硬刷新浏览器，打开 设置 → 视觉工具 确认插件已加载。
2. 决定是否继续使用默认免费服务；处理私有图片前改为自有 Provider，并把 API Key 保存为 DSH Credential。
3. 首次启动等待隔离 Python 运行时准备完成；离线环境先安装 Python 3.11+ 或在设置中指定 runtime.python。
4. 如不希望模型选择器被透明替换，在设置中关闭 imageInputVariants.hidden 或 autoSwitch。

1. 01
   确认 web Profile 中出现 id 为 vision-toolkit 的 @anionex/dsh-vision-toolkit 行。

   复制验证命令复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

   期望结果：Bundle 行存在且没有加载错误；只证明配置写入，不代表视觉调用可用。

2. 02
   在 设置 → 视觉工具 点击“测试视觉模型”。

   期望结果：返回连接与模型检查结果，或给出可解释的 Credential、网络、配额错误。

3. 03
   在测试工作区放一张公开截图，调用 /vision-skills 让它描述并定位一个按钮。

   期望结果：得到描述和原图像素坐标，产物写入 .dsh-vision-toolkit 目录。

• （使用 vision-skills）读一下这张公开错误截图，说明报错原因和先修哪里。
• 找到截图右上角的登录按钮，返回原图像素坐标并生成框选预览。
• 把 reference.png 还原成 HTML，每轮渲染后做像素差异对比。

读取工作区、/tmp 和 allowedDirs 中的图片与 HTML；默认把图片发往作者自建的免费视觉服务；运行 Python 子进程与本机 Chrome；首次下载 Python 和 PyPI 依赖；可在设置页触发 pnpm 自更新并重启 DSH Web。

数据存储：图片会按配置发往视觉 Provider，默认是作者自建的 vision.anionex.me，返回的描述进入 DSH 会话与持久证据缓存；Settings 只存 Credential 引用；产物与粘贴图在工作区 .dsh-vision-toolkit 或 storageDir；Python 运行时与签名密钥在 ~/.dsh/cache/dsh-vision-toolkit。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

首次使用提示运行环境尚未就绪

检查到腾讯云 COS 镜像、GitHub 与 PyPI 镜像的网络；离线时安装 Python 3.11+ 或设置 runtime.python 后重试“测试视觉模型”。

返回 429 或额度用尽

默认免费服务是共享入口且有每日额度；改为自有 Provider 和 DSH Credential。

模型列表看不到 (Vision Toolkit) 变体

imageInputVariants.hidden 默认开启，会沿用原模型名并隐藏原文本模型条目；关闭 hidden 可恢复显式并列条目。

设置页提示应用内更新不可用

git、本地或只读 Profile 安装不支持应用内更新；按本页固定版本命令手动升级，不建议跟随 @latest。

vision_html_screenshot 不可用

安装 Chrome、Chromium 或 Edge；该工具只接受授权目录内的本地 .html/.htm，不接受 URL。