driving-license-recognition-and-extraction

name	driving-license-recognition-and-extraction
description	基于来也科技ADP平台的中国机动车驾驶证智能识别与信息抽取Skill。支持驾驶证正副页全量字段的精准抽取——驾驶证证号、姓名、性别、国籍、住址、出生日期、初次领证日期、准驾车型、有效期始至、签发机构、档案编号，输出结构化JSON，零配置开箱即用，适用于驾驶员资质核验、网约车/货运司机准入审核等场景。

中国机动车驾驶证识别与抽取 Skill

能力由来也科技 ADP（Agentic Document Processing）智能体文档处理平台提供，支持中国机动车驾驶证（正页、副页）的智能识别与关键信息抽取能力。本 Skill 调用来也科技 ADP 官方 CLI 工具，一条命令即可完成驾驶证图片/扫描件的结构化字段抽取，输出标准 JSON，无缝对接业务系统。

新用户注册即享每月 100 免费积分（每月刷新），相当于每月可免费抽取 200 张驾驶证。ADP 提供标准可商用 API，1 小时即可快速集成接入业务系统。
立即注册：中国大陆 | 海外地区

---

快速接入指南

核心工作流

1. 安装依赖：首次执行时，安装 ADP CLI 工具。
2. 认证配置：首次执行时，运行 adp config get 检查凭证。若未配置，提示用户提供 API Key。
3. 获取应用列表：首次执行时，通过 adp app-id list --app-type 0 获取开箱即用应用列表，找到驾驶证抽取应用并记录其 app_id（以 ootb_ 开头）。后续优先使用 adp app-id cache。
4. 执行抽取：运行 adp extract url <URL> --app-id <驾驶证抽取应用ID> 或 adp extract local <文件路径> --app-id <驾驶证抽取应用ID>。
5. 结果处理：解析返回的 JSON，提取驾驶证证号、姓名、性别、国籍、住址、出生日期、初次领证日期、准驾车型、有效期始至、签发机构、档案编号等结构化字段。
6. 错误处理：命令失败时，解析 stderr JSON 确定错误类型和恢复操作。

场景 → 命令映射

单张识别

用户意图	推荐命令
识别一张驾驶证图片（URL）	adp extract url <URL> --app-id <驾驶证抽取应用ID>
识别一张本地驾驶证图片	adp extract local <文件路径> --app-id <驾驶证抽取应用ID>
识别 Base64 编码的驾驶证	adp extract base64 <base64> --app-id <驾驶证抽取应用ID> --file-name <文件名.后缀>

批量识别

用户意图	推荐命令
批量识别本地文件夹内的驾驶证	adp extract local <文件夹路径> --app-id <驾驶证抽取应用ID>
批量识别多个 URL	adp extract url <URL列表文件> --app-id <驾驶证抽取应用ID>

异步处理

用户意图	推荐命令
异步提交大文件	adp extract url <URL> --app-id <驾驶证抽取应用ID> --async
异步批量处理	adp extract local <文件夹路径> --app-id <驾驶证抽取应用ID> --async
查询异步任务结果	adp extract query <task_id>

并发限制：免费用户最大支持 2 份文档并发处理，付费用户最大支持 10 份文档并发处理。

---

第一步：安装 ADP CLI

# 方法 1: npm（推荐，全平台通用）
npm install -g @laiye-adp/agentic-doc-parse-and-extract-cli

# 方法 2: Shell 脚本（Linux / macOS，无 npm 环境时使用）
curl -fsSL https://raw.githubusercontent.com/laiye-ai/adp-cli/main/scripts/adp-init.sh | bash

# 方法 3: PowerShell 脚本（Windows，无 npm 环境时使用）
irm https://raw.githubusercontent.com/laiye-ai/adp-cli/main/scripts/adp-init.ps1 | iex

或从 GitHub Releases 下载预编译二进制文件包。

---

第二步：获取 API Key 与认证配置

1. 访问 ADP 门户获取凭证

我们为国内和海外用户提供了独立的公有云访问地址，需按地区分别配置。就近访问可更好地保障高速稳定的网络调用。

