工程(注释标记词换代·oracle→判据出处): 用户 2026-11-07 令——判据出处注记的标记词改用项目已有中文名,避免 Oracle 被读成数据库。注释格式句、机检正则、标识符、卡片与登记同步换代;零行为改动。

改动面 112 文件 572+/572-:game/tests/** 与 game/probe/** 共 106 件 545 行 `# oracle:`→`# 判据出处:`;tools/capability_audit.py 正则字面量换中文+ORACLE_*→CRITERION_*/check_oracle_markers→check_criterion_markers/oracle_marked(flagged)→criterion_* 共 11 行;test-conventions.md:119 格式句+:155 措辞;待办清单与需求卡片-QA覆盖余量收口批各 1 处字面量;coverage_enum.py:21 与 camp_scene_layout_test.gd:101 旁支措辞;ui_click_probe.gd 对拍局部变量 oracle→expected 7 处;auto_player.gd 三处 safe_set 真值措辞。不动:历史审计报告两份、test-oracle-anchor 分支名、git 史、生成日志;指针格式/扫描面/判红条件/验收义务全不变。

读数(区内实跑):改前 capability_audit --strict「417 注记函数·红项 0」→改后「417 判据出处注记函数·红项 0」exit=0;新标记 545 行/106 文件,现行义务面 oracle 残留 0(在册沿革除外);diff 自检 game/ 非注释新增行仅 6 行且全在 ui_click_probe.gd 的 expected 变量段;112 改动文件 CRLF=0;py_compile tools/capability_audit.py OK;--docs exit=0【验收通过】无新增红;--gates exit=0(静态扫描绿、闸壳 bash -n ×13 失败 0)。
This commit is contained in:
DKChan committed 2026-11-07 07:11:15 +08:00
1 parent 166114e094
commit 9f21236f80
112 files changed
+572 -572

No files matched your search

@@ -33,7 +33,7 @@ const A1_FILES := {
func _init() -> void:
# oracle: design/engineering/code-conventions.md:41 (presentation 封装——四族零命中扫描组)
# 判据出处: design/engineering/code-conventions.md:41 (presentation 封装——四族零命中扫描组)
_sweep_a1_data_classes()
_sweep_a2_subparts()
_sweep_b_combo_root()
@@ -43,7 +43,7 @@ func _init() -> void:
# 源文件读取+非空前置(返 "" 即已判红——调用侧跳过后续正则断言)
func _src(path: String) -> String:
# oracle: design/engineering/code-conventions.md:41 (源码采样组)
# 判据出处: design/engineering/code-conventions.md:41 (源码采样组)
var src := FileAccess.get_file_as_string(path)
Kit.check("扫描面非空前置:%s" % path, src.length() > 0)
return src
@@ -51,21 +51,21 @@ func _src(path: String) -> String:
# 正则零命中断言(-pattern 意图写入断言文案——可 grep 定位;suffix 区分族组)
func _zero(pattern: String, src: String, label: String, suffix: String = "pres封装 V1") -> void:
# oracle: design/engineering/code-conventions.md:41 (零命中扫描组)
# 判据出处: design/engineering/code-conventions.md:41 (零命中扫描组)
var re := RegEx.create_from_string(pattern)
Kit.check("%s:%s 零命中〔%s〕" % [label, pattern, suffix], re.search(src) == null)
# 正锚在案断言(正则命中 ≥1——新公开面/新形态在用;suffix 区分族组)
func _anchor(pattern: String, src: String, label: String, suffix: String = "pres封装 V1") -> void:
# oracle: design/engineering/code-conventions.md:41 (正锚存在组)
# 判据出处: design/engineering/code-conventions.md:41 (正锚存在组)
var re := RegEx.create_from_string(pattern)
Kit.check("%s:%s 正锚在案〔%s〕" % [label, pattern, suffix], re.search(src) != null)
# ② V2 A2 拆件子件(行为归位子件公开方法、读走公开读法、身份构造交付)
func _sweep_a2_subparts() -> void:
# oracle: design/engineering/code-conventions.md:41 (A2 子件封装扫描组)
# 判据出处: design/engineering/code-conventions.md:41 (A2 子件封装扫描组)
var body := _src("res://presentation/views/standee_body.gd")
if body.length() > 0:
_zero("\\bst\\._|\\bmo\\._", body, "子件私取模式零命中(standee_body)", "pres封装 V2")
@@ -82,7 +82,7 @@ func _sweep_a2_subparts() -> void:
# ③ V3 B 组合根交接面(main+五分文件——成对单行转发梯换代为公开入口+Callable 束)
func _sweep_b_combo_root() -> void:
# oracle: design/engineering/code-conventions.md:41 (组合根束封装扫描组)
# 判据出处: design/engineering/code-conventions.md:41 (组合根束封装扫描组)
var b_files := {
"res://presentation/main.gd": false,
"res://presentation/main_ui_build.gd": true,
@@ -117,7 +117,7 @@ func _sweep_b_combo_root() -> void:
# ④ V4 C 杂项(UiKit 私有工厂公开化+cell_mark 构造交付)
func _sweep_c_misc() -> void:
# oracle: design/engineering/test-conventions.md:56 (判定上报通道——验证函数组)
# 判据出处: design/engineering/test-conventions.md:56 (判定上报通道——验证函数组)
var offenders: PackedStringArray = []
var scanned := 0
_walk_gd_for("res://", "UiKit\\._[a-zA-Z]", "res://presentation/views/ui_kit.gd", offenders)
@@ -155,7 +155,7 @@ func _walk_gd_for(dir_path: String, pattern: String, exclude: String, offenders:
# ① V1 A1 三内部数据类(字段公开化——宿主直读写内类私有字段清零)
func _sweep_a1_data_classes() -> void:
# oracle: design/engineering/test-conventions.md:56 (判定上报通道——验证函数组)
# 判据出处: design/engineering/test-conventions.md:56 (判定上报通道——验证函数组)
for path in A1_FILES:
var spec: Dictionary = A1_FILES[path]
var src := _src(path)