mcpField
I
image-grid-split

image-grid-split

github.com/meitu创意与媒体36111 次安装9 周前更新
代码仓库

关于 image-grid-split

image-grid-split 是一个通过 Meitu CLI 拆分宫格图片的 Skill，适用于需要还原拼图或电商合图的场景。它根据图片自动识别分割线，无需预先指定宫格数，并将独立图片写入输出目录。

主要功能

  1. 01自动检测宫格分割线
  2. 02支持常见标准网格拆分
  3. 03无需指定宫格数量
  4. 04输出多张独立图片
  5. 05验证依赖与执行凭证

适用场景

  1. 01拆分电商商品拼合图
  2. 02还原社交媒体宫格图
  3. 03将一张网格图片切成独立图片

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/meitu/meitu-skills --skill image-grid-split

安装后在 Claude Code 中输入/image-grid-split确认已加载。

详细介绍

来自项目 README

图片拆分（image-grid-split）

Overview

自动识别宫格分割线，将单张多格图拆分为多张独立图片。覆盖四宫格/九宫格/六宫格等标准网格自动拆分，自动识别分割线位置；用于电商多图拼合图分离、社交媒体宫格图还原。仅需 image_url，无需指定宫格数。

执行前应让用户清楚知道：本 Skill 会读取 Meitu 凭证、调用本地 meitu CLI、将用户提供的图片 URL 发送到 Meitu OpenAPI 处理，并把拆分结果写入 ./output/ 或 $VISUAL/output/image-grid-split/。

API Mapping

  • 宫格拆分：image_grid_split

Dependencies

  • meitu-cli: >=2.0.6（npm install -g meitu-cli@latest）
  • 凭证：CONFIG AKSK → meitu tools update；EXEC AKSK → 实际执行（见根 CONFIG.md）
  • 环境变量：MEITU_OPENAPI_TOOL_TASK_MODE=command

路径别名：$VISUAL = {OPENCLAW_HOME}/workspace/visual/

Core Workflow

Preflight → Execute → Deliver
Preflight
  1. meitu --version ≥ 2.0.6（否则 npm install -g meitu-cli@latest）
  2. 确认已跑过 meitu tools update（用 CONFIG AKSK）
  3. 当前 AKSK = EXEC，且 MEITU_OPENAPI_TOOL_TASK_MODE=command
  4. 解析 output_dir：openclaw.yaml → ./output/ ｜else → $VISUAL/output/image-grid-split/；mkdir -p
Execute

触发信号 / 路由规则

场景判定关键词路由
宫格图拆分四宫格、九宫格、切成多张、拼图拆开、格子图image_grid_split

决策顺序：

  1. image_url 缺失 → 追问
  2. 唯一路由：调用 image_grid_split，自动检测分割线（无需用户指定宫格数）

单 API 工具：参数齐全即调用，失败重试 1 次后返回错误；不做跨工具兜底。非宫格图 / 未检测到分割线时按等分切割处理并告知用户。

参数定义

参数类型必填范围默认值说明
image_urlSTRING是----图片地址（需为宫格图）。缺失 → 提示"请提供需要拆分的宫格图"

工具调用

meitu image-grid-split \
  --skill_name skill_image-grid-split \
  --image_url <image_url> \
  --json \
  --download-dir {output_dir}

错误降级

场景处理方式
image_url 缺失提示"请提供需要拆分的宫格图"
image_url 不可访问直接返回图片链接无效错误，不重试
非宫格图片正常调用（按等分切割），告知用户结果可能不理想
未检测到分割线按等分切割处理
image_grid_split 调用失败重试 1 次，仍失败返回错误
内容合规拦截返回合规提示，不重试
用户想裁剪某区域本工具仅支持拆分宫格图，不支持裁剪
用户要拼合方向相反，本工具仅拆分不拼合
Deliver
  • 直接使用 Preflight 解析的 output_dir
  • 从 downloaded_files[*].saved_path 读取全部已下载文件路径
  • 按序重命名为 {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 中对应行。

评论

支持 Markdown