Merge branch 'master' into m4iter13-debt-20261004

2026-10-04 08:28:09 +08:00
commit e6811a6cdd
@@ -56,6 +56,18 @@
 - 确需给新概念命名时：首次出现处必须附一句白话定义，并登记 `design/registry` 术语条目——不得让读者猜测比喻含义。
 - 唯一例外：玩家在游戏里也会看到的专属名词（道具名、界面用语，如"显影尘""探巢摆钟"）。文档内部的机制概念不得造词。

+**自造词的三种固定形态（2026-10-04 黑话审计后补成，全部禁止）**：审计发现本仓自造词几乎都长成下面三种样子，写的时候照着规避，读的时候见到即展开改写：
+
+| 形态 | 反例（本仓真实案例） | 正确写法 |
+|---|---|---|
+| 给工作包起代号 | "样张批""八型批""资产升档重产批" | 叙述名 = 日期 + 做什么，如"2026-10-01 按新分辨率规格重做素材" |
+| 给机制、检查、基线、区域造名词 | "熵增闸""形象锚""判读口径""暗淡记忆态""变异纹带" | 用行业通用词；确实要长期复用的概念走上面的登记通道（正常名字 + 首现白话定义 + registry 登记） |
+| 给流程步骤造动词 | "收口""落籍""在飞""随批""对拍""销账""正主""台账" | 用日常动词：完成 / 合并进 master / 执行中 / 顺带 / 与基线数据逐项比对 / 注销 / 定义所属的那份文档 / 工作日志 |
+
+**通行检验标准**：读者是业内人士，但没读过本项目的历史。一个词如果需要作者另外解释才能懂，这个词就不合格，包含它的句子必须重写成完整的白话句——换一个新名词不算改，展开才算改。
+
+**写后自查**：每写完一条工作日志、一篇文档，重读一遍——凡是自己都要停顿一下才能想起意思的词，一律展开成完整句子。
+
 ## 5. 结构纪律

 | 规则 | 内容 |
@@ -150,7 +162,7 @@

 ## 10. 会话记录纪律

-根目录 `active.md`（会话快照+批次台账）每条进度 ≤3 行（粗体键 + 短句）；详情一律外链到对应文档或报告，禁止把定稿摘要、义务清单整段塞进条目。台账条目记裁决结论本身，不记中间文档文件指针（见第 11 节）。
+根目录 `active.md`（会话快照+批次台账）每条进度用完整的白话句子写清结论本身；条目写多长以读者能看懂为准，不设行数上限（2026-10-04 用户立规：能看懂比字数少更重要，原「每条 ≤3 行」约束废除——该约束曾迫使台账压缩成只有作者自己懂的自造缩略语，是文档黑话的繁殖地）。仍然禁止的只有两件：把定稿摘要、义务清单整段搬进条目（详情归各正主文档，台账只记结论）；以及自造黑话——第 4 节用语纪律对台账同等生效。台账条目记裁决结论本身，不记中间文档文件指针（见第 11 节）。

 ## 11. 文档生命周期：吸收即死（2026-10-01 用户立规）

@@ -184,3 +196,5 @@
 | v7 | 2026-09-16 | 06 清单改版（用户拍板）：「待拍板」术语全仓改「待办」，清单更名 `design/gdd/06-待办清单.md`；清单内格式由四列表格改为「循环 → 系统 → 条目（四级标题）+ 粗体属性段（现状 / 归属 / 状态）」，条目解决后状态改"已解决（日期）"留痕；第 6 节顶层文档表与骨架表、第 8 节「待办单点登记」同步改指 |
 | v8 | 2026-09-30 | **概念落位与口径携带条款（微光口径事故后补成，用户拍板）**：第 7 节概念封装纪律增「落位五要素」行（定义/作用对象与范围/生命周期/关联/状态缺一不立）与「无正主，不下定义」段（概念未落正主前，任何文档不得替它下定义，只许 06 登记「待落位」）；第 8 节「引用不转述」行扩口径携带纪律（作用对象/范围/生命周期随句写全或显式指路，禁裸形容词复述） |
 | v9 | 2026-10-02 | **文档生命周期条款（2026-10-01 用户立规「吸收即死」落文）**：新增第 11 节——中间文档寿命=迭代寿命，结论吸收进正主即删、未决先迁再死、永不入库、引用面口径、台账记结论不记指针、sim-data 白名单、迭代出口清理项、design/research 与 design/qa 为暂存地非档案库；第 10 节补台账记结论口径；文首地位/适用范围两处过期路径修正（`docs/`→`design/dev/`、`production/` 会话记录→根 `active.md`） |