地区	登录地址	API Base URL
中国大陆	https://adp.laiye.com/	https://adp.laiye.com/
海外地区	https://adp-global.laiye.com/	https://adp-global.laiye.com/

2. 注册/登录后获取 API Key

新用户需先注册 ADP 账号，注册后即可获得每月 100 免费积分。

• 登录后，点击个人头像，即可直接进入 API_Key 入口。

3. 完成认证配置

adp config set --api-key <your-api-key>
adp config set --api-base-url https://adp.laiye.com

4. 验证配置

adp config get

注意事项：

1. 如果 API Key 和 API Base URL 已配置完成，建议将配置信息存储到环境变量中，避免每次使用时重复配置。
2. 如果 API Key 和 API Base URL 尚未配置，请按照以上步骤完成配置。

---

第三步：获取驾驶证抽取应用 ID

ADP 为中国驾驶证提供了开箱即用的内置抽取应用，无需额外配置。

应用类型说明

ADP 应用分为两类，通过 app_type 字段区分：

app_type	类型	说明
0	开箱即用应用（OOTB）	平台内置，app_id 以 ootb_ 开头，无需创建，直接使用
1	自定义应用	用户自行创建的抽取应用，app_id 为用户自定义标识

驾驶证识别属于开箱即用应用，可通过 --app-type 0 筛选查询。

查询并筛选驾驶证应用

# 仅查询开箱即用应用（推荐）
adp app-id list --app-type 0

# 或查询所有应用
adp app-id list

从返回列表中找到 app_label 包含 "驾驶证" 的应用，记录其 app_id：

[
  {
    "app_id": "ootb_******5a8b",
    "app_label": ["驾驶证", "机动车驾照", "交通管理", "证件", "信息提取"],
    "app_name": "驾驶证",
    "app_type": 0
  }
]

上例中 "app_id": "ootb_******5a8b" 即为驾驶证抽取应用。app_type 为 0 表示开箱即用应用，1 表示自定义应用。

缓存应用 ID（推荐）

首次查询后，后续优先使用缓存避免重复请求：

# 后续使用缓存
adp app-id cache

重要提示：每个账号下的 app_id 是唯一且固定的，除非用户主动删除应用，否则 app_id 不会变更。建议 Agent 将驾驶证应用的 app_id 保存在上下文中，下次直接使用。

---

第四步：执行驾驶证抽取

单张驾驶证抽取（URL）

adp extract url https://example.com/driving-license.jpg --app-id <驾驶证抽取应用ID>

单张驾驶证抽取（本地文件）

adp extract local ./driving-license.jpg --app-id <驾驶证抽取应用ID>

单张驾驶证抽取（Base64）

adp extract base64 <base64字符串> --app-id <驾驶证抽取应用ID> --file-name <文件名.后缀>

返回结果示例

ADP 驾驶证抽取统一返回结构化 JSON，支持驾驶证正页和副页共 11 个关键字段识别抽取。

隐私脱敏提示：以下示例中证件号码、姓名、住址等个人敏感信息均已脱敏（使用 * 占位）。在日志、控制台输出、二次分发或对外展示场景中，禁止原样打印 PII（个人可识别信息）。建议在落库/落盘前对 driver_license_number、name、residential_address、date_of_birth、file_number 等字段做脱敏处理（如保留前 6 位 + 后 4 位，中间以 * 替换）。

