用途
扫描当前项目目录,查找所有超过指定尺寸或文件大小的图片文件,并生成详细报告。
主要能力
- 按尺寸(宽度/高度)扫描图片
- 按文件大小扫描图片
- 同时按尺寸和文件大小扫描图片
- 自动忽略常见目录:node_modules、.git、dist、build 等
- 支持的图片格式:PNG、JPG、JPEG、GIF、BMP、WebP、TIFF、ICO
- 按文件大小降序排列大图片列表
- 提供优化建议
使用方式
- 使用 AskUserQuestion 询问用户要扫描的阈值类型,选项包括:仅按尺寸扫描(宽度/高度)、仅按文件大小扫描、同时按尺寸和文件大小扫描。
- 根据用户选择,询问具体阈值:
- 若选择尺寸扫描,预设选项为 1920x1080 (Full HD)、2560x1440 (2K)、3840x2160 (4K)、自定义。
- 若选择文件大小扫描,预设选项为 1MB、5MB、10MB、自定义。
- 根据用户选择,使用 Bash 运行扫描脚本:
/Users/bytedance/.claude/skills/scan-large-images/scanner.sh --min-width <宽度> --min-height <高度> --min-size <大小>注意:5MB = 5242880 字节。 - 任务完成后执行通知:
play -n synth 0.5 sine 1000-1000 vol 0.2
适用场景
- 项目优化前检查图片资源
- 发现可能导致性能问题的大尺寸图片
- 发现占用过多存储空间的大文件图片
- 审计项目中的图片资源使用情况
技术说明
- 使用 macOS 原生的 sips 命令获取图片尺寸。
- 自动忽略常见目录:node_modules、.git、dist、build 等。
- 支持的图片格式:PNG、JPG、JPEG、GIF、BMP、WebP、TIFF、ICO。
- 按文件大小降序排列大图片列表。
- 提供优化建议。
限制
- 脚本路径为本地绝对路径,可能因环境不同而变化。
- 尺寸获取依赖 macOS 的 sips 命令,其他平台可能不可用。
- 其他阈值类型或自定义输入的处理细节暂未提供。