feat(通关口径换代·提前实施卡批 T3/T4): C 面注释清扫 61 条(core 六件 29/adventure_runner 14+save_manager 9+level_runner 3+其余 3/表头注 5/enemy 768 验收判据+871 设计基准/treasure_items 11/adventure 51/meta 55/schema 4/sim 11/README 7/呈现层四件 8)＋S11 豁免单 7→20 处(.tres 段 12+level_autoplay:560,头注避词「口径换代」防自撞)＋tests/README S11 豁免计数 4→20 订正(quotaface 漏同步随批修)＋体验验证清单 3 行(:107 关卡完成率/:193 冒险成功局数+各关完成次数+才计冒险成功/:198 引语);件核三判据过(S11 等价验证器零命中+豁免撤销证明 hero.tres:21 去豁免即红/冒险终结零命中/清单对账零差异);grep 残留=豁免单 13 行+被检字形态,非豁免残留清零——208 处基线全数消化(12 产品+111 随动+84 注释+体验清单 3+README tests 1=211 改动行,其中豁免保留 13)

game/core/save_manager.gd

@@ -7,7 +7,7 @@
 class_name SaveManagerCore
 extends Node
 
-const SAVE_FORMAT_VERSION := 7   # registry schema_version：v7=锻造工坊域（meta 新域 forge_routes〔六路线等级 levels+直购解锁清单 unlocked+当前武器/甲选中标记 weapon/armor；无特效域〕，旧档缺键由 _normalize 按默认补齐=初始持有态〔sword/light 在档余四锁、选中=初始路线〕，v6→v7 空迁移=缺键补齐模式）；v6=生涯终身计数域（meta 两新域 adventure_total〔冒险总局数，开局即计含放弃与失败〕/adventure_cleared〔通关局数，三关全通才计 1——判定字段 summary.cleared〕，旧档缺键由 _normalize 按默认补零，收束自增唯一入账=apply_adventure_summary）；v5=天赋树域（meta 三新域 tree_nodes〔node_id→已购等级〕/fork_sides〔fork_group→a|b〕/migration_note〔三体系迁移补偿注记〕）；v4=同调位域（meta 三新域 boss_kill_count/attunement_equipped/attune_refresh_level——旧档缺键 = 合法空态）；v3=断点附随件扩列+摘要 keystone_drops；v2=断点域出生；v1=首版；高版本拒读 owner=存档序列化
+const SAVE_FORMAT_VERSION := 7   # registry schema_version：v7=锻造工坊域（meta 新域 forge_routes〔六路线等级 levels+直购解锁清单 unlocked+当前武器/甲选中标记 weapon/armor；无特效域〕，旧档缺键由 _normalize 按默认补齐=初始持有态〔sword/light 在档余四锁、选中=初始路线〕，v6→v7 空迁移=缺键补齐模式）；v6=生涯终身计数域（meta 两新域 adventure_total〔冒险总局数，开局即计含放弃与失败〕/adventure_cleared〔冒险成功局数，三关全通才计 1——判定字段 summary.cleared〕，旧档缺键由 _normalize 按默认补零，收束自增唯一入账=apply_adventure_summary）；v5=天赋树域（meta 三新域 tree_nodes〔node_id→已购等级〕/fork_sides〔fork_group→a|b〕/migration_note〔三体系迁移补偿注记〕）；v4=同调位域（meta 三新域 boss_kill_count/attunement_equipped/attune_refresh_level——旧档缺键 = 合法空态）；v3=断点附随件扩列+摘要 keystone_drops；v2=断点域出生；v1=首版；高版本拒读 owner=存档序列化
 const SUMMARY_CAP := 10          # 最近冒险摘要保留条数（最新在前）
 
 const TREE_STRUCT_VERSION := 2   # 树结构版本标记（12 节点 v0.8 结构；加载检测缺失
@@ -154,7 +154,7 @@ func delete_slot(slot: int) -> bool:
 	return true
 
 
-# 摘要三项按槽窥视读器（sv7/sv8，契约 5/9）：钥石余额/通关局数/冒险总局数。
+# 摘要三项按槽窥视读器（sv7/sv8，契约 5/9）：钥石余额/冒险成功局数/冒险总局数。
 # 只读零副作用：不激活、不写盘、不触发 _corrupt_fallback 改名（.corrupt.bak 只在正式进档路径产生）。
 # 返回 {"readable", "has_file", "keystone", "cleared", "total"}——readable=true=可读槽（空槽=零值合法态，
 # .tmp 残留按空槽——主文件不在即空）；readable=false=不可读槽（损坏/高版本/缺版本字段/打开失败，
