docs(glossary): 术语表建立+全库术语统一批——危险格/整图/专长凭证(2026-10-11 用户四裁)+秘宝.md v2.5 可读性审查批

- 新建 design/gdd/术语表.md v1.0(四节术语+退役词对照;02 清单登记;用户令查表阅读)
- 全库更名:雷格/惩罚格→危险格(113 处)、雷安→危险格与安全格(39)、板级→整图(29)、门票→专长凭证(88)、雷位→危险格位置(5);排雷玩法定义句换代+版本行
- 秘宝.md v2.5 可读性批:术语指路+黑话清扫(正主/落籍/P1甲死指针/charges/结构闸等)+承重契约白话化+验收分层白话化+两处过时事实修正(战斗道具窗口 2026-09-15 已下线/21 项义务死指针)+版本行序修复
This commit is contained in:
DKChan committed 2026-10-11 03:56:12 +08:00
1 parent ee99badb95
commit 6951632d25
34 files changed
+258 -190

No files matched your search

@@ -75,7 +75,7 @@ BoardView(`presentation/views/board_view.gd`,现 extends Control + 内部 Gr
**A 区退场形态(2026-09-23 追问裁定)**:LevelStripView **退役,不迁移**;关卡画面**不重新实现**——由 RouteOverlay(整幅节点图选路层,节点态色板语义与压缩条同族、候选按钮与放弃入口在役)升级为常驻页面承接。压缩条唯一存在理由(战斗屏无整图时的常显替代面)随零进度裁定消亡,无独有资产流失;唯一继承面 = 逻辑层节点数据面(runner 只读出口零改动)。退役删除面清单见迁移方案 §1。
**3. 命中测试 = 板级公式换算单点,非逐格 Area2D。**
**3. 命中测试 = 整图公式换算单点,非逐格 Area2D。**
鼠标输入经 BoardView 壳层 `_gui_input` 接收(Control 已有的矩形命中),格坐标 = `floor(local_pos / 格边长)` 单点公式换算——悬停/点选/双击 chord/长按全部复用现有逻辑入口。不为 144 格建 Area2D(节点开销无必要,Alternative 2 论据沿用);ADR-0003 登记的「自建命中测试」成本由此收敛为一个公式函数。无障碍面缺失为接受后果(沿 ADR-0003 Decision 3 已登记口径,键盘寻格体系延后)。
@@ -99,7 +99,7 @@ Phase B 届时将 BattleStageView 同构改造(PanelContainer → Control 壳
### Alternative 3: 逐格 Area2D 承载命中
- **Cons**: 144 个 Area2D 节点开销与信号接线量;命中语义(相邻约束/chord/长按)仍要自建。
- **Rejection Reason**: 板级公式换算单点已覆盖全部交互语义,物理命中是纯开销。
- **Rejection Reason**: 整图公式换算单点已覆盖全部交互语义,物理命中是纯开销。
### Alternative 4: TileMapLayer 承载棋盘
- **Rejection Reason**: ADR-0003 已否(瓦片语义与变体标记/数字/旗多层叠加不匹配),维持。
+2 -2
View File
@@ -122,12 +122,12 @@
| 概念即对象 | 核心概念各自独立成体,有规范名、有属性、有规则边界;下笔前先能用一句"它是谁、它管什么"说清,说不清就是还没想完 |
| 属性归属唯一 | 每个属性只归一个概念——离开 A 就没有意义的属性写在 A 名下,禁止上提给容器、也不下压给成员 |
| 包含关系显式写 | 容器与成员的关系明文写出谁是容器、谁是成员、一对几(例:棋盘包含多个格);禁止让读者从散文里反推结构 |
| 概念状态用枚举 | 概念的类型与状态写成封闭枚举并列全成员(例:格的类型 = 安全格 / 雷格,格的状态 = 未开 / 已开);禁止用散文形容词零散罗列状态 |
| 概念状态用枚举 | 概念的类型与状态写成封闭枚举并列全成员(例:格的类型 = 安全格 / 危险格,格的状态 = 未开 / 已开);禁止用散文形容词零散罗列状态 |
| 附加物独立成对象 | 挂在概念上的附加内容若自己有一组属性或规则要写(例:格上的奖励/惩罚 = 格面资源),就是独立对象——父概念只保留挂载位(如"有无资源资格"),禁止把附加物摊平成父概念的一堆属性字段 |
| 关系不吸内容 | 概念间关系只写"有没有关系、是什么关系";对方的属性与规则留在对方名下——与第 8 节"引用不转述"同源 |
| 落位五要素 | 概念的正主文档必须写全五要素:**定义**(它是什么)/ **作用对象与范围**(作用在谁、什么范围内有效)/ **生命周期**(何时出现、何时变化、何时消失、怎么重置)/ **关联**(与谁衔接、边界归谁、哪些指路别处)/ **状态**(已定稿/待实施/已退役)。缺任何一项都是半成品概念,如同对象缺了构造函数(2026-09-30 微光口径事故后补成) |
**切分正例**(现行排雷循环即按此切分):棋盘是地图级对象,包含多个格;格是成员对象,雷格/安全格是它的枚举属性;格上可能挂的奖励或惩罚(格面资源)是独立对象,本体与规则归地图战斗资源与战斗结算,格只保留"有无资源资格"一个挂载位。反面基准:把奖励的类型、数值、极性全摊开写成格子的属性字段——奖励规则一改,棋盘文档就得跟着改,这便是没封装。
**切分正例**(现行排雷循环即按此切分):棋盘是地图级对象,包含多个格;格是成员对象,危险格/安全格是它的枚举属性;格上可能挂的奖励或惩罚(格面资源)是独立对象,本体与规则归地图战斗资源与战斗结算,格只保留"有无资源资格"一个挂载位。反面基准:把奖励的类型、数值、极性全摊开写成格子的属性字段——奖励规则一改,棋盘文档就得跟着改,这便是没封装。
**无正主,不下定义**:一个概念还没有正主文档时,任何其他文档都不得替它下定义——只能引用概念名,并在 06-待办清单登记「待落位」;谁先立正主,谁拿走全部定义权。(2026-09-30 微光事故:类型微光长期无正主文档,art-bible 复述、06 登记、需求卡片摘要三处各自给出口径,范围限定词在层层复述中丢失,最终放大成「全板常显」的错误事实。)