前言¶
实名认证、开户、政务填报等流程里，经常要把身份证照片里的姓名、身份证号、住址等字段录入系统。手写或肉眼抄写容易错，自己对接 OCR 又要处理图片编码、正反面字段映射和接口鉴权。若你已经在用 Cursor、Claude Code 等支持 Skills 的 Agent，可以把「识别二代身份证」交给 SkillHub 上的企业技能 @tencent-adm/tencentcloud-ocr-idcard，由 Agent 按技能说明调用腾讯云身份证识别（IDCardOCR）接口。
这是什么¶
腾讯云身份证识别 是 SkillHub 坐标 @tencent-adm/tencentcloud-ocr-idcard 的技能包，当前版本 1.0.5，来源为 enterprise，由 腾讯云文字识别团队 发布，分类为 dev-programming。技能封装腾讯云 IDCardOCR 能力：从中国大陆居民二代身份证正反面图片中提取结构化信息，并支持 Base64、URL 两种图片输入方式，同时具备身份证照片裁剪与多种告警相关能力（以技能内说明为准）。
SkillHub 页面标注 requires_api_key=true，使用前需准备腾讯云文字识别相关 API 密钥，并按技能文档完成配置。
核心功能¶
以下能力均来自 SkillHub 与官方技能页简介，可与腾讯云 IDCardOCR 产品能力对应理解：
- 正反面字段提取：姓名、性别、民族、出生日期、住址、身份证号；反面含签发机关、有效期限等。
- 两种图片输入：支持图片 Base64 与 URL 传入识别请求。
- 图像与质量相关能力：支持身份证图片照片裁剪；具备多种告警功能（具体告警项以技能内文档及腾讯云接口返回为准）。
安装与启用¶
官方技能页写明：安装请参照 SkillHub 安装与优先源配置，安装坐标 @tencent-adm/tencentcloud-ocr-idcard。
1、安装 SkillHub CLI（若尚未安装）¶
先检查本机是否已有 skillhub：
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
2、安装技能到当前 Agent 的 skills 目录¶
安装文档要求：安装时必须用 --dir 指向当前 Agent 正在使用的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法加载。
skillhub install @tencent-adm/tencentcloud-ocr-idcard --dir <你的 skills 目录>
常用客户端 skills 路径（摘自安装文档，按你实际环境选择其一）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
安装后按所用客户端要求重启或刷新 Agent，使技能生效。
3、API 密钥¶
技能标签为 requires_api_key=true。具体环境变量名、配置文件路径以技能包内 SKILL.md 及腾讯云控制台说明为准；勿将 SecretId、SecretKey 写入仓库或对话日志。
典型用法¶
技能设计目标是：当用户需要识别身份证图片中二代证正反面信息时，由 Agent 选用本技能并调用 IDCardOCR。
可复现的操作路径如下（不编造未公开的接口参数名）：
- 在对话中说明要识别正面或反面，并提供图片：本地文件（由 Agent 按技能要求转为 Base64）或可公网访问的 图片 URL。
- 确认 Agent 已加载
@tencent-adm/tencentcloud-ocr-idcard，且你已按技能文档配置腾讯云 API 密钥。 - 让 Agent 返回结构化字段（姓名、性别、民族、出生日期、住址、身份证号、签发机关、有效期限等），并对照原图做人工抽检。
若需核对字段含义或与告警码对应关系，应查阅技能包内文档及腾讯云 IDCardOCR 官方 API 文档，本文不展开未出现在 SkillHub 简介中的请求示例。
适用场景与注意¶
适合谁
- 已在 Agent 工作流中处理证件照、需要快速抽出二代证字段的开发者。
- 希望复用腾讯云文字识别团队维护的企业技能，而不是从零写 OCR 调用脚本的场景。
限制与注意
- 识别对象为中国大陆居民二代身份证正反面；港澳台或其他证件类型不在本技能简介范围内。
- 依赖腾讯云账号与 API 密钥，产生调用费用与合规义务需自行评估。
- SkillHub 统计（以抓取资料为准）：评分 100000，下载 2687，安装 131；数据会随时间变化，以 SkillHub 页面为准。
- 含个人身份信息的图片与识别结果应遵守最小必要、加密存储与访问控制等要求。
结尾¶
@tencent-adm/tencentcloud-ocr-idcard 把腾讯云 IDCardOCR 封进 Agent Skill：在需要二代证结构化字段时，用 Base64 或 URL 供图、由技能引导完成识别与字段整理。安装与优先源配置见 skillhub.md；技能详情与版本见 SkillHub：https://www.skillhub.cn/skills/tencent-adm/tencentcloud-ocr-idcard，API 入口：https://api.skillhub.cn/tencent-adm/tencentcloud-ocr-idcard。
