安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install youcam-beauty-advisor
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 youcam-beauty-advisor。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Beauty Advisor 是一款由 Perfect Corp 的 YouCam APIs 驱动的 Openclaw Skills 美妆推荐和图像生成工具。它可以分析面部特征和肤色，根据分析结果推荐合适的颜色和妆容，并在用户的自拍照上生成预览。
在生成图像前，该技能会询问用户希望使用精选的全脸模板还是自定义美妆效果，并说明积分消耗。它适用于美妆推荐和虚拟试妆，不适用于皮肤状况评分、发型建议或服装推荐。

应用场景

用户希望获得根据其脸型或肤色定制的妆容推荐。
用户希望在自拍照上预览精选的全脸妆容模板。
用户希望自定义单独的效果，例如唇色、眼影或腮红。
用户希望在亲自试妆前比较不同的妆容选项。
请求涉及皮肤状况评分、头发或服装时，应将其转交给更合适的技能。

工作原理

确认用户拥有清晰的正面自拍照，并验证 YouCam API key。
针对要使用的每项分析或生成功能，查阅最新的相关 Perfect Corp API 文档。
检查并披露分析和预览选项的积分消耗。询问用户希望使用预设的完整妆容还是自定义效果，并且只运行用户选择的选项。
分析面部特征，并在需要时分析肤色。对于面部特征，选择所需的项目，例如脸型、脸部纵横比、眼型和唇形。
使用分析结果和 references/guide.md 推荐合适的妆容和颜色。如果脸型为 Unknown，不要猜测；只能使用纵横比谨慎地提供偏长或偏宽的指导，其他建议应保持概括。
对于预设妆容，列出可用模板并让用户选择一个。对于自定义美妆，使用文档规定的类别 schema 提交所选效果。
完整返回生成的图像 URL，并解释该推荐可能为何适合用户的面部特征。始终以必需的 AI 预览免责声明结尾。
如果生成仍在进行中，则持续轮询现有 task ID，直到成功或出错。不要重新运行生成操作，因为这会启动另一个任务并产生另一笔费用。

配置指南

该技能需要执行 Python、访问 yce-api-01.makeupar.com 的网络权限，以及 YouCam API key。可以通过 YOUCAM_API_KEY 环境变量或技能根目录中的 credentials.json 提供密钥；请参考 credentials.example.json 了解预期的文件格式。从 Perfect Corp API Console 获取 API key。该技能未指定包安装命令。

验证 API key；此检查不消耗积分。

python scripts/youcam_core.py validate-key

在选择分析或生成功能前检查费用。

python scripts/youcam_core.py cost --feature face-attr-analysis
python scripts/youcam_core.py cost --feature skin-tone-analysis
python scripts/youcam_core.py cost --feature look-vto
python scripts/youcam_core.py cost --feature makeup-vto
每次使用前，请阅读计划运行功能的最新文档。在发出 API 请求前设置 YOUCAM_API_KEY 或创建凭据文件，并使用清晰的正面自拍照作为源图像。

数据架构

该技能通过 scripts/youcam_core.py 运行工作流。它未指定本地数据库或持久化输出文件格式；分析和生成结果由 YouCam APIs 返回。
资源或字段 用途
YOUCAM_API_KEY 通过环境变量或 credentials.json 提供的 API 凭据。 --src_file 提供用于分析或虚拟试妆的用户自拍照路径。 features 必需的面部特征选择，例如 faceShape、faceAspectRatio、eyeShape 和 lipShape。
faceshape 脸型结果：Triangle、Diamond、Heart、InvTriangle、Oblong、Oval、Round、Square 或 Unknown。
face_aspect_ratio 返回为 [1, r]；该指南将大致高于 1.6 视为偏长，低于 1.3 视为偏短或偏宽，仅用于有限指导。
template_id look-vto 功能所选预设妆容的标识符。模板列表包括 ID、标题和缩略图。
effects 按照 API 的类别 schema 和图案目录提供的自定义美妆效果类别项目。
data.results.url 生成的预览图像 URL；必须按原样返回。
task_id and task_status 用于检查异步生成。task ID 的有效期为 24 小时；应轮询该任务，而不是重新运行会产生费用的请求。
支持文件包括用于美妆指导的 references/guide.md 和用于凭据文件格式的 credentials.example.json。预设模板可以使用 --starting_token 进行分页。

高级特性

