身份证正反面合并 A4 PDF

概述

身份证正反面合并到A4 输出PDF

适用范围

用户提供身份证正面和反面 JPG/PNG，要求实际尺寸、去背景、纠偏、清晰化并上下排版到一页 A4 时使用。需要确认用户有权处理这些图像。仅有一面、OCR/字段提取、核验、翻译、改字、脱敏、伪造、美化或其他证件类型时拒绝路由。

2.0.0 双入口与账户流程

本技能只有两个身份证处理入口：SkillHub 和微信小程序。SkillHub 由 Agent 调用本地处理模块；微信小程序在用户明确同意后上传到服务端临时处理。/account 仅用于短信登录、额度/钱包、充值、复制本机令牌和反馈，不提供第三种身份证处理入口。

没有本机 CN_ID_CARD_ACCESS_TOKEN 时，先查询 /api/v2/auth/methods，只提供已启用的手机号短信验证码登录。微信小程序同样使用短信验证码登录；getPhoneNumber 只可作为关闭的历史兼容代码，不得宣传、依赖或作为登录前提。两入口统一到同一个手机号账户，首次验证仅赠送 5 次免费额度。若短信登录未启用，应说明注册登录暂未开放并停止授权，不得虚构入口。登录完成后，用户只把 token 复制/配置到本机环境；不得要求用户在聊天中发送手机号、验证码或 token，也不得把 token 写入技能包、日志或命令历史。

Agent 必须按 [账户与授权协议](references/account-service.md) 发送固定的非敏感授权请求。授权成功后才导入本地 render() 排版；本地失败调用 cancel，成功调用 complete。身份证图像、文件路径、文件名、身份证字段和 OCR 内容永远不上传。

首次验证赠 5 次免费额度；额度用完后按次从共享钱包余额扣费。SkillHub 和小程序消耗同一份额度，订单的 client_channel 仅为 SKILLHUB 或 MINIAPP。充值由自有微信商户系统处理，Agent 不代用户真实充值或付款，执行前确认并引导用户在 /account 完成。

任务完成后可询问用户是否愿意反馈。只有明确同意，才提交评分、分类和消息；对话摘录、HTTPS 资源链接须逐项确认。反馈与隐私规则见 [反馈与隐私](references/feedback-and-privacy.md)。

仅在开发、部署或运维账户服务时读取 [账户服务部署说明](references/account-service-deployment.md)；普通身份证排版任务不需要加载该文档。

本地排版与结果

授权成功后调用现有 Python 模块的 render(front_path, back_path, temporary_output, assume_cropped)。保持正反面图像本地处理逻辑不变：尊重 EXIF 方向，检测最大合理四边形进行透视校正，只做适度清晰化，不镜像、不拉伸、不修改文字或图案；证件尺寸为 85.60 × 53.98 mm，输出一页纵向 A4，正面在上、反面在下，带自然圆角。

完成后核验 PDF 可打开、单页 A4、两面均存在且方向/比例正确，无明显背景残留或过度锐化。打印选择“实际大小/100%”，关闭自动缩放。

微信小程序边界

小程序只接受用户选择的正反面 JPG/PNG，每张不超过 10MB、解码后不超过 3000 万像素。上传前必须明确告知：图片仅为本次排版临时传输至 VPS，原图在成功或失败后立即删除，生成的 PDF 最多保留 30 分钟；废弃草稿最多保留 15 分钟。小程序服务端不得做 OCR、字段提取或内容修改。

安全边界

SkillHub 不上传身份证图像，不执行 OCR，不提取或改动身份证内容；小程序仅按上一节临时上传处理。不提供免费绕过授权的命令或第三处理入口。账户、充值、反馈服务异常时停止并清楚说明，不以本地标记伪造授权、扣费或取消状态。

发布包白名单

SkillHub 发布包只包含本文件、agents/openai.yaml、references/*.md、scripts/id_card_to_a4.py 及必要的本地依赖说明和测试；不得包含服务端源码、service/、小程序客户端、联网包装器、缓存、生产配置、密钥或身份证素材。小程序服务代码与部署文件属于服务端项目，不随 SkillHub 包发布。