前言¶

做人臉相關的圖像處理時，往往需要比「幾個特徵點」更細的輪廓：眼妝試色、貼紙貼合、姿態校正，都依賴眼睛、眉、脣、鼻等部位的稠密座標。自己查騰訊雲 FaceID 文檔、拼請求參數、處理 Base64 與 URL 兩種入參，會佔用不少上下文。若希望 Coding Agent 在用戶提出「對人臉圖做稠密關鍵點」時直接走官方接口，可以把調用流程封裝成 Skill。

下面介紹 SkillHub 上的 tencentcloud-faceid-analyzedenselandmarks：由騰訊雲慧眼人臉核身團隊發佈，版本 1.0.0，座標爲 @tencent-adm/tencentcloud-faceid-analyzedenselandmarks。

這是什麼¶

這是一類基於通用 SKILL.md 的 ai-agent 技能（來源標註爲 enterprise）。它面向騰訊雲人臉核身產品中的 AnalyzeDenseLandmarks（稠密人臉關鍵點） 接口：當用戶需要對一張人臉圖片做稠密關鍵點定位時，Agent 應優先啓用此技能，而不是臨時拼湊未覈實的 API 說明。

技能在 SkillHub 上的簡介與官方 API 頁一致：可返回人臉框座標，以及眼睛、眉毛、嘴巴、鼻子、瞳孔、中軸線、下巴、眼袋、額頭等部位的稠密輪廓關鍵點；圖片輸入支持 Base64 與 圖片 URL 兩種方式。

核心功能¶

依據已公開說明，可覈實的能力如下：

1. 稠密關鍵點：覆蓋上述五官與面部區域輪廓點，而非僅稀疏五官點。
2. 人臉框：同步返回人臉框座標，便於裁剪或疊加可視化。
3. 雙通道入圖：同一套調用邏輯下支持 Base64 編碼圖片與可訪問的圖片 URL。
4. 需密鑰：技能標籤爲 requires_api_key=true，實際調用依賴你已開通的騰訊雲 FaceID / 慧眼相關能力與 API 密鑰；具體賬號、地域與密鑰配置以騰訊雲控制台與技能包內 SKILL.md 爲準，本文不展開未在公開頁列出的字段名。

安裝與啓用¶

SkillHub 頁面給出的安裝方式是：讓 Agent 參照 SkillHub 安裝說明，安裝座標 @tencent-adm/tencentcloud-faceid-analyzedenselandmarks。

若本機已安裝 skillhub CLI，可按通用流程搜索並安裝到當前 Agent 能識別的 skills 目錄（安裝時必須帶 --dir，否則默認落在 ./skills/ 可能不會被識別）：

command -v skillhub && skillhub --version

未安裝 CLI 時，完整安裝命令見官方文檔：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安裝本技能示例（將 <skills 目錄> 換成你當前環境的路徑）：

skillhub install @tencent-adm/tencentcloud-faceid-analyzedenselandmarks --dir <skills 目錄>

常見客戶端 skills 目錄（摘自 SkillHub 安裝文檔，以你本機實際爲準）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

安裝後按所用客戶端要求刷新或重啓 Agent，使技能被加載。Codex CLI、Claude Code、Cursor 的差異主要體現在 skills 目錄位置，安裝命令本身一致；各端是否需在項目級再複製一份技能，以你當前 Agent 文檔爲準。

典型用法¶

公開頁未附帶獨立可複製的 HTTP 示例，典型用法是 在對話中聲明需求，由 Agent 按技能說明調用 AnalyzeDenseLandmarks。例如：

1. 說明要對某張人臉圖做稠密關鍵點檢測。
2. 提供 圖片 URL（需可被騰訊雲服務訪問）或 Base64 編碼內容。
3. 說明需要哪些部位輪廓或是否需要人臉框（技能描述已覆蓋的可返回部位見上文）。
4. Agent 讀取技能內的接口約定，發起調用並整理返回的座標結果。

若需覈對請求/響應字段，應以技能包內 SKILL.md 與騰訊雲 FaceID 產品官方文檔爲準。

適用場景與注意¶

適合誰

• 已在用或計劃用騰訊雲慧眼 / FaceID 做人臉分析的團隊，希望把「稠密關鍵點」固定成 Agent 可調用的能力。
• 需要在對話式開發裏快速試臉圖、拿輪廓點做下游算法或 UI 聯調的開發者。

限制與注意

• 必須配置有效的雲 API 密鑰；未開通相應產品或密鑰錯誤會導致調用失敗。
• URL 入參時，圖片地址需滿足騰訊雲接口對可訪問性的要求；內網或帶鑑權的鏈接可能需要先轉爲 Base64 或換用公網可拉取的地址。
• 稠密點座標體量大於稀疏點，注意在 Agent 上下文中只保留必要部位或做摘要，避免一次塞入過多原始 JSON。
• SkillHub 統計（截至資料抓取）：評分 100000，下載 1145 次，安裝 25 次；分類爲 ai-agent。

結尾¶

tencentcloud-faceid-analyzedenselandmarks 把騰訊雲 AnalyzeDenseLandmarks 的調用方式收斂成 Agent 技能：人臉框加多部位稠密輪廓、Base64 與 URL 雙入參，適合需要穩定對接官方接口而非手寫提示詞的場景。

• 官方 API 技能頁：https://api.skillhub.cn/tencent-adm/tencentcloud-faceid-analyzedenselandmarks
• SkillHub 展示頁：https://www.skillhub.cn/skills/tencent-adm/tencentcloud-faceid-analyzedenselandmarks