使用指南 / 07

用 TRAE 创造 AI Passport 玩法

在 TRAE Work 中描述玩法、完成代码与构建,再把新体验装进随身的 AI Passport。

STEP / 01

连接设备并确认安装基线

用 USB 数据线连接 AI Passport,先从官方玩法库完成一次已发布玩法的安装,确认浏览器串口权限、线材和设备都能正常工作。

AI Passport 连接电脑并打开官方玩法页面
先确认设备连接和官方安装流程正常
提示
这一步能先排除连接问题,也为自定义玩法准备一个明确的恢复路径。

STEP / 02

在 TRAE Work 中打开玩法项目

进入 TRAE Work,把完整玩法目录作为项目打开。先让 Agent 阅读项目说明、构建脚本、目标硬件和现有玩法示例,并在动手前总结开发方案。

发送给 Agent 的提示词
请下载并参考这个项目代码:
https://github.com/folotoy/ai-passport
帮我开发一个敲木鱼的应用。
视频中的 TRAE Work 项目界面
在 TRAE Work 中载入完整玩法项目
提示
让 TRAE 在项目目录内完成修改和命令执行,不要只在聊天里生成一段脱离工程的代码。

STEP / 03

说明你想做的专属玩法

用自然语言写清场景、首屏、操作流程和完成结果,并补充三个实体按键、声音、蓝牙或网络要求。先做可以在硬件上快速验证的最小版本。

AI Passport 展示定制兔子玩法
从一项清晰的专属体验开始
  • 谁会在什么场景使用
  • 屏幕需要显示哪些页面和状态
  • 三个按键分别如何操作
  • 第一版的完成标准和明确边界

STEP / 04

让 TRAE 完成代码、构建和检查

让 TRAE 按确认后的方案修改代码,运行项目提供的构建命令,并继续修复编译错误。完成时要求它说明改动文件、验证结果、玩法路径和仍需实机确认的部分。

提示
不要在生成代码后直接结束。必须看到构建成功,并确认实际输出了可安装的玩法文件。

STEP / 05

安装玩法并逐项检查

打开本地玩法安装工具,选择 TRAE 构建的玩法并写入测试设备。重启后检查首屏、按键、声音、连接与异常恢复是否符合需求。

TRAE 构建的自定义玩法在 AI Passport 上运行
让 TRAE 的构建结果在真实硬件上运行
  • 写入过程中保持 USB 连接
  • 先用测试设备验证并保留恢复版本
  • 把异常操作步骤和日志记录下来

STEP / 06

把它作为随身设备实际使用

佩戴或随身携带一段时间,观察户外可读性、单手操作、连接稳定性和电量表现。把最影响体验的问题按优先级交回 TRAE,完成下一轮小范围修改、构建和刷写。

佩戴在身上的 AI Passport
从桌面开发走到真正的随身使用
  • 真实场景优先于桌面演示
  • 一次迭代只处理少量关键问题
  • 为每个稳定版本保留代码与玩法备份