7.4 KiB
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 READYABG 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:
- 页面统一(W5):14 个页面视图 + Boot/首次设置/Title/Settings 全部迁到
共享手绘材质族;
docs/runtime/M62_PAGE_CONSISTENCY_MATRIX.md每行从"旧代" 变为"共享族",页面私有StyleBoxFlat计数归零;每页有独立或合并探针。 - 机器门(W3 延续):所有页面探针接入墨迹检查并通过(
INK_OK), 中英两种语言、760/844/1280 三尺寸;M62-I02/I03/I04全部关闭。 - 可玩性(W1 延续):
m60-playthrough完整首轮 0 阻断、视频可复现; 每个迁移后的页面在真实路径上复跑一次完整轮次。 - 决策密度(W2 延续):五画像模拟通过;在真实一轮里记录一次墙钟决策
间隔样本(
M61-I04),与docs/02目标对照。 - 本地化/无障碍冒烟:zh_CN/en 100% 全页通过;130% 文本与 reduced motion/flash 冒烟无阻断性缺陷。
- 人类验收(owner 门):owner 观看完整首轮视频并实际试玩,记录 comprehension/fun 结论(这项是 owner 决定,不由我自评)。
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→ 交 ownerhuman_reviewed。 - 保持 OPEN 的门:趣味/理解、听感、设备、打包/签名/商店/发布。
Execution Loop(命令每次调用执行一个工作包)
- 读
GOAL_ABG_MVP_QUALITY.md+CURRENT_CHECKPOINT.md+docs/EVIDENCE_LEDGER.md。 - 取"下一个未完成工作包"(W4 → W5 DEV-1R → DEV-2R → DEV-3R → DEV-4R → DEV-5R → DEV-6R → 冒烟 → 交接验收)。
- 为该工作包写/更新窄计划(一页一计划、一提交、一验收),实现 → 探针验证 → 源绑定 attempt → 提交 → 更新 checkpoint 与账本。
- 工作包内发现的新缺陷进 issue register,不静默扩包。
- 命中 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)留到后续步骤,届时 只做整体缩放适配,不允许再为小尺寸增加第二套构图/紧凑分支。现有小尺寸 测试保留为不溢出的冒烟门,不再按其缺陷改设计;探针以宽屏为主尺寸。