+| v10 | 2026-10-04 | **台账去压缩条款（用户立规）**：第 10 节废除「每条 ≤3 行」——能看懂比字数少更重要；条目改用完整白话句子写结论，长度服从可读性；第 4 节黑话禁令对台账同等生效。起因：2026-10-04 黑话审计证实 ≤3 行压缩压力迫使台账条目使用自造缩略语（收口/落籍/在飞等约 15 个流程动词、530 条自造短语），并渗入正式文档；CLAUDE.md 规范导航表「会话进度记录」行同步改写 |
+| v11 | 2026-10-04 | **第 4 节补强：自造词三形态禁令（用户令，黑话审计后）**：新增自造词三种固定形态禁令表（工作包代号 / 机制造词 / 流程造词，各带本仓真实反例与正确写法）+ 通行检验标准（读者 = 业内人但没读过项目历史，需要作者解释的词即不合格，展开才算改）+ 写后自查动作；同批 CLAUDE.md 硬性红线新增「用语红线」一行。起因：原第 4 节禁令过于抽象、执行失效（全仓 530 条自造短语），且未明确覆盖对话输出与工作日志命名 |
@@ -118,14 +118,6 @@

 **状态**：待办

-#### Alpha：全怪物技能池数值验证与合理性设计
-
-**现状**：2026-09-19 用户立项。背景：切片期技能池只保证正常游玩（用户裁示——卓尔池无增益技、文档池构成表缺 L2 行等候选缺漏不做当期修复，后续可能对全怪物技能池整体重设计）；本条 = Alpha 版本时对**所有怪物**的技能池做一次完整的数值验证与合理性设计。范围：池构成与权重、技能倍率与冷却、保底 M 与冷却递减、EV 期望与关间台阶、克制的技能面覆盖；**含技能倍率在小整数基线下的取整抖动复核**（×1.5 遇奇数攻击基线出半点、现行 round 处理——与甲效矩阵"假粒度"论证同族，轻量版）；含本批两候选缺漏的复核（卓尔池增益技去留、敌人系统文档池构成表补 L2 行）。**2026-09-19 节奏体验验证批观测移交**：按用户判读带（过旱 = 整场战斗全敌人零特殊技）实测，过旱集中在短命杂鱼（地精系 82–87%、巨蜘蛛 52%，均出招 1.2–2.2 拍——保底 M=4 在战斗总长 1–2 拍时结构性无法触发），耐久敌零过旱（酋长 0% / 卓尔 2%）——「杂鱼是否也该有可感知的技能纹理」（如首拍加权/保底按剩余血量改算）属池设计面，随本条 Alpha 池验证一并评估。若技能池届时整体重设计，本验证以重设计后的版本为准。
-
-**归属**：难度曲线与Boss（数值验证主责）与[敌人系统](systems/战斗循环/敌人系统.md)（池设计共裁）；时点 = Alpha，随验收读数重测批同窗口执行
-
-**状态**：待办（2026-09-19 用户立项）
-
 ### 增益状态

 #### 削弱档位的最终数值
@@ -156,7 +148,7 @@

 #### 冒险前资源配比预设（构筑提案）

