merge(追加行文档关联面清净): README 静态扫描段补 S12 与 S11 词源订正＋待办清单欠账条目整条删除与悬挂指路句改写（回执 commit=c162fca9）
This commit is contained in:
DKChan committed
commit
bfb23bedb3
2 files changed
+9
-16
No files matched your search
@@ -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_` 前缀新名）；扫描面文件数为零即判红。
|
||||
|
||||
## 本地闸（唯一验收门禁）
|
||||
|
||||
|
||||
@@ -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 登记，来源=批次移交，设计面=文档轨）
|
||||
|
||||
|
||||
Reference in new issue
Block a user