From c162fca9ad00b838d1cf352e2ec2ecc212177025 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Wed, 21 Oct 2026 17:05:22 +0800 Subject: [PATCH] =?UTF-8?q?chore(=E5=BC=95=E7=94=A8=E5=8F=AF=E6=A0=B8?= =?UTF-8?q?=E9=97=B8=E5=BB=BA=E6=A1=A3=E6=B3=A8=E5=86=8C):=20=E8=BF=BD?= =?UTF-8?q?=E5=8A=A0=E8=A1=8C=E5=88=A0=E9=99=A4=E5=90=8E=E7=9A=84=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E5=85=B3=E8=81=94=E9=9D=A2=E6=B8=85=E5=87=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - game/tests/README.md：静态扫描段 S1–S11 → S1–S12（S12 旧件零残留闸缺登记，补一段实现说明）； S11 说明句删去「显式追加『完美封印』」——该追加行已删，且原句连词名都写错（被禁的是「完美排雷」）； 改后写明禁词全由术语表第一列解析供给、脚本内不内联词面； 「规则全集见 architecture.md」指针句加限定：S1–S10 在架构文档，S11／S12 自持于本文件与脚本头注（迭代 32 两卡为代码批禁写 design/） - 待办清单：「game/ 域文档两处措辞订正欠账」整条删除（未净项已由用户合入完成）； 「效果引擎系统无状态原则缺架构文档条目」现状里指向已删条目「计数器寿命域未统一」的悬挂指路句改写成凭据句 --- game/tests/README.md | 12 ++++++++---- 待办清单.md | 13 +------------ 2 files changed, 9 insertions(+), 16 deletions(-) diff --git a/game/tests/README.md b/game/tests/README.md index d8b03037..d2d6abb2 100644 --- a/game/tests/README.md +++ b/game/tests/README.md @@ -15,7 +15,7 @@ tests/ smoke/ # critical-paths.md——人工 gate 清单（/smoke-check 读取） evidence/ # 截图与人工签核记录 run_all.gd # 单元套件统一入口（套件 manifest 协议，D2 AC-2b） - static_scan.sh # 静态扫描域 S1–S11 可执行子集 + static_scan.sh # 静态扫描域 S1–S12 可执行子集 ``` ## 测试三层与承载目录 @@ -109,10 +109,14 @@ timeout 120s godot --headless --script tests/run_all.gd ## Static Scan（提交前本地跑） -`tests/static_scan.sh` 实现静态扫描域 S1–S11 的可执行子集；规则全集与动机见 -`design/engineering/architecture/architecture.md`「测试与质量域」节。新违规案例必须**先补扫描规则再修码**。 +`tests/static_scan.sh` 实现静态扫描域 S1–S12 的可执行子集；S1–S10 的规则全集与动机见 +`design/engineering/architecture/architecture.md`「测试与质量域」节，**S11／S12 两段的规则说明自持于本文件与 +`tests/static_scan.sh` 头注**——迭代 32 两卡是代码实现批，按流水线红线禁写 `design/`，故这两段未进架构文档。 +新违规案例必须**先补扫描规则再修码**。 -S11 代码注释禁用词：扫描 game/ 全域 .gd/.tres/.md/.json/.sh 的注释面，词表从 `design/gdd/术语表.md`「退役词对照」解析（显式追加「完美封印」，排除「巢穴」「旗」）；三层豁免（闸门自指／显式留档 4 处／非注释面天然不取）；两道自检（扫描面文件数非空＋词表解析非空）。 +S11 代码注释禁用词：扫描 game/ 全域 .gd/.tres/.md/.json/.sh 的注释面；禁词全部由 `design/gdd/术语表.md`「退役词对照」第一列解析供给（脚本内不内联任何词面——单一事实源）；解析结果再按「巢穴」「旗」「flag_*」三条整行排除；三层豁免（闸门自指／显式留档 4 处／非注释面天然不取）；两道自检（扫描面文件数非空＋词表解析非空）。 + +S12 效果引擎无状态化旧件零残留：扫描 game/ 全域 `.gd` 与 `game/data/tables/*.tres`，禁已删符号（`counters_export`／`counters_seed`／`_reset_tree_limited_counters` 等）与带引号的旧计数器 id 字面（引号锚定，不误伤 `adv_`／`round_` 前缀新名）；扫描面文件数为零即判红。 ## 本地闸（唯一验收门禁） diff --git a/待办清单.md b/待办清单.md index a0eff9b8..ba0d2752 100644 --- a/待办清单.md +++ b/待办清单.md @@ -692,7 +692,7 @@ #### 效果引擎「系统无状态」原则缺架构文档条目（2026-10-20 登记，来源=会话提及，设计面=文档轨） -**现状**：用户 2026-10-19 会话裁定的 ECS 架构依据（系统无状态——效果引擎这类系统零运行时可变状态、数据由宿主对象持有并随宿主生灭、状态按参数传入系统、系统只做判定）是「效果引擎无状态化」重构批的立项判据（上游条目=本清单「计数器寿命域未统一」，提案=reports/提案-效果引擎无状态化-2026-10-19.md v1.3 §7.9 #1），但 `design/engineering/architecture/architecture.md`「架构原则」节（原 7 条）无「系统无状态」条目——立项判据暂无权威文档出处（2026-10-19 全仓检索「无状态／纯计算」零命中，提案 §10.3 实查；原 `design/registry/` 两 yaml 已随 2026-10-19 用户裁注销删除，无可迁凭据）。重构批是代码批、禁写 `design/`，文档级补条只能另立文档批。 +**现状**：用户 2026-10-19 会话裁定的 ECS 架构依据（系统无状态——效果引擎这类系统零运行时可变状态、数据由宿主对象持有并随宿主生灭、状态按参数传入系统、系统只做判定）是「效果引擎无状态化」重构批的立项判据（上游＝迭代 31 卡② 移交的计数器寿命域判据线——该登记条目已在本条闭合时整条删除，判据现由 architecture.md v1.9 条 8 承载；提案=reports/提案-效果引擎无状态化-2026-10-19.md v1.3 §7.9 #1），但 `design/engineering/architecture/architecture.md`「架构原则」节（原 7 条）无「系统无状态」条目——立项判据暂无权威文档出处（2026-10-19 全仓检索「无状态／纯计算」零命中，提案 §10.3 实查；原 `design/registry/` 两 yaml 已随 2026-10-19 用户裁注销删除，无可迁凭据）。重构批是代码批、禁写 `design/`，文档级补条只能另立文档批。 **现状换代（2026-10-21 文档批写入完成）**：architecture.md「架构原则」节已补第 8 条「系统无状态」（条文序位=呈现层契约成文条之后，与条 1 核心层纯逻辑、条 5 fail-fast 交叉核过无冲突），effect_engine 模块行与战斗域装配节同步改写为 ctx 形态描述——design/engineering/architecture/architecture.md v1.9（2026-10-21 用户裁写入）。 @@ -722,17 +722,6 @@ --- -#### `game/` 域文档两处措辞订正欠账（2026-10-21 登记，来源=批次移交，设计面=工程直入） - -**现状**：标题里的「两处」是 2026-10-21 登记时的原述（标题属登记元数据不改）。当日用户手工提交批已清三处纯文字面——`game/tests/static_scan.sh:100` S11 词表来源注释、`game/tests/README.md:58` 套件数（26 → 35，按 `_suites()` manifest 实数）、`game/tests/README.md:81`／`:92` 两处 `design/qa/` 死指（分别改指跑批回执＋`reports/` 与 `sim-data/`）。**本条唯一未净项**＝`game/tests/static_scan.sh:122` 的 `printf `'完美排雷' -' >> "$S11_WFILE" 追加行：该词自 2026-10-21 已入术语表「退役词对照」，追加行成为冗余（`sort -u` 去重后行为不变）。删它属改闸件词表本体、非纯文字订正，留待下一个触 `game/` 的代码批一并清；注释行已写明这个状态。 - -**归属**：`game/tests/`（代码域，剩余项随下一个触碰 game/ 的批次顺带清） - -**状态**：待写卡〔用户特批 2026-10-21 跳过代码域闸〕 - ---- - #### 迭代 32 移交项一——奇物门票三处玩家文案待定性后传导（2026-10-21 登记，来源=批次移交，设计面=文档轨）