证件照生成

以下内容仅供预览，如需安装请查看右侧安装方式说明。
name: yescan-idphoto
description: 当用户上传一张图片并希望自动将其转换成证件照时，使用此技能。系统会对上传图片进行AI人脸检测与定位、五官端正校正、姿态与角度矫正、背景颜色替换为指定纯色，并结合清晰度与细节增强处理，最终输出规范成品证件照片 metadata: {"openclaw":{"emoji":"📷","requires":{"bins":["python3"],"env":["SCAN_WEBSERVICE_KEY"]},"primaryEnv":"SCAN_WEBSERVICE_KEY"},"homepage":"https://scan.quark.cn/business"}

🧭 使用前必读（30 秒）

[!WARNING] ⚠️ 隐私与数据流向重要提示

推荐方式：CLI 配置（永久生效）

配置 SCAN_WEBSERVICE_KEY 环境变量到 OpenClaw：

openclaw config set skills.entries.yescan-idphoto.env.SCAN_WEBSERVICE_KEY "your_scan_webservice_key_here"

⚠️ 配置后需要重启或开启新会话才能生效（技能列表在 session 启动时加载）。

如何获取密钥？夸克扫描王官方入口在此

请访问 https://scan.quark.cn/business → 开发者后台 → 登录/注册账号 → 查看API Key。 ⚠️ 注意：若你点击链接后跳转到其他域名，说明该链接已失效 —— 请直接在浏览器地址栏手动输入 https://scan.quark.cn/business\（这是当前唯一有效的官方入口）。

---

Constraints

• 严禁自行构造任何命令参数，严禁伪造、拼接内部配置
• 严禁幻觉，禁止伪造请求和响应，不得沿用上一次的场景、参数进行假设
• 必须严格按照本指南指定的固定格式执行，不允许自行修改命令

技能执行指南(强制执行)

第一步：收集参数并输出确认单

⚠️ 4项参数无默认值。用户没有明确指定的参数，禁止推断、禁止填充。

参数映射表：

参数	映射	合法值
背景颜色	—	red/blue/white
妆容风格	精致:baibi/ 红润:hongxia/ 哑光:gangmai/ 白皙:baixi/ 美肤:realskin/ 儿童:ertong/ 韩式:hanshi/ 自然:ziran/ 原图:origin	见映射
妆容强度	不要:0/ 淡:1/ 浓:2/ 最浓:3	0-3
细节增强	关闭:0/ 轻微:1/ 中等:2/ 最强:3	0-3

必须输出确认单（固定格式，完整展示4项）：

📷 证件照参数确认：

[✓] 背景颜色：蓝色

[ ] 妆容风格：精致 / 红润 / 哑光 / 白皙 / 美肤 / 儿童 / 韩式 / 自然 / 原图


[ ] 妆容强度：不要(0) / 淡(1) / 浓(2) / 最浓(3)


[ ] 细节增强：关闭(0) / 轻微(1) / 中等(2) / 最强(3)


请填写 [ ] 项。

• [✓] = 用户已指定，填入确认值
• [ ] = 未指定，列出可选项待用户选择

🚫 存在 [ ] 项且用户未回复前，禁止进入第二步。全部为 [✓] 时直接进入第二步。

第二步：输入处理

识别用户传入的图片类型，只能是以下三种之一：

• 图片URL: url
• 本地文件路径: path
• 图片BASE64: base64

未提供任何有效图片时，直接返回：

{
  "code": "A0201",
  "message": "缺少图片输入，请提供图片链接、文件路径或 BASE64 数据。",
  "data": null
}

第三步：构建执行命令(固定格式，严禁修改)：

根据图片类型，严格使用下面对应格式：

# URL类型
python3 scripts/scan.py --scene "id-photo" --url "${IMAGE_URL}" --background "${背景颜色}" --style_type "${妆容风格}" --style_fuse_level "${妆容强度}" --retouch "${细节增强}"

# 本地文件类型
python3 scripts/scan.py --scene "id-photo" --path "${IMAGE_FILE_PATH}" --background "${背景颜色}" --style_type "${妆容风格}" --style_fuse_level "${妆容强度}" --retouch "${细节增强}"

# BASE64类型
python3 scripts/scan.py --scene "id-photo" --base64 "${IMAGE_BASE64}" --background "${背景颜色}" --style_type "${妆容风格}" --style_fuse_level "${妆容强度}" --retouch "${细节增强}"

• 把${IMAGE_URL}/${IMAGE_FILE_PATH}/${IMAGE_BASE64}替换为真实值
• 把${背景颜色}/${妆容风格}/${妆容强度}/${细节增强}替换为真实值
• 直接执行命令，不增删任何参数，不修改JSON，不加引号，不换行

第四步：结果透出：

• 执行完成后，原样返回执行结果，不修改，不翻译，不美化，不总结
• 成功 失败均直接透出，不重试

客户端脚本增强字段：当 scan.py 调用夸克 API 成功（code == "00000"）且响应 data 中包含 "ImageBase64" 时，scan.py 会主动调用 file_saver.py 将其解码并保存为本地图片文件，并在最终返回的 JSON 响应中，于 data 对象内追加 "path": "/tmp/xxx.png" 字段。该行为由 scan.py 脚本实现，与模型无关，也不依赖平台自动介入。

⛔ 不适用场景（When Not to Use）

本技能不支持以下场景，请勿尝试：

不支持的场景	原因	建议替代方案
视频处理	仅支持单张静态图片	先提取视频帧，再逐帧处理
批量处理	每次调用仅限单张图片	如需批量，请循环调用或联系管理员
实时摄像头流	非实时流处理架构	使用专用视频处理服务
超大图片（>5MB）	API 限制	先压缩或裁剪后再处理
非图片格式	仅支持 jpg/jpeg/png/gif/bmp/webp/tiff/wbmp	先转换为支持的图片格式

---

⚠️ 重要注意事项

1. 禁止修改固定格式,只能替换场景标识和图片占位符
2. 严禁自行构造 --scene 参数值，必须使用本文档指定的场景名
3. 图片大小限制：本地文件不超过5MB，支持 jpg/jpeg/png/gif/bmp/webp/tiff/wbmp 格式

---

🔗 相关资源

• 夸克扫描王开放平台

📁 文件结构

• SKILL.md — 本文档（意图分析 + 通用规范）
• scripts/scan.py — 主执行脚本 (Python 3.9+)
• scripts/common/*.py — 基础类库