Lbp-EspAi 粉粉兔小车新手从 0 到上线指南 · espai-car-bunny
产品：Lbp-EspAi 硬件可选 项目文件夹：espai-car-bunny

先养一只会聊天的粉粉兔数字宠物 🐰💕

手机 App 里的情绪陪伴桌宠是主角：看心情、摸摸、喂食、软软聊两句。实体 Wi‑Fi 小车是 可选增强——有车才能兜风遥控，没车也能完整体验家园与陪伴。

这份页面写给“完全没做过硬件、也没写过代码”的你：先在原型里体验 App 宠物，再按需决定要不要配小车。进度勾选会保存在本机浏览器里。

🏡 情绪桌宠💬 软陪伴聊天📚 学习加油🚗 可选小车
🎨 设计约束 · 图标：界面主控件（底栏 / 设置行 / 首页芯片 / 学习卡片 / 喂食按钮 / 年龄分段）统一使用内联 SVG（stroke / currentColor），不依赖 CDN 图标库；文案里偶发的小表情仅作玩味点缀。

⚙️ 系统能力 FE / BE soft-first

对照深化后的前后端模块边界：App 与云端先行，固件可选。

前端 UniApp 模块 — 家园 / 学习 / 聊天 / 遥控 / 家长中心（App，后续可发小程序）。
云端 cloud-api 模块 — FastAPI：学习判题、宠物状态、家长偏好、设备指令转发。
管理端 — enjoy-iot + enjoy-web：题库、能量日志、宠物状态、家长审计（只读示例）。
可选固件 — ESP32-S3：配网、遥控、OTA；关掉「我有实体小车」也不挡 App 体验。

产品故事：养宠 · 陪伴 · 学习 ·（可选）开车

🏡💕

① 情绪数字宠物

主角：手机里的粉粉兔桌宠——心情、摸摸、喂食、软陪伴。不必先绑小车。
💬

② 软软聊天

打字或说话，云端 AI 用“兔子语气”回答。有实体车时也可从喇叭念出来。
📚⚡

③ 学习赚能量

成语、英语、识字。答对撒花 + 能量；答错只给温和解析，不扣分。
🚗🐰

④ 实体小车 可选

有车才解锁遥控兜风、车灯喇叭、车顶摇耳朵。没车也能完整体验 App。
🏡 先体验 App 宠物→💬 聊天陪伴→📚 学习加油→🥕 喂养 / 摸摸→🚗 有车再绑小车（可选）↺
🌷 产品温柔规则（来自 Lbp_Pet）：答错不惩罚宠物——不扣能量、不降心情。学习是“加油”，养宠是“情感容器”。硬件是增强，不是门槛。

产品定位 · 三个年龄支柱

同一只粉粉兔，三种年龄档。App 宠物始终可用；实体小车是可选增强。在「📱 操作原型 → 我的」切换年龄档与「我有实体小车」，本机浏览器会记住。

🧑🌿

大人 可无硬件

情绪数字宠物为主：家园桌宠、心情陪伴、软聊天。学习是次要加油；绑车是可选快捷入口，不是门槛。
  • 默认首页强调「家园」
  • 文案：情绪陪伴 / 桌宠
  • 奶油薄荷配色
📄 详见 25大人桌宠
🧓🌸

老人

陪伴为主：大字聊天 + 宠物家园。生活识字可选；有车时遥控锁定慢速，无车也不影响陪伴。
  • 大字大按钮
  • 聊天更慢更温和
  • 小车可选 · 慢速
📄 详见 50长者慢速
🧒🐰

小孩

学习 + 陪伴：看图识字赚能量养兔；遥控 / 小车入口更醒目（有硬件时）。可爱语气全程陪伴。
  • 学习与养宠并重
  • 遥控入口更突出
  • 答错也抱抱
📄 详见 10儿童陪伴
🚗✨

实体小车 · 可选增强 硬件可选

配上网后解锁：摇杆遥控、车灯喇叭、车顶粉粉兔摇耳朵庆祝。设置里关掉「我有实体小车」时，遥控入口会隐藏或显示锁定「可选硬件」预告——不挡你先玩 App 宠物。

推荐体验路径

  1. 登录 →「先体验 App 宠物」
  2. 家园里摸摸、喂食、看心情
  3. 想兜风再开「我有实体小车」并配网
