前言¶
业务里常见一步：用户上传一张人脸照，系统要判断是不是翻拍——手机对着屏幕、打印纸、面具等。若在 Agent 对话里临时查腾讯云 FaceID 文档、拼 SDK 参数，容易漏字段或和普通版静态活体搞混。下面介绍 SkillHub 上的 tencentcloud-faceid-detectlivefaceaccurate，把 DetectLiveFaceAccurate（人脸静态活体检测高精度版） 的调用约定写进 SKILL.md，由 Agent 在需要防翻拍活体检测时按同一套流程执行。
这是什么¶
一句话：面向 Coding Agent 的腾讯云 DetectLiveFaceAccurate 接口调用技能，对静态人脸图片做防翻拍活体检测。
- 坐标：
@tencent-adm/tencentcloud-faceid-detectlivefaceaccurate - 版本：1.0.0（SkillHub 页面标注）
- 维护方：腾讯云慧眼人脸核身团队
- 分类：
it-ops-security；SkillHub 标签含requires_api_key=true - 来源：enterprise（SkillHub 已抓取资料）
相比普通静态活体检测，官方简介说明高精度版加强了对高清屏幕、裁剪纸片、3D 面具等攻击的防御，适用于移动端、PC 端等以图片为主的活体检验场景。接口能力与参数细节以腾讯云文档为准：https://cloud.tencent.com/document/product/867/48501
核心功能¶
以下内容与技能包内 SKILL.md 一致，仅列已写明的能力：
- 防翻拍活体检测：对用户上传的静态图片判断是否为翻拍。
- 攻击类型侧重：高清屏幕翻拍、裁剪纸片、3D 面具等（相对普通静态活体的增强点，见技能简介）。
- 输入方式：图片 Base64、图片 URL；本地文件路径可由脚本自动转为 Base64。
- 脚本入口：
scripts/main.py，依赖tencentcloud-sdk-python。 - 输出：JSON，含
Score、ScoreDesc、IsLive、FaceModelVersion、RequestId等字段；技能文档给出推荐阈值 40（Score ≥ 40倾向真实人脸，< 40倾向翻拍）。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装说明执行完整安装（示例为官方文档中的推荐命令）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装本技能¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
skillhub install @tencent-adm/tencentcloud-faceid-detectlivefaceaccurate --dir <skills 目录>
常用路径示例（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可让 AI 按 SkillHub 页面提示，参照 https://skillhub.cn/install/skillhub.md 完成安装。
3、配置腾讯云密钥¶
技能要求 Python 3.6+，并配置环境变量：
export TENCENTCLOUD_SECRET_ID="<你的 SecretId>"
export TENCENTCLOUD_SECRET_KEY="<你的 SecretKey>"
安装 Python 依赖：
pip install tencentcloud-sdk-python
典型用法¶
Agent 加载技能后，在需要静态图片活体检测时运行 scripts/main.py。请求参数（与 SKILL.md 一致）：
| 参数 | 说明 |
|---|---|
--image |
本地路径、Base64 字符串；与 --url 二选一 |
--url |
图片 URL；若与 --image 同时提供，优先使用 URL |
--face-model-version |
可选，目前支持 3.0，默认 3.0 |
--region |
可选，腾讯云地域，默认为空 |
图片规格（技能文档摘要）：PNG、JPG、JPEG、BMP（不支持 GIF）；jpg 长边不超过 4000 像素，其他格式长边不超过 2000；人脸区域建议大于 100×100；Base64 编码后不超过 5MB。
可复现示例：
# 本地图片（自动 Base64）
python scripts/main.py --image ./face.jpg
# 图片 URL
python scripts/main.py --url "http://example.com/face.jpg"
# 指定模型版本
python scripts/main.py --image ./face.jpg --face-model-version 3.0
成功时返回示例结构（分数说明见技能内表格，推荐阈值 40）：
{
"Score": 99,
"ScoreDesc": "活体分数99，高于推荐阈值40，判断为真实人脸",
"IsLive": true,
"FaceModelVersion": "3.0",
"RequestId": "xxx"
}
在 Cursor 等环境中，更常见的路径是：用户用自然语言描述「判断这张脸是不是翻拍」，由 Agent 根据 SKILL.md 的「使用时机」触发，再调用上述脚本，而不是手写 SDK 样板代码。
适用场景与注意¶
适合谁
- 已在用或计划用腾讯云人脸核身 / FaceID，需要在 Agent 工作流里做静态图片防翻拍检测的团队。
- 对普通静态活体精度不满意、希望走 DetectLiveFaceAccurate 高精度版 的场景（移动端、PC 端上传图片均可，以实际拍摄质量满足规格为前提）。
限制与注意
- 仅静态图片：技能定位是静态活体检测，不是视频流或动作活体；若需求是 AIGC 换脸、视频攻击等，应选用腾讯云其他接口与对应 Skill，勿与本技能混用。
- 合规：处理人脸个人信息需具备合法授权基础，具体以腾讯云官网服务协议为准（技能
SKILL.md亦指向官网约定）。 - 密钥：
requires_api_key=true，勿将TENCENTCLOUD_SECRET_*写入仓库或对话日志。 - 阈值：默认推荐 40，业务可按文档中的 5 / 10 / 40 / 70 / 90 调整安全策略。
SkillHub 页面显示该技能评分 100000，下载约 1171 次、安装约 26 次（以页面/抓取数据为准，会随时间变化）。
结尾¶
tencentcloud-faceid-detectlivefaceaccurate 把 DetectLiveFaceAccurate 的触发条件、环境变量、脚本参数和图片规格收敛进一份 Agent 可读的技能说明，减少对接时的反复查文档。需要安装或查看元信息时，可打开 SkillHub 官方页：
- https://www.skillhub.cn/skills/tencent-adm/tencentcloud-faceid-detectlivefaceaccurate
- https://api.skillhub.cn/tencent-adm/tencentcloud-faceid-detectlivefaceaccurate
