用途:将图像裁剪为指定尺寸,裁剪区域以可配置的焦点为中心计算,并始终保持在原图边界内。适用于提取图片的某一部分、按自定义定位生成缩略图。
主要能力:通过命令行执行裁剪。必需参数为输入路径或 URL(--in)、裁剪区域宽度(--width,单位像素)和高度(--height)。可选参数包括焦点 X 位置 --focus-x(0-100,默认 50 即居中)、焦点 Y 位置 --focus-y(0-100,默认 50 即居中)、输出分辨率 --dpi(默认 300)、输出路径/文件名/目录 --out(默认 ./)以及使用的服务方 --provider(默认 local)。
使用方式:命令为 agent-media image crop --in <path> --width <px> --height <px> [options]。例如居中裁剪为 800x600:agent-media image crop --in photo.jpg --width 800 --height 600;将焦点设在左上方区域(距左 20%、距上 30%):agent-media image crop --in photo.jpg --width 800 --height 600 --focus-x 20 --focus-y 30;从 URL 裁剪并指定输出目录:agent-media image crop --in https://example.com/image.jpg --width 1024 --height 768 --out ./output。
输出:返回 JSON 对象,包含裁剪后图像路径及状态字段,例如 ok、media_type、action、provider、output_path、mime、bytes。
限制:资料仅说明默认 provider 为 local,使用 Sharp 库且无需 API key。其他 provider 的具体情况、支持的输入格式、体积或尺寸上限、异常处理方式暂未提供;焦点参数超出范围时的行为也暂未提供。