📑
二期设计文档（本机 Mac 上）
详细产品 / UI / 工程说明不在本页，请打开项目文件夹里的文档（文件名示意，以你 Mac 上实际文件为准）：
  • 10儿童陪伴 — 小孩档：学习+陪伴、遥控更醒目
  • 25大人桌宠 — 大人档：情绪宠物优先、可无硬件
  • 50长者慢速 — 老人档：陪伴为主、大字、慢速可选车
  • 21产品设计 — 学习赚能量、家园养成、硬件可选、温柔规则
  • 22UI — 粉粉兔视觉、屏幕流、组件规范
  • 23工程 — 接口、能量发放、与 Lbp_Pet 打通

它由哪几部分组成？

🚗

小车本体

ESP32-S3 主控板 + 电机 + 电池 + 外壳 + 兔子。里面跑的程序叫“固件”，负责连 Wi‑Fi、听指令、驱动轮子。
☁️

云端服务

cloud-api（Python FastAPI，端口 8080）：转发遥控指令、调用大模型生成兔子的回答。
📱

手机 App

用 UniApp 开发，先做 App，后续同一套代码可以发布成微信小程序。
🖥️

管理后台

enjoy-iot（RuoYi 系，Spring Boot 后端）+ enjoy-web（网页界面）：看设备、看日志、管用户。
🌐

宣传官网

Vue 3 做的介绍网站，给潜在用户看产品介绍、下载 App。
🧠

AI 大模型

兔子“会说话”的大脑。由云端调用，密钥只放在服务器，不放进小车或 App。

一张图看懂：指令和聊天是怎么跑的

遥控 / 聊天 手机 App UniApp（后续小程序） ☁️ 云端 cloud-api Python FastAPI · 端口 8080 小车控制 + 调用大模型 🧠 AI 大模型 兔子小车 ESP32-S3 固件 · Wi‑Fi 🖥️ 管理后台 enjoy-iot + enjoy-web RuoYi 系 · Spring Boot · 看设备/日志/用户 ① 发指令 / 说话 ② 转发给小车 ③ 上报状态 / 电量 ④ 兔子回复 / 结果 共享设备与日志数据

粉色箭头 = 你发出去的；绿色箭头 = 回来的。手机不直接连小车（第一次配网除外），所有指令都经过云端，这样你在外面也能控制家里的小车。宣传官网（Vue 3）是独立的介绍网站，不参与控制。

7 步路线图

已完成 0 / 7
点击每一步的标题展开详细说明；勾选“我已完成”后进度保存在本机浏览器（localStorage），关掉再打开也还在。
🐰🤝🐱
以后会和 Lbp_Pet（萌宠家园）合并 规划 · 二期
一期先把「App 情绪宠物 + 聊天」做稳，实体小车为可选增强；二期打通学习打卡养萌宠：同一账号、同一能量，有车时车顶粉粉兔 = 家园里那只。见第 ⑦ 步。

📱 手机 App 操作原型 示例数据

这是一个“可以点的草图”：所有数据都是假的，不会真的连小车。每个按钮都能点，右边会告诉你这一屏在做什么、真实 App 会调用哪个后端接口。

9:41示例数据 📶 🔋
Lbp-EspAi
先养桌宠，小车可选 🐰💕
验证码
添加小车配网
🔌🐰

第 1 步：给小车开机

打开小车底部的电源开关，等兔子耳朵的灯慢慢闪烁，说明小车进入“等待配网”状态。

💡 如果灯不闪：长按小车上的配网键 3 秒（示例）。
🏡 没有实体小车？完全没关系。粉粉兔 App 宠物可以单独玩，绑车以后再来。
📶

第 2 步：连接小车的热点

打开手机「设置 → Wi‑Fi」，连接下面这个名字的热点，然后回到 App。

📡 EspAi-Bunny-3F2A小车热点
尚未检测到连接
🏠

第 3 步：告诉小车家里的 Wi‑Fi

小车只支持 2.4GHz Wi‑Fi（名字带 5G 的一般不行）。

🎉

绑定成功！

小车已连上家里的 Wi‑Fi，并绑定到你的账号。给它起个名字吧：

你好
遥控 · 粉粉兔 1 号在线
速度 0 cm/s朝向 0°电量 78%
🐢 老人档 · 已锁定「慢速」（示例）
拖动左边粉色圆球控制方向（电脑上也可用方向键 / WASD）
和粉粉兔聊天AI 回复
学习加油站 60
20
今日能量目标 / 100 示例数据
答对得能量 → 「家园」喂粉粉兔 · 答错不扣
🔥 连续学习 3 天 示例连胜 · 二期接真数据
宠物家园 60
🔗 与 Lbp_Pet 打通 · 二期 示例数据

还没有粉粉兔

先领养一只情绪桌宠吧——无需实体小车，摸摸、喂食、软聊天都能玩。

