Vision

核心用法

vision 是一个封装 ImageMagick 命令行工具的图像处理技能，提供六大核心功能：

1. 尺寸调整（resize）：支持按像素值或百分比缩放图像，适配缩略图生成、响应式图片等场景。

2. 智能裁剪（crop）：支持坐标定位或基于重力感应（gravity center）的居中裁剪，适合头像截取、焦点构图。

3. 格式转换（convert）：在 PNG、JPEG、WebP 间互转，可指定质量参数平衡画质与体积。

4. 压缩优化（optimize）：智能压缩算法在保持视觉质量前提下减小文件体积，提升网页加载性能。

5. 元数据读取（info）：提取 EXIF 信息、色彩空间、文件尺寸等，支持 JSON 结构化输出便于程序处理。

6. 水印添加（watermark）：可配置文字内容、位置（东南西北等方位）、透明度及字号，保护版权标识。

显著优点

• 命令行原生：直接调用成熟的 ImageMagick 生态，稳定可靠
• 灵活输出：支持自定义输出路径或自动生成带后缀文件名
• 结构化数据：info 命令的 --json 选项便于自动化工作流集成

潜在局限性

• 依赖外部工具：需预装 ImageMagick 和可选的 exiftool，环境配置成本存在
• 无 GUI 交互：纯命令行操作，对非技术用户门槛较高
• 本地执行：大规模批处理受限于单机性能，无云端加速选项

适合人群

前端开发者、摄影师、内容运营、DevOps 工程师及需要自动化图像处理的技术团队。

常规风险

• 水印位置与透明度设置不当可能影响图像可用性
• 压缩质量参数过低导致不可逆的画质损失
• 处理高分辨率 RAW 文件时可能产生较大临时内存占用

核心用法

vision 是一款基于 Bash 和 ImageMagick 的本地化图像处理 Skill，提供 6 项核心功能：

| 命令 | 功能 | 典型用法 |

|------|------|---------|

| `resize` | 按比例或绝对尺寸缩放图像 | `--width 800 --height 600` 或 `--percent 50` |

| `crop` | 按坐标或重心裁剪图像 | `--x 100 --y 50 --width 400` 或 `--gravity center` |

| `convert` | 格式转换（PNG/JPG/WebP） | `--to webp --quality 85` |

| `optimize` | 有损/无损压缩优化文件体积 | `--quality 80` |

| `info` | 读取 EXIF 元数据及图像属性 | `--json` 输出结构化数据 |

| `watermark` | 添加可配置文字水印 | `--text "© 2025" --position southeast --opacity 30` |

所有命令均通过 --input 指定源文件，--output 可选（默认自动生成带后缀的文件名）。

显著优点

1. 纯本地化架构：零网络依赖，图像数据不出本地，隐私风险极低
2. 依赖精简透明：仅依赖系统级 ImageMagick（convert/identify/mogrify），无 npm/pip 供应链风险
3. 安全代码实践：无 eval/exec/system 动态执行，输入参数完整验证，无命令注入漏洞
4. 功能边界清晰：6 项功能与代码实现 100% 对应，无隐藏行为或后门
5. EXIF 合规读取：仅读取图像元数据（功能必需），不收集用户隐私信息

潜在局限

| 局限项 | 说明 |

|--------|------|

| 格式支持有限 | 当前仅 PNG/JPG/WebP，缺少 HEIC/AVIF 等现代格式 |

| 系统依赖前置 | 必须预装 ImageMagick 和 bash 4+，Windows 需额外配置 |

| 无批量处理语法 | 需外部循环实现目录批量处理 |

| 水印样式单一 | 仅支持文字水印，不支持图片水印或复杂排版 |

| 无 GUI 界面 | 纯命令行交互，对非技术用户门槛较高 |

适合人群

• 开发者/运维人员：需要集成到 CI/CD 流水线或自动化脚本
• 隐私敏感用户：拒绝云端图像处理服务，追求数据本地化
• 内容创作者：批量处理博客/社交媒体配图，优化加载速度
• 企业合规场景：满足 GDPR 等数据最小化原则的内部图像处理需求

常规风险

| 风险类型 | 等级 | 说明 |

|----------|------|------|

| 输入文件恶意构造 | 低 | ImageMagick 历史存在解析漏洞，建议保持 ImageMagick 更新 |

| 本地资源耗尽 | 低 | 处理超大图像可能触发内存/磁盘限制，建议设置 ulimit |

| 覆盖原始文件 | 极低 | 默认自动生成输出文件名，显式 `--output` 覆盖前无警告 |

> 综合评价：代码规范、功能专注、安全可控，是本地图像处理场景的可靠选择。建议生产环境配合 ImageMagick 最新稳定版本使用。