前言¶

業務裏常見一步：用戶上傳一張人臉照，系統要判斷是不是翻拍——手機對着屏幕、打印紙、面具等。若在 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 一致，僅列已寫明的能力：

1. 防翻拍活體檢測：對用戶上傳的靜態圖片判斷是否爲翻拍。
2. 攻擊類型側重：高清屏幕翻拍、裁剪紙片、3D 面具等（相對普通靜態活體的增強點，見技能簡介）。
3. 輸入方式：圖片 Base64、圖片 URL；本地文件路徑可由腳本自動轉爲 Base64。
4. 腳本入口：scripts/main.py，依賴 tencentcloud-sdk-python。
5. 輸出：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 一致）：

圖片規格（技能文檔摘要）：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 端上傳圖片均可，以實際拍攝質量滿足規格爲前提）。

限制與注意

1. 僅靜態圖片：技能定位是靜態活體檢測，不是視頻流或動作活體；若需求是 AIGC 換臉、視頻攻擊等，應選用騰訊雲其他接口與對應 Skill，勿與本技能混用。
2. 合規：處理人臉個人信息需具備合法授權基礎，具體以騰訊雲官網服務協議爲準（技能 SKILL.md 亦指向官網約定）。
3. 密鑰：requires_api_key=true，勿將 TENCENTCLOUD_SECRET_* 寫入倉庫或對話日誌。
4. 閾值：默認推薦 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