133 lines
8.8 KiB
Markdown
133 lines
8.8 KiB
Markdown
# 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%/无障碍冒烟，最后才是设备/打包/发布授权。
|
||
|
||
每一步仍是"一页一计划、一提交、一验收"；本清单不授权任何产品代码。
|