chore(代码卫生): 头注存量清偿批——82 文件按两类白名单改写为 ## 文档注释载体

按 code-conventions §1.4.1 第三轮定稿执行:core 22+schemas 18+presentation 根 14+views 28,全部头注 #→##、删日期/变更叙事/GDD 与架构反向链接/字段与域清单/机制描述,保留职责摘要+真实使用约束(防事故禁令/单一入口/信号契约每信号一行)。main.gd 31→5 行、save_manager 45→5 行、adventure_runner 37→5 行为最大单件。子代理分模块执行(波一 core+schemas、波二 presentation+views,并发≤2)。验收=tools/verify_comment_only_change.py 逐字节校验(82 文件头注区外逐行一致=零行为变更)+audit_file_headers 全绿;纯注释批免冒烟(先例 5843270)
This commit is contained in:
DKChan committed 2026-10-16 23:28:07 +08:00
1 parent 1c034f555f
commit 9a72394652
83 files changed
+348 -916

No files matched your search

+4 -6
View File
@@ -1,9 +1,7 @@
# VERTICAL SLICE - NOT FOR PRODUCTION
# 实现 GDD:design/ux/interaction-patterns.md(pattern 6 模态 overlay 层级纪律)。
# Date: 2026-09-12(code-review 修复批——自 main.gd 拆出,规范 1.1 状态装配独立成类)
# 模态层级状态机:登记序 = 树序 = z 遮挡序;打开时显式隐藏树序在其上方的可见层、关闭恢复
# (缺陷⑤纪律载体:功能存在 ≠ 功能可达——遮挡关系不得靠树序巧合)。
# 纯逻辑零节点构建——组合根持有本类并喂入 Control;不持久化核心状态。
## VERTICAL SLICE - NOT FOR PRODUCTION
## 模态层级状态机:登记序 = 树序 = z 遮挡序,打开显式隐藏其上方可见层、关闭恢复。
## 层必须先 register 方可 open/close;遮挡由本类显式记账,不得靠树序巧合。
## 纯逻辑类——Control 层由组合根喂入 register。
extends RefCounted
var _list: Array[Control] = [] # 登记序 = z 遮挡序(低 → 高)