docs(术语): 设计文档术语刷新批全量入库——2026-10-18 用户裁定（金币/插旗/旗/雷格/惩罚格五词）design/+tools/ 域落文

- 术语表 v1.13：GP 唯一正式命名（删「局内金币」别名）＋旗/控制词条更名封印/控制＋封印定性由「插旗的对外表达」更正为正式动作名（全库统一、非比喻）＋禁用字面从对外命名扩为全库＋删「机制文档内部用语不受限」条款＋退役词对照表补三行（金币→GP/插旗→封印/旗→封印印记）＋危险格词条「被旗控制」→「被封印控制」＋B3 豁免例举去旗 - 机检扩容 tools/doc_term_audit.py：RETIRED_TERMS 新增金币→GP、插旗|标旗→封印两行（DEFAULT_DIRS 不变，game/ 扫描归代码批）；拔旗|撤旗行继任措辞随批换代（插旗不可逆→封印不可逆） - GDD 全域正文换代约 200 行/31 文件：金币→GP（金币袋→GP 袋）、插旗/标旗→封印、雷格/惩罚格→危险格（2026-10-11 退役批存量补扫）、旗概念→封印印记（旗判定→封印判定/标中旗→封印标中/标错旗→标错封印/旗格→封印格/旗位→封印位等复合词系）；00-游戏概念「封印降级为类型风味词」定性翻转；修订记录/版本历史/禁令引举/更名记载等留档行零动 - registry/entities.yaml（信标网络可达性/事件序/回执驱动三处）＋art 五件（art-bible 封印印记六处/comfyui 背旗→背负封印印记/两清单）＋dev 七件（architecture 旗集→封印集/code-conventions-cases/test-conventions/架构图 html json 四件）随批换代 - tools 四脚本注释与图内标注换代（clear_dominance_audit/render_sample_sheet×2/analyze_playtest；代码标识符零动归代码批） - design/qa/代码术语审计报告-2026-10-18.md 随批入库（本批参考素材，06:578 引用闭合 doc_link 死链） - 06-待办清单/术语表两在途脏件（代码术语批 06 登记＋A 表头「不用→禁用」）随批一并入库自检：doc_term_audit --strict 零疑似现行（45 文件 434 命中全留档类）；文档域六闸验收通过无新增红（gdd_lint R3 对 00 正文修订注记一次打回已去注记化改写；doc_link 死链经报告入库闭合）；正文残留仅 06:73「拔旗」一处（件派生动词白名单豁免语境、机检同款豁免，设计意图记录不动）
2026-10-18 06:15:38 +08:00
1 parent 89fb640586
commit bbd49abfb0
@@ -0,0 +1,120 @@
+# 代码术语审计报告
+
+日期：2026-10-18
+触发：用户裁定——GP 是唯一正式命名（「金币」系 AI 噪音）；「插旗」全库禁用（正式名=封印）；「旗」概念不存在；「雷格」「惩罚格」已退役（正式名=危险格）
+
+---
+
+## 1. 裁定摘要
+
+| 禁用词 | 正式替代 | 裁定依据 |
+|--------|---------|---------|
+| 金币 | GP | GP 是唯一正式命名，「金币」系 AI 产出噪音，不应存在于任何位置 |
+| 插旗 | 封印 | 游戏中不存在「旗」概念，右键动作=封印 |
+| 旗（作为游戏概念） | 封印印记 | 同上——「不存在任何旗相关的东西」 |
+| 封印（作为比喻解释） | 封印（作为正式术语） | 封印是正式动作名，不是比喻；禁止以「比喻」框架描述 |
+| 雷格 | 危险格 | 2026-10-11 已裁退役 |
+| 惩罚格 | 危险格 | 2026-10-11 已裁退役 |
+| flag_*（代码键名） | seal_* | 用户裁定全换 |
+
+---
+
+## 2. 命中统计
+
+| 禁用词 | 命中次数 | 涉及文件数 |
+|--------|---------|-----------|
+| 金币 | 116 | 44 |
+| 插旗 | 210 | 61 |
+| 雷格 | 109 | 31 |
+| 惩罚格 | 8 | 4 |
+| flag_（.gd） | 270 | 29 |
+| flag（.tres） | 22 | 4 |
+| flag（独立词 .gd） | 22 | 10 |
+| **合计** | **~757** | **~100+（有重叠）** |
+
+注：「封印」现有 170 处命中（46 文件），其中大部分是正确用法（封印=正式术语），但部分语境把它当「比喻」或「对外表达」描述，需修正措辞。
+
+---
+
+## 3. 分域明细
+
+### 3.1 玩家可见文本（P0 最高优先级）
+
+UI 字符串、toast、tooltip、display_name、desc 字段中出现的禁用词：
+
+| 文件 | 行 | 内容 | 问题 |
+|------|-----|------|------|
+| game/presentation/views/shop_overlay_view.gd | 51,101,109,174,191 | `"金币 0"` / `"金币 %d"` / `"现价 %d 金币"` / `"刷新 %d 金币"` | 金币→GP |
+| game/presentation/camp_shop_presenter.gd | 180,190,202 | `"金币不足——买不起这件商品"` / `"金币不足——刷新失败"` | 金币→GP |
+| game/presentation/curio_interact_controller.gd | 192 | `"金币不足——刷新失败"` | 金币→GP |
+| game/presentation/battle_narrator.gd | 24,114 | `"商店房：金币 %d"` / `"金币袋%s\n金币 +%d"` | 金币→GP |
+| game/presentation/views/curio_pick_overlay.gd | 122,124 | `"刷新 %d 金币"` / tooltip 含「金币」 | 金币→GP |
+| game/presentation/views/legend_overlay.gd | 14 | `"金=金币"` | 金币→GP |
+| game/presentation/hud_presenter.gd | 169 | `"不能插旗：此格已有旗"` | 插旗→封印，旗→封印印记 |
+| game/presentation/main.gd | 967 | `"插旗后轮末自动判定标中"` | 插旗→封印 |
+| game/presentation/views/legend_overlay.gd | 9,11 | `"右键插旗（1AP）"` / `"封印印记（呈现名·不能拔）"` | 插旗→封印 |
+| game/data/tables/treasure_items.tres | 212 | `"插旗不限相邻"` | 插旗→封印 |
+| game/data/tables/reward.tres | 188 | `"display_name": "金币袋"` | 金币袋→GP 袋（或用户定名） |
+| game/data/tables/feats.tres | 多处 | desc 含「封印」 | 需逐条核验语境（非比喻即合法） |
+| game/tests/unit/presentation/reward_overlay_test.gd | 31,49 | `"金币袋\n金币 +20"` / `"刷新 20 金币"` | 测试断言里的 UI 文本 |
+
+### 3.2 代码注释与内部文档（P1）
+
+约 500+ 处分布在 .gd 注释、game/README.md、design/registry/entities.yaml、design/gdd/ 各系统文档中。主要模式：
+
+- `# 挖雷格/标错旗` → `# 挖危险格/标错封印`
+- `# 插旗不可逆` → `# 封印不可逆`
+- `# 雷格恒无变异` → `# 危险格恒无变异`
+- `# 金币袋兑付` → `# GP 袋兑付`
+- `flag_place` / `flag_hit` / `flag_cell` / `has_flag` / `tex_flag` → `seal_place` / `seal_hit` / `seal_cell` / `has_seal` / `tex_seal`
+
+### 3.3 代码标识符（P1，影响面最大）
+
+flag_* 族标识符 270 处（29 个 .gd 文件）+ 22 处（.tres），涉及：
+
+- 核心逻辑：minesweeper_rules.gd(18)、battle_orchestrator.gd(17)、grant_segment.gd(23)、effect_engine.gd(9)
+- 数据表：action_economy.tres(2)、feats.tres(15)、settlement.tres(3)、treasure_items.tres(2)
+- Schema：settlement_table.gd(3)、treasure_item_table.gd(3)、action_economy_table.gd(4)
+- 呈现层：board_view.gd(7)、battle_end_overlay.gd(9)、ui_input_probe.gd(23)
+- 冒烟/测试：smoke_all.gd(105)、level_autoplay.gd(16)、各 test 文件
+
+### 3.4 设计文档（P1）
+
+design/gdd/ 和 design/registry/ 中约 200+ 处，需随术语表修正同步更新。
+
+### 3.5 历史文档（P2）
+
+design/research/（提案、需求卡片）、design/qa/（审查报告）、design/art/（美术文档）中的命中：
+- 历史提案和已结案需求卡片：留档不改（记录当时语境）
+- 美术文档中的「封印旗」「封印特效」：需逐条核验（封印合法，旗不合法）
+- roadmap.md：历史条目留档
+
+---
+
+## 4. 术语表自身修正清单
+
+术语表（design/gdd/术语表.md）需按新裁定修正的条目：
+
+| 行 | 现行内容 | 问题 | 修正方向 |
+|----|---------|------|---------|
+| 14 | `旗 / 控制` 条目 | 「旗」概念不存在 | 改为「封印 / 控制」，删除「旗插在危险格上」措辞 |
+| 28 | `GP（局内金币）` | 「金币」是噪音 | 改为 `GP`，删除「金币」别名 |
+| 126 | `雷格 / 惩罚格 → 危险格` | 对照行，合法 | 保留 |
+| 138 | `禁用字面：「雷」「插旗」…禁止进入对外命名` | 范围不够——插旗应全库禁用，不只是对外命名 | 扩大为全库禁用 |
+| 139 | `插旗的对外表达 = 封印` | 封印不是「对外表达」，是唯一正式名 | 改为「封印=正式术语（全库统一）」 |
+| 154 | v1.6 修订记录「插旗对外=封印…机制文档内部用语不受限」 | 内部用语也禁用 | 修正 |
+
+---
+
+## 5. 风险评估
+
+- **flag_* → seal_* 重命名**是最高风险项：涉及核心游戏逻辑（排雷规则、战斗编排、结算授予段），改错会破坏游戏行为。必须全量冒烟通过。
+- **.tres 数据文件**中的 flag 键名改动需与 schema 同步，否则数据加载失败。
+- **smoke_all.gd 单文件 105 处 flag_**，是改动密度最高的文件。
+- 中文文本替换风险较低，但量大面广，需防漏改和误改（如「旗」字在非游戏语境出现）。
+
+---
+
+## 6. 建议拆批
+
+见同目录需求卡片：`design/research/需求卡片-代码术语刷新批-2026-10-18.md`