粉粉兔 · Lv.3 幼兔
就是坐在你小车上的那只 · Lbp_Pet「云朵兔」形象（规划）
今天也一起学习吧～
已关联：粉粉兔 1 号
🍎 饱食
0
💕 心情
0
💞 亲密
0
结缘 · 即将开放
二期与 Lbp_Pet 打通后，可邀请好友的萌宠来做客。当前为锁定示意，无价格。
⚡
能量不足啦～去「学习」答几题就能喂粉粉兔
⛽
学习加油站：今天答对 0 题，每答对 1 题心情 +2
🖥️🐰
情绪桌宠 · 大人档
粉粉兔是你的情绪数字宠物：看心情、摸摸、软聊天。学习是次要加油；实体小车可关可开，不强制绑定。
🌷 学习是加油，养宠是情感容器 · 答错不会让粉粉兔难过
我的 · 设置
和粉粉兔聊天
学习记录 （本次演示）答对 0 / 0
能量余额60
家长控制 示例
年龄档锁定未锁定
小车名字粉粉兔 1 号
兔子音量
兔子声音
兔子性格
我有实体小车 关掉则隐藏遥控，显示「可选硬件」预告 · soft-first 无需硬件
低电量提醒
儿童模式（限速+内容过滤）
年龄档位 （小孩 / 大人 / 老人）
大字模式 （老人档自动开启）
固件 v0.3.1（示例）
重新配网
账号138****8888
解绑这辆小车
退出登录

🚪启动 / 登录

这一屏会调用的接口 示例接口设计
🛰️ 模拟请求记录
// 在左边手机上点点看，这里会出现 App 发给云端的请求（示例）
你在手机上的每个操作，真实 App 都会向云端发一个类似的请求。这里只是显示出来，没有真的发送。接口路径为建议设计，最终以 cloud-api 代码为准。

🖥️ 管理后台原型 示例数据

这是 enjoy-iot（后端）+ enjoy-web（网页）上线后大概的样子：运营 / 客服人员用它查看所有小车、指令和聊天记录。表格里全部是编造的示例数据。

首页 / 数据概览示例数据👩‍💼 admin（示例账号）
近 7 天对话次数 示例数据
最近告警 示例数据
🔋 粉粉兔 4 号 电量低于 20% · 10:12
📴 演示车 B 离线超过 2 小时 · 08:30
⚠️ 粉粉兔 4 号 指令超时 · 10:20
⬆️ 2 台设备固件低于 v0.3.0，建议 OTA 升级
🛡️ 1 条对话被内容审核拦截 · 09:30
设备编号名称状态电量固件绑定用户最后在线操作
全部为示例数据第 1 / 1 页
记录来源：cloud-api 转发指令时写入（示例）
时间设备指令参数来源结果耗时
用于检查 AI 回答是否合适、统计调用量（示例）
时间用户设备用户说兔子回复Token审核
示例数据
题号题型题面正确答案干扰项答对能量难度状态
App 通过 GET /api/v1/learn/questions（建议接口）从题库抽题；判题在云端完成，答错只返回解析、不扣能量。
在左侧「操作原型 → 学习 / 家园」里答题、喂食，这里会实时多出记录（示例）示例数据
时间用户来源变动余额备注
宠物与车顶兔子一一关联；「结缘」二期开放（示例）示例数据
用户宠物关联小车饱食心情亲密装扮结缘最近互动
只读 stub：家长锁相关事件（PIN / 年龄锁 / 禁止解绑 等）· 不可在此改写示例数据只读
时间用户事件详情来源结果
接口对照：GET /api/v1/parent/audit（建议设计）· App 侧变更走 /api/v1/parent/*，本页仅审计回放。

🛠️ 调试台 本地假设备 + 串口对照

给现在就能用的联调：浏览器里模拟发 JSON 指令、看全龄速度封顶、切换 soft-first / 有车，并对齐固件 Serial 的 help / status / ping。真机请用 USB 串口监视器 115200。

假设备控制台

// 假设备日志（不连真车）\n

全龄速度封顶

child ≤ 70% adult ≤ 100% elder ≤ 40%

soft-first / 有车

—

与「操作原型 → 我的」共用 localStorage 键；关掉 = soft-first 只玩 App 宠物。

固件 Serial 对照

烧录后 pio device monitor -b 115200，输入： help status ping estop

cloud-api

若浏览器 CORS 失败：在终端 curl http://127.0.0.1:8080/health。设备端勿填 127.0.0.1，请用电脑局域网 IP。

名词解释

遇到看不懂的词，来这里搜一下。每个词只用一句大白话解释。

图标约束 = 内联 SVG（stroke / currentColor）；本页与操作原型底栏 / 设置 / 芯片等主控件均不使用 emoji 图标库。