image-catch-skill — 图片抓取规范
本技能提供图片抓取流程,不执行本地脚本。Claude 应根据以下规范,直接调用图库 API 或浏览器/网络工具完成下载。
数据源
本技能采用可配置源优先设计:
| 源类型 | 配置方式 | 说明 |
|---|---|---|
| 自定义源(推荐) | 用户提供的远程图片服务 / CDN | 地址内容由用户控制 |
| 正版图库 | Pexels / Pixabay / Unsplash API Key | 质量更高,适合正式项目 |
| 默认兜底 | Lorem Flickr(关键词语义)+ Picsum(随机占位) | 无需任何配置 |
各图源特点
| 源 | 质量 | 推荐场景 | 是否需要 Key |
|---|---|---|---|
| Pexels | ⭐⭐⭐⭐⭐ | 正式项目、Hero、Banner | 免费 Key |
| Pixabay | ⭐⭐⭐⭐ | 内容运营、营销页、插画 | 免费 Key |
| Unsplash | ⭐⭐⭐⭐⭐ | 大图/Hero/品牌视觉 | 免费 Key |
| Lorem Flickr | ⭐⭐⭐ | Demo、原型、占位图 | 无需 Key |
| Picsum | ⭐⭐ | 纯视觉占位、测试 | 无需 Key |
使用前询问规范
当用户要求抓图片时,Claude 必须先询问用户想用的图源,给出风格/质量推荐,再执行。示例:
准备抓「科技感办公」配图,可选图源:
- Pexels — 高质量真实照片(推荐正式项目)
- Pixabay — 量大,含插画/矢量
- Unsplash — 画质最高,艺术感强
- Lorem Flickr — 无需 Key,真实照片但授权不确定
- Picsum — 无需 Key,纯占位
- 全部自动 — 按 Pexels → Pixabay → Unsplash → Lorem Flickr → Picsum 顺序自动降级(默认)
你想用哪个?直接回车默认全部自动。
如果用户明确指定了源,或已配置自定义源,则不再询问。
标准抓取流程
- 明确主题:从需求提取图片内容词(如「团队配图」→
teamwork),越具体越好。 - 询问图源:向用户展示可选源及风格推荐,确认后执行;用户已指定则跳过。
- 英文关键词:优先使用英文搜索;中文需求参考
references/image-sources.md的中英文映射表。 - 定规格:按使用位置定方向(横版/竖版/方形)与尺寸。
- 若项目已执行过素材审计,优先使用
assets-requirements-report.md中的平台与推荐尺寸。 - 若未审计,根据项目关键文件探测平台(参考
../references/project-type-detection.md),再匹配../references/image-sizes.md中的默认尺寸。 - 用户已明确指定尺寸时,以用户为准。
- 若项目已执行过素材审计,优先使用
- 询问压缩:下载图片时先询问是否压缩。若需要本地压缩/裁剪/格式转换,转
frontend-icon-skill;若仅需远程缩放,使用各图源支持的缩放参数。 - 选源降级:优先使用用户自定义源;未配置则尝试 Pexels/Pixabay/Unsplash;仍无则使用 Lorem Flickr 和 Picsum 兜底。
- 落地保存:保存到项目图片目录(uniapp 默认
static/images/)。
API 调用参考
Pexels
GET https://api.pexels.com/v1/search?query={query}&per_page={count}&orientation={landscape|portrait|square} Authorization: {PEXELS_API_KEY}
Pixabay
GET https://pixabay.com/api/?key={KEY}&q={query}&per_page={count}&image_type=photo&safesearch=true&orientation={horizontal|vertical}
Unsplash
GET https://api.unsplash.com/search/photos?query={query}&per_page={count}&orientation={landscape|portrait|squarish} Authorization: Client-ID {ACCESS_KEY}
Lorem Flickr
GET https://loremflickr.com/{width}/{height}/{keyword}?lock={seed}
Picsum
GET https://picsum.photos/seed/{seed}/{width}/{height}
参数规范
| 参数 | 说明 | 示例 |
|---|---|---|
source | 指定源 | pexels / pixabay / unsplash / loremflickr / picsum / custom / all |
count | 数量 | 5 |
out | 下载目录 | ./static/images |
width | 目标宽度 | 1920 |
height | 目标高度 | 600 |
orientation | 方向 | landscape / portrait / squarish |
name | 文件名前缀 | hero-bg |
压缩/切图/格式转换
本技能不本地执行图片处理脚本。需要时:
- 优先使用
frontend-icon-skill处理本地图片。 - 或在下载时利用图源远程缩放参数(如 Unsplash
?w=1920&q=80)。
异常处理
- 无可用源:提示用户配置自定义源或 API Key;未配置时自动使用 Lorem Flickr 和 Picsum 兜底。
- 某源限流/失败:自动降级到下一源。
- 搜不到合适图片:换更具体的英文词,或加风格词(如
minimal、flat lay)。
使用规范
- 需要图片的场景尽量用真实图片,禁止用渐变色区块占位。
- 背景图上的文字需加遮罩确保对比度。
- 按显示区域选尺寸;首屏图预加载、非首屏懒加载;支持时优先 WebP。
- 图片必须添加
alt属性描述内容。 - 图片加载失败时要有纯色背景 fallback。
触发词
image-catch、image-catch-skill — 图片抓取规范


