港澳台通行证识别与抽取（ADP）

港澳通行证识别与抽取 技能

能力由来也科技 ADP（代理ic Document Processing）智能体文档处理平台提供，支持港澳通行证（往来港澳通行证）的智能识别与关键信息抽取能力。本 技能 调用来也科技 ADP 官方 命令行工具 工具，一条命令即可完成港澳通行证图片/扫描件的结构化字段抽取，输出标准 JSON，无缝对接业务系统。

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

快速接入指南 核心工作流 安装依赖：首次执行时，安装 ADP 命令行工具 工具。 认证配置：首次执行时，运行 adp config 获取 检查凭证。若未配置，提示用户提供 API Key。 获取应用列表：首次执行时，通过 adp 应用-id 列出 --应用-type 0 获取开箱即用应用列表，找到港澳通行证抽取应用并记录其 应用_id（以 ootb_ 开头）。后续优先使用 adp 应用-id 缓存。 执行抽取：运行 adp 提取 url --应用-id <港澳通行证抽取应用ID> 或 adp 提取 local <文件路径> --应用-id <港澳通行证抽取应用ID>。 结果处理：解析返回的 JSON，提取姓名、姓名拼音、性别、出生日期、证件号码、签发日期、有效期至、签发机关等结构化字段。 错误处理：命令失败时，解析 stderr JSON 确定错误类型和恢复操作。 场景 → 命令映射

单张识别

用户意图 推荐命令 识别一张港澳通行证图片（URL） adp 提取 url --应用-id 识别一张本地港澳通行证图片 adp 提取 local <文件路径> --应用-id 识别 Base64 编码的港澳通行证 adp 提取 base64 --应用-id --file-name <文件名.后缀>

批量识别

用户意图 推荐命令 批量识别本地文件夹内的港澳通行证 adp 提取 local <文件夹路径> --应用-id 批量识别多个 URL adp 提取 url --应用-id

异步处理

用户意图 推荐命令 异步提交大文件 adp 提取 url --应用-id --a同步 异步批量处理 adp 提取 local <文件夹路径> --应用-id --a同步 查询异步任务结果 adp 提取 查询

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

第一步：安装 ADP 命令行工具 # 方法 1: npm（推荐，全平台通用） npm 安装 -g @lAIye-adp/代理ic-doc-解析-and-提取-命令行工具

# 方法 2: Shell 脚本（Linux / macOS，无 npm 环境时使用） curl -fsSL https://raw.githubusercontent.com/lAIye-AI/adp-命令行工具/mAIn/scripts/adp-init.sh | bash

# 方法 3: PowerShell 脚本（Windows，无 npm 环境时使用） irm https://raw.githubusercontent.com/lAIye-AI/adp-命令行工具/mAIn/scripts/adp-init.ps1 | iex

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

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

• 访问 ADP 门户获取凭证

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

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

• 注册/登录后获取 API Key

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

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

• 完成认证配置

• 验证配置

注意事项：

如果 API Key 和 API Base URL 已配置完成，建议将配置信息存储到环境变量中，避免每次使用时重复配置。 如果 API Key 和 API Base URL 尚未配置，请按照以上步骤完成配置。 第三步：获取港澳通行证抽取应用 ID

ADP 为港澳通行证提供了开箱即用的内置抽取应用，无需额外配置。

应用类型说明

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

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

港澳通行证识别属于开箱即用应用，可通过 --应用-type 0 筛选查询。

查询并筛选港澳通行证应用 # 仅查询开箱即用应用（推荐） adp 应用-id 列出 --应用-type 0

# 或查询所有应用 adp 应用-id 列出

从返回列表中找到 应用_label 包含 "港澳通行证" 或 "往来港澳通行证" 的应用，记录其 应用_id：

[ { "应用_id": "ootb_***xx", "应用_label": ["港澳通行证", "往来港澳通行证", "出入境证件", "个人证件", "信息提取"], "应用_name": "港澳通行证", "应用_type": 0 } ]

上例中 "应用_id": "ootb_xx" 即为港澳通行证抽取应用。应用_type 为 0 表示开箱即用应用，1 表示自定义应用。

缓存应用 ID（推荐）

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

# 后续使用缓存 adp 应用-id 缓存

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

第四步：执行港澳通行证抽取 单张港澳通行证抽取（URL） adp 提取 url https://example.com/hk-macau-permit.jpg --应用-id <港澳通行证抽取应用ID>

单张港澳通行证抽取（本地文件） adp 提取 local ./hk-macau-permit.jpg --应用-id <港澳通行证应用ID>

单张港澳通行证抽取（Base64） adp 提取 base64 --应用-id <港澳通行证应用ID> --file-name <文件名.后缀>

返回结果示例

ADP 港澳通行证抽取统一返回结构化 JSON，精准识别港澳通行证共9个关键字段。

[ { "field_key": "name", "field_name": "姓名", "field_values": [ { "field_value": "陈" } ] }, { "field_key": "english_name", "field_name": "英文姓名", "field_values": [ { "field_value": "CHEN " } ] }, { "field_key": "gender", "field_name": "性别", "field_values": [ { "field_value": "女" } ] }, { "field_key": "date_of_birth", "field_name": "出生日期", "field_values": [ { "field_value": "1992年08月10日" } ] }, { "field_key": "certificate_number", "field_name": "证件号码", "field_values": [ { "field_value": "C*****" } ] }, { "field_key": "issue_date", "field_name": "签发日期", "field_values": [ { "field_value": "2022年03月20日" } ] }, { "field_key": "validity_period", "field_name": "有效期限", "field_values": [ { "field_value": "2032年03月19日" } ] }, { "field_key": "issuing_authority", "field_name": "签发机关", "field_values": [ { "field_value": "xx市公安局出入境管理处" } ] } { "field_key": "document_machine_readable_code", "field_name": "证件机读码", "field_values": [ { "field_value": "123456" } ] } ]

抽取字段说明

ADP 港澳通行证抽取返回以下字段：

field_key field_name 说明 name 姓名 持证人中文姓名 english_name 英文姓名 持证人英文姓名 gender 性别 男 / 女 date_of_birth 出生日期 出生日期 certificate_number 证件号码 港澳通行证证件号码 issue_date 签发日期 证件签发日期 validity_period 有效期限 证件有效期限 issuing_authority 签发机关 签发机关名称 document_machine_readable_code 证件机读码 证件机读码 返回字段通用结构

每个字段遵循以下结构：

字段 类型 说明 field_key string 字段标识（机器可读） field_name string 字段名称（