需启用腾讯身份证识别扩展、配置OCR密钥、设计表单并绑定图像字段、上传合规照片后提交，系统自动识别并填充身份证号码；识别失败时通过日志code排查密钥、图像或配置问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy处理入职登记、实名验证等业务时，需从用户提交的身份证照片中快速获取证件号码，但发现系统未自动识别或提取失败，则可能是图像质量、字段映射或OCR配置未正确启用。以下是实现该功能的具体操作路径：
一、启用腾讯身份证识别扩展
WorkBuddy 5.0 版本内置可插拔式证件识别能力，需手动启用腾讯官方提供的身份证识别扩展模块，该模块调用腾讯云OCR引擎，专为中文身份证优化识别准确率。
1、打开WorkBuddy控制台界面，点击左侧菜单栏「扩展中心」。
2、在搜索框中输入“腾讯身份证识别范例”，找到对应扩展并点击「一键部署」。
3、部署完成后点击「启动」按钮，确认状态变为“运行中”。
二、配置OCR访问密钥
扩展依赖腾讯云OCR服务接口，必须绑定合法的API凭证才能调用识别能力，否则所有图像上传后将返回空结果或报错。
1、点击右上角头像，进入「访问管理」页面。
2、在页面最下方找到「访问秘钥」，点击进入详情页。
3、复制「SecretId」和「SecretKey」两行值。
4、返回扩展配置页，在「OCR配置」区域的两个空白输入框中分别粘贴上述两行密钥。
5、点击「保存」，系统提示“配置更新成功”即完成授权。
三、设计表单并设置身份证图像字段
WorkBuddy需明确知道哪张图片用于识别，且必须确保图像字段在流程中未被提前覆盖或清空，否则OCR引擎接收不到原始图像数据。
1、进入「设计端」，新建或编辑目标业务表单。
2、添加一个「图片上传」组件，命名为“身份证正面照”，并勾选“允许上传单张图片”。
3、添加多个文本字段，如“姓名”“性别”“出生日期”“身份证号码”，用于承接识别结果。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
4、点击“身份证号码”字段右侧的「取值设置」，选择「提取身份证信息」公式。
5、在弹出配置中，将「来源字段」指定为前述“身份证正面照”图片组件。
6、确认字段映射关系：左侧“证件号”必须对应右侧“身份证号码”字段，严禁点击“自动填充”按钮覆盖图像字段，否则识别阶段无图可读。
四、上传图像并触发识别
WorkBuddy在用户提交表单时自动调用OCR服务，整个过程无需人工干预，识别结果实时写入对应字段，适用于批量处理场景。
1、在应用端打开已配置好的表单。
2、点击“身份证正面照”区域，从手机相册或电脑文件夹中选择一张清晰、完整、无反光的身份证正面照片。
3、确保照片中所有文字区域（尤其是右下角18位号码）完整可见，边缘无遮挡。
4、点击「提交」按钮，系统后台自动上传图像并调用OCR引擎。
5、提交成功后，“身份证号码”字段将自动填充识别结果，若显示为空，请检查图像是否模糊、倾斜角度是否超过15度、或是否误传了身份证背面。
五、本地调试与错误排查
当识别失败率偏高时，可通过WorkBuddy日志面板查看OCR请求原始响应，定位是网络问题、权限问题还是图像质量问题。
1、在控制台点击「系统日志」，筛选类型为“OCR识别”的条目。
2、点击任一条失败记录，展开查看response内容中的code字段。
3、若返回code=1002，表示SecretKey无效或已过期，请重新生成并更新配置。
4、若返回code=2001，表示图像不满足识别要求，需提示用户重拍，重点检查身份证边缘是否全部入框、字体是否被强光冲刷、是否使用截图而非原图。
5、若日志中无任何OCR相关记录，说明扩展未启动或表单未正确绑定识别公式，需返回步骤一与步骤三复核。
