核心用法
resize-magic 是一个轻量级的 OpenClaw 技能,封装了 ImageMagick 的图像处理能力,通过 Bash 脚本提供简洁的命令行接口。核心命令为 resize <input-path> <geometry> [output-path],支持灵活的几何参数定义:
- 固定宽度:
800x— 宽度 800px,自动保持宽高比 - 精确尺寸:
800x600— 强制指定宽高(可能改变比例) - 百分比缩放:
50%— 按比例缩放 - 条件缩放:
800x800\>— 仅当原图大于 800x800 时才缩小
显著优点
1. 依赖成熟生态:ImageMagick 是业界标准的图像处理库,历经数十年验证,功能稳定可靠
2. 零配置开箱即用:通过 brew 一键安装依赖,无需复杂环境配置
3. 参数语义清晰:几何字符串格式与 ImageMagick CLI 原生一致,对熟悉该工具的用户零学习成本
4. 轻量封装:仅 100 行左右的 Bash 包装脚本,易于审计和二次开发
潜在缺点与局限性
1. 外部依赖强绑定:必须预装 ImageMagick(magick 或 convert 命令),跨平台(尤其 Windows)部署存在摩擦
2. 无交互式预览:纯 CLI 工具,无法直观预览缩放效果,需反复试验确认参数
3. 错误处理简约:依赖 ImageMagick 原生的退出码和 stderr 输出,缺乏结构化的错误反馈
4. 功能单一:仅封装 resize 能力,裁剪、格式转换、滤镜等需调用其他工具
适合人群
- 开发者/DevOps:需要集成图像处理到 CI/CD 或自动化脚本
- 内容运营团队:批量处理产品图、缩略图生成等重复性工作
- 熟悉 ImageMagick 的用户:希望用更简洁的抽象层替代冗长的原生命令
常规风险
- 输入验证依赖 ImageMagick 本身,需确保来源图片无恶意构造(如 CVE 历史中的解析漏洞)
- 磁盘空间:处理大分辨率 RAW/PSD 文件时可能产生临时文件峰值占用
- 覆盖写入风险:未显式指定输出路径时行为未文档化,建议始终提供完整参数
---
> 来源可信度:T3(个人开发者 Stenkil,Git 提交历史未公开验证,无组织背书)
> 安全建议:仅处理可信来源的图像文件,生产环境建议容器化隔离运行