合并(架构文档收敛批): architecture.md v3.0 依赖规则形态(221行)——删模块归属表换目录归属表(目录=层级物理承载,同目录同层级同约束,领域不切目录)+删API边界表(规范源单点=GDD)+29处判据锚全部迁出架构文档(16+5直指GDD规范句/3指架构保留节/3锚game-sim头注并扩锚空间)+补GDD契约句5句(战斗结算扩展行节/排雷玩法揭示预览口/冒险结构种子三分)+八处文档引用改指+架构图region标签目录化重渲染+capability_audit认.gd锚与game-sim空间。区内凭据: --docs域闸【验收通过】+能力审计红项0+并master重出闸全量档七闸全绿(GATES_EXIT=0×2轮, 含.a710477b并入后); 合回前置检查读数见pre-merge钩子; post-merge钩子推送触发远端CI
ci / gates (push) Successful in 8m23s
ci / gates (push) Successful in 8m23s
This commit is contained in:
DKChan committed
commit
fdd536942a
29 files changed
+115
-174
No files matched your search
@@ -48,7 +48,7 @@
|
||||
| 定文档方案 / 写文档 / 改文档前 | `design/engineering/doc-conventions.md`——白话写作 / 载体分工 / 用语 / 结构骨架 / 会话记录与生命周期 |
|
||||
| 概念切分与互链 | `design/engineering/concept-conventions.md`——概念封装 / 跨文档引用 / 归档与事实源 |
|
||||
| 系统设计 / 增删文档 | `design/gdd/02-系统清单.md`——根索引 + 中文规范名↔英文代号对照 |
|
||||
| 架构（唯一事实源） | `design/engineering/architecture/architecture.md`（只写约束面：分层/模块归属/数据流/API 边界；实现现状归代码与头注，闸清单归 `game/tests/README.md`）——历史决策沿革查 git commit log，不另设决策文档；修订须用户发令 |
|
||||
| 架构（唯一事实源） | `design/engineering/architecture/architecture.md`（只写依赖规则面：分层/目录归属/数据流/架构原则；模块级归属归代码头注，闸清单归 `game/tests/README.md`）——历史决策沿革查 git commit log，不另设决策文档；修订须用户发令 |
|
||||
| 术语与已锁数值 | 规范名与定义 = `design/gdd/术语表.md`（全库唯一对照表，仅 owner 文档可修订）；现行数值 = `game/data/tables/*.tres`；规则（概念面）= 各系统 owner 文档；取值域与字段契约 = `game/data/schemas/*.gd`。冲突须显式提出，禁默默改值 |
|
||||
| 现在做什么 / 待办与待裁 | 根 `roadmap.md` 顶部「当前位」节＋迭代总表六列 · 待办唯一登记处 `待办清单.md` · 批次过程与结论查 git 提交信息与 `reports/` |
|
||||
|
||||
@@ -122,7 +122,7 @@
|
||||
- 文件头 = `##` 文档注释，介绍本模块是什么；禁写变更叙事（改动史查 git log）；禁文档反向链接（code-conventions §1.4.1）
|
||||
- 数值单一事实源——玩法数值只存 `data/tables/`（.tres）经 ConfigDB 单点读取；禁数值字面量与自建 `load()` 表路径
|
||||
- RNG 单点——禁 `randomize()`/自建 RandomNumberGenerator，随机只经 `RngService` 统一流
|
||||
- 架构事实唯一源——架构事实只认 `design/engineering/architecture/architecture.md`（只写约束面：分层/模块归属/数据流/API 边界；实现现状归代码与头注）；禁立第二架构文档或决策文档体系，历史决策记录只进 git commit log；架构文档写权限＝用户专属，agent 与技能只读（2026-11-07 用户裁）
|
||||
- 架构事实唯一源——架构事实只认 `design/engineering/architecture/architecture.md`（只写依赖规则面：分层/目录归属/数据流/架构原则；模块级归属归代码头注）；禁立第二架构文档或决策文档体系，历史决策记录只进 git commit log；架构文档写权限＝用户专属，agent 与技能只读（2026-11-07 用户裁）
|
||||
- Core 层零 UI 依赖——完整战斗必须可 `--headless --script` 跑通；fail-fast——数据校验错误一律致命中止，无软回退
|
||||
- spec-AC 一致性——规约与验收标准禁止在同一输入上给出不同答案；评审隔离——`/design-review` 必须独立会话跑（与 `/design-system` 隔离）
|
||||
- 像素结构件——先抄后造、验收写成像素级判据、±1px 坐标推导（process-conventions 第 7 节）
|
||||
@@ -2,11 +2,11 @@
|
||||
|
||||
## 文档状态
|
||||
|
||||
- 版本：2.0（收窄为约束面形态——分层/模块归属/数据流/API 边界；实现现状归代码与代码头注，实现历史归 git commit log，闸清单与判定口径归 `game/tests/README.md`，见 doc-conventions「架构事实唯一源」行）
|
||||
- 版本：3.0（依赖规则形态——分层/目录归属/数据流/原则；模块级归属登记与模块对接口契约均不进本文：前者归代码文件头注，后者规范源单点＝各系统 GDD、执法＝静态扫描域与契约测试）
|
||||
- 引擎：Godot 4.7.2-stable（GDScript 单语言；2026-09-07 锁定）
|
||||
- 评审模式：solo（`review-mode.txt`——门禁按 solo 跳过）
|
||||
- 覆盖 GDD：现行全集（根索引＝`design/gdd/02-系统清单.md`，文档树构成以根索引为准）
|
||||
- 事实源地位：本文是架构约束的唯一权威（分层/模块归属/数据流/API 边界）；写权限＝用户专属（agent 与技能只读）
|
||||
- 事实源地位：本文是架构约束的唯一权威（分层/目录归属/数据流/架构原则）；写权限＝用户专属（agent 与技能只读）
|
||||
- 实现实证：`game/`（完整游戏开发版本；本文分层与所有权经实现验证）。测试层级＝冒烟/单元/系统三级＋UI 探针与渲染 golden，识别三元组权威＝`design/engineering/test-conventions.md`「测试层三元组」节
|
||||
|
||||
---
|
||||
@@ -74,66 +74,19 @@
|
||||
|
||||
---
|
||||
|
||||
## 模块归属
|
||||
## 目录归属
|
||||
|
||||
> 命名遵循 `design/engineering/code-conventions.md`：领域命名、禁 ID 前缀。本表只写约束：模块的职责语句、对外封闭面概述与消费依赖——各件的完整公开方法面、成员与接线明细归代码文件头注（`##` 文档注释）与代码自身承载；文件路径是导航索引。
|
||||
> 目录＝层级的物理承载：同一目录内的文件同层级、同受该层约束属性管辖，职责各自独立、归各文件头注（`##` 文档注释）承载；领域不做目录切分，仅当领域大到内部再需要一层时才立子目录。命名遵循 `design/engineering/code-conventions.md`：领域命名、禁 ID 前缀。逻辑依赖层级（基础/核心/功能/呈现）见「系统分层图」——`game/core/` 一目录内按依赖层级再分三段，层级约束由分层图与架构原则承载，目录不再切分。
|
||||
|
||||
### 基础层
|
||||
|
||||
| 模块 | 文件 | 独占职责 | 对外封闭面 | 消费依赖 |
|
||||
|---|---|---|---|---|
|
||||
| **ConfigDB**（autoload，D2） | `game/core/config_db.gd` | 全部玩法数值表唯一加载与持有单点（`.tres` 经校验后入容器）；行族访问器归各 schema 表类（表管自己的行查询），本类只留加载/校验/override/诊断门面，表持有按域收进域容器 Resource | 类型化域容器属性＋load_tables / reload / set_reload_gate / diagnostics 族 | 无（基础层顶点） |
|
||||
| **RngService**（autoload，D2） | `game/core/rng_service.gd` | master_seed 与各封闭流 scope 计数器单点（封闭流词表现值以 `RngServiceCore.PURPOSE_TAGS` 为准，增流走 P1 评审） | set_master_seed（唯一调用方 C2）/ open_stream 有状态门面 / derive_at 纯函数 / 只读计数器 | 无 |
|
||||
| **save_system**（SaveManager，autoload，D3） | `game/core/save_manager.gd` | 存档格式与版本比较、序列化接线单点；槽位文件域归 SlotStore、元进度数据归 MetaStateStore | 写盘/读回/槽位管理/断点快照公开面（契约规范源：`../../gdd/systems/表现与支撑/存档序列化.md`——契约锚：SAVE_FORMAT_VERSION + master_seed + 各流 scope 计数器快照） | ConfigDB、RngService 只读计数器 |
|
||||
| **SlotStore**（D3） | `game/core/slot_store.gd` | 存档三槽位文件域唯一所有者：槽位挂载与模板、激活与建删、摘要窥视 | 槽位读写原语族＋摘要投影 | save_manager（注入路径与模板配置） |
|
||||
| **MetaStateStore**（D3） | `game/core/meta_state_store.gd` | 存档内元进度数据的读写唯一层（数据读写原语，不含业务规则） | 写口原语族＋只读投影（消费方经 `save.meta_state.` 直连） | save_manager（序列化接线） |
|
||||
| **MetaProgression**（autoload，C4） | `game/core/meta_progression.gd` | 元进度账本服务：钥石收束入账、营地消费定价与解锁判定的纯被动服务，零信号零外发；业务层（数据读写全经 MetaStateStore） | 写口族（天赋树/锻造/同调）＋解锁判定与读投影；四个 Autoload 中唯一有跨 Autoload 依赖（ConfigDB/SaveManager） | ConfigDB、SaveManager |
|
||||
| **action_economy**（A3） | `game/core/action_economy.gd` | AP/RAP 账本、轮次相位机 {Idle, Active, Waiting}、结束仲裁 | 意图与通知布尔面（request_dig / request_stop / request_refresh / notify_* 族）＋预授权通道；ap/rap/phase 只读 | ConfigDB、EffectPort、B1 回发 |
|
||||
| **variation**（A4） | `game/core/variation*.gd` | VariationTable schema 与 F1 候选池门控谓词 | variant_pool（门控三维）/ global_variant_row 访问器 | ConfigDB |
|
||||
| **status_container**（B3） | `game/core/status_container.gd` | 状态实例容器（战斗域生命周期、跨轮跨图延续） | 五 API：notify_battle_start / apply_effect / query_active / decay_round / notify_battle_end | ConfigDB |
|
||||
| **effect_engine** | `game/core/effect_engine.gd` | 零运行时可变状态的全同步解释器（架构原则 8）：事件由宿主在明确代码点位显式 dispatch 进件，命中序＝装载声明序，不是事件总线/事件循环 | rebuild / dispatch / validate_trigger_row ＋静态计数口；事件/事实/效果类型/算子四词表封闭＋树规则合成订阅六键 | ConfigDB 行集、EffectContext 引用束（四桶由宿主持有） |
|
||||
| **settings/localization**（D6，愿景） | — | 设置项、翻译数据 | （契约规范源：`../../gdd/systems/表现与支撑/设置与本地化.md`） | ConfigDB |
|
||||
|
||||
### 核心层
|
||||
|
||||
| 模块 | 文件 | 独占职责 | 对外封闭面 | 消费依赖 |
|
||||
|---|---|---|---|---|
|
||||
| **board_generator**（A1） | `game/core/board_generator.gd` | 生成算法（五阶段管线）、合法性谓词（clearable / R₀≠S / min_safe）、可推理率度量；生成姿态＝MVP 同步生成＋加载幕（WorkerThread 留扩展） | `generate(L, D, rng) -> Board`；度量独立入口 | ConfigDB；board_gen 封闭流（一次 open_stream＝一张图） |
|
||||
| **minesweeper_rules**（A2） | `game/core/minesweeper_rules.gd` | 棋盘状态（已开集/封印集/小人位）、批次仲裁、install 四不变式 | `install_board` / `settle_batch`（唯一提交入口）/ 查询只读面 / preview_reveal 只读预览口 / retire_board；三事件封闭（cell_revealed / flag_judged / round_end，payload 字段封闭） | A1 Board 契约（class_name 数据契约）；A3 try_spend |
|
||||
| **unit_container**（B2） | `game/core/unit_container.gd` | hero/enemy 单位实例（hp/atk/实例池） | spawn / query_alive / 动作与伤害面 | ConfigDB |
|
||||
| **reward_economy**（B4） | `game/core/reward_economy.gd` | 格面资源身份映射（install 期预分配、换图映射消亡）、极性路由字典面、受理账面（装配期摇号归掷格件 RewardRoller） | 封闭 API：roll_board / query_identity / grant / grant_clear / retire_mapping / polarity_row / phase | ConfigDB；BattleFxHost 偏运合计查询（注入 Callable） |
|
||||
| **helper_items**（A5） | `game/core/helper_items*.gd` | HelperItemTable、探测显影语义 | （契约规范源：`../../gdd/systems/跨局循环/秘宝.md`——桥接位：A2 查询接口＋A4 counter_item_ids） | A2 / A4 / B4 |
|
||||
| **CurioDeck**（A5） | `game/core/curio_deck.gd` | 三选一/商店共享令牌池、抽签、cap 库存与专长凭证判定唯一所有者（停点编排与兑付推进留 CurioStop） | draw_candidates 抽签 / consume 族池消耗 / cap_ok / 凭证判定 / stock 只读投影 | ConfigDB；注入 RngServiceCore（reward_pick 封闭流） |
|
||||
| **ShopSession** | `game/core/shop_session.gd` | 关卡商店双模式（legacy 固定三件／pool 共享令牌池）的货架、定价、购买与刷新唯一宿主；账本/钱包经宿主 LevelRunner 注入共享引用 | 货架与定价只读面＋写入口；调用方经宿主公开成员 `shop` 直连 | ConfigDB；注入 RngServiceCore；pool 模式经注入 Callable 转 CurioDeck |
|
||||
| **HeroStats** | `game/core/hero_stats.gd` | 冒险生命周期主角数值域唯一所有者：生命账与特性持有集、生效公式单点 | 构造注入；单写原语族＋只读投影 | ConfigDB；注入 GainJournal（只读）；AdventureRunner 创建 |
|
||||
| **GainJournal** | `game/core/gain_journal.gd` | 统一冒险加算区与获得记录唯一所有者（三层结构：记录→明细→四轴汇总） | gain_bonus 单写原语；记录与汇总只读投影 | AdventureRunner 创建，注入各消费方 |
|
||||
| **GpWallet** | `game/core/gp_wallet.gd` | 冒险局内货币唯一所有者（不入存档不入摘要） | gain / spend / clear 单写原语 | AdventureRunner 创建，宿主与商店注入读写 |
|
||||
| **RefreshBank** | `game/core/refresh_bank.gd` | 三选一刷新三源账唯一所有者＋GP 付费刷报价公式（零停点态依赖，编排归 CurioStop） | 支出与余量原语＋报价公式；断点自交片段（refresh_stock / attune_refresh_y） | ConfigDB；注入 CurioStop 支出路径 |
|
||||
| **AttuneLoadout** | `game/core/attune_loadout.gd` | 装备中的秘宝件对象集与同调充能唯一所有者（种行/补行改写时同步） | 构造注入；充能查询/消耗/按周期重置原语 | ConfigDB；TreasureItems 投放面；注入使用路径 |
|
||||
| **CurioStop** | `game/core/curio_stop.gd` | 三选一停点编排唯一所有者（架构原则 9 本域承载）：停点三态、刷新编排、兑付方法族、零自动推进语义 | 开停点/刷新/兑付/放行谓词/交断点片段五组入口＋信号面（curio_choice_presented / curio_resolved） | ConfigDB；注入 CurioDeck、HeroStats、GainJournal、RefreshBank |
|
||||
| **breakpoint_store** | `game/core/breakpoint_store.gd` | 存档断点组装与回放唯一承载：断点快照拼盘、回放回填、读侧策略分发 | `BREAKPOINT_FIELDS` 键登记单源（键名/策略标签/键序冻结） | 注入引用束 |
|
||||
|
||||
### 功能层
|
||||
|
||||
| 模块 | 文件 | 独占职责 | 对外封闭面 | 消费依赖 |
|
||||
|---|---|---|---|---|
|
||||
| **battle_orchestrator**（B1，域文件集＝编排器＋`settlement/` 五段段类＋其拆件：BattleFxHost / RewardGrant / DamageController / BattleRefreshFlow / BoardInstaller / RoundCycle / BattleFacts / EffectPort / RewardRoller） | `game/core/battle_orchestrator.gd` 等 | 战斗域编排唯一宿主：战斗状态机与生命周期、A2 三事件订阅、结算五段驱动（授予/增益减益/战斗/衰减/判定，段序冻结于 SettlementTable.segment_order）、行发射基建、呈现投影；**战斗域全部跨系统调用权集中本域**（静态扫描域 S7 执法，文件集清单单点＝`game/tests/static_scan.sh`） | `begin_battle(encounter)`；窗口/刷新意图提交面；`level_clear()`；步骤流（输出契约）；[明细行协议](../../gdd/systems/战斗循环/战斗结算.md#明细流水每一行都能指回你刚才的哪一步棋) | B2/B3/B4 全调用面；A2 订阅；A1 generate；A3 代理+回发；D2 SettlementTable |
|
||||
| **level_runner**（C1） | `game/core/level_runner.gd` | 关卡域生命周期：节点链推进、共享 B4、HP 携带、关卡末 level_clear；依赖构造注入一次给齐 | 节点推进接口；LevelTable（ConfigDB 跨表校验） | B1（直构接线战斗）、ConfigDB |
|
||||
| **run_structure**（C2） | — | 冒险/关卡序列、失败重开、**master_seed 唯一接线方** | （契约规范源：`../../gdd/systems/冒险循环/冒险结构.md`） | RngService.set_master_seed、C3/D2 |
|
||||
| **difficulty**（C3） | — | DifficultyTable 回填、全部曲线数值调参所有权、战斗期望表 | 调参输出（经 D2 解析传递，禁反向调用生成） | ConfigDB、B1 对账输出、A1 报告 |
|
||||
| **meta_progression**（C4，业务层） | `game/core/meta_progression.gd` | MetaTable、钥石账本、天赋树域、同调位槽位判定（业务规则与写口编排；数据原语归 MetaStateStore） | tree_* / forge_* / attune_* / settle_adventure / hero_override 族 | MetaStateStore、ConfigDB |
|
||||
|
||||
### 呈现层
|
||||
|
||||
| 模块 | 文件 | 独占职责 | 对外封闭面 | 消费依赖 |
|
||||
|---|---|---|---|---|
|
||||
| **D1 HUD** | `game/presentation/main.gd`（组合根）＋三屏壳＋`views/` 视图单元族＋`ui_registry.gd` | 全部 Control/CanvasLayer；输入→意图翻译（**唯一提交路径＝settle_batch，不直调 A3**）；组合根＝信号接线与核心写调用唯一出口；views/ 各域呈现拆件的职责与接口归各件头注 | 组合根公开服务面与注册面句柄寻址合同（`main.ui.<域容器>.<句柄>`）归 main.gd / ui_registry.gd 头注承载 | A2 compute_move_path；A3 只读；B1 步骤流；ConfigDB display_name；**MEDIUM**：Control/CanvasLayer/draw_*/InputEvent/RichTextLabel |
|
||||
| **组合根拆件** | `game/presentation/*_controller.gd` / `camp_shop_presenter.gd` | 代组合根执行核心写调用（冒险节点推进／营地购买与刷新／道具使用） | 各拆件写入口（仅组合根装配面可达；视图零直连） | 构造注入的核心写引用 |
|
||||
| **HudPresenter** | `game/presentation/hud_presenter.gd` | 战斗屏数据投影＋文案拼装静态族（核心状态→呈现文案的全部翻译集中于此） | refresh 全量重查装配＋只读静态投影族 | 只走 `settlement.presentation_snapshot()` 成文快照面（禁链式穿透） |
|
||||
| **board_resolvers** | `game/presentation/board_resolvers.gd` | 棋盘每格渲染数据只读解析回调四函数（与无态静态投影族职责互斥） | 构造注入产出绑定 Callable 供组合根接线 | ConfigDB / 结算活态取值 Callable |
|
||||
| **battle_presentation**（B5，垂直切片后） | — | 结算动画 / 伤害数字 / 战斗舞台 | （契约规范源：`../../gdd/systems/战斗循环/战斗表现.md`——前置「战斗表现美术测试」锁双舞台陷阱） | B1 步骤流、D1；**MEDIUM**：AnimationPlayer/Tween |
|
||||
| **audio**（D4，Alpha） | — | 音频挂点 | 挂点＝B1 明细行类型流（负反馈聚合——单结算至多一次） | B1 流水 |
|
||||
| **tutorial**（D5，Alpha） | — | 教学条目 | 口径来源＝A2/A3/B3/B1 各教学条目 | 各上游 |
|
||||
| 目录 | 层级作用 | 该层约束属性 |
|
||||
|---|---|---|
|
||||
| `game/core/` | 全部玩法逻辑的承载（配置、RNG、存档域件、棋盘生成、排雷规则、经济与账本、效果引擎、战斗编排、关卡与冒险域件）——依赖逻辑层级内分基础/核心/功能三段，见分层图 | 纯逻辑：零 Control/场景引用、构造注入、fail-fast、`--headless --script` 完整可跑、玩法数值零字面量（读 `game/data/tables`）、随机只经封闭流 |
|
||||
| `game/core/settlement/` | 领域子目录——战斗结算五段段件（领域大到内部再需要一层时切分的在案先例） | 同 core；段类可直接 new() 单测、段类对编排器零引用 |
|
||||
| `game/presentation/` | 呈现层——全部 Control/CanvasLayer、输入→意图翻译、组合根装配 | 视图零核心写调用（信号外发为主）、组合根＝核心写调用唯一出口、呈现数据只走成文快照面；引擎风险域对照 breaking-changes |
|
||||
| `game/data/` | 数据承载——玩法数值表（tables/*.tres）与字段契约（schemas/*.gd），对应基础层 D2 数据配置 | 数值单一事实源；表值直接改变游戏运行结果 |
|
||||
| `game/tests/` | 测试域——冒烟/单元/系统三闸承载 | 依赖只经 autoload 边界与场景契约两类入口；禁反向依赖呈现层实现内部 |
|
||||
| `game/probe/` | 探针域——场景级探针与取证探针 | 同测试域边界；在闸件与手动测量件两分 |
|
||||
| `game/sim/` | 测量域——MC/调参/数值验证驱动件 | 不入 CI、用户手动发起、随机显式定种 |
|
||||
|
||||
**依赖单向性**：上层可消费下层，禁止反向（C3 禁调用 A1 生成、D1 不直调 A3、A2/B3/B4 零相互直调）。全项目唯一回边＝A2 事件订阅面。
|
||||
|
||||
@@ -190,7 +143,7 @@
|
||||
1. **autoload 边界**——ConfigDB / RngService 的公开面（--script 模式不加载 autoload 且不注册全局标识符，测试文件自带显式实例化夹具）；
|
||||
2. **场景契约**——探针场景的信号外发面与视图单元接口（信号外发、setter 只读注入），禁直引呈现层实现内部。
|
||||
|
||||
测试域是所有层的消费方，进入方式限于上述两类边界；除此之外的依赖方向一律与「模块归属」节依赖单向性同规。
|
||||
测试域是所有层的消费方，进入方式限于上述两类边界；除此之外的依赖方向一律与「目录归属」节依赖单向性同规。
|
||||
|
||||
---
|
||||
|
||||
@@ -253,28 +206,6 @@ CJK 字体随包发行并设为 theme 默认字体——运行时默认字体无
|
||||
4. 续玩钮可见态恒等于断点在档态（双向）。
|
||||
5. 闲时会话已在树（`run_scope` 永非 null 契约的启动侧证明）。
|
||||
6. 调试浮窗 boot 不自动开（菜单优先）＋调试入口全局浮层角标 boot 可见。
|
||||
|
||||
---
|
||||
|
||||
## API 边界
|
||||
|
||||
> 完整 API 面（含封闭枚举负空间、布尔受理口径、输入×相位矩阵）以各 GDD AC 前言为**规范源**——本节列边界契约与不变式，实现须与 GDD 逐字一致；冲突时以 GDD 为准并走接口漂移修订。
|
||||
|
||||
| 边界 | 契约要点 | 调用方必须遵守的不变式 | 模块保证 |
|
||||
|---|---|---|---|
|
||||
| D1 → A2 | 意图经 `settle_batch(intents)` 提交；不直调 A3 | 单意图帧收集；stop 经批次委托 | 语义序仲裁 + voided 零副作用 |
|
||||
| A2 → A3 | 挖/插/拔＝先棋盘面判定后 `try_spend`；A2 不可自行扣减 | 相位判定两侧一致（同一矩阵） | 原子事务（余量+扣减+仲裁一体） |
|
||||
| A2 → 下游 | 只外发三事件，payload 字段封闭（digit 恒真透传 / reward_eligible / variant_ids） | 增删事件＝接口漂移 | 发射面封闭 + 规范序 |
|
||||
| B1 → B2/B3/B4 | 全调用面集中 B1；调用序钉死（按摇定技能行兑现→apply_damage→commit_action；先兑付后衰减；段内伤害序＝主角先手→逐敌还手→地图账殿后） | 禁第二调用方（静态扫描域 S7：API 符号命中文件 ⊆ B1 文件集） | 恰一次编排纪律（roll_board/decay/清理全序） |
|
||||
| B1 ↔ A3 | 编排期代理 `request_refresh`（玩家意图，禁 RAP 满自动刷）；回发 next_round_mode/battle_over | stopped/ap_exhausted 未刷新回发 new_board＝违约 fail-fast | 刷新受理契约（同 Waiting 多次合法） |
|
||||
| 各系统 → D2 | ConfigDB 类型化属性单点读取 | 禁绕过 ConfigDB load 表、禁缓存副本、禁玩法数值字面量、禁 randomize()/自建 RNG | 校验双通道 + fail-fast 致命 |
|
||||
| A1 → A2 | Board 产物 class_name 数据契约 | install 四不变式校验（violation＝拒绝 + 五类诊断枚举） | 生成期合法性闸（R₀≠S / clearable / min_safe） |
|
||||
| A1 ↔ B1 | attempt 边界非 scope 事件；actuals p10 为对账输入（非 target 参数） | 编排不把重试当取号 | 生成期指标集输出（实测可推理率 / 实际雷数与安全格数 / 重试次数 / 降级与非法产物标记） |
|
||||
| B4 → B3 | buff 类经 B1 调 apply_effect（B4 零跨系统读、零直接接口） | 满层拒绝＝零兑付 + 明细行（无折算） | 授予时数值快照（抗热重载） |
|
||||
| B1 → D1 | [步骤流行协议](../../gdd/systems/战斗循环/战斗结算.md#明细流水每一行都能指回你刚才的哪一步棋)（基础行型＋扩展行两层封闭 + 公共字段 type/source_class/origin_cell/round_index/display_name/value/highlight? + 特有字段 target/effect_id/pool_value） | 无来源行＝断言失败；呈现侧禁按行序重演 B2 状态机 | 可回放步骤流（同种子逐行相同） |
|
||||
|
||||
**引擎类型核验注记**：接口使用的引擎类型＝Resource / .tres（D2 全表）、RefCounted（容器类）、Signal/Callable（事件载体）、Control/CanvasLayer/Drawing（D1）、SceneTree headless 协议（测试）——均属 4.x 基线稳定面；4.7 Control 域增量已在 breaking-changes.md 登记，D1 采纳前对照核实。
|
||||
|
||||
---
|
||||
|
||||
## 架构原则
|
||||
|
||||
@@ -5160,7 +5160,7 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
|
||||
<rect data-graph-role="structural-frame" data-composition-frame-kind="region" data-composition-frame-id="1" data-composition-frame-label="浮层与对话框（组合根挂载）" x="90" y="390" width="1060" height="106" rx="12" class="c-region" stroke-width="1"/>
|
||||
|
||||
<rect data-graph-role="structural-frame" data-composition-frame-kind="region" data-composition-frame-id="2" data-composition-frame-label="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" x="66" y="524" width="1226" height="222" rx="12" class="c-region" stroke-width="1"/>
|
||||
<rect data-graph-role="structural-frame" data-composition-frame-kind="region" data-composition-frame-id="2" data-composition-frame-label="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" x="66" y="524" width="1226" height="222" rx="12" class="c-region" stroke-width="1"/>
|
||||
|
||||
<!-- Connection paths (before components for correct z-order) -->
|
||||
<path data-edge-from="main" data-edge-to="stage" data-edge-key="0" data-edge-id="main-stage" data-composition-points="566,132;566,196;125,196;125,260" d="M 566 132 L 566 188 Q 566 196 558 196 L 133 196 Q 125 196 125 204 L 125 260" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
|
||||
@@ -5390,8 +5390,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="fine" x="1044" y="468" class="t-frontend" font-size="7" text-anchor="middle">debug_overlay.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-save" data-node-id="save" data-node-label="存档管理" tabindex="0" role="button" aria-label="聚焦存档管理，save_manager.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="database" data-node-sublabel="save_manager.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>存档管理 · save_manager.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-save" data-node-id="save" data-node-label="存档管理" tabindex="0" role="button" aria-label="聚焦存档管理，save_manager.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="database" data-node-sublabel="save_manager.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>存档管理 · save_manager.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="96" y="554" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="96" y="554" width="130" height="48" rx="6" class="c-database" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="database" class="semantic-sigil s-database" transform="translate(102 560) scale(0.6875)">
|
||||
@@ -5402,8 +5402,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="161" y="592" class="t-muted" font-size="9" text-anchor="middle">save_manager.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-meta" data-node-id="meta" data-node-label="元进度" tabindex="0" role="button" aria-label="聚焦元进度，meta_progression.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="database" data-node-sublabel="meta_progression.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>元进度 · meta_progression.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-meta" data-node-id="meta" data-node-label="元进度" tabindex="0" role="button" aria-label="聚焦元进度，meta_progression.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="database" data-node-sublabel="meta_progression.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>元进度 · meta_progression.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="244" y="554" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="244" y="554" width="130" height="48" rx="6" class="c-database" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="database" class="semantic-sigil s-database" transform="translate(250 560) scale(0.6875)">
|
||||
@@ -5414,8 +5414,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="309" y="592" class="t-muted" font-size="9" text-anchor="middle">meta_progression.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-orch" data-node-id="orch" data-node-label="战斗编排器" tabindex="0" role="button" aria-label="聚焦战斗编排器，battle_orchestrator.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="battle_orchestrator.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>战斗编排器 · battle_orchestrator.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-orch" data-node-id="orch" data-node-label="战斗编排器" tabindex="0" role="button" aria-label="聚焦战斗编排器，battle_orchestrator.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="battle_orchestrator.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>战斗编排器 · battle_orchestrator.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="383" y="554" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="383" y="554" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(389 560) scale(0.6875)">
|
||||
@@ -5425,8 +5425,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="448" y="592" class="t-muted" font-size="9" text-anchor="middle">battle_orchestrator.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-rules" data-node-id="rules" data-node-label="扫雷规则" tabindex="0" role="button" aria-label="聚焦扫雷规则，minesweeper_rules.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="minesweeper_rules.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>扫雷规则 · minesweeper_rules.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-rules" data-node-id="rules" data-node-label="扫雷规则" tabindex="0" role="button" aria-label="聚焦扫雷规则，minesweeper_rules.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="minesweeper_rules.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>扫雷规则 · minesweeper_rules.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="540" y="554" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="540" y="554" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(546 560) scale(0.6875)">
|
||||
@@ -5436,8 +5436,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="605" y="592" class="t-muted" font-size="9" text-anchor="middle">minesweeper_rules.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-boardgen" data-node-id="boardgen" data-node-label="棋盘生成" tabindex="0" role="button" aria-label="聚焦棋盘生成，board_generator.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="board_generator.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>棋盘生成 · board_generator.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-boardgen" data-node-id="boardgen" data-node-label="棋盘生成" tabindex="0" role="button" aria-label="聚焦棋盘生成，board_generator.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="board_generator.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>棋盘生成 · board_generator.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="688" y="554" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="688" y="554" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(694 560) scale(0.6875)">
|
||||
@@ -5447,8 +5447,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="753" y="592" class="t-muted" font-size="9" text-anchor="middle">board_generator.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-boarddata" data-node-id="boarddata" data-node-label="棋盘数据" tabindex="0" role="button" aria-label="聚焦棋盘数据，board_data.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="database" data-node-sublabel="board_data.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>棋盘数据 · board_data.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-boarddata" data-node-id="boarddata" data-node-label="棋盘数据" tabindex="0" role="button" aria-label="聚焦棋盘数据，board_data.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="database" data-node-sublabel="board_data.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>棋盘数据 · board_data.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="836" y="554" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="836" y="554" width="130" height="48" rx="6" class="c-database" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="database" class="semantic-sigil s-database" transform="translate(842 560) scale(0.6875)">
|
||||
@@ -5459,8 +5459,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="901" y="592" class="t-muted" font-size="9" text-anchor="middle">board_data.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-effects" data-node-id="effects" data-node-label="效果引擎" tabindex="0" role="button" aria-label="聚焦效果引擎，effect_engine.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="effect_engine.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>效果引擎 · effect_engine.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-effects" data-node-id="effects" data-node-label="效果引擎" tabindex="0" role="button" aria-label="聚焦效果引擎，effect_engine.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="effect_engine.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>效果引擎 · effect_engine.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="984" y="554" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="984" y="554" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(990 560) scale(0.6875)">
|
||||
@@ -5470,8 +5470,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="1049" y="592" class="t-muted" font-size="9" text-anchor="middle">effect_engine.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-adventure" data-node-id="adventure" data-node-label="冒险运行器" tabindex="0" role="button" aria-label="聚焦冒险运行器，adventure_runner.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="adventure_runner.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>冒险运行器 · adventure_runner.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-adventure" data-node-id="adventure" data-node-label="冒险运行器" tabindex="0" role="button" aria-label="聚焦冒险运行器，adventure_runner.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="adventure_runner.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>冒险运行器 · adventure_runner.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="1132" y="554" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="1132" y="554" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(1138 560) scale(0.6875)">
|
||||
@@ -5481,8 +5481,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="1197" y="592" class="t-muted" font-size="9" text-anchor="middle">adventure_runner.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-levelrun" data-node-id="levelrun" data-node-label="关卡运行器" tabindex="0" role="button" aria-label="聚焦关卡运行器，level_runner.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="level_runner.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>关卡运行器 · level_runner.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-levelrun" data-node-id="levelrun" data-node-label="关卡运行器" tabindex="0" role="button" aria-label="聚焦关卡运行器，level_runner.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="level_runner.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>关卡运行器 · level_runner.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="96" y="616" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="96" y="616" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(102 622) scale(0.6875)">
|
||||
@@ -5492,8 +5492,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="161" y="654" class="t-muted" font-size="9" text-anchor="middle">level_runner.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-dmgctl" data-node-id="dmgctl" data-node-label="伤害控制" tabindex="0" role="button" aria-label="聚焦伤害控制，damage_controller.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="damage_controller.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>伤害控制 · damage_controller.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-dmgctl" data-node-id="dmgctl" data-node-label="伤害控制" tabindex="0" role="button" aria-label="聚焦伤害控制，damage_controller.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="damage_controller.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>伤害控制 · damage_controller.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="244" y="616" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="244" y="616" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(250 622) scale(0.6875)">
|
||||
@@ -5503,8 +5503,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="309" y="654" class="t-muted" font-size="9" text-anchor="middle">damage_controller.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-dgmath" data-node-id="dgmath" data-node-label="伤害公式" tabindex="0" role="button" aria-label="聚焦伤害公式，damage_math.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="damage_math.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>伤害公式 · damage_math.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-dgmath" data-node-id="dgmath" data-node-label="伤害公式" tabindex="0" role="button" aria-label="聚焦伤害公式，damage_math.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="damage_math.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>伤害公式 · damage_math.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="392" y="616" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="392" y="616" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(398 622) scale(0.6875)">
|
||||
@@ -5514,8 +5514,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="457" y="654" class="t-muted" font-size="9" text-anchor="middle">damage_math.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-reward" data-node-id="reward" data-node-label="奖励经济" tabindex="0" role="button" aria-label="聚焦奖励经济，reward_economy.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="reward_economy.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>奖励经济 · reward_economy.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-reward" data-node-id="reward" data-node-label="奖励经济" tabindex="0" role="button" aria-label="聚焦奖励经济，reward_economy.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="reward_economy.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>奖励经济 · reward_economy.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="540" y="616" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="540" y="616" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(546 622) scale(0.6875)">
|
||||
@@ -5525,8 +5525,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="605" y="654" class="t-muted" font-size="9" text-anchor="middle">reward_economy.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-lottery" data-node-id="lottery" data-node-label="技能抽奖" tabindex="0" role="button" aria-label="聚焦技能抽奖，skill_lottery.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="skill_lottery.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>技能抽奖 · skill_lottery.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-lottery" data-node-id="lottery" data-node-label="技能抽奖" tabindex="0" role="button" aria-label="聚焦技能抽奖，skill_lottery.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="skill_lottery.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>技能抽奖 · skill_lottery.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="688" y="616" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="688" y="616" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(694 622) scale(0.6875)">
|
||||
@@ -5536,8 +5536,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="753" y="654" class="t-muted" font-size="9" text-anchor="middle">skill_lottery.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-attune" data-node-id="attune" data-node-label="同调" tabindex="0" role="button" aria-label="聚焦同调，attunement.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="attunement.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>同调 · attunement.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-attune" data-node-id="attune" data-node-label="同调" tabindex="0" role="button" aria-label="聚焦同调，attunement.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="attunement.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>同调 · attunement.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="836" y="616" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="836" y="616" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(842 622) scale(0.6875)">
|
||||
@@ -5547,8 +5547,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="901" y="654" class="t-muted" font-size="9" text-anchor="middle">attunement.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-action" data-node-id="action" data-node-label="行动经济" tabindex="0" role="button" aria-label="聚焦行动经济，action_economy.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="action_economy.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>行动经济 · action_economy.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-action" data-node-id="action" data-node-label="行动经济" tabindex="0" role="button" aria-label="聚焦行动经济，action_economy.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="action_economy.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>行动经济 · action_economy.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="984" y="616" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="984" y="616" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(990 622) scale(0.6875)">
|
||||
@@ -5558,8 +5558,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="1049" y="654" class="t-muted" font-size="9" text-anchor="middle">action_economy.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-feats" data-node-id="feats" data-node-label="特长引擎" tabindex="0" role="button" aria-label="聚焦特长引擎，feats_engine.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="feats_engine.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>特长引擎 · feats_engine.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-feats" data-node-id="feats" data-node-label="特长引擎" tabindex="0" role="button" aria-label="聚焦特长引擎，feats_engine.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="feats_engine.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>特长引擎 · feats_engine.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="1132" y="616" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="1132" y="616" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(1138 622) scale(0.6875)">
|
||||
@@ -5569,8 +5569,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="1197" y="654" class="t-muted" font-size="9" text-anchor="middle">feats_engine.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-status" data-node-id="status" data-node-label="状态容器" tabindex="0" role="button" aria-label="聚焦状态容器，status_container.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="status_container.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>状态容器 · status_container.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-status" data-node-id="status" data-node-label="状态容器" tabindex="0" role="button" aria-label="聚焦状态容器，status_container.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="status_container.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>状态容器 · status_container.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="96" y="678" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="96" y="678" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(102 684) scale(0.6875)">
|
||||
@@ -5580,8 +5580,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="161" y="716" class="t-muted" font-size="9" text-anchor="middle">status_container.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-units" data-node-id="units" data-node-label="单位容器" tabindex="0" role="button" aria-label="聚焦单位容器，unit_container.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="unit_container.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>单位容器 · unit_container.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-units" data-node-id="units" data-node-label="单位容器" tabindex="0" role="button" aria-label="聚焦单位容器，unit_container.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="unit_container.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>单位容器 · unit_container.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="244" y="678" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="244" y="678" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(250 684) scale(0.6875)">
|
||||
@@ -5591,8 +5591,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="309" y="716" class="t-muted" font-size="9" text-anchor="middle">unit_container.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-treasure" data-node-id="treasure" data-node-label="秘宝数据" tabindex="0" role="button" aria-label="聚焦秘宝数据，treasure_items.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="database" data-node-sublabel="treasure_items.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>秘宝数据 · treasure_items.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-treasure" data-node-id="treasure" data-node-label="秘宝数据" tabindex="0" role="button" aria-label="聚焦秘宝数据，treasure_items.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="database" data-node-sublabel="treasure_items.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>秘宝数据 · treasure_items.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="392" y="678" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="392" y="678" width="130" height="48" rx="6" class="c-database" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="database" class="semantic-sigil s-database" transform="translate(398 684) scale(0.6875)">
|
||||
@@ -5603,8 +5603,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="457" y="716" class="t-muted" font-size="9" text-anchor="middle">treasure_items.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-resolver" data-node-id="resolver" data-node-label="配置解析" tabindex="0" role="button" aria-label="聚焦配置解析，config_db_resolver.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="config_db_resolver.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>配置解析 · config_db_resolver.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-resolver" data-node-id="resolver" data-node-label="配置解析" tabindex="0" role="button" aria-label="聚焦配置解析，config_db_resolver.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="config_db_resolver.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>配置解析 · config_db_resolver.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="540" y="678" width="130" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="540" y="678" width="130" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(546 684) scale(0.6875)">
|
||||
@@ -5614,8 +5614,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-detail="context" x="605" y="716" class="t-muted" font-size="9" text-anchor="middle">config_db_resolver.gd</text>
|
||||
</g>
|
||||
|
||||
<g id="node-xvalid" data-node-id="xvalid" data-node-label="配置交叉校验" tabindex="0" role="button" aria-label="聚焦配置交叉校验，config_db_cross_validator.gd, 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="config_db_cross_validator.gd" data-node-context="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<title>配置交叉校验 · config_db_cross_validator.gd · 逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</title>
|
||||
<g id="node-xvalid" data-node-id="xvalid" data-node-label="配置交叉校验" tabindex="0" role="button" aria-label="聚焦配置交叉校验，config_db_cross_validator.gd, 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）" aria-pressed="false" data-node-kind="backend" data-node-sublabel="config_db_cross_validator.gd" data-node-context="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<title>配置交叉校验 · config_db_cross_validator.gd · 逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</title>
|
||||
<rect x="688" y="678" width="170" height="48" rx="6" class="c-mask"/>
|
||||
<rect x="688" y="678" width="170" height="48" rx="6" class="c-backend" stroke-width="1.5"/>
|
||||
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(694 684) scale(0.6875)">
|
||||
@@ -5660,9 +5660,9 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<text data-boundary-label="" x="98" y="413" class="t-cloud" font-size="9" font-weight="600">浮层与对话框（组合根挂载）</text>
|
||||
</g>
|
||||
|
||||
<g data-graph-role="structural-frame-label" data-composition-frame-id="2" data-composition-frame-kind="region" data-composition-frame-label="逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）">
|
||||
<rect data-graph-role="structural-frame-label-mask" x="70" y="534" width="339.4" height="16" rx="3" class="c-mask"/>
|
||||
<text data-boundary-label="" x="74" y="547" class="t-cloud" font-size="9" font-weight="600">逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）</text>
|
||||
<g data-graph-role="structural-frame-label" data-composition-frame-id="2" data-composition-frame-kind="region" data-composition-frame-label="逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）">
|
||||
<rect data-graph-role="structural-frame-label-mask" x="70" y="534" width="328.59999999999997" height="16" rx="3" class="c-mask"/>
|
||||
<text data-boundary-label="" x="74" y="547" class="t-cloud" font-size="9" font-weight="600">逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）</text>
|
||||
</g>
|
||||
|
||||
<!-- Legend -->
|
||||
@@ -5883,7 +5883,7 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
|
||||
<h3>逻辑层与边界</h3>
|
||||
</div>
|
||||
<ul>
|
||||
<li>• core/ 模块与拆件全量清单以 architecture.md「模块归属」表为准，本图只画顶层导航件</li>
|
||||
<li>• core/ 全量清单以 architecture.md「目录归属」表与各文件头注为准，本图只画顶层导航件</li>
|
||||
<li>• ConfigDB/RngService 两单例经 project.godot autoload 全局供给</li>
|
||||
<li>• smoke/ 下 13 个测试探针场景属测试基建，不入架构主干</li>
|
||||
</ul>
|
||||
|
||||
@@ -556,7 +556,7 @@
|
||||
},
|
||||
{
|
||||
"kind": "region",
|
||||
"label": "逻辑层 core/（模块与拆件清单＝architecture.md「模块归属」表）",
|
||||
"label": "逻辑层 core/（目录层级约束＝architecture.md「目录归属」表）",
|
||||
"wraps": [
|
||||
"save",
|
||||
"meta",
|
||||
@@ -689,7 +689,7 @@
|
||||
"dot": "rose",
|
||||
"title": "逻辑层与边界",
|
||||
"items": [
|
||||
"core/ 模块与拆件全量清单以 architecture.md「模块归属」表为准，本图只画顶层导航件",
|
||||
"core/ 全量清单以 architecture.md「目录归属」表与各文件头注为准，本图只画顶层导航件",
|
||||
"ConfigDB/RngService 两单例经 project.godot autoload 全局供给",
|
||||
"smoke/ 下 13 个测试探针场景属测试基建，不入架构主干"
|
||||
]
|
||||
|
||||
@@ -18,7 +18,7 @@
|
||||
设计稿与实现同尺度：功能 = 类（状态 + 行为 + 信号），类是封装的最小交付单位。工具性纯函数只允许挂在明确的宿主类下（静态装配器/工厂），不允许无主散落。
|
||||
|
||||
### 1.3 依赖单向，核心写调用完成
|
||||
依赖方向唯一：`views →（信号）→ 组合根 →（写调用）→ core`。视图零核心写调用（纯 setter / 信号外发优先）；"读核心状态 → 拼展示文案"集中于装配器（presenter）；核心写接口（settle_batch / player_request_refresh / runner 推进）只允许在组合根出现——组合根＝main.gd＋其构造注入的组合根拆件（成员与边界见架构文档「模块归属·呈现层」），视图不得直连拆件。
|
||||
依赖方向唯一：`views →（信号）→ 组合根 →（写调用）→ core`。视图零核心写调用（纯 setter / 信号外发优先）；"读核心状态 → 拼展示文案"集中于装配器（presenter）；核心写接口（settle_batch / player_request_refresh / runner 推进）只允许在组合根出现——组合根＝main.gd＋其构造注入的组合根拆件（成员与边界见各件文件头注），视图不得直连拆件。
|
||||
|
||||
### 1.4 命名 = 领域命名，禁止系统 ID 前缀
|
||||
文件名与类名禁止 `a1_`/`b1_`/`c1_` 等系统 ID 前缀（`a1_board_generator.gd` → `board_generator.gd`）。设计追溯不靠前缀：代码↔设计的追溯由 GDD 文档承担，系统 ID 只作为文档的追溯锚；文件头注不承担追溯职责，不写任何文档链接（§1.4.1）。豁免：D2 schema 类与 autoload；文档/夹具登记名（如 b4_golden）属文档层。
|
||||
|
||||
@@ -63,7 +63,7 @@
|
||||
| 规则 | 内容 |
|
||||
|---|---|
|
||||
| 树形文档体系 | 全部设计文档构成一棵树；文档增删必须同步根索引 `design/gdd/02-系统清单.md` |
|
||||
| 架构事实唯一源 | `design/engineering/architecture/architecture.md` 是架构事实的唯一权威（分层/模块归属/数据流/API 边界——只写约束面：难以改变的分层、依赖规则、边界契约与关键决策；实现现状归代码与代码头注，实现历史归 git commit log）；禁建第二份架构文档；**架构文档写权限＝用户专属**（2026-11-07 用户裁：agent 与技能只读，修订须用户发起） |
|
||||
| 架构事实唯一源 | `design/engineering/architecture/architecture.md` 是架构事实的唯一权威（分层/目录归属/数据流/架构原则——只写依赖规则面：难以改变的分层、目录层级约束、依赖方向与数据流；模块级归属归代码头注，接口契约规范源＝各系统 GDD，实现历史归 git commit log）；禁建第二份架构文档；**架构文档写权限＝用户专属**（2026-11-07 用户裁：agent 与技能只读，修订须用户发起） |
|
||||
| 一页纸节点 | 一节、一条规则 ≤一页纸（约 ≤80 行）；装不下就拆节 |
|
||||
| 一系统一文档 | 不建 analysis 推演件；两三句能说清的"为什么"直接写进设计目的或规则正文 |
|
||||
| 正文只写现行规则 | 禁删除线、"（作废）"、"（日期+拍板）"式注记；审计信息入对应文档附录 |
|
||||
|
||||
@@ -117,7 +117,7 @@
|
||||
|
||||
**判据出处行锚（2026-11-05 立，自 2026-11-05 起对文件名日期不早于该日的需求卡片生效；旧卡不回头改，被编入迭代开工前由写卡段按本粒度补挂）**：对照表「需求点」列每行必须带**判据出处行锚**——该行验收判据所依据的现行文档句子，格式「`<文档相对路径>:<行号>`」。现行文档＝`design/` 全域现行文档（含 `ux/` 交互规格与 art-bible 的判据行）；已退役的需求卡片不是现行文档，不得充当判据出处。作用＝断言预期值从规格句抄出，不从实现反推：实现行为与规格句冲突时断言红；规格缺席的行写不出锚，即停卡退回写卡段（那是需求澄清缺口，不是测试缺口）。机检＝`tools/pipeline_gate.py` 判据 C5（锚格式与指向存在性，按卡文件名日期分流）＋`tools/capability_audit.py` 链式锚检查（断言→套件→能力行→系统文档，见 §8.9）。
|
||||
|
||||
**测试函数的判据出处注记（2026-11-06 立）**：`game/tests/**` 与 `game/probe/**` 内每个**验证函数**（函数体含 `check(`／`check_quiet(`／`_problems.append(`／`push_error(` 判定调用的函数——定义行与 `_check(` 前缀不作判定计）必须带至少一条**判据出处注记**，格式「`# 判据出处: <design/相对路径>:<行号> <判据一句>`」——指针在前、判据摘要句在后；锚形态两档：行号锚（默认）与节锚（`<design/相对路径>「节名」<行关键词>`）——所指文档整节重排时同批把行号锚重锚为节锚，免行号漂移（2026-11-07 架构收窄批立），断言预期值的出处随断言走：断言红时读注记即达出处文档句，零查表。指针空间＝`design/` 全域现行文档（行为测试锚 owner 系统文档「验收标准」句或 `ux/` 规格句；惯例类测试〔封装扫描、判定通道纪律、驱动契约〕锚规约条款行）；`game/sim/` 不进扫描面（测量面直构惯例）。与链式锚的分工：链式锚（断言→套件→能力行→系统文档）不变、属义务清单层；本注记属执行证据层、写在断言文件内，非独立账本（§8.9 法则 4 不变）。写新测试函数时当场挂注记；被指规格句改行号时随批维护指针——死指针即红。局限如实声明：注记是被动文本，句内容改而行数不变时机检抓不到（与卡片判据 C5 同限）。机检＝`tools/capability_audit.py` 判据出处注记道（覆盖检查＋指针存在性；扫描面零文件自检红）。规格缺席写不出锚＝发现规格缺口：记发现不造锚、收尾呈报，禁锚到非现行文档凑数。
|
||||
**测试函数的判据出处注记（2026-11-06 立）**：`game/tests/**` 与 `game/probe/**` 内每个**验证函数**（函数体含 `check(`／`check_quiet(`／`_problems.append(`／`push_error(` 判定调用的函数——定义行与 `_check(` 前缀不作判定计）必须带至少一条**判据出处注记**，格式「`# 判据出处: <design/相对路径>:<行号> <判据一句>`」——指针在前、判据摘要句在后；锚形态两档：行号锚（默认）与节锚（`<design/相对路径>「节名」<行关键词>`）——所指文档整节重排时同批把行号锚重锚为节锚，免行号漂移（2026-11-07 架构收窄批立），断言预期值的出处随断言走：断言红时读注记即达出处文档句，零查表。指针空间＝`design/` 全域现行文档（行为测试锚 owner 系统文档「验收标准」句或 `ux/` 规格句；惯例类测试〔封装扫描、判定通道纪律、驱动契约〕锚规约条款行；测量面驱动契约锚 `game/sim/` 实现件文件头注——规范句在哪锚哪，2026-11-09 架构收敛批立）；`game/sim/` 不进扫描面（测量面直构惯例）。与链式锚的分工：链式锚（断言→套件→能力行→系统文档）不变、属义务清单层；本注记属执行证据层、写在断言文件内，非独立账本（§8.9 法则 4 不变）。写新测试函数时当场挂注记；被指规格句改行号时随批维护指针——死指针即红。局限如实声明：注记是被动文本，句内容改而行数不变时机检抓不到（与卡片判据 C5 同限）。机检＝`tools/capability_audit.py` 判据出处注记道（覆盖检查＋指针存在性；扫描面零文件自检红）。规格缺席写不出锚＝发现规格缺口：记发现不造锚、收尾呈报，禁锚到非现行文档凑数。
|
||||
|
||||
**验收档申报（2026-11-04 立，自 2026-11-05 起对文件名日期不早于该日的需求卡片生效；旧卡不回头改）**：每张需求卡片在头部信息区（与设计事实源声明同区）申报一个验收档，三档：高／中／低。判据＝失败代价单维——这条改动做错了，后果随存档或结算传播的（存档写读与迁移、RNG 流、战斗结算公式与乘区、经济入账、数值表结构校验）＝高；后果玩家可见但不损持久状态的（常规玩法逻辑、门控、交互逻辑、呈现数据面）＝中；后果即看即知且无状态残留的（文案、纯呈现样式、布局微调）＝低。一张卡触多档按最高档申报；申报由写卡段落笔，用户批卡（U0）时确认或改判。档位只调节 §8.7 审计深度——闸机与 CI 的域划分、选闸算法、全量强制档一概不因档位变化，真实入口、判据绑定面、禁削弱等验收闭合判据全部照旧。未申报档位的卡一律按高档全量审计。机检＝`tools/pipeline_gate.py` 判据 C4：卡内须含「验收档：高／中／低」申报行。
|
||||
|
||||
|
||||
@@ -184,7 +184,7 @@ GP（显示名「GP」）是冒险内的一次性属性提升货币：战斗胜
|
||||
|
||||
主动放弃按与失败同型结算：已兑付的三选一件与回血不追回、已到手的保留，摘要标记未打穿。放弃请求只在非战斗期受理，战斗进行中一律拒绝（战斗域单事务执行期间）。放弃的界面入口挂在[关卡节点地图](关卡节点地图.md)的选路覆盖层上——选路停点天然是非战斗期，按钮只在冒险模式开放（选路覆盖层只在冒险模式出现）；战斗进行中没有选路停点，入口因此天然不可达，拒绝分支仅作防御兜底。
|
||||
|
||||
主种子（本文含义：冒险开始时注入的一个随机种子，本局全部随机性都派生自它）在冒险开始时注入恰一次。冒险内的雷图生成、奖励抽取、遭遇掷骰与 GP 掉落掷定（消费 gp_drop 封闭流）全部派生自它，冒险内不重置、不逐关播种。冒险的可复现域 = 主种子 + 全局取数计数器（统一随机流口径，语义权威归[数据配置](../表现与支撑/数据配置.md)），供复盘与快照（见[存档序列化](../表现与支撑/存档序列化.md)）。重开抽到的种子与上一局相同是允许的（随机源范围小，撞种子不算错误），但生成新种子禁止复用玩法里的随机数。
|
||||
主种子（本文含义：冒险开始时注入的一个随机种子，本局全部随机性都派生自它）在冒险开始时注入恰一次。冒险内的雷图生成、奖励抽取、遭遇掷骰与 GP 掉落掷定（消费 gp_drop 封闭流）全部派生自它，冒险内不重置、不逐关播种。冒险的可复现域 = 主种子 + 全局取数计数器（统一随机流口径，语义权威归[数据配置](../表现与支撑/数据配置.md)），供复盘与快照（见[存档序列化](../表现与支撑/存档序列化.md)）。重开抽到的种子与上一局相同是允许的（随机源范围小，撞种子不算错误），但生成新种子禁止复用玩法里的随机数。调试种子入口的三分判定：显式输入的合法整数优先；首局（无存档在档）空框恒用固定教学种子；非首局空框用引擎熵随机生成（不进玩法封闭流）。
|
||||
|
||||
### 冒险断点：中断可续玩的停点快照
|
||||
|
||||
@@ -193,7 +193,7 @@ GP（显示名「GP」）是冒险内的一次性属性提升货币：战斗胜
|
||||
- **停点粒度**：快照只挂选路停点（入口呈现/战斗胜利后/兑付确认后的选路态）——这是唯一可恢复停点形态。战斗进行中不写快照：中断恢复后**当场战斗从头打**，棋盘中局不入档。
|
||||
- **七字段拍板面**：关卡序号 / 节点位 / 生命 / 本关加成区 / GP 钱包 / 商店已购档 / 已抽模板。附随件（续玩正确性必需）：主种子 + 取数计数器（rng 快照契约回填——续玩从断点号位精确续接原随机时间线，已抽模板零重抽）、钥石累计（Boss 掉落逐杀入账的中途值，终局摘要不失真）、已到节点序（关卡画面图条重建）、秘宝库存（奖励节点已选件防静默丢失）、**奖励选择态**（三选一停点中断：已选件 / 同调位替换在途——续玩已选不丢失；候选一致性=快照现状非强求 feature，2026-10-01 用户裁决）、**件获取次数计数**（kind 维度派生账本——断点附随件与读数承载）、**令牌池余库**（bonus_deck 逐枚还原——TP0 扩列，池消耗即上限的续玩正确性承载；旧版断点缺键=满库重建防御口径，单版本周期）、**商店货架态**（当前货架三件 + 本次进店已购次数；离开店=空架合法态，货架续玩由确定性重放承载：重进店同种子同货架逐位）、**Y 刷新池余量**（attune_refresh_y——冒险周期池消耗余量随断点：续玩优先读断点、不自参数面整额重注入，堵「用完 Y 退菜单再续玩满血复活」可利用漏洞；旧断点缺键回退参数面=旧档行为零变化）。
|
||||
- **中断与退出两口径分离**（2026-09-29 用户裁决）：中断（关游戏）= 留断点可续；**退出冒险**（放弃流程）= 失败同型结算 + **清除断点**——退出后「继续上局」不再出现。
|
||||
- **获得日记键**（gain_journal，断点 28 键）：获得记录明细（三层结构归架构文档「模块归属·核心层」GainJournal 行——本域只登记断点面口径）随断点保存，回退策略 plain；旧档回退两态——旧断点缺日记键＝汇总键直载并跳过比对（零迁移损失），日记在档＝由日记推导汇总值与留存值比对，不符即报错中止（迁移正确性自检）。
|
||||
- **获得日记键**（gain_journal，断点 28 键）：获得记录明细（三层结构归实现类头注——本域只登记断点面口径）随断点保存，回退策略 plain；旧档回退两态——旧断点缺日记键＝汇总键直载并跳过比对（零迁移损失），日记在档＝由日记推导汇总值与留存值比对，不符即报错中止（迁移正确性自检）。
|
||||
- **续玩**：自断点重建到最近停点（逐字段回填 + 随机流回填），停点处玩家重新选路。三结局（冒险成功/失败/放弃）一律清断点——断点只活在一个进行中的冒险上。
|
||||
- 与测量面的关系：断点面只在注入存档承载的正式冒险路径生效；模拟/冒烟不注入 = 整面静默，MC 逐项比对零扰动。
|
||||
|
||||
|
||||
@@ -100,7 +100,9 @@
|
||||
|
||||
基础 9 类写的是裸机制的账：玩家没有任何专长时，结算流水的每一行都出得了这九类。有了专长之后，效果引擎会在段内挂点插入额外的结算效果，这类效果写**扩展行**。扩展行是**一个**行型，不是每种专长效果各占一个行型——具体插的是哪种效果，由行携带的效果身份（effect_id 载荷）说明，呈现层按身份取各自的行文案。专长会不断增加、效果种类不可穷举，行型词表因此对扩展类封口：新增专长效果只新增载荷身份，不再新增行型。
|
||||
|
||||
扩展行与基础行共用同一套行协议：公共字段、来源归因、两层豁免、无来源即炸，全部照常生效。发射时点由段序骨架的挂点决定（时序与挂点施加面、效果身份清单与各发射点归代码文件头注承载——模块归属见架构文档「模块归属·功能层」battle_orchestrator 行），本节只管这行是什么、带什么字段。扩展行携带效果身份（effect_id 载荷）。
|
||||
扩展行与基础行共用同一套行协议：公共字段、来源归因、两层豁免、无来源即炸，全部照常生效。发射时点由段序骨架的挂点决定（时序与挂点施加面、效果身份清单与各发射点归代码文件头注承载），本节只管这行是什么、带什么字段。扩展行携带效果身份（effect_id 载荷）。
|
||||
|
||||
效果引擎的装载与订阅面（表装载、rebuild、树规则挂接）与端口装配明细归实现件文件头注承载。两业务类（伤害管线／行动经济）持同一个效果端口件实例，命中批经端口路由全处理。伤害域传给效果引擎的事实面为封闭集合：载荷携带的事实键可达、宿主链事实不外溢——事实面增删走实现件修订，禁静默扩面。
|
||||
|
||||
举证：本节为行协议约定，无计算。
|
||||
|
||||
|
||||
@@ -232,6 +232,7 @@
|
||||
- 清图口径：清图 = 全部安全格完成——挖开或封印都算完成；封到安全格计入清图进度，封印可以完成清图。
|
||||
- 已引爆危险格可通行：挖雷后轮次不结束，小人可站、可经已开区穿行续挖；危险格不计清图、不可再挖再封印。
|
||||
- 移动合法且预览同源：目标未开或无已开区连通路径时拒绝；路径预览与实际执行逐格相同；移动免费、零事件。
|
||||
- 揭示预览口：预览口按实挖同口径返回揭示闭包——零状态写入、零事件外发、封印格不外扩（只读查询面，供测量与呈现旁路取数）。
|
||||
- 批次仲裁与到达序无关：同一批意图按任意顺序提交，结束路径与结算结果一致；赢家定出后其余意图丢弃——零棋盘效果、零扣费、零事件，且丢弃区别于拒绝。
|
||||
- 收轮事件序：先报完全部封印判定，再报轮次结束；轮次结束每轮恰一条，停手路径由行动经济直发、本系统不双发。
|
||||
- 拒绝三源可辨：棋盘面非法、资源不足、相位不对三类原因互异可判定；任何拒绝零副作用。
|
||||
|
||||
@@ -56,7 +56,7 @@
|
||||
|
||||
第二条边界是反面清单：局内资源不入存档。行动点、储备行动点、道具库存、生命、GP 全部单局清零——各归各的系统管，没有局内数值需要持久化。若未来某局内资源要开放跨局携带（如储备行动点跨战斗携带），须修订其池规则并向本系统登记持久化归属，禁止静默超域。
|
||||
|
||||
**唯一豁免 = `breakpoint` 断点域**：断点是冒险进行中的瞬态快照，不是跨局携带——里面的生命/GP/道具库存只在「续玩上局」时还原进局内，冒险收束（冒险成功/失败/放弃）即整域清除，永远不会渗进永久进度。反面清单的管辖对象因此收窄为 `meta` 永久进度域（冒烟域界扫描收窄到 meta 域）；断点域自身的字段口径归[冒险结构](../冒险循环/冒险结构.md)登记。断点顶层键（28 键）的登记单源＝冒险应用层的断点键表（键→回退策略；现行契约见架构文档「模块归属·核心层」breakpoint_store 行）；写读已换代为各件自交片段——主角账/停点件/关卡件各自写读自己的键（缺键回退策略随领域知识归各件），冒险应用层是唯一拼盘落盘口（收齐各件片段拼成顶层快照后写盘，写触发点不变）。**关卡完成停点的同调未用行留存**：`aux_items` 键在此停点形态含同调未用行（「同调行始终留在 treasure_inventory」与「键值形态逐位不变」在关卡完成停点互斥，采行留存；玩家可见 C 区投影零变化，24 停点充能读数逐位一致）。
|
||||
**唯一豁免 = `breakpoint` 断点域**：断点是冒险进行中的瞬态快照，不是跨局携带——里面的生命/GP/道具库存只在「续玩上局」时还原进局内，冒险收束（冒险成功/失败/放弃）即整域清除，永远不会渗进永久进度。反面清单的管辖对象因此收窄为 `meta` 永久进度域（冒烟域界扫描收窄到 meta 域）；断点域自身的字段口径归[冒险结构](../冒险循环/冒险结构.md)登记。断点顶层键（28 键）的登记单源＝冒险应用层的断点键表（键→回退策略，键表本体＝承载件的常量登记）；写读已换代为各件自交片段——主角账/停点件/关卡件各自写读自己的键（缺键回退策略随领域知识归各件），冒险应用层是唯一拼盘落盘口（收齐各件片段拼成顶层快照后写盘，写触发点不变）。**关卡完成停点的同调未用行留存**：`aux_items` 键在此停点形态含同调未用行（「同调行始终留在 treasure_inventory」与「键值形态逐位不变」在关卡完成停点互斥，采行留存；玩家可见 C 区投影零变化，24 停点充能读数逐位一致）。
|
||||
|
||||
**三存档位**：存档是 3 个独立的 JSON 文件（三个独立存档文件，槽文件名只经存档系统单点派生，槽 1 禁复用旧单档名），字典键一律字符串。写盘目标=当前激活槽的文件；启动（boot）不读任何槽文件——启动态=无激活态，不读写；激活态由选档界面的「新档」或「进档」建立。数据模型（现行 = v7；示例值全为零值默认态）：
|
||||
|
||||
|
||||
+1
-1
@@ -94,7 +94,7 @@
|
||||
|
||||
| 术语 | 定义 |
|
||||
|---|---|
|
||||
| 效果端口件 | 战斗业务类（伤害管线／行动经济）唯一的效果发射出口：收事件与载荷、交效果引擎结算、取回命中批——业务类零引擎直连（机制归属见架构文档「模块归属·功能层」battle_orchestrator 行；实现类 EffectPort） |
|
||||
| 效果端口件 | 战斗业务类（伤害管线／行动经济）唯一的效果发射出口：收事件与载荷、交效果引擎结算、取回命中批——业务类零引擎直连（机制归属见实现类 EffectPort 文件头注） |
|
||||
| 掷格件 | 装配期格面资源摇号的承载件：池行装配、区间行 roll、权重合成（订阅加权/board_skew 两路投影）；受理账面留守地图战斗资源件（机制归属同上；实现类 RewardRoller） |
|
||||
| `seal_missed` | 封印落空事件（旧名已换代）：封印动作落在安全格上时发出，订阅面据此做限次与豁免判定 |
|
||||
| `forgive_seal_miss` | 本场首次封印落空豁免——专长「完美保险」的效果类型，`domain=battle` 首例；有效误标＝误标总数 − 豁免数，豁免不改写误标账 |
|
||||
|
||||
@@ -743,7 +743,7 @@ func _in_scroll(c: Control) -> bool:
|
||||
|
||||
|
||||
func _audit(screen: String, roots: Array) -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·呈现层」D1 行(组合根交接面) 组合根交接面与呈现装配——屏结构审计宿主面（结构审计组）
|
||||
# 判据出处: design/engineering/architecture/architecture.md「三屏壳与组合根」(组合根交接面) 组合根交接面与呈现装配——屏结构审计宿主面（结构审计组）
|
||||
for r in roots:
|
||||
if r != null and is_instance_valid(r):
|
||||
_force_layout(r)
|
||||
|
||||
@@ -199,7 +199,7 @@ func _ready() -> void:
|
||||
_overlay_zero_motion_contract(main, problems)
|
||||
# ⑩ 种子三分单点断言（18卡⑦ C1——判定只落 _seed_value() 单点；对局态不影响本判定面）：
|
||||
# 显式合法整数全场景优先（含首局）→ 首局（存档布尔 false）恒 42 → 非首局空框引擎熵连抽不全等 42
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·呈现层」D1 行(组合根交接面) seed_value＝组合根公开服务面（⑩种子三分判定单点组）
|
||||
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md「主种子」(组合根交接面) seed_value＝组合根公开服务面（⑩种子三分判定单点组）
|
||||
main.ui.modals.menu.debug_overlay.seed_edit.text = "777"
|
||||
if main.seed_value() != 777:
|
||||
problems.append("显式种子输入未优先（_seed_value != 777——C1 ①失守）")
|
||||
|
||||
@@ -46,7 +46,7 @@ tests/
|
||||
>
|
||||
> **维护规则（写卡段维护，实现批禁写本表）**：写需求卡片时当场入表——本批新增能力当场增行（真实入口取自设计文档已定的入口；代表用例＝卡内定死的计划测试 `文件:函数`，实现照单落名，名实不符＝卡片没写清＝停卡退回）；受影响存量行（入口／用例名变更）同批更新；能力退役删行。批末收尾只核对表上名字与实际落地一致（改名则回表），不刷任何批次字段（test-conventions §8.3／§8.9）。
|
||||
>
|
||||
> **旅程补录方法**：新旅程＝加一行，「系统」列写涉及边界；源＝architecture「API 边界」表＋「数据流」存档/读档路径＋各 GDD 登记的 deferral 跨系统用例。
|
||||
> **旅程补录方法**：新旅程＝加一行，「系统」列写涉及边界；源＝各系统 GDD「依赖与输出」节＋「数据流」存档/读档路径＋各 GDD 登记的 deferral 跨系统用例。
|
||||
|
||||
**旅程段一：开机与存档**
|
||||
|
||||
|
||||
@@ -19,7 +19,7 @@ var _db
|
||||
|
||||
|
||||
func _init() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·功能层」battle_orchestrator 行(域文件集含 EffectPort) （效果端口宿主——装载组）
|
||||
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「扩展行：专长插入的结算效果」 （效果端口宿主——装载组）
|
||||
_db = ConfigDBScript.new()
|
||||
var load_ok: bool = _db.load_tables("res://data/tables", true)
|
||||
Kit.check("前置：表加载零 error", load_ok and _db.diagnostics_count("error") == 0)
|
||||
@@ -54,7 +54,7 @@ func _hero_attack_value(rows: Array) -> int:
|
||||
# ---- V1 端口单实例与真实发射路由 ----
|
||||
|
||||
func _smoke_effect_port_wiring() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·功能层」battle_orchestrator 行(域文件集含 EffectPort) （端口单实例与六 Callable 路由组）
|
||||
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「扩展行：专长插入的结算效果」 （端口单实例与六 Callable 路由组）
|
||||
print("--- 效果端口：装配链单实例＋真实发射路由 ---")
|
||||
# 充能跑（蓄力周转 charge_rotation 在册——attack_commit 订阅行 attack_bonus per 蓄力周转计数器）
|
||||
var orch_c = _orch(TEST_SEED)
|
||||
@@ -88,7 +88,7 @@ func _smoke_effect_port_wiring() -> void:
|
||||
# ---- V2 业务类零引擎直连（源码契约锚——theme_projection_test 源码锚惯例）----
|
||||
|
||||
func _test_business_classes_engine_free() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·功能层」battle_orchestrator 行(域文件集含 EffectPort) （业务类零引擎直连组）
|
||||
# 判据出处: design/gdd/术语表.md「效果端口件」 （业务类零引擎直连组）
|
||||
print("--- 效果端口：业务类零引擎直连源码锚 ---")
|
||||
for path in ["res://core/damage_controller.gd", "res://core/action_economy.gd"]:
|
||||
var src := FileAccess.get_file_as_string(path)
|
||||
@@ -100,7 +100,7 @@ func _test_business_classes_engine_free() -> void:
|
||||
# ---- V3 伤害域事实面闭集（合成行两对照——damage_taken 真实单据流）----
|
||||
|
||||
func _test_biz_fact_face_closed() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·功能层」battle_orchestrator 行(域文件集含 EffectPort) （闭面四键 biz_fact 组）
|
||||
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「扩展行：专长插入的结算效果」 （闭面四键 biz_fact 组）
|
||||
print("--- 效果端口：业务发射事实面闭集 ---")
|
||||
var orch = _orch(TEST_SEED)
|
||||
Kit.check("V3 begin_battle 受理", orch.begin_battle(_enc([])))
|
||||
|
||||
@@ -41,8 +41,8 @@ func _init() -> void:
|
||||
# ---- B1 兑付配方词表：五配方/三目标规则/双结账政策——常量非空且互异（封闭枚举负空间） ----
|
||||
|
||||
func _test_damage_controller_vocabularies() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·基础层」effect_engine 行 （事件/事实/效果类型/算子四词表封闭——契约词表组）
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·基础层」effect_engine 行 （事件/事实/效果类型/算子四词表封闭——契约词表组）
|
||||
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「伤害单据与伤害控制器」 （事件/事实/效果类型/算子四词表封闭——契约词表组）
|
||||
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「伤害单据与伤害控制器」 （事件/事实/效果类型/算子四词表封闭——契约词表组）
|
||||
var kinds: Array = [
|
||||
DamageControllerScript.KIND_HERO_ATTACK, DamageControllerScript.KIND_ENEMY_SKILL,
|
||||
DamageControllerScript.KIND_BOARD_TYPED, DamageControllerScript.KIND_BOARD_BLAST,
|
||||
@@ -72,8 +72,8 @@ func _test_damage_controller_vocabularies() -> void:
|
||||
# ---- D2↔B1：掷点用途标签 ∈ RngService 封闭词表（EC12——跨系统字面量契约的成员性断言） ----
|
||||
|
||||
func _test_rng_tag_closure(db) -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·基础层」RngService 行 （流 scope 封闭词表组）
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·基础层」RngService 行 （流 scope 封闭词表组）
|
||||
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流」 （流 scope 封闭词表组）
|
||||
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流」 （流 scope 封闭词表组）
|
||||
var stream_label: String = String(db.combat.settlement.damage_roll.armor_roll_stream)
|
||||
Kit.check("settlement.armor_roll_stream ∈ RngService 封闭标签词表（EC12）",
|
||||
RngServiceScript.PURPOSE_TAGS.has(stream_label))
|
||||
|
||||
@@ -55,7 +55,7 @@ func _init() -> void:
|
||||
|
||||
# ① 缺省两参（真编排器）：同种子两跑整轮驱动逐位（确定性自证——动作序列快照经 cell_revealed 事件流）
|
||||
func _smoke_drive_round_contract() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·功能层」battle_orchestrator 行(域文件集含 EffectPort) （效果端口件：收事件交结算取回命中批——驱动循环契约组）
|
||||
# 判据出处: design/gdd/术语表.md「效果端口件」 （效果端口件：收事件交结算取回命中批——驱动循环契约组）
|
||||
var db = load("res://core/config_db.gd").new()
|
||||
var load_ok: bool = db.load_tables("res://data/tables", true) and db.diagnostics_count("error") == 0
|
||||
Kit.check("前置：表加载零 error", load_ok)
|
||||
@@ -81,7 +81,7 @@ func _smoke_drive_round_contract() -> void:
|
||||
|
||||
# ② provider 形态：策略回调产出 dig/seal_place/refresh 各一——提交与日志回调四元组在案
|
||||
func _provider_shapes() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·功能层」battle_orchestrator 行(域文件集含 EffectPort) （端口应答束形状组）
|
||||
# 判据出处: game/sim/battle_driver.gd「战斗驱动循环单点」 （端口应答束形状组）
|
||||
var st := _StubSettlement.new()
|
||||
var script := [ {"kind": "dig", "cell": Vector2i(1, 1)}, {"kind": "seal", "cell": Vector2i(2, 2)}, {"kind": "refresh"}, {"kind": "stop"} ]
|
||||
var logs: Array = []
|
||||
@@ -102,7 +102,7 @@ func _provider_shapes() -> void:
|
||||
|
||||
# ③ max_rejects：策略恒返被拒动作——第 3 拒后停手出环（循环次数=3）
|
||||
func _max_rejects() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·功能层」battle_orchestrator 行(域文件集含 EffectPort) （拒绝通道组）
|
||||
# 判据出处: game/sim/battle_driver.gd「战斗驱动循环单点」 （拒绝通道组）
|
||||
var st := _StubSettlement.new()
|
||||
st.minesweeper.accept = false
|
||||
st.minesweeper.reject_cells = {Vector2i(9, 9): true}
|
||||
@@ -122,7 +122,7 @@ func _max_rejects() -> void:
|
||||
|
||||
# ④ 合步 next：move 后相位变更即断弃 dig（桩 on_submit 钩子把 phase 推离 Active）
|
||||
func _combined_step_next() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·功能层」battle_orchestrator 行(域文件集含 EffectPort) （合并步进组）
|
||||
# 判据出处: game/sim/battle_driver.gd「战斗驱动循环单点」 （合并步进组）
|
||||
var st := _StubSettlement.new()
|
||||
st.minesweeper.on_submit = func(action: String) -> void:
|
||||
if action == "move":
|
||||
|
||||
@@ -8,7 +8,7 @@ const Kit := preload("res://tests/unit/test_kit.gd")
|
||||
|
||||
|
||||
func _init() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·核心层」CurioDeck 行 （CurioDeck：三选一/商店共享池、抽签、cap 库存——刷新付费组）
|
||||
# 判据出处: design/gdd/systems/跨局循环/秘宝.md「定位与形态」 （CurioDeck：三选一/商店共享池、抽签、cap 库存——刷新付费组）
|
||||
var db = load("res://core/config_db.gd").new()
|
||||
if not db.load_tables("res://data/tables", false):
|
||||
print("[curio_refresh_paid_test] FAIL — 数值表加载失败")
|
||||
|
||||
@@ -11,7 +11,7 @@ const EffectEngineScript = preload("res://core/effect_engine.gd")
|
||||
|
||||
|
||||
func _init() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·基础层」effect_engine 行 （效果词表封闭——扩签封闭性组）
|
||||
# 判据出处: design/gdd/systems/冒险循环/奇物.md「扩签登记」 （效果词表封闭——扩签封闭性组）
|
||||
# ① 词表在册断言（扩签面：2 事件+8 事实+7 效果类型+1 算子）
|
||||
Kit.check_quiet(EffectEngineScript.EVENTS.has("dig_stop") and EffectEngineScript.EVENTS.has("battle_won"),
|
||||
"新事件在册：dig_stop/battle_won〔专长批 V1〕")
|
||||
|
||||
@@ -1254,7 +1254,7 @@ func _paths_all_one_shop(nodes: Array) -> bool:
|
||||
# ---- ⑤ 商店共享池（三选一同构/乘法价/跨渠道共账/切边/断点扩键）----
|
||||
|
||||
func _smoke_shop_pool() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·核心层」CurioDeck 行 （商店共享池组）
|
||||
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md「共享池账本」 （商店共享池组）
|
||||
print("--- 商店共享池（抽3买1全重抽 · 乘法定价 ceil · 池空硬闸 · 切边零入店）---")
|
||||
var autoplay = load("res://sim/level_autoplay.gd")
|
||||
var shelf_kinds: Array = []
|
||||
|
||||
@@ -126,7 +126,7 @@ func _test_reject_out_of_catalog() -> void:
|
||||
# ---- V14 棋盘揭示预览只读口（架构整改——preview_reveal 与实挖揭示集同口径、零状态写入零事件）----
|
||||
|
||||
func _test_preview_reveal_readonly() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·核心层」minesweeper_rules 行 （preview_reveal 只读预览口——零写入零事件组）
|
||||
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「核心规则」 （preview_reveal 只读预览口——零写入零事件组）
|
||||
var events := 0
|
||||
_rules.cell_revealed.connect(func(_evt): events += 1) # 零发射哨兵（preview 全程不触发揭示事件）
|
||||
# 形态 A：封印在场——preview(未开格) 不越封印且零状态写入
|
||||
|
||||
@@ -9,7 +9,7 @@ const Kit := preload("res://tests/unit/test_kit.gd")
|
||||
|
||||
|
||||
func _init() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·核心层」CurioDeck 行 （池结构案 D：候选抽取与池纪律组）
|
||||
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取（重设计 v1）」 （池结构案 D：候选抽取与池纪律组）
|
||||
var db = load("res://core/config_db.gd").new()
|
||||
if not db.load_tables("res://data/tables", false):
|
||||
print("[pool_case_d_test] FAIL — 数值表加载失败")
|
||||
@@ -66,7 +66,7 @@ func _tiers_of(cands: Array) -> Array:
|
||||
|
||||
|
||||
func check_v7(a, db) -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·核心层」CurioDeck 行 （池案 D V7 组）
|
||||
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取（重设计 v1）」 （池案 D V7 组）
|
||||
if not a.start_adventure(201):
|
||||
Kit.check_quiet(false, "V7 前置：冒险启动")
|
||||
return
|
||||
@@ -112,7 +112,7 @@ func check_v7(a, db) -> void:
|
||||
|
||||
|
||||
func check_v6(b, db) -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·核心层」CurioDeck 行 （池案 D V6 组）
|
||||
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取（重设计 v1）」 （池案 D V6 组）
|
||||
if not b.start_adventure(202):
|
||||
Kit.check_quiet(false, "V6 前置：冒险启动")
|
||||
return
|
||||
@@ -142,7 +142,7 @@ func check_v6(b, db) -> void:
|
||||
|
||||
|
||||
func check_v12(m, db) -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·核心层」CurioDeck 行 （池案 D V12 组）
|
||||
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取（重设计 v1）」 （池案 D V12 组）
|
||||
if not m.start_adventure(401):
|
||||
Kit.check_quiet(false, "V12 前置：冒险启动")
|
||||
return
|
||||
@@ -161,7 +161,7 @@ func check_v12(m, db) -> void:
|
||||
|
||||
|
||||
func check_v8(c, db) -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·核心层」CurioDeck 行 （池案 D V8 组）
|
||||
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取（重设计 v1）」 （池案 D V8 组）
|
||||
if not c.start_adventure(203):
|
||||
Kit.check_quiet(false, "V8 前置：冒险启动")
|
||||
return
|
||||
|
||||
@@ -47,7 +47,7 @@ func _fresh_rng(seed_val: int):
|
||||
# ---- ① RNG 事件日志会话落盘（源 `_initialize` :70，主会话裁决一改判跨系统闭环承载——
|
||||
# 驱动沿源 :60–70 取号序列自持：master 种子 42 → 前置取号 → new_adventure 开日志会话 → 会话内取号）----
|
||||
func _rng_event_log_session() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·基础层」RngService 行 （事件日志落盘会话组）
|
||||
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流」 （事件日志落盘会话组）
|
||||
var rng = load("res://core/rng_service.gd").new()
|
||||
rng.set_master_seed(42)
|
||||
rng.open_stream("board_gen")
|
||||
|
||||
@@ -218,7 +218,7 @@ func _test_negative_cases() -> void:
|
||||
# 现行 30；本套件零扩签，钉现行数（将来任何加词即转红提示复核）。
|
||||
|
||||
func _test_effect_kinds_closed() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·基础层」effect_engine 行 事件/事实/效果类型/算子四词表封闭（特效闭集组）
|
||||
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md「满级特效扩展位」 事件/事实/效果类型/算子四词表封闭（特效闭集组）
|
||||
Kit.check("效果引擎效果类型闭集 30 种〔锻造工坊批 V11〕",
|
||||
EffectEngineScript.EFFECT_KINDS.size() == 30)
|
||||
Kit.check("效果引擎事件词表在册 21 种（charge_full 位摘名——蓄力层删键批）〔锻造工坊批 V11〕",
|
||||
|
||||
@@ -77,7 +77,7 @@ func _test_stream_draw_determinism() -> void:
|
||||
|
||||
# 负输入 abs 归一化（警告通道）——|−s| 与 s 同派生
|
||||
func _test_negative_seed_normalization() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·基础层」RngService 行 RngService：master_seed 与各流 scope 计数器单点（种子规约组）
|
||||
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流」 RngService：master_seed 与各流 scope 计数器单点（种子规约组）
|
||||
var pos = _fresh_service()
|
||||
var neg = RngServiceScript.new()
|
||||
neg.set_master_seed(-TEST_SEED)
|
||||
|
||||
@@ -22,7 +22,7 @@ func _init() -> void:
|
||||
# 单元宿主改由 `_init` 显式调用，断言逐字未动；源 :70 事件日志落盘条经主会话裁决一
|
||||
# 改判跨系统闭环套件——不随本宿主，见迁移账本转办清单）----
|
||||
func _smoke_initialize() -> void:
|
||||
# 判据出处: design/engineering/architecture/architecture.md「模块归属·基础层」RngService 行 RngService autoload：open_stream 有状态门面与启动初始化（启动流组）
|
||||
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流」 RngService autoload：open_stream 有状态门面与启动初始化（启动流组）
|
||||
print("=== Dungeon Sweeper 垂直切片冒烟 ===")
|
||||
var db = ConfigDBScript.new()
|
||||
var load_ok: bool = db.load_tables("res://data/tables", true)
|
||||
|
||||
@@ -339,7 +339,7 @@ def check_coverage(cov_tables, names):
|
||||
red(README.relative_to(REPO), 1, "覆盖域表", "%s 未在覆盖域表登记" % doc)
|
||||
|
||||
|
||||
CRITERION_RE = re.compile(r"^#\s*判据出处:\s*(\S+?\.md)(?::(\d+)|「([^」]+)」)\s*\S")
|
||||
CRITERION_RE = re.compile(r"^#\s*判据出处:\s*(\S+?\.(?:md|gd))(?::(\d+)|「([^」]+)」)\s*\S")
|
||||
VERDICT_RE = re.compile(r"(?<![_\w])check(?:_quiet)?\(|_problems\.append\(|push_error\(")
|
||||
CRITERION_FUNC_RE = re.compile(r"^(?:static\s+)?func\s+([A-Za-z_]\w*)")
|
||||
|
||||
@@ -391,8 +391,9 @@ def check_criterion_markers():
|
||||
marked += 1
|
||||
for m in oks:
|
||||
relp, no, sec = m.group(1), m.group(2), m.group(3)
|
||||
if not relp.replace("\\", "/").startswith("design/"):
|
||||
red(rel, s0 + 1, "判据出处注记", "%s 指针越出 design/ 全域：%s" % (name, relp))
|
||||
_rp = relp.replace("\\", "/")
|
||||
if not (_rp.startswith("design/") or _rp.startswith("game/sim/")):
|
||||
red(rel, s0 + 1, "判据出处注记", "%s 指针越出 design/ 与测量面全域：%s" % (name, relp))
|
||||
continue
|
||||
tp = REPO / relp
|
||||
if not tp.is_file():
|
||||
@@ -403,7 +404,7 @@ def check_criterion_markers():
|
||||
red(rel, s0 + 1, "判据出处注记", "%s 指针不可核：%s:%d（行号越界）" % (name, relp, int(no)))
|
||||
elif sec is not None:
|
||||
# 节锚（2026-11-07 架构收窄批立，test-conventions §8.3）：核验节名首段（「·」前）
|
||||
# 在所指文档中出现——「模块归属·基础层」核「模块归属」节标题在档；关键词不核（随文档措辞漂移由人审兜）
|
||||
# 在所指文档中出现——节名首段为「·」前的标题词（如「统一随机流」），标题在档即过；关键词不核（随文档措辞漂移由人审兜）
|
||||
head = sec.split("·")[0]
|
||||
if head not in read(tp):
|
||||
red(rel, s0 + 1, "判据出处注记", "%s 节锚不可核：%s「%s」（文档内无该节名首段）" % (name, relp, head))
|
||||
|
||||
@@ -2,6 +2,12 @@
|
||||
|
||||
本清单是流水线的唯一登记处：以后才做的事在此登记一条，随流水线段推进改状态，做完整条删除（条目记进度，不是各段的开工前置）；各系统文档的「待办」节只留一行指路存根，不再自建条目。条目格式（标题＝登记元数据含可选优先级，正文＝实况/缺口/改动面/状态四属性）与状态机以 [doc-conventions §12.1](design/engineering/doc-conventions.md) 为权威。
|
||||
|
||||
#### 架构文档收敛第二批——依赖规则形态（2026-11-09 登记，来源=会话提及）
|
||||
|
||||
**实况**：方案经用户批准（模块归属表目录化+API 边界表删除+29 处判据锚迁 GDD/规约规范源+四文档引用改指+架构图同步）；分层依据＝依赖方向、目录＝层级承载、同目录同层级同约束。证据＝design/engineering/doc-conventions.md 架构事实唯一源行（只写约束面条款）+用户 2026-11-09 会话裁决。
|
||||
**改动面**：文档＋游戏代码＋工具代码
|
||||
**状态**：待执行
|
||||
|
||||
#### 未决问题迁移——轮内刷新数值连锁重算（2026-11-07 登记，来源=批次移交）
|
||||
|
||||
**实况**：原 architecture.md「未决问题」QQ-04（git 历史可考，架构收窄批迁出）。清图支配性条款⑤的轮内刷新数值连锁重算，判据＝真人刷图行为获取期望。
|
||||
|
||||
Reference in new issue
Block a user