Files
aetherbound-guild/docs/plans/M79_REGION_CONTENT.md
T

4.8 KiB
Raw Blame History

M79 · 区域内容实现(按区域推进到设计门全量)

Owner 指示(2026-09-14):"就按你说的都做"——战斗演员之后开始按区域补内容。

Player-visible stopping point

设计合同 05_CONTENT_CATALOG.md 的全部内容在运行时可达:8 区域(320 装备 / 100 敌人 / 16 Boss / 60 遗物 / 16 合同),每区域有:区域数据、遭遇语法(按区域带抽取敌人)、该区域的装备/遗物商店带、 合同与 Boss 配对、区域战斗/BOSS 音乐、敌人与 Boss 立绘;双语(zh_CN/en)名称与语义标签齐全。

现状(2026-09-14 核实)

  • 设计文档已含全部内容(320 EQ / 100 EN / 16 BO / 60 AR / 8 RG ✓)。
  • 运行时目录此前只有 RG-01(40/12/2/8 + 2 合同 + 137 条 name_zh/execution_tags)。
  • 抽取管线 tools/content/build_catalog_from_contract.py 已把全量主数据解析进目录, 但注册表需要每行的 name_zh + execution_tags(作者内容)→ 按区域切片补齐,每片都过门。

Ordered steps

  1. M79-A(COMPLETE)区域 2:EQ-041..080、EN-R2-01..12、BO-R2-01/02、AR-009..015、 CTR-R2-01/02 的中文名 + 语义标签;注册表计数更新(80/24/4/15/2/4);区域带接线(战斗/装备按区域抽); 区域 2 敌人立绘(12×2)+ Boss(2×2);区域 2 战斗/BOSS 音乐;全流程门。 1b. M79-B(COMPLETE)合同推进/区域前进:合同按序数从目录取行(2/区域),区域带随行落地; 已归还的合同作为历史保留(含其全部回执),修订号 = 已建合同数 + 已提交动作数;第三次合同进区域 2 ✓; 区域 2 战场底图与区域音乐族切换。
  2. M79-C..G 区域 3..8:同样管线逐区域推进(每区域一片,含立绘/音乐/门)。
  3. M79-H 收口:全量计数门(320/100/16/60/8/16)、区域推进(合同按区域前进)、 区域图鉴/解锁与区域差异实拍。

Frozen scope

  • 只实现设计合同已写的内容;不发明机制、数值或名称风格之外的规则。
  • 合同行(CTR-*)为派生(区域矩阵 + RG-01 基线),已在目录标记 derived,待 Owner/设计复核。
  • 像素资产不复活;美术沿用已验收风格族。

M79-A 产出(2026-09-14,数据与本地化部分)

  • 抽取管线 tools/content/build_catalog_from_contract.py:按 --through-region N 从设计合同重建目录, 行内文(装备/遗物/敌人/Boss/区域)全部来自合同;tools/content/content_locale_zh.json 提供每行的 中文名 + 语义标签(缺失即构建报错,不含占位)。
  • 合同行(CTR-*)按区域派生(2/区域 = 16),标记 derived 待复核。
  • 注册表改为分阶段:CONTENT_STAGE_REGIONS = 2(80 装备 / 15 遗物 / 24 敌人 / 4 Boss / 2 区域 / 4 合同; 201 行本地化齐备);收口时改为 8(320/60/100/16/8/16)。
  • 区域带接线:市场装备只从本区域 40 件里抽;战斗报价只从本区域敌人里抽(按 region 字段过滤)。
  • 门:ABG_P10_0_CONTENT_REGISTRY_OK professions=36 ... equipment=80 artifacts=15 enemies=24 bosses=4 contracts=4 localized=201 (marker 现在打印真实计数);音频服务门与 34 步全流程不回归。

Acceptance checks

  • 注册表测试通过:计数、连续 ID、name_zh、execution_tags、无填充词(含误报例外登记)
  • 每区域的敌人/装备/遗物只在自己的区域带内出现(区域带断言)
  • 双语探针(1.0/1.3 × zh/en)0 违规;全流程 34 步 0 阻断;战斗门/音频门不回归

Issue register

ID 状态 说明
M79-I01 OPEN 合同行(16 条)的 round_count/first_clear_renown 为派生值,待复核
M79-I02 OPEN 填充词检查对 copy of 有误报(EQ-248、BO-R3-02 是机制描述),需登记例外或改写措辞
M79-I03 RESOLVED(Owner:'超出 MVP 没事,可以支持你做') 区域 2+ 内容目前在运行时不可达:合同循环只到首份合同(contract_ordinal != 0 即拒绝),
第二次合同/区域推进属"第二周目"范围(M31-I03 曾判定超出首个 MVP 停点)。按区域补内容要真正可玩,需要一步
"合同推进/区域前进"(含区域 Boss Muster、区域音乐与立绘切换)。建议作为 M79 的下一步。
M79-I04 RESOLVED 区域 2 立绘 28 张 + 战斗/Boss 音乐各 1 套已生成并接线
M79-I05 OPEN 区域推进已有服务层门(region_advance_test),UI 全流程(合同→…→归还→下一合同)尚未驱动验证;
收口阶段补一次"两周目"全流程驱动
M79-I06 OPEN 16 条合同的 round_count/first_clear_renown 仍为派生值(待复核);超出已实现区域后合同会重复最后一份(后游戏范围)