开发路线与交付验收

1. 路线原则

• 先消除屏幕、电源和存储等硬件高风险，再扩大功能。
• 用户需求、购买单位和价格验证必须与技术可行性并行进行。
• 最终六色屏的候选和真实样屏验证前移，不能等到开发末期首次判断。
• 每个阶段都有可演示产物和退出条件。
• RLCD原型只验证核心体验，不评价最终六色显示品质。
• Wi-Fi、BLE、账号和平台能力不得阻塞本地最小游戏闭环。
• 在真实用户验证前不投入完整网页、市场或多人系统。
• 日历排期等团队人数、供应商交期和屏幕资料齐备后再制定。

2. 工作流

项目分为五条相互协作的工作流：

3. 阶段0：方案冻结

产出

• 15～20名目标玩家访谈和至少5场低成本流程测试。
• 手机工具、实体体力牌与专用设备的替代方案比较。
• 个人单台、桌主套装和桌游店套装的购买模式与价格区间。
• 整体设计和决策记录。
• ST7305模组资料与接口表。
• 至少两款六色屏候选清单，并规划或完成至少一块样屏验证。
• Rev.A0硬件框图、GPIO预算和电源目标。
• 整机机械包络、器件堆叠和天线净空草案。
• ESP-IDF、C++17、LVGL技术基线。
• LVGL 1-bit、外部字体和刷新调度的最小验证计划。
• 五键交互和对局状态机。
• 卡牌包Schema草案和CHB格式草案。
• 原图黑白化、简化海报和结构化模板三种内容对比方案。
• 可靠性、功耗和OTA策略。
• 原型测试任务与成功指标。

退出条件

• 所有影响原理图的待决策有负责人和输入资料。
• 用户痛点、首要购买理由、购买单位和初步价格区间有证据支持。
• 六色屏不存在已知的尺寸、刷新、功耗、成本或供应致命问题。
• 已确认与推荐方案有明确状态。
• Rev.A最小范围不再增加功能。
• A0硬件和固件接口不存在明显冲突。

4. 阶段1：工程基线

目标

建立可重复构建、烧录、测试和发布的空工程，不开发产品功能。

产出

• ESP-IDF组件化脚手架。
• rev_a_debug、rev_a_release、factory_test和simulator配置。
• 固定依赖版本和构建说明。
• 双OTA分区草案。
• 基础日志、错误码、格式化和静态检查。
• 电脑端核心逻辑测试入口。
• 版本号和构建信息生成规则。

退出条件

• 新环境能按文档完成构建和烧录。
• Debug与Release配置均可生成镜像。
• 最小模拟器和单元测试可运行。
• 构建产物包含固件、硬件目标和版本信息。

5. 阶段2：Rev.A0板级点亮

优先顺序

1. 电源、USB和调试。
2. ESP32-S3 N16R8识别与PSRAM测试。
3. ST7305全屏测试图。
4. 五键。
5. MicroSD。
6. PCF85063。
7. 电池ADC、充电状态和睡眠。
8. Wi-Fi与BLE基础诊断。

产出

• Board层和工厂诊断固件。
• ST7305初始化、方向、全刷和局刷验证。
• 五键短按、长按和消抖。
• SD容量、读速和热插拔测试。
• RTC与电量诊断。
• 各电源状态电流测量。

退出条件

• 所有Rev.A0器件均可独立诊断。
• 屏幕刷新与SD读取并行不损坏数据。
• Wi-Fi、SD和屏幕同时工作不复位。
• 深睡眠达到A0通过线或已有明确整改方案。

6. 阶段3：显示和资源闭环

产出

• 产品Display接口与ST7305实现。
• LVGL 300×400五键导航。
• Python cardpack最小工具。
• pack.json、index.json和CHB读取。
• 至少100张无版权测试卡资源，后续扩展到500张验收集。
• 卡池和武将文字列表。
• 当前、上一张和下一张有限缓存。
• 内部当前卡面缓存。

退出条件

• 可从SD稳定浏览和显示100张卡。
• 规模验收以500张为目标，并使用1,000张进行压力测试。
• 损坏单张资源不会阻止其他卡显示。
• 无SD可以进入设置和诊断。
• 旧异步加载结果不会覆盖新选择。
• 模拟器和真机显示逻辑一致。

7. 阶段4：最小游戏闭环

产出

• 三国杀适配器。
• 武将、身份和体力上限计算。
• 体力、护盾和一个通用Token。
• 锁定、解锁和5秒一步撤销。
• 游戏保持态和临时状态层。
• 开始、更换武将和结束确认。
• RTC对局时长。
• 当前对局A/B快照。

退出条件

• 能仅用五键完整完成一场游戏。
• 主公和地主体力修正正确。
• 休眠和异常复位后恢复一致。
• 游戏中拔卡仍能继续当前对局。
• 两小时运行无非预期重启和不可恢复状态错误。

