Merge branch 'termsweep-20261026'：魔法道具/罕见旧词清扫＋退役词表防再犯（--docs 域闸绿，回执 3ef62cfb）
This commit is contained in:
DKChan committed
commit
a4129b1d9b
7 files changed
+14
-18
No files matched your search
@@ -159,4 +159,4 @@
|
||||
|
||||
**获取概率提升**是元进度/营地的合法提升轴（可提升=奇物高档位出现率/秘宝解锁进度/地图 T3/T4 权重），但**不动保底**——保底是承诺不是概率，禁止任何概率件改变 T3「每板必有回复」类承诺。
|
||||
|
||||
**专长 rarity 语义约束**：Boss 三选一候选按档配比或加权抽取，使罕见度对出现率生效（字段双脱钩修复——此前 rarity 不影响抽选也不稳代表幅度）；具体配比归调参批。
|
||||
**专长 rarity 语义约束**：Boss 三选一候选按档配比或加权抽取，使稀有度对出现率生效（字段双脱钩修复——此前 rarity 不影响抽选也不稳代表幅度）；具体配比归调参批。
|
||||
@@ -77,7 +77,7 @@
|
||||
| `interaction-patterns.md` | 交互 pattern 库：核心 8 成文 + 目录 20 条 | Complete |
|
||||
| `level-clear.md` | 关卡结算屏 UX spec：大奖励三件套兑付与钥石/GP 结算呈现 | 义务锁定版·视觉终稿后置 |
|
||||
| `level-map.md` | 关卡画面 UX spec：选路枢纽独立屏三停点布局、GP 常驻徽章、底栏状态栏 | 定稿版·独立屏+视觉终稿已冻结 |
|
||||
| `node-reward.md` | 节点奖励屏 UX spec：奖励节点提升三选一选择面、六种令牌池与刷新双源（与商店货架同库；通关三选一候选=纯专长，见 level-clear） | v2.5·令牌池在役 |
|
||||
| `node-reward.md` | 节点奖励屏 UX spec：奖励节点提升三选一选择面、七种令牌池与刷新双源（与商店货架同库；通关三选一候选=纯专长，见 level-clear） | v2.9·令牌池在役 |
|
||||
| `settlement-summary.md` | 结算总结 UX spec：战斗总结结算（战斗胜利面）与冒险总结结算（冒险终结面）——两面分节的纯呈现轻量 spec | v1.2·纯呈现已实装面成文 |
|
||||
| `camp.md` | 营地场景 UX spec：可点击场景图与七物件点选、钥石余额、各功能界面入口（存档级/局外呈现面） | v1.1 |
|
||||
| `shop.md` | 商店覆盖层 UX spec：令牌级货架（与三选一同池）、GP 余额与付费刷新、购买/离开（中循环节点兑付呈现面） | v1.1 |
|
||||
|
||||
@@ -97,7 +97,7 @@
|
||||
| T1 攻击类 | attack / blast / pierce / magic | 最高 | 0 | 无 |
|
||||
| T2 增益类·GP 小袋 | defense / weaken / 小 GP 袋（gp） | 中 | 0 | 无 |
|
||||
| T3 回复（可保底档） | heal（将来可扩） | 低 | 1 | heal = 每板 ≥1 |
|
||||
| T4 惊喜类（永不保底档） | action / 大宝箱（大额 GP，枚举新增归实装批）/ 未来稀有型 | 极致罕见 | 0 | 永不登记 |
|
||||
| T4 惊喜类（永不保底档） | action / 大宝箱（大额 GP，枚举新增归实装批）/ 未来稀有型 | 出现概率极低 | 0 | 永不登记 |
|
||||
|
||||
- **档由两个参数定义：概率位 + 保底上限**。「永不保底」不单立规则——T4 的保底上限 = 0 即其统一表达；T1/T2 上限同为 0。
|
||||
- **保底数量挂在型上、不挂在档上**：每个型各自登记「每板至少出几个」。档内登记保底的型数 ≤ 档上限 → 全部兑现；> 上限 → 每板从登记型中随机选定「上限」个兑现，其余型该板按普通概率出现、不保底。
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
# 节点奖励屏 UX spec（node-reward）
|
||||
|
||||
> 状态：v2.8（池与交互形态同 v2.4；头部文案与现行渠道分离对齐）
|
||||
> 状态：v2.9（池与交互形态同 v2.4；档名对齐四级档位框架、配额对齐现行结构锚）
|
||||
> 事实源：`game/presentation/views/curio_pick_overlay.gd`（三选一覆盖层共用面）+ `main.gd`（奖励节点分支——`adventure.node_bonus_candidates/apply_node_bonus`）+ `battle_narrator.gd`（node_bonus_header）
|
||||
> 相邻：[level-clear](level-clear.md)（通关三选一面——同一覆盖层的另一上下文）/ [level-map](level-map.md)（关卡画面）/ [秘宝](../systems/跨局循环/秘宝.md)（道具件内容权威——本批起为局外同调件，不再入三选一牌库）/ [冒险结构](../systems/冒险循环/冒险结构.md)（共享池令牌库账本）
|
||||
|
||||
## 定位
|
||||
|
||||
奖励节点（reward node）到达即开的**提升三选一选择面**：**七种×档位**令牌池（攻击/生命上限/护甲/GP 袋/行动点件/恢复件/刷新件 × 普通/稀有/罕见——v2.2 起秘宝件随同调批退役出池；v2.4 起=固定配额令牌池；刷新件随迭代15② T6 入池〔稀有 2，恢复件同批挤占收窄——adventure_table CURIO_KINDS 第七类〕），与商店货架同库同账（v2.3）、同池耗语义、同 reward_pick 封闭流。**通关三选一自迭代 15② 渠道分离起候选 = 纯专长，与本面不再同池**；与通关面的差异另在上下文：无部分回血、无钥石增量行，兑付后「继续」回图选路（不推进关卡）。
|
||||
奖励节点（reward node）到达即开的**提升三选一选择面**：**七种×档位**令牌池（攻击/生命上限/护甲/GP 袋/行动点件/恢复件/刷新件 × 普通/优秀/稀有（+传说头奖位留空）——v2.2 起秘宝件随同调批退役出池；v2.4 起=固定配额令牌池；刷新件随迭代15② T6 入池〔稀有档 2，恢复件同批挤占收窄——adventure_table CURIO_KINDS 第七类〕），与商店货架同库同账（v2.3）、同池耗语义、同 reward_pick 封闭流。**通关三选一自迭代 15② 渠道分离起候选 = 纯专长，与本面不再同池**；与通关面的差异另在上下文：无部分回血、无钥石增量行，兑付后「继续」回图选路（不推进关卡）。
|
||||
|
||||
## 布局与交互
|
||||
|
||||
@@ -18,6 +18,6 @@
|
||||
|
||||
## 口径
|
||||
|
||||
- **同库同池耗（v2.4）**：池=固定配额令牌库（普通 70/稀有 25/罕见 3=98 张；罕见档原列「道具件 2」随 aux_item 池种退役〔迭代 11 第①批 T7，落地晚于追认 b〕收窄——状态记录自决披露项）；洗牌不放回抽 3（**同 kind 去重每 kind 至多一枚**——「三种不同选项」体验延续，kind 出现率∝剩余令牌数）、选中踢池未选回池、池耗即枯竭（余库不足出齐剩余，空库=零候选合法态直通）；**种类次数上限退役**（池消耗即上限）。数值对：小GP 20/大GP 50、小增伤 +1/大 +2、小护甲 +1/大 +2、小生命 +5/大 +10、恢复 +6 当即回血（封顶生效上限）、AP +1。**MC 策略 316-f**：1 级优先度=最稀有（rarest>rare>common）、2 级=最左（并列同档取最左）。配额结构锚与档位构成读冒险表（schema validate 硬断言 70/25/3——见 `data/schemas/adventure_table.gd`）。**v2.3 第三渠道并账维持**：商店货架=同库付费渠道（令牌级货架，买一件=奖励面少一件），库存=剩余令牌数，账本语义与切边注记归[冒险结构](../systems/冒险循环/冒险结构.md)共享池账本节。
|
||||
- **同库同池耗（v2.4）**：池=固定配额令牌库（档位=四级框架 普通/优秀/稀有/传说，配额结构锚 70/25/7/0＝102 张、传说=头奖位留空〔稀有档 provisional 投放〕；各 kind 现行配额读 `game/data/tables/adventure.tres`——「道具件 2」原列稀有档，随 aux_item 池种退役〔迭代 11 第①批 T7，落地晚于追认 b〕收窄——状态记录自决披露项）；洗牌不放回抽 3（**同 kind 去重每 kind 至多一枚**——「三种不同选项」体验延续，kind 出现率∝剩余令牌数）、选中踢池未选回池、池耗即枯竭（余库不足出齐剩余，空库=零候选合法态直通）；**种类次数上限退役**（池消耗即上限）。数值对：小GP 20/大GP 50、小增伤 +1/大 +2、小护甲 +1/大 +2、小生命 +5/大 +10、恢复 +6 当即回血（封顶生效上限）、AP +1。**MC 策略 316-f**：1 级优先度=最稀有（legendary>rare>excellent>common，头奖位现行留空）、2 级=最左（并列同档取最左）。配额结构锚与档位构成读冒险表（schema 硬断言=TIER_QUOTAS 结构锚 70/25/7/0——见 `data/schemas/adventure_table.gd`）。**v2.3 第三渠道并账维持**：商店货架=同库付费渠道（令牌级货架，买一件=奖励面少一件），库存=剩余令牌数，账本语义与切边注记归[冒险结构](../systems/冒险循环/冒险结构.md)共享池账本节。
|
||||
- ~~道具件入本关库存~~（v2.2 退役——秘宝局内不掉落机制道具，三轴 doctrine 锁死）。
|
||||
- ~~「池空直通」合法态~~（v2.4 随令牌池换代退役又回归异形：旧口径=GP 无上限保证牌库恒非空；现口径=98 张池真可耗尽，空库=零候选直通合法态——池耗即枯竭既定后果）。
|
||||
- ~~「池空直通」合法态~~（v2.4 随令牌池换代退役又回归异形：旧口径=GP 无上限保证牌库恒非空；现口径=固定配额池（现值 102 张，读冒险表）真可耗尽，空库=零候选直通合法态——池耗即枯竭既定后果）。
|
||||
@@ -156,6 +156,8 @@
|
||||
| 单元套件 | 单元测试（2026-10-22 用户裁——标准四级测试层之一，「套件」单独成词非必要） |
|
||||
| 启动探针 / 秒级冒烟探针 / L0–L3 | 冒烟测试（2026-10-22 用户裁——极小启动场景：能否启动、能否加载表、能否进主屏，零逻辑判定） |
|
||||
| 轻闸 / 重闸 / 三查 | （随 2026-10-22 频率规则消亡，无替代词——检出工作区零测试；卡内只测自己改的东西；全量只在收尾与合回两个时机。机制词「去重闸」含「重闸」二字但与此无关，不在退役之列） |
|
||||
| 魔法道具 | 秘宝（2026-10-26 用户裁入表：AUXILIARY_ITEMS 旧中文规范名，2026-10-05 已更名） |
|
||||
| 罕见（档位名） | 稀有（2026-10-26 用户裁入表：旧三档档位名，现行四级第三档=稀有；散文形容词义不受限） |
|
||||
|
||||
## 对外命名纪律（玩家可见命名，2026-10-11 用户令）
|
||||
|
||||
|
||||
@@ -76,6 +76,11 @@ RETIRED_TERMS = [
|
||||
("单元套件", "2026-10-22", "单元测试", "测试术语重构批——标准四级层命名"),
|
||||
("启动探针|秒级冒烟探针|L0[–-]L3", "2026-10-22", "冒烟测试", "测试术语重构批——极小启动场景"),
|
||||
(r"(?<!去)重闸|轻闸|三查", "2026-10-22", "（随频率规则消亡：检出工作区零测试；卡内只测自己改的东西；全量只有批末＋合回两个时机）", "测试术语重构批——闸档用语退役；代码注释面由 S11 承接（S11 设「去重闸」同形异义豁免）"),
|
||||
# —— 旧词残留清扫批（2026-10-26 用户裁）：权威=design/gdd/术语表.md「退役词对照」——
|
||||
# 魔法道具=秘宝旧中文规范名（2026-10-05 消歧更名）；罕见=旧三档档位名，现行四级第三档=稀有
|
||||
# （档名映射见 adventure_table.gd 头注）——散文形容词义的「罕见」人工判读，不算档位名残留。
|
||||
("魔法道具", "2026-10-05", "秘宝（AUXILIARY_ITEMS 中文规范名）", "消歧更名批；2026-10-26 用户裁入表防再犯（旧词残留清扫批）"),
|
||||
("罕见", "2026-10-26", "稀有（四级档名第三档——旧三档名换代）；散文形容词义人工判读", "档位旧名退役（旧词残留清扫批 2026-10-26 用户裁入表）"),
|
||||
]
|
||||
|
||||
DEFAULT_DIRS = ["design/gdd", "design/art"]
|
||||
|
||||
@@ -638,17 +638,6 @@
|
||||
|
||||
---
|
||||
|
||||
#### 「魔法道具」与「罕见」两个旧叫法的残留未扫——扫不扫待裁（2026-10-18 登记，来源=批次移交）
|
||||
|
||||
**实况**：「魔法道具」随 2026-09-15 可选类道具删除而失效，「罕见」随 2026-09-14 分辨率档位批换装而失效，正文里仍有残留。2026-10-18 实数（全仓 markdown 检索）：魔法道具 23 处、罕见 17 处；此前根目录状态文件记的「约 30 处／约 18 处」系旧读数。两词都不在 `tools/doc_term_audit.py` 的退役词表里，机器闸抓不到，只能人工裁。待裁：扫或不扫；扫则把两词追加进 doc_term_audit 退役词表防再犯。
|
||||
- 相关文档：design/gdd/ 正文用语（权威对照=design/gdd/术语表.md）
|
||||
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待裁决
|
||||
|
||||
---
|
||||
|
||||
#### 「通关」与「通过第 N 关」两种口径混用——统一与否待裁（2026-10-18 登记，来源=批次移交）
|
||||
|
||||
**实况**：「通关」一词既被用来指「打完一整局冒险」，也被用来指「通过第 N 关」，2026-10-18 实测 design/gdd 内 188 处（此前状态文件记 273 处，口径是全仓）。歧义直接影响难度曲线读数与验收判据的表述——同一个「通关率」两种读法差一个数量级。待裁：是否定单一口径并逐处改写。
|
||||
|
||||
Reference in new issue
Block a user