docs(06): 登记「代码注释禁用词清扫批」条目(工程直入)

来源=会话提及,设计面=工程直入——凭 2026-10-19 全量扫描的可复核实测读数
(范围 game/ 195 文件;口径=剔除对照性/历史文本行)跳过设计轨。

现状登记三组事实:
- 确定违规(术语表「退役词对照」在册,落于代码注释面):板级 26/门票 38/
  正主 12(含误报 1)/落籍 10(含历史注记 1,不追改)
- 含「雷」字面 16 处,其中 3 处为玩家可见文案,违反术语表「对外命名纪律」
- 已核实清零(迭代 31 成果):金币/插旗/标旗/雷格/惩罚格/旗 均为 0

根因:迭代 31 卡① 完成判据 V4 只覆盖四词,排雷/雷族未入判据;且机检闸
doc_term_audit.py 的 DEFAULT_DIRS 只含 design/gdd,代码注释面从未进闸。

上游依据=2026-10-19 用户裁:完美排雷全库统一换代为「完美封印」(含代码
内部注释),据此推翻 需求卡片-凭证件裁削批:108「内部开发用语按 v3.15 纪律
保留」半句,该卡片条款订正归文档轨批。
This commit is contained in:
DKChan committed 2026-10-20 00:12:57 +08:00
1 parent b2327eb9ce
commit 6e04fa60f6
1 file changed
+16
+16
View File
@@ -675,3 +675,19 @@
**归属**:①`奇物.md` §1.1/§2.2/v2.2 行(已订正写入文档);②`奇物.md` §1.3(:121/:223/:229)与 `02-系统清单.md:49`(待裁)
**状态**:已写入(design/gdd/systems/冒险循环/奇物.md v3.19——第①项专长凭证归类订正)+待裁决(第②项资源判据句,心智模型未对齐,不列候选不提前处置)
---
#### 代码注释禁用词清扫批——退役词换代+完美排雷统一为完美封印(2026-10-20 登记,来源=会话提及,设计面=工程直入)
**现状**:2026-10-19 全量扫描 `game/`(195 个文件:.gd/.tres/.md/.json/.sh/.txt)的可复核实测读数,口径=剔除含对照性/历史信号的行后计「疑似现行残留」。
**确定违规**(术语表「退役词对照」在册,落于代码注释面)=`板级` 26 处/`门票` 38 处/`正主` 12 处(含 `tests/unit/battle_settlement/damage_math_test.gd:36`「正主角池」误报 1 处)/`落籍` 10 处(含 `data/tables/enemy.tres:653` 带 commit 号的历史注记 1 处,不追改)。
**含「雷」字面**(违反术语表「对外命名纪律」——「雷」及相关字面禁入对外命名,适用范围含 UI 文案)=`完美排雷` 16 处,其中 **3 处为玩家可见文案**:`core/battle_orchestrator.gd:925` `"完美排雷!清图奖励 ×2"`、`presentation/views/board_fx_view.gd:102` `_show_banner("完美排雷 ×2")`、`presentation/views/battle_log_view.gd:194` `"(本板完美排雷已破——归因此封印)"`(末条 `design/qa/文案审查报告-2026-10-18.md:150` 已判病句,至今未修)。
**根因**:迭代 31 卡① 完成判据 V4 只覆盖「金币/插旗/雷格/惩罚格」四词(+旗族),`排雷`/`雷`族未入完成判据;且机检闸 `tools/doc_term_audit.py` 的 `DEFAULT_DIRS = ["design/gdd"]`,**代码注释面从未进闸**——不清根则同类残留持续复发。
**裁定(2026-10-19 用户)**:完美排雷**全库统一**换代为「完美封印」,含代码内部注释。本裁**推翻** `需求卡片-凭证件裁削批`:108「内部开发用语按 v3.15 纪律保留」半句,该卡片条款订正归**文档轨批**,代码批照本裁执行。
**移交(不属本批)**:`game/data/tables/shop.tres:86` display_name「奇物门票」、`game/presentation/curio_interact_controller.gd:165-166`「开一次奇物三选一」——两处属 奇物/专长 归类表述,与 06「2026-10-18 冒记案遗留待裁两项」第①项同源,交文档侧先定性,定后另走传导批。
**不做(待用户另裁)**:术语表 A 表词(`不得` 14/`报错` 18/`对标` 1/`若干` 1/`buff` 22——后者绝大多数是标识符与数据键)、doc-conventions 第 4 节流程动词(`收口` 128/`随批` 20/`台账` 17/`对拍` 16/`在飞` 10/`落文` 2)、简明技术中文(STC)通用禁用词(`缺省` 105/`情况` 26/`入参|出参` 23/`比较|较为|相对` 22 等)。
**归属**:game/ 代码与数据表(代码域,走独立 worktree 批;并行避让——`changelog-retire-20261019` 在盘未合回且正在改 `AGENTS.md` 与 `design/dev/code-conventions.md`,本批禁碰这两个文件,S11 规则说明自持于 `game/tests/static_scan.sh` 头注与 `game/tests/README.md`)
**状态**:待写卡