# 产品迭代路线图

## Phase 4 ✅ (已完成)

- [x] 开机动画 — 像素小龙虾逐行渐入
- [x] 模式切换动画 — 像素擦除过渡
- [x] 日夜背景 — 根据 NTP 时间切白天/傍晚/夜晚
- [x] 角色自发动作 — 伸懒腰、东张西望
- [x] 音效 — 按键咔嗒、开心音阶、AI 回复提示音
- [x] SSE 流式响应 — 逐 token 显示 AI 回复，零堆分配 chunked transfer 解析
- [x] 语音输入 — Fn 按住说话，Groq Whisper STT 转文字，本地代理中转
- [x] 桌面宠物同步 — macOS 端 Swift 桌面宠物，通过 UDP 接收 Cardputer 状态
- [x] OpenClaw 集成 — 局域网连接 OpenClaw Gateway，多模型自动切换

## Phase 4.5 ✅ (已完成)

- [x] 运行时可配置 Gateway/STT — 编译时值作为默认，Fn+R 向导可修改，重启后保持
- [x] 备用 WiFi 自动降级 — 主 WiFi（家里）连不上自动尝试备用（手机热点），编译时配置两套
- [x] 备用 Gateway Host — 连上备用 WiFi 时自动切换 Gateway IP（热点网络 Mac IP 不同）
- [x] Setup 向导可取消 — Tab 退出向导回到 Companion 模式
- [x] WiFi 连接失败不死循环 — 所有 WiFi 都失败后提供选择：重试 / 进 Setup 改配置 / 跳过进入离线模式
- [x] 离线模式 — 跳过联网后 Companion 模式正常可用（动画、时钟、音效），Chat 模式显示离线提示

## Phase 5 ✅ (已完成)

- [x] TTS 语音回复 — AI 回复通过扬声器播放，按任意键可中断
- [x] 宠物键盘移动 — `;./ ,` 方向键，按住持续走，精灵翻转朝向
- [x] 时光倒流天空 — 宠物 X 位置映射 ±12h 时间偏移，背景随位置变化（左=过去，右=未来），地面时钟仍显示真实时间
- [x] 桌面位置同步 — UDP 广播扩展 x/y/d 字段，Cardputer 移动宠物 → 桌面宠物同步移动

## Phase 5.5 ✅ (已完成)

- [x] 实时天气 — Open-Meteo API 每 15 分钟自动刷新，免费无需 API Key
- [x] 天气背景特效 — 雨滴下落、雪花飘飞（横向漂移）、雾气点阵闪烁、雷暴白色闪光
- [x] 天空色调 — 阴雨/雾天天空变暗，厚云遮挡太阳/月亮/星星
- [x] 宠物配饰 — 晴天戴墨镜、雨天撑伞、雪天雪帽、雾天口罩，配饰随精灵翻转
- [x] 温度显示 — 时钟旁显示温度 + °，竖线分隔
- [x] 天气模拟模式 — Fn+W 切换，数字键 1-8 预览全部 8 种天气类型，底部 [SIM] 状态栏
- [x] 天气 UDP 同步 — 天气类型通过 UDP 广播到桌面端

## Phase 5.6 ✅ (已完成)

- [x] 桌面端双模式 — Follow Mode（透明跟鼠标）+ Scene Mode（menu bar 天气场景面板）
- [x] Scene Mode 完整场景 — 日夜天空、天体（太阳/月亮/星星/云）、天气粒子（雨/雪/雾/雷暴）、地面 + 草丛
- [x] 桌面端时光倒流 — Scene Mode 下 sprite X 位置偏移天空 ±12h
- [x] 温度 UDP 同步 — ESP32 广播包新增温度字段，桌面端 Scene Mode 显示时钟+温度

## Phase 6：体验打磨

- [ ] 电量显示 — 屏幕角落电池百分比，低电量角色变虚弱
- [ ] 亮度自动调节 — 夜间自动降亮度
- [ ] 聊天历史持久化 — 存 NVS 或 SD 卡，重启后保留上次对话

## Phase 6.5 ✅ (已完成)

- [x] 像素画生成 — `/draw` 命令 AI 生成 8x8/16x16 像素画，96x96 渲染嵌入聊天
- [x] 桌面双向通信 — Mac ↔ ESP32 命令控制、聊天同步、像素画同步、通知转发
- [x] 桌面像素画弹窗 — 256x256 高清渲染 + 历史浏览
- [x] 桌面 Chat Viewer — 实时聊天镜像 + 远程发送
- [x] 宠物停靠 — Chat Viewer 打开时宠物停靠在窗口顶部

## Phase 7：互动玩法

- [ ] 养成系统 — 饥饿值/心情值，需定期"喂食"，否则角色变蔫。洗澡、排泄等拟真互动（社区呼声高）
- [ ] 表情反应 — AI 回复关键词（happy/sad/wow）触发对应表情
- [ ] 小游戏 — 按键接物 / 打地鼠，小龙虾钳子接东西

## Phase 8：实用功能

- [ ] 番茄钟 — 25 分钟倒计时，角色陪你专注，到时间蹦起来提醒
- [ ] 提醒事项 — 键盘输入提醒，到点角色弹窗

## Phase 9：硬核扩展

- [ ] BLE 联动 — 手机推送通知到 Cardputer，角色举牌提示

## 社区建议（待评估）

> 来自视频评论区，待评估优先级和方案

- [ ] **像素美术升级** — 找专业像素画师优化角色动画、背景、道具设计，参考星露谷物语风格（@^v^，3赞）
- [ ] **长语音 TTS 支持** — 当前内存限制无法播放长回复。方案：服务端切片缓存分段发送，或存 SD 卡流式播放（@NeonBay）
- [ ] **M5Burner 固件发布** — 多位用户询问，降低使用门槛。需解决固件依赖 .env 凭据的问题（用户烧录后通过 Fn+R 向导配置）（@Licht @穿越新视角，4回复）