使用指南 / 05
用 Codex 创造 AI Passport 玩法
在 Codex 中打开玩法项目，把想法写成可验收任务，完成构建、安装与实机迭代。
STEP / 01
准备玩法项目和测试设备
先准备可以正常构建的 AI Passport 玩法项目，并选一台用于开发的设备。记录项目依赖、构建命令和当前可恢复的玩法，让后续问题能够区分是环境、代码还是硬件造成的。
- 确认原项目可以完成一次干净构建
- 保留可恢复的官方玩法或稳定版本
- 使用支持数据传输的 USB 线连接测试设备
STEP / 02
在 Codex 中打开玩法项目
把完整玩法项目作为 Codex 的工作区。第一条消息先让 Codex 阅读项目说明、硬件配置、现有示例和构建脚本，并总结它准备复用的代码路径；确认理解一致后再开始修改。
发送给 Agent 的提示词
请下载并参考这个项目代码：
https://github.com/folotoy/ai-passport
帮我开发一个敲木鱼的应用。
提示
完整项目上下文比孤立代码片段更可靠，也更容易让构建、测试和最终玩法保持在同一条工作流里。
完整项目上下文比孤立代码片段更可靠，也更容易让构建、测试和最终玩法保持在同一条工作流里。
STEP / 03
把玩法写成可验收任务
告诉 Codex 玩法给谁使用、启动后看到什么、三个实体按键如何操作，以及完成时应该出现什么结果。最后明确要求它运行构建并交付可刷写文件，而不是只生成源代码。
- 场景与核心目标
- 屏幕页面、状态和文字
- 上键、下键、确定键的短按与长按行为
- 声音、蓝牙、网络和存储需求
- 完成标准、构建命令和玩法输出格式
STEP / 04
让 Codex 实现、构建并修复错误
让 Codex 按计划修改代码，运行项目原有的构建或测试命令，并根据真实报错继续修正。完成后要求它列出修改内容、验证结果、玩法文件路径和仍未覆盖的风险。
提示
如果构建失败，把完整错误保留在当前任务里继续处理；不要跳过验证，也不要把未经构建的源码当作最终结果。
如果构建失败，把完整错误保留在当前任务里继续处理；不要跳过验证，也不要把未经构建的源码当作最终结果。
STEP / 05
把构建结果安装到 AI Passport
打开本地玩法安装工具，选择 Codex 输出的玩法文件，核对目标设备后开始安装。写入期间保持 USB 连接；完成后重启设备，先检查能否正常启动。
- 确认选择的是本次构建生成的文件
- 安装过程中不要拔线或关闭页面
- 出现异常时保留设备日志和构建标识
STEP / 06
实机体验，再把反馈交回 Codex
离开电脑完整玩一遍，检查小屏文字、单手按键、启动速度和异常恢复。把复现步骤、画面和日志交回同一个 Codex 任务，请它只修改最影响体验的问题，再重新构建和刷写。
- 一次迭代聚焦少量可复现问题
- 每个可用版本保留源码提交和玩法备份
- 稳定后再增加新的页面、规则或连接能力