📦 Ekyc Suite — AI身份核验

金融级电子身份核验工具包，涵盖人脸比对、活体检测、证件 OCR、媒体标签等 8 项能力。 所有输入仅限图像或视频文件。

快速参考

能力	命令
人脸比对	python scripts/ekyc_api.py face_compare --photo1 --photo2
照片活体	python scripts/ekyc_api.py photo_liveness_detect --file
视频活体	python scripts/ekyc_api.py video_liveness_detect --file
身份证 OCR	python scripts/ekyc_api.py id_card_ocr --image --side <0\	1>
银行卡 OCR	python scripts/ekyc_api.py bank_card_ocr --image
驾驶证 OCR	python scripts/ekyc_api.py driver_license_ocr --image
行驶证 OCR	python scripts/ekyc_api.py vehicle_license_ocr --image --side <1\	2>
媒体标签	python scripts/ekyc_api.py media_labeling --file --labels "A14,B03" --type image

外部端点

安全与隐私

本软件不存储、缓存或保留任何提交数据。 API 核验结果仅供参考，不构成法律意义上的身份确认。 不得将本软件作为产生法律效果或重大影响的自动化决策唯一依据。 高风险身份决策应补充业务逻辑与人工审核。

信任声明

安装并使用本 skill 后，你提供的图像与视频数据将被发往腾讯云身份核验 API 处理。 仅在你信任上游服务商数据处理实践的前提下安装。 本 skill 不独立存储、处理或保留任何生物识别数据。

目标

接收用户上传的图像或视频，调用对应身份核验 API，将结构化结果用通俗语言解释给用户。

何时使用

当用户请求涉及以下场景时调用本 Skill：

• “Compare these two photos — same person?” / “face similarity score”
• “Is this photo AI-generated?” / “Is this video real?” / “deepfake detection”
• “Read this ID card” / “Read bank card number” / “Read driver's license” / “Read vehicle license”
• “Check for mask” / “Detect coercion” / “Wearing hat?” / “On the phone?”
• “Unconscious or asleep?” / “Wearing sunglasses?” / “Inside a car?”
• “In a hotel room?” / “Has tattoo?” / “Multiple people?” / “Wearing headphones?”
• “Facial sheet mask?” / “Critical patient?” / “At a car dealership?”
• 任何包含 “face comparison”、“liveness detection”、“OCR”、“media labeling”、“ekyc” 的请求

请勿使用

• 用户仅询问 “what is KYC” 或 “how does eKYC work” → 直接以知识回答
• 用户以文本提供姓名、证件号、手机号 → 拒绝并引导（见下方隐私规则）
• 用户要求“活体检测+身份验证”组合（需传输姓名+证件号）→ 说明隐私限制

关键规则

规则 1：隐私 —— 绝不接受个人文本

“为保护隐私，本服务不接受文本形式的姓名、证件号等敏感信息。AI 对话传输存在泄露风险，请直接上传图像或视频文件，我将通过图像识别完成核验。”

规则 2：绝不重写签名代码

规则 3：双路径解析返回

value = data.get("field") or (data.get("result", {}) or {}).get("field")

环境变量

# 能力 1-7（人脸比对、活体、证件 OCR）
KYC_APPID=your_kyc_appid
KYC_SECRET=your_kyc_secret
# 能力 8（媒体标签，独立密钥）
LABEL_APPID=your_label_appid
LABEL_SECRET=your_label_secret

获取密钥：

• 密钥 A（KYC）与密钥 B（LABEL）：联系慧眼技术支持（微信：blue-201809）
• 或在 腾讯云人脸核身控制台 注册获取密钥 A

⚠️ 重要：使用测试密钥（免费 100 次），切勿使用生产密钥，否则将产生上游计费。

部分配置支持： 仅密钥 A 可启用能力 1-7；仅密钥 B 可启用能力 8。 若用户请求未配置的能力，请明确告知缺失的密钥及获取方式。

8 项能力

能力 1：人脸比对

• 触发：“compare these two photos”、“same person?”、“face similarity”
• 用户需提供：两张含人脸照片
• 仅上传一张：请提示“请再上传第二张照片用于比对”
• 执行：python scripts/ekyc_api.py face_compare --photo1 --photo2
• 返回：similarity（0–100 分）
• 结果解释：

• 回复示例：

能力 2：照片活体检测

• 触发：“is this photo real?”、“AI-generated?”、“photoshopped?”
• 用户需提供：一张含人脸照片
• 执行：python scripts/ekyc_api.py photo_liveness_detect --file
• 返回：riskLevel（风险等级）、riskTag（风险标签编号）
• 结果解释：

• 回复示例：

能力 3：视频活体检测

• 触发：“is this video real?”、“deepfake?”、“video liveness”
• 用户需提供：含人脸视频（≤20 MB；超过 20 秒将报错）
• 视频过大：提示“视频需 ≤20 MB，请压缩后重新上传”
• 执行：python scripts/ekyc_api.py video_liveness_detect --file
• 网络重试：上传可能遇 999999 网络错误，脚本自动指数退避重试 3 次，仍失败则告知“网络繁忙，请稍后再试”
• 返回与解释：同能力 2
• 回复示例：

能力 4：身份证 OCR

• 触发：“read ID card”、“extract ID card info”
• 用户需提供：身份证照片 + 正反面标记

• 未指定面：询问“这是人像面（正面带照片）还是国徽面（背面带国徽）？”
• 执行：python scripts/ekyc_api.py id_card_ocr --image --side <0|1>
• 返回：

• 结果解释：将字段整理为清晰列表
• 回复示例（人像面）：

  媒体标签结果：
  - A14（佩戴帽子）：✅ 检出
  - A02（口罩遮挡）：❌ 未检出
  活体状态：活体
  

Step 1: GET access_token ← app_id + secret  
Step 2: GET SIGN ticket ← app_id + access_token  
Step 3: Signature = sort([appId, orderNo, nonce, "1.0.0", ticket]) → concat → SHA1 → 40 位大写

Step 1: GET ticket 直接 ← appId + secret（无需 access_token）  
Step 2: Signature = sort([appId, orderNo, nonce, "1.0.0", ticket, unixTimeStamp]) → concat → SHA1 → 40 位大写

区别：6 个参数（增加 unixTimeStamp），ticket 直接获取。 实现：scripts/label_auth.py —— 勿重写，直接调用*

法律声明

本软件不存储、缓存或保留任何提交数据。 API 核验结果仅供参考，不构成法律意义上的身份确认。 不得将本软件作为产生法律效果或重大影响的自动化决策唯一依据。 高风险身份决策应补充业务逻辑与人工审核。