-**现状**：2026-09-18 用户提案，方向评估通过，登记在案。核心想法 = 玩家在**开始冒险前**预设地图战斗资源的类型配比——预设的是**分布**（八型在格面上的权重占比），不是落位：装板摇号仍按专属随机流摇出各格类型身份，玩家定分布、摇号定落位，无固定出招剧本（与既定随机性立场相容）。两分法：① **基础资源配比**——玩家对八型格面池（attack 增伤 / defense 护甲 / heal 回血 / blast 群伤 / weaken 削弱 / pierce 穿刺 / magic 魔法 / action 行动点）的正向行权重做配比，经覆盖值通道在开局注入，摇号按覆盖后的分布落位；② **关卡特殊资源**——不同关卡（board_biome 图主题）的地图携带配比池之外的特殊资源与差异化分布。设计红利：雷安同池 + 极性矩阵使配比自带代价轴——调高某型权重，安全格正向与雷格负向同步变多，配比 =「赌自己挖掘少失误 + 赌关卡敌人构成怕什么」的双重下注，不是免费午餐，无需另发明平衡机制。架构红利：① 的注入通道 = [元进度](systems/跨局循环/元进度.md) v1.0 刚定稿的「冒险开始参数面 + 覆盖值通道」（追加/替换集合操作已登记），零新机制；② 正是[棋盘生成](systems/排雷循环/棋盘生成.md) board_biome 上下文与[地图战斗资源](systems/战斗循环/地图战斗资源.md)`clear_<图类型>` 差异化插槽、P1 功能道具渠道等预留位的启用场景。
+**现状**：2026-09-18 用户提案，方向评估通过，登记在案。核心想法 = 玩家在**开始冒险前**预设地图战斗资源的类型配比——预设的是**分布**（八型在格面上的权重占比），不是落位：装板摇号仍按专属随机流摇出各格类型身份，玩家定分布、摇号定落位，无固定出招剧本（与既定随机性立场相容）。两分法：① **基础资源配比**——玩家对九型格面池（attack 增伤 / defense 护甲 / heal 回血 / blast 群伤 / weaken 削弱 / pierce 穿刺 / magic 魔法 / action 行动点 / gp 金币——2026-10-04 立项裁决批口径收口：原登记时 gp 型未入池写八型，现行九型正向权重合计 77）的正向行权重做配比，经覆盖值通道在开局注入，摇号按覆盖后的分布落位；② **关卡特殊资源**——不同关卡（board_biome 图主题）的地图携带配比池之外的特殊资源与差异化分布。设计红利：雷安同池 + 极性矩阵使配比自带代价轴——调高某型权重，安全格正向与雷格负向同步变多，配比 =「赌自己挖掘少失误 + 赌关卡敌人构成怕什么」的双重下注，不是免费午餐，无需另发明平衡机制。架构红利：① 的注入通道 = [元进度](systems/跨局循环/元进度.md) v1.0 刚定稿的「冒险开始参数面 + 覆盖值通道」（追加/替换集合操作已登记），零新机制；② 正是[棋盘生成](systems/排雷循环/棋盘生成.md) board_biome 上下文与[地图战斗资源](systems/战斗循环/地图战斗资源.md)`clear_<图类型>` 差异化插槽、P1 功能道具渠道等预留位的启用场景。

 **影响面（按循环）**：
 - 排雷循环：[行动经济](systems/排雷循环/行动经济.md)——经济契约对账以资源行值为原材料，类型频次构成随配比漂移，对账窗口须按配比包络复算；[棋盘生成](systems/排雷循环/棋盘生成.md)——生成管线零改动（资源身份摇号不在其域），board_biome 词表定稿是关卡特殊资源的前置；[排雷玩法](systems/排雷循环/排雷玩法.md)——挖掘/标旗动作决定极性、承载配比的风险轴，机制零改动；[魔法道具](systems/排雷循环/魔法道具.md)——相邻：预读类道具读取身份查询面，配比改变分布先验后「资源预读与推理的边界」读感联动，不做机制耦合。
@@ -168,13 +160,13 @@

 **被依赖（谁会依赖本提案）**：HUD 构筑界面呈现；教学新口径；难度曲线与Boss 验收判读口径（配比包络下的通关率带复算，换算率表强条目纪律同类）；行动经济对账窗口；registry 与架构概念图的结构登记（新节点落地时 archify 图须重交付）。

-**开放问题（立项前裁决）**：① **预算机制**——自由滑条必出支配策略（全拉穿刺 + 魔法〔必中克制直伤〕大概率唯一解，构筑空间反死），候选 = 点数总预算 / 每型上限 / 配比槽位本身当解锁内容——最大设计题；② **杠杆主权切分**——切片与验收期锁默认权重（测量保护），正式期「设计者定包络、玩家分配」的参数归属；③ **与永久强化的分工**——配比容量（可用类型/点数/槽位）映射到营地三柜台哪几个；④ **基础配比的注入语义**——权重覆盖走数值覆盖还是集合操作（追加/替换），参数面字段裁决；⑤ **关卡特殊资源与功能道具渠道的边界**——图内格面池差异化与节点奖励不混池的口径。
+**开放问题（立项前裁决）**〔五问已全裁（2026-10-04 用户令「拍板点全部使用推荐」），裁决结论见状态行与提案-冒险前资源配比预设-2026-10-04.md §九；下文为裁决前登记留痕〕：① **预算机制**——自由滑条必出支配策略（全拉穿刺 + 魔法〔必中克制直伤〕大概率唯一解，构筑空间反死），候选 = 点数总预算 / 每型上限 / 配比槽位本身当解锁内容——最大设计题；② **杠杆主权切分**——切片与验收期锁默认权重（测量保护），正式期「设计者定包络、玩家分配」的参数归属；③ **与永久强化的分工**——配比容量（可用类型/点数/槽位）映射到营地三柜台哪几个；④ **基础配比的注入语义**——权重覆盖走数值覆盖还是集合操作（追加/替换），参数面字段裁决；⑤ **关卡特殊资源与功能道具渠道的边界**——图内格面池差异化与节点奖励不混池的口径。

 **前置**：① 验收批读数重测与真人试玩先跑——配比博弈的核心未知数（玩家配比是否收敛到唯一解、分布先验怎么被利用）只有真人数据能回答；② 当前批序列走完：本批审批 → 验收重测 → 曲线调参 → 魔法道具内容批。〔原前置③「立项时与差异化批合并评估——同一冻结面一批做省一次修订流程」随差异化批否决退役（2026-10-04）——配比预设转独立立项评估〕

 **归属**：[地图战斗资源](systems/战斗循环/地图战斗资源.md)修订批（基础配比的权重覆盖语义 + GDD 修订）与[元进度](systems/跨局循环/元进度.md)（解锁容量与注入生产者）共裁；呈现面归[HUD 框架](systems/表现与支撑/HUD框架.md)与[教学引导](systems/表现与支撑/教学引导.md)随批。

