Image Text Replace

Image Text Replace

Overview

对已有图片做文字内容替换：简单精准改字（标准印刷体/单处/≤6 字符/字符数不变四条件全满足）与复杂改字（花字/手写体/风格化/多处/字符数变化）。

API Mapping

• 简单精准改字：workflow_image_update_words
• 复杂改字（主）：image_praline_edit_v2
• 复杂改字（降级）：image_praline_edit_2
• 工具内兜底：image_mint_edit
• model 映射：auto（默认）/praline_pro→v2 / praline_lite→edit_2 / mint_edit→mint

Dependencies

• meitu-cli: >=2.0.6
• 凭证：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
2. 已用 CONFIG AKSK 跑过 meitu tools update
3. 当前 AKSK = EXEC，MEITU_OPENAPI_TOOL_TASK_MODE=command
4. output_dir：openclaw.yaml → ./output/ ｜else → $VISUAL/output/image-text-replace/；mkdir -p

Execute

触发信号 / 路由规则

核心维度：四条件判断（必须同时满足）：

1. 字体类型：标准印刷体（宋体/黑体/楷体/圆体/衬线体/无衬线体/等宽字体）
2. 修改位置：只修改一处文字
3. 字符长度：修改的文字字符数 ≤ 6
4. 字符数恒等：原文字符数 = 修改后字符数

| 场景 | 判定 | 路由 | |------|----------|------| | 四条件全满足 | 标准印刷体 + 单处 + ≤6 字符 + 字符数不变 | workflow_image_update_words → 失败升级 image_praline_edit_v2 → image_praline_edit_2 → image_mint_edit | | 花字 / 手写 / 风格化 | 花体字、手写、风格化 | image_praline_edit_v2 → image_praline_edit_2 → image_mint_edit | | 多处修改 | 改多个地方 | image_praline_edit_v2 → image_praline_edit_2 → image_mint_edit | | 字符数 >6 或 字符数变化 | 长文本 / 3 字→5 字 | image_praline_edit_v2 → image_praline_edit_2 → image_mint_edit |

参数定义

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | image_url | STRING | 是 | 图片地址。缺失 → 提示"请提供需要改字的图片" | | source_words | STRING | 条件必填 | 原文字内容。简单改字必填；复杂改字可从 prompt 自动提取 | | target_words | STRING | 条件必填 | 目标文字内容。简单改字必填 | | prompt | STRING | 否 | 改字描述；复杂改字时根据 source_words / target_words 自动生成英文改字指令 |

API 映射说明：

• workflow_image_update_words（简单改字）：image_url / source_words / target_words 直传
• image_praline_edit_v2 / image_praline_edit_2（复杂改字主/降级）：image_url 直传，prompt 根据 source_words/target_words 自动生成英文指令（如 "Replace the text 'xxx' with 'yyy' in the image"）
• image_mint_edit（降级兜底）：image_url / prompt 直传

目标文字含中文时，prompt 中目标文字保持原样、不做翻译。

工具调用

meitu image-text-replace --image_url  --source_words "" --target_words "" --json --download-dir {output_dir} --skill_name skill_image-text-replace

错误降级

| 场景 | 处理方式 | |------|------| | image_url 缺失 | 提示"请提供需要改字的图片" | | image_url 不可访问 | 直接返回图片链接无效错误，不重试 | | source_words / target_words 缺失 | 提示"请告诉我要把哪个文字改成什么" | | source_words 在图片中找不到 | 返回原图，告知未找到匹配文字 | | 字符数改变 / 花字 / 多处 | 不走简单改字，直接走 image_praline_edit_v2 | | workflow_image_update_words 调用失败 | 自动升级至 image_praline_edit_v2 | | image_praline_edit_v2 调用失败 | 自动降级至 image_praline_edit_2 | | image_praline_edit_2 调用失败 | 自动降级至 image_mint_edit | | image_mint_edit 调用失败 | 返回错误 | | 用户一次要改多张图 | 提示每次处理一张 | | 用户未提供字体信息 | 按标准印刷体判断，先试简单 API；失败自动升级 | | 内容合规拦截 | 直接返回合规提示，不重试、不降级 |

Deliver

• 使用 Preflight 解析的 output_dir
• 从 downloaded_files[0].saved_path 读取已下载文件路径
• mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_image-text-replace.{ext}

Output

• 格式：image
• 位置：项目 → ./output/，一次性 → $VISUAL/output/image-text-replace/

基线 Task ID

见 references/task-id-baseline.md 中对应行。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: meitu
• Source: meitu/meitu-skills
• License: MIT

Install and usage instructions live in the source repository linked above.