前言¶

停車場、路側抓拍、風控審覈裏，經常要從一張車圖裏讀出車牌號，還要知道顏色和位置。自己接 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。