look-vto
支持精选的全脸妆容，并通过
makeup-vto
支持单独的美妆效果。
提供费用感知工作流：模板列表消耗 0 积分，并且该技能会在询问用户选择生成内容前检查功能费用。
允许用户浏览分页模板目录，并通过 ID、标题和缩略图选择妆容。
通过选择具体要测量的特征，支持可配置的面部特征分析。
通过针对原始 task ID 进行状态轮询来处理异步生成，避免意外的重复请求和费用。
当脸型未知时使用谨慎的备用指导，并让美妆推荐以现有分析结果为依据。
包含明确的范围边界和输出要求，包括原样返回图像 URL，并以必需的 AI 生成预览免责声明结尾。

name: beauty-advisor description: >- Recommend and preview makeup looks based on the user's face shape and skin tone,
using YouCam (Perfect Corp) AI. Analyzes the selfie, suggests suitable looks, then
renders a virtual makeup try-on image. Use for "推薦妝容", "幫我上妝", "makeup look",
"virtual makeup". Do NOT use for skin-condition scoring, hair, or clothes.
version: 1.1.1
requirements:
credentials:

• name: YOUCAM_API_KEY source: env | credentials.json (in the skill root, next to SKILL.md)
  network:
• yce-api-01.makeupar.com apis:
• face-attr-analysis
• skin-tone-analysis
• makeup-vto
• look-vto permissions:
• type: exec commands: [python]

Beauty Advisor

An analysis + generation skill: analyze face shape and skin tone, then recommend and preview a makeup look. Run the flow here through scripts/youcam_core.py.

When to trigger

When the user wants a makeup recommendation or a virtual try-on. For skin scores, hair, or clothes, hand off to the matching skill.

Ask first (this skill has multiple generation options) and state cost

Before generating, ask the user which they want, and tell them the credit cost of each option:

Full look (preset template) — apply a curated full-face look (look-vto)
Custom effects — specify individual items (lip color, eyeshadow, blush, …) (makeup-vto) Get costs with python scripts/youcam_core.py cost --feature look-vto and --feature makeup-vto (and --feature face-attr-analysis / --feature skin-tone-analysis for the analysis step), tell the user, and only run what they choose.
Get the latest API spec (do this every run)

Read the doc section(s) for the steps you will run and open the latest version for endpoints / parameters:

Facial attributes: https://docs.perfectcorp.com/reference/ai_face_analyzer.md
Skin tone: https://docs.perfectcorp.com/reference/ai_skin_tone_analysis.md
Makeup try-on (custom): https://docs.perfectcorp.com/reference/makeup_vto.md
Full look (template): https://docs.perfectcorp.com/reference/ai_look_vto.md

Prerequisites

A clear, front-facing selfie.
Run python scripts/youcam_core.py validate-key (0 credits) to confirm the key. If it is not set, tell the user to get one at https://yce.perfectcorp.com/api-console and set the YOUCAM_API_KEY env var, or create credentials.json in the skill root (see credentials.example.json for the format).

Flow

Analyze (as needed): face shape and eye/lip shape with python scripts/youcam_core.py run --feature face-attr-analysis --src_file --param features='["faceShape","faceAspectRatio","eyeShape","lipShape"]' (features is required and picks which attributes to measure), and run --feature skin-tone-analysis for colors. The face shape comes back as faceshape: one of Triangle, Diamond, Heart, InvTriangle, Oblong, Oval, Round, Square, or Unknown; references/guide.md has advice for Round, Oblong, Square, and Heart.

If it is Unknown, don't guess a shape. face_aspect_ratio comes back as [1, r] (ideal 1 : 1.46): r above about 1.6 means a long face, below about 1.3 a short/wide one. Use it only for that long-vs-wide advice, and keep the rest general.

Recommend: use references/guide.md to pick a look/colors from face shape + skin tone.
Preview (the option the user chose):
Full look: list the looks with python scripts/youcam_core.py templates --feature look-vto (0 credits; each has an id, title, and thumb image; pass --starting_token for the next page), let the user pick one, then run --feature look-vto --src_file --param template_id= Custom: run --feature makeup-vto --src_file --param effects='[{...}]' (each effects item is one category; see the doc's category schema and pattern catalogs) The generation returns a result image URL in data.results.url.

If run prints "task_status": "running", the task is still processing and run stopped waiting. Do not run it again, since that starts a new task and charges again. Check back with python scripts/youcam_core.py status --feature --task_id , using the task_id from that output, until task_status is success or error. A task_id stays valid for 24 hours.

Output rules

Return the result image URL exactly as given (you may make it a hyperlink, but do not modify or shorten it).
Explain the recommendation (why this look suits their face shape / skin tone).
Always end with this note: "This preview image is AI-generated and for reference only; actual makeup results may vary by product, skin, and lighting."
发色与发型顾问
PatentMax 中国专利审查意见通知书答复