使用指南 / 07
用 TRAE 创造 AI Passport 玩法
在 TRAE Work 中描述玩法、完成代码与构建,再把新体验装进随身的 AI Passport。
STEP / 01
连接设备并确认安装基线
用 USB 数据线连接 AI Passport,先从官方玩法库完成一次已发布玩法的安装,确认浏览器串口权限、线材和设备都能正常工作。

提示
这一步能先排除连接问题,也为自定义玩法准备一个明确的恢复路径。
这一步能先排除连接问题,也为自定义玩法准备一个明确的恢复路径。
STEP / 02
在 TRAE Work 中打开玩法项目
进入 TRAE Work,把完整玩法目录作为项目打开。先让 Agent 阅读项目说明、构建脚本、目标硬件和现有玩法示例,并在动手前总结开发方案。
发送给 Agent 的提示词
请下载并参考这个项目代码:
https://github.com/folotoy/ai-passport
帮我开发一个敲木鱼的应用。
提示
让 TRAE 在项目目录内完成修改和命令执行,不要只在聊天里生成一段脱离工程的代码。
让 TRAE 在项目目录内完成修改和命令执行,不要只在聊天里生成一段脱离工程的代码。
STEP / 03
说明你想做的专属玩法
用自然语言写清场景、首屏、操作流程和完成结果,并补充三个实体按键、声音、蓝牙或网络要求。先做可以在硬件上快速验证的最小版本。

- 谁会在什么场景使用
- 屏幕需要显示哪些页面和状态
- 三个按键分别如何操作
- 第一版的完成标准和明确边界
STEP / 04
让 TRAE 完成代码、构建和检查
让 TRAE 按确认后的方案修改代码,运行项目提供的构建命令,并继续修复编译错误。完成时要求它说明改动文件、验证结果、玩法路径和仍需实机确认的部分。
提示
不要在生成代码后直接结束。必须看到构建成功,并确认实际输出了可安装的玩法文件。
不要在生成代码后直接结束。必须看到构建成功,并确认实际输出了可安装的玩法文件。
STEP / 05
安装玩法并逐项检查
打开本地玩法安装工具,选择 TRAE 构建的玩法并写入测试设备。重启后检查首屏、按键、声音、连接与异常恢复是否符合需求。

- 写入过程中保持 USB 连接
- 先用测试设备验证并保留恢复版本
- 把异常操作步骤和日志记录下来
STEP / 06
把它作为随身设备实际使用
佩戴或随身携带一段时间,观察户外可读性、单手操作、连接稳定性和电量表现。把最影响体验的问题按优先级交回 TRAE,完成下一轮小范围修改、构建和刷写。

- 真实场景优先于桌面演示
- 一次迭代只处理少量关键问题
- 为每个稳定版本保留代码与玩法备份