使用 Vibe Coding 开发 IDEA

本章介绍如何从零开发 IDEA、预览并优化界面、在 ESP-Mosaico 上安装和测试,并将 IDEA 发布到 IDEA 中心。

本节以贪吃蛇为例进行说明,你可以根据自己的需求,开发更多有趣的 IDEA。

Vibe ModeVibe Mode

2. 开始前的准备

  • 使 ESP-Mosaico 进入 Vibe Mode
  • 通过 USB 数据线连接 ESP-Mosaico 与 PC
  • 配置一个 Coding Agent(如 Codex、Claude Code、OpenCode 或 Trae)

3. 开始开发

01

创建项目,配置环境

在 PC 上创建空文件夹,启动 Coding Agent,然后发送:

esp-mosaico-vibe
下载这个仓库的代码:https://github.com/esp-mosaico/esp-mosaico-vibe 配置环境并实现一个贪吃蛇游戏。

1. Agent 会自动配置开发环境。配置期间:

  • 确认必要权限、安装位置和网络访问。
  • 遇到错误时,将完整报错交给 Agent。
  • 等待 Agent 确认环境检查通过。

2. 为明确计划,可以尝试:

  • 打开 Plan Mode,或要求 Agent 先提供计划。
  • 确认计划无误后,再开始实现。
02

明确任务目标

检查 Agent 的计划,确认游戏细节符合需求,确保流程包含 .irisfw 构建、安装和验证。

建议让 Agent 确认以下内容:

  • 游戏规则:移动方式、计分规则、暂停功能和开始界面
  • 模拟器预览:在 PC 模拟器中预览并优化界面
  • 设备安装:生成 .irisfw 文件,完成安装与验证

.irisfw 是什么?

IDEA 的标准文件格式

01

Agent 完成第一版后会自动打开模拟器。如未打开,可以发送:

请打开模拟器,让我预览界面。
02

检查布局、交互和视觉效果,并将修改要求告诉 Agent。例如:

请降低贪吃蛇的移动速度,并添加暂停功能、开始界面和游戏结束界面。
01

构建、安装 IDEA

模拟器验证通过后,向 Agent 发送:

请按 esp-mosaico-vibe 仓库文档完成构建、自检和安装,并报告结果、IDEA 文件路径、已通过的检查及仍需实机验证的项目。

构建失败?

让 Agent 读取完整构建日志并继续修正。

安装失败?

  • 授权 Agent 按仓库文档安装 IDEA。
  • 确保 ESP-Mosaico 进入 Vibe Mode。
  • 保持 ESP-Mosaico 与 PC 的连接。
02

实机调试与优化

安装完成后,可以在 ESP-Mosaico 上检查游戏效果,并将发现的问题或新创意直接告诉 Agent。
例如:

让 AI Button 返回主菜单。
进阶玩法

Agent 自动调试优化

仓库已集成调试工具,Agent 可以:

  • 获取 ESP-Mosaico 的画面和运行数据。
  • 进行交互式测试。
  • 辅助定位问题并进行多轮优化。

向 Agent 发送:

捕获 ESP-Mosaico 当前屏幕并对游戏进行交互式测试,检查画面、触摸是否正常,并报告发现的问题。
01

使用 Agent 上传

注册并登录 mosaico.ai IDEA 中心,然后向 Agent 发送:

请将当前项目作为新的 IDEA 上传到 https://
mosaico.ai/
:补充并检查发布信息,构建并检查 .irisfw 文件,登录后创建草稿。完成后,请返回草稿链接、版本和校验值。
  • 完成授权:根据提示,在浏览器中输入授权码。
  • 检查草稿:前往“个人主页”查看草稿。
  • 提交审核:确认内容无误后,手动提交审核。

提示

可使用 ChatGPT、Monica、Sider 等 AI 浏览器助手,辅助整理内容和填写发布表单。第三方扩展安装前请确认来源与权限。

02

手动上传

上传 IDEA:

  • 点击网站顶部的 “发布” 按钮。
  • 选择 “软件” 分类。
  • 填写 IDEA 信息,上传 .irisfw 文件。

提交审核:

  • 保存草稿,提交审核。
  • 审核通过后,IDEA 将在软件栏目公开展示。