-**状态**：待办（2026-09-18 用户提案、方向评估通过；实施窗口 = Alpha；原「与差异化批合并立项」随差异化批否决退役〔2026-10-04〕，转独立立项评估）
+**状态**：已裁待实施（2026-10-04 立项提案五拍板点全按推荐落定〔用户令「拍板点全部使用推荐」〕——①预算机制 = 组合制：总量挪点为骨架〔九型正向权重总和恒 77，拉高某型必以压低别型为代价，全押穿刺+魔法算术不可达〕+每型上下限包络+容量随营地解锁渐进〔三子裁随裁：gp 首发不可调〔包络 (2,2) 恒定〕/预设档位 3 套/下限 >0〕；②主权切分 = 设计者定包络与默认、玩家包络内分配，验收 = 默认分布锚〔现行四带正主读数不动〕+新增极端构筑护栏带；③容量柜台 = 奖励格图鉴承接〔随 A3 否决空置的柜台得正业〕；④注入语义 = 差值向量〔存相对默认偏移 ΣΔ=0，与偏运硬币同一摇号前权重合成层，关态逐位零扰动〕，集合操作保留在解锁层〔可调型集扩容〕作辅语义；⑤渠道边界 = 清图槽差异化先行 + 三句不混池口径〔板图分工/配比域封闭/格型无差——不按雷格安全格分的 A3 红线沿用〕。全案与淘汰依据 = design/research/提案-冒险前资源配比预设-2026-10-04.md §八备选全列 + §九裁决记录 + §十盘问轮四裁。盘问轮四裁随落（2026-10-04 全按推荐：合成序 = 表值→玩家配比差值→包络钳制→图级变异偏斜→同调硬币偏置〔包络只管玩家差值，提案 §6.3 原草图废止〕/图鉴柜台逐型商品/冒险开始锁档〔关间换档后置评估〕/包络宽度随容量分级放宽）。**已编入 roadmap 迭代 14 ⑥号卡（2026-10-04 用户令）**，任务书=design/research/任务书-冒险前资源配比预设批-2026-10-04.md（T0-T8≈6.0d 两段切分；开工门=②③号卡出口；零新拍板点，provisional 归出口追认）——序位在②③后（合成序扩参与包络数值锚依赖②判式换代与③变异投影，三者共用摇号投影点）；包络数值 provisional 起步，待真人读数与②号新当量账双锚校准；任务书待起草（估时随任务书）。原「实施窗口 = Alpha」随编卡改迭代 14。原「与差异化批合并立项」随差异化批否决退役〔2026-10-04〕）

 ### 关卡节点地图

@@ -255,7 +247,7 @@

 **归属**：[art-bible](../art/art-bible.md) §8.2 · 资产管线批

-**状态**：**已裁决案乙（2026-09-30 迭代 9 三裁决，用户「按推荐来」）**——本迭代不升档，先收 Alpha 真人读数再定（B 区舞台落影已改善存在感；T10 黄金图基准本迭代内建成不被作废）；升档批=M-4 候选位，届时提灯点亮解禁候选一并重议；A4 尺寸基线冻结（立绘 46×48/小人源 32×32）维持有效
+**状态**：**已裁决案乙（2026-09-30 迭代 9 三裁决，用户「按推荐来」）**——本迭代不升档，先收 Alpha 真人读数再定（B 区舞台落影已改善存在感；T10 黄金图基准本迭代内建成不被作废）；升档批=M-4 候选位，届时提灯点亮解禁候选一并重议；A4 尺寸基线冻结（立绘 46×48/小人源 32×32）维持有效。**2026-10-04 用户令：暂不做、先忽略**（真人读数虽已收，用户裁不编入当前迭代表、挂起不讨论；重启=用户点名）

 ### 数据配置