Vision

核心用法

vision 是一套围绕 ImageMagick 构建的命令行图像处理技能，提供六大核心功能模块：

| 功能 | 典型场景 |

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

| **resize** | 按比例或指定像素调整图片尺寸，生成缩略图 |

| **crop** | 按坐标或智能居中裁剪特定区域 |

| **convert** | 在 PNG/JPG/WebP 之间互转，支持质量参数 |

| **optimize** | 压缩体积同时保持视觉质量 |

| **info** | 读取 EXIF、尺寸、色彩空间等元数据（可选 JSON 输出） |

| **watermark** | 添加自定义文字水印，支持位置、透明度、字号调整 |

所有命令统一通过 bash scripts/script.sh <command> 调用，输出文件自动添加后缀（如 _resized）或指定 --output 路径。

显著优点

• 成熟底层：依托 ImageMagick 30+ 年图像处理积淀，格式兼容性极佳
• 批处理友好：命令行设计便于脚本化、自动化流水线集成
• 轻量依赖：仅需 bash 4+ 和 ImageMagick，exiftool 为可选增强
• 输出灵活：--json 开关支持结构化数据获取，方便下游程序解析

潜在局限

• 无 GUI：纯命令行交互，对非技术用户门槛较高
• 本地执行：依赖本地 ImageMagick 环境，跨平台配置（尤其 Windows）可能繁琐
• 误操作风险：直接覆盖原文件需手动确认，--output 遗漏时自动命名规则可能造成目录混乱
• 高级功能缺失：不支持 AI 超分、智能抠图等现代图像 AI 特性

适合人群

• 开发者构建图片处理自动化流程
• 运维人员批量优化站点图片资源
• 内容创作者配合脚本快速处理素材
• 需要轻量级方案而不愿引入重量级 SaaS 服务的团队

常规风险

• 输入验证：需确保 --input 路径合法，避免路径遍历
• 资源消耗：大分辨率批量处理可能占用大量内存与 CPU
• 格式兼容性：WebP 等现代格式在旧版 ImageMagick 中支持有限

核心用法

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

• resize：按像素或百分比缩放图像
• crop：按坐标或中心重力裁剪区域
• convert：PNG/JPG/WebP 格式互转
• optimize：压缩优化文件体积
• info：读取 EXIF 及图像元数据（支持 JSON 输出）
• watermark：添加可配置的文字水印

所有命令通过 bash scripts/script.sh <command> 调用，输出文件支持 --output 指定或自动生成后缀命名。

显著优点

1. 功能完整：覆盖常见图像处理需求，无需记忆复杂的 ImageMagick 参数
2. 纯本地执行：无网络通信，图像数据不出本地，隐私风险极低
3. 输入验证完善：通过 validate_input 函数校验文件存在性，防范路径遍历
4. 轻量依赖：仅依赖系统级 ImageMagick，无额外第三方库
5. JSON 输出支持：info 命令可输出结构化数据，便于脚本集成

潜在缺点与局限性

1. T3 来源可信度：个人开发者维护（bytesagain），无开源许可证声明，社区生态较弱
2. 数值参数未校验：--width/--height/--percent 等参数缺乏类型和范围检查
3. 输出覆盖风险：自动命名文件存在时直接覆盖，无确认机制
4. ImageMagick 依赖风险：底层工具历史上存在图像解析漏洞，需用户自行维护更新
5. 无沙箱隔离：处理不受信任图像时存在潜在安全风险

适合人群

• 需要批量处理图片的开发者与设计师
• 注重隐私、偏好本地工具的用户
• 熟悉命令行，希望简化 ImageMagick 使用门槛的技术人员

常规风险

• 低风险：外部命令调用 ImageMagick，但输入已验证
• 低风险：临时文件自动写入，限于用户指定目录
• 信息级：个人开发者来源，建议审查代码后使用