前言¶
在家庭监控、办公区门禁或访客记录场景里，常见需求不是「画面里有没有人」，而是「画面里是谁、出现在哪一块区域」。若只靠通用视觉模型做开放域描述，身份结论不稳定，也很难和自家成员或员工名单对齐。
下面介绍 SkillHub 上的 Acquaintance Recognition & Analysis Skill | 熟人识别分析技能：通过人脸图片比对，在视频或静态图中识别已录入底库的熟人，并在结果里标明位置与身份，面向家庭与办公区域的身份核验类任务。
这是什么¶
熟人识别分析技能是一条社区来源（community）的 Agent Skill，坐标为 @user_bb47e3e3/familiar-person-recognition-analysis，当前页面标注版本为 1.0.10，分类为 it-ops-security，由发布者 user_bb47e3e3 维护。
官方简介说明其能力边界：对人脸照片做比对，在视频或图片中识别熟人；支持底库录入；识别结果会说明「哪个位置是谁」；适用于家庭、办公区域的身份核验。页面标签标明 requires_api_key=false，即按 SkillHub 展示无需额外配置 API Key 即可安装使用（具体运行仍取决于本机 Agent 与技能包内说明）。
- SkillHub 页面：https://www.skillhub.cn/skills/user_bb47e3e3/familiar-person-recognition-analysis
- API 坐标页：https://api.skillhub.cn/user_bb47e3e3/familiar-person-recognition-analysis
核心功能¶
以下能力均来自 SkillHub 页面与已抓取元数据，不展开未在资料中出现的接口或参数。
- 熟人识别：对视频或图片中的人脸，与已有人脸底库进行比对，判断是否为已录入的熟人。
- 底库录入：支持将熟人的人脸资料写入底库，供后续识别引用。
- 位置与身份关联：识别结果不仅给出身份判断，还关联画面中的位置信息，便于回答「谁在画面的哪一处」。
- 场景定位：官方说明适用于家庭、办公区域等需要身份核验的环境，而非泛化的开放世界人脸识别产品描述。
安装与启用¶
SkillHub 提供两种常见安装方式：让 AI 按安装文档操作，或在本机使用 skillhub CLI。
通过提示词交给 AI 安装¶
将下面意图发给当前使用的 AI Agent（需能读取 SkillHub 安装说明）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_bb47e3e3/familiar-person-recognition-analysis`。
Agent 会按 SkillHub 安装与优先源配置 检查 CLI、选择正确的 skills 目录并完成安装。
使用 skillhub CLI¶
先确认是否已安装 CLI：
command -v skillhub && skillhub --version
未安装时，可按官方文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装技能时，必须用 --dir 指向当前 Agent 实际使用的 skills 目录；否则默认会装到 ./skills/，Agent 可能无法加载。官方文档给出的常见路径示例：
| 环境 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
安装本技能的命令形式为（将 <skills 目录> 替换为上表对应路径）：
skillhub install @user_bb47e3e3/familiar-person-recognition-analysis --dir <skills 目录>
也可先搜索再安装：
skillhub search familiar-person-recognition-analysis
skillhub install @user_bb47e3e3/familiar-person-recognition-analysis --dir <skills 目录>
安装后需按所用 Client 的要求重启或刷新 Agent，使 SKILL.md 被加载。Cursor、Codex CLI、Claude Code 的差异主要体现在 skills 目录位置；安装命令本身在 SkillHub 文档中统一为 skillhub install ... --dir，未单独列出各客户端的不同子命令。
典型用法¶
公开页面未提供逐行 API 示例，典型工作流可按官方能力描述在 Agent 对话中复现，步骤如下。
- 确认技能已装入当前 Agent 的 skills 目录，并能在技能列表或行为中看到熟人识别相关说明（技能包内为通用
SKILL.md格式）。 - 底库录入：向 Agent 提供待登记熟人的人脸图片（及 Agent 或技能文档要求的标识信息），完成底库录入。
- 发起识别：提供待分析的视频或图片，说明需要识别其中的熟人并关心位置信息。
- 查看结果：根据 Agent 返回的识别输出，核对「谁」与「在画面中的哪个位置」是否与底库一致。
具体字段名、工具调用名以安装后的 SKILL.md 为准；本文不编造未出现在 SkillHub 资料中的配置项或示例请求体。
适用场景与注意¶
适合谁
- 需要在家庭或办公监控画面中，对已登记成员做身份核对，而不是对陌生人做大规模建档。
- 希望由 Agent 编排「录入底库 → 对新媒体识别 → 解释位置」的流程，而不是单独集成一套人脸识别 SDK。
限制与注意
- 能力描述依赖人脸比对与底库质量；录入照片与实拍角度、光照差异过大时，识别效果会受影响，这一点属于该类方案的共性，而非本页单独承诺的指标。
- 涉及人脸与监控数据时，需遵守所在地隐私与安防合规要求；技能本身不提供法律合规审查。
- SkillHub 页面展示的统计（截至抓取时：评分 100000、下载 823）仅反映商店侧数据，不代表你的环境下的识别准确率。
- 社区技能（
community）升级与维护节奏取决于发布者；生产环境使用前建议在测试素材上验证版本 1.0.10 的行为。
结尾¶
熟人识别分析技能把「底库录入 + 视频/图片人脸比对 + 位置是谁」收敛成一条可安装的 Agent Skill，标签上无需 API Key，安装路径与 SkillHub 生态一致。若你的场景是家庭或办公区的熟人身份核验，可从官方页面获取最新说明并安装：
https://www.skillhub.cn/skills/user_bb47e3e3/familiar-person-recognition-analysis
