需用codex设备直采指纹并生成门禁库：先确认驱动兼容性（win/macos均需v4.2.1+），windows端用sdk toolkit采集5次合成iso标准.tpl模板，导出时勾选metadata；macos端用rsync同步（禁用finder），再通过codexlib v1.7.3脚本生成含schema_version:"1.7.3"的personnel.json直接导入门禁平台。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在Windows和macOS双系统环境下，用Codex设备采集指纹特征并自动生成门禁打卡人员库，而不是手动录入或依赖第三方中间件。
确认Codex设备与驱动兼容性
先插上Codex指纹采集器，打开设备管理器（Win）或系统报告（Mac），查看是否识别为“Codex Biometric Device”而非通用USB HID设备。若显示黄色感叹号或“未知设备”，说明驱动未加载——【必须安装Codex官方v4.2.1及以上驱动，旧版驱动不支持macOS Sonoma 14.5+的Secure Enclave指纹桥接】。
Windows端访问codexbio.com/drivers下载exe安装包；Mac端需先关闭SIP（执行csrutil disable后重启），再运行pkg驱动安装器。
Windows端提取原始指纹模板
第一步：以管理员身份运行Codex SDK Toolkit → 选择“Template Capture Mode” → 点击“Start Capture”。
第二步：将手指平压在传感器上，保持3秒不动，听到“滴”声后抬起；重复同一手指5次，SDK自动剔除模糊帧并合成单个ISO/IEC 19794-2标准模板文件（.tpl格式）。
第三步：导出时勾选“Include metadata header”，否则Mac端无法解析设备厂商ID字段；导出路径设为D:\codex\templates\，确保目录无中文、空格、特殊符号。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
macOS端同步并校验模板完整性
方法一：用rsync命令同步模板文件（推荐）
打开终端，执行：rsync -av --delete /Volumes/WinData/codex/templates/ ~/Documents/codex_templates/。这一步必须用rsync而非Finder复制，【Finder会剥离.tpl文件的xattr扩展属性，导致后续特征比对失败】。
方法二：通过iCloud Drive中转（仅限小规模测试）
把.tpl文件拖入iCloud Drive指定文件夹 → 在Mac端等待同步完成图标消失 → 进入~/Library/Mobile Documents/com~apple~CloudDocs/对应路径下验证文件大小是否与源端完全一致。
生成门禁人员库JSON结构
① 打开终端，cd到模板目录：cd ~/Documents/codex_templates。
② 执行批量解析脚本：python3 -m codexlib.cli --batch --output personnel.json。该命令会读取每个.tpl文件头中的DeviceID、FingerPosition、EnrollmentDate字段，并按ISO/IEC 2382-37标准生成base64编码的FeatureVector字段。
③ 检查生成的personnel.json首行是否含"schema_version": "1.7.3"，若为"1.6.x"说明Python环境未激活codexlib v1.7.3虚拟环境——需先运行source venv/bin/activate再执行上一步。
④ 最终文件直接拖入门禁管理平台的“人员库导入”窗口即可生效，无需解压或转换格式。
