木鸡 SteadyGame Alpha 冲刺第三天：真实倾斜输入与结果入口联调

一、Day3 讨论

• 日期：2026 年 10 月 25 日（冲刺第三天）
• 会议场景：小组围绕笔记本电脑开展项目讨论
• 讨论照片：

图 1：Day3 小组围绕开发任务开展讨论。

二、今日目标：把真实输入接入玩法，并准备统一结算

Day3 的工作重心从前一天的接口和模块骨架，推进到可以端到端联调的真实输入与结果入口。核心路径为：

摄像头 / 姿态快照
        ↓
姿态质量门控与站姿校准
        ↓
MotionInput（小球真实倾斜 / 切水果腕点）
        ↓
GameCoordinator 与玩法生命周期
        ↓
冻结 GameResult → 统一结果网关 → 模式结果端点 → 公共校验

小球开始使用真实倾斜输入；切水果和八段锦仍使用固定轨迹、特征样例推进规则，不等待所有识别工作完成。当天共同检查真实输入与样例输入的边界，并验证相交、错过、重复命中、阶段顺序和非法结果等情况。摄像头输入是否稳定、接口是否接入真实服务、结果是否写入真实数据库，分别作为独立验收项记录。

结算和保存到个人历史是两个动作：结果端点接收并校验游戏结果，POST /sessions/{sessionId}/save 则在用户明确同意后保存。

三、八位成员的 Day3 工作

四、接口口径与跨模块交接

4.1 小球结果口径

Apifox 的小球接口简介与字段说明存在差异：简介写作 targetsHit × 10，而字段定义包含到达终点的奖励。为统一前后端实现，计划采用与系统设计和字段定义一致的口径：

score = min(100, targetsHit × 10 + (reachedEnd ? 50 : 0))

使用“命中 2 个目标并到达终点”的样例区分两种口径，预期分数为 70。正式编码和接口联调前，由林晨、林宇扬、刘婷婷统一接口描述、schema、示例、实现和断言。

4.2 八段锦结果口径

八段锦接口简介出现阶段 ID/数量字段，但详细 schema 使用 metrics.attempts/actions，且不允许额外字段。计划以详细 schema 为 HTTP 请求体口径；内部 actionAttempts 由结果网关转换为 metrics.attempts，阶段动作汇总放在 metrics.actions。八段锦成绩字段固定为 null，不参加分数榜。

4.3 三方交接

• 王婉怡向玩法模块交付 MotionInput 字段、坐标单位、有效状态、失败原因及可重放样例。
• 林凯向林宇扬交付共享碰撞方法和相交/不相交用例；调用双方共用同一几何语义。
• 三位玩法负责人向林晨交付冻结的 GameResult、结束条件和结果字段映射。
• 林晨通过统一结果网关调用模式结果端点；刘婷婷复用公共身份、归属、幂等和结果校验；孙田田负责页面状态和查询展示。
• 测试由全员共同执行。每项交接包含代码/模块位置、输入输出样例、正常与失败路径、未覆盖边界及对应 Issue。

五、Day3 联调与测试清单

以下列出本日需要执行的验收场景。

六、代码、运行展示与缺陷跟踪

本日代码交接如下：

• 协调器生命周期与统一结果网关；
• 站姿校准、leanX 归一化和输入质量事件；
• 小球结果验证及共享 sweptCircle 调用；
• 切水果时间对齐、命中去重和结果端点；
• 八段锦阶段状态与 attempts/actions 转换；
• 页面结果状态、历史查询和明确保存流程；
• 公共结果校验、唯一性、归属与保存事务。

七、燃尽计划

燃尽图按真实 Issue 计算。以下是目前的 52 SP 基线：

八、AI 技术员

用代码助手生成协调器订阅与降级渲染、历史页筛选分页、recordQuery 纯函数与本地模拟运行器；人工核验了 listRecords 的 OpenAPI 参数、BaduanjinResult.score 必须为 null、未改动 GameCoordinator 与玩法类、36 例单测与构建。AI 输出被改或拒的地方：拒绝在协调器失败时跳转结算页、拒绝 pageSize 用 100、以及 AI 未发现样例 payload 缺陷。

九、Day3 复盘与 Day4 安排

Day3 的技术主线是让真实输入、玩法规则和结果接口各有清晰边界：小球进入真实倾斜联调；切水果用时间对齐的腕点轨迹检查共享碰撞；八段锦用阶段特征样例建立两式动作记录；三种结果都准备通过公共校验和统一网关。接下来我们小组打算查看画面是否能动，并确认暂停恢复、重复提交、结果归属和保存意愿是否各自生效。

按计划，Day4 将推进三种玩法的最短闭环：小球和切水果接入真实动作，八段锦先用固定特征样例完成阶段和结算；三种结果经统一网关提交并覆盖保存流程。再由团队全员交叉检查正常结束、提前退出、暂停恢复以及断网重试。若真实链路阻塞，团队决定先保证输入、规则、结果并保存主流程，暂时缩减装饰与非必要统计。

十、仓库页面截图

协调器尚未接入时的训练页提示：

本地模拟运行与结算页：

历史接口失败与筛选状态：

修复后的无残留回归截图：