mcpField
C
claude-vision-skill

claude-vision-skill

github.com/asuojunAgent 工作流2.3k63 次安装6 天前更新
代码仓库

关于 claude-vision-skill

claude-vision-skill 指导 Agent 在当前模型不支持原生图像输入时,通过 Node.js 脚本处理图像路径、网址或剪贴板内容,并说明回退和配置方式。

主要功能

  1. 01处理本地图像路径
  2. 02处理远程图像网址
  3. 03读取剪贴板图像
  4. 04缺少路径时自动回退

适用场景

  1. 01描述用户提供的本地图像
  2. 02分析通过网址分享的图像
  3. 03处理没有可见路径的粘贴图像

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/asuojun/claude-vision-skill --skill claude-vision-skill

安装后在 Claude Code 中输入/claude-vision-skill确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

AGENTS.md
.gitignore
README.md
cyberboss-setup.md
clipboard.ps1
CLAUDE.md
vision.js
clipboard.swift

详细介绍

视觉助手

当前模型可能不支持原生图像输入。用户提供图像路径或 URL 时,不要尝试直接查看图像。请改为运行:

node /Users/wwu/.codex/skills/claude-vision-skill/vision.js "<absolute image path>" "<prompt>"

对于图像 URL:

node /Users/wwu/.codex/skills/claude-vision-skill/vision.js --url "<image url>" "<prompt>"

用户将图像粘贴到聊天中,但没有显示文件路径或 URL 时:

node /Users/wwu/.codex/skills/claude-vision-skill/vision.js --clipboard "<prompt>"

--clipboard 会读取系统剪贴板中的当前图像(macOS 使用捆绑的 Swift 助手,Windows 使用捆绑的 PowerShell 脚本;粘贴的图像通常仍在剪贴板中)。如果失败,请让用户将图像保存为文件并提供绝对路径。

回退规则(自动):

  • 如果提供了本地路径,但文件不存在,vision.js 会自动回退到剪贴板。
  • 如果完全没有提供图像路径或 URL,vision.js 会自动尝试读取剪贴板。
  • 传入 --no-fallback 可禁用此行为,改为报错并显示明确的错误信息。

规则:

  • 始终使用 vision.js 的绝对路径。
  • 本地文件使用绝对图像路径,远程图像使用 --url。
  • 用户粘贴了图像但没有可访问路径时,优先使用 --clipboard。
  • 除非用户另有要求,否则使用中文进行描述。
  • 配置位于 vision.js 同目录下的 .env 文件中(DASHSCOPE_API_KEY、VISION_MODEL、DASHSCOPE_BASE_URL)。切勿打印或提交 API 密钥。
  • 如果 API 调用失败,请向用户报告错误,并让他们检查密钥、模型或基础 URL。

评论

支持 Markdown