前言¶

停车场、路侧抓拍、风控审核里，经常要从一张车图里读出车牌号，还要知道颜色和位置。自己接 OCR SDK、写鉴权与参数校验，在对话式开发里往往重复劳动。下面介绍 SkillHub 上的企业技能 腾讯云车牌识别（@tencent-adm/tencentcloud-ocr-licenseplate）：把腾讯云 LicensePlateOCR 封装成 Agent 可遵循的 SKILL.md 与脚本，在需要识别中国大陆机动车车牌时由模型按文档触发调用。

这是什么¶

腾讯云车牌识别 是腾讯云文字识别团队发布的 Skill（来源：enterprise，分类：dev-programming，当前版本 1.0.3）。它面向「中国大陆机动车车牌」的自动定位与识别，底层对应接口文档 车牌识别（请求域名 ocr.tencentcloudapi.com，Action 为 LicensePlateOCR）。

与在业务代码里直接拼 API 相比，该 Skill 把使用时机、环境变量、脚本入口和返回字段说明写进技能包，便于 Cursor、Claude Code 等带 Skills 的客户端在对话中稳定执行。

核心功能¶

以下能力均来自技能简介与包内 SKILL.md，并与官方 API 说明一致：

1. 车牌号码：识别并返回号码（示例格式如 京AF0236）。
2. 车牌颜色：支持白、黑、蓝、绿、黄、黄绿、临牌、喷漆、其它。
3. 置信度与坐标：返回 0–100 的置信度，以及车牌在原图中的像素框（X、Y、Width、Height）。
4. 多车牌：一张图多个车牌时，通过 LicensePlateInfos 列出全部结果，并附带 PlateCount。
5. 车牌类别：如实体车牌、非实体车牌等（字段 LicensePlateCategory）。
6. 输入方式：ImageUrl 与 ImageBase64 二选一；两者都传时仅使用 URL。

官方接口默认频率限制为 10 次/秒（见腾讯云文档）。Skill 标签标明 requires_api_key=true，需配置腾讯云 API 密钥后方可调用。

安装与启用¶

安装 SkillHub CLI¶

若本机尚未安装 CLI，可先检查版本：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装说明 执行完整安装（示例）：

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

安装本技能¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被客户端加载。

skillhub install tencentcloud-ocr-licenseplate --namespace tencent-adm --dir ~/.cursor/skills/

各客户端常见 skills 路径（摘自 SkillHub 安装文档，按实际环境选择）：

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

也可在 SkillHub 技能页将安装提示发给 AI，让其按 https://skillhub.cn/install/skillhub.md 安装 @tencent-adm/tencentcloud-ocr-licenseplate。

运行环境与密钥¶

技能包要求：

• Python 3.6+
• 依赖：pip install tencentcloud-sdk-python
• 环境变量：
• TENCENTCLOUD_SECRET_ID
• TENCENTCLOUD_SECRET_KEY

需在腾讯云开通文字识别相关服务并保证账号计费正常；欠费、资源包耗尽等会对应文档中的业务错误码（如 ResourceUnavailable.InArrears）。

典型用法¶

进入技能目录后，通过 scripts/main.py 发起识别。参数与 API 一致：ImageUrl / ImageBase64 二选一；图片支持 PNG、JPG、JPEG，不支持 GIF；Base64 编码后不超过 10M，URL 下载不超过 3 秒。

通过图片 URL：

python scripts/main.py --image-url "https://example.com/car.jpg"

通过本地图片（脚本侧做 Base64）：

python scripts/main.py --image-base64 ./car.jpg

指定地域（可选）：

python scripts/main.py --image-url "https://example.com/car.jpg" --region ap-beijing

成功时返回 JSON，核心字段包括 Number、Confidence、Color、Rect、LicensePlateInfos、PlateCount、RequestId 等（结构与技能文档中的示例一致）。

在 Agent 对话中的典型表述可以是：「识别这张图里的车牌颜色和号码」并附上图片路径或 URL；模型在匹配「车牌 OCR」「多车牌」等意图时应加载本 Skill 并调用上述脚本，而不是自行编造识别结果。

适用场景与注意¶

适合：

• 需要在中国大陆场景下识别机动车车牌，并要颜色、置信度、框选坐标或多车牌列表。
• 已在用腾讯云 OCR，希望把 LicensePlateOCR 的调用方式固化给编码 Agent。

注意：

1. 识别对象为中国大陆机动车车牌；跨境或其他证件类型应选用对应 OCR 技能或接口。
2. 仅支持 PNG/JPG/JPEG；大图、模糊图、下载超时可能触发 FailedOperation.DownLoadError、LimitExceeded.TooLargeFileError 等错误。
3. 调用产生腾讯云 OCR 费用，需自行管控密钥与配额；密钥不要写入仓库或对话日志。
4. SkillHub 页显示本技能评分 100000，下载 2063 次、安装 140 次（统计以 SkillHub 展示为准）。

结尾¶

腾讯云车牌识别 把 LicensePlateOCR 的触发条件、脚本用法和返回结构收敛进一个 Skill，适合在 Agent 工作流里做车牌结构化抽取。官方入口：https://api.skillhub.cn/tencent-adm/tencentcloud-ocr-licenseplate；SkillHub 浏览页：https://www.skillhub.cn/skills/tencent-adm/tencentcloud-ocr-licenseplate。