Vision

核心功能

vision 是一款面向命令行用户的图像处理工具集，封装了 ImageMagick 的核心能力，提供六大核心模块：

• resize：按比例或像素尺寸调整图像大小，支持百分比缩放与固定宽高输出
• crop：基于坐标或智能锚点（如 gravity center）裁剪图像区域
• convert：在 PNG/JPG/WebP 格式间转换，可指定质量参数
• optimize：压缩文件体积同时保持视觉质量，适合 Web 发布场景
• info：提取 EXIF 元数据、色彩空间、文件尺寸等技术信息，支持 JSON 结构化输出
• watermark：添加文字水印，支持位置、透明度、字号自定义

显著优势

• 批量自动化：基于 Bash 脚本，易于集成到 CI/CD 或批处理工作流
• 轻量无依赖：仅需 ImageMagick 和可选的 exiftool，不引入复杂运行时
• 格式覆盖全：现代 Web 三剑客（PNG/JPG/WebP）全支持，质量参数可控
• 元数据透明：EXIF 读取功能对摄影师和合规审计场景实用

局限性与风险

• 前置依赖：必须预先安装 ImageMagick，不同系统版本可能存在参数兼容差异
• 无 GUI 反馈：纯命令行操作，无法实时预览裁剪或压缩效果，需反复调试
• 水印功能单一：仅支持文字水印，不支持图像水印或平铺模式
• 安全风险：处理用户上传图像时，ImageMagick 历史漏洞（如 CVE-2016-3714）需警惕，建议沙箱运行

适用人群

Web 开发者、DevOps 工程师、内容运营团队及需要批量处理图像的技术用户。

常规风险提示

• 处理来源不明的图像文件可能触发 ImageMagick 解析漏洞
• 批量操作前建议备份原图，--output 参数可覆盖原文件

核心用法

vision 是一款封装 ImageMagick 的 Bash 图像处理 Skill，提供六大核心功能：

• resize：按像素或百分比缩放图片，支持指定输出路径
• crop：基于坐标或重心（gravity）裁剪区域
• convert：PNG/JPG/WebP 三向格式互转，可指定压缩质量
• optimize：在保持视觉质量的前提下压缩文件体积
• info：读取 EXIF、尺寸、色彩空间等元数据，支持 JSON 输出
• watermark：添加文字水印，可调节位置、透明度与字体大小

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

显著优点

1. 零依赖网络：纯本地处理，除文档中的反馈链接外无任何外部请求，数据隐私风险极低。
2. T2 可信来源：由 BytesAgain 组织维护，具备明确 GitHub 仓库与官网，供应链可信度较高。
3. 安全编码实践：通过 CLS-Certify S 级认证，无 eval/exec/system 等危险函数，输入路径经校验，无命令注入或路径遍历漏洞。
4. 功能原子化：每个操作为独立子命令，参数语义清晰，便于脚本化集成和批量处理。
5. 元数据友好：EXIF 读取与 JSON 输出能力，适合摄影 workflow 与自动化归档。

潜在缺点与局限性

• 外部系统依赖：必须预先安装 ImageMagick 与可选的 exiftool，跨平台配置成本较高。
• 无 GUI 交互：纯命令行交互，非技术用户上手门槛较高。
• 版本号不一致：SKILL.md 声明 v3.3.0 与认证报告中的 v1.0.7 存在差异，维护者需统一版本管理。
• 许可证未声明：当前未明确开源协议，存在潜在合规不确定性。
• 文件类型未白名单：虽经输入校验，但未限制图像格式，误操作非图像文件可能产生异常。

适合人群

• 需要批量处理图片的开发者与运维工程师
• 构建自动化发布流水线（CI/CD）的技术团队
• 注重数据隐私、不愿上传图像至云端的设计/摄影工作者
• 熟悉 Bash 与 ImageMagick 的高级用户

常规风险

尽管通过 S 级安全认证，使用时仍需注意：

• ImageMagick 历史漏洞：底层依赖需保持更新，以防范已知 CVE（如图像解析漏洞）。
• 路径权限：处理系统目录下的文件时，确保执行用户具备最小必要权限。
• 大内存图片：处理超高分辨率图像时，ImageMagick 可能占用大量内存，建议在资源受限环境设置策略限制。