阶段4完成后才算“可玩原型”。

8. 阶段5：稳定性与功耗

产出

• 游戏保持、深睡眠和低电保护。
• 服务超时、看门狗和外设恢复。
• 连续启动失败与安全模式。
• A/B Catalog。
• 错误历史和诊断导出。
• 随机断电、SD损坏和睡眠循环测试。

退出条件

• 1000次睡眠唤醒无状态错误。
• 关键写入阶段随机断电可以恢复。
• 深睡眠达到目标或形成明确硬件改版结论。
• 低电状态能保存并通过USB恢复。
• 损坏资源和NVS异常不会形成启动循环。

9. 阶段6：升级与传输

产出

• 双分区OTA。
• 固件Manifest、SHA-256和回滚。
• USB专用资源传输模式。
• .chpack安装、staging和Catalog切换。
• 电脑端安装与检查命令。

退出条件

• 固件更新中断不破坏旧固件。
• 新固件启动失败自动回滚。
• 资源安装中断继续使用旧包。
• USB传输期间电脑和设备不会同时写SD。

10. 阶段7：无线基础能力

产出

• 配网。
• NTP校时。
• 可选局域网资源传输或固件检查。
• BLE广播、扫描和连接验证。

退出条件

• 无线关闭时本地功能完整。
• 配网失败可退出并继续游戏。
• 游戏中默认关闭无线，功耗回到本地基线。
• 不在Rev.A扩展多人组局业务。

11. 阶段8：Rev.A1和扩大用户验证

产出

• 接近目标形态的A1整机。
• 侧键、外壳、SD口、USB口和天线验证。
• 在阶段0低成本验证基础上，完成至少5场A1真实面杀。
• 全卡面与固定状态区对比。
• 用户价格访谈和购买单位验证。

退出条件

• 熟悉用户15秒内完成常用武将选择。
• 体力变化一次按键完成。
• 每场无未纠正的状态误操作。
• 连续两小时无不可恢复问题。
• 明确整机尺寸、按键、刷新和续航是否可接受。
• 明确购买模式：个人一台、桌主多台或其他。

12. 阶段9：六色屏产品化定型

输入

• 阶段0至前期验证形成的候选屏幕尺寸、分辨率、颜色、刷新和功耗数据。
• 单价、最小采购量和交期。
• 驱动接口、电压、温度和寿命。
• A1用户验证结论。

产出

• 六色屏驱动正式适配与产品化评估。
• 彩色资源转换流水线。
• 主板、电源、GPIO和外壳改版清单。
• BOM和量产风险。

退出条件

• 游戏规则和对局模型无需重写。
• Display接口能够承载新屏刷新限制。
• 彩色效果、刷新和成本达到产品要求。
• 内容授权和商业路径可接受。

13. 优先级

P0：可玩原型必须有

• 屏幕、五键、SD、RTC、电池。
• 卡池、选将、身份、体力、护盾和Token。
• 锁定、撤销、休眠和恢复。
• 诊断和基础资源工具。

P1：原型稳定后

• USB资源传输。
• 双分区OTA。
• 收藏、最近使用和随机选将。
• Wi-Fi校时和传输。
• 简单对局摘要。

P2：用户验证后

• BLE设备互动。
• 多设备组局。
• 桌面管理器。
• 其他卡游适配器。
• 官方内容和市场。
• NFC、音效、灯光和扩展配件。

14. 关键依赖

用户与价格验证     ST7305资料与六色屏候选
       ↓                    ↓
   产品门槛             核心技术门槛
       └──────────┬─────────┘
                  ↓
         A0原理图与显示驱动
   ↓
Display接口与LVGL
   ↓
卡牌展示与最小游戏闭环

资源Schema
   ↓
Python工具与测试包
   ↓
SD资源读取与用户测试

电源方案
   ↓
A0功耗测量
   ↓
A1结构和续航结论

用户与价格验证、两类屏幕验证、机械包络和资源工具是当前关键路径。

15. 风险登记

16. 版本路线

17. 完成定义

任何工作项只有同时满足以下条件才算完成：

• 主流程和错误流程均实现。
• 对应测试通过。
• 无SD、无网和RTC无效场景已评估。
• 日志可以定位问题。
• 功耗影响有测量或说明。
• 公开接口和资源Schema有文档。
• 决策状态和设计文档已同步。
• 不引入未批准的P1/P2功能。

18. 下一轮集中决策

进入实施前建议集中确认：

1. P-001至P-019建议冻结项。
2. ST7305具体模组、六色屏候选和ESP32-S3模组料号。
3. A0是否使用双SPI、四层板和电源路径管理。
4. 游戏中默认不自动锁及5秒撤销。
5. 数据插件与编译期游戏适配器边界。
6. CHB逻辑像素格式、500张验收和1,000张压力测试目标。
7. A/B快照、A/B Catalog和双OTA策略。