Files
aetherbound-guild/GOAL_ABG_MVP_QUALITY.md
T

7.4 KiB
Raw Blame History

Goal: ABG MVP 质量达标(MVP QUALITY READY)

Status: ACTIVE Repository: /Users/wusumac/Documents/game/aetherbound_guild Owner authorization: 2026-09-13(owner 指示:生成 Goal 并持续运行,直到 MVP 版本"可以了") Mode: 单会话连续执行(owner 明确授权);不新增并行开发任务、不启用多 Agent 实现 Baseline source: 2e5540ed(M62 组件统一收口) Accepted predecessor: M57 Readiness / M58 Market / M59 检查器 / M60 可玩性 / M61 设计密度 / M62 组件统一

Legal terminal:

  • ABG MVP QUALITY READY
  • ABG MVP QUALITY BLOCKED: <具体边界与需要 owner 决定的事>

Objective

把当前"功能可玩、视觉只统一了两页"的构建,推进到 MVP 质量达标:所有玩家 可见页面统一到共享手绘材质族、每个页面有机器墨迹检查与 owner 验收、完整首轮 可真实游玩并可复现、已登记缺陷清零,然后交给 owner 做最终人类验收(趣味/听感/ 设备/发布仍是 owner 门)。

Experience Or System Contract

  • 玩家情境:全新玩家从 boot 进入,按"开始远征 → 四选二 → 公会 → 委托 → 市场 → 排阵 → 出发准备 → 风险 → 战斗 → 结算 → 恢复"完成一轮,并能继续。
  • 主要动作:每一步只需做一个清晰决定;界面只呈现当前决定所需事实。
  • 即时结果:所有文字在承载面内、与图标无压字、对比达标、触摸目标 ≥48px。
  • 失败/权衡:任何一页达不到上述标准就不能宣称 MVP 达标(机器门 + owner 眼)。
  • 恢复:Save/重返路径不得因视觉迁移而改变语义。
  • 持久后果:远征团、金币、记录等语义保持不变;只改呈现层。

