合并(工程清理批·用户令): 六件直改——①palette_check基线建档+双门②机检化+05b色板闸 ②extract_checks补check_quiet(1719→2133三重自证) ③样张S1b四色墨断言(31/31全绿) ④main.gd死preload清理10条 ⑤ui_kit/path_check注释换代 ⑥CAMP_HEADER_BAND评估=改名中性化归ui_kit令牌批; run_all_gates02传参核查=d32ff342已完成漏删; 待办清单7条目删除; pipeline_gate PASS; 合回后post-merge钩子自动跑CI全量域闸(含新05b色板闸), 回执后台挂ci_watch
This commit is contained in:
commit
cdc50e06de
13 files changed
+238
-90
No files matched your search
@@ -35,7 +35,7 @@
|
||||
需求卡片 §8「改动—验收对照表」每一条都要落成可执行的验证;本文定统一写法,卡里定每批的具体内容(测什么/注入哪里)。写卡期查不出执行载体的条目=不可测,当场呈报,禁拖到实现期。
|
||||
|
||||
1. **执行载体五选一,逐条声明**:单元测试(`tests/run_all`)/系统测试断言(`tests/system_test.gd`)/场景探针(`probe/` 下 `*_probe`)/MC 同种子逐项比对/人工核对(仅限无法自动化的纪律类需求点,如命名锁定、数值占位)。行为类条目以自动化载体为主。
|
||||
2. **粒度与对应关系**:每条清单条目至少一个自动断言,且断言必须从该条目的真实入口进入;多条条目可合用一个测试函数,但每条都要有自己单独可判红的判据(取证口径见 §8.4 唯一口径——禁变异/禁撤销)。断言失败消息末尾带编号尾缀〔卡短名 Vn〕(如〔秘宝批 V3〕)——断言与卡片清单可互相 grep 查找。**工具面局限备案(2026-10-27 迭代 39 验收审计)**:`Kit.check_quiet` 静默收集形态(计数不入判定即打印、失败消息进 problems 汇总)的断言消息不进 `tools/extract_checks.py` 扫描面——验收尾缀 grep 对该通道失效;如需覆盖属提取器改版(工程批)。
|
||||
2. **粒度与对应关系**:每条清单条目至少一个自动断言,且断言必须从该条目的真实入口进入;多条条目可合用一个测试函数,但每条都要有自己单独可判红的判据(取证口径见 §8.4 唯一口径——禁变异/禁撤销)。断言失败消息末尾带编号尾缀〔卡短名 Vn〕(如〔秘宝批 V3〕)——断言与卡片清单可互相 grep 查找。`Kit.check_quiet` 静默收集形态(计数不入判定即打印、失败消息进 problems 汇总)的断言已入 `tools/extract_checks.py` 扫描面(2026-11-02 提取器改版:三通道同口径提取,静默通道条目 quiet 列记 `channel:check_quiet`),验收尾缀 grep 对该通道有效。
|
||||
3. **断言词汇按验证对象五选一**:
|
||||
|
||||
| 词汇 | 适用场景 |
|
||||
|
||||
@@ -14,21 +14,11 @@ const AUTOLOAD_PATH_RNG := "/root/RngService"
|
||||
const AUTOLOAD_PATH_SAVE := "/root/SaveManager"
|
||||
const AUTOLOAD_PATH_META := "/root/MetaProgression"
|
||||
|
||||
const UiAssembler := preload("res://presentation/ui_assembler.gd")
|
||||
const Narrator := preload("res://presentation/battle_narrator.gd")
|
||||
const TuneSimController := preload("res://presentation/tune_sim_controller.gd")
|
||||
const DebugSessionScript := preload("res://presentation/debug_session.gd")
|
||||
const TreasureInteractController := preload("res://presentation/treasure_interact_controller.gd") # 秘宝两步交互
|
||||
const CurioInteractController := preload("res://presentation/curio_interact_controller.gd") # 三选一与替换子交互
|
||||
const CampShopPresenter := preload("res://presentation/camp_shop_presenter.gd") # 营地/商店投影
|
||||
const BoardResolversScript := preload("res://presentation/board_resolvers.gd") # 棋盘解析回调族
|
||||
const MainUiBuild := preload("res://presentation/main_ui_build.gd") # 装配分步承接件
|
||||
const MainAdventureFlow := preload("res://presentation/main_adventure_flow.gd") # 冒险流程承接件
|
||||
const MainOverlayFlow := preload("res://presentation/main_overlay_flow.gd") # 覆盖层流程承接件
|
||||
const MainDebugFlow := preload("res://presentation/main_debug_flow.gd") # 调试流程承接件
|
||||
const MenuScreenScene := preload("res://presentation/scenes/menu_screen.tscn") # 三屏壳场景
|
||||
const CampScreenScene := preload("res://presentation/scenes/camp_screen.tscn")
|
||||
const AdventureScreenScene := preload("res://presentation/scenes/adventure_screen.tscn")
|
||||
|
||||
var db
|
||||
var run_scope = null # 会话状态承载(run_scope.gd;_ready 即建闲时态,永非 null)
|
||||
|
||||
@@ -230,7 +230,7 @@ static func motion(dur: float) -> float:
|
||||
# 的字形/无演出回退路径;禁 preload(素材缺位树上直接断言炸脚本,冒烟安全红线)
|
||||
const TEX_HERO_IDLE := "res://assets/art/character/character_hero_idle.png"
|
||||
const TEX_HERO_WALK := "res://assets/art/character/character_hero_walk.png"
|
||||
const TEX_HERO_PORTRAIT := "res://assets/art/character/character_hero_portrait.png" # B 区站桩立绘·normal 态(48px 档)
|
||||
const TEX_HERO_PORTRAIT := "res://assets/art/character/character_hero_portrait.png" # B 区站桩立绘·normal 态(素材=原稿分辨率,显示档缩放读 standee_motion PORTRAIT_DISPLAY_H)
|
||||
const TEX_HERO_ATTACK := "res://assets/art/character/character_hero_attack.png" # B 区站桩立绘·attack 态(三态切换)
|
||||
const TEX_HERO_HIT := "res://assets/art/character/character_hero_hit.png" # B 区站桩立绘·hit 态(三态切换)
|
||||
# 敌种立绘(B 区站桩)——文件键 = 数据表主键 enemy_id(圣经 §8.3 命名规范),
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 2.5 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 337 B |
@@ -0,0 +1,75 @@
|
||||
# 工程改动报告——工程清理批(2026-11-02)
|
||||
|
||||
接收方:待办清单 7 条目(本批完成整条删除——palette_check 基线建档/CAMP_HEADER_BAND 评估/ui_kit 立绘注释/迭代 43 四色墨断言/断言提取器 check_quiet/run_all_gates 02 传参〔已完成漏删〕/main.gd 死 preload)。
|
||||
|
||||
## 一、批定位
|
||||
|
||||
工程改动批(用户发令直改,不写卡)。worktree `eng-cleanup`,基点 7e9e57fd,基点即 master 尖端。七件:六件本批落地+一件核查确认已完成(run_all_gates 02 传参)。
|
||||
|
||||
## 二、逐件落地
|
||||
|
||||
### 件 1 palette_check 基线建档+双门机检化
|
||||
|
||||
- 基线目录 `game/tests/golden/palette_baseline/`(图像白名单在册目录)两张条带 PNG:`ui_tokens.png` 92 色(ui_kit.gd 全量 Color8 常量唯一值快照)+ `art_snapshot.png` 1274 色(现役素材 128 张 PNG 唯一色并集快照);并集 1346 色=双门②「新增色 vs 既有色板」的既有色板机检承载物。
|
||||
- 新件 `tools/gen_palette_baseline.py`:基线建档与刷新器(token 提取剔除注释行;素材目录零 PNG 拒绝生成空快照)。
|
||||
- `tools/palette_check.py` 零代码改动——头注补基线构成与维护纪律、退出码描述校正(单张超 32 色是 WARN 非 FAIL)。
|
||||
- 闸机接线:`tools/run_all_gates.sh` 新增 **05b 色板闸**(code 域;--quick 与影响面选闸 SKIP;素材齐盘预检之后段执行)——扫 `game/assets/art` 全目录对基线判新增色近色红。
|
||||
- 口径边界(呈报):门①语义检查属设计面人工核对(§4.2 色相语义判域),不入本器执法面;48 token 计数上限不接闸——ui_kit 现役唯一色值 92 与「48 上限」的成员名单口径差归 art-bible §4.1 owner 裁定,本批不自裁。
|
||||
- 维护纪律:素材批收尾跑 `python tools/gen_palette_baseline.py` 重生成全套并随批提交——新色过门后须入基线,否则下批扫描把已过门的新色再报新增;两张 PNG 缺一即漏判。
|
||||
|
||||
### 件 2 extract_checks.py 补 check_quiet 静默通道
|
||||
|
||||
- `CALL_RE` → `check(?:_quiet)?\(`、`DEF_RE` 同扩(func check / func check_quiet 定义行双拦)、`collect_call` 按实际匹配长度偏移;check_quiet 通道契约 cond 在前,条目 quiet 列记 `channel:check_quiet`。单趟正则无重叠匹配,结构上不双计。
|
||||
- 自证三重(当轮实跑):①双计等式——旧两正则匹配数之和 2155 == 新 CALL_RE 2155(全 tests 面);②新旧版条目对拍 1719 → 2133,差 414 条 check_quiet 入账(grep 调用行实数 416,差 2=定义行与注释行不入账,方向自洽);③`--extract` 生成临时清单后 `--diff` 往返对账 PASS 零差异(标签/cond/计数三对齐)。
|
||||
- 验证集清单已随验证体系整改阶段 2 退役,`--diff` 无存档参照——对账自证以临时清单往返承载,语义等同。
|
||||
- 随批换代 `design/engineering/test-conventions.md` §5.2 工具面局限备案句(2026-10-27 立的「断言消息不进扫描面——验收尾缀 grep 对该通道失效」已消除,留存会漂移);文档设计面仅此一句现状描述更新,申报。
|
||||
|
||||
### 件 3 意图徽标四色墨机检断言
|
||||
|
||||
- `tools/render_sample_sheet_v3.py` `run_screen_checks` 增 **S1b**:意图徽标四色墨(攻击/增益/减益/蓄力)对 PANEL_DATA 垫牌(#E9D9B8,与绘制矩形 fill 同源)≥4.5:1 色值对表断言,四墨值即脚本意图色表四值,零新增色。
|
||||
- 当轮真实读数:攻击 5.62/增益 5.10/减益 4.97/蓄力 5.21——与独立审计复算区间 4.97–5.62 逐位一致。
|
||||
- 样张机检 31/31 全绿。V10 改前基线对拍图属 artwork(不入 git)环境件,worktree 用 `--save-baseline` 重建(本批零素材零绘制变更,基线等值)。
|
||||
|
||||
### 件 4 main.gd 拆件遗留死 preload 清理
|
||||
|
||||
- 逐条 grep 复核(登记纪律):死码 **10 条**——登记 8 条,复核多出 2 条(三场景 preload 中 AdventureScreenScene 登记时另有消费面、UiAssembler 登记时在役;现全零)。UiAssembler 唯一非定义出现=组合根接线段注释提及类名(非常量使用)。
|
||||
- 7 具名(TuneSimController/DebugSessionScript/TreasureInteractController/CurioInteractController/CampShopPresenter/BoardResolversScript 等)消费面已迁 `main_ui_build.gd:9-13`(拆件自持 preload)——main.gd 旧常量=拆件残留重复声明;三场景消费面=system_test.gd `load()` 与 main.tscn,删常量不触。
|
||||
- 删除 10 条 const preload,保留 Narrator/MainUiBuild/MainAdventureFlow/MainOverlayFlow/MainDebugFlow 五条在役。
|
||||
|
||||
### 件 5 过时注释换代
|
||||
|
||||
- `game/presentation/views/ui_kit.gd` TEX_HERO_PORTRAIT 行注释「48px 档」→「素材=原稿分辨率,显示档缩放读 standee_motion PORTRAIT_DISPLAY_H」(迭代 48 显示档批现行口径)。
|
||||
- `tools/path_check.py` 头注删「· 立绘定档批 2026-10-07」日期批注记(变更叙事黑名单类);47 行键集指名核实现行仍在役(standee_asset_check 现行 import STANDEE_DISPLAY_H),不改。
|
||||
|
||||
### 件 6 ui_kit CAMP_HEADER_BAND 令牌退役评估
|
||||
|
||||
现役消费面 4 处逐一核过:`level_map_screen.gd:107/144`(关卡屏头带与地图条)、`shop_overlay_view.gd:49`(商店头带)、`ui_kit.gd` KeystoneBadge 工厂(钥石徽描边——消费方=营地覆盖层+状态面板钥石余额行)。
|
||||
|
||||
**结论**:「退役删除」不成立——4 处在用且全是活面板绘制面;营地域柜台头带语义岗已随迭代 47 四柜台覆盖层退役,令牌现役值 #6E4526 只剩材质棕底色语义(木色头带/徽章描边)。**处置=改名中性化**(脱 CAMP_ 前缀,名随现役语义,如 WOOD_BAND 一族)归 ui_kit 令牌批顺带;改名零值变化零渲染变化,届时逐点核后动。维持原登记口径「退役归 ui_kit 令牌批顺带处置、非独立强删」。
|
||||
|
||||
### 件 7 run_all_gates 02 关联档传参(核查确认已完成)
|
||||
|
||||
`d32ff342`(工程小件批·件 1)已落两案中的「解析器补逗号切分」案:`run_all.gd` 选跑解析补 `split(",")`,闸脚本逗号串传参与之配套,孤立验证四套件全绿。本批零改动,条目属完成漏删。
|
||||
|
||||
## 三、待办清单
|
||||
|
||||
删 7 条(整条删除,状态机出口):palette_check 基线建档/CAMP_HEADER_BAND 评估/ui_kit 立绘注释/迭代 43 移交小件(①能力清单补行已随 2026-10-31 写卡批落位、②四色墨断言本批落)/断言提取器改版/run_all_gates 02 传参(d32ff342 已完成)/main.gd 死 preload。流水线闸复验 PASS(33 条目/49 总表行)。
|
||||
|
||||
## 四、窄验读数(worktree 内当轮实跑)
|
||||
|
||||
| 验证 | 读数 |
|
||||
|---|---|
|
||||
| palette_check 带基线扫 art 全目录 | 128 张 0 红 0 新增色 |
|
||||
| presentation 单元套件(main.gd/ui_kit.gd 编译面) | 17 suites 全绿 |
|
||||
| 冒烟 run_smoke | 15 项 0 失败,三闸全过 |
|
||||
| 样张 render_sample_sheet_v3 | 31/31 全绿(含新 S1b) |
|
||||
| path_check | 0 处问题 |
|
||||
| extract_checks | 双计等式过/1719→2133/往返对账 PASS |
|
||||
| pipeline_gate | PASS(33 条目/49 总表行/交叉核 3 链) |
|
||||
|
||||
全量回归归合回后本地 CI(post-merge 钩子自动跑,含新 05b 色板闸)。
|
||||
|
||||
## 五、边界与移交
|
||||
|
||||
- 48 token 计数上限的机检承载与门①语义检查不属本批(口径归 art-bible owner),呈报待裁。
|
||||
- 05b 色板闸的基线维护义务(素材批收尾刷新)已写进 palette_check.py 头注与 gen_palette_baseline.py 头注,闸机注释同步点名。
|
||||
+24
-19
@@ -2,7 +2,7 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
r"""extract_checks.py — 断言静态提取器(验证集清单生成与出口对账)
|
||||
|
||||
机器提取宿主脚本的全部静态 check( 调用点(每个调用点记录:所在文件、所在函数、
|
||||
机器提取宿主脚本的全部静态断言调用点(每个调用点记录:所在文件、所在函数、
|
||||
行号、标签字符串字面量原文、cond 表达式原文),提供两种模式:
|
||||
|
||||
用法:
|
||||
@@ -19,10 +19,11 @@ r"""extract_checks.py — 断言静态提取器(验证集清单生成与出口
|
||||
断言,对账时以「新增」出现(非迁移面),出口判定以显式模式为准。
|
||||
|
||||
提取口径:
|
||||
- 静态 check( 调用点,两种通道都认:smoke/系统宿主的 check(cond, label)(cond 在前)
|
||||
与单元/集成宿主的 Kit.check("label", cond)(点前缀=标签在前);`_check(` 等同名
|
||||
前缀调用非标准通道,不取。
|
||||
- 调用点可跨行:从 `check(` 起括号配平归集完整实参文本(() [] {} 三种括号都计深度);
|
||||
- 静态断言调用点,三通道都认:smoke/系统宿主的 check(cond, label)(cond 在前)、
|
||||
单元/集成宿主的 Kit.check("label", cond)(点前缀=标签在前)、静默收集通道
|
||||
Kit.check_quiet(cond, label)(cond 在前,条目 quiet 列记 channel:check_quiet);
|
||||
`_check(` 等同名前缀调用非标准通道,不取。
|
||||
- 调用点可跨行:从调用名起括号配平归集完整实参文本(() [] {} 三种括号都计深度);
|
||||
字符串字面量内的括号/逗号/井号、行尾注释、转义序列均不参与结构判定(码位掩码单趟预扫)。
|
||||
- cond 摘要=cond 原文跨行折叠为单行(连续空白并一空格);标签原文=标签实参里的字符串
|
||||
字面量逐字保真(含引号与转义序列原样,禁改写);标签实参若带格式化/拼接后缀
|
||||
@@ -64,8 +65,8 @@ def default_sources():
|
||||
files.extend(sorted(p.rglob("*.gd")))
|
||||
return sorted(files)
|
||||
|
||||
CALL_RE = re.compile(r"check\(")
|
||||
DEF_RE = re.compile(r"^\s*(static\s+)?func\s+check\s*\(")
|
||||
CALL_RE = re.compile(r"check(?:_quiet)?\(")
|
||||
DEF_RE = re.compile(r"^\s*(static\s+)?func\s+check(?:_quiet)?\s*\(")
|
||||
FUNC_RE = re.compile(r"^(static\s+)?func\s+([A-Za-z_][A-Za-z0-9_]*)")
|
||||
LITERAL_RE = re.compile(r'"((?:[^"\\]|\\.)*)"')
|
||||
OPENERS = "([{"
|
||||
@@ -188,9 +189,9 @@ def split_args(body):
|
||||
return args
|
||||
|
||||
|
||||
def collect_call(joined, start):
|
||||
"""从 check( 的 start 起括号配平归集调用。返回 (body, end_pos);不配平返回 None。"""
|
||||
i = start + len("check(")
|
||||
def collect_call(joined, start, call_len):
|
||||
"""从调用名起点起括号配平归集调用。返回 (body, end_pos);不配平返回 None。"""
|
||||
i = start + call_len
|
||||
depth = 1
|
||||
in_str = False
|
||||
parts = []
|
||||
@@ -228,7 +229,7 @@ def collect_call(joined, start):
|
||||
|
||||
|
||||
def extract(src_path: Path):
|
||||
"""提取单文件全部静态 check( 调用点。返回(条目列表, 函数表),条目保持源码顺序。"""
|
||||
"""提取单文件全部静态断言调用点(check/check_quiet)。返回(条目列表, 函数表),条目保持源码顺序。"""
|
||||
src = src_path.read_text(encoding="utf-8")
|
||||
lines = src.split("\n")
|
||||
funcs = func_table(lines)
|
||||
@@ -247,28 +248,32 @@ def extract(src_path: Path):
|
||||
entries = []
|
||||
for m in CALL_RE.finditer(joined):
|
||||
if not mask[m.start()]:
|
||||
continue # 字符串字面量内 / 注释里的 check( 字样
|
||||
continue # 字符串字面量内 / 注释里的调用名字样
|
||||
ln = line_of(m.start())
|
||||
if DEF_RE.match(lines[ln - 1]):
|
||||
continue # func check 定义行
|
||||
continue # func check / func check_quiet 定义行
|
||||
prev = joined[m.start() - 1] if m.start() > 0 else ""
|
||||
if prev and (prev.isalnum() or prev == "_"):
|
||||
continue # `_check(` 等同名前缀——非标准通道
|
||||
label_first = prev == "." # Kit.check("label", cond)——点前缀=标签在前
|
||||
body, end_pos = collect_call(joined, m.start())
|
||||
is_quiet = m.group(0).startswith("check_quiet")
|
||||
if is_quiet:
|
||||
label_first = False # Kit.check_quiet(cond, label)——cond 在前
|
||||
else:
|
||||
label_first = prev == "." # Kit.check("label", cond)——点前缀=标签在前
|
||||
body, end_pos = collect_call(joined, m.start(), len(m.group(0)))
|
||||
if body is None:
|
||||
raise SystemExit("[extract_checks] FAIL:%s 行 %d 起的 check( 括号不配平到文件尾——先查解析缺口"
|
||||
raise SystemExit("[extract_checks] FAIL:%s 行 %d 起的断言调用括号不配平到文件尾——先查解析缺口"
|
||||
% (src_path.name, ln))
|
||||
args = split_args(body)
|
||||
if len(args) not in (2, 3):
|
||||
raise SystemExit(
|
||||
"[extract_checks] FAIL:%s 行 %d 的 check( 拆出 %d 个实参(预期 2/3)——解析缺口,先查再跑"
|
||||
"[extract_checks] FAIL:%s 行 %d 的断言调用拆出 %d 个实参(预期 2/3)——解析缺口,先查再跑"
|
||||
% (src_path.name, ln, len(args)))
|
||||
if label_first:
|
||||
label_expr, cond = args[0], args[1]
|
||||
else:
|
||||
cond, label_expr = args[0], args[1]
|
||||
quiet = args[2] if len(args) == 3 else ""
|
||||
quiet = "channel:check_quiet" if is_quiet else (args[2] if len(args) == 3 else "")
|
||||
lm = LITERAL_RE.search(label_expr)
|
||||
if lm is None:
|
||||
continue # 标签实参无字面量(wrapper 直传变量——既有套件先例 reward_overlay_test _req)
|
||||
@@ -336,7 +341,7 @@ def render_list(entries, funcs_by_src, src_names, carry=None) -> str:
|
||||
out.append("# 验证集清单(断言快照·冻结)")
|
||||
out.append("")
|
||||
out.append("> 生成日期:%s · 基点 commit:`%s` · 源:%s" % (date.today().isoformat(), base_commit(), "、".join(src_names)))
|
||||
out.append("> 提取口径:静态 `check(` 调用点,括号配平归集(可跨行);缺省源=三宿主遍历")
|
||||
out.append("> 提取口径:静态 `check(`/`check_quiet(` 调用点,括号配平归集(可跨行);缺省源=三宿主遍历")
|
||||
out.append("> (unit/**+integration/**+system_test.gd)。本基点实测 %d 个静态调用点;行级" % len(entries))
|
||||
out.append("> `grep -c \"check(\"` 是另一口径(含 `func check(` 定义行与注释行),两口径各自浮动,")
|
||||
out.append("> 禁互相换算(tests/README「断言计数双口径」)。运行时计数大于静态计数=循环展开条目。")
|
||||
|
||||
@@ -0,0 +1,105 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""色板基线生成器——palette_check 双门②基线的建档与刷新件。
|
||||
|
||||
产出两张 1×N 条带 PNG 落 game/tests/golden/palette_baseline/(图像白名单在册目录):
|
||||
ui_tokens.png = ui_kit.gd 全量 Color8 常量唯一色值(token 板现役值快照)
|
||||
art_snapshot.png = 现役素材(game/assets/art 递归)全量唯一色快照(像素板+各屏环境子板)
|
||||
|
||||
palette_check --baseline 取目录下全部 PNG 的唯一色并集为「既有色板」;基线缺一张
|
||||
即漏判——基线刷新必须重生成全套。维护纪律:素材批收尾跑一次本器刷新并随批提交
|
||||
(新色过门②后须入基线,否则下批扫描把已过门的新色再报新增)。
|
||||
|
||||
用法:
|
||||
python tools/gen_palette_baseline.py [--repo <仓库根>]
|
||||
退出码: 0 成功 / 2 前置缺位(ui_kit.gd 或素材目录缺 / 素材零 PNG)
|
||||
"""
|
||||
import argparse
|
||||
import os
|
||||
import re
|
||||
import sys
|
||||
|
||||
from PIL import Image
|
||||
|
||||
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
|
||||
from palette_check import palette_of # 排除全透明的唯一色提取——与检查器同口径
|
||||
|
||||
|
||||
def strip_comments(text):
|
||||
"""剔 GDScript 行注释与字符串字面量,防注释里举的色值被误收进 token 快照。"""
|
||||
out = []
|
||||
for line in text.split("\n"):
|
||||
i = line.find("#")
|
||||
if i != -1:
|
||||
line = line[:i]
|
||||
out.append(line)
|
||||
return "\n".join(out)
|
||||
|
||||
|
||||
def token_cols(ui_kit_path):
|
||||
"""ui_kit.gd 全量 Color8 唯一色值集合。"""
|
||||
text = strip_comments(open(ui_kit_path, encoding="utf-8").read())
|
||||
vals = re.findall(r"Color8\((\d+),\s*(\d+),\s*(\d+)\)", text)
|
||||
return sorted(set((int(r), int(g), int(b)) for r, g, b in vals))
|
||||
|
||||
|
||||
def scan_dirs(roots):
|
||||
"""递归扫 PNG,唯一色并集(含像素位置首见序不保——并集无序)。"""
|
||||
cols = set()
|
||||
count = 0
|
||||
for root in roots:
|
||||
for dirpath, _, names in os.walk(root):
|
||||
for fn in sorted(names):
|
||||
if fn.lower().endswith(".png"):
|
||||
c, _n = palette_of(os.path.join(dirpath, fn))
|
||||
cols |= c
|
||||
count += 1
|
||||
return cols, count
|
||||
|
||||
|
||||
def write_strip(cols, out_path):
|
||||
"""1×N 条带 PNG(一色一像素列)。"""
|
||||
cols = sorted(cols)
|
||||
im = Image.new("RGB", (len(cols), 1))
|
||||
for i, c in enumerate(cols):
|
||||
im.putpixel((i, 0), c)
|
||||
im.save(out_path)
|
||||
return len(cols)
|
||||
|
||||
|
||||
def main():
|
||||
if hasattr(sys.stdout, "reconfigure"):
|
||||
sys.stdout.reconfigure(encoding="utf-8", errors="replace")
|
||||
ap = argparse.ArgumentParser(description="色板基线生成器(token∪素材快照)")
|
||||
ap.add_argument("--repo", default=".", help="仓库根(含 game/ 与 tools/)")
|
||||
args = ap.parse_args()
|
||||
|
||||
ui_kit = os.path.join(args.repo, "game", "presentation", "views", "ui_kit.gd")
|
||||
artdir = os.path.join(args.repo, "game", "assets", "art")
|
||||
outdir = os.path.join(args.repo, "game", "tests", "golden", "palette_baseline")
|
||||
if not os.path.isfile(ui_kit):
|
||||
print("[gen_palette_baseline] FAIL:ui_kit.gd 缺:%s" % ui_kit)
|
||||
return 2
|
||||
if not os.path.isdir(artdir):
|
||||
print("[gen_palette_baseline] FAIL:素材目录缺:%s" % artdir)
|
||||
return 2
|
||||
os.makedirs(outdir, exist_ok=True)
|
||||
|
||||
tcols = token_cols(ui_kit)
|
||||
n_t = write_strip(tcols, os.path.join(outdir, "ui_tokens.png"))
|
||||
|
||||
acols, npng = scan_dirs([artdir])
|
||||
if npng == 0:
|
||||
print("[gen_palette_baseline] FAIL:素材目录零 PNG(素材未同步)——拒绝生成空快照")
|
||||
return 2
|
||||
n_a = write_strip(acols, os.path.join(outdir, "art_snapshot.png"))
|
||||
|
||||
union = set(tcols) | set(acols)
|
||||
print("[gen_palette_baseline] 已生成:ui_tokens.png %d 色 / art_snapshot.png %d 色"
|
||||
"(素材 %d 张 PNG);基线并集 %d 色 → %s"
|
||||
% (n_t, n_a, npng, len(union), outdir))
|
||||
return 0
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
+11
-2
@@ -17,12 +17,21 @@
|
||||
|
||||
另:必须排除全透明像素 (0,0,0,0)(同standee_asset_check 的坑)。
|
||||
|
||||
基线(双门②「新增色 vs 既有色板」的既有色板机检承载物):
|
||||
目录 = game/tests/golden/palette_baseline/,两张条带 PNG(1×N,一色一像素列):
|
||||
ui_tokens.png = ui_kit.gd 全量 Color8 token 快照(token 板现役值)
|
||||
art_snapshot.png = 现役素材全量唯一色快照(像素板+各屏环境子板)
|
||||
两张并集=「既有色板」。缺一张即漏判——基线刷新必须重生成全套。
|
||||
门①语义检查属设计面人工核对(§4.2 色相语义判域),不在本器执法面。
|
||||
|
||||
用法:
|
||||
# 主用法:扫目录,新增色相对 --baseline 判定
|
||||
# 主用法(闸机 05b 色板闸承载):扫目录,新增色相对 --baseline 判定
|
||||
python tools/palette_check.py <目录> --baseline <基线目录>
|
||||
# 无基线:只出读数(单张色数/ 近色对计数),不判红
|
||||
python tools/palette_check.py <目录>
|
||||
退出码: 0 通过 / 1 有红灯(仅新增色违规或超单张上限时)
|
||||
# 基线建档与刷新:重扫现役素材∪token 重生成基线条带(素材批收尾动作,随批提交)
|
||||
python tools/gen_palette_baseline.py
|
||||
退出码: 0 通过 / 1 有红灯(仅新增色近色不过门②时)
|
||||
"""
|
||||
import os
|
||||
import sys
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""B3 路径核对器(圣经 §8.3② 挂点实现 · 立绘定档批 2026-10-07)。
|
||||
"""B3 路径核对器(圣经 §8.3② 挂点实现)。
|
||||
|
||||
职责:扫描 asset-path-map.md 声明的全部路径 + 代码侧素材常量,
|
||||
报「悬空(声明存在但盘上无)/ 退役未清(仍引用已退役命名)」。
|
||||
|
||||
@@ -1209,6 +1209,18 @@ def run_screen_checks(scr, zones, board_origin, frames_strip, frames_meta, s6_im
|
||||
weakest = min(ratios, key=lambda r: r[1])
|
||||
check("S1", "整屏①全部文字对直接背景 ≥4.5:1(WCAG AA)", all(r[1] >= 4.5 for r in ratios),
|
||||
"最弱 %s=%.2f;全部 %s" % (weakest[0], weakest[1], ratios))
|
||||
# S1b 意图徽标四色墨对 PANEL_DATA 垫牌 ≥4.5:1(色值对表——镜像实装同值;垫牌=ui_kit PANEL_DATA #E9D9B8,
|
||||
# 与 draw_standee 徽标垫矩形 fill 同源;四墨=意图色表 damage/buff/debuff/charge 四值)
|
||||
panel_data = (233, 217, 184)
|
||||
intent_inks = [("攻击墨", (150, 44, 36)), ("增益墨", (30, 90, 150)),
|
||||
("减益墨", (122, 66, 148)), ("蓄力墨", (116, 80, 11))]
|
||||
iratios = [(n, round((max(wcag_lum(a), wcag_lum(panel_data)) + 0.05)
|
||||
/ (min(wcag_lum(a), wcag_lum(panel_data)) + 0.05), 2))
|
||||
for n, a in intent_inks]
|
||||
iweak = min(iratios, key=lambda r: r[1])
|
||||
check("S1b", "意图徽标四色墨对 PANEL_DATA 垫牌 ≥4.5:1(WCAG AA·色值对表)",
|
||||
all(r[1] >= 4.5 for r in iratios),
|
||||
"最弱 %s=%.2f;全部 %s" % (iweak[0], iweak[1], iratios))
|
||||
# S2 整屏②明度三档带 + 世界底层两子带(§2;舞台=实测区域读数,格底=实测板面;WCAG 0–1 域)
|
||||
stage_l = _region_wcag(scr, (300, 190, 600, 220))
|
||||
bx, by = board_origin
|
||||
|
||||
@@ -413,6 +413,14 @@ if [ $QUICK -eq 1 ] || [ $NONBEHAVIOR -eq 1 ]; then
|
||||
else
|
||||
gate "05 渲染闸" "render.log" bash "$REPO/tools/render_gate.sh" "$GAME"
|
||||
fi
|
||||
# ── 5b. 色板闸(§4.1 新色双门②:素材新增色 vs 基线〔token∪素材快照〕近色判红;
|
||||
# 门①语义检查属设计面人工核对不入机检;基线刷新=tools/gen_palette_baseline.py,素材批收尾动作)──
|
||||
if [ $QUICK -eq 1 ] || [ $NONBEHAVIOR -eq 1 ]; then
|
||||
NAMES+=("05b 色板闸"); EXITS+=("SKIP"); LOGS+=("")
|
||||
echo ""; echo "[gates] 05b 色板闸 → SKIP(--quick 或 影响面选闸:素材色板面不随测量面改动开闸)"
|
||||
else
|
||||
gate "05b 色板闸" "palette.log" "$PY" "$REPO/tools/palette_check.py" "$GAME/assets/art" --baseline "$REPO/game/tests/golden/palette_baseline"
|
||||
fi
|
||||
fi
|
||||
# ══ 文档域(6–8e)══
|
||||
if in_domain docs; then
|
||||
|
||||
@@ -2,22 +2,6 @@
|
||||
|
||||
本清单是流水线的唯一登记处:以后才做的事在此登记一条,随流水线段推进改状态,做完整条删除(条目记进度,不是各段的开工前置);各系统文档的「待办」节只留一行指路存根,不再自建条目。条目格式(标题=登记元数据含可选优先级,正文=实况/缺口/改动面/状态四属性)与状态机以 [doc-conventions §12.1](design/engineering/doc-conventions.md) 为权威。
|
||||
|
||||
#### palette_check 基线建档与双门机检化(2026-11-02 登记,来源=批次移交)
|
||||
|
||||
**实况**:证据=迭代 47 实现报告 §7.2(已按吸收即死退役,git 提交 3443890d 可考)——卡④ V10 素材级读数:15 张素材 palette_check 只读模式 0 红灯 0 新增色;但 48 令牌 baseline 目录在库缺位(机检无对照基线),§4.1 两道门(语义检查+RGB 三通道差)的双门机检化缺承载。归工程改动批:建 baseline 目录+闸件双门判据落地。
|
||||
|
||||
**改动面**:工具代码
|
||||
|
||||
**状态**:待执行
|
||||
|
||||
#### ui_kit CAMP_HEADER_BAND 令牌退役评估(2026-11-02 登记,来源=批次移交)
|
||||
|
||||
**实况**:证据=迭代 47 审计记档 2 订正在案(git 提交 3443890d 可考)——营地域柜台头带消费面已随迭代 47 四柜台覆盖层退役注销(ui_contrast 令牌表四行随形态注销),现役消费面仅剩 keystone_badge 工厂与关卡屏/商店两处非营地域用途。处置口径(实现批备案):退役归 ui_kit 令牌批顺带处置、非独立强删;届时逐点核消费面后删令牌或改名。
|
||||
|
||||
**改动面**:游戏代码
|
||||
|
||||
**状态**:待执行
|
||||
|
||||
#### hobgoblin 内容三件套补齐(2026-11-01 登记,来源=审计发现)
|
||||
|
||||
**实况**:敌人表 hobgoblin 行(寻址键 (1, battle, 3))数值完整在役、战斗正常运行,但内容三件套未交付——立绘、敌种语义模板、敌人系统.md 敌种表行均缺,呈现面因语义模板未成文无定义可依。登记凭据=[敌人系统](design/gdd/systems/战斗循环/敌人系统.md) v1.1「hobgoblin 缺口登记」节(2026-10-13 迭代 24 反哺④)。
|
||||
@@ -38,22 +22,6 @@
|
||||
|
||||
**状态**:待文档设计
|
||||
|
||||
#### ui_kit.gd 立绘注释陈旧顺带换代(2026-11-02 登记,来源=批次移交)
|
||||
|
||||
**实况**:证据=迭代 48 实现报告§六与验收审计观察项(已退役,git 提交 4c94eee3 可考)——`ui_kit.gd` TEX_HERO_PORTRAIT 行注释仍写「48px 档」(现行=原稿分辨率+显示档缩放),`path_check.py` 一处注释表述也已改指外;零行为,随下次触碰该两件的批次顺带换代(顺带件,不独立出批)。
|
||||
|
||||
**改动面**:游戏代码
|
||||
|
||||
**状态**:待执行
|
||||
|
||||
#### 迭代 43 批后移交小件——能力清单补行+四色墨断言(2026-10-30 登记,来源=批次移交)
|
||||
|
||||
**实况**:证据=迭代 43 反哺点清单 9/13(已按吸收即死退役,git 历史可考)。逐条:①**能力清单补行**——game/tests/README.md 能力清单无战斗一屏样张批 V5–V9 代表用例行(卡片成文早于清单 2026-10-29 改版定稿),归写卡段随下一写卡会话按 test-conventions §8.3 补行(能力=站桩呈现定值与素材绑定;代表用例=`game/tests/unit/presentation/standee_present_values_test.gd:_init`,真实入口=`UiKit.load_tex()`/`StandeeBody.name_line_probe()`),并同步覆盖域表「战斗表现.md」行。②**意图徽标四色墨补机检断言**——样张脚本 S1 文字对比为绘图用色值对表,意图徽标四色墨(对 PANEL_DATA 垫牌)未入 CHECKS;独立审计复算 4.97–5.62 全 ≥4.5 事实成立仅缺机检断言,`tools/render_sample_sheet_v3.py` CHECKS 补一条对表断言(values 全在册,零新增色)。**2026-10-31 写卡会话落位**:①能力清单补行已随「站桩名字行提档与地台色合并批」卡片成文同批入表(能力行+覆盖域表战斗表现.md 行);②四色墨断言仍待执行。
|
||||
|
||||
**改动面**:游戏代码+工具代码
|
||||
|
||||
**状态**:待执行
|
||||
|
||||
#### 架构审查优化讨论——全库架构审计读数的逐条裁决与整改分批(2026-10-29 登记,来源=审计发现)
|
||||
|
||||
**实况**:2026-10-29 全库架构静态审计完成,读数见 reports/审计-全库架构审查-2026-10-29.md(七节:总评/健康面/P0/P1/P2/待裁点/取证口径;零测试执行零引擎运行,全部结论带 文件:行号)。健康面已逐条核干净:Core 零 UI 八项判据全零命中、core 内 RNG 单点 100% 成立、字符串式信号连接全库 0 处、core 层零超长函数、19 表 ↔ 19 schema 一一对应、无循环 preload。问题集中在三条「写了没闸守」的纪律被实际破坏:①数值单一事实源被 18 处硬编码击穿,最危险两处是 `presentation/main.gd:787` 与 `:790` 把 `rap_refresh_cost=8` 与 `refresh_cap_per_round=2` 写死进提示文案(紧邻 783 行是正确读表的),表改文案不改、玩家直接受错误数字;另有 4 组代码自标「机制结构常量/产出约束」的字面量(`node_map_generator.gd:12` `MAX_WIDTH`、`action_economy.gd:14` `CHARGE_LAYER_CAP`、`board_data.gd:9` `SPAWN_AREA_CELLS`、`node_map_generator.gd:83-94` 域字面量)是否入表待裁。②`game/sim/` 与 `game/core/` 四组平行实现——扫雷推理引擎双份(`board_generator.gd` `measure_inferability` 族 vs `auto_player.gd` `_deduce` 族,输入集口径不同:前者含 safe_set oracle、后者 no-peek)、伤害掷点期望重算(`damage_probe.gd:196-201`)、档位排序与驱动循环双份(`level_autoplay.gd` vs `treasure_item_table.gd:44` 与 `battle_driver.gd:17`)、FakeDB 伪造表喂生成器——直接威胁「模拟读数 = 游戏真实数值」这一数值验证前提。③RNG 单点纪律在 core 外失守(sim 4 处/probe 1 处/tests 3 处自建 `RandomNumberGenerator`,均显式定种、确定性尚存),而 `static_scan.sh` 的 S1/S2 扫描面只含 `DIR_CORE` + `DIR_PRES`。守卫面另有三缺口:S8 是 9 文件显式清单(新增结算文件忘登记=静默不扫,缺位自检只防删改不防增)、S9 类型闸与 S13 质量闸扫描面止步于 core+data+presentation(sim/probe/tests 三层除 S11/S12 外零闸)、S13 三处豁免常态化到最大户文件(`battle_orchestrator`/`main.gd`/`tune_sim_controller`);另有四个 core 文件零测试点名(`attune_loadout`/`battle_fx_host`/`meta_state_store`/`slot_store`)。P2 级:`core/settlement/` 五段类直读写编排器私有成员 20+ 处(`oc._damage.*`/`oc._enemy_system.*`,GDScript 无编译期检查、改名静默断裂);架构文档三处漂移(`architecture.md:110` 登记的 `core/hero_ledger.gd` 盘上不存在且 `hero_ledger_test.gd:171` 显式断言它必须不存在、`:135` 行数过期、EC8 热重载门后 `ConfigDb.reload()` 零调用方且走 `load()` 拿不到磁盘新值);class_name 级双向依赖(`core/config_db` → `data/schemas/board_gen_table` → `core/board_data.SPAWN_AREA_CELLS`)与 `NODE_TYPES` 词表双份;`MetaProgression` 是唯一用 `get_node("/root/...")` 取依赖、唯一跨 Autoload 直调的单例。
|
||||
@@ -87,14 +55,6 @@
|
||||
|
||||
**状态**:文档设计已闭合
|
||||
|
||||
#### 断言提取器改版——覆盖 Kit.check_quiet 静默通道(2026-10-29 登记,来源=会话提及)
|
||||
|
||||
**实况**:`tools/extract_checks.py:67` 的 `CALL_RE = check\(` 只认即时通道,静默收集通道 `Kit.check_quiet(cond, desc)` 静态站点实测 407 个在提取口径外(证据=`grep -rn "check_quiet(" game/tests --include="*.gd"` 实数;test-conventions §5.2 已备案该工具局限)。能力清单以 `文件:函数` 为锚,不受影响;但要把断言面全账纳入机器对账(重建账本或全量断言面审计),须先改版提取器:识别 `check_quiet(` 并按反参序(cond 在前)提取标签与 cond。改版后须以全量套件跑一遍 `--diff` 自证提取面覆盖、且 `Kit.check(` 与 `check_quiet(` 不双计。
|
||||
|
||||
**改动面**:工具代码
|
||||
|
||||
**状态**:待执行
|
||||
|
||||
#### 能力清单覆盖缺口补齐——六类无断言面或设计未定项(2026-10-29 登记,来源=会话提及)
|
||||
|
||||
**实况**:证据=`game/tests/README.md` 覆盖域表 25 篇对照行(2026-10-29 立)。以下部分覆盖/未覆盖项作为缺口指针,逐项:①增益状态——只验契约词表与布尔受理,叠层/衰减/清除结算链无断言;②设置与本地化——减动效开关本体仅系统测试与冒烟覆盖、无单元/集成断言,多语言切换面未建;③音频——MVP 无音频,P1 后置无断言面;④战斗表现——死亡灰化与减动效演出档只有探针与人工目检;⑤难度曲线与Boss——难度曲线整链与 Boss 出场门控无专项断言;⑥锻造工坊——价格梯仅长剑路线逐级验,GDD 无验收标准节(`capability_audit` 验收标准豁免在册)。教学引导与生涯两篇的缺口归各自在册条目(「教学形态未定」「「生涯」界面——冒险中数据回看的唯一承接处」),不在本条。补齐时同批刷新覆盖域表与能力行,新增断言按 test-conventions §8.4 绑真实入口。
|
||||
@@ -103,14 +63,6 @@
|
||||
|
||||
**状态**:待执行
|
||||
|
||||
#### run_all_gates 02 关联档多套件词传参修复(2026-10-31 登记,来源=批次移交)
|
||||
|
||||
**实况**:证据=iter45 实现报告 §5 遗留观察(已按吸收即死退役,git 历史可考)——`tools/run_all_gates.sh` 02 关联档以逗号连接多套件词传单个 `--only=a,b` 参数,而 `game/tests/run_all.gd` 选跑解析器不切逗号(多词整串做子串匹配→零命中 quit(2));iter45 施工时以多 `--only=` 旗标形态绕过。合回后 CI 跑全量档不经此路径不受影响,只挡开发期关联档窄跑。修法两案待裁:闸脚本改传多旗标,或解析器补逗号切分。
|
||||
|
||||
**改动面**:工具代码
|
||||
|
||||
**状态**:待执行
|
||||
|
||||
#### 战斗域结构深拆批——效果发射端口+掷格/受理分件(2026-10-31 重立,来源=批次移交)
|
||||
|
||||
**实况**:本条为 2026-10-27 原条目的重立版(原条目含宿主瘦身子项,该子项完成后随净零重立一并出清,git 历史可考)。三条同病根的结构债,需先一次设计讨论定端口形态,再谈切卡;`RewardEconomy` 的最小缝拆样本已由迭代 40 卡② 落卡。**宿主瘦身子项已完成(2026-10-30 随迭代 44 卡② 战斗编排归约批合回,合并提交 bee73db5——RoundCycle/BattleFacts 两新件建件,宿主实测 15 类变量/811 行,验收审计通过;原需求卡片与设计过程稿已按吸收即死退役,git 历史可考)。**
|
||||
@@ -126,14 +78,6 @@
|
||||
|
||||
**状态**:文档设计已闭合+已写卡+已编迭代 49
|
||||
|
||||
#### main.gd 拆件遗留死 preload 清理(2026-10-31 登记,来源=批次移交)
|
||||
|
||||
**实况**:证据=iter44 反哺点 11(已按吸收即死退役,git 历史可考;实现报告实现决定记录同载)——迭代 44 卡① 组合根注册面批拆件后,main.gd 遗留零使用 preload 常量 8 条(UiAssembler/TuneSimController/DebugSessionScript/TreasureInteractController/CurioInteractController/CampShopPresenter/BoardResolversScript/三场景 preload 中 main 零使用者三件);卡① 施工时仅清理与迁移直接相关的 ModalStack/RowPacer 两条,其余属存量债不扩范围,归工程改动直改批顺路清理。清理前须逐条 grep 复核零使用(布局批与 iter45 合回后消费面或有变化)。
|
||||
|
||||
**改动面**:游戏代码
|
||||
|
||||
**状态**:待执行
|
||||
|
||||
#### 数值标定窗口总挂账——原九条数值类条目合并(2026-10-28 登记,来源=会话提及)
|
||||
|
||||
**实况**:2026-10-28 用户令把九条数值类挂账合并为一条:削弱档位的最终数值/迭代 10 奖励重构联动欠账/调参批数值点评登记/三方向各自的解锁清单与定价/GP 经济换算失衡/天赋树实装批登记欠账余两件/商店独立刷新机制两参数/基线通关率越带加难杠杆扫描/成长系数节奏——原九条同步删除,内容全量迁入汇总文档,git 历史可考(本提交)。共同背景:M4 数值批卡已随 2026-10-16 删卡令退役;2026-10-18 用户裁=各条留待办清单、未设计未启动、不另行归属,未来数值标定窗口重开时重走设计段再写卡——本条沿用该裁定,重启条件=用户发令开窗口。合并动机=九条共享同一重启条件与同一执行形态(窗口内一次 MC 批量统一覆盖各条对比需求:全冒险期望+奖励期望),分散登记徒增维护面。逐条挂账明细、裁定史与相关文档见汇总文档。
|
||||
|
||||
Reference in new issue
Block a user