用 Qoder CN 创造 AI Passport 玩法

Qoder CN 是阿里巴巴推出的智能体编程平台（原通义灵码），桌面应用以编程智能体为核心，可以在本地项目中理解代码、规划任务、修改文件并运行命令。

• 开发方：阿里巴巴（阿里云）
• 支持系统：macOS 12 及以上，Windows 10 及以上，Linux（x64 / ARM64 / LoongArch64），HarmonyOS 6.1.1 及以上
• 使用前提：Qoder CN 账号；模型调用消耗账号额度（Credits），不同模型的消耗倍率显示在模型菜单中
• 本教程使用的版本：0.5.1

从官方网站下载安装包：qoder.com.cn/download↗。请只使用官方渠道，不要安装来源不明的打包版本。

• 在下载页的「Qoder CN」卡片中选择你的系统并下载（同一页面的 Qoder CN IDE、CLI 是其他形态）
• macOS：打开 .dmg，把 Qoder CN 拖进「应用程序」文件夹
• Windows：运行安装程序，按向导完成安装

首次打开时登录 Qoder CN 账号。在输入框附近确认模式和模型：本教程使用「Coding」模式、「Local」本地运行、模型「Auto」，权限为默认的「Auto approve」。

点击输入框上方的「No workspace selected」，选择「New workspace」，点击「Click to add a readable and editable folder」打开 AI Passport 项目文件夹，再点击「Create」。

新建一个会话，把下面的提示词复制到输入框，把【填写应用需求】换成你想做的玩法，再发送。本教程的示例需求如下：

请基于完整项目 https://gitee.com/FoloToy/ai-passport 开发；本地已有项目则复用。
先读 AGENTS.md 和 docs/README.md，按需查阅相关文档、硬件接口及示例，自行准备环境并安装项目要求的 Skill。
保留已有修改，新建分支开发。复用 BSP，重新设计应用界面，不照搬 demo；中文界面检查字体覆盖。关键需求不明确时询问，其余自主完成。
运行项目验证，交付可从 0x0 刷写的合并固件，说明测试结果与未验证项。完成后主动询问是否刷机测试，未经确认不烧录。

• 一个番茄钟：开机进入 25 分钟专注倒计时；确定键开始 / 暂停，上下键在未开始时把时长调整为 5–60 分钟（每次 5 分钟）；倒计时结束时屏幕醒目提示并播放提示音，按确定键回到初始状态

Qoder CN 会阅读项目、检查项目要求的 Skill、新建开发分支，再修改代码并运行构建命令。默认的「Auto approve」会自动执行命令；如果希望逐条确认，可以在发送前改成需要确认的权限。

本次示例用时约 20 分钟。Qoder CN 报告构建通过、电脑端单元测试全部通过，交付合并固件 build/full.bin（约 762 KB，可从 0x0 写入），并列出设备上尚未验证的项目，最后询问是否刷机。

• 点击「Edited 9 files」旁的「Review」，可以查看每个文件的改动
• 右侧「Environment」显示改动行数、运行位置和当前分支
• 未验证项包括中文显示效果、按键响应、提示音、电量显示和进度动画，需要安装到设备后确认
• Agent 询问是否刷机时，设备没准备好就回复「暂不刷机」

打开本地玩法安装工具↗，选择 Agent 交付的合并固件（从 0x0 写入的 .bin 文件），用支持数据传输的 USB-C 线连接 AI Passport 并开始安装。完成后设备自动重启，逐项检查屏幕、按键和声音。

• 安装新玩法会覆盖设备当前的全部内容；之后可以随时恢复默认固件
• 安装过程中不要拔线或关闭页面
• 把与预期不一致的画面和按键表现描述给 Agent，让它继续修改并重新构建

使用 Qoder CN 开发 AI Passport 玩法时，可能遇到以下情况：

• 额度不足：在账号中查看剩余 Credits，或在模型菜单中选择消耗倍率更低的模型
• 下载页有多个产品：开发玩法使用「Qoder CN」桌面应用即可
• 构建环境缺失：让 Agent 按项目文档准备 ESP-IDF 5.5.3；已经安装过时，可以提示它通过 IDF_PYTHON_ENV_PATH 使用现有的 Python 环境
• macOS 上完整验证脚本提示缺少 sha256sum：Agent 可能改为只运行 C 单元测试。这种情况下请把结果理解为「构建和单元测试通过」，不是完整验证全部通过