Allowed Scope

  • runtime/entry/views/**、runtime/entry/entry_shell.gd(仅呈现层)
  • runtime/ui/shared/**、runtime/ui/m52/**(组件层)
  • runtime/assets/**(仅在需要替换/新增材质时,且必须登记出处)
  • runtime/tools/**(探针与驱动)
  • docs/**(计划、契约、矩阵、账本)

Frozen Scope And Invariants

  • 玩法/经济/内容/Save/路由/数值语义冻结(docs/01/02/05 为权威)。
  • 已验收页面(Readiness、Market、BAT-001/002)不得在无新缺陷证据的情况下重做。
  • 无付费服务、无新生成批次(除 owner 授权)、无设备/打包/签名/商店/发布动作。
  • 不删除已验收证据与出处;清理只在 owner 签字后执行。
  • 每个工作包仍走:计划 → 实现 → 源绑定验证 → 提交 → 更新 checkpoint/账本。

Definition Of Done

按顺序全部满足,才算 ABG MVP QUALITY READY:

  1. 页面统一(W5):14 个页面视图 + Boot/首次设置/Title/Settings 全部迁到 共享手绘材质族;docs/runtime/M62_PAGE_CONSISTENCY_MATRIX.md 每行从"旧代" 变为"共享族",页面私有 StyleBoxFlat 计数归零;每页有独立或合并探针。
  2. 机器门(W3 延续):所有页面探针接入墨迹检查并通过(INK_OK), 中英两种语言、760/844/1280 三尺寸;M62-I02/I03/I04 全部关闭。
  3. 可玩性(W1 延续):m60-playthrough 完整首轮 0 阻断、视频可复现; 每个迁移后的页面在真实路径上复跑一次完整轮次。
  4. 决策密度(W2 延续):五画像模拟通过;在真实一轮里记录一次墙钟决策 间隔样本(M61-I04),与 docs/02 目标对照。
  5. 本地化/无障碍冒烟:zh_CN/en 100% 全页通过;130% 文本与 reduced motion/flash 冒烟无阻断性缺陷。
  6. 人类验收(owner 门):owner 观看完整首轮视频并实际试玩,记录 comprehension/fun 结论(这项是 owner 决定,不由我自评)。
  7. HEAD == upstream、工作树干净、无遗留运行进程。

Evidence Contract

  • 实现/证据修订:每个工作包独立源绑定 attempt(tools/run_test_attempt.py)。
  • 候选路径:attempt artifact 目录 + docs/EVIDENCE_LEDGER.md 条目。
  • 必需命令与 marker:按工作包在计划中声明,marker 恰好一次、strict 诊断 0。
  • 必需代表状态:每页 static / dynamic(中性底)/ final × 中英 × 三尺寸。
  • 证据等级:runtime_verified → agent_reviewed → 交 owner human_reviewed。
  • 保持 OPEN 的门:趣味/理解、听感、设备、打包/签名/商店/发布。

Execution Loop(命令每次调用执行一个工作包)

  1. 读 GOAL_ABG_MVP_QUALITY.md + CURRENT_CHECKPOINT.md + docs/EVIDENCE_LEDGER.md。
  2. 取"下一个未完成工作包"(W4 → W5 DEV-1R → DEV-2R → DEV-3R → DEV-4R → DEV-5R → DEV-6R → 冒烟 → 交接验收)。
  3. 为该工作包写/更新窄计划(一页一计划、一提交、一验收),实现 → 探针验证 → 源绑定 attempt → 提交 → 更新 checkpoint 与账本。
  4. 工作包内发现的新缺陷进 issue register,不静默扩包。
  5. 命中 owner 门(验收/授权类)时输出 ABG MVP QUALITY BLOCKED: <边界> 并停。

Decisions Log

  • 2026-09-14 · Owner:ElevenLabs 音乐/音效生成改为常设授权(“以后需要就自己生成,不用等我同意”);同步修订 06_DEVELOPMENT_AND_REVIEW.md 的付费授权边界;旧 fg2/fg4 合成占位音不再播放、保留出处。

  • 2026-09-14(owner 指示 + 验收):角色形象统一(M69)。Owner 指出角色形象不统一, 并指定标题页那对柔绘 Q 版角色为风格基准;要求人像与底图角色"都一起换"。执行结果: V1(旧立绘作构图参考)偏硬边被否 → V2(仅标题页风格参考)柔绘但"不够 Q" → V3 (1.8 头身大头短手脚、布偶感)获 owner 认可;12 职业立绘重出、委托底图去角色化 (改为显示玩家真实队员)、全严格门 104 扫描 0 违规;owner 于 2026-09-14 看过换装后 的 21 页全景并回复"可以的"。旧素材(pf_b*/m52_q_company/旧底图)保留溯源。

  • 2026-09-13:Title 视觉权威取当前已接线的 M52 Q 版标题背景 + 共享手绘族 组件重做;8/19 的 v002 候选转入历史证据(owner 两次未指定,按"你看着办" 由我决定并记录于此)。

  • 2026-09-13:M60-I03(已招募 Offer 占卡位)与 M60-I04(遗留可恢复远征团 禁用"新游戏")并入 DEV-1R / DEV-3R 工作包处理,不单独开工。

  • 2026-09-13(owner 指示,第二次更严格):只做一种横屏尺寸 1280x720。 已执行:入口页/四选二页删除全部按尺寸分叉(settings short_layout、setup 紧凑双列、 按高度的行高/间距/栏宽选择);project.godot 窗口覆盖改 1280x720;窗口化触摸测试 统一 CONTENT_SCALE_ASPECT_KEEP + 1280x720(此前是 EXPAND + 844x390,这正是 UI 在不同尺寸下走样与测试错位的来源);当前世代响应式/捕获测试与 m63/m53/m54 探针只跑 1280x720。旧 P9.x/p10_2 测试与旧页面的尺寸分支留待各自迁移轮清理, 不得再新增。

  • 2026-09-13(owner 指示):目标视口收敛。宽屏 1280x720(16:9)是唯一设计 权威;1280x600 只作宽屏冒烟。手机横屏(844x390、760x360)留到后续步骤,届时 只做整体缩放适配,不允许再为小尺寸增加第二套构图/紧凑分支。现有小尺寸 测试保留为不溢出的冒烟门,不再按其缺陷改设计;探针以宽屏为主尺寸。