meitu-id-photo

name	meitu-id-photo
description	用于基于用户原图制作规格化证件照、证件照换底色或单人写真套图。当用户要证件照、一寸照、二寸照、护照/签证照、白底/蓝底/红底证件版、写真照、三宫格写真、主题/场景写真时触发。不适用于多人合影、卡通化转绘、普通人像轻修。执行时会读取 Meitu 凭证、调用本地 `meitu` CLI，把人像照片、生成提示词与任务参数发送到 Meitu OpenAPI，并把结果写入本地输出目录。
version	1.2.0
metadata	{"openclaw":{"requires":{"bins":"[Truncated]","env":"[Truncated]","paths":"[Truncated]"},"primaryEnv":"MEITU_OPENAPI_ACCESS_KEY","security":{"dataFlow":"Inputs, selected local context, generated prompts, and task parameters may be sent to Meitu OpenAPI when used by the workflow.","credentials":"Credentials are used only for CLI authentication and must not be disclosed.","persistence":"Record workflows may access declared project and visual memory/rules files."}}}
security	{"credential_use":"Uses Meitu OpenAPI credentials from env or ~/.meitu/credentials.json for CLI calls; credentials must not be echoed, logged, or embedded in prompts.","remote_processing":"Portrait photos, ID photo parameters, portrait prompts, and generated prompts may be sent to Meitu OpenAPI.","persistence":"Project mode may write output files and may update project or visual-memory files according to the Record workflow."}
requirements	{"credentials":[{"name":"MEITU_OPENAPI_ACCESS_KEY","source":"env | ~/.meitu/credentials.json"},{"name":"MEITU_OPENAPI_SECRET_KEY","source":"env | ~/.meitu/credentials.json"}],"env":{"MEITU_OPENAPI_TOOL_TASK_MODE":"command"},"permissions":[{"type":"file_read","paths":"[Truncated]"},{"type":"file_write","paths":"[Truncated]"},{"type":"exec","commands":"[Truncated]"}]}

Overview

本 skill 采用“证件照与写真套图”决策方式，但执行统一收敛到现有公开模板工具集：

• 标准证件照：image-edit
• 已有照片换证件底色：image-edit
• 单人写真 / 三宫格写真 / 主题场景写真：image-portrait-generate

核心原则只有两条：证件照求“规格准确、身份不漂移、不过度美化”，写真求“像本人、风格明确、摄影质感成立”。

执行前应让用户清楚知道：本 Skill 会读取 Meitu 凭证、调用本地 meitu CLI、将人像照片、生成提示词和任务参数发送到 Meitu OpenAPI，并把生成结果写入 ./output/ 或 $VISUAL/output/meitu-id-photo/。证件照场景只收集当前任务必需的信息，非必要不持久化姓名、性别或其他身份字段。

Dependencies

• meitu-cli (>=2.0.6): npm install -g meitu-cli@latest
  • 首选环境变量：MEITU_OPENAPI_ACCESS_KEY / MEITU_OPENAPI_SECRET_KEY
  • 或预置凭证文件：~/.meitu/credentials.json
  • 如需人工初始化本地凭证，可显式执行 meitu config set-ak --value "..." + meitu config set-sk --value "..."（会写入本地文件）
  • 验证：meitu auth verify --json
• 环境变量：MEITU_OPENAPI_TOOL_TASK_MODE=command

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

Core Workflow

Preflight -> Intent Routing -> Execute -> Refine -> Deliver -> [Record]

Preflight

1. meitu --version -> 未安装则提示 npm install -g meitu-cli@latest
2. meitu auth verify --json -> 凭证无效则引导配置
3. Detect mode: cwd has openclaw.yaml -> project mode; else -> one-off 检查 $VISUAL 目录 -> 确定 capabilities can_record = cwd 有 openclaw.yaml AND $VISUAL 存在（两者缺一即 false）
4. output_dir 解析（Preflight 内 MUST 完成）： Resolve output_dir: openclaw.yaml -> ./output/ | else -> $VISUAL/output/meitu-id-photo/ mkdir -p {output_dir}

硬约束： {output_dir} 禁止指向 skill 文件夹内部。output/ 永远在 skill 文件夹外部。 Execute 中所有 --download-dir {output_dir} 使用此处解析的路径。

Intent Routing

先判断用户要的是哪一类任务，只走一条路径：

用户需求	工具路径