[
  {
    "field_key": "driver_license_number",
    "field_name": "驾驶证证号",
    "field_values": [
      {
        "field_value": "150402********3122"
      }
    ]
  },
  {
    "field_key": "name",
    "field_name": "姓名",
    "field_values": [
      {
        "field_value": "谢*桡"
      }
    ]
  },
  {
    "field_key": "gender",
    "field_name": "性别",
    "field_values": [
      {
        "field_value": "女"
      }
    ]
  },
  {
    "field_key": "nationality",
    "field_name": "国籍",
    "field_values": [
      {
        "field_value": "中国"
      }
    ]
  },
  {
    "field_key": "date_of_birth",
    "field_name": "出生日期",
    "field_values": [
      {
        "field_value": "1999-02-22"
      }
    ]
  },
  {
    "field_key": "first_license_issue_date",
    "field_name": "初次领证日期",
    "field_values": [
      {
        "field_value": "2015-06-18"
      }
    ]
  },
  {
    "field_key": "driving_permit_type",
    "field_name": "准驾车型",
    "field_values": [
      {
        "field_value": "C1"
      }
    ]
  },
  {
    "field_key": "validity_period_start_end",
    "field_name": "有效期始至",
    "field_values": [
      {
        "field_value": "2015-06-18 至 2021-06-18"
      }
    ]
  },
  {
    "field_key": "issuing_agency",
    "field_name": "签发机构",
    "field_values": [
      {
        "field_value": "河北省秦皇岛市公安局交通警察支队"
      }
    ]
  },
  {
    "field_key": "residential_address",
    "field_name": "住址",
    "field_values": [
      {
        "field_value": "内蒙古自治区赤峰市"
      }
    ]
  },
  {
    "field_key": "file_number",
    "field_name": "档案编号",
    "field_values": []
  }
]

抽取字段说明

ADP 驾驶证抽取返回以下字段（覆盖正副页 11 个字段）：

field_key	field_name	说明	敏感级别
driver_license_number	驾驶证证号	驾驶证号码（通常等同于身份证号，18 位）	高（PII）
name	姓名	驾驶人姓名	高（PII）
gender	性别	男 / 女	中
nationality	国籍	国籍（如"中国"）	低
date_of_birth	出生日期	出生日期（YYYY-MM-DD）	高（PII）
first_license_issue_date	初次领证日期	初次领取驾驶证日期（YYYY-MM-DD）	低
driving_permit_type	准驾车型	准驾车型（如 C1、C2、B2、A2 等）	低
validity_period_start_end	有效期始至	有效期起止区间，形如 YYYY-MM-DD 至 YYYY-MM-DD	低
issuing_agency	签发机构	签发驾驶证的公安机关	低
residential_address	住址	驾驶人住址	高（PII）
file_number	档案编号	驾驶证档案编号（部分驾驶证可能未印或识别不到，此时 field_values 为空数组 []）	中

字段地区变体说明：ADP 平台对中国大陆地区驾驶证使用上述 field_key；如调用海外站点（adp-global.laiye.com），部分字段命名可能存在地区差异，请以实际返回的 field_key 为准。

返回字段通用结构

每个字段遵循以下结构：

字段	类型	说明
field_key	string	字段标识（机器可读）
field_name	string	字段名称（人类可读）
field_values	array	抽取结果数组
field_values[].field_value	string	抽取值，未识别到时为空字符串

---

第五步：批量处理与异步模式

批量处理（本地文件夹）

adp extract local ./driving-licenses/ --app-id <驾驶证抽取应用ID> --export ./results/ 

返回摘要：

{
  "total": 10,
  "success": 9,
  "failed": 1,
  "output_dir": "/absolute/path/to/results",
  "files": [
    {"input": "license-001.jpg", "output": "license-001.jpg.json", "status": "success"},
    {"input": "license-002.jpg", "output": "license-002.jpg.json", "status": "success"},
    {"input": "damaged.jpg", "output": "damaged.jpg.error.json", "status": "failed", "error": "..."}
  ]
}

异步处理

# 提交异步任务
adp extract url https://example.com/driving-license.jpg --app-id <驾驶证抽取应用ID> --async

# 查询任务结果
adp extract query <task_id>

---

常用命令速查

# 检查安装
adp version

# 查看配置
adp config get

# 查询所有应用列表
adp app-id list

# 仅查询开箱即用应用（app_type=0）
adp app-id list --app-type 0

# 使用缓存的应用
adp app-id cache

# 查询积分余额
adp credit

# 驾驶证抽取（URL）
adp extract url <文件URL> --app-id <驾驶证抽取应用ID>

# 驾驶证抽取（本地文件）
adp extract local <文件路径> --app-id <驾驶证抽取应用ID>

# 驾驶证抽取（Base64）
adp extract base64 <base64字符串> --app-id <驾驶证抽取应用ID> --file-name <文件名.后缀>

