ocr-passport-xiangyun — OCR护照-翔云

翔云通行证OCR概述 利用翔云开放平台的ID文档识别API对护照图像进行结构化解析，支持中文和国际护照。识别的字段包括：护照号码、姓名、姓名（拼音）、性别、出生日期、出生地、签发日期、有效期、签发机关、国籍等。 产品页面：https://www.netocr.com/products.html

触发器 以下用户表达式应触发此技能： "护照OCR"、"护照识别"、"识别护照"、"提取护照信息"、"解析护照"、"扫描护照"、"读取护照"、"护照数据提取"、"翔云护照"、"netocr护照"、"OCR此护照"、"识别护照"

工作流程

步骤1：加载配置 调用脚本/config_manager.py读取配置：python scripts/config_manager.py load 配置文件位置：config.json在技能根目录中 如果配置文件存在且包含有效的key和secret，则跳转到步骤3 如果配置文件缺失或字段为空，则转到步骤2

步骤2：首次设置（缺失配置） 通知用户："请在翔云平台（https://www.netocr.com）注册，导航到您的账户仪表板以获取您的ocrKey和ocrSecret，然后提供它们给我以完成设置。" 一旦收到key和secret： python scripts/config_manager.py save --key YOUR_KEY --secret YOUR_SECRET 这将保存凭证到config.json在技能根目录中： { "key": "用户的ocrKey", "secret": "用户的ocrSecret" }

步骤3：接受图像输入 支持的输入方法： 方法 描述 本地文件路径 用户提供绝对或相对路径 Base64字符串 用户直接粘贴Base64编码数据 URL（→Base64） 下载图像，然后转换为Base64

步骤4：调用识别API 运行识别脚本： # 本地文件（推荐——自动保存结果与图像） python scripts/recognize.py --file /path/to/passport.jpg # Base64输入 python scripts/recognize.py --base64 "BASE64_STRING_HERE" # 人类可读表格输出 python scripts/recognize.py --file /path/to/passport.jpg --output-format table # 禁用自动保存（默认：保存为{image_name}.json） python scripts/recognize.py --file /path/to/passport.jpg --no-save 成功后，结果将自动保存为{image_name}.json在源图像旁边，避免重复API调用以备后续导出。 API参数： 参数 值 描述 typeId 13 固定值用于护照识别——不要更改 format json 返回JSON格式 key 用户凭证 从config.json加载 secret 用户凭证 从config.json加载 Base64端点：POST https://netocr.com/api/recogliu.do 文件上传端点：POST https://netocr.com/api/recog.do

步骤5：格式化和显示结果 成功后，显示结果为表格： Passport识别成功

字段	值
护照号码	E12345678
姓名	张三
拼音	张三
性别	男
出生日期	1990-01-01
出生地	北京
签发日期	2020-06-01
有效期	2030-06-01
签发机关	国家移民管理局
国籍	中国

步骤6：导出结果（按需） 仅当用户明确请求导出、保存或生成文件时执行此步骤。 触发示例："导出结果"、"保存为Excel"、"生成CSV"、"导出" 首选--from-dir以直接从缓存的JSON结果导出——零API消耗。 # 推荐：从图像目录读取缓存的JSON结果（无API调用） python scripts/export.py --from-dir /path/to/images --format excel --output result.xlsx python scripts/export.py --from-dir /path/to/images --format csv --output result.csv # 管道模式（识别然后导出——用于未缓存的结果） python scripts/recognize.py --file passport.jpg | python scripts/export.py --format csv --output result.csv # 特定JSON文件 python scripts/export.py --input result.json --format excel --output result.xlsx 导出优先级：--from-dir > --batch-input > --input > stdin

错误处理 错误代码 含义 操作 -1 识别失败（图像质量差/未检测到护照） 请求用户提供更清晰的护照图像 -2 参数错误 检查请求参数 -3 服务配额不足 建议用户在翔云平台上充值 -4 身份验证失败 提示用户验证key/secret并重新配置 -5 余额不足 建议用户在翔云账户中充值 CONFIG_MISSING 凭证未配置 引导用户完成首次设置 身份验证失败时，提示用户重置：python scripts/config_manager.py reset

图像要求 类型 推荐