Files
aetherbound-guild/docs/runtime/ABG_REMAINING_WORK_AND_GATES.md
T

8.8 KiB
Raw Blame History

Aetherbound 剩余工作与门禁清单

用途:程序级盘点文档。回答"还要查什么、还差什么、下一步做什么"。 权威来源:docs/06_DEVELOPMENT_AND_REVIEW.md(Program Acceptance Gates + Development Plan V2)、AGENTS.md(Design Completion Gate)、 CURRENT_CHECKPOINT.md(当前阶段与验收记录)。冲突时以上述权威为准。 维护规则:每完成一次页面验收或门禁检查,更新对应行与证据路径;不得 用本文件替代里程碑计划或验收记录。 最近更新:2026-09-13(M58 Market 验收后)。

1. 页面视觉状态

判定口径:ACCEPTED = 有 owner 在当前手绘材质族(page_chrome.gd / market_chrome.gd 比例手绘材质 + 引擎文字)下的验收记录;OPEN = 当前 修订没有该记录(可能是旧族材质、或只做过实现/结构门)。自动化测试通过 不算 ACCEPTED。

页面 入口/视图 状态 证据 下一步
Boot / 首次设置 entry_shell / boot_service OPEN Setup v001 仅 DRAFT_REVIEW,未进运行时 并入 DEV-1R
Title entry_shell(M52 标题背景) OPEN M52-A 批准方向板;Title 页本身无验收记录 DEV-1R
初始四选二 / 招募检视 recruit_review_page_view OPEN M40 结构迁移;无当前族验收 DEV-2R
Guild guild_page_view OPEN M53 模块迁移;当前材质族未覆盖 DEV-3R
Contract contract_choice_page_view OPEN M54 模块迁移;当前材质族未覆盖 DEV-3R
Market market_page_view ACCEPTED m58-market-probe 20260913T114947Z-91894;owner 这个 OK 了 —
装备检视 market_page_view(equipment 分类) OPEN 无独立验收 DEV-3R
Party Line party_line_page_view OPEN M39 结构迁移 DEV-4R
Readiness readiness_page_view ACCEPTED m57-readiness-probe;owner 2026-09-13 —
Risk Board risk_board_page_view OPEN M38 结构迁移;验收早于方向反转 DEV-4R
Risk Commitment risk_commitment_page_view OPEN M36 结构迁移;验收早于方向反转 DEV-4R
Battle Opening battle_opening_page_controller ACCEPTED BAT001-RUNTIME-02(2026-08-24) —
Battle Live battle_live_page_controller ACCEPTED BAT002-RUNTIME-11(2026-08-24) —
Battle Result battle_result_page_view OPEN M55 迁移;无当前族验收 DEV-5R
淘汰回顾 OUT-002 knockout_review_page_view OPEN M34 结构迁移 DEV-5R
奖励选择 OUT-003 reward_choice_page_view OPEN M33 结构迁移 DEV-5R
恢复 OUT-004 recovery_page_view OPEN M30 结构迁移 DEV-5R
Company 花名册 company_roster_page_view OPEN M44 结构迁移 DEV-6R
招募详情 / 解雇 / 合同返回 recruit_detail_page_view 等 OPEN 结构迁移 DEV-6R

2. 内容生产状态

  • 目录权威 docs/05_CONTENT_CATALOG.md 计数已核对:42 个职业 ID (12 基础 + 24 进阶 + 6 隐藏)、36 特性、320 装备、60 神器; 100 普通/精英敌人、16 Boss、8 区域、16 合同按区域矩阵记录 (EN-Rn-nn / BO-Rn-nn / RG-nn)。
  • 运行时实现:已验证到 RG-04 中点;RG-05..RG-08、全部 Boss 遭遇、 结局与 Oath Season 的运行时身份解析与决策影响未完成(程序门 "Complete Runtime" 仍 OPEN)。
  • 生成招募规则:docs/05 已定义(确定性顺序、命名池、视觉语法、 属性/trait/职业/装备起始、稀有度边界);运行时按首循环范围实现。

3. 门禁清单

A. 设计完成门(AGENTS.md,八条)

# 条目 状态 说明
1 产品与玩家体验合同 文档齐备 docs/01;批准记录以 docs/06 P0 为准
2 核心循环/战斗/职业/技能/成长/经济/失败/存档/难度/通关后规格 文档齐备 docs/02(2703 行)
3 完整内容目录与生成规则 文档齐备 docs/05;见上节计数
4 屏幕/状态图、引导、无障碍、本地化、输入、错误/空/确认/设置/终局 文档齐备 docs/03;运行时覆盖到首循环
5 美术方向、资产清单、动画矩阵、VFX、音乐、SFX 计划 计划齐备,音频未生产 docs/04;运行时仅 28 个 FG-2 wav
6 覆盖每页与关键状态的 HTML 设计画廊 部分 docs/design-authority/gallery/index.html 由 tools/build_design_gallery.py 重建;"每页每状态"未验证
7 经济/构筑模拟与决策密度审计 部分(W2 完成) 五画像模拟通过(m61-five-profile:decisions=330、max_gap=31.3s、risks 0/1/2、反支配、存档一致、内容可达);全战役与墙钟密度待内容构建后复测(M61-I03/M61-I04),见 docs/runtime/M61_DESIGN_AND_DENSITY_REVIEW.md
8 交互式设计原型与 owner 审阅 部分 教程战斗 P9.0R3 已验收;其余页面未覆盖