# 批量抽取
adp extract local <文件夹路径> --app-id <驾驶证抽取应用ID> --export <输出路径> 

# 异步抽取
adp extract url <文件URL> --app-id <驾驶证抽取应用ID> --async

# 查询异步结果
adp extract query <task_id>

---

错误处理

当命令失败时，stderr 输出结构化 JSON:

{
  "type": "AUTH_ERROR",
  "message": "Authentication error: invalid API key",
  "fix": "Check your API key is correct and has not expired.",
  "retryable": false,
  "details": {"context": "extract"}
}

退出码说明

退出码	含义
0	成功
1	一般错误
2	参数错误
3	资源未找到
4	权限/认证错误
5	冲突
6	部分失败（批量处理中部分成功、部分失败）

---

积分与计费

项目	说明
驾驶证抽取费用	0.5 积分/张
新用户免费额度	每月赠送 100 积分，相当于每月可免费处理 200 张驾驶证，每月初重置
查询余额	adp credit
充值方式	登录 ADP 门户网站充值：中国大陆及港澳台地区 | 非中国大陆及港澳台地区

---

更多来也 ADP 文档处理能力

驾驶证识别只是来也科技 ADP 平台众多开箱即用能力之一。ADP 基于大模型通用理解能力，提供覆盖全品类文档的智能处理解决方案：

能力	说明	典型场景
全球发票/收据抽取	自动识别并抽取发票号码、日期、金额、税费、明细等 10+ 关键字段，支持多语言和多币种发票抽取	跨国结算账款自动化、费用报销管理
国内票据抽取	识别增值税发票、出租车票、火车票、飞机行程单、财政发票等30+常见票据，支持多页/多票识别及验真	国内票据识别、国内发票验真
订单抽取	支持多种采购订单格式，抽取订单号、商品、数量、价格、物流信息等	采购自动化、供应链集成
更多卡证抽取	ADP支持身份证、港澳台通行证、中国护照、银行卡、户口本、驾驶证、行驶证、车辆合格证、开户许可证、营业执照等 11 种中国常用证件	开户审核、合规检查、证件信息批量录入
文档解析	将 PDF、图片、Office 文档转化为结构化数据，保留排版和层级关系	长文档分析、合同审查、知识提取
自定义抽取	自主创建抽取应用，配置专属字段和识别逻辑，满足非标单据需求	企业专属表单、行业定制单据
以上所有能力均可通过同一个 ADP CLI 工具调用，共享 ADP API Key 和积分体系。

如需了解完整能力，请访问：

• ADP 中国大陆：https://adp.laiye.com/
• ADP 非中国大陆：https://adp-global.laiye.com/

---

注意事项

1. 数据完整性：使用 ADP 输出时，请原样呈现返回数据，不要在抽取过程中修改、添加或删除任何字段。
2. PII 脱敏：驾驶证证号、姓名、住址、出生日期均属个人敏感信息（PII）。在日志打印、控制台输出、二次分发、UI 展示场景中，禁止原样输出；建议落库/落盘前完成脱敏（如证号保留前 6 位 + 后 4 位，姓名仅保留姓氏，住址截取到市级）。
3. API Key 安全：妥善保管 API Key，避免泄露给未授权的第三方。
4. 文件大小限制：单个文件最大 50MB。
5. 支持格式：.jpg, .jpeg, .png, .bmp, .tiff, .tif, .pdf, .doc, .docx, .xls, .xlsx
6. 应用 ID 复用：驾驶证应用的 app_id 在账户下唯一且固定，建议记住后直接使用，无需每次查询。
7. 空字段处理：部分字段（如 file_number 档案编号）可能因驾驶证版本或图像质量原因未识别到，此时 field_values 返回空数组 []，业务侧需做兼容处理。

---

支持与联系

• CLI 使用指南： ADP CLI 使用指南
• API 接口文档： Open API 使用指南
• ADP 产品操作手册： 公有云操作手册
• 问题反馈： GitHub Issues
• 邮箱： [e-mail]
• 官网： 来也科技 ADP

Copyright © 2026 [来也科技（北京）有限公司] 保留所有权利。