@@ -285,7 +285,7 @@ func _default_data() -> Dictionary[String, Variant]:
 			"recent_summaries": [],
 			"first_adventure_done": false,
 			"adventure_total": 0,     # 生涯终身计数·冒险总局数（开局即计含放弃与失败，收束唯一入账）
-			"adventure_cleared": 0,   # 生涯终身计数·通关局数（三关全通才计 1——判定字段 summary.cleared）
+			"adventure_cleared": 0,   # 生涯终身计数·冒险成功局数（三关全通才计 1——判定字段 summary.cleared）
 			"vision_used": 0,         # 生涯终身计数·真视类工具累计使用次数（信标网络解锁行为条件；
 			                          # 受理成功唯一计数点=battle 层经冒险层聚合、收束入账；缺键补零不升版本）
 			"forge_routes": {         # 锻造工坊域（六路线等级+直购解锁清单+当前选中标记；无特效域）
@@ -417,7 +417,7 @@ func boss_first_kill_marked(level_index: int) -> bool:
 
 # ---- 同调位账本域（里程碑谓词表计数源 + 装配关系 + Y 升级态）----
 
-# Boss 击杀总数（含重复——底稿裁决 4 计数源；收束入账 = apply_adventure_summary 逐通关关次 +1，
+# Boss 击杀总数（含重复——底稿裁决 4 计数源；收束入账 = apply_adventure_summary 逐关卡完成关次 +1，
 # Boss 恒唯一终点故 levels_cleared 即本次冒险 Boss 击杀数）
 func boss_kill_count() -> int:
 	return int(_data["meta"].get("boss_kill_count", 0))
@@ -431,8 +431,8 @@ func adventure_total() -> int:
 	return int(_data["meta"].get("adventure_total", 0))
 
 
-# 通关局数（口径=三关全通才计 1——判定字段 summary.cleared，adventure_runner「completed」
-# 唯一出口=末关通关）
+# 冒险成功局数（口径=三关全通才计 1——判定字段 summary.cleared，adventure_runner「completed」
+# 唯一出口=末关的关卡完成）
 func adventure_cleared() -> int:
 	return int(_data["meta"].get("adventure_cleared", 0))
 
@@ -558,7 +558,7 @@ func set_attune_refresh_level(n: int) -> void:
 	_data["meta"]["attune_refresh_level"] = maxi(0, n)
 
 
-# 同调位计数源组装（Attunement 服务取数口——clear_count = 逐关通关次数合计〔含重复关，底稿 §2.1 口径〕；
+# 同调位计数源组装（Attunement 服务取数口——clear_count = 逐关完成次数合计〔含重复关，底稿 §2.1 口径〕；
 # clear_count(level_index) 逐关访问器零改动复用）
 func recent_summaries() -> Array:
 	return _data["meta"]["recent_summaries"].duplicate(true)   # 值拷贝出户（本类契约「禁碰内部结构」——消费方直改不得渗入存档内存态）
@@ -566,10 +566,10 @@ func recent_summaries() -> Array:
 
 # 域更新原语（正式冒险收束唯一入账口——组合根经本函数入账，禁直改内部结构）：
 # 钥石入账（summary.keystone_total——逐杀掉落已在冒险内计入，boss_drops 参数为
-# 摘要归档副本不重复入账）+ 逐通关关次 clear_count +1 与 Boss 首杀标记 + Boss 击杀总数累计
+# 摘要归档副本不重复入账）+ 逐关卡完成关次 clear_count +1 与 Boss 首杀标记 + Boss 击杀总数累计
 # （同调位里程碑计数源）+ 摘要头部插入（cap 10，最新在前，元素附
 # keystone_drops 副本——复盘可归因）+ 生涯终身计数自增（总局数开局即计：
-# 三结局同经本口恰计一次；通关局数按 summary.cleared 判定三关全通才计 1。终身计数写入
+# 三结局同经本口恰计一次；冒险成功局数按 summary.cleared 判定三关全通才计 1。终身计数写入
 # 单口=本函数，禁第二写入点）。
 func apply_adventure_summary(summary: Dictionary, boss_drops: Array = []) -> void:
 	_data["meta"]["adventure_total"] = adventure_total() + 1