B. 程序验收门(docs/06)

  • Complete Runtime:OPEN。内容身份未全部实现;结局/Oath Season 未验证。
  • Verified Candidate:PARTIAL。
    • 有:全套首循环 normal 100% 矩阵、strict diagnostics 0、Save v11 迁移/损坏/重试类回归、parsed touch、路由回归。
    • 缺:五种节奏画像(normal/active/efficient/adversarial/returning) 未跑;130% 文本、reduced motion/flash、mute、low power 的系统性冒烟 未在 M57/M58 新族页面上重跑;时钟变更与零离线价值未验证。
  • Owner Checkpoints:三个既定边界中,第 2 个(RG-04 中点)于 2026-08-17 因像素 H5 被拒,现处于手绘方向重做;第 3 个(完整首通 beta)未到。

C. 人文/外部门

  • 理解与趣味(comprehension/fun):OPEN,需真人试玩。
  • 听感(listening):OPEN,音频目录计划在 docs/04,实际资产仅 FG-2 小批量,未做全量生产与混音验收。
  • 设备:OPEN,M49 本地 iOS 路径已配置,但无可用真机。
  • 打包/签名/TestFlight/商店/发布:FROZEN,需 owner 单独授权与计划。

3.5 可玩性事实核查(2026-09-13 首轮)

Owner 反馈"MVP 还玩不了",因此先跑事实核查,而不是继续做页面。

  • 通过:entry-truth-pass(源绑定 attempt 20260913T134101Z-78670)—— ABG_DEV1_BOOT_RUNTIME_OK(EntryShell 启动、facade 隐藏、交接首次设置) 与 ABG_DEV1_ENTRY_TOUCH_OK(真实触摸:boot→首次设置→Title→Settings→ 应用→返回;重启回 Title,重置回首次设置)各一次,strict 诊断 0。
  • 测试漂移(待修,非功能结论):
    • runtime/tests/p10_0/main_front_door_test.gd 期望 auto_boot=true 直接 创建 P10 运行时;当前入口优先顺序是 EntryShell 先行,p100_experience 在该路径下为 null,测试在第 27 行报错并挂起。
    • runtime/tests/dev3/guild_contract_choice_test.gd:60 期望节点带 text 属性(Label),当前 Guild/Contract 迁移后该节点是 Control。
    • 两个脚本都是旧时代测试,随 PageView/视觉迁移漂移;需要与当前路径 对齐后再作为回归使用。
  • 已回答(2026-09-13,M60):EntryShell 路径的完整首轮已真实驱动通过 (34 步、0 阻断、34 次真实触摸、视频 + 逐步截图),证据见 docs/runtime/M60_PLAYABILITY_TRUTH.md 与 attempt 20260913T145904Z-38281。发现的开放项:M60-I03(已招募 Offer 仍占 卡位)、M60-I04(存在可恢复远征团或遗留 .bak 时"新游戏"被禁用)、 M60-I05(测试用回放加速)。

4. 已挂起的小项

  • M58-I09(docs/plans/M58_MARKET_READ_SURFACE_REPAIR.md):两个既有 dev6 失败,其中 Guild 交接页 GuildRisk 按钮 41px 低于 44px 触控下限; M58 冻结范围外。
  • M58-I11:已解决(M59_PROBE_INK_CHECKS,2026-09-13)。Market 探针 现已内置 runtime/tools/ui_ink_check.gd 与最长线上文案 fixture;检查器 同时抓出并修复了 6 处残留缺陷。检查器接入其它页面属于 M59-I03。

5. 建议顺序

  1. M58-I11 探针加固(小、保护后续所有页面)。
  2. DEV-1R Title / Boot / 首次设置(玩家第一步;做完 DEV-1R 四页 才符合登记的执行顺序)。
  3. DEV-2R 初始四选二与 Company 交接。
  4. DEV-3R Guild / Contract / 装备检视(统一到 page_chrome.gd 材质族)。
  5. DEV-4R Party Line / Risk 两页;DEV-5R OUT-001..004;DEV-6R Company 管理。
  6. CONTENT-1 起逐区域生产(RG-05+)、随后经济模拟与决策密度审计、 五种节奏画像、130%/无障碍冒烟,最后才是设备/打包/发布授权。

每一步仍是"一页一计划、一提交、一验收";本清单不授权任何产品代码。