关于 claude-vision-skill
claude-vision-skill 指导 Agent 在当前模型不支持原生图像输入时,通过 Node.js 脚本处理图像路径、网址或剪贴板内容,并说明回退和配置方式。
主要功能
- 01处理本地图像路径
- 02处理远程图像网址
- 03读取剪贴板图像
- 04缺少路径时自动回退
适用场景
- 01描述用户提供的本地图像
- 02分析通过网址分享的图像
- 03处理没有可见路径的粘贴图像
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ asuojun/ claude-vision-skill --skill claude-vision-skill安装后在 Claude Code 中输入/claude-vision-skill确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
AGENTS.md.gitignoreREADME.mdcyberboss-setup.mdclipboard.ps1CLAUDE.mdvision.jsclipboard.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