SKILL.md
图片拆分（image-grid-split）
Overview
自动识别宫格分割线，将单张多格图拆分为多张独立图片。覆盖四宫格/九宫格/六宫格等标准网格自动拆分，自动识别分割线位置；用于电商多图拼合图分离、社交媒体宫格图还原。仅需 image_url，无需指定宫格数。
执行前应让用户清楚知道：本 Skill 会读取 Meitu 凭证、调用本地 meitu CLI、将用户提供的图片 URL 发送到 Meitu OpenAPI 处理，并把拆分结果写入 ./output/ 或 $VISUAL/output/image-grid-split/。
API Mapping
- 宫格拆分：
imagegridsplit
Dependencies
- meitu-cli:
>=2.0.6（npm install -g meitu-cli@latest） - 凭证：CONFIG AKSK →
meitu tools update；EXEC AKSK → 实际执行（见根CONFIG.md） - 环境变量：
MEITUOPENAPITOOLTASKMODE=command
路径别名：
$VISUAL={OPENCLAW_HOME}/workspace/visual/
Core Workflow
Preflight → Execute → DeliverPreflight
meitu --version≥ 2.0.6（否则npm install -g meitu-cli@latest）- 确认已跑过
meitu tools update（用 CONFIG AKSK） - 当前 AKSK = EXEC，且
MEITUOPENAPITOOLTASKMODE=command - 解析 output_dir：openclaw.yaml →
./output/｜else →$VISUAL/output/image-grid-split/；mkdir -p
Execute
触发信号 / 路由规则
| 场景 | 判定关键词 | 路由 |
|---|---|---|
| 宫格图拆分 | 四宫格、九宫格、切成多张、拼图拆开、格子图 | imagegridsplit |
决策顺序：
image_url缺失 → 追问- 唯一路由：调用
imagegridsplit，自动检测分割线（无需用户指定宫格数）
单 API 工具：参数齐全即调用，失败重试 1 次后返回错误；不做跨工具兜底。非宫格图 / 未检测到分割线时按等分切割处理并告知用户。
参数定义
| 参数 | 类型 | 必填 | 范围 | 默认值 | 说明 |
|---|---|---|---|---|---|
image_url |
STRING | 是 | -- | -- | 图片地址（需为宫格图）。缺失 → 提示"请提供需要拆分的宫格图" |
工具调用
meitu image-grid-split \
--skill_name skill_image-grid-split \
--image_url <image_url> \
--json \
--download-dir {output_dir}错误降级
| 场景 | 处理方式 |
|---|---|
image_url 缺失 |
提示"请提供需要拆分的宫格图" |
image_url 不可访问 |
直接返回图片链接无效错误，不重试 |
| 非宫格图片 | 正常调用（按等分切割），告知用户结果可能不理想 |
| 未检测到分割线 | 按等分切割处理 |
imagegridsplit 调用失败 |
重试 1 次，仍失败返回错误 |
| 内容合规拦截 | 返回合规提示，不重试 |
| 用户想裁剪某区域 | 本工具仅支持拆分宫格图，不支持裁剪 |
| 用户要拼合 | 方向相反，本工具仅拆分不拼合 |
Deliver
- 直接使用 Preflight 解析的 output_dir
- 从
downloadedfiles[*].savedpath读取全部已下载文件路径 - 按序重命名为
{YYYY-MM-DD}{descriptive}image-grid-split_{idx}.jpg（多张输出以 idx 递增）
Output
- 格式：JPEG/PNG（保持原格式，多张独立图片）
- 命名：
{YYYY-MM-DD}{descriptive}image-grid-split_{idx}.jpg - 位置：项目 →
./output/，一次性 →$VISUAL/output/image-grid-split/
基线 Task ID
见 references/task-id-baseline.md 中对应行。