image-id-photo-generate

name	image-id-photo-generate
description	基于用户正面人像和明确证件规格生成标准证件照，自动换装、换背景和合规调整。仅在用户明确要求证件照、一寸/二寸、护照/签证/身份证/驾照等规格化证件照，并已提供人像照片时触发；泛化的商务照、形象照或写真需求不单独触发。
version	1.0.0
metadata	{"openclaw":{"requires":{"bins":"[Truncated]","env":"[Truncated]","paths":"[Truncated]"},"primaryEnv":"MEITU_OPENAPI_ACCESS_KEY"}}
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":"User-provided portrait photos, spec parameters, and generated prompts are sent to Meitu OpenAPI for processing.","biometric_notice":"Portrait photos and face-description anchors are sensitive biometric-like personal data. Confirm the depicted person has agreed to this processing before running the workflow.","persistence":"Generated ID photos are written to the resolved local output directory."}
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]"}]}

证件照生成（image-id-photo-generate）

Overview

基于用户照片 + 证件规格一键生成标准证件照。自动换装（默认黑西装+白衬衫）+ 换背景 + 合规调整（露耳/露额/底色/着装/尺寸）+ face_desc 面部特征锚定，避免通用编辑链路对五官做过度美化。覆盖一寸/二寸/护照/签证/身份证/驾照/入学/毕业/职业/商务/结婚证/工牌等多规格。

执行前应让用户清楚知道：本 Skill 会读取 Meitu 凭证、调用本地 meitu CLI、将用户提供的人像图片与规格参数发送到 Meitu OpenAPI 处理，并把结果写入 ./output/ 或 $VISUAL/output/image-id-photo-generate/。证件照涉及敏感的人脸与身份相关图像数据，应确认对照片中人物具备合法授权。

API Mapping

• 证件照生成：固定使用 praline_pro，通过证件照 prompt 模板与规格映射驱动。

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-id-photo-generate/；mkdir -p

Execute

触发信号 / 路由规则

核心判断维度：证件用途判定 + spec_type 齐全 + 参数齐全。

决策顺序：

1. image_url 缺失 → 追问；spec_type 缺失 → 展示规格选择模板
2. 着装冲突检查：身份证规格 + 白衣无外套 → 强制改为黑西装
3. 观察原图填写 face_desc 13 项（禁止凭印象或默认值）
4. 构造 prompt（face_desc + attire_desc + bg_desc + 合规指令 + 负面约束）→ 固定使用 praline_pro

优先级规则：明确证件照用途 > 通用写真；需完整证件照（换装+换背景+合规） > 单纯换背景。失败精简 prompt 重试，最多 3 轮。

参数定义

参数	类型	必填	范围	默认值	说明