docs(glossary): 退役词对照表全库强制清扫——正主→现行事实源130行+落籍→已入库79行(39文件194行,语境微调=权威文档/权威定义节/拼表制主选/入库注记等;对照性文本豁免保留)+五词终验零真残留+术语表v1.3+active 446(2026-10-11 用户令收尾)
This commit is contained in:
1 parent
23f23b00b9
commit
ac19754374
40 files changed
+196
-194
No files matched your search
@@ -51,7 +51,7 @@
|
||||
| 架构与决策记录 | `design/dev/architecture/architecture.md` + 同目录 `adr-*.md` |
|
||||
| 引擎版本与参考 | `design/dev/engine-reference/godot/`(版本表已在上方 @ 引入) |
|
||||
| 术语、已锁数值 | `design/registry/entities.yaml`——仅 owner 文档可修订,冲突须显式提出 |
|
||||
| 会话进度记录 | 根目录 `active.md`(状态文件,2026-10-09 立宪:只记现在,每行当下为真)——快照节(≤10 条)+未决面+当前迭代状态记录;收口先改快照再记账,并删除已完结旧条目;历史归 git、待裁归 06、教训归记忆库;条目用完整白话句子写清结论,能看懂比短重要(2026-10-04 用户立规),详情归正主文档 |
|
||||
| 会话进度记录 | 根目录 `active.md`(状态文件,2026-10-09 立宪:只记现在,每行当下为真)——快照节(≤10 条)+未决面+当前迭代状态记录;收口先改快照再记账,并删除已完结旧条目;历史归 git、待裁归 06、教训归记忆库;条目用完整白话句子写清结论,能看懂比短重要(2026-10-04 用户立规),详情归权威文档 |
|
||||
| 工程路线图 | 根目录 `roadmap.md`——里程碑时间线与下一步顺序(批级视图;实时状态看快照节) |
|
||||
|
||||
## 分支纪律(worktree 铁律,2026-09-19 用户立规)
|
||||
@@ -59,7 +59,7 @@
|
||||
主工作区(本目录,`master` 检出)只作**合并落点与共享状态载体**,一切开发/设计改动不得直接发生在主工作区:
|
||||
|
||||
1. **开工**:每个任务批次先建独立 worktree 分支再动手:`git worktree add ../g-plan2-<任务名> -b <任务分支>`。所有代码/文档/数值改动与验证跑测都在 worktree 内进行(注意:未跟踪文件不会出现在新 worktree,需手工搬运)
|
||||
2. **收尾**:迭代 loop 批次在验证全绿(冒烟 + 场景探针;冒烟挂迭代开发完成后的出口/落籍闸)后,在主工作区 `git merge --no-ff <任务分支>` 落回 master,然后 `git worktree remove` + 删分支;合并前先看 active.md 尾部状态记录,避免与并行会话撞号/漏捎带;收口时按 doc-conventions §10 退役规则删除已完结旧条目(判据=已落籍+结论进快照+无未决项指向)。非 loop 批次收口跑闸与否按「测试执行两入口铁规」(见硬性红线):默认不跑,用户点名或当场问
|
||||
2. **收尾**:迭代 loop 批次在验证全绿(冒烟 + 场景探针;冒烟挂迭代开发完成后的出口/入库闸)后,在主工作区 `git merge --no-ff <任务分支>` 落回 master,然后 `git worktree remove` + 删分支;合并前先看 active.md 尾部状态记录,避免与并行会话撞号/漏捎带;收口时按 doc-conventions §10 退役规则删除已完结旧条目(判据=已入库+结论进快照+无未决项指向)。非 loop 批次收口跑闸与否按「测试执行两入口铁规」(见硬性红线):默认不跑,用户点名或当场问
|
||||
3. **豁免面(仅这两处允许主工作区直改)**:根目录 `active.md`(会话收口)与 `.zcode/`(钩子配置)——其余一律走 worktree;主工作区 `git commit` 会被钩子直接拦截
|
||||
4. 本铁律由 PreToolUse 钩子 `.zcode/hooks/worktree-guard.sh` 强制兜底;钩子只约束 agent 侧,用户本人手工改动不受限
|
||||
|
||||
@@ -76,12 +76,12 @@
|
||||
**第二段·写需求卡片**——产出需求卡片(实施指导文档,写作规范见用户级技能 req-card)。
|
||||
- 触发:设计定稿后由用户发令。**无设计前置的例外**:缺陷修复/工程债/测试基建/重构类工程需求,凭 bug 证据或 06 在册条目直接进入本段;新玩法/新系统/新内容类必须有设计定稿前置。
|
||||
- 质量门:卡片必经 grilling 多轮复核,裁决全落、零待裁点才算成立。
|
||||
- 登记:卡片入库后必在 `design/gdd/06-待办清单.md` 登记一条(卡片名/文件指针/状态:待编入/已编入/已开工/已落籍)——防用户遗忘已写过的卡;卡片落籍后按 06 退役规则销号。
|
||||
- 登记:卡片入库后必在 `design/gdd/06-待办清单.md` 登记一条(卡片名/文件指针/状态:待编入/已编入/已开工/已入库)——防用户遗忘已写过的卡;卡片入库后按 06 退役规则销号。
|
||||
- 编入:卡片加入后续未完成的迭代(roadmap 迭代行);没有可用迭代时与用户确认开新一轮。
|
||||
|
||||
**第三段·实现**——产出代码与配置文件,可运行的游戏。
|
||||
- 触发:需求卡片永不单独施工,统一由用户指定迭代号触发(=U0 开工令);执行按 /iter 技能与下方批次工作流标准清单。
|
||||
- **设计正主文档(GDD/art-bible 等承载设计决定的文档)在实现批内一律不更新**——文档与用户想法等同对等,任何更新必须经用户同意;实现批只出迭代实现报告(见下方第 12 条文档同步闸)。
|
||||
- **设计权威文档(GDD/art-bible 等承载设计决定的文档)在实现批内一律不更新**——文档与用户想法等同对等,任何更新必须经用户同意;实现批只出迭代实现报告(见下方第 12 条文档同步闸)。
|
||||
- 收口人闸:实机目检清单+代拍板追认单交用户;后置不阻塞收口,用户验完才算真完。
|
||||
|
||||
## 批次工作流标准清单(2026-10-06 用户确认固化)
|
||||
@@ -89,7 +89,7 @@
|
||||
每个批次按以下链路执行——本清单主要承载第三段(实现段)与一切被批准批次的执行纪律,三段的出入口与转进规则见上节。本清单是总索引,各步细则散见上文各节与 `design/dev/` 子文档;与任一细则冲突时以细则为准,发现清单本身过时须同批修订。
|
||||
|
||||
**开工前**
|
||||
1. **先检索后提问**——动手前先查在册记忆与正主文档,防止把已裁决事项当新问题重问,或重踩已记录的坑
|
||||
1. **先检索后提问**——动手前先查在册记忆与权威文档,防止把已裁决事项当新问题重问,或重踩已记录的坑
|
||||
2. **需求卡片全列备选案**——批需求卡片里每个待拍板点列出全部备选方案与各自代价,交用户裁决,不在需求卡片内自行定夺
|
||||
3. **用户发开工令才动手**——需求卡片经用户批准(U0)后方开工
|
||||
|
||||
@@ -106,16 +106,16 @@
|
||||
9. **批末四闸全绿才合并**——冒烟 + 单元测试 + 场景探针 + 改前改后读数对拍,四项全绿方可在主工作区合并
|
||||
10. **合并后主区全量复跑**——合并本身可能引入冲突或环境差异,落回 master 后再跑一遍全套验证
|
||||
11. **会话收口落记**——`active.md` 快照与状态记录更新(含删除已完结旧条目,退役规则见 `design/dev/doc-conventions.md` §10);跨会话有效的教训写入记忆库
|
||||
12. **文档同步闸 v2(2026-10-10 用户改立,替代 2026-10-09 版)**——文档更新时间点分两层:**机械面文档**(roadmap 行换代、registry、active.md 记账、README/工具注)合并/落籍前随批更新完毕方算收口(原口径不变);**设计正主文档**(GDD/art-bible 等承载用户设计决定的文档)实现批内一律不更新——文档与用户想法等同,更新必须经用户同意:实现批收口产出**迭代实现报告**(`design/qa/iter<N>-实现报告-<日期>.md`,一个迭代一份,含各卡状态+代拍板追认单+**GDD 反哺点节**——实现与设计的差异/缺口逐条列明),反哺点收口时同步登记 `design/gdd/06-待办清单.md`,用户逐点裁决后另批落文(可随批捎带,窗口长短由用户控制)。反哺点未落文期间,相关 GDD 节按 06 登记视为待反哺状态——读该节做新设计/写新卡前先查 06,勿把旧文当现行事实。需求卡片仍必列「关联文档同步面」,同步义务按两层标注(机械面=随批更新;设计面=报告反哺)
|
||||
12. **文档同步闸 v2(2026-10-10 用户改立,替代 2026-10-09 版)**——文档更新时间点分两层:**机械面文档**(roadmap 行换代、registry、active.md 记账、README/工具注)合并/入库前随批更新完毕方算收口(原口径不变);**设计权威文档**(GDD/art-bible 等承载用户设计决定的文档)实现批内一律不更新——文档与用户想法等同,更新必须经用户同意:实现批收口产出**迭代实现报告**(`design/qa/iter<N>-实现报告-<日期>.md`,一个迭代一份,含各卡状态+代拍板追认单+**GDD 反哺点节**——实现与设计的差异/缺口逐条列明),反哺点收口时同步登记 `design/gdd/06-待办清单.md`,用户逐点裁决后另批落文(可随批捎带,窗口长短由用户控制)。反哺点未落文期间,相关 GDD 节按 06 登记视为待反哺状态——读该节做新设计/写新卡前先查 06,勿把旧文当现行事实。需求卡片仍必列「关联文档同步面」,同步义务按两层标注(机械面=随批更新;设计面=报告反哺)
|
||||
13. **实机目检归用户**——真机人闸由用户执行,用户亲口确认才算验收通过
|
||||
14. **中间产物吸收即死**——结论先迁入正主文档(GDD/待办清单/路线图),中间文件即删且永不提交(细则见硬性红线)
|
||||
14. **中间产物吸收即死**——结论先迁入权威文档(GDD/待办清单/路线图),中间文件即删且永不提交(细则见硬性红线)
|
||||
|
||||
## 硬性红线(勿违反)
|
||||
|
||||
- **worktree 铁律**:主工作区禁止直接改动与提交(细则见上节;并行会话各占 worktree 互不踩踏)
|
||||
- **测试执行两入口铁规(2026-10-02 用户立规)**:测试类执行——冒烟测试、单元测试(tests/run_all)、模拟验证(MC/verifier/调参批量工具)、场景探针等一切跑游戏的验证调用——只有两个触发入口:①**迭代 loop 开发**(冒烟挂迭代开发完成后的出口/落籍闸,loop 内过程性验证属开发工作本身);②**用户主动点名**。除此之外(问答/调研/文档/审查/零散小改等短小会话)一律零测试,不得擅自调用任何测试;确需测试支撑结论时先请示,以静态阅读/推理作答并注明未跑测。**MC/模拟验证触发细则(2026-10-02 用户确认,2026-10-03 补落文——出处:迭代 9 出口批 81000 锚误跑质询)**:MC/verifier 仅在**数值验证场景**触发(改数值前后取证);normal 档为主、perfect 按需;**无数值改动的会话禁跑 MC**——结构位移类「存档锚」须先向用户请示定性再跑;需求卡片预设步骤的前提消失时(如「带值裁定后重锚」实际未投值)停问勿照字面执行。**分级周期口径(2026-09-26 用户裁定,2026-10-03 自 06-待办清单收编;重闸定义随迭代 19 卡①需求卡片 Q1 裁决扩容 2026-10-08)**:轻闸(run_smoke 全量+ui_input_probe;触碰 presentation 加跑 ui_click_probe+ui_layout_probe)可随变更执行;**重闸自此批末=轻闸+probe_gate --click+probe_gate --full(ui_probe/ui_tune_probe/t17_defer_probe/fx_probe 四探针)+render_gate(窗口化渲染闸:shot_probe 七屏样张 A-D 断言+fx_shot/board_shot 取证+棋盘 golden 逐像素)+run_all 单元全套+doc 三闸(gdd_lint/doc_link_audit/doc_term_audit)+熵增闸(repo_structure_audit)**,属**周期执行**——统一在批次收口或固定周检跑,不进每次变更;真人实机目检仍归用户不进自动闸(07⑮ 目检半不销号);MC 大扫描仍按上方 MC 触发细则(无数值改动零跑)
|
||||
- **测试执行两入口铁规(2026-10-02 用户立规)**:测试类执行——冒烟测试、单元测试(tests/run_all)、模拟验证(MC/verifier/调参批量工具)、场景探针等一切跑游戏的验证调用——只有两个触发入口:①**迭代 loop 开发**(冒烟挂迭代开发完成后的出口/入库闸,loop 内过程性验证属开发工作本身);②**用户主动点名**。除此之外(问答/调研/文档/审查/零散小改等短小会话)一律零测试,不得擅自调用任何测试;确需测试支撑结论时先请示,以静态阅读/推理作答并注明未跑测。**MC/模拟验证触发细则(2026-10-02 用户确认,2026-10-03 补落文——出处:迭代 9 出口批 81000 锚误跑质询)**:MC/verifier 仅在**数值验证场景**触发(改数值前后取证);normal 档为主、perfect 按需;**无数值改动的会话禁跑 MC**——结构位移类「存档锚」须先向用户请示定性再跑;需求卡片预设步骤的前提消失时(如「带值裁定后重锚」实际未投值)停问勿照字面执行。**分级周期口径(2026-09-26 用户裁定,2026-10-03 自 06-待办清单收编;重闸定义随迭代 19 卡①需求卡片 Q1 裁决扩容 2026-10-08)**:轻闸(run_smoke 全量+ui_input_probe;触碰 presentation 加跑 ui_click_probe+ui_layout_probe)可随变更执行;**重闸自此批末=轻闸+probe_gate --click+probe_gate --full(ui_probe/ui_tune_probe/t17_defer_probe/fx_probe 四探针)+render_gate(窗口化渲染闸:shot_probe 七屏样张 A-D 断言+fx_shot/board_shot 取证+棋盘 golden 逐像素)+run_all 单元全套+doc 三闸(gdd_lint/doc_link_audit/doc_term_audit)+熵增闸(repo_structure_audit)**,属**周期执行**——统一在批次收口或固定周检跑,不进每次变更;真人实机目检仍归用户不进自动闸(07⑮ 目检半不销号);MC 大扫描仍按上方 MC 触发细则(无数值改动零跑)
|
||||
- **MC 采集档位细则(2026-10-03 用户四档立规,承接 MC 触发细则)**:MC 局数按用途四档硬闸(表见 `sim-data/README.md`「MC 采集档位表」):**一档·调研**=总量 >40(100+ 为常用锚量级;60/档=结构回归、100=95% CI ±9.8pp、170=±7.5pp=15pp 带半宽、400 满档=±4.9pp 贴边裁决;normal 独立满档 ~8 分钟同属一档)**只能由用户发起**——需求卡片/计划书/agent 均无权发起,非用户发起一律不构成一档授权;**二档·数值修改验证**=总量 ≤40、每档 ≤20(仅 ≥~40pp 结构位移可判,同种子配对下 ~30pp);**三档·小调**=总量 ≤20、每档 ≤10(只测不判);**四档·微量**=总量 ≤5(sanity 门,零统计判读)。四档仅承接 MC 触发细则的数值验证场景,两入口铁规不变;超档=停机呈报,禁在二/三/四档下带值结论(窗口不足如实挂起)。改前/改后锚同 seed0 配对、改前锚留盘禁补跑;对拍断言零新跑(复验用锚内子集 ≤20);读数缺陷(零 gameplay/RNG 触碰)禁整套重跑、走事件流重构补算;≥60 局采集先 N=5 pilot 校验字段;二/三/四档会话累计 ≤20 分钟;零数值改动=零 MC
|
||||
- **中间产物吸收即死(2026-10-01 立规)**:中间文档(批需求卡片/机检报告/调研审计报告/模拟读数/迭代计划书/目检清单)寿命=迭代寿命——结论先吸收进正主文档、未决项先迁 `design/gdd/06-待办清单.md` 或 roadmap,然后文件即删,且永不提交 git;活文档=唯一事实源,git=变更记录。细则见 `design/dev/doc-conventions.md` 第 11 节
|
||||
- **中间产物吸收即死(2026-10-01 立规)**:中间文档(批需求卡片/机检报告/调研审计报告/模拟读数/迭代计划书/目检清单)寿命=迭代寿命——结论先吸收进权威文档、未决项先迁 `design/gdd/06-待办清单.md` 或 roadmap,然后文件即删,且永不提交 git;活文档=唯一事实源,git=变更记录。细则见 `design/dev/doc-conventions.md` 第 11 节
|
||||
- **用语红线(2026-10-04 用户立规,黑话审计后落文)**:面向用户的一切输出——文档、状态记录(active.md)、报告、清单、对话——禁止自造黑话与代号式命名;判据 = 业内读者没读过项目历史也能一遍看懂,需要作者解释才能懂的词必须展开成完整白话句(三种固定形态、本仓反例全表与正确写法见 `design/dev/doc-conventions.md` 第 4 节)
|
||||
- **呈报六问铁规(2026-10-07 用户立规)**:向用户呈报一切事物——bug、需求、概念设计、提案——一律按六问结构顺序展开,确认后才动手实现:①**What 现状与差异**——现在是什么样(引用文件、行为等事实)+ 要做什么/改什么;②**Why 期望与动机**——目标态是什么样、为什么值得改,含「不做的代价」;③**How 怎么改**——修改路径,有备选案全部列出不私藏;④**Where 影响面**——改动波及哪些系统、文件、流程、既有裁决;⑤**怎么算改对了**——可判定的验收标准,不写模糊话;⑥**不确定的地方**——没把握、需要用户裁决的点,单列收尾不埋正文。**Who/When 不进呈报正文**——谁来执行、什么时候做由用户决定,由 roadmap 与需求卡片承接,呈报里最多一句话带过。**适用范围(2026-10-08 用户补立)**——六问结构只用于**首次描述需求、bug 缺陷或相关方案**的呈报;同一方案的后续对答(追问、讨论、细化、执行汇报)不再套用六问结构,除非用户显式要求
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# 会话状态:Dungeon Sweeper(扫雷 × 自动战斗)——唯一状态源·状态文件(2026-10-09 立宪)
|
||||
|
||||
> **定性(2026-10-09 用户裁决):状态文件,非历史档案**——本文件每一行都必须在当下为真;历史变更一律以 git 提交史为准(删除的条目可在 git 历史版本中完整复原)。
|
||||
> 写入边界:只写快照、未决面、当前迭代工作条目。待办裁决归 `design/gdd/06-待办清单.md`,跨会话教训归记忆库;已完结批次条目(已落籍+结论进快照+无未决项指向)在迭代收口时删除,超 30 条必须清。细则见 `design/dev/doc-conventions.md` §10。
|
||||
> 写入边界:只写快照、未决面、当前迭代工作条目。待办裁决归 `design/gdd/06-待办清单.md`,跨会话教训归记忆库;已完结批次条目(已入库+结论进快照+无未决项指向)在迭代收口时删除,超 30 条必须清。细则见 `design/dev/doc-conventions.md` §10。
|
||||
> 并行会话禁止将本文件整体复原/回退。
|
||||
|
||||
|
||||
@@ -21,22 +21,23 @@
|
||||
- **更新于**:2026-10-10(**状态记录更名+新规落文+秘宝实装待办登记批**——worktree status-record-batch 自治合入;用户三令):「工作日志」旧叫法全仓清扫改「状态记录」(五文件 105 处)+doc-conventions §10 章程落新规「用户确认任务完成时清除当前会话写过的状态条目——状态清除即任务完成证明」+06 新条「秘宝体系实现重构落地批」(文档层已换代/代码数据层未落,冻结待发令)
|
||||
- **更新于**:2026-10-10(**第一版秘宝全弃用收官批**——worktree treasure-lib-13 自治合入;用户裁「退役与封存都进素材库,无留待 Alpha 重定的挂起」):显影尘/地穴全图卷 deferred→retired+秘宝.md v1.9 四处正文换代+素材库四件迁表一(表一 14 件);数据表四行删除归退役删行批
|
||||
- **更新于**:2026-10-10(**天赋树裁定跨文档同步批**——worktree tbox-docsync 自治合入,用户令「本批只做文档同步,勿再开裁」):武器锻造.md v0.2 补树侧解锁门+06 新登「天赋树结构重构批」实装待办+「道具工坊→秘宝匣」改名扫改九文件现行正文+registry 术语条「秘宝匣」
|
||||
- **更新于**:2026-10-10(**三段开发流程立规+文档同步闸 v2 落文**——worktree rules-3stage 自治合入 b56a7b8):设计→写需求卡片→实现三段定规;实现段 GDD/art-bible 等设计正主批内一律不更新,收口出迭代实现报告,GDD 反哺点经用户逐点裁决后另批落文;落文=CLAUDE.md 三段节+第 12 条 v2+doc-conventions v15+/iter·req-card 技能
|
||||
- **更新于**:2026-10-10(**三段开发流程立规+文档同步闸 v2 落文**——worktree rules-3stage 自治合入 b56a7b8):设计→写需求卡片→实现三段定规;实现段 GDD/art-bible 等设计权威文档批内一律不更新,收口出迭代实现报告,GDD 反哺点经用户逐点裁决后另批落文;落文=CLAUDE.md 三段节+第 12 条 v2+doc-conventions v15+/iter·req-card 技能
|
||||
- **更新于**:2026-10-09(**小尾巴卫生批**——worktree hygiene-batch 自治合入;状态记录 430):秘宝.md 版本表 v0.6 双行改 v0.6a/v0.6b+06 欠账块精简+素材库表三「待核」换代「已核」+难度曲线 L122 销账——交接文档第五事项全部闭环
|
||||
- **更新于**:2026-10-09(**天赋树欠账三分流批**——worktree tree-debt-gdd 自治合入;状态记录 429):06 新条「天赋树已建未接面两件」+registry「永久强化」词条换代+camp.md 补树面板结构位行+销账两项确认
|
||||
- **更新于**:2026-10-09(**武器锻造成文批提交合入**——worktree wforge-gdd;状态记录 428):新建 systems/跨局循环/武器锻造.md v0.1(17 裁点开放在册待用户逐点裁决、推翻即改)+02 v1.18+元进度 v1.12+06 实装待办条登记(冻结待排期)
|
||||
- **更新于**:2026-10-09(**active.md 立宪+大裁批**;状态记录 424):定性=状态文件落文六处+大裁 941 行→约 60 行(吸收扫描全量过门,漏网 2 项迁 06=美术审计两项 P0+filter-repo)
|
||||
- **更新于**:2026-10-09(**落籍完成 03c4b4c**,用户自跑提交绕过守卫;状态记录 423):74 文件 +1153/−773 十一批全落 master,核验全过
|
||||
- **更新于**:2026-10-09(**入库完成 03c4b4c**,用户自跑提交绕过守卫;状态记录 423):74 文件 +1153/−773 十一批全落 master,核验全过
|
||||
|
||||
## 项目当前位置(2026-10-11 刷新;实时细节以根目录 `roadmap.md` 与 06-待办清单 为准)
|
||||
- **里程碑**:M3=Alpha 版本的完整实现(2026-10-09 立规:用户未明令宣布 M3 完成前停留 M3,迭代只排 M3 需求,M4 一律不排期)
|
||||
- **迭代**:迭代 19 五卡全部落籍(2026-10-08);迭代 20 尚未开工(头卡=主菜单开局缺陷修复批四件已立,待用户发令);迭代 21/22 规划前提换代后重谈
|
||||
- **迭代**:迭代 19 五卡全部已入库(2026-10-08);迭代 20 尚未开工(头卡=主菜单开局缺陷修复批四件已立,待用户发令);迭代 21/22 规划前提换代后重谈
|
||||
- **近期主战场**:文档治理与设计换代连续批(秘宝/奇物正文换代+件表扩容 27 件+术语统一+天赋树 v0.2+素材库备选节)——批次详情见 git 提交史;下一前沿=专长+秘宝实装批写卡(设计面已清零)与迭代 20 卡A,均待用户发令
|
||||
|
||||
## 未决面(进行中/待人闸/待裁点指针;正主登记处=`design/gdd/06-待办清单.md`)
|
||||
## 未决面(进行中/待人闸/待裁点指针;现行事实源登记处=`design/gdd/06-待办清单.md`)
|
||||
- 待用户裁决:美术审计两项 P0(art-bible 死样张指涉+主角像素管线重产;06 在册);filter-repo 计划书批准或放弃(06 在册);去毒残留词扫否(魔法道具约 30 处/罕见约 18 处,呈报在案);武器锻造 17 裁点逐点拍板(06 在册,推翻即改文档);奇物呈现三处违规改法与档位呈现三路(06 在册);天赋树实装需求卡片 Q1-Q5 五裁点(06 在册);喂雷流 R5 甲重启条件是否从 git 历史捞回落文(一句话件)
|
||||
- 待发令:迭代 20/21/22 规划重启(2026-10-09 用户令冻结,重启=用户直接发令);专长+秘宝实装批写卡段(设计面已清零,等发令)
|
||||
- 进行中:黑话清扫第二波(GDD 正文流程动词族约三千处,随时可派)
|
||||
|
||||
## 状态记录(滚动窗口:仅当前迭代;退役规则见 doc-conventions §10)
|
||||
445. **active.md 状态清理批(2026-10-11,用户令「状态都更新一下,结束的状态就清了」;worktree active-sweep,主会话直执,纯文档零测试)**:①**状态记录 414-444 全数清除**(28 条均已落籍、结论入快照或 06,无未落籍在飞项;git 历史完整可复原)——其中含两组并行撞号各两条:443 号=生存件扩容批(本会话)与术语表建立批(glossary-batch 会话)同号、444 号=天赋树统一落文批(tree-unify 会话)与怪物巢穴退役批同号,清除后编号自 445 起继续递增不重排;②**快照节 19 条瘦回 ≤10**(立宪上限,删 2026-10-09 早期十条)+新增 2026-10-10/11 文档线五批合并行;③**未决面刷新到当下为真**:摘除 X/Y 刷新语义倒置(2026-10-10 用户复述定案,残留=实装批 T0 字段名核对)与「active.md 大裁待放行」两条过期指针;新增武器锻造 17 裁点/天赋树需求卡片 Q1-Q5/喂雷流重启条件捞否三指针;当前位置节刷新(主战场换代+下一前沿=实装批写卡与迭代 20 卡A)。
|
||||
445. **active.md 状态清理批(2026-10-11,用户令「状态都更新一下,结束的状态就清了」;worktree active-sweep,主会话直执,纯文档零测试)**:①**状态记录 414-444 全数清除**(28 条均已入库、结论入快照或 06,无未入库在飞项;git 历史完整可复原)——其中含两组并行撞号各两条:443 号=生存件扩容批(本会话)与术语表建立批(glossary-batch 会话)同号、444 号=天赋树统一落文批(tree-unify 会话)与怪物巢穴退役批同号,清除后编号自 445 起继续递增不重排;②**快照节 19 条瘦回 ≤10**(立宪上限,删 2026-10-09 早期十条)+新增 2026-10-10/11 文档线五批合并行;③**未决面刷新到当下为真**:摘除 X/Y 刷新语义倒置(2026-10-10 用户复述定案,残留=实装批 T0 字段名核对)与「active.md 大裁待放行」两条过期指针;新增武器锻造 17 裁点/天赋树需求卡片 Q1-Q5/喂雷流重启条件捞否三指针;当前位置节刷新(主战场换代+下一前沿=实装批写卡与迭代 20 卡A)。
|
||||
446. **退役词对照表全库强制清扫批(2026-10-11,用户令「正主/落籍两组扫完+前三组终验」;worktree glossary-retire-final,主会话直执,纯文档零测试)**:①正主→现行事实源 130 行+落籍→已入库 79 行全库换代(39 文件;语境微调=权威文档/权威定义节/拼表制主选/入库注记等;doc-conventions §4 禁令行与黑话引举行、秘宝.md 清扫记载行等对照性文本豁免保留);②雷格/惩罚格/板级/门票/工作日志五词终验=零真残留(存量命中全为术语表对照行/更名记载句/禁令引举);③技能 SKILL.md 三件+记忆目录随批同扫;术语表 v1.3 随批登记。
|
||||
@@ -319,7 +319,7 @@
|
||||
| action | 行动族 | 行动点/疾步 |
|
||||
| gp | 金币族 | 钱币/财货 |
|
||||
|
||||
- **呈现约束(2026-09-28 角嵌退役批更新)**:未开格呈现**类型微光单通道**(五组色带,§4.2「类型微光色带」,色相+明度双码;样张 v2 定稿 2026-09-28;可见范围与时机见《HUD框架》「未开格类型微光」节);不呈现极性、不呈现雷/安(信息口径见该正主节);样张批微光组间互辨抽测含明度档互辨(误读率指标出处见《地图战斗资源》极性提案)。
|
||||
- **呈现约束(2026-09-28 角嵌退役批更新)**:未开格呈现**类型微光单通道**(五组色带,§4.2「类型微光色带」,色相+明度双码;样张 v2 定稿 2026-09-28;可见范围与时机见《HUD框架》「未开格类型微光」节);不呈现极性、不呈现雷/安(信息口径见该权威定义节);样张批微光组间互辨抽测含明度档互辨(误读率指标出处见《地图战斗资源》极性提案)。
|
||||
- **状态声明**:键集九值封闭(attack/defense/heal/blast/weaken/pierce/magic/action/gp,与 RewardTable 现行 cell_type 词表一致),扩键走本节修订。
|
||||
- 与 §4.6.1 的关系:同语义域的键(attack↔attack_up 等)可共族设计,键分立、纹样须可区分(格面小记号级对槽内图标级)。
|
||||
- **资产契约(2026-10-06 P1-2 批——审计「6 类地形变异纹带 0 张」缺口收口;尺寸候选,样张批冻结)**:纹带族 = `board/band_<variant_id>.png`(键 = 变异类型 id,键集事实源 = [地形变异](../gdd/systems/排雷循环/地形变异.md)「变异框架与类型清单」region 六行〔荆棘丛/藤蔓缠绕/岩浆/烬覆/落石/矿尘〕+ registry `variant_pool_gate`;通配 global 型〔贫矿脉〕无格子布置域、**不在纹带族**),源 64×64 四边无缝(叠于已开格底)、显示 1× = 格边长。呈现锚 = 「变异格未开时无预告呈现(遭遇式)」——纹带是**已开变异格**的标识层(地形变异 GDD「视觉标识归表现层升级批」的素材承载),半透明叠加、不得侵入数字字形占位区(§4.1 砖心留白同理)。程序化纹带在役 = 占位(◐);出图工单归 PRD,交付后 art-status-checklist 随批 ✅。
|
||||
@@ -382,12 +382,12 @@
|
||||
|
||||
### 6.5 视野迷雾与黑暗区域渲染(棋盘灯光区,2026-10-03 立节)
|
||||
|
||||
> **白话**:战斗棋盘不再整板可见——只有以角色为中心的菱形灯光区看得清,区外没开过的格子沉入全黑,开过的格子留下灰阶的「记忆」。像在洞穴里举灯探索。机制口径(可见性/生命周期/纯呈现纪律)的正主 =《HUD框架》「视野迷雾:菱形灯光区与黑暗边界」节(全项目唯一正主,引用只指路),该节点名「黑暗区域渲染规格(暗淡态明度、迷雾过渡)归 art-bible」,本节即其承载——只管"怎么画",不复述机制。纯呈现层:格态、数字真值、清图判定零影响;零素材新增(全部程序化遮罩/调制);类型微光语义零改动。
|
||||
> **白话**:战斗棋盘不再整板可见——只有以角色为中心的菱形灯光区看得清,区外没开过的格子沉入全黑,开过的格子留下灰阶的「记忆」。像在洞穴里举灯探索。机制口径(可见性/生命周期/纯呈现纪律)的现行事实源 =《HUD框架》「视野迷雾:菱形灯光区与黑暗边界」节(全项目唯一事实源,引用只指路),该节点名「黑暗区域渲染规格(暗淡态明度、迷雾过渡)归 art-bible」,本节即其承载——只管"怎么画",不复述机制。纯呈现层:格态、数字真值、清图判定零影响;零素材新增(全部程序化遮罩/调制);类型微光语义零改动。
|
||||
|
||||
- **菱形灯光区(遮罩几何)**:灯光区 = 以角色所在格为中心、**曼哈顿距离 ≤ LIGHT_RADIUS** 的格集,区内照常渲染。LIGHT_RADIUS 走表值/常量参数化,**基准 8**——正主「灯光区起步半径=微光环 8 格」的落码口径(半径数值沿微光「周围 8 格」的 8 起步,实测后可调)。**两圈分立注**:类型微光作用圈 = 英雄贴身 8 邻格(与可挖域同圈,正主《HUD框架》「未开格类型微光」节),**不随灯光区扩**(正主配套拍板④)——灯光区只裁可见性,微光锚仍是可挖域,两圈几何分立、半径参数互不读写。提灯插值位:FOG_LANTERN_BONUS = **+2**(flat 整数档,正主配套拍板;落码常量名 `board_view.gd FOG_LANTERN_BONUS`——本条旧记 LIGHT_RADIUS_LANTERN_BONUS 系文档侧拟名,随迭代 19 卡④落籍对齐实名),**已接效果落籍**(2026-10-08 迭代 19 卡④:载体=秘宝·同调位 fog_lantern「魔法提灯」行,组合根每战装配链显式重算接线;呈现画法零改动——本节只管"怎么画",机制正主仍归《HUD框架》)。边界随角色格位逐格重算,无半径插值动画。←正主;§2 光照氛围允许域
|
||||
- **区外未开格:全黑不渲染(不透明档,照抄正主)**:正主原文「区外**未开格=全黑不渲染**」——不透明纯黑(L=0),**非高遮蔽半透档**。理由注记(为何不用高遮蔽档):①三档信息阶梯干净——未开格不可见=零信息、记忆格=弱信息、活格=全信息,叠读不打架;②高遮蔽档下砖面纹理隐约残留,与「类型微光=未开格唯一信息通道」(§4.2/§4.6.3)冲突——纹理残影泄格面观感;③正主验收线「区外未开格不可见」须二值态才能逐格断言。←正主;§4.2
|
||||
- **区外已开格:暗淡记忆态(灰显可读档,2026-10-06 UI 设计对齐批 P10 乙换装)**:画法 = **地板纹理原样 + 灰罩压顶**(demo 口径换装——原「程序化素色记忆板平涂」退役;纹理直画后 `FOG_MEMORY_PLATE #3A3A3A` α0.66 灰罩盖顶,素材零改动)+ 格内元素灰阶随罩隐现:**记忆墨 #C4C4C4(中性灰 L≈0.55)**;数字对合成底实测 **≈6.7:1 ≥4.5:1**(WCAG 硬指标;地板纹理均值 #453020 与灰罩合成后 #3E3731 复算,迭代 16 T0)。双峰板色牌格在记忆态**退牌归板**——牌面并入记忆态、数字以记忆墨直画。可辨性自查判据(三通道,落码后随样张/实机自检):①对全黑未开格——合成底 #3E3731(L≈0.036)对 L0,实机目检常光档可分(暗房档一并抽检);②对灯光区内活态已开格——主判据=数字墨灰度差(记忆墨 L0.55 对亮墨三档 L≥0.75 / 色牌 #F5EAD3 L≈0.83,灰度 ΔL≥0.20)+ 色相通道(记忆态近中性灰,对活态暖底暖墨);格底明度差为辅助通道;③格态三形在记忆态保持灰度可辨——形通道经纹理+灰罩形态不变,沿 §1.4 验收 2 同源判据。**旗不在记忆态面**:旗只插在未开格,区外未开格全黑——旗印记随格隐没、灯光区移回复显(纯呈现,旗数据零影响,正主口径的显式推论)。←HUD框架 可访问性基线;§4.1;§1.4;§3.2
|
||||
- **迷雾过渡边:硬边(逐格二值)**:灯光区边界 = **整格二值切换**(区内全渲染 / 区外全黑或记忆态),**不做渐变过渡带、不做半透明晕边**。理由:①边界是信息边界不是氛围晕——渐变中间态 =「看得见但看不清」,破数字可读硬指标与记忆态明度档;②正主验收断言(边界格呈态、两态逐位一致)须格级二值可判;③与砖面整格表达(§3.2 高墙瓦片体系)、ITB 格内信息分层气质同轴。无动画,减动效无涉。←正主;§1.2 原则一;§3.2
|
||||
- **菱形灯光区(遮罩几何)**:灯光区 = 以角色所在格为中心、**曼哈顿距离 ≤ LIGHT_RADIUS** 的格集,区内照常渲染。LIGHT_RADIUS 走表值/常量参数化,**基准 8**——现行事实源「灯光区起步半径=微光环 8 格」的落码口径(半径数值沿微光「周围 8 格」的 8 起步,实测后可调)。**两圈分立注**:类型微光作用圈 = 英雄贴身 8 邻格(与可挖域同圈,现行事实源《HUD框架》「未开格类型微光」节),**不随灯光区扩**(权威文档配套拍板④)——灯光区只裁可见性,微光锚仍是可挖域,两圈几何分立、半径参数互不读写。提灯插值位:FOG_LANTERN_BONUS = **+2**(flat 整数档,权威文档配套拍板;落码常量名 `board_view.gd FOG_LANTERN_BONUS`——本条旧记 LIGHT_RADIUS_LANTERN_BONUS 系文档侧拟名,随迭代 19 卡④入库对齐实名),**已接效果入库**(2026-10-08 迭代 19 卡④:载体=秘宝·同调位 fog_lantern「魔法提灯」行,组合根每战装配链显式重算接线;呈现画法零改动——本节只管"怎么画",机制现行事实源仍归《HUD框架》)。边界随角色格位逐格重算,无半径插值动画。←现行事实源;§2 光照氛围允许域
|
||||
- **区外未开格:全黑不渲染(不透明档,照抄现行事实源)**:现行事实源原文「区外**未开格=全黑不渲染**」——不透明纯黑(L=0),**非高遮蔽半透档**。理由注记(为何不用高遮蔽档):①三档信息阶梯干净——未开格不可见=零信息、记忆格=弱信息、活格=全信息,叠读不打架;②高遮蔽档下砖面纹理隐约残留,与「类型微光=未开格唯一信息通道」(§4.2/§4.6.3)冲突——纹理残影泄格面观感;③现行事实源验收线「区外未开格不可见」须二值态才能逐格断言。←现行事实源;§4.2
|
||||
- **区外已开格:暗淡记忆态(灰显可读档,2026-10-06 UI 设计对齐批 P10 乙换装)**:画法 = **地板纹理原样 + 灰罩压顶**(demo 口径换装——原「程序化素色记忆板平涂」退役;纹理直画后 `FOG_MEMORY_PLATE #3A3A3A` α0.66 灰罩盖顶,素材零改动)+ 格内元素灰阶随罩隐现:**记忆墨 #C4C4C4(中性灰 L≈0.55)**;数字对合成底实测 **≈6.7:1 ≥4.5:1**(WCAG 硬指标;地板纹理均值 #453020 与灰罩合成后 #3E3731 复算,迭代 16 T0)。双峰板色牌格在记忆态**退牌归板**——牌面并入记忆态、数字以记忆墨直画。可辨性自查判据(三通道,落码后随样张/实机自检):①对全黑未开格——合成底 #3E3731(L≈0.036)对 L0,实机目检常光档可分(暗房档一并抽检);②对灯光区内活态已开格——主判据=数字墨灰度差(记忆墨 L0.55 对亮墨三档 L≥0.75 / 色牌 #F5EAD3 L≈0.83,灰度 ΔL≥0.20)+ 色相通道(记忆态近中性灰,对活态暖底暖墨);格底明度差为辅助通道;③格态三形在记忆态保持灰度可辨——形通道经纹理+灰罩形态不变,沿 §1.4 验收 2 同源判据。**旗不在记忆态面**:旗只插在未开格,区外未开格全黑——旗印记随格隐没、灯光区移回复显(纯呈现,旗数据零影响,现行事实源口径的显式推论)。←HUD框架 可访问性基线;§4.1;§1.4;§3.2
|
||||
- **迷雾过渡边:硬边(逐格二值)**:灯光区边界 = **整格二值切换**(区内全渲染 / 区外全黑或记忆态),**不做渐变过渡带、不做半透明晕边**。理由:①边界是信息边界不是氛围晕——渐变中间态 =「看得见但看不清」,破数字可读硬指标与记忆态明度档;②现行事实源验收断言(边界格呈态、两态逐位一致)须格级二值可判;③与砖面整格表达(§3.2 高墙瓦片体系)、ITB 格内信息分层气质同轴。无动画,减动效无涉。←现行事实源;§1.2 原则一;§3.2
|
||||
- **与结算期去饱和的叠加共存**:结算期去饱和偏移(settlement_fx_view,同族先例)与迷雾调制叠加口径 = **记忆态为终态档**——区外已开格在结算期保持记忆态档、**不再叠加**结算去饱和(灰显已含去饱和语义,二次调制无信息增量且明度不可控);灯光区内格照常吃结算去饱和;全黑格两态无差。叠加态随实施批共存校验 + 探针断言(provisional,实机目检可代拍)。←需求卡片 T3/T4
|
||||
- **§2 明度禁令自查**:迷雾遮蔽与记忆态灰显属 §2 明度分层**光照氛围允许域**(洞穴举灯的空间光照呈现,与 Moonlighter 取列「亮地板/暗深渊/发光体」光照层次同族),非情绪压暗(§9.2 Darkest 反面条款不触——那禁的是情绪表达)、非状态明暗编码(格态语义仍由形+色相承载,灰度下三态可辨不受扰)。←§2;§9.1;§9.2
|
||||
|
||||
@@ -521,11 +521,11 @@
|
||||
- **v3.8(2026-10-06)零定义资产族契约批(P1-2,用户拍板「写进圣经、不另立文件」)**:零素材新增,纯契约登记——①§4.6.2 奖励徽章 19 枚资产契约(`ui/icons/reward_<reward_id>.png`,源 40×40,显示 20/40 双档候选);②§4.6.3 新增地形变异纹带族资产契约(`board/band_<variant_id>.png`,键集事实源 = 地形变异 GDD region 六行,源 64×64 无缝,已开变异格标识层);③§6.1 舞台背景插画资产契约(`stage/stage_bg.png` 基准一张 1280×270,三关换挡走 wall_ambient tint 槽不出三张)。三族照抄状态图标「键→文件名→尺寸」模式(§4.6.1 全链唯一完全合规族,审计点名可复制);程序化占位在役,出图工单归 PRD;art-status-checklist 看板随交付 ✅。
|
||||
- **v3.7(2026-10-06)立绘八敌定档批+方案二排版落文+归档纪律(P0 收口讨论批;工作流程铁律 = 讨论期只动文档,代码实装另批走 PRD→迭代)**:①**§8.2 画布基准——站桩立绘源档八敌逐键定档**(goblin 36/giant_spider 38/duergar 46/hook_horror 58/bugbear 62/ogre_chief 74/drider 90/duergar_king 94,×2 整数显示;原三档 48/64/96 候选与 v3.0 档位上调方向候选一并收口;依据 = 用户三体型约束+定档总图确认;可读性门槛源高 ≥32 实测;派生管线 = pixel-1→紧裁→dom_block_resize);②**§8.2 缩放纪律——站桩立绘排版 = 方案二**(B 区 270 ≈1/3/C 区 530 ≈2/3/扫雷盘 438 不缩;立绘底锚落台+血条状态落底排全场对齐+大体档探顶;原「血条悬浮头顶」退役——高盒空洞用户点名否决);③**§8.3 归档纪律**(P0-1 用户口径:图片不入 git/归档+对象存储/主文档禁引用 artwork 散路径);④连带 = character-design.md §5.2 体量语义修订(强度先验→生物体型)+§5.5 源档注记+钩爪恐魔宽≥高豁免登记、battle.md 区表/组件/线框/空态/修订记录随批。
|
||||
- **v3.6(2026-10-04)站桩槽「高定宽随」条款落规(UI 重设计原型审计教训)**:§8.2 缩放纪律新增**站桩立绘槽位=高定宽随**条——槽位只定高度的整数倍档、宽度随源图宽高比自适应,禁统一方框强拉(纵横倍率恒等;实例=原型 88×92 方框把 23×48 地精横拉 3.83×/纵拉 1.92×、26×48 熊地精 3.38×/1.92× 压扁,46×48 主角近方恰等比独活;三层成因=窄条源图/方框一刀切/非整数倍 pixelated 发花);**乙类非整数豁免口径收窄注记=只覆盖等比缩放,不含纵横异倍变形**。同批原型侧修复=站槽 height:96 width:auto(48px 源 2×)+开始屏背景怪/大立绘/庆祝像/旗/图标显示尺寸整数倍对齐。文档核查=battle.md/HUD框架 均无强制方框条文(缺口是规则本身缺位,本批补)
|
||||
- **v3.5(2026-10-03)视野迷雾黑暗区域渲染规格批(迭代 11 第④批实施批 T1;上位裁决=《HUD框架》「视野迷雾」节 v0.13,正主已定论照抄)**:新增 §6.5——菱形灯光区=曼哈顿距离 ≤LIGHT_RADIUS(基准 8,表值/常量参数化;两圈分立注=类型微光仍贴身 8 邻格不随灯光区扩;提灯 +2 插值位预留不接效果);区外未开格全黑不渲染(照抄正主「全黑不渲染」,非高遮蔽档,三档信息阶梯理由在节内);区外已开格暗淡记忆态(记忆板 #3A3A3A/记忆墨 #C4C4C4 provisional,数字 ≥4.5:1,三通道可辨判据在案,色牌格退牌归板,旗印记随未开格全黑隐没);过渡边=硬边逐格二值(禁渐变晕边);结算期去饱和叠加互斥口径(记忆态为终态档);§2 光照氛围允许域自查注记在节内;§6 开篇枚举行补「棋盘视野迷雾遮蔽」一词。纯呈现层零素材新增(程序化遮罩/调制),微光语义零改动,明度值 provisional(样张/实机自检锚,代拍板白名单内)
|
||||
- **v3.5(2026-10-03)视野迷雾黑暗区域渲染规格批(迭代 11 第④批实施批 T1;上位裁决=《HUD框架》「视野迷雾」节 v0.13,现行事实源已定论照抄)**:新增 §6.5——菱形灯光区=曼哈顿距离 ≤LIGHT_RADIUS(基准 8,表值/常量参数化;两圈分立注=类型微光仍贴身 8 邻格不随灯光区扩;提灯 +2 插值位预留不接效果);区外未开格全黑不渲染(照抄现行事实源「全黑不渲染」,非高遮蔽档,三档信息阶梯理由在节内);区外已开格暗淡记忆态(记忆板 #3A3A3A/记忆墨 #C4C4C4 provisional,数字 ≥4.5:1,三通道可辨判据在案,色牌格退牌归板,旗印记随未开格全黑隐没);过渡边=硬边逐格二值(禁渐变晕边);结算期去饱和叠加互斥口径(记忆态为终态档);§2 光照氛围允许域自查注记在节内;§6 开篇枚举行补「棋盘视野迷雾遮蔽」一词。纯呈现层零素材新增(程序化遮罩/调制),微光语义零改动,明度值 provisional(样张/实机自检锚,代拍板白名单内)
|
||||
- **v3.4(2026-10-01)数字呈现三态修订(甲案深墨族方案渲染帧取证证伪后改版)**:v3.3 的「L2/L3 切深墨族直画」经 board_shot_probe 渲染帧取证证伪——underdark 系地板双峰纹理(近黑斑 p10 0.011+近白筋 p90 0.40+)上深墨直画融黑斑隐形(用户实机复测「还是看不清」实证),任何墨族直画不可救;改**三态**:dungeon 亮族直画(门 p90≥4.5/均值≥2.5)/中暗板深墨直画(门 p90≥4.5/均值≥3.0)/双峰板**色牌垫底**(素牌+深墨 12:1,v2 色牌形制复役);机检三关呈现模式断言 19/19;目视验证面=board_shot_probe 渲染帧取证入流程(机检≠看得清)。§1.4 样张闸第四验收项判读随三态口径件注记。
|
||||
- **v3.3(2026-10-01)数字墨按板自适应修订(L2/L3 亮瓦融字缺陷修复,用户裁甲案「墨色按关自适应+补三关对比断言」)**:§4.1 数字墨双色制①改**按板自适应双族**——暗纹理板维持亮族三档(样张 v3 冻结原样),亮筋纹板(underdark/deep_underdark)切深墨族三档(青墨/赭墨/锈墨复役);选族判据=所选族对归一后地板 p90 亮斑 ≥4.5:1 且对均值 ≥2.0:1,落码单点 `board_view._digit_ink_mode`,机检=`terrain_tile_sets_test` 三关对比断言 21/21;缺盘平色回退默认深墨族。§4.1 其余条款(字形唯一载体/三档色温/垫牌后备)不变。
|
||||
- **v3.1(2026-09-30)越权清理批(用户指令:按域内审查修订案修改,概念定义归还 GDD 正主)**:①**微光口径四处改指路**——§1.2 原则三/§1.4 样张清单去「常显」、§4.2 色带条去「常显」、§4.6.3 去「全部未开格」,统一指路《HUD框架》「未开格类型微光」节(2026-09-30 收口批落位的唯一正主,他文只许指路);②**概念越权剥离**——危险格叙事属名与换轴史、封印插旗语义(→registry「封印」条+《排雷玩法》玩家说法)、极性定义(→《地图战斗资源》极性提案)、完美排雷定义与兑付结构(→同)、敌意图预告语义与「待机即预示」(→《敌人系统》意图线索节)、奖励 weight 与兑付/库存语义(→《地图战斗资源》)、键名沿革史(empower/fortify 来源=敌方技能施放、alert 2026-09-20 八型批换装、ac_up 2026-09-16 换装——自 §4.6.1 移除留痕)、甲档 armor 数据实态(L1 全轻甲/L2 除 drider 外全轻甲/L3 duergar·duergar_king 重甲)与旧键集史({grub, ambusher} 随 DND 更名退役——自 §4.6.4 移除留痕)、「敌不占格」断言、「类型分布即先验」机制 rationale、「分布属初始化随机」归属断言(改画法口径「分布每板一次跨轮不复掷」);③**实装状态与排期注记移本历史留痕**——游戏 UiKit.HERO_BLUE 已同步 #2E6E8E→#2E86DE、UiKit.CONTACT_GLOW 同值 #D6ECFF、旧可挖域绿相 DIG_EDGE 已随接触带方案退役、死亡表现切片实装=程序化 tween(灰化罩+碎块弹飞 5 块 0.45s,挂 unit_died)、封印特效「待表现批」、§6.1 背景插画「排期归表现层升级批」、panel_stone/button_stone 接线归最近表现批、§7.2 对比度违例「修复归表现批」、§7.5「占位不空窗」注记;④**角嵌退役条改写**为现行「未开格预读通道(微光单通道)」条(退役史见 v2.12);⑤**残留矛盾清除**——§3.2 呈现基准条「装饰变体一律纹理级」旧措辞随 v3.0 物件级解禁同步;⑥§2.8 营地承载元素/§7.5 钥石呈现位改指 §6.2(事实源边界在该节);⑦**补漏五处(同批完工审计发现,同类剥离留痕)**——§4.1 危险红「机关红」更名史、§6.2 营地贴图「排期归 UI 贴图重构批」与「占位不空窗」注记、§7.4 字体「接入归表现批」注记、§8.1 扩板与 1920 档换算值「归表现层升级批成文」(改债务指路 06「分辨率档位与棋盘格边长口径」条)、§8.3 「终稿目录归表现批定」注记、§1.4 整屏样张闸「表现层落码批开工前」改屏级落码开工前、§7.1 「样式终稿归样张后表现批」改随样张闸后定稿。**零美术信息损失**:全部色值/机检断言/纹样描述/画法参数不动,样张 v2 四冻结之②③维持
|
||||
- **v3.2(2026-09-30)样张 v3 冻结批+缩放分级修订+案甲落定(迭代 9 T1/T2/T9;需求卡片已退役(git 710f9b7 出口批))**:①§1.4 补**样张 v3 冻结记录**——机检 17/17 全绿,断言定值两件(A3b 图底分离定值 Δ≥30〔实测 38〕/A4 尺寸基线硬等冻结 立绘 46×48+小人源 32×32),F6 沿用 v3.4;**四冻结①④重冻**——①砖面形态=E 格高墙 30% 词表扩展+格底明度分档(世界底层档 L≈0.10)+装饰物件级解禁/④数字形制=亮墨三档直画+色牌后备;②色板③动画维持冻结。产物 `artwork/mockups/sample-batch-v3-final-2026-09-30.png`+机检报告【冻结】;气质终审=2026-09-29 用户验收豁免(台账 281)。②**§8.2 缩放纪律分级修订**(2026-09-26 用户裁「改规则不豁免」落文,修订窗口=v3.0 落籍):甲类文本语义件(数字/图标/旗/砖面/纹样)维持严格整数倍;乙类角色精灵允许运行时非整数倍(NEAREST 不变,判据=实机目检可感不适即回整数档);1920 档策略经三裁决**案甲落定**(全局等比 stretch keep——v3.2 当日 T9 落文,详见 §8.2)。头注「现行为」随批 v3.2。
|
||||
- **v3.1(2026-09-30)越权清理批(用户指令:按域内审查修订案修改,概念定义归还 GDD 权威文档)**:①**微光口径四处改指路**——§1.2 原则三/§1.4 样张清单去「常显」、§4.2 色带条去「常显」、§4.6.3 去「全部未开格」,统一指路《HUD框架》「未开格类型微光」节(2026-09-30 收口批落位的唯一事实源,他文只许指路);②**概念越权剥离**——危险格叙事属名与换轴史、封印插旗语义(→registry「封印」条+《排雷玩法》玩家说法)、极性定义(→《地图战斗资源》极性提案)、完美排雷定义与兑付结构(→同)、敌意图预告语义与「待机即预示」(→《敌人系统》意图线索节)、奖励 weight 与兑付/库存语义(→《地图战斗资源》)、键名沿革史(empower/fortify 来源=敌方技能施放、alert 2026-09-20 八型批换装、ac_up 2026-09-16 换装——自 §4.6.1 移除留痕)、甲档 armor 数据实态(L1 全轻甲/L2 除 drider 外全轻甲/L3 duergar·duergar_king 重甲)与旧键集史({grub, ambusher} 随 DND 更名退役——自 §4.6.4 移除留痕)、「敌不占格」断言、「类型分布即先验」机制 rationale、「分布属初始化随机」归属断言(改画法口径「分布每板一次跨轮不复掷」);③**实装状态与排期注记移本历史留痕**——游戏 UiKit.HERO_BLUE 已同步 #2E6E8E→#2E86DE、UiKit.CONTACT_GLOW 同值 #D6ECFF、旧可挖域绿相 DIG_EDGE 已随接触带方案退役、死亡表现切片实装=程序化 tween(灰化罩+碎块弹飞 5 块 0.45s,挂 unit_died)、封印特效「待表现批」、§6.1 背景插画「排期归表现层升级批」、panel_stone/button_stone 接线归最近表现批、§7.2 对比度违例「修复归表现批」、§7.5「占位不空窗」注记;④**角嵌退役条改写**为现行「未开格预读通道(微光单通道)」条(退役史见 v2.12);⑤**残留矛盾清除**——§3.2 呈现基准条「装饰变体一律纹理级」旧措辞随 v3.0 物件级解禁同步;⑥§2.8 营地承载元素/§7.5 钥石呈现位改指 §6.2(事实源边界在该节);⑦**补漏五处(同批完工审计发现,同类剥离留痕)**——§4.1 危险红「机关红」更名史、§6.2 营地贴图「排期归 UI 贴图重构批」与「占位不空窗」注记、§7.4 字体「接入归表现批」注记、§8.1 扩板与 1920 档换算值「归表现层升级批成文」(改债务指路 06「分辨率档位与棋盘格边长口径」条)、§8.3 「终稿目录归表现批定」注记、§1.4 整屏样张闸「表现层落码批开工前」改屏级落码开工前、§7.1 「样式终稿归样张后表现批」改随样张闸后定稿。**零美术信息损失**:全部色值/机检断言/纹样描述/画法参数不动,样张 v2 四冻结之②③维持
|
||||
- **v3.2(2026-09-30)样张 v3 冻结批+缩放分级修订+案甲落定(迭代 9 T1/T2/T9;需求卡片已退役(git 710f9b7 出口批))**:①§1.4 补**样张 v3 冻结记录**——机检 17/17 全绿,断言定值两件(A3b 图底分离定值 Δ≥30〔实测 38〕/A4 尺寸基线硬等冻结 立绘 46×48+小人源 32×32),F6 沿用 v3.4;**四冻结①④重冻**——①砖面形态=E 格高墙 30% 词表扩展+格底明度分档(世界底层档 L≈0.10)+装饰物件级解禁/④数字形制=亮墨三档直画+色牌后备;②色板③动画维持冻结。产物 `artwork/mockups/sample-batch-v3-final-2026-09-30.png`+机检报告【冻结】;气质终审=2026-09-29 用户验收豁免(台账 281)。②**§8.2 缩放纪律分级修订**(2026-09-26 用户裁「改规则不豁免」落文,修订窗口=v3.0 已入库):甲类文本语义件(数字/图标/旗/砖面/纹样)维持严格整数倍;乙类角色精灵允许运行时非整数倍(NEAREST 不变,判据=实机目检可感不适即回整数档);1920 档策略经三裁决**案甲落定**(全局等比 stretch keep——v3.2 当日 T9 落文,详见 §8.2)。头注「现行为」随批 v3.2。
|
||||
- **v3.0(2026-09-29)中修批(案 B,用户拍板;审视报告=git fbaadb8(已退役),六病根+三案呈报)**:①**§2 明度恒定→明度分层**——三档明度带(信息面层/世界中层/世界底层),情绪与状态明暗禁令保留(状态区分仍只走色相/饱和/运动/元素),空间纵深/光照/形体塑造开允许域;§2.1/2.2/2.3/2.5/2.7 各状态条措辞随改,§2.7 增「明度带随深度微移」候选。②**原则二色牌降级**——「明亮为皮,色牌为骨」改「明度分档为骨」:已开格走世界底层档(候选 L 0.20–0.32),棋盘数字墨亮族直画(候选 L≥0.75,冷亮/暖白/金亮三档色温承袭密度语义),色牌仅复杂格底后备(垫牌场景用深墨族,12.3:1 实测保留);§1.4 验收 1/2/4 与判定回退口径同步,样张 v2 四冻结之①④(砖面形态之数字承载面/数字形制)**解冻待样张 v3 重冻**(②③冻结〔色板/动画〕不受影响)。③**语义色适用域限定**——§4.2 各条「X 只说 Y」约束信息层与语义物件,纯环境氛围解禁(焦点预算与低饱和后退接管防抢焦);紫赤禁入带环境层低饱和可入、高饱和独占不变;§4.3 换皮槽与不变槽口径随改。④**装饰变体物件级解禁**——专属装饰形状家族+零信息纪律不变+焦点预算约束,配额候选 3–5 种(原则三/§3.2)。⑤**§6.1 舞台正面目标**——B 区=地窟看台(地台/落影/光源氛围候选),补原条只有负面约束之缺。⑥**§1.4 整屏样张闸新增**——战斗/关卡/菜单/营地四屏,验收四项(全局文字 ≥4.5:1/明度三档带/整屏焦点预算/文字禁压纹理),闸形=方向稿目检先行→机检冻结。⑦**§7 三件**——7.1 占位收口条款(占位=临时态,终稿闸=整屏样张)/7.2 全局文字可读性硬指标/7.4 字号下限 16/14px 对齐 ux-designer PC 规范+层级手段解禁(字号档差+墨色+字重)。⑧**§8.2 档位上调方向候选**(主角 64×96/敌 64/96/128 评估,归整屏样张闸,本批不重产资产)。⑨**§9 参考表**——Moonlighter 取列增光照层次、§9.2 DD 条款改名+新增「传统扫雷白牌」反面行。⑩**§3.4 焦点双机制**(完整度+明度带)。**连带文档同步**:character-design.md(提灯点亮解禁候选)/interaction-patterns.md/level-map.md/art-assets-checklist.md/battle.md/04-美术音频方向.md 引用口径随批。**挂账(06 登记)**:样张 v3 重跑批(断言改造+新参数冻结)/ui_kit 与棋盘渲染落码批(明度分层/格底分档/亮墨/UI 对比度修复)/资产升档重产批/mockup v3 方向稿(按 v3.0 重出)。**代拍板三项 2026-09-29 当日已追认**(闸形两段式/色牌后备范围/升档只立方向)。
|
||||
- **v2.15(2026-09-28)人设旗脱钩批(用户拍板)**:§5.4 速览背包旗改旗朱红矩形旗+§4.1 封印黑条红族口径限定棋盘侧;封印黑仍为棋盘封印专属色不变;人设侧详见 character-design 对应版本行(v1.7)
|
||||
- **v2.14(2026-09-28)关卡画面样张 v1 冻结批(M-2 迭代 4 T1–T4,机检闸形 A——11/11 全绿即冻结)**:§7.2 增「暗底呈现态双色墨制」条(暗底系图标/读数=暖白 #F0E2C8、当前金底转深墨 #181410,各态 ≥4.5:1;已过节点暗金冻结 **GOLD_DONE #68562C** 专用呈现态值——旧 GOLD_DIM #8C743C 对双色墨均不达标;Boss 描边=紫赤 2px+外缘 1px 深墨环灰度冗余通道——§4.2 色相独占本色不变);冻结面=节点图标形制(♻ kenney-board-game-icons 五键 bow/award/campfire/crown_b/pouch,20px 烘焙 1:1 消费,WARM 单色,复用闸①②③④)+通道质感(折线 2/3/4px 直角肘形)+画布公式(70+层×122+34/52+槽×58+26+8 下限 620×240——routebug 83c11a1 根修件同源)+底栏样式(暗数据框 WARM/WARM_SOFT 双墨)+屏底(BG_ROOT+backdrop_stone);换层色板渐变挂点落码(§2.7 切片档——level_index→tint 表候选值随 §6.3 方向,明度带归一,终值归色板样张批)。规格承载=level-map.md(修订记录同日行);产物=`artwork/mockups/level-map-sheet-v1-2026-09-28.png`,机检报告=git 提交 9a79927;气质终审=M-2 出口闸真人目检
|
||||
|
||||
@@ -259,7 +259,7 @@ Pixel art style. true pixel art game sprite drawn on a tiny 48x72 pixel canvas,
|
||||
**对话式生图控制纪律(2026-09-25/26 实证)**:
|
||||
1. 同对话续写=对上一张图的**编辑模式**——变体必须各开新对话;同一对话里"same as X but ..."会被当成对最近一张的增量编辑。
|
||||
2. 英文 prompt 服从度明显高于中文(Gemini/Nano Banana 语料结构使然),提示词一律英文。
|
||||
3. **地形瓦片出图制式 = 拼表制正主(2026-10-06 用户拍板,操作单见 remote-gen-prompts §3)**——一张整图容纳全部瓦片变体,后处理裁切取用:风格统一、一张管住全族。画框风险的缓解 = ①出图贴程序占位样图作参考(模型有具体锚定就不乱画框)②裁切时每格内缩 2–3% 切掉边框③统一降采样(结构归程序)。**分张(一张一跑)降为回退路径**:仅当拼表连续画框失败时改用。〔实证教训保留:2026-09-25/26 裸拼表(无参考图)必诱画框——教训归因于缺参考锚定,非拼表制本身〕
|
||||
3. **地形瓦片出图制式 = 拼表制主选(2026-10-06 用户拍板,操作单见 remote-gen-prompts §3)**——一张整图容纳全部瓦片变体,后处理裁切取用:风格统一、一张管住全族。画框风险的缓解 = ①出图贴程序占位样图作参考(模型有具体锚定就不乱画框)②裁切时每格内缩 2–3% 切掉边框③统一降采样(结构归程序)。**分张(一张一跑)降为回退路径**:仅当拼表连续画框失败时改用。〔实证教训保留:2026-09-25/26 裸拼表(无参考图)必诱画框——教训归因于缺参考锚定,非拼表制本身〕
|
||||
4. 差异特征写第一句并给否定约束(如碎石斑变体须写明 `no cracks, no dark lines`);尺寸不写死(模型自定,原图越大裁切余量越足,后处理统一降采样)。
|
||||
|
||||
**①墙顶基面(无缝岩石)**:
|
||||
@@ -292,8 +292,8 @@ Seamless tileable pixel art texture of dry dirt ground, top-down, for a dungeon
|
||||
|
||||
## 版本历史
|
||||
|
||||
- **v3.1(2026-10-06)渠道定位+拼表制正主批(用户拍板)**:①**渠道定位更正——远程对话式生图为主、本地 ComfyUI 为备选**(v2.7「彻底关闭」为当时口径,现行更正为备选;§0 使用流程随改);②**§4bis 纪律 3 改制**——地形瓦片出图 = 拼表制正主(三步流程:程序占位样图参考 → 整图生成 → 裁切+统一降采样;操作单 remote-gen-prompts §3),分张降为回退路径(裸拼表画框实证教训归因于缺参考锚定,非拼表制本身);③与 remote-gen-prompts 分工写明:本文件 = 词库正文、remote-gen = 对话操作单,正文不双处维护。
|
||||
- **v3.0(2026-10-06)地形色值对齐批(审计 P1-1,用户拍板色值正主 = 圣经 §4.1)**:§4bis 四张地形卡色值漂移修正——岩石系 `#8B755B`→**`#C9AF83`(掩尘/未开格)**、地面系 `#564232`→**`#B39A78`(裸土/已开格)**;remote-gen-prompts.md 2×2 拼图卡同批对齐。提示词侧色值自此以圣经 §4.1 为唯一正主。
|
||||
- **v3.1(2026-10-06)渠道定位+拼表制主选批(用户拍板)**:①**渠道定位更正——远程对话式生图为主、本地 ComfyUI 为备选**(v2.7「彻底关闭」为当时口径,现行更正为备选;§0 使用流程随改);②**§4bis 纪律 3 改制**——地形瓦片出图 = 拼表制主选(三步流程:程序占位样图参考 → 整图生成 → 裁切+统一降采样;操作单 remote-gen-prompts §3),分张降为回退路径(裸拼表画框实证教训归因于缺参考锚定,非拼表制本身);③与 remote-gen-prompts 分工写明:本文件 = 词库正文、remote-gen = 对话操作单,正文不双处维护。
|
||||
- **v3.0(2026-10-06)地形色值对齐批(审计 P1-1,用户拍板色值现行事实源 = 圣经 §4.1)**:§4bis 四张地形卡色值漂移修正——岩石系 `#8B755B`→**`#C9AF83`(掩尘/未开格)**、地面系 `#564232`→**`#B39A78`(裸土/已开格)**;remote-gen-prompts.md 2×2 拼图卡同批对齐。提示词侧色值自此以圣经 §4.1 为唯一事实源。
|
||||
|
||||
- **v2.9(2026-09-26)地形填充纹理节批**(高墙批收官,用户拍板):新增 §4bis——地形类首张卡(墙顶基面/裂纹/碎石斑/地面四张自包含英文卡)+对话式生图控制纪律四条(编辑模式/英文优先/分张跑/否定约束);分工纪律转写 art-bible §8.5「生产分工」(模型只出无缝填充纹理,结构件程序化)。
|
||||
|
||||
|
||||
@@ -78,7 +78,7 @@ Pixel art style. true pixel art game sprite drawn on a tiny 48x72 pixel canvas,
|
||||
|
||||
## 3. 瓦片纹理
|
||||
|
||||
**制式 = 拼表制正主(2026-10-06 用户拍板)——三步流程**:
|
||||
**制式 = 拼表制主选(2026-10-06 用户拍板)——三步流程**:
|
||||
1. **程序占位出样图**:现行程序化格面(占位在役)截一张作参考样图;
|
||||
2. **整图生成**:开新对话,贴样图 + 发下方整段,一张 2×2 出全部瓦片变体(风格统一、一张管全族);
|
||||
3. **裁切取用**:按 50% 坐标切图、每格内缩 2–3% 切掉可能的边框 → 统一降采样 → 成片瓦片 21 枚由程序从切出的材质合成(词表:高墙瓦片词表(已落码 board_world.gd 查表,文件已退役))。
|
||||
|
||||
@@ -125,11 +125,11 @@
|
||||
| 概念状态用枚举 | 概念的类型与状态写成封闭枚举并列全成员(例:格的类型 = 安全格 / 危险格,格的状态 = 未开 / 已开);禁止用散文形容词零散罗列状态 |
|
||||
| 附加物独立成对象 | 挂在概念上的附加内容若自己有一组属性或规则要写(例:格上的奖励/惩罚 = 格面资源),就是独立对象——父概念只保留挂载位(如"有无资源资格"),禁止把附加物摊平成父概念的一堆属性字段 |
|
||||
| 关系不吸内容 | 概念间关系只写"有没有关系、是什么关系";对方的属性与规则留在对方名下——与第 8 节"引用不转述"同源 |
|
||||
| 落位五要素 | 概念的正主文档必须写全五要素:**定义**(它是什么)/ **作用对象与范围**(作用在谁、什么范围内有效)/ **生命周期**(何时出现、何时变化、何时消失、怎么重置)/ **关联**(与谁衔接、边界归谁、哪些指路别处)/ **状态**(已定稿/待实施/已退役)。缺任何一项都是半成品概念,如同对象缺了构造函数(2026-09-30 微光口径事故后补成) |
|
||||
| 落位五要素 | 概念的权威文档必须写全五要素:**定义**(它是什么)/ **作用对象与范围**(作用在谁、什么范围内有效)/ **生命周期**(何时出现、何时变化、何时消失、怎么重置)/ **关联**(与谁衔接、边界归谁、哪些指路别处)/ **状态**(已定稿/待实施/已退役)。缺任何一项都是半成品概念,如同对象缺了构造函数(2026-09-30 微光口径事故后补成) |
|
||||
|
||||
**切分正例**(现行排雷循环即按此切分):棋盘是地图级对象,包含多个格;格是成员对象,危险格/安全格是它的枚举属性;格上可能挂的奖励或惩罚(格面资源)是独立对象,本体与规则归地图战斗资源与战斗结算,格只保留"有无资源资格"一个挂载位。反面基准:把奖励的类型、数值、极性全摊开写成格子的属性字段——奖励规则一改,棋盘文档就得跟着改,这便是没封装。
|
||||
|
||||
**无正主,不下定义**:一个概念还没有正主文档时,任何其他文档都不得替它下定义——只能引用概念名,并在 06-待办清单登记「待落位」;谁先立正主,谁拿走全部定义权。(2026-09-30 微光事故:类型微光长期无正主文档,art-bible 复述、06 登记、需求卡片摘要三处各自给出口径,范围限定词在层层复述中丢失,最终放大成「全板常显」的错误事实。)
|
||||
**无权威文档,不下定义**:一个概念还没有权威文档时,任何其他文档都不得替它下定义——只能引用概念名,并在 06-待办清单登记「待落位」;谁先立权威文档,谁拿走全部定义权。(2026-09-30 微光事故:类型微光长期无权威文档,art-bible 复述、06 登记、需求卡片摘要三处各自给出口径,范围限定词在层层复述中丢失,最终放大成「全板常显」的错误事实。)
|
||||
|
||||
**落盘载体**:概念对象登记 `design/registry/entities.yaml`(owner 与 referenced_by 由此机械维护);文档里概念怎么切,registry 就怎么登记,代码里的对象划分与之同构。
|
||||
|
||||
@@ -143,7 +143,7 @@
|
||||
|---|---|
|
||||
| 单点定义 | 每个概念只在 owner 文档里定义一次,registry 术语条目登记其规范名 |
|
||||
| 规范名唯一 | 正文只准用规范名,禁止别名散开——否则删除时 grep 搜不全 |
|
||||
| 引用不转述 | 跨文档引用 = 规范名 + 链接,禁止复述对方的规则细节、公式、数值与口径;确需携带口径时,作用对象/范围/生命周期必须随句写全或显式指路——禁止只复述形容词,「常显」「恒亮」这类词不带范围就是半句话(2026-09-30 微光口径事故的直接形态);若发现自己需要一条规则,那是自己的概念,先立正主再定义 |
|
||||
| 引用不转述 | 跨文档引用 = 规范名 + 链接,禁止复述对方的规则细节、公式、数值与口径;确需携带口径时,作用对象/范围/生命周期必须随句写全或显式指路——禁止只复述形容词,「常显」「恒亮」这类词不带范围就是半句话(2026-09-30 微光口径事故的直接形态);若发现自己需要一条规则,那是自己的概念,先立权威文档再定义 |
|
||||
| 引用落到对外承诺 | 跨文档链接只锚到对方文档明示的对外内容(事件、接口、规则条目),不锚其内部细节 |
|
||||
| 依赖逐条列出 | 系统文档的「依赖与输出」节逐条列出本系统依赖的他人概念(规范名 + 链接)——这份清单就是删除概念时的影响面清单 |
|
||||
| 引用必登记反向边 | 引用他系统概念时,在被引方的 registry 条目 `referenced_by` 里登记——影响面靠它机械列出,不靠全仓搜 |
|
||||
@@ -163,9 +163,9 @@
|
||||
|
||||
## 10. 会话记录纪律
|
||||
|
||||
**active.md 定性:状态文件(2026-10-09 用户裁决;2026-10-10 用户再立:它是状态记录,不是工作日志——旧叫法废止)。** 根目录 `active.md` 是会话状态的唯一状态源,**每一行都必须在当下为真**;它不是历史档案——历史变更一律以 git 提交史为准(删除条目不销毁任何记录:`active.md` 自身的每个历史提交版本都完整可查)。只许写入三类内容:①当前状态快照(≤10 条滚动窗口);②未决面(进行中批次/待人闸/待裁点的指针);③当前迭代的滚动工作条目。禁止写入:已完结批次的历史叙述(归 git 与各正主文档)、待办裁决事项(归 `06-待办清单.md`)、跨会话教训(归记忆库);并行会话禁止将本文件整体复原/回退(2026-10-09 覆写事故规矩化)。退役规则:**用户确认任务完成时,清除当前会话写过的状态条目——状态清除即任务完成的证明,不留执行中痕迹(2026-10-10 用户立)**;条目完结判据=批次已落籍+结论已进快照+未决面无条目指向它;迭代收口兜底删除已完结条目,状态记录超过 30 条必须清(2026-10-09 用户裁:每迭代收口清+30 条兜底)。
|
||||
**active.md 定性:状态文件(2026-10-09 用户裁决;2026-10-10 用户再立:它是状态记录,不是工作日志——旧叫法废止)。** 根目录 `active.md` 是会话状态的唯一状态源,**每一行都必须在当下为真**;它不是历史档案——历史变更一律以 git 提交史为准(删除条目不销毁任何记录:`active.md` 自身的每个历史提交版本都完整可查)。只许写入三类内容:①当前状态快照(≤10 条滚动窗口);②未决面(进行中批次/待人闸/待裁点的指针);③当前迭代的滚动工作条目。禁止写入:已完结批次的历史叙述(归 git 与各权威文档)、待办裁决事项(归 `06-待办清单.md`)、跨会话教训(归记忆库);并行会话禁止将本文件整体复原/回退(2026-10-09 覆写事故规矩化)。退役规则:**用户确认任务完成时,清除当前会话写过的状态条目——状态清除即任务完成的证明,不留执行中痕迹(2026-10-10 用户立)**;条目完结判据=批次已入库+结论已进快照+未决面无条目指向它;迭代收口兜底删除已完结条目,状态记录超过 30 条必须清(2026-10-09 用户裁:每迭代收口清+30 条兜底)。
|
||||
|
||||
根目录 `active.md`(会话快照+批次状态记录)每条进度用完整的白话句子写清结论本身;条目写多长以读者能看懂为准,不设行数上限(2026-10-04 用户立规:能看懂比字数少更重要,原「每条 ≤3 行」约束废除——该约束曾迫使状态记录压缩成只有作者自己懂的自造缩略语,是文档黑话的繁殖地)。仍然禁止的只有两件:把定稿摘要、义务清单整段搬进条目(详情归各正主文档,状态记录只记结论);以及自造黑话——第 4 节用语纪律对状态记录同等生效。状态记录条目记裁决结论本身,不记中间文档文件指针(见第 11 节)。
|
||||
根目录 `active.md`(会话快照+批次状态记录)每条进度用完整的白话句子写清结论本身;条目写多长以读者能看懂为准,不设行数上限(2026-10-04 用户立规:能看懂比字数少更重要,原「每条 ≤3 行」约束废除——该约束曾迫使状态记录压缩成只有作者自己懂的自造缩略语,是文档黑话的繁殖地)。仍然禁止的只有两件:把定稿摘要、义务清单整段搬进条目(详情归各权威文档,状态记录只记结论);以及自造黑话——第 4 节用语纪律对状态记录同等生效。状态记录条目记裁决结论本身,不记中间文档文件指针(见第 11 节)。
|
||||
|
||||
## 11. 文档生命周期:吸收即死(2026-10-01 用户立规)
|
||||
|
||||
@@ -175,8 +175,8 @@
|
||||
|
||||
| 规则 | 内容 |
|
||||
|---|---|
|
||||
| 吸收即死 | 中间文档的结论写进正主文档(GDD 对应节/art-bible/registry)的那一刻,文件即删 |
|
||||
| 未决先迁再死 | "还没完成/还有未决项"不是留的理由:未决内容先迁正主(`06-待办清单.md`/roadmap 卡/GDD 对应节),然后文档即死 |
|
||||
| 吸收即死 | 中间文档的结论写进权威文档(GDD 对应节/art-bible/registry)的那一刻,文件即删 |
|
||||
| 未决先迁再死 | "还没完成/还有未决项"不是留的理由:未决内容先迁现行事实源(`06-待办清单.md`/roadmap 卡/GDD 对应节),然后文档即死 |
|
||||
| 永不入库 | 迭代出口(总结归档)后,本迭代中间产物一律删除,且不允许提交进 git;迭代进行中可暂存工作区(未跟踪或 gitignored),出口批一并清 |
|
||||
| 引用面口径 | 活文档(`design/gdd`+`design/art`+`design/dev`+`design/registry`+`roadmap.md`+`tools/`)对中间文档的指路阻塞删除:先把指路句改写为结论内联或 git 提交号,再删文件;根 `active.md` 状态记录引用不阻塞(状态记录=当前状态与最近批次的记录;历史变更一律以 git 提交史为准) |
|
||||
| 状态记录记结论 | 状态记录条目记裁决结论本身,不记中间文档文件指针;中间文档删除后不留死链指针 |
|
||||
@@ -199,12 +199,12 @@
|
||||
| v5 | 2026-09-15 | 新增第 7 节概念封装纪律(概念对象化建模:概念即对象 / 属性归属唯一 / 包含关系显式写 / 概念状态用枚举 / 附加物独立成对象 / 关系不吸内容),原 7/8/9 节顺延为 8/9/10,第 6 节骨架表与 CLAUDE.md 摘要的章节指针同步改指 |
|
||||
| v6 | 2026-09-16 | 待拍板收编批:第 8 节引用纪律新增「待拍板单点登记」(待拍板事项单点登记 `design/gdd/06-待拍板清单.md`,系统文档只留指路存根,新增条目直接登记清单);第 6 节顶层文档表补入 `06-待拍板清单.md`,骨架表「待拍板」行改为指路存根口径 |
|
||||
| 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`) |
|
||||
| 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 条自造短语),且未明确覆盖对话输出与状态记录命名 |
|
||||
| v12 | 2026-10-09 | §9 摘除 design/archive/gdd-2026-09-14/ 归档列项(目录已删,2026-10-09 用户令旧档引用全量摘除);旧概念翻译与 registry 改指两条维持 |
|
||||
| v13 | 2026-10-09 | §11 新增「证据只留最新」行(2026-10-09 用户立规——qa 存量清理批随批落文):测试证据只保留最新迭代/最新一轮审计版本,新证据落位即删上一份;待人清单过闸后同规退役 |
|
||||
| v14 | 2026-10-09 | §1「与旧体系门禁的关系」段与现实对齐(文档正确性审查批·独立复核)——原文「gdd_lint 门禁已停用、现行文档不跑 lint」与现状矛盾:gdd_lint 现为机检三闸之一(与 doc_link_audit/doc_term_audit 并列,分级周期口径见 CLAUDE.md,2026-10-03 起分域批在役);lean 六条硬规则本身维持停用仅用于解读旧档;「可读性是第一内容质量门」定位不变,lint 定性为格式机检面 |
|
||||
| v15 | 2026-10-10 | **迭代实现报告条款(2026-10-10 用户立规三段开发流程随批)**:§11 新增「迭代实现报告」行——实现批收口出迭代级一份实现报告(各卡状态/代拍板追认单/GDD 反哺点节),属中间文档,反哺点未决先迁 06、裁决落文后按「证据只留最新」退役,替代原每卡出口报告;「证据只留最新」行措辞同步换代。配套:GDD/art-bible 等设计正主文档实现批内一律不更新(文档更新必须经用户同意),反哺点经用户裁决另批落文——总规见 CLAUDE.md「三段开发流程」节与批次工作流第 12 条 v2 |
|
||||
| v15 | 2026-10-10 | **迭代实现报告条款(2026-10-10 用户立规三段开发流程随批)**:§11 新增「迭代实现报告」行——实现批收口出迭代级一份实现报告(各卡状态/代拍板追认单/GDD 反哺点节),属中间文档,反哺点未决先迁 06、裁决落文后按「证据只留最新」退役,替代原每卡出口报告;「证据只留最新」行措辞同步换代。配套:GDD/art-bible 等设计权威文档实现批内一律不更新(文档更新必须经用户同意),反哺点经用户裁决另批落文——总规见 CLAUDE.md「三段开发流程」节与批次工作流第 12 条 v2 |
|
||||
| v16 | 2026-10-10 | **用语纪律正面总则(2026-10-10 用户立规)**:§4 落「见名知意,所见即所得」——见名知意管名字(概念名/术语/文档与目录名本身说清所指,读者看到名字不用等解释就知道大概),所见即所得管句子(字面意思=规则的完整意思,有隐含前提就写进句子),并注明两句管语义透明、不与第 8 节指路存根冲突;§4 标题同步补八字总则。背景:用户已在用此尺裁用词(c50eef7「谓词」清除批自述「见名知意」),本批把现行做法成文 |
|
||||
@@ -57,7 +57,7 @@
|
||||
| 第一层 · 地精洞窟 | 首关层名 | level_table |
|
||||
| 封印 | 插旗动作的呈现名——对未开格(巢穴)插旗即实施封印,旗 = 封印印记 | terminology |
|
||||
|
||||
注意:上表六件秘宝为旧目录,已全数退役、只作素材库(新正主=[秘宝](systems/跨局循环/秘宝.md)「目录(重设计 v1)」节——新目录 15 件为代号制、正式命名归用户);registry 登记行随实装批迁移后本表同步。
|
||||
注意:上表六件秘宝为旧目录,已全数退役、只作素材库(新现行事实源=[秘宝](systems/跨局循环/秘宝.md)「目录(重设计 v1)」节——新目录 15 件为代号制、正式命名归用户);registry 登记行随实装批迁移后本表同步。
|
||||
|
||||
另:元进度资源定名**钥石**——每一层关底 Boss 看守他那块区域的钥石,击杀即取走,用于在存档内解锁永久提升(属性 / 怪物遭遇 / 道具池)。2026-09-14 用户拍板,registry 术语登记随元进度设计批补登。
|
||||
|
||||
@@ -68,4 +68,4 @@
|
||||
| v1.0 | 2026-09-14 | 初版随 GDD 骨架建立:一句话概念、目标受众、世界观命名、术语层级 |
|
||||
| v1.1 | 2026-09-25 | 术语「封印」定稿(用户拍板):插旗动作呈现名落术语表,出处条目 terminology |
|
||||
| v1.2 | 2026-10-03 | R3 清账批(gdd_lint 分域随批):术语表日期批注括注迁出至本表 v1.1 行;语义零变更 |
|
||||
| v1.3 | 2026-10-09 | 文档正确性审查批:专名表下「部分秘宝效果待重定」注过期——六件旧目录秘宝已随目录重设计全数退役、只作素材库,注改写为退役指路(新正主=秘宝.md「目录(重设计 v1)」节,registry 登记行随实装批迁移);表格登记事实本体不动 |
|
||||
| v1.3 | 2026-10-09 | 文档正确性审查批:专名表下「部分秘宝效果待重定」注过期——六件旧目录秘宝已随目录重设计全数退役、只作素材库,注改写为退役指路(新现行事实源=秘宝.md「目录(重设计 v1)」节,registry 登记行随实装批迁移);表格登记事实本体不动 |
|
||||
@@ -77,7 +77,7 @@
|
||||
|
||||
**GP**(冒险级账)与**钥石**(存档级账)是平行独立资源,不立统一上位概念,按生命周期各归各档文档:GP 归[冒险结构](systems/冒险循环/冒险结构.md)「GP 冒险账本」节,钥石归[元进度](systems/跨局循环/元进度.md)。
|
||||
|
||||
### 各域正主指针
|
||||
### 各域现行事实源指针
|
||||
|
||||
- AP 两账(上限=冒险级属性/当前=回合级池):[行动经济](systems/排雷循环/行动经济.md)「每轮预算与价目」节
|
||||
- 刷新两账(存量 Y/当次临时 X,X 挂「三选一呈现」):[秘宝](systems/跨局循环/秘宝.md)「三选一刷新双源」节
|
||||
@@ -130,8 +130,8 @@
|
||||
| v1.0 | 2026-09-14 | 初版随 GDD 骨架建立:一场战斗 / 一场冒险 / 死了之后三节 |
|
||||
| v1.1 | 2026-09-18 | 「数值语言」节定稿(用户拍板:整数加减核、百分比仅三处既有粗档、全局 floor) |
|
||||
| v1.2 | 2026-10-03 | R3 清账批(gdd_lint 分域随批):节标题日期批注迁出至本表 v1.1 行;语义零变更 |
|
||||
| v1.3 | 2026-10-07 | **生命周期轴(五档)节新立(道具重设计框架讨论用户裁决落文)**:五档定义(存档/冒险/关卡=预留档/节点=一次停点不按类型分档/回合)、节点链 DAG 前提(只向前·无环·只进一次)、一次性结算与持续态结算模型(跨层=转换非横跨,类A→类C)、总线与抽屉两类结算目标、道具定义卡 3+1 句、GP 与钥石两条平行独立资源;AP 两账/刷新两账/增益容器各归域内正主(行动经济/秘宝/冒险结构/元进度同批落文) |
|
||||
| v1.3 | 2026-10-07 | **生命周期轴(五档)节新立(道具重设计框架讨论用户裁决落文)**:五档定义(存档/冒险/关卡=预留档/节点=一次停点不按类型分档/回合)、节点链 DAG 前提(只向前·无环·只进一次)、一次性结算与持续态结算模型(跨层=转换非横跨,类A→类C)、总线与抽屉两类结算目标、道具定义卡 3+1 句、GP 与钥石两条平行独立资源;AP 两账/刷新两账/增益容器各归域内现行事实源(行动经济/秘宝/冒险结构/元进度同批落文) |
|
||||
| v1.5 | 2026-10-10 | 分界尺措辞精确化(2026-10-10 用户澄清):秘宝行「不出裸属性值」精确为「不出角色战斗属性值」+操作包络正向列举(经济与操作参数不在此限)——「属性值」定义行(生命/护甲/攻击/伤害)不变;机制零改动 |
|
||||
| v1.4 | 2026-10-07 | **道具三层职责与分界定稿(用户裁决——哈迪斯2 塔罗牌/祝福同构分界)**:新节落三句职责(秘宝=营地装配的角色机能件/奇物=冒险途中当局清零的增益/地图战斗资源=回合内获取并结算的格面兑付,地图层坐标经用户纠正——装板期生成、回合内获取与结算)+ 机能/机制/属性值判定尺 + 分层准入约束(新建秘宝必检:不出裸属性值、不改战斗结算机制;战斗机制改写只走专长);现行秘宝目录机制向三件(淬毒刃纹/标中殉爆/惊巢反制)经用户点名与本约束不符,归留秘宝层重设计批处置,冻结期内维持现状 |
|
||||
| v1.5 | 2026-10-07 | **跨层档位框架落文(用户裁——道具三层重设计)**:分界节新增「档位与获取规则」分节——稀有度四级统一=**普通/优秀/稀有/传说**(「优秀」=用户认可的「非普通」优化:无双否定、WoW 绿装先例、正面积木递进;DND 六级梯子中取四、跳档表意头奖级);分层语义=秘宝档位越高解锁越苛刻/奇物越高概率越低/地图=概率位+保底上限;获取概率提升=元进度/营地合法轴但**不动保底**(保底=承诺非概率);专长 rarity 语义约束=Boss 三选一按档配比或加权(字段双脱钩的文档面修复,配比归调参批) |
|
||||
| v1.6 | 2026-10-07 | **同调位分档批(用户裁——道具三层重设计·秘宝层)**:档位与获取规则节秘宝行扩装配面——同调位分三档(普通格/优秀格/稀有格),槽位可装 ≤ 槽位档位的件(向下兼容不惩罚早解锁);里程碑分档发槽(m1 普通格/m2 优秀格/m3 稀有格);费用制落选留档(槽位仅 3 组合太小);正主落点=[秘宝](systems/排雷循环/秘宝.md)速览节同批 |
|
||||
| v1.6 | 2026-10-07 | **同调位分档批(用户裁——道具三层重设计·秘宝层)**:档位与获取规则节秘宝行扩装配面——同调位分三档(普通格/优秀格/稀有格),槽位可装 ≤ 槽位档位的件(向下兼容不惩罚早解锁);里程碑分档发槽(m1 普通格/m2 优秀格/m3 稀有格);费用制落选留档(槽位仅 3 组合太小);现行事实源落点=[秘宝](systems/排雷循环/秘宝.md)速览节同批 |
|
||||
@@ -142,8 +142,8 @@
|
||||
| v1.10 | 2026-10-05 | 《奇物》v2.5:第三类定名「资源」(资源偏泛,故在命名出处节写死判据句——给的是可消耗或可重掷的余量,不是属性永久抬升);回复归属定案留在本类不拆第四类;修复 1.5 段末与渠道轴标题粘连 |
|
||||
| v1.11 | 2026-10-05 | 《奇物》v2.7 三个子节点正式定名:专长(Feat)/ 属性值提升(ASI)/ 资源——去「类」字后缀,此前是描述式叫法不是专名;新增 1.6 节「三层结构与命名」,定玩家可见的三层(奇物 / 三个分类 / 具体单件),并明确命名与呈现是两件事 |
|
||||
| v1.12 | 2026-10-06 | 生涯设计立项批(迭代 17 卡④,纯文档):新建 `systems/跨局循环/生涯.md` 设计提纲 v0.1(信息架构 / 承载内容清单 / 与既有界面关系 / 分期实装建议 / 待裁点五节;状态=范围草案待评审——P0-P5 已裁结论落文,新发现待裁点 P6 营地最近冒险条带去留)。文档树跨局循环补行 + 命名对照表补 `CAREER` 行(无代码实现面,代号随实装批对齐) |
|
||||
| v1.13 | 2026-10-07 | 道具三层职责分界批随批(用户裁——规则正主=[核心循环](01-核心循环.md)「道具三层职责与分界」节 v1.4):秘宝行概要由「扫雷侧秘宝(显影、探测类)」(同调形态起已滞后)换代为「营地装配、整局冒险生效的角色机能件」;状态列随去迁移注记 |
|
||||
| v1.14 | 2026-10-07 | 奇物层重设计落地随批(正主=[奇物](systems/冒险循环/奇物.md)版本历史 v2.9-v3.4——专长体系推倒重建+资源转换源+池结构案D+跨层档位框架):奇物行概要与状态同步——概要补「专长=触发器句式的机制件/资源=转换源凭证」,状态改「已实现·2026-10-07 专长体系重设计落地(18 件基础框架+池结构案D)」 |
|
||||
| v1.13 | 2026-10-07 | 道具三层职责分界批随批(用户裁——规则现行事实源=[核心循环](01-核心循环.md)「道具三层职责与分界」节 v1.4):秘宝行概要由「扫雷侧秘宝(显影、探测类)」(同调形态起已滞后)换代为「营地装配、整局冒险生效的角色机能件」;状态列随去迁移注记 |
|
||||
| v1.14 | 2026-10-07 | 奇物层重设计落地随批(现行事实源=[奇物](systems/冒险循环/奇物.md)版本历史 v2.9-v3.4——专长体系推倒重建+资源转换源+池结构案D+跨层档位框架):奇物行概要与状态同步——概要补「专长=触发器句式的机制件/资源=转换源凭证」,状态改「已实现·2026-10-07 专长体系重设计落地(18 件基础框架+池结构案D)」 |
|
||||
| v1.15 | 2026-10-09 | 旧档引用摘除批(用户令——旧版 GDD 归档 design/archive/gdd-2026-09-14/ 已删,全部指涉摘除):「旧代号」句不再指涉归档路径(仅解读 2026-09-14 之前历史记录);旧骨架索引参考行整行摘除。语义零变更 |
|
||||
| v1.16 | 2026-10-09 | 文档正确性审查批(ux 表五行在役态对齐):node-reward 行「v1.0·切片期过渡形态随同调实施批退役改写」过期——退役改写已兑现,改 v2.5 令牌池在役口径;level-map 行「占位升格版·视觉终稿后置」过期——改定稿版(独立屏+样张 v1 冻结);shop 行「三商品卡全陈列」过期——pool 模式在役,改令牌级货架+v1.1;camp/settlement-summary 行版本号顺延 v1.1/v1.2。文件清单一轮只读核对零死链 |
|
||||
| v1.17 | 2026-10-09 | B1 裁决落文(用户令——天赋树独立成文):跨局循环区补 `天赋树.md` 行(系统随迭代 12 实装在役,文档 v0.1 补写——机制以代码实态与迭代 12 落地裁决为据);命名对照表本批不动(代码标识符面 meta_tree 在役,代号登记另批) |
|
||||
|
||||
@@ -36,7 +36,7 @@ MVP 不加新敌种,也不做同深度多敌种混搭;敌种扩容走数据
|
||||
|
||||
## 扫雷秘宝
|
||||
|
||||
目录(重设计 v1)已定稿 **15 件**(普通 7 / 优秀 5 / 稀有 3——代号制,正式命名归用户;数值全 provisional 归调参批),正主=[秘宝](systems/跨局循环/秘宝.md)「目录(重设计 v1)」节;数据行随实装批落表(同调件数据表 = `data/tables/treasure_items.tres`)。旧目录(registry aux_items 六行:显影尘/工兵令/探宝罗盘/探巢摆钟/地穴全图卷/爆破工兵包,及过渡形态诸件)已全数退役、只作素材库(design/research/道具退役素材库.md),旧行删除与 registry 迁移归实装批。MVP 不新增。
|
||||
目录(重设计 v1)已定稿 **15 件**(普通 7 / 优秀 5 / 稀有 3——代号制,正式命名归用户;数值全 provisional 归调参批),现行事实源=[秘宝](systems/跨局循环/秘宝.md)「目录(重设计 v1)」节;数据行随实装批落表(同调件数据表 = `data/tables/treasure_items.tres`)。旧目录(registry aux_items 六行:显影尘/工兵令/探宝罗盘/探巢摆钟/地穴全图卷/爆破工兵包,及过渡形态诸件)已全数退役、只作素材库(design/research/道具退役素材库.md),旧行删除与 registry 迁移归实装批。MVP 不新增。
|
||||
|
||||
## 增益与状态
|
||||
|
||||
|
||||
@@ -11,7 +11,7 @@
|
||||
- **chord(经典扫雷的双击快开)**:本作每一格的兑现都要花行动点,chord 一键开一片会让行动点预算失去意义。
|
||||
- **抽象货币 / 中间资源折算**:扫雷收益全部直接兑成战斗效果,中间隔一层货币会稀释"排雷的因 = 战斗的果"这条因果可见的底线。**显式例外:格面金币(GP,显示名「金币」)**——金币有定名、明码定价与余额常驻呈现,因果链 = 排雷 → 战斗 → 金币 → 属性提升,每一段玩家都看得见,可见性底线不破;金币之外不再引入任何"扫雷收益折算成货币再兑换效果"的夹层。
|
||||
- **旗做成背包道具或限量**:旗只是棋盘上的标记,想用多少用多少;它的稀缺性由行动点价目承载,不做第二重限制。
|
||||
- **未开格预读危险格与安全格**:扫雷是本作的本征玩法,预读「这格是不是雷」会拆掉推理。允许"恢复推理原料"类道具(显影/预读窄域),不允许替代推理。**类型身份不在本条禁止之列**——类型微光只读「这格兑什么」、不读危险格与安全格,推理本体不受蚀(呈现正主归 [HUD框架](systems/表现与支撑/HUD框架.md)「未开格类型微光」节)。
|
||||
- **未开格预读危险格与安全格**:扫雷是本作的本征玩法,预读「这格是不是雷」会拆掉推理。允许"恢复推理原料"类道具(显影/预读窄域),不允许替代推理。**类型身份不在本条禁止之列**——类型微光只读「这格兑什么」、不读危险格与安全格,推理本体不受蚀(呈现现行事实源归 [HUD框架](systems/表现与支撑/HUD框架.md)「未开格类型微光」节)。
|
||||
- **第二套随机惩罚**:所有风险都从雷和未知格派生,不再引入平行的随机惩罚源——惩罚多了,玩家就没法归因了。
|
||||
|
||||
## 现阶段不做(裁下来的,以后再说)
|
||||
@@ -32,4 +32,4 @@
|
||||
| v1.1 | 2026-09-21 | 元进度实现批:元进度行注首批已落地(营地三柜台 / 钥石账本 / 跨局注入),数值 provisional 归设计批标定 |
|
||||
| v1.2 | 2026-10-03 | R3 清账批(gdd_lint 分域随批):元进度行日期批注迁出至本表 v1.1 行;语义零变更 |
|
||||
| v1.3 | 2026-10-03 | 道具替代推理边界锚复核(迭代 11 第①批同调实施批——需求卡片 §十连带):「允许恢复推理原料,不允许道具替代推理」边界锚**原样保留即通过**——同调目录九件逐件对表:真视/预读类=信息给付(探巢摆钟 3×3 窄域护栏承重),六被动=机制修正(禁裸 flat schema 强制),无一替代推理判定本体;复核零改动 |
|
||||
| v1.4 | 2026-10-07 | 道具三层重设计·地图层身份裁决(案甲,用户裁):第 14 条收窄——「未开格显示奖励身份」改「未开格预读危险格与安全格」,未开格类型微光(读类型不读危险格与安全格)移出禁止面;呈现正主=HUD框架「未开格类型微光」节(定义与色带已定稿),实施归微光批;推理本体保护不变 |
|
||||
| v1.4 | 2026-10-07 | 道具三层重设计·地图层身份裁决(案甲,用户裁):第 14 条收窄——「未开格显示奖励身份」改「未开格预读危险格与安全格」,未开格类型微光(读类型不读危险格与安全格)移出禁止面;呈现现行事实源=HUD框架「未开格类型微光」节(定义与色带已定稿),实施归微光批;推理本体保护不变 |
|
||||
+14
-14
@@ -20,9 +20,9 @@
|
||||
|
||||
#### 魔法提灯(fog_lantern)在秘宝新旧目录的归属(2026-10-09 登记)
|
||||
|
||||
**现状**:迭代 19 卡④将魔法提灯落为秘宝第十件(同调位新行,已实装在役);同日秘宝.md v1.5 立「目录(重设计 v1)」15 件新正主、旧目录全数退役,但处置名单只写九件、未含提灯。重叠面:新目录普通档「阔视野带」(微光 8→12 格)与提灯(灯光区半径+2)效果域相交。去留三案:①留任(第十一件/并入新目录)②退役(效果并入阔视野带)③改型重定。
|
||||
**现状**:迭代 19 卡④将魔法提灯落为秘宝第十件(同调位新行,已实装在役);同日秘宝.md v1.5 立「目录(重设计 v1)」15 件新现行事实源、旧目录全数退役,但处置名单只写九件、未含提灯。重叠面:新目录普通档「阔视野带」(微光 8→12 格)与提灯(灯光区半径+2)效果域相交。去留三案:①留任(第十一件/并入新目录)②退役(效果并入阔视野带)③改型重定。
|
||||
|
||||
**状态**:✅ **已裁=退役**(2026-10-09 用户令——「新目录没收就去掉;有也不需要,已有对应设计」)——功能由新目录普通档阔视野带(类型微光 8→12 格)承接;fog_lantern 数据行与迭代 19 卡④接线(board_view.set_fog_lantern 链/断言面/fog_lantern_wiring_test)拆除归退役删行批(实装批);素材库已由待核表迁入秘宝退役表。本条随拆线落籍后收口移除
|
||||
**状态**:✅ **已裁=退役**(2026-10-09 用户令——「新目录没收就去掉;有也不需要,已有对应设计」)——功能由新目录普通档阔视野带(类型微光 8→12 格)承接;fog_lantern 数据行与迭代 19 卡④接线(board_view.set_fog_lantern 链/断言面/fog_lantern_wiring_test)拆除归退役删行批(实装批);素材库已由待核表迁入秘宝退役表。本条随拆线入库后收口移除
|
||||
|
||||
#### 双层 BD 延期与备选内容总登记(2026-10-03 立项——需求卡片退役保险)
|
||||
|
||||
@@ -45,7 +45,7 @@
|
||||
- 「概率收窄」类派生动词(花 AP 把某格是雷的概率收窄,非确定信息)
|
||||
- **重启条件=R4 复查闸读数支持(信息型挫败信号,T10 呈报)+用户显式放宽红线①边界**——本组重启属红线变更,须用户发起
|
||||
|
||||
**设计知识存续口径**:七流派完整件表/逐项反例条件表/天赋树后备语言(哈迪斯 2 预算制扩容/邻接树改型/GP 价格通胀防线)存整合定稿,随实施批文档吸收迁入各 GDD 正主(元进度/node-reward/战斗结算/地形变异/行动经济/秘宝边界句/商店 spec)——**吸收完成前定稿不删**;喂雷流待办见上条遗留登记。
|
||||
**设计知识存续口径**:七流派完整件表/逐项反例条件表/天赋树后备语言(哈迪斯 2 预算制扩容/邻接树改型/GP 价格通胀防线)存整合定稿,随实施批文档吸收迁入各 GDD 权威文档(元进度/node-reward/战斗结算/地形变异/行动经济/秘宝边界句/商店 spec)——**吸收完成前定稿不删**;喂雷流待办见上条遗留登记。
|
||||
|
||||
#### 冒险 BD 各分类获取同渠道、纯概率差——渠道分工目标态(2026-10-04 提问登记;2026-10-05 用户定分工)
|
||||
|
||||
@@ -110,7 +110,7 @@
|
||||
|
||||
**现状**:用户提案(playnote 2026-10-06):攻击力提升改造为「武器锻造」系统——① 剑(普通攻击):锻造升级增加攻击力,最高等级附带额外效果;② 长枪/法杖:后续新增武器,攻击类型分别变为穿刺/魔法,同样满级带特殊效果——实现武器间差异化;③ 护甲同理:初始只有轻甲(升级只提 AC),最高等级后可解锁重甲/魔法甲——基础 AC 各不相同、可继续升级、各带不同额外效果。
|
||||
|
||||
**归属**:[武器锻造](systems/跨局循环/武器锻造.md)(设计正主,v0.1 起自本专条独立成文)
|
||||
**归属**:[武器锻造](systems/跨局循环/武器锻造.md)(设计权威文档,v0.1 起自本专条独立成文)
|
||||
|
||||
**状态**:已成文转正(2026-10-09 用户令「完成文档编写、代码不实现、记录待办」——正式设计文档 design/gdd/systems/跨局循环/武器锻造.md v0.1 按 2026-10-07 提案推荐案落文;提案过程稿 design/research/提案-武器锻造系统-2026-10-07.md 保留作成文底稿〔全部备选案与淘汰依据、用户原案逐条对照在彼〕)。**17 裁点用户未逐点拍板**:文档按推荐案记录,任一裁点推翻后随改该文档(开放表见其「待裁决清单」节)。数值 provisional 终值归 Alpha 收官 M4 数值批〔未排期〕。实装待办见下条。
|
||||
|
||||
@@ -124,7 +124,7 @@
|
||||
|
||||
#### 天赋树实装批 — 待办(冻结:迭代规划冻结中,重启=用户发令)(原「已建未接面两件」+「结构重构批」两条合并;2026-10-11 天赋树设计会话终裁扩充)
|
||||
|
||||
**背景**:天赋树随迭代 12 实装在役(33 节点,2026-10-04 合并 e780063);2026-10-10/11 天赋树设计会话完成全部裁决(结构换代+分叉效果定案+营地统一案甲),设计正主 = [天赋树](systems/跨局循环/天赋树.md) v0.2(2026-10-11 落文)。本条合并原「天赋树已建未接面两件」(2026-10-09)与「天赋树结构重构批」(2026-10-10)两专条,承载换代实装全量。
|
||||
**背景**:天赋树随迭代 12 实装在役(33 节点,2026-10-04 合并 e780063);2026-10-10/11 天赋树设计会话完成全部裁决(结构换代+分叉效果定案+营地统一案甲),设计权威文档 = [天赋树](systems/跨局循环/天赋树.md) v0.2(2026-10-11 落文)。本条合并原「天赋树已建未接面两件」(2026-10-09)与「天赋树结构重构批」(2026-10-10)两专条,承载换代实装全量。
|
||||
|
||||
**内容**:① 结构换代——`meta_tree.tres` 33→29 节点:锻造枝三属性节点(武器锻造/护身锻造/甲胄锻造)删除,换单个免费解锁节点「锻造工坊」(前置 = 攻击淬炼累计 ≥2 级 且 护甲淬炼累计 ≥2 级,等级阈值前置属新机制);克制专精 Fork 对删除(Fork 词表 4→3 组);地脉共鸣解锁条件改四条淬炼线全部买满;同调位 1 改无前置根节点(串行 1→2→3 保留)。② 营地统一(案甲)——树=营地本体:属性升级唯一入口=树淬炼节点,旧属性锻造柜台退役吸收进脊柱(落地前柜台维持现役);工作间钥匙模型(锻造工坊/秘宝匣=钥匙节点展开面板,图鉴常开无钥匙);营地 UI 重做(树=主界面,树面板从图鉴柜台下段程序占位位升出)。③ 叠加公式换代——开局属性 = 角色基础值 + 树四线淬炼 flat + 锻造路线加值 + 局内加算区(旧「柜台三档 flat」项随退役移除)。④ 迁移重做——forge_levels 不再映射锻造枝(旧映射作废),改映射脊柱对应线等级(零亏损,cap 差额补偿口径随批定);秘宝匣点亮映射与同调位谓词映射沿用。⑤ schema 面——等级阈值前置新形态;Fork 组词表 4→3 组;RULE_KEYS 2→6 键扩表(三组 Fork 效果定案:开局姿态=每关首轮窗〔先手压制=每关首轮 AP+1 / 稳健拓荒=每关首轮内受击减伤〕、危险直觉=锋陷阱伤害减半 / 守误标返 AP·均每关限次、财富之道=聚 GP 获取增益 / 散消费折价;现役两键占位态随批终结);「道具工坊」改名「秘宝匣」代码连带面(文档正文已随 2026-10-10 跨文档同步批扫改,代码标识符 workshop_items 与界面文案归本批)。⑥ 刷新升级节点接线缺陷修复——树上购买写 attune_refresh_level 同一账本(定性=缺陷修复:树上购买现无消费面=白花钱;两入口并存收敛口径随批)。⑦ 同调位 2/3 槽位收编——槽位判定源从谓词表切换/合并到树节点(与秘宝实装批的槽位定序点见其进展注记)。⑧ 命中线 flat 注入——**归数值批**(先定值域再接线),随本批接线。⑨ T0 实查一项:危险直觉守侧「误标返 AP」前提 = 标错机制存在性,查无则守侧换安全网向等价效果经用户裁。**关联**:与「武器锻造系统实装批」共用 meta_tree/forge_levels 与营地柜台面,排期两批合并评估;与「秘宝体系实现重构落地批」存在槽位定序点(见其进展注记)。
|
||||
|
||||
@@ -134,7 +134,7 @@
|
||||
|
||||
#### 秘宝体系实现重构落地批 — 待办(冻结:迭代规划冻结中,重启=用户发令)(2026-10-10 用户令「文档层已改完,记录新设计的实现重构落地」登记)
|
||||
|
||||
**背景**:文档层已全部换代完毕——现行正主=秘宝.md「目录(重设计 v1)」新 15 件(三档骨架+解锁混合制〔基础件钥石购买+特定件条件解锁〕+设计骨架〔效果轴三方向×代价轴三段〕,数值 provisional 归调参批);第一版 14 件(旧九件+表外四件+魔法提灯)已全数裁退役入素材库(2026-10-10 用户裁「退役与封存都进素材库」,deferred 态清零——显影尘/地穴全图卷原 deferred 封存态一并终结);「道具工坊」更名「秘宝匣」(2026-10-10 天赋树裁定批,文档正文已扫改)。**代码与数据层未落**——`treasure_items.tres` 现行行仍系旧体系:表外四行(显影尘/地穴全图卷字段值 deferred、工兵令/探宝罗盘 retired)+旧九件行+魔法提灯行及卡④接线。
|
||||
**背景**:文档层已全部换代完毕——现行事实源=秘宝.md「目录(重设计 v1)」新 15 件(三档骨架+解锁混合制〔基础件钥石购买+特定件条件解锁〕+设计骨架〔效果轴三方向×代价轴三段〕,数值 provisional 归调参批);第一版 14 件(旧九件+表外四件+魔法提灯)已全数裁退役入素材库(2026-10-10 用户裁「退役与封存都进素材库」,deferred 态清零——显影尘/地穴全图卷原 deferred 封存态一并终结);「道具工坊」更名「秘宝匣」(2026-10-10 天赋树裁定批,文档正文已扫改)。**代码与数据层未落**——`treasure_items.tres` 现行行仍系旧体系:表外四行(显影尘/地穴全图卷字段值 deferred、工兵令/探宝罗盘 retired)+旧九件行+魔法提灯行及卡④接线。
|
||||
|
||||
**内容**:① 新 15 件按「目录(重设计 v1)」实装(数据行重建/迁移、解锁混合制——钥石购买面+解锁条件表〔由 attunement_growth.tres 改造,逐件条件随需求卡片〕、装配与同调位面、秘宝匣柜台语义、使用代价各形态实现〔关卡级/战斗级限量、转化获取三通道——见秘宝.md 设计骨架代价轴〕);② 旧数据行清理(表外四行+旧九件行+提灯行拆线+卡④接线拆除,deferred 态清零——文档与数据表的窗口期不一致随本批消解);③ 专长侧联动:`feats.tres` 27 件旧行删除(名单=素材库表二)+新专长框架实装衔接;④ 空配置验收闸(三选一池空兜底/商店空货架/装配面空目录);⑤ 池结构选型三案(概率上限解耦的耦合案随批选型)与配额数字;⑥ 效果引擎扩签核实与停手挂点;⑦ 件级跨事件状态账、秘宝参数注入面两疑似漏项 T0 核实。
|
||||
|
||||
@@ -148,7 +148,7 @@
|
||||
|
||||
**内容**:效果引擎条件事实词表新增「生命比例」事实(当前生命 ≤50% 类条件判定)——[奇物](systems/冒险循环/奇物.md) 专长件「背水」(when 生命 ≤50%:受伤额外 −N,v3.13 生存件扩容批)的**实现前置需求**,用户明令标注;随专长实装批一并落(实装批=上方「秘宝体系实现重构落地批」③ 专长侧联动)。
|
||||
|
||||
**归属**:[奇物](systems/冒险循环/奇物.md)「扩签登记」节(词表扩项正主)+ 效果引擎(`game/core/effect_engine.gd` 条件事实词表修订随实装批)
|
||||
**归属**:[奇物](systems/冒险循环/奇物.md)「扩签登记」节(词表扩项现行事实源)+ 效果引擎(`game/core/effect_engine.gd` 条件事实词表修订随实装批)
|
||||
|
||||
**状态**:待办(冻结——迭代规划冻结覆盖,随专长实装批重启)
|
||||
|
||||
@@ -260,7 +260,7 @@
|
||||
|
||||
**归属**:[地图战斗资源](systems/战斗循环/地图战斗资源.md)修订批(基础配比的权重覆盖语义 + GDD 修订)与[元进度](systems/跨局循环/元进度.md)(解锁容量与注入生产者)共裁;呈现面归[HUD 框架](systems/表现与支撑/HUD框架.md)与[教学引导](systems/表现与支撑/教学引导.md)随批。
|
||||
|
||||
**状态**:已裁待实施(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〕)。**挂起(2026-10-05 用户令)**:移出 roadmap 迭代 14(⑥号卡撤销)——暂不做,本条目在 06 保留为挂起待办;八项裁决与需求卡片全部冻结保留(需求卡片=design/research/需求卡片-冒险前资源配比预设批-2026-10-04.md,文件头已挂冻结横幅);原开工门「②③号卡出口」随挂起冻结——重启须用户另行发令,届时若②判式换代与③全局变异已落籍 master 则开工门自然解(合成序与包络数值锚仍依赖两者的摇号投影点)
|
||||
**状态**:已裁待实施(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〕)。**挂起(2026-10-05 用户令)**:移出 roadmap 迭代 14(⑥号卡撤销)——暂不做,本条目在 06 保留为挂起待办;八项裁决与需求卡片全部冻结保留(需求卡片=design/research/需求卡片-冒险前资源配比预设批-2026-10-04.md,文件头已挂冻结横幅);原开工门「②③号卡出口」随挂起冻结——重启须用户另行发令,届时若②判式换代与③全局变异已合并进 master 则开工门自然解(合成序与包络数值锚仍依赖两者的摇号投影点)
|
||||
|
||||
#### GP 经济换算失衡——GP 袋面值与商店价格的换算关系复查(2026-10-07 登记)
|
||||
|
||||
@@ -272,7 +272,7 @@
|
||||
|
||||
#### 迭代 10 奖励重构联动欠账(2026-10-01 登记)
|
||||
|
||||
**现状**:迭代 10 奖励重构批(worktree 分支 m3-iter10-20261001,不合入 master、渲染层验证冻结,待用户批准合并)落地面产生三条后续义务——①钥石产出重标:渠道改「Boss/精英击杀掉落」(大奖励 keystone_per_level 退役、boss_keystone 重锚首杀 3/复杀 2 provisional),现行元进度产出结构作废,标定义务重开;②通关率带重扫:通关回血 20%(血回满→部分回血,难度上压方向)+ 三选一件值/权重/次数上限 knob(AP 件 = 每场战斗首轮 +1 AP 强度敏感轴)——难度曲线与Boss P1 行已登记;③同调位读数源切换:本批挂过渡键 transitional_sync_slots(provisional 1),同调实施批落地后切换为 attunement_growth.tres 谓词表实时求值,切换注记随该批。〔③已清偿(2026-10-03 迭代 11 第①批 T7:过渡键表/schema/断言三处退役,读取点归零,呈现与求值正主=Attunement.slots 谓词表实时求值);①②仍开放〕
|
||||
**现状**:迭代 10 奖励重构批(worktree 分支 m3-iter10-20261001,不合入 master、渲染层验证冻结,待用户批准合并)落地面产生三条后续义务——①钥石产出重标:渠道改「Boss/精英击杀掉落」(大奖励 keystone_per_level 退役、boss_keystone 重锚首杀 3/复杀 2 provisional),现行元进度产出结构作废,标定义务重开;②通关率带重扫:通关回血 20%(血回满→部分回血,难度上压方向)+ 三选一件值/权重/次数上限 knob(AP 件 = 每场战斗首轮 +1 AP 强度敏感轴)——难度曲线与Boss P1 行已登记;③同调位读数源切换:本批挂过渡键 transitional_sync_slots(provisional 1),同调实施批落地后切换为 attunement_growth.tres 谓词表实时求值,切换注记随该批。〔③已清偿(2026-10-03 迭代 11 第①批 T7:过渡键表/schema/断言三处退役,读取点归零,呈现与求值现行事实源=Attunement.slots 谓词表实时求值);①②仍开放〕
|
||||
|
||||
**归属**:①元进度设计批 + 曲线调参批 ②曲线调参批(现行窗) ③~~秘宝同调实施批~~(已清偿 2026-10-03)
|
||||
|
||||
@@ -296,7 +296,7 @@
|
||||
|
||||
#### 袋装摇号(格面资源池结构备选——保底型增多后的重构方向)(2026-10-07 登记)
|
||||
|
||||
**现状**:地图战斗资源池保底结构(四档概率 + 按型保底 + 档位保底上限,正主=[地图战斗资源](systems/战斗循环/地图战斗资源.md)候选集合节)以「摇完整板校验补签」的补丁式实现起步——简单够用。备选正规形态 = **袋装摇号**:装板时按各档配额数好牌再洗开发放,保底天然成立、分布精确;代价 = 摇号结构重写 + 偏运硬币/board_skew 两路权重投影须改为袋面投影。启用条件 = 保底登记型增多、补签逻辑复杂化时。来源 = 2026-10-07 地图层题四讨论,用户裁「先挂在 06」。
|
||||
**现状**:地图战斗资源池保底结构(四档概率 + 按型保底 + 档位保底上限,现行事实源=[地图战斗资源](systems/战斗循环/地图战斗资源.md)候选集合节)以「摇完整板校验补签」的补丁式实现起步——简单够用。备选正规形态 = **袋装摇号**:装板时按各档配额数好牌再洗开发放,保底天然成立、分布精确;代价 = 摇号结构重写 + 偏运硬币/board_skew 两路权重投影须改为袋面投影。启用条件 = 保底登记型增多、补签逻辑复杂化时。来源 = 2026-10-07 地图层题四讨论,用户裁「先挂在 06」。
|
||||
|
||||
**归属**:[地图战斗资源](systems/战斗循环/地图战斗资源.md)(重评归该层内容批或数值批窗口)
|
||||
|
||||
@@ -327,7 +327,7 @@
|
||||
**状态**:✅ 代码面已交付待实机目检(2026-10-06,迭代 17 卡③暂停层只读入口批——worktree g-plan2-iter17-pause 分支 iter17-pause-20261006,提交 c08a901/fc9eb1e/d44fdd5+收口笔;P1丁常驻角标/P2甲设置层同档 dim 遮罩/P3甲余额+三柜台进度/P4甲零动效直开直关全落;badge 已按 Q10 甲工厂化入 ui_kit 并同步迁营地钥石徽;机检=冒烟 788/0+run_all 17 套+四探针全绿〔含输入锁 case⑯/只读巡检/零动效契约/钥石徽对比度对〕+doc 三闸零新增;**人闸=用户实机目检** 迭代17暂停层人闸清单(已退役,git 历史可查)——过闸后本条销号;Esc 快捷通道维持本清单键盘/手柄条登记随键盘批办理)
|
||||
#### 未开格类型徽章呈现时机(2026-09-18 方向已拍板,待实施批)
|
||||
|
||||
**现状**:2026-09-18 用户拍板方向——未开格常显奖励类型微光(周围 8 格泛光:魔法=紫 / 穿刺=蓝 / 群伤=红 / 治疗=绿 / 其他增益=黄),让玩家能针对敌人护甲类型规划优先开哪些格。设计依据:护甲克制轴已落地(穿刺弹/魔法矢),玩家需要类型先验才能兑现克制博弈。**2026-09-22 美术圣经审阅批更新(T1 裁决:采纳彩色常显微光)**:原五色与圣经语义色条款三方冲突(紫落 300°–345° 禁入带/治疗绿违反绿零逻辑/穿刺蓝违反蓝只说己方),经用户裁决采纳微光后五组色相已重选候选——芥末黄(通用增益)/黄绿(治疗)/青(穿刺)/紫罗兰(魔法)/绯红(群伤),见 [art-bible](../art/art-bible.md) §4.2「类型微光色带」(候选值,样张批冻结);圣经 §4.6.3 呈现约束已同步为「角嵌纹样(形状)+常显微光(色彩)」双通道,类型预读呈现方案在美术侧已成文。连带裁决面:① 本方向修订[不做清单](05-不做清单.md)「未开格不显示奖励身份」裁定(owner 修订,合法);② ~~与 art-bible §4.6.3 家族类型徽章口径对齐归美术批~~——已完成(2026-09-22 美术文档修订批);③ 探宝罗盘(预读 3×3)价值被清空,效果重定归秘宝内容批;④ ~~色板与既有格面徽标/UI 用色冲突检查归样张批~~——冲突面已在色相重选时规避,样张批保留组间互辨抽测义务;⑤ 原「资源预读与推理的边界」条目并入口径(2026-09-19 用户拍板:预读边界按本条微光方案定——类型级常显;探宝罗盘重定两方案另立条目评估);⑥ 实施窗口 = 表现层升级批(会改推理信息面,切片期默认不开、保护验收读数基线)。**2026-09-30 口径校正(用户裁决)**:微光正确口径=**英雄周围 8 格内的未开格显示类型微光**(非全板常显)——本条历史文本中的「常显」为无范围复述、「魔法=紫/穿刺=蓝…」为 2026-09-18 原案旧色(已被 T1 重选五组取代,现行见 art-bible §4.2);概念正主已落 [HUD框架](systems/表现与支撑/HUD框架.md)「未开格类型微光」节(2026-09-30 收口批落位),本条此后只承载实施状态、不再承载定义。
|
||||
**现状**:2026-09-18 用户拍板方向——未开格常显奖励类型微光(周围 8 格泛光:魔法=紫 / 穿刺=蓝 / 群伤=红 / 治疗=绿 / 其他增益=黄),让玩家能针对敌人护甲类型规划优先开哪些格。设计依据:护甲克制轴已落地(穿刺弹/魔法矢),玩家需要类型先验才能兑现克制博弈。**2026-09-22 美术圣经审阅批更新(T1 裁决:采纳彩色常显微光)**:原五色与圣经语义色条款三方冲突(紫落 300°–345° 禁入带/治疗绿违反绿零逻辑/穿刺蓝违反蓝只说己方),经用户裁决采纳微光后五组色相已重选候选——芥末黄(通用增益)/黄绿(治疗)/青(穿刺)/紫罗兰(魔法)/绯红(群伤),见 [art-bible](../art/art-bible.md) §4.2「类型微光色带」(候选值,样张批冻结);圣经 §4.6.3 呈现约束已同步为「角嵌纹样(形状)+常显微光(色彩)」双通道,类型预读呈现方案在美术侧已成文。连带裁决面:① 本方向修订[不做清单](05-不做清单.md)「未开格不显示奖励身份」裁定(owner 修订,合法);② ~~与 art-bible §4.6.3 家族类型徽章口径对齐归美术批~~——已完成(2026-09-22 美术文档修订批);③ 探宝罗盘(预读 3×3)价值被清空,效果重定归秘宝内容批;④ ~~色板与既有格面徽标/UI 用色冲突检查归样张批~~——冲突面已在色相重选时规避,样张批保留组间互辨抽测义务;⑤ 原「资源预读与推理的边界」条目并入口径(2026-09-19 用户拍板:预读边界按本条微光方案定——类型级常显;探宝罗盘重定两方案另立条目评估);⑥ 实施窗口 = 表现层升级批(会改推理信息面,切片期默认不开、保护验收读数基线)。**2026-09-30 口径校正(用户裁决)**:微光正确口径=**英雄周围 8 格内的未开格显示类型微光**(非全板常显)——本条历史文本中的「常显」为无范围复述、「魔法=紫/穿刺=蓝…」为 2026-09-18 原案旧色(已被 T1 重选五组取代,现行见 art-bible §4.2);概念权威定义已落 [HUD框架](systems/表现与支撑/HUD框架.md)「未开格类型微光」节(2026-09-30 收口批落位),本条此后只承载实施状态、不再承载定义。
|
||||
|
||||
**归属**:[地图战斗资源](systems/战斗循环/地图战斗资源.md)极性提案实施批与HUD框架共裁
|
||||
|
||||
@@ -441,7 +441,7 @@
|
||||
|
||||
**归属**:新界面立项(用户发令后排批);退役落码随 UI 落码批 M8/M9
|
||||
|
||||
**状态**:待办(生涯未做前,冒险中无任何历史回看入口——已知代价,用户知情裁决)——**设计提纲已成文待评审**(2026-10-06 迭代 17 卡④设计批完成:提纲 = [systems/跨局循环/生涯.md](systems/跨局循环/生涯.md) v0.1 范围草案,五节成文〔信息架构/承载内容清单/与既有界面关系/分期实装建议/待裁点〕,现状描述经代码级复核;P0-P5 六裁点已全裁落文〔P0甲 提纲落正主 / P1甲 主菜单一级入口 / P2甲 每局一行摘要+cap 扩容 N+补用时埋点 / P3甲 敌人图鉴优先 / P4甲 局内不放入口+生涯零跳转 / P5甲 settlement_review 复活承接〕,新发现待裁点 P6 营地最近冒险条带去留随评审一并裁。**人闸 = 用户评审提纲**;实装批另行立项,期一/二/三均未预占排期)——**实装批已编入 roadmap 迭代 18 卡④生涯界面实装批(2026-10-06 用户令;门=本提纲用户评审+设计定稿)**——**期一已落地(2026-10-07 迭代 18 卡④实装批:生涯页六类九项+主菜单入口+终身计数域存档 v6,批末重闸全绿;实机人闸挂账待用户——目检项=07⑲;出口报告 design/qa/iter18-career-exit-report-2026-10-07.md)**;剩余面=期二(历史回看/图鉴)与期三实装+P6 营地最近冒险条带去留
|
||||
**状态**:待办(生涯未做前,冒险中无任何历史回看入口——已知代价,用户知情裁决)——**设计提纲已成文待评审**(2026-10-06 迭代 17 卡④设计批完成:提纲 = [systems/跨局循环/生涯.md](systems/跨局循环/生涯.md) v0.1 范围草案,五节成文〔信息架构/承载内容清单/与既有界面关系/分期实装建议/待裁点〕,现状描述经代码级复核;P0-P5 六裁点已全裁落文〔P0甲 提纲落现行事实源 / P1甲 主菜单一级入口 / P2甲 每局一行摘要+cap 扩容 N+补用时埋点 / P3甲 敌人图鉴优先 / P4甲 局内不放入口+生涯零跳转 / P5甲 settlement_review 复活承接〕,新发现待裁点 P6 营地最近冒险条带去留随评审一并裁。**人闸 = 用户评审提纲**;实装批另行立项,期一/二/三均未预占排期)——**实装批已编入 roadmap 迭代 18 卡④生涯界面实装批(2026-10-06 用户令;门=本提纲用户评审+设计定稿)**——**期一已落地(2026-10-07 迭代 18 卡④实装批:生涯页六类九项+主菜单入口+终身计数域存档 v6,批末重闸全绿;实机人闸挂账待用户——目检项=07⑲;出口报告 design/qa/iter18-career-exit-report-2026-10-07.md)**;剩余面=期二(历史回看/图鉴)与期三实装+P6 营地最近冒险条带去留
|
||||
|
||||
**迭代 19 卡②遗留件登记(2026-10-08)**:settlement_review_overlay.gd 现态考证=未接线遗留件(全仓零引用,M9 结算框改版「明细回看」钮退役后遗留——迭代 19 卡②需求卡片普查表「出批归退役处置另议」落位本条)。处置两途:①随生涯实装批按 P5 甲复活承接(重接线入生涯);②确认不再需要则正式退役删除文件。二选一归生涯实装批/用户裁;卡②批红线(旧屏零 diff)该文件零触碰。
|
||||
|
||||
@@ -459,12 +459,12 @@
|
||||
|
||||
**背景**:根目录 active.md 已从状态文件漂移成追加式日志——928 行约 1MB,快照节标题写「≤10 行」实际堆了 129 条,编号条目四百多条,另有五个 2026 年 9 月时代的死节;「只追加不删除」成因已定案=收口协议只定义追加从未定义退役(遗漏而非规定)+doc-conventions.md:177「状态记录=历史变更记录」豁免句系 agent 起草越权(用户从未裁决永久保留)。2026-10-09 用户指出定性是前置问题:若是状态记录(历史变更记录),可全量记录+定期归档成文件链;若是状态文件,只追加的做法本身不成立。先定性,其余裁断随之收敛。完整论证见 active.md 状态记录 416 号条目。
|
||||
|
||||
**裁决零:active.md 的定性——状态文件还是状态记录(前置)**。agent 推荐定性为状态文件,论据三条:①出身——文件第一行自述「会话状态……唯一状态源」,日志是收口协议起草时搭进来的器官,「收口记一笔」的动作用户批准过,但「该文件因此是历史档案、旧条目永久保留」的身份从未被决定;②职能——它存在的理由是会话开工时回答「现在」时态的问题(在哪/什么进行中/什么阻塞/下一步),历史时态的问题各有正主(git 提交史承载批次级叙述、06 承载待裁、GDD 版本历史承载规则演变);③宪法一致——2026-10-01 吸收即死已立「git=变更记录」,177 行豁免句是全库唯一偏离,定性为状态不是立新规而是把既有宪法补齐到这个文件。日志承担的跨会话接力职能由滚动窗口保住(快照 ≤10 条+当前迭代条目),删前迁移检查(吸收即死程序)保证没被正主吸收的结论零丢失。
|
||||
**裁决零:active.md 的定性——状态文件还是状态记录(前置)**。agent 推荐定性为状态文件,论据三条:①出身——文件第一行自述「会话状态……唯一状态源」,日志是收口协议起草时搭进来的器官,「收口记一笔」的动作用户批准过,但「该文件因此是历史档案、旧条目永久保留」的身份从未被决定;②职能——它存在的理由是会话开工时回答「现在」时态的问题(在哪/什么进行中/什么阻塞/下一步),历史时态的问题各有现行事实源(git 提交史承载批次级叙述、06 承载待裁、GDD 版本历史承载规则演变);③宪法一致——2026-10-01 吸收即死已立「git=变更记录」,177 行豁免句是全库唯一偏离,定性为状态不是立新规而是把既有宪法补齐到这个文件。日志承担的跨会话接力职能由滚动窗口保住(快照 ≤10 条+当前迭代条目),删前迁移检查(吸收即死程序)保证没被现行事实源吸收的结论零丢失。
|
||||
备选定性=状态记录:名正言顺全量记录+按里程碑滚入归档文件形成文件链(如 worklog-2026-09→2026-10);自洽且常见,收益=单一入口可翻全部历史,代价=多养一份资产+一套归档流程+与 git 双份记账。agent 不荐:先按状态定性跑,日后若发现 git 提交史不够翻,归档链随时可从 git 生成,届时建链零成本。裁=定性为状态文件(荐)/定性为状态记录+建归档链。
|
||||
|
||||
**定性为状态文件时,四项推论**:
|
||||
- 推论一(doc-conventions.md:177 定性句):就是把裁决零落文的动作——改为「状态记录=当前状态与最近批次的记录;历史变更一律以 git 提交史为准」,同行「日志引用不阻塞其他文档删除」功能保留。裁=认可措辞或改字。
|
||||
- 推论二(清旧条目时机):窗口怎么滑——甲=每迭代收口时清已合入 master 批次的旧条目(荐),丙=超 30 条兜底可与甲并用;乙=每里程碑清是日志身份才需要的归档节奏,状态定性下撤除。规则原文:「迭代收口落账后,删除状态记录中已合入 master 的历史批次条目,只保留当前迭代的记录与未决事项;删除前确认结论已吸收进正主文档(06 待办/roadmap/GDD),未吸收的先迁再删。」(末句系吸收即死既有铁律自动适用。)
|
||||
- 推论二(清旧条目时机):窗口怎么滑——甲=每迭代收口时清已合入 master 批次的旧条目(荐),丙=超 30 条兜底可与甲并用;乙=每里程碑清是日志身份才需要的归档节奏,状态定性下撤除。规则原文:「迭代收口落账后,删除状态记录中已合入 master 的历史批次条目,只保留当前迭代的记录与未决事项;删除前确认结论已吸收进权威文档(06 待办/roadmap/GDD),未吸收的先迁再删。」(末句系吸收即死既有铁律自动适用。)
|
||||
- 推论三(一次性大裁保留线五项)=状态定义本身:①文件头指针节(阶段/引擎/架构/文档索引);②项目当前位置(按当前真实状态重写);③状态快照节(执行标题既有「≤10 行」,只留最近十条);④未决面(进行中批次/待人闸/待裁点);⑤最近一个迭代的日志条目。其余约九成删除,编号 416 起继续递增不重排(提交信息与记忆均引编号)。裁=照单或增补。
|
||||
- 推论四(九月死节五节)=纯死状态直接删:「GDD 设计顺序(前 10 = MVP)」「GDD 写作纪律」「垂直切片速度日志(2026-09-10 启动)」「Session Extract — /review-all-gdds 2026-09-14」「项目当前位置」旧内容(节本体在推论三②保留);删前按吸收即死过一遍独有规则先吸进 doc-conventions。裁=照准全删。
|
||||
|
||||
|
||||
@@ -105,7 +105,7 @@
|
||||
|
||||
### ⑪ Boss 图整图变异(贫矿脉)目检项(2026-10-04 全局作用域变异首发批随批登记——**目检改排:随 UI 优化批之后统一验证**,用户 2026-10-04 裁「先做完 UI 优化再一起验证」)
|
||||
|
||||
> **改排状态注记(2026-10-05 ui-struct-probe 批)**:UI 优化批(UI 落码 11 卡+SR-1)已全落籍;期间实机目检抓到标题屏双列叠放缺陷,已随 ui-struct-probe 批修复,并新增全 UI 屏结构探针入轻闸(按钮互压/等宽/出屏/零尺寸——机械可判项自此探针代管,见 §⑯)。本条统一验证窗口仍开,等用户实机目检时点;下列六项均为体感/呈现面,保留人闸。
|
||||
> **改排状态注记(2026-10-05 ui-struct-probe 批)**:UI 优化批(UI 落码 11 卡+SR-1)已全入库;期间实机目检抓到标题屏双列叠放缺陷,已随 ui-struct-probe 批修复,并新增全 UI 屏结构探针入轻闸(按钮互压/等宽/出屏/零尺寸——机械可判项自此探针代管,见 §⑯)。本条统一验证窗口仍开,等用户实机目检时点;下列六项均为体感/呈现面,保留人闸。
|
||||
|
||||
**怎么玩**:打一局正常打到第 2 关的 Boss 图(想快可以在开始界面开调试入口直接进第 2 关);顺手的话再看一眼第 1 关 Boss 和任意普通战斗图,前后共约十分钟。本条目在 UI 优化批落地后执行——届时以改完后的最终界面为准,下述文案若随 UI 批调整以当批登记为准。
|
||||
|
||||
@@ -135,7 +135,7 @@
|
||||
- **对症信号(「开一大片」体感)**:开局第一挖还会不会「唰一下开掉大半张图」?预期=开场仍是出生区连锁、但明显比以前克制;「开了片面积」的失控感是否消退。
|
||||
- **节奏信号(单板停留时长)**:单块雷图的挖掘轮数/停留时长变化(免费信息变少 → 每板要多挖几格才有全图视野)——是变紧凑了还是变拖沓。
|
||||
- **策略信号(连锁与微光预读)**:玩家是否更依赖读数字推雷/类型微光预读(免费视野少了,推理工具的使用率应上升)。
|
||||
- **迷雾联动信号(记忆态使用率)**:视野外扩道具(魔法提灯 +2——已裁退役 2026-10-09,拆线批落籍后本信号面失效)与记忆态(暗淡已见格)的使用频率变化。
|
||||
- **迷雾联动信号(记忆态使用率)**:视野外扩道具(魔法提灯 +2——已裁退役 2026-10-09,拆线批入库后本信号面失效)与记忆态(暗淡已见格)的使用频率变化。
|
||||
- **红灯信号**:开局连续多板几乎无免费展开(R₀ 常年 ≈9-15,体感「开局一片黑」);或可推理率体感骤降(数字不够推)。前者=剃雷半径 r 回调面(P1 旋钮 [0,2]),后者归 S1 相变警戒复测。
|
||||
- **结论回流**:体感 → 本条目记录;参数终值(r 0/1/2、cap 收紧路径 45→40 等)归 P1-P3 拍板面(读数后置,MC 四带复算挂 07 现行义务),不在试玩现场改数。
|
||||
|
||||
@@ -149,7 +149,7 @@
|
||||
### ⑮ 秘宝词族换词全 UI 面目检 + 渲染像素闸补跑(2026-10-05 秘宝代码词族对齐批随批登记——迭代15③号卡)
|
||||
|
||||
- **实机目检(「秘宝」字样全 UI 面,约 3 分钟)**:①C 区槽位标题应显示「秘宝」(原「魔法道具」,hero_info_panel_view 槽位组);②空槽悬停提示应显示「秘宝槽(空)」;③战斗总结三选一叙述行应显示「秘宝 / …」或「秘宝 / 随机获得一件」(原「魔法道具」开头);④换关 toast 应显示「上关剩余 N 件秘宝已随关卡结束清空」。**红灯信号**:任何界面残留「魔法道具」字样。
|
||||
- **渲染像素类闸补跑挂账**:本批屏蔽五件(golden_compare / shot_probe / fx_probe / ui_layout_probe / board_shot——组 A 文案变更使像素断言合法失效,按 goal 令弃断);**补跑时点=迭代 14 全落籍后的表现批周期闸一次性补跑**,与本批无独立补跑义务;届时若 golden 基线因文案换代失效,按换代流程重锚而非当缺陷修。**分工注记(2026-10-05 ui-struct-probe 批)**:结构类断言(互压/等宽/出屏)已由 `ui_struct_probe` 入轻闸默认必跑段(tools/probe_gate.sh),与像素五闸互补不替代——五闸补跑义务不变。**核销注记(2026-10-08 迭代 19 卡①自动化验收补齐批——机器补跑半随批核销)**:五件机器半全部归宿落籍并实测绿——shot_probe(扩屏七屏+shot_checker A-D 断言)/board_shot(L1-L3 取证+golden 逐像素 0.00%×3)/golden_compare 三件入 render_gate(窗口化自动闸),fx_probe 入 probe_gate --full(headless 逻辑层断言),ui_layout_probe 补 1280/1920 两档最小断言(首跑 PASS);五闸归宿对账见需求卡片-自动化验收补齐批 §一。**真人目检半(上方「秘宝」字样全 UI 面 3 分钟)仍归用户,不销号**。
|
||||
- **渲染像素类闸补跑挂账**:本批屏蔽五件(golden_compare / shot_probe / fx_probe / ui_layout_probe / board_shot——组 A 文案变更使像素断言合法失效,按 goal 令弃断);**补跑时点=迭代 14 全入库后的表现批周期闸一次性补跑**,与本批无独立补跑义务;届时若 golden 基线因文案换代失效,按换代流程重锚而非当缺陷修。**分工注记(2026-10-05 ui-struct-probe 批)**:结构类断言(互压/等宽/出屏)已由 `ui_struct_probe` 入轻闸默认必跑段(tools/probe_gate.sh),与像素五闸互补不替代——五闸补跑义务不变。**核销注记(2026-10-08 迭代 19 卡①自动化验收补齐批——机器补跑半随批核销)**:五件机器半全部归宿已入库并实测绿——shot_probe(扩屏七屏+shot_checker A-D 断言)/board_shot(L1-L3 取证+golden 逐像素 0.00%×3)/golden_compare 三件入 render_gate(窗口化自动闸),fx_probe 入 probe_gate --full(headless 逻辑层断言),ui_layout_probe 补 1280/1920 两档最小断言(首跑 PASS);五闸归宿对账见需求卡片-自动化验收补齐批 §一。**真人目检半(上方「秘宝」字样全 UI 面 3 分钟)仍归用户,不销号**。
|
||||
|
||||
### ⑯ UI 结构批复验(2026-10-05 ui-struct-probe mini-loop 随批登记——标题屏双列修复+按钮宽度纪律,约 2 分钟)
|
||||
|
||||
@@ -196,7 +196,7 @@
|
||||
|
||||
| 版本 | 日期 | 改动 |
|
||||
|---|---|---|
|
||||
| v0.1 | 2026-10-09 | 补登:文档正确性审查批改动①——⑬节「迷雾联动信号」行魔法提灯观测点加退役注(「魔法提灯 +2——已裁退役 2026-10-09,拆线批落籍后本信号面失效」);本文件当时无版本表,本行系卫生批补登 |
|
||||
| v0.1 | 2026-10-09 | 补登:文档正确性审查批改动①——⑬节「迷雾联动信号」行魔法提灯观测点加退役注(「魔法提灯 +2——已裁退役 2026-10-09,拆线批入库后本信号面失效」);本文件当时无版本表,本行系卫生批补登 |
|
||||
| v0.2 | 2026-10-09 | 补登:文档正确性审查批改动②——⑰节「结论回流」行裸「M-4」改「Beta 阶段(未排期)」(强度体感归 Beta 阶段带判读);同上系卫生批补登 |
|
||||
| v0.3 | 2026-10-09 | 版本历史表补建——本文件此前无版本表(2026-10-09 审查批呈报在案),本卫生批补建本表并补登上两行 |
|
||||
| v0.4 | 2026-10-09 | **文档正确性审查批·独立复核(worktree docaudit-2026-10-09)**:①三处「链接语法但目标非路径」伪死链去链接改纯文本(numfix 报告/迭代10通关率读数/T19真人试玩读数——三份读数均已退役,git 历史可查口径不变);②「难度修正批」批次名全替「数值批(Beta 阶段,未排期)」——与 06 现行归属称呼对齐(同批=M4 数值批需求卡片,未排期态不变) |
|
||||
|
||||
@@ -152,7 +152,7 @@ GP(显示名「金币」)是冒险内的一次性属性提升货币:战斗
|
||||
|
||||
掉落掷定消费 gp_drop 封闭随机流(主种子派生、可回放)。**商店货架抽签消费 shop_draw 封闭随机流**(v0.13 扩签——每次抽 3〔进店+每次买后重抽〕恰一 scope,与 reward_pick 分签防取数序互扰)。掉落与价格的现行行值读商店表(registry 为准),数值所有权归[难度曲线与Boss](难度曲线与Boss.md)曲线调参批——本批骨架先行,全部数值 provisional。
|
||||
|
||||
**共享池账本(v0.13 P1 共享池单点;v0.14 令牌库换代)**:商店货架与提升三选一是**同一个池**——货架候选 = 池∖{GP 袋, 刷新件}∪{凭证} = {攻击, 生命上限, 护甲, 行动点, 回复, 凭证} 六种(GP 袋计价物不自售切边、刷新件不上货架、秘宝件已随同调批出池;凭证与回复随迭代15② 入架——shop.tres pool_shelf 六行);**库存 = 剩余令牌数**(TP0——「池消耗即上限」,种类次数上限退役,与奖励兑付摘牌同一令牌库承载,全冒险一次性跨关卡不补给):商店买一件,奖励面就少一枚;「无限购买」收敛为**钱尽或池空为止**(池空=硬闸、A 链爬价=软闸),空货架合法态。货架 = **令牌级抽签**(同 kind 去重每 kind 至多一卡,价格公式 tier-blind 维持批②裁定,购买消费在架令牌本体 kind+tier)。两渠道不得各自私记库存——消费走同一入口写同一令牌库(实现=AdventureRunner._bonus_deck 单点,冒险结构 owner;kind 维度派生计数 _bonus_taken 承载断点附随件与读数)。**货架独立刷新(v0.15 MC-1 2026-10-04——P-C2+Q2 裁)**:进店免费刷新次数(基础 0,天赋/营地侧增益位预留)用尽后 GP 付费刷新(ceil(20×1.8^已付费刷) provisional——调参表旋钮 shop_refresh_*);重抽=同 pool_draw 共享池抽签(shop_draw 恰一新 scope),池空=不可刷新合法态;进店/离开双向清零付费刷计数。**三选一同款付费档(v0.16 2026-10-06 用户令——刷新对齐商店)**:提升三选一免费双源(刷新件 X/冒险池 Y,机制正主=[秘宝](../跨局循环/秘宝.md)三选一刷新双源节)用尽后 GP 付费刷新——读同 shop_refresh_* 两旋钮(单点调参)、扣同一 GP 冒险账本(LevelRunner.spend_gp 单口)、重抽同 reward_pick 共享池抽签;付费刷计数每停点清零(与进店清零同构);钮常驻选择态、免费与付费两源皆穷=禁用。
|
||||
**共享池账本(v0.13 P1 共享池单点;v0.14 令牌库换代)**:商店货架与提升三选一是**同一个池**——货架候选 = 池∖{GP 袋, 刷新件}∪{凭证} = {攻击, 生命上限, 护甲, 行动点, 回复, 凭证} 六种(GP 袋计价物不自售切边、刷新件不上货架、秘宝件已随同调批出池;凭证与回复随迭代15② 入架——shop.tres pool_shelf 六行);**库存 = 剩余令牌数**(TP0——「池消耗即上限」,种类次数上限退役,与奖励兑付摘牌同一令牌库承载,全冒险一次性跨关卡不补给):商店买一件,奖励面就少一枚;「无限购买」收敛为**钱尽或池空为止**(池空=硬闸、A 链爬价=软闸),空货架合法态。货架 = **令牌级抽签**(同 kind 去重每 kind 至多一卡,价格公式 tier-blind 维持批②裁定,购买消费在架令牌本体 kind+tier)。两渠道不得各自私记库存——消费走同一入口写同一令牌库(实现=AdventureRunner._bonus_deck 单点,冒险结构 owner;kind 维度派生计数 _bonus_taken 承载断点附随件与读数)。**货架独立刷新(v0.15 MC-1 2026-10-04——P-C2+Q2 裁)**:进店免费刷新次数(基础 0,天赋/营地侧增益位预留)用尽后 GP 付费刷新(ceil(20×1.8^已付费刷) provisional——调参表旋钮 shop_refresh_*);重抽=同 pool_draw 共享池抽签(shop_draw 恰一新 scope),池空=不可刷新合法态;进店/离开双向清零付费刷计数。**三选一同款付费档(v0.16 2026-10-06 用户令——刷新对齐商店)**:提升三选一免费双源(刷新件 X/冒险池 Y,机制现行事实源=[秘宝](../跨局循环/秘宝.md)三选一刷新双源节)用尽后 GP 付费刷新——读同 shop_refresh_* 两旋钮(单点调参)、扣同一 GP 冒险账本(LevelRunner.spend_gp 单口)、重抽同 reward_pick 共享池抽签;付费刷计数每停点清零(与进店清零同构);钮常驻选择态、免费与付费两源皆穷=禁用。
|
||||
|
||||
### 关卡大奖励:通关回血 + 提升三选一(钥石退役出大奖励)
|
||||
|
||||
@@ -184,7 +184,7 @@ GP(显示名「金币」)是冒险内的一次性属性提升货币:战斗
|
||||
|
||||
**抽取机制 = 令牌池洗牌不放回(v0.14 追认 b 实施形态,取代 E-S 加权洗牌)**:池 = 固定配额令牌库(普通 70/稀有 25/罕见 3=98 张,kind×tier 多重集);洗牌 = Fisher-Yates 不放回抽 3(**同 kind 去重每 kind 至多一枚**——「三选一=三种不同选项」体验延续;kind 出现率∝剩余令牌数,档位配额即分布、无独立权重 knob);**选中踢池、未选回池**(抽签不摘牌、兑付才摘牌);**池耗即枯竭**(余库不足出齐剩余,空库=零候选合法态直通);**种类次数上限退役**(池消耗即上限)。消费 reward_pick 封闭随机流(主种子派生、[数据配置](../表现与支撑/数据配置.md)口径),同种子同操作序列同三选项可复放。**MC 策略 316-f**:autoplay 1 级优先度=最稀有(rarest>rare>common)、2 级=最左。**提升池为冒险级单例**(迭代 10 追加批):关卡内奖励节点的三选一与通关三选一共享同一令牌库(同库同摘牌),兑付语义归[关卡节点地图](关卡节点地图.md)。
|
||||
|
||||
**秘宝件受同调位约束**(2026-10-09 注:道具件已随迭代 11 第①批 T7 出池——三选一/奖励节点/战斗内渠道现行零道具件投放,下述渠道约束与替换交互无现役触发面,保留作渠道恢复时的契约口径;同调位读数正主=attunement_growth.tres 谓词表实时求值):道具持有上限 = 同调位数。读数源 = 同调位里程碑谓词表 attunement_growth.tres 实时求值(0 起步、硬上限 3、增长 = 通关次数 + Boss 击杀数——同调实施批 2026-10-03 落地,过渡读数源 transitional_sync_slots 已随批退役;原提案八拍板 git 57da58c 已退役)。获取渠道约束形态(迭代 10 过渡承载):三选一道具件超位触发**替换交互**(现有件与新件 N+1 选 N——丢任一原有件腾位收新,或放弃新件不获取;终态恒 ≤ 同调位);奖励节点与战斗内渠道超位**不授予**(候选拒绝 + 掉落沉没,逐行归因留痕)——停点渠道全覆盖的替换交互随同调实施批统一收口(原 06 条目已随收口移除)。
|
||||
**秘宝件受同调位约束**(2026-10-09 注:道具件已随迭代 11 第①批 T7 出池——三选一/奖励节点/战斗内渠道现行零道具件投放,下述渠道约束与替换交互无现役触发面,保留作渠道恢复时的契约口径;同调位读数现行事实源=attunement_growth.tres 谓词表实时求值):道具持有上限 = 同调位数。读数源 = 同调位里程碑谓词表 attunement_growth.tres 实时求值(0 起步、硬上限 3、增长 = 通关次数 + Boss 击杀数——同调实施批 2026-10-03 落地,过渡读数源 transitional_sync_slots 已随批退役;原提案八拍板 git 57da58c 已退役)。获取渠道约束形态(迭代 10 过渡承载):三选一道具件超位触发**替换交互**(现有件与新件 N+1 选 N——丢任一原有件腾位收新,或放弃新件不获取;终态恒 ≤ 同调位);奖励节点与战斗内渠道超位**不授予**(候选拒绝 + 掉落沉没,逐行归因留痕)——停点渠道全覆盖的替换交互随同调实施批统一收口(原 06 条目已随收口移除)。
|
||||
|
||||
最后一关通关不发三选一与部分回血:没有下一战可受益——只做冒险完成结算,末关 Boss 钥石照常入账。设计意图:清库之后才兑付、末关不兑付,都是从「奖励只朝下一战生效」这一条推出来的。
|
||||
|
||||
@@ -331,11 +331,11 @@ GP(显示名「金币」)是冒险内的一次性属性提升货币:战斗
|
||||
| v0.9 | 2026-09-23 | **停点前移批流程口径对齐(用户 2026-09-23 拍板冒险入口流程倒置修复——与 HUD框架 / 关卡节点地图 / battle.md / `../../../dev/architecture/adr-0006-board-node2d-rendering.md` 同批)**:P0 闭环「开始关卡」条改新流程口径——关卡节点地图加载节点图后停在入口选路停点(关卡画面,选路覆盖层常驻形态),行进自玩家首次选路开始;通读复核其余章节——「通关自动进下一关」属关卡序列层语义(进入下一关后仍出图选路,零矛盾)、接口契约四件套、收束点先清库后宣布、放弃入口(选路停点 = 天然非战斗期)等既有裁决零改动。**批内代拍板三项已追认(2026-09-24 用户确认)**(字母不重编 / 28px 归 C/D 底行 / 进度呈现由选路覆盖层节点态承载)不落本文修订面,登记见 HUD框架 v0.8 |
|
||||
| v0.10 | 2026-09-27 | **统一随机流批口径对齐(ADR-0007 裁丙——rng 架构批随批)**:主种子节「可复现域 = 主种子 + 各随机流计数器」改「主种子 + 全局取数计数器」(语义权威指数据配置);本文规则面零改动——主种子恰一次注入、重开即全新一轮、摘要五件事均不变。代码实证与七消费点迁移见数据配置 v0.5 |
|
||||
| v0.11 | 2026-09-29 | **冒险断点批(迭代 8 卡①③——中断可续玩/退出即结算两口径分离)**:核心规则新增「冒险断点」节(停点粒度/七字段拍板面+附随件/中断退出两口径/续玩语义/测量面静默);依赖表存档序列化行补断点域 owner 登记;验收标准 GP 不留痕条补断点域豁免口径。实现落点 = AdventureRunner 快照/清除/续玩 + SaveManager breakpoint 域 + rng restore_adventure |
|
||||
| v0.12 | 2026-10-01 | **关卡大奖励重构批(迭代 10——用户 2026-09-30 拍板案丙 + P-A~P-E 全裁毕;冒险表扩列 / meta.tres 重锚 / registry / 行动经济 / 元进度 / 01-核心循环 / 03-内容规模 / 难度曲线与Boss / 关卡节点地图 / 06 同批落文)**:①大奖励「固定三件套」退役改两层兑付——非末关通关 = 部分回血(clear_heal_pct 20 provisional)+ 提升三选一(池六种:攻击/生命上限/护甲/GP 袋/秘宝/行动点件;加权洗牌不放回 E-S weight-key 消费 reward_pick 封闭流;属性件上限各 3、AP 件上限 2,达上限先剔牌库);②统一冒险加算区三轴扩四轴 +行动点(AP 件 = 每场战斗开始首轮基线 +1);③钥石退役出大奖励改 Boss/精英击杀逐杀掉落(boss_keystone 重锚首杀 3/复杀 2,末关照常入账,精英掉 1 预留);④秘宝件受同调位约束(过渡键 transitional_sync_slots=1 provisional,正主 = 同调实施批谓词表;超位替换交互 N+1 选 N、战斗内渠道沉没不入);⑤断点附随件扩奖励选择态 + 件获取次数计数;⑥选择停点零自动推进/可中断。渲染层验证冻结(用户 2026-10-01 提前开工拍板——不合入 master、目检待批),目检清单随批交付 |
|
||||
| v0.12 | 2026-10-01 | **关卡大奖励重构批(迭代 10——用户 2026-09-30 拍板案丙 + P-A~P-E 全裁毕;冒险表扩列 / meta.tres 重锚 / registry / 行动经济 / 元进度 / 01-核心循环 / 03-内容规模 / 难度曲线与Boss / 关卡节点地图 / 06 同批落文)**:①大奖励「固定三件套」退役改两层兑付——非末关通关 = 部分回血(clear_heal_pct 20 provisional)+ 提升三选一(池六种:攻击/生命上限/护甲/GP 袋/秘宝/行动点件;加权洗牌不放回 E-S weight-key 消费 reward_pick 封闭流;属性件上限各 3、AP 件上限 2,达上限先剔牌库);②统一冒险加算区三轴扩四轴 +行动点(AP 件 = 每场战斗开始首轮基线 +1);③钥石退役出大奖励改 Boss/精英击杀逐杀掉落(boss_keystone 重锚首杀 3/复杀 2,末关照常入账,精英掉 1 预留);④秘宝件受同调位约束(过渡键 transitional_sync_slots=1 provisional,现行事实源 = 同调实施批谓词表;超位替换交互 N+1 选 N、战斗内渠道沉没不入);⑤断点附随件扩奖励选择态 + 件获取次数计数;⑥选择停点零自动推进/可中断。渲染层验证冻结(用户 2026-10-01 提前开工拍板——不合入 master、目检待批),目检清单随批交付 |
|
||||
| v0.13 | 2026-10-03 | **GP 商店房重构批(迭代 11 第②批——需求卡片 v1.3 全裁 P1 共享池/P1-a/P1-b 双甲/P2 甲/P3 甲/P4 ceil/P5 甲;06「GP 商店房重构」条 2026-10-02 用户裁决取代 09-20 无刷新裁决)**:①GP 冒险账本节商店购买行换代——价格公式 = ceil(基价 × b^(关序−1) × A^(本次进店已购次数))(A/b provisional 1.8/1.1;legacy 旧式随对照模式保留注记);②新增「共享池账本」段——商店货架 = 池∖{GP 袋}∖{秘宝件} 四种,库存=上限即库存全冒险一次性,两渠道同一账本(买一件=奖励面少一件),池空硬闸+空架合法态;③shop_draw 扩签登记;④统一冒险加算区段——pool 模式买上限不回血(池件=奖励件本体)、AP 件累加源并商店;⑤断点附随件扩商店货架态(shop_shelf/shop_visit_buys,P2 甲;确定性重放承载注记);⑥调参表 GP 经济参数行随表换代。实现=AdventureRunner/LevelRunner 池模式(缺省 legacy 对照承载,真实入口投 pool) |
|
||||
| v0.14 | 2026-10-03 | **令牌池落地批(迭代 12 TP0——node-reward v2.2 追认 b 实施批)**:①提升池改**固定配额令牌池**——普通 70/稀有 25/罕见 3=98 张〔罕见档原列「道具件 2」随 aux_item 池种退役〔迭代 11 第①批 T7,落地晚于追认 b〕收窄,池总量 100→98——台账自决披露项〕;②抽取机制换代——Fisher-Yates 不放回抽 3 同 kind 去重每 kind 至多一枚(取代 E-S 加权洗牌),选中踢池未选回池、池耗即枯竭、**种类次数上限退役**;③恢复件新入池(rare 档 +6 当即回血封顶生效上限)+ 数值对(小GP 20/大GP 50 等);④MC 策略 316-f 落地(autoplay 1 级最稀有/2 级最左);⑤共享池账本段换代——库存=剩余令牌数,货架=令牌级抽签(价格公式 tier-blind 维持批②裁定),消费=AdventureRunner._bonus_deck 单点;⑥断点附随件扩令牌池余库(bonus_deck 逐枚还原;旧断点缺键=满库重建防御口径单版本周期);⑦现行基线锚换代=runsum_m4iter12_tp0_n20_20261003(normal 档配对读数同带 0/5/0) |
|
||||
| v0.16 | 2026-10-06 | **三选一刷新对齐商店批(用户令——「三选一对齐商店,得有刷新」;机制正主=秘宝.md 三选一刷新双源节同批落文)**:免费双源(刷新件 X/冒险池 Y)用尽后 GP 付费刷新——同 shop_refresh_* 两旋钮(curio_refresh_gp_cost 单点调参)、扣同一 GP 冒险账本(LevelRunner.spend_gp 新单口)、重抽同 reward_pick 共享池抽签;付费刷计数每停点清零;呈现=CurioPickOverlay.set_refresh_display 与商店 set_refresh_display 同构(钮常驻选择态、两源皆穷禁用不隐藏、角标=免费余量、价签行示 GP 价);通关停点刷新重发载荷带 refreshed 标直落选择面(不再重开胜利总结面)。店内凭证专长三选一暂不挂刷新面(维持现状)。单测=tests/unit/core/curio_refresh_paid_test.gd |
|
||||
| v0.17 | 2026-10-07 | **生命周期轴裁决随批(框架正主=核心循环「生命周期轴」节同批落文)**:GP 冒险账本节补独立资源口径——GP 与钥石=两条平行独立资源不立统一上位概念(钥石归元进度同批落文);各层对 GP 的兑付=一次性转换入账(转换源结算即消尽、钱包长存,类A→类C 转换关系非横跨多层);既有账本语义零改动 |
|
||||
| v0.16 | 2026-10-06 | **三选一刷新对齐商店批(用户令——「三选一对齐商店,得有刷新」;机制现行事实源=秘宝.md 三选一刷新双源节同批落文)**:免费双源(刷新件 X/冒险池 Y)用尽后 GP 付费刷新——同 shop_refresh_* 两旋钮(curio_refresh_gp_cost 单点调参)、扣同一 GP 冒险账本(LevelRunner.spend_gp 新单口)、重抽同 reward_pick 共享池抽签;付费刷计数每停点清零;呈现=CurioPickOverlay.set_refresh_display 与商店 set_refresh_display 同构(钮常驻选择态、两源皆穷禁用不隐藏、角标=免费余量、价签行示 GP 价);通关停点刷新重发载荷带 refreshed 标直落选择面(不再重开胜利总结面)。店内凭证专长三选一暂不挂刷新面(维持现状)。单测=tests/unit/core/curio_refresh_paid_test.gd |
|
||||
| v0.17 | 2026-10-07 | **生命周期轴裁决随批(框架现行事实源=核心循环「生命周期轴」节同批落文)**:GP 冒险账本节补独立资源口径——GP 与钥石=两条平行独立资源不立统一上位概念(钥石归元进度同批落文);各层对 GP 的兑付=一次性转换入账(转换源结算即消尽、钱包长存,类A→类C 转换关系非横跨多层);既有账本语义零改动 |
|
||||
| v0.18 | 2026-10-09 | **文档正确性审查批(用户令——状态记录与证据对齐)**:①关卡序列节「第二关生效有前提、未落地前单关运行」过期句替换——三关序列 2026-09-21 起均已生效;②共享池账本货架候选订正——pool_shelf 六行 = 池∖{GP 袋, 刷新件}∪{凭证}(凭证与回复随迭代15② 入架),「∖{GP 袋} 四种」过期;③大奖励表提升三选一「加权抽 3、另 2 件丢弃」改令牌池口径(洗牌不放回抽 3、未选回池);④提升池表六种→七种——恢复件配额 稀有 5→3、补刷新件行(稀有 2/+1,迭代15② 入池);⑤秘宝件同调位读数源改谓词表实时求值(transitional_sync_slots 已退役、切换义务清偿,调参表过渡键行同改);⑥断点附随件「秘宝库存」重复短语去重;⑦P2 冒险长度扩展行「MVP 两关」改「现行三关」;⑧调参表关卡行集行「第一关现行、第二关随扩展批」改「三关现行(templates 池 3×5)」、三选一件值(其余)行 bonus_* 旧键改 curio_value_* 列族、三选一权重行整体标退役(E-S 随 TP0 换代)、件次数上限行删「GP/道具件无次数上限」残句;⑨验收三条订正——抽签封闭条「AP 用尽 2 次/属性件达 3 次先剔」改「令牌耗尽快即枯竭」、同调位条「过渡键」改「谓词表实时求值」、加算区同账条购买生命上限改 pool 模式语义(只加上限不回当前生命);⑩不负责表「节点奖励内容与库存语义→地图战斗资源」改「节点奖励件的分类与凭证定义→奇物」(提升池构成与库存归本文——两文档互指矛盾收口)。 |
|
||||
| —— | 2026-10-09 | 缺号注记:v0.15 未登记(对应批次=MC-1 商店独立刷新机制批〔2026-10-04,git ac3cee7 提交信息明记「冒险结构v0.15回写」、版本行未入表〕,登记见正文「共享池账本」节 v0.15 标签),卫生批仅注记不补写 |
|
||||
| v0.19 | 2026-10-09 | 文档正确性审查批·独立复核(worktree docaudit-2026-10-09):「秘宝件受同调位约束」段与验收「同调位约束」条补现状注——道具件已随迭代 11 第①批 T7 出池,三渠道零投放、替换交互无现役触发面(与关卡节点地图 v1.7「满位替换子交互随之不再触发」口径对齐),约束保留作渠道恢复契约;段内「(06 在册)」悬空指针改「原 06 条目已随收口移除」 |
|
||||
@@ -17,7 +17,7 @@
|
||||
|
||||
## 专长(重设计·基础框架 v1)
|
||||
|
||||
> 本节是专长分类的正主(2026-10-07 用户终审认同落文)。件表为设计声明——数值全 provisional 归调参批,实装归重设计实装批;命名全为代号,正式命名归用户。新框架实装批落地前,现役代码按同框架(订阅行+效果引擎)运行旧 27 件目录。
|
||||
> 本节是专长分类的现行事实源(2026-10-07 用户终审认同落文)。件表为设计声明——数值全 provisional 归调参批,实装归重设计实装批;命名全为代号,正式命名归用户。新框架实装批落地前,现役代码按同框架(订阅行+效果引擎)运行旧 27 件目录。
|
||||
|
||||
### 设计原则
|
||||
|
||||
@@ -114,7 +114,7 @@
|
||||
|
||||
## 资源(重设计·基础框架 v1)
|
||||
|
||||
> 本节是资源分类的正主(2026-10-07 五件新凭证用户裁准落文)。资源成员 = **转换源**:不是资源本身,是「到手即结算成独立资源或系统数值的凭证」——凭证加完消尽,被写入的账各有自己的寿命档位。判据句与归类方法见 §1.3/§1.4。新框架实装批落地前,现役代码按旧资源成员(行动点上限 / 刷新次数 / 金币 / 回复)运行。
|
||||
> 本节是资源分类的现行事实源(2026-10-07 五件新凭证用户裁准落文)。资源成员 = **转换源**:不是资源本身,是「到手即结算成独立资源或系统数值的凭证」——凭证加完消尽,被写入的账各有自己的寿命档位。判据句与归类方法见 §1.3/§1.4。新框架实装批落地前,现役代码按旧资源成员(行动点上限 / 刷新次数 / 金币 / 回复)运行。
|
||||
|
||||
### 凭证件表(新 5 + 留任 2;代号制命名归用户;稀有度档、配额与面值数值归调参批)
|
||||
|
||||
@@ -200,7 +200,7 @@
|
||||
|
||||
专长改的是规则而不是数字——它给自己加一条"在某种条件下,本来不会发生的事现在会发生"的规则。它不是任何一条属性轴的延伸,玩家也无法用"加了多少"来衡量它。
|
||||
|
||||
专长的现行体系以本文「专长(重设计·基础框架 v1)」节为正主:触发器句式(on/when/do)+ 事件族组织,不设流派标签、不设集件档位。它和另两类最直观的体感差别:属性提升是"我更耐打了",专长是"我现在会一件以前不会的事"。
|
||||
专长的现行体系以本文「专长(重设计·基础框架 v1)」节为现行事实源:触发器句式(on/when/do)+ 事件族组织,不设流派标签、不设集件档位。它和另两类最直观的体感差别:属性提升是"我更耐打了",专长是"我现在会一件以前不会的事"。
|
||||
|
||||
**专长凭证也归专长**:非 Boss 渠道不直接给专长,而是给一张名为「专长获取」的凭证——拿到后立刻开一次专长 N 选一。它给的是"一件你以前不会的事"(只是把选择推迟到一次三选一),按 1.4 的判据归专长,不归资源。详见 2.2。
|
||||
|
||||
@@ -218,7 +218,7 @@
|
||||
|
||||
#### 1.3 资源:转换源凭证
|
||||
|
||||
资源这一类装的是"不抬高战斗属性、也不改规则,但让你更有余地"的东西。成员正主=本文件「资源(重设计·基础框架 v1)」节的**凭证件表(新 5+留任 2)**;旧枚举四项的去向:行动点上限归属性值提升轴(见 1.2)、刷新次数由刷新券替代、金币与回复留任为小金币袋/应急口粮。
|
||||
资源这一类装的是"不抬高战斗属性、也不改规则,但让你更有余地"的东西。成员现行事实源=本文件「资源(重设计·基础框架 v1)」节的**凭证件表(新 5+留任 2)**;旧枚举四项的去向:行动点上限归属性值提升轴(见 1.2)、刷新次数由刷新券替代、金币与回复留任为小金币袋/应急口粮。
|
||||
|
||||
**资源为什么单独成一类**:它的成员不满足"抬高战斗属性"(那归属性值提升),也不满足"改写规则"(那归专长),但玩家拿到时的感受是一致的——"我能做的事变多了"。把它们跟属性提升混在一起,会让"加了多少攻击"这种可度量的提升和"多一次重抽"这种不可度量的余地摆在同一张候选卡上,玩家没法比。即时兑付的金币与回复同留本类、不独立成第四类(2026-10-05 用户定)——判据与资源完全同源,拆出去只会让读者多查一张表。
|
||||
|
||||
@@ -424,7 +424,7 @@
|
||||
| 专长定义行(标识 / 显示名 / 稀有度 / 效果说明 / 订阅行〔订阅哪个事件 on / 什么条件 when / 什么效果 do〕) | 各字段封闭枚举,行键白名单封闭;事件 / 效果类型 / 条件事实 / 算子四词表封闭(效果引擎单一事实源);稀有度档=新四级(普通/优秀/稀有/传说),schema 字段双脱钩(字段在、设计面按档配比加权) | `game/data/tables/feats.tres` |
|
||||
| 专长凭证(出现概率 / 配额 / 限购次数 / 保底计数阈值) | 整数,四参数全 provisional | 已入表(迭代15② 凭证行——`shop.tres` + `adventure_table.gd`) |
|
||||
| 属性值提升种类 | 封闭三项:生命上限 / AC / 攻击,扩项走文档修订 | `game/data/schemas/adventure_table.gd` |
|
||||
| 资源种类 | 种类正主=「凭证件表(新 5+留任 2)」节;凭证已入表(迭代15②) | 同上 |
|
||||
| 资源种类 | 种类现行事实源=「凭证件表(新 5+留任 2)」节;凭证已入表(迭代15②) | 同上 |
|
||||
| 稀有度档位 | 封闭四级(普通 / 优秀 / 稀有 / 传说);配额是结构锚,改总量须重新拍板而非调参 | 同上 |
|
||||
| 各分类种类 × 档位的配额与值 | 整数 | `game/data/tables/adventure.tres` |
|
||||
| 专长获取的全局限量 | 整数(一局内可获得的次数上限) | 同上 |
|
||||
@@ -469,15 +469,15 @@
|
||||
| **新增 1.6 节「三层结构与命名」**(用户 2026-10-05 拍板做玩家可见的三层):奇物(总称)/三个分类/具体单件。明确**命名是本节规矩、呈现是另一件事**——分类名在卡面不出现(归 battle.md / node-reward.md 裁决),但帮百科、成就名、效果描述的指代三处都要用,所以它必须是玩家读一遍就懂的正式名词。连带:修掉批量替换撞出的五处「专长(专长)」类自撞、v2.0 历史行内的自撞并标注当时的旧称、registry 的「资源(命名待定)」过期标注。
|
||||
| **v2.8** | 2026-10-06 | **效果行为数据驱动换代(内容数据驱动扩展批)**:专长的效果声明从「挂点+效果字典」换为「订阅行」——每件声明**订阅哪个事件(on)/ 什么条件(when)/ 什么效果(do)**,由效果引擎统一解释执行;旧挂点枚举消亡(事件名+效果类型取代)。配套事实:效果引擎 `game/core/effect_engine.gd`(事件 16 / 效果类型 24 / 条件事实 9 / 算子封闭词表);专长行 `feats.tres` 27 件全量迁移,秘宝被动六件同批订阅化;行为与迁移前逐位一致(MC 同种子 40 局逐位对拍实证)。
|
||||
| **v2.9** | 2026-10-07 | **专长体系推倒重设计裁(用户裁——道具三层重设计·奇物层)**:专长分类的**流派标签(archetype)与档位机制(集件质变)框架级作废**——用户判流派式设计「烂到极点」,且流派标签从未被认可为呈现面概念(命名铁律:流派名禁上玩家可见面,06「内部分类禁写入玩家可见面」条升格);现行 27 件全数待重设,重设计主权归用户,灵感原材料归调研批(design/research 两份 2026-10-07 调研);审查「六流派档位兑付位立项」方向随档位作废注销。专长=机制改写件的分类定位、凭证/渠道机制、属性值提升与资源两分类不受影响。新增准入校验(重设计适用):**代价与收益须同账可核算**——「纯代价件」禁止出生(深挖钻头/整备军备教训);头部加冻结遗留态横幅。 |
|
||||
| **v3.0** | 2026-10-07 | **专长基础框架落地批(用户终审认同——道具三层重设计·奇物层)**:新增「专长(重设计·基础框架 v1)」节=新正主——设计原则五条(触发器句式/事件族组织不上卡面/准入校验同账可核算/信息红线/防兑换环)+基础件表 18 件(开格系6/插旗系3/踩雷系3/节奏系3/战斗系3+契约尖点1;代号制命名归用户)+扩签登记(新事实候选6+停手挂点+清图事件暂缓)+老27件处置(随实装批整体替换、仅作素材库不默认继承);横幅由「推倒重设计中」翻转「基础框架已立」;数值归调参批、实装归重设计实装批。 |
|
||||
| **v3.1** | 2026-10-07 | **档位名与 rarity 语义约束随批(正主=[核心循环](../../01-核心循环.md)「档位与获取规则」节 v1.5 同批落文)**:稀有度四级采用**普通/优秀/稀有/传说**——本层旧三档名映射=普通→普通、稀有→优秀、罕见→稀有,第四级「传说」=新增头奖位(正文档名扫改归奇物批次);**专长 rarity 语义约束落为文档约束**——Boss 三选一候选按档配比或加权抽取(双脱钩修复:此前 rarity 不影响抽选也不稳代表幅度;配比数值归调参批,MC「最稀有优先」策略的读数偏颇随实装一并校正);「获取概率提升不动保底」护栏同批。 |
|
||||
| **v3.2** | 2026-10-07 | **资源分类基础框架落地批(五件新凭证用户裁准——道具三层重设计·奇物层)**:新增「资源(重设计·基础框架 v1)」节=新正主——定义句重写为**转换源**(成员=到手即结算成独立资源/系统数值的凭证,加完消尽,账各有寿命档)+凭证件表新 5 留任 2(刷新券/储备金袋RAP/同调电池/时沙/完美保险+小金币袋/应急口粮;代号制命名归用户,稀有度档配额面值归调参批)+上架原则(默认原则全渠道可出);§1.3 判据句与异质性节随迁重写(凭证全部即时消尽,异质性=账的寿命不在凭证上);池子档位形态(各档装什么)待用户裁后随批 |
|
||||
| **v3.0** | 2026-10-07 | **专长基础框架落地批(用户终审认同——道具三层重设计·奇物层)**:新增「专长(重设计·基础框架 v1)」节=新现行事实源——设计原则五条(触发器句式/事件族组织不上卡面/准入校验同账可核算/信息红线/防兑换环)+基础件表 18 件(开格系6/插旗系3/踩雷系3/节奏系3/战斗系3+契约尖点1;代号制命名归用户)+扩签登记(新事实候选6+停手挂点+清图事件暂缓)+老27件处置(随实装批整体替换、仅作素材库不默认继承);横幅由「推倒重设计中」翻转「基础框架已立」;数值归调参批、实装归重设计实装批。 |
|
||||
| **v3.1** | 2026-10-07 | **档位名与 rarity 语义约束随批(现行事实源=[核心循环](../../01-核心循环.md)「档位与获取规则」节 v1.5 同批落文)**:稀有度四级采用**普通/优秀/稀有/传说**——本层旧三档名映射=普通→普通、稀有→优秀、罕见→稀有,第四级「传说」=新增头奖位(正文档名扫改归奇物批次);**专长 rarity 语义约束落为文档约束**——Boss 三选一候选按档配比或加权抽取(双脱钩修复:此前 rarity 不影响抽选也不稳代表幅度;配比数值归调参批,MC「最稀有优先」策略的读数偏颇随实装一并校正);「获取概率提升不动保底」护栏同批。 |
|
||||
| **v3.2** | 2026-10-07 | **资源分类基础框架落地批(五件新凭证用户裁准——道具三层重设计·奇物层)**:新增「资源(重设计·基础框架 v1)」节=新现行事实源——定义句重写为**转换源**(成员=到手即结算成独立资源/系统数值的凭证,加完消尽,账各有寿命档)+凭证件表新 5 留任 2(刷新券/储备金袋RAP/同调电池/时沙/完美保险+小金币袋/应急口粮;代号制命名归用户,稀有度档配额面值归调参批)+上架原则(默认原则全渠道可出);§1.3 判据句与异质性节随迁重写(凭证全部即时消尽,异质性=账的寿命不在凭证上);池子档位形态(各档装什么)待用户裁后随批 |
|
||||
| **v3.3** | 2026-10-07 | **池结构与抽取落文(用户裁案D——归档打底做翼+曝光槽,道具三层重设计·奇物层)**:新增「池结构与抽取(重设计 v1)」节——令牌=出现次数上限明文化(拿消耗/没拿回池/刷新不消耗,「只刷出没拿」不计次,TP0 语义沿用);内容归档=普通档面粉打底、优秀/稀有档功能凭证做翼、传说档惊喜位(按决策影响力归档不按数值);曝光槽=三选一 2 格全池+1 格「优秀档以上」子池(子池空回退全池,池空直通同族);凭证维持独立计数体系不进子池;配额改动须用户重裁(TP0 结构锚非调参);MC 策略读数影响随实装复核 |
|
||||
| **v3.4** | 2026-10-07 | **概率与上限解耦约束+耦合问题登记(用户指出的令牌模型冲突——道具三层重设计·奇物层)**:池结构节补两条——①**概率与上限解耦**(设计约束,新内容必检:概率位与已拿上限=两个独立字段,拿了才计/刷出不计,互不决定);②已知耦合问题与实现路径候选三案登记(令牌 N 张同时承担概率与上限不可独立设定——抽象权重表+独立计数器/令牌池+提前退役计数器/维持耦合已否;选型归实装批,影响面=MC 对账与断点存档)。用户裁:实现设计不定于现在,只落约束与问题点防后续撞车 |
|
||||
| **v3.5** | 2026-10-07 | **秘宝域迁出两件迁入登记(用户裁——秘宝层归留裁决同批)**:淬毒刃纹→战斗系克制向(`on attack_commit + advantageous → 追加 +N`);标中殉爆→插旗系(`on flag_hit → 全体存活敌 N 群伤`,插旗系补第 4 件;数值均归调参批);惊巢反制→退役进素材库(归[秘宝](..\排雷循环\秘宝.md)速览「目录处置」同批);实装批执行数据迁移 treasure→feats 并补入件表 |
|
||||
| **v3.6** | 2026-10-09 | **旧条例外科摘除批(用户令——流派方向讨论中暴露的活矛盾)**:①分类表专长行、§1.1、生命周期表、P1 后置四处「流派标签·集件档位质变」残句摘除——v2.9 已框架级作废,残句以正文规则身份存活、持续误导设计(「战斗系占比须治理」伪问题即其衍生);②验收标准第 4 条 B1 铁律(每流派标签 ≥1 件挂排雷侧触发点)作废,替换为条件判据「收益必挂条件、无条件数值归属性值提升」(用户同日讯:纯属性增加不是专长,通过条件获得数值才是专长要做的);③待办两条(档位阈值匹配复裁 / charge 标签缺陷)因对象消亡注销。未动:冻结遗留(老 27 件清单与战斗结算侧现行代码行为描述)仍随重设计实装批整体替换;06-待办清单内三处描述性残留(BD 分层条目现状文 / charge 条 / 档位呈现裁点)归 06 条目自身生命周期,另行列出。 |
|
||||
| **v3.7** | 2026-10-09 | **去毒批(用户立「文档去毒」为首要任务)**:退役术语魔法道具→秘宝(正文各处,含关联边界表)/档名三档→四级扫改(罕见→稀有)/凭证与刷新入表状态订正(迭代15② 已落籍,调参表与 P1 与待办节同步)/资源成员指路凭证件表/验收第 3 条改令牌口径——新老框架分家第一步,老章节冻结段随实装批整体替换不变。 |
|
||||
| **v3.8** | 2026-10-09 | **文档正确性审查批(用户令——状态记录与证据对齐)**:①§1.6 命名节例子「同标签达到 4 件时质变」摘除(流派标签集件档位 v2.9 已框架级作废,换为不引退役机制的归类指代例);②渠道轴交叉表专长行自撞「专长(专长)」修为「专长」(v2.7 同类自撞漏网);③§2.4 回复节现状句订正——shop.tres pool_shelf 六行已含回复(迭代15② 落地,默认原则对齐),「货架四项、回复缺席须补上」过期表述替换;④§2.5 在册事项订正——凭证形式已随迭代15② 入表实装,渠道分工仅 Boss 渠道直接给专长仍为目标状态;⑤生命周期表选定行老规则「选定即从池中剔除、任何渠道不再见」改令牌口径(拿消耗、刷出不计、耗尽不再出现——对齐验收第 3 条与 TP0 在役语义);⑥依赖与输出表摘除「档位求值结果」(集件档位作废的漏网输出);⑦§1.2 补成员变动在途注(行动点上限归属性值提升轴,在役仍三项、迁动归实装批——对齐 §1.3 表下正主注)。 |
|
||||
| **v3.7** | 2026-10-09 | **去毒批(用户立「文档去毒」为首要任务)**:退役术语魔法道具→秘宝(正文各处,含关联边界表)/档名三档→四级扫改(罕见→稀有)/凭证与刷新入表状态订正(迭代15② 已入库,调参表与 P1 与待办节同步)/资源成员指路凭证件表/验收第 3 条改令牌口径——新老框架分家第一步,老章节冻结段随实装批整体替换不变。 |
|
||||
| **v3.8** | 2026-10-09 | **文档正确性审查批(用户令——状态记录与证据对齐)**:①§1.6 命名节例子「同标签达到 4 件时质变」摘除(流派标签集件档位 v2.9 已框架级作废,换为不引退役机制的归类指代例);②渠道轴交叉表专长行自撞「专长(专长)」修为「专长」(v2.7 同类自撞漏网);③§2.4 回复节现状句订正——shop.tres pool_shelf 六行已含回复(迭代15② 落地,默认原则对齐),「货架四项、回复缺席须补上」过期表述替换;④§2.5 在册事项订正——凭证形式已随迭代15② 入表实装,渠道分工仅 Boss 渠道直接给专长仍为目标状态;⑤生命周期表选定行老规则「选定即从池中剔除、任何渠道不再见」改令牌口径(拿消耗、刷出不计、耗尽不再出现——对齐验收第 3 条与 TP0 在役语义);⑥依赖与输出表摘除「档位求值结果」(集件档位作废的漏网输出);⑦§1.2 补成员变动在途注(行动点上限归属性值提升轴,在役仍三项、迁动归实装批——对齐 §1.3 表下现行事实源注)。 |
|
||||
| **v3.9** | 2026-10-09 | **B3/B4 两裁落文(用户令)**:①P1 后置「两项合成高阶项」注销——非用户设计意图的脏信息,合成方向若需要按新体系重新生一件;②§3 刷新次数例外句口径换代——一律按最新设计口径:刷新次数由刷新券替代(凭证到手即结算进刷新存量账、加完消尽不进持有集),旧「进同一份持有账本」表述作废、随实装批整节删除 |
|
||||
| **v3.10** | 2026-10-09 | 文档正确性审查批·独立复核(worktree docaudit-2026-10-09):①§1.3 异质性节「被写入的账」清单对齐凭证件表——旧四项时代「AP 上限」摘除(已归属性值提升轴,§1.2 在途注),补生命账/秘宝充能两账;②依赖与输出表 `relics.tres` 改 `feats.tres`(表文件已随词族对齐批换代,data/tables/ 无 relics.tres——代码实证) |
|
||||
| **v3.11** | 2026-10-10 | **正文换代批(方案甲,用户裁「旧的删、误标改」——同秘宝.md v2.2 同法)**:①头部冻结横幅摘除——所指「流派/档位/27 件清单」旧章节正文已不存在,名单承载=[道具退役素材库](../../../research/道具退役素材库.md)表二;②专长/资源两节引言去「冻结遗留态/随实装批整体替换」错标,各落一句「新框架实装批落地前,现役代码按同框架运行」;③§1.3 旧资源四项枚举表删除(成员去向一行交代:行动点上限归属性值提升轴/刷新次数由刷新券替代/金币回复留任为小金币袋/应急口粮),回复归属裁定并入「资源为什么单独成一类」段;④§1.2 在途注与 §3 刷新例外去标注改正文(行动点上限归本轴/刷新券口径一律按最新设计);⑤§1.6 单件举例换新框架件(奥术余烬/贯穿射击→双管镐/疼痛记忆);⑥「谓词」用词清除——「可计算谓词」改「可计算条件」(正文与验收,版本历史行引述豁免);⑦验收 4/7/8/9 换代新口径+尾部现役代码运行线;⑧P1/P2 括注清算(已清偿/已注销条目由版本历史承载)+待办节收编为 06 单点指针。真旧内容承载=素材库表二+git 历史 |
|
||||
|
||||
@@ -104,7 +104,7 @@
|
||||
- **补签纪律**:执行序 = 装板摇号(含偏运硬币/board_skew 投影)→ 按上限定本期保底型集合 → 校验补签 → 板上全程只读。补签只改类型身份:危险格与安全格不动(补签格可为雷可为安全格,危险格与安全格同池不破)、不消费权重(补签不是一次取号)、清图判定不动、不泄露元信息(补签格与摇号格不可区分)。粒度 = 板,换板重新校验。
|
||||
- **GP 数值锚**:以战斗结束 GP 奖励为锚——小金币袋 ≈ 其 1/10、大宝箱 ≈ 其 1 倍(具体数值归调参批)。
|
||||
- 大宝箱为枚举新增(九型→十型走本文修订流程,不随手加行);微光归通用增益组(五色相不变,组内不细分正好容下)。
|
||||
- **对外稀有度映射**(正主=[核心循环](../../01-核心循环.md)「档位与获取规则」节):T1=普通 / T2=优秀 / T3=稀有 / T4=传说;任何概率提升不得改变本档保底承诺(保底=承诺非概率)。
|
||||
- **对外稀有度映射**(现行事实源=[核心循环](../../01-核心循环.md)「档位与获取规则」节):T1=普通 / T2=优秀 / T3=稀有 / T4=传说;任何概率提升不得改变本档保底承诺(保底=承诺非概率)。
|
||||
|
||||
### 极性矩阵:动作与格型决定符号
|
||||
|
||||
@@ -273,6 +273,6 @@
|
||||
| v0.17 | 2026-10-07 | **类型层身份裁决(道具三层重设计·地图层开场题——案甲用户裁,与 05-不做清单 v1.4 同批)**:设计目的节补「类型层身份」段——本层=规划素材层,未开格类型经微光可见(只读类型不读危险格与安全格,呈现归 HUD框架),「读敌拍板、抢类型」为正式设计意图;05 清单第 14 条同批收窄移出禁止面;微光实施归呈现批(06「未开格类型徽章呈现时机」条在案) |
|
||||
| v0.18 | 2026-10-07 | 地图层内容题①裁案A(用户裁):兑付形态差异化方向转正——九型枚举不动、同型兑付形态将拉开(pierce/magic 同构为首要对象),具体形态设计归用户、实施归后续批次;九型字典节补方向注记 |
|
||||
| v0.19 | 2026-10-07 | **地图层题四裁(用户裁——四档池结构)**:候选集合节新增「四档概率结构与保底」——档=概率位+保底上限两参数(T1 攻击类/T2 增益类·GP 小袋/T3 回复可保底档/T4 惊喜类永不保底档=上限 0 统一表达);保底按型登记(heal=每板 ≥1),超上限时每板随机选定兑现集合(暂定);补签四纪律(只改类型身份/不消费权重/粒度=板/不泄露元信息);GP 数值锚(小袋≈战斗结束 GP×1/10、大宝箱≈×1);大宝箱枚举新增归实装批(微光归通用增益组,五色相不变);调参表节补四档组织注记+旧「按板保底」失义句消歧;结构冻结条补「补签=装板期校验环节非重摇」;验收标准补四档保底条;袋装摇号备选挂号 06 |
|
||||
| v0.20 | 2026-10-07 | **档位名映射随批(正主=[核心循环](../../01-核心循环.md)「档位与获取规则」节 v1.5 同批落文)**:四档池节补对外稀有度映射行——T1=普通/T2=优秀/T3=稀有/T4=传说(T4=头奖级,与「极致罕见抽到就是爽」定位互证);同补护栏=任何概率提升不得改变本档保底承诺(保底=承诺非概率) |
|
||||
| v0.20 | 2026-10-07 | **档位名映射随批(现行事实源=[核心循环](../../01-核心循环.md)「档位与获取规则」节 v1.5 同批落文)**:四档池节补对外稀有度映射行——T1=普通/T2=优秀/T3=稀有/T4=传说(T4=头奖级,与「极致罕见抽到就是爽」定位互证);同补护栏=任何概率提升不得改变本档保底承诺(保底=承诺非概率) |
|
||||
| v0.21 | 2026-10-09 | **文档正确性审查批(用户令——状态记录与证据对齐)**:①格面资源节「没挖开的格子在界面上不显示里面是什么」订正——未开格类型身份已随 2026-10-07 类型层身份裁决经微光只读可见(不显示的是危险格与安全格),与 P1 呈现深度行同步(基础档已定);②清图节图类型词表 {dungeon, underdark} 补第三值 deep_underdark(第三关内容批在役,P1 差异化行同步);③负责表与 P1「功能道具渠道、渠道设计未定」订正——功能道具 = 秘宝局外同调件(渠道已随秘宝域与同调实施批落定),本系统结构位不变;④调参表 ap_up 行「weight=6」改域表述(数值纪律:行值读表)。 |
|
||||
| v0.22 | 2026-10-09 | 文档正确性审查批·独立复核(worktree docaudit-2026-10-09):依赖与输出表秘宝行「秘宝的**背包**与使用归其管」过渡形态残留——同调形态无背包(关卡域库存已退役),改「秘宝件的装配与使用归其管」并补预读接口现行零投放注(与秘宝.md v1.7 依赖表对齐) |
|
||||
@@ -380,10 +380,10 @@ EV 参考数不入正文(派生读数,需要时按判定式与现行表值
|
||||
| v0.16 | 2026-09-18 | **甲效矩阵加法核换装批(用户拍板数值语言——小整数加法核,与 01-核心循环 数值语言条款 / registry / 切片代码同批)**:量纲 percent→整数点数,三档(克制 +1/中性 0/被克 −1)九格改值〔normal 0/+1/−1、pierce −1/+1/0、magic 0/−1/+1〕,pierce×heavy = 0 中性为用户特别拍板;五档词表与百分比乘区退役(v0.15 的五档表随批短命退役,理由=个位数刻度假粒度);分量算术改述=折算取整后加修正点数;缺项回退 100→0;奖励直伤行 payload 键 effectiveness 保留、值语义改点数;池乘区/AC 折扣档/暴击保留百分比并成文粒度口径(数值语言条款:百分比仅此三处既有粗档+开发侧工具);切片同批:settlement.tres/settlement_table.gd/damage_math/battle_orchestrator/smoke/registry/01-核心循环同步 |
|
||||
| v0.17 | 2026-09-19 | **技能池新效应词汇批(用户拍板——设计权威 proposal-status-vocabulary.md〔提案已吸收退役 git a6833b6a——现行事实源=敌人系统.md 词汇表/增益状态.md〕 v1.0,与 敌人系统 / 增益状态 / registry / 切片代码同批)**:① 三乘法链尾部 +必中附加分量 rider(伤害技 rider_mult 字段:max(伤害下限, floor(攻击基线 × rider_mult))——后置加法、必中全额、不进乘区不出暴击、价位锚 0.75 = AC 折扣档最轻档;"固定值伤害"改形——固定值不随基线缩放与共享技能表前提冲突);② 增益/妨害技 = 同族施放行(0 伤害不掷不折不兑伏击),妨害状态按状态行 target_side 落主角——零新授予通道;③ 必中家族清单 +rider(掷点边界切口);④ 公式行/吃掷点行/验收标准三处同步 + 新效应词汇验收条目(rider 逐拍精确复算 + rider 键封闭 + 妨害落主角端到端);⑤ 实装面 = 仅 L2 Boss 卓尔(毒爆 +rider、新行蛛网束缚妨害→失衡),其余敌种不动;多段命中经用户拍板退役不入词汇表 |
|
||||
| v0.18 | 2026-09-19 | **插旗不可逆批(用户拍板全套落地,2026-09-18 提案转正;与排雷玩法 v0.5 / 行动经济 v0.4 / 地图战斗资源 v0.12 / registry / 切片代码同批)**:① 授予段「抵消过滤」改述「判定基线」——撤旗动作退役,旗判定以轮末在场旗为基线,被挖开的旗不入基线;② 新增插旗不可逆四情况兑付表:①标中照常 / ②插旗危险格直挖只吃挖雷惩罚标中不发 / ③标空照常 / ④插旗安全格直挖零惩罚零奖励(正向作废 + reward_ineffective 归因行);③ 挖格批兑付表补四情况分支;④ 标中资格措辞改「旗无移除手段」(拔旗重插通道消失);⑤ P0 闭环第 2/4 步与验收标准同步(「抵消过滤」条改「挖旗格兑付改判」)。切片同批:minesweeper_rules 挖旗格放行 + flag_pull 出目录 + dug_under_flag 事件标记、battle_orchestrator 情况④零奖励抑制、action_economy 表 flag_pull_ap_cost 删除、冒烟 317→327 项 0 失败(四情况探针 `_smoke_flag_irreversible_quadrants`) |
|
||||
| v0.19 | 2026-09-20 | **伤害下限全来源批(用户拍板「任何伤害取值域 [1,+∞),最小值一定是 1」;与 06 清单「零伤害/无威胁组合的跨字段护栏」收口 / registry / 切片代码同批,台账 100)**:① 下限语义从"任何攻击落地伤害"扩为"任何来源的伤害落地"——攻击双方(原有)+棋盘克制直伤(counter_component 增 landed_floor 参数,空桶不吃修正恒 0 边界不变)+爆裂正向+负向反噬(穿刺陷阱/魔法反噬/heal 反噬)+地形变异 flat_damage,全部收进 damage_floor 闸内;② 取值域成文 [1, +∞) **不设上限**——「零伤害/无威胁组合」条目的跨表上界护栏半边随拍板裁决为不设(上不封顶),敌种攻击基线 0 的退化态经下限自然消解(0 基线攻击落地仍 ≥1,"无威胁敌"结构性不存在);③ 现行表值下零行为变更(棋盘直伤贴底值 2−1=1 本就在闸内),本批=结构保证+调参防误配;④ 判读口径/约束表/调参表/验收四处措辞同步;冒烟 352→355 项 0 失败(+贴底/穿透/空桶三断言)。版本号注记:v0.19 在伏击上限删除批(未合并分支)中已被占用,本条与之合并时以先落籍者为准顺延避让 |
|
||||
| v0.19 | 2026-09-20 | **伤害下限全来源批(用户拍板「任何伤害取值域 [1,+∞),最小值一定是 1」;与 06 清单「零伤害/无威胁组合的跨字段护栏」收口 / registry / 切片代码同批,台账 100)**:① 下限语义从"任何攻击落地伤害"扩为"任何来源的伤害落地"——攻击双方(原有)+棋盘克制直伤(counter_component 增 landed_floor 参数,空桶不吃修正恒 0 边界不变)+爆裂正向+负向反噬(穿刺陷阱/魔法反噬/heal 反噬)+地形变异 flat_damage,全部收进 damage_floor 闸内;② 取值域成文 [1, +∞) **不设上限**——「零伤害/无威胁组合」条目的跨表上界护栏半边随拍板裁决为不设(上不封顶),敌种攻击基线 0 的退化态经下限自然消解(0 基线攻击落地仍 ≥1,"无威胁敌"结构性不存在);③ 现行表值下零行为变更(棋盘直伤贴底值 2−1=1 本就在闸内),本批=结构保证+调参防误配;④ 判读口径/约束表/调参表/验收四处措辞同步;冒烟 352→355 项 0 失败(+贴底/穿透/空桶三断言)。版本号注记:v0.19 在伏击上限删除批(未合并分支)中已被占用,本条与之合并时以先入库者为准顺延避让 |
|
||||
| v0.20 | 2026-09-20 | **伏击单轮上限删除批(用户拍板——与 敌人系统 / 地图战斗资源 / 难度曲线与Boss / registry / 切片代码同批)**:① 行型协议 10 类→9 类——溢出未生效行下线(唯一发射源 = 伏击上限截流,上限删除后零发射面);② 授予段伏击加层改直授无上限(反灾难护栏退役——一轮踩雷数由行动点预算天然封顶);③ 核验清单伏击守恒条改伏击池共享;④ 切片同批:enemy.tres 12 行字段删除、敌表校验/编排器截流/单位容器 F3 计划函数/日志视图 overflow 格式化删除、冒烟 blast 负向断言改直授累加(330 项 0 失败) |
|
||||
| v0.21 | 2026-09-20 | **格面资源八型批(用户拍板——与 敌人系统 / 地图战斗资源 / 行动经济 / registry / 切片代码同批)**:① 三乘法链与敌方技能攻击公式删伏击附加项及其"后置加法不进乘区"解释短语(rider 保留);② 授予段兑付表 blast 负向换装警觉加层(enemy_alert → alert 行)+ 新增 action 型行动点修正行(queue_ap_delta 排队、下一轮开始兑现、下限 0、明细记 effect_id=ap_delta);③ EV flat 类枚举伏击→行动点;④ 呈现快照两处伏击层数拆除(警觉并入敌方增益 effects 投影);⑤ 棋盘来源必中枚举去伏击(两处);⑥ 核验清单伏击池共享改警觉共享 |
|
||||
| v0.22 | 2026-09-19 | **充能退役批(版本号避让注记:原登 v0.16 与甲效矩阵加法核换装批撞号——2026-09-20 R10 版本号唯一性规则上线发现,后落籍者顺延;用户拍板,与切片代码 / registry / 07 清单 / README 同批)**:主角攻击三分量模型(普通 + 穿刺/魔法充能)整体退役,回归单分量——量 = 攻击基线、类型 = 主角表 attack_type;挖格批/旗判定批的充能计数条款删除、充能供给表与 charge_grants 调参行删除、乘区公式与粒度口径改"攻击合计";退役理由 = 克制策略归冒险前配置(营地换型/未来冒险前参数面),局内不再有挖掘攒弹药的第二伤害供给;保留面 = 攻击类型属性轴与棋盘奖励触发源的抽象分离、奖励直伤道具(穿刺弹/魔法矢)的克制直伤消费不变。切片同批:battle_orchestrator 攻击段单分量化 + _charge_points/_charge_counts/round_facts 充能键删除、DamageMath.charge_component → counter_component 改名(奖励直伤唯一消费方)、settlement.tres charge_grants 键与 schema 校验删除、冒烟充能断言组退役改形(乘区接线单分量基线 100、标中正向兑付行断言、恢复点探针换种子 42)、冒烟 293 项 0 失败 |
|
||||
| v0.22 | 2026-09-19 | **充能退役批(版本号避让注记:原登 v0.16 与甲效矩阵加法核换装批撞号——2026-09-20 R10 版本号唯一性规则上线发现,后入库者顺延;用户拍板,与切片代码 / registry / 07 清单 / README 同批)**:主角攻击三分量模型(普通 + 穿刺/魔法充能)整体退役,回归单分量——量 = 攻击基线、类型 = 主角表 attack_type;挖格批/旗判定批的充能计数条款删除、充能供给表与 charge_grants 调参行删除、乘区公式与粒度口径改"攻击合计";退役理由 = 克制策略归冒险前配置(营地换型/未来冒险前参数面),局内不再有挖掘攒弹药的第二伤害供给;保留面 = 攻击类型属性轴与棋盘奖励触发源的抽象分离、奖励直伤道具(穿刺弹/魔法矢)的克制直伤消费不变。切片同批:battle_orchestrator 攻击段单分量化 + _charge_points/_charge_counts/round_facts 充能键删除、DamageMath.charge_component → counter_component 改名(奖励直伤唯一消费方)、settlement.tres charge_grants 键与 schema 校验删除、冒烟充能断言组退役改形(乘区接线单分量基线 100、标中正向兑付行断言、恢复点探针换种子 42)、冒烟 293 项 0 失败 |
|
||||
| v0.23 | 2026-09-20 | **GP+商店房批(用户拍板——与 关卡节点地图 v1.1 / 冒险结构 v0.5 / 地图战斗资源 v0.15 / 难度曲线与Boss v0.18 / registry / 切片代码同批;版本号注记:v0.22 已被充能退役批占用,表尾顺延)**:① 呈现只读面表 battle_finished 载荷 +gp_dropped(掉落掷定 + 关级加值 + 战斗内缓冲的合计——字段增删走本文修订条款兑现);② 授予段兑付形态表新增 GP 缓冲行:gp 正/负向(金币袋 / 破财——九型批)兑付 = 战斗内 GP 缓冲 ±power,战斗完成统一上抛入钱包账本(账本归冒险结构),战斗域零钱包状态;③ 随机口径六处→七处:战斗结束掉落掷定消费 `gp_drop` 封闭流(出口随机、步骤流之外);九型字典措辞与验收标准可回放条目同步 |
|
||||
| v0.24 | 2026-09-24 | **伤害管线单据化批(用户三裁决——与切片代码同批,06 台账 148)**:新增「伤害单据与伤害控制器」一节——伤害对象抽象补全:五族伤害来源收口伤害控制器单点管线、兑付配方封闭五种;三裁决落文——①结账时机双模式(现行 = 段界结账:授予段尾 / 清图批同步点 / 战斗段尾;开单即结保留为回切结构位,切换走代码不走调参)②目标结账时刻照规则解析③死亡事件由单位自行宣布(怪死其未结单据作废、主角死兑付终止);授予段兑付与战斗段两节补结账时点句;验收标准 +伤害单据管线条目。切片同批:`core/damage_controller.gd` 新建(单据构造/开单/结账/死亡事件消费/管线算术收口)、battle_orchestrator 六调用点改开单、掷点/折扣/克制/池乘/攻击行文本助手迁出(`_defender_ac`/`_clamped_pool` 留薄委托)、unit_container 增 `unit_died` 信号;冒烟 557 项 0 失败双模式全绿 + A/B 对拍四配置全确定且真实分岔(行数恒等、纯次序位移);历史基线读数自本批起以段界结账口径为准(重测归曲线调参批) |
|
||||
| v0.25 | 2026-10-05 | **挖掘风险不等式判式换代(迭代14②号卡 T3/T4——与行动经济/难度曲线与Boss/registry 同批)**:①收益对照表补 gp/ap 当量口径注记(gp=flat power 代理 3/2 假设 A5 口径空白登记、ap=flat 表值 1 机会成本口径仅登记假设 A6,精确口径归商店批复核);②验收标准 +条款3 对账条(聚合健康式+β 带逐 u 检算 / 旗溢价兑付三形态覆盖·标空与挖格不乘·同池零触碰);③T4 机制载体 = settlement.tres 新键 flag_hit_premium=125(percent 域 provisional)——标中旗正向兑付 ×(1+δ),整数四舍五入取整与伤害管线 floor 分域(registry 随批登记);DamageController 零改、危险格与安全格同池冻结不动、直伤雷 6/8/8 与 p_perfect 不动 |
|
||||
|
||||
@@ -106,7 +106,7 @@
|
||||
|
||||
**关联与边界**:结算顺序与结果归[战斗结算](战斗结算.md)(本节零触碰,逻辑先行、演出后行);减动效开关归[设置与本地化](../表现与支撑/设置与本地化.md);节奏常量以代码为事实源(上列三常量),本文登记现行值与沿革,表值化随演出批再议;fx_probe 轮横幅发射计数为验收断言面。
|
||||
|
||||
**状态**:已实装(2026-09-29 迭代 8 卡⑦落籍、三轮修改批调参追认;pacing_queue_test 第 15 套在册)。本节是本文第一块已落地内容,其余部分维持范围草案。
|
||||
**状态**:已实装(2026-09-29 迭代 8 卡⑦已入库、三轮修改批调参追认;pacing_queue_test 第 15 套在册)。本节是本文第一块已落地内容,其余部分维持范围草案。
|
||||
|
||||
## 依赖与输出
|
||||
|
||||
@@ -168,5 +168,5 @@ MVP 不要求本文的闭环:不做清单把战斗动画演出列为 MVP 打
|
||||
| v0.2 | 2026-09-16 | 新增「一屏样张的验收标准」:内容清单、五项按序判定与判定回退成文,四件锁定物(角色剪影/动画方案/战斗空间/敌层插入位置)的过判口径落到已冻结口径上(06 清单「样张验收标准未成文」闭合);依赖与输出表"五区"改"四区"随 UI 收口批同步 |
|
||||
| v0.3 | 2026-09-16 | **敌人技能池批(与敌人系统 / 战斗结算 / HUD框架 / registry / 切片代码同批)**:上游呈现输入清单「敌种姿态资产定稿」行改型——行为环姿态预告(一态与三态)随行为环退役,改「特殊技技能动画定稿」(普通攻击零表示、特殊技攻/防系两型动画映射,暴击掷点层无前置表示);摇定动画位呈现语义 = 开轮摇定即可见、纯类型级提醒(池与权重不公开),样张验收联动口径不变 |
|
||||
| v0.4 | 2026-09-20 | **敌人卡形态裁决收口批(与 battle.md / HUD框架 / 06 清单同批,台账 99)**:敌人呈现形态拍板全站桩式(无框立绘+底座,主角同站桩、状态小图标挂血条下,卡片式退役)——「前置美术测试是硬前置」节相邻裁定句改裁决已下;样张内容清单「敌人卡两候选形态对照」项划线解除(正式样张按站桩形态单版出样,owner 修订);判定与回退节第 5 项拆出形态对照半边(已收口);敌人层插入位置裁决义务保留随样张批 |
|
||||
| v0.5 | 2026-09-30 | **拍板点 3 收口批(GDD 概念覆盖审计——用户裁甲:演出正主节落位)**:新增「结算演出与轮间节奏」节(五要素:定义/作用对象与范围/生命周期/关联与边界/状态)——结算演出覆盖层(迭代 6)与轮间结算节奏化(迭代 8 卡⑦:段间 0.3s/段内 0.22s/轮横幅 0.6s+减动效双态)的呈现规则自 06 已收口条目与代码注释收编入正主;段内常量按代码实态 0.22s 登记(06 条目旧记 0.06s 系三轮修改批前值);常量以代码为事实源。孤儿 1(演出 spec 零承载)随本节解除 |
|
||||
| v0.5 | 2026-09-30 | **拍板点 3 收口批(GDD 概念覆盖审计——用户裁甲:演出权威定义节落位)**:新增「结算演出与轮间节奏」节(五要素:定义/作用对象与范围/生命周期/关联与边界/状态)——结算演出覆盖层(迭代 6)与轮间结算节奏化(迭代 8 卡⑦:段间 0.3s/段内 0.22s/轮横幅 0.6s+减动效双态)的呈现规则自 06 已收口条目与代码注释收编入现行事实源;段内常量按代码实态 0.22s 登记(06 条目旧记 0.06s 系三轮修改批前值);常量以代码为事实源。孤儿 1(演出 spec 零承载)随本节解除 |
|
||||
| v0.6 | 2026-10-09 | **文档正确性审查批(用户令——状态记录与证据对齐)**:①输入清单「特殊技攻/防系两型动画」订正——2026-09-19 新效应词汇批已扩三族(攻击系/增益系/妨害系,敌人系统意图呈现节);②P1「溢出行呈现」改「奖励未生效行呈现」(溢出未生效行型已随 2026-09-20 伏击上限删除批下线,与输入清单行措辞对齐)。 |
|
||||
@@ -271,7 +271,7 @@
|
||||
| v0.6 | 2026-10-01 | **失同步清偿 + 跨冒险行动点加成轴节(迭代 10 奖励重构批——与冒险结构 / registry 同批)**:①失同步欠账清偿——ap_per_round 真实配置 = **8**(action_economy.tres,Package B 2026-09-22 批 6→8 回调,表内批注在案);v0.2 批 8→6 系最后一次文档面记录,此后配置面单独回调未回写本文,本批补记(rap_refresh_cost 与 ap_per_round 的「满预算停手 = 恰好一刷」节拍耦合以现行 8/8 维持);②新增「跨冒险行动点加成轴」节——统一冒险加算区扩第四轴(行动点),经战斗开始入参覆盖值通道、只在每场战斗开轮首轮兑现一次;价值锚 = 冒险表 bonus_ap_flat / bonus_cap_ap(迭代 10 三选一 AP 件,全冒险 2 次上限),调参表补跨表行 |
|
||||
| v0.7 | 2026-10-03 | **两 AP 件兑现通道注记(迭代 11 第①批同调实施批——需求卡片 §十连带)**:同调目录两 AP 件兑现通道落位——①工兵晨令(被动·限时)=战斗开始首轮 queue_ap_delta 入队 + 轮始段续队(前 effective_rounds 轮每轮 +1,表值化 P4 甲),复用「跨冒险行动点加成轴」同族排队通道;②掘进蓄能(主动·充能)=grant_ap 当轮加量(同挖掘期 ap_grant 通道),受理闸=战斗域安全开格积点(charge_n 格/点);账本零新机制(queue_ap_delta/grant_ap 两既有原语),充能扣减经共享账本(attune_charges)同引用直改 |
|
||||
| v0.8 | 2026-10-05 | **挖掘风险不等式判式换代(迭代14②号卡 T3——与战斗结算/难度曲线与Boss/registry 同批)**:F1 条款3 重立——三层口径并行立(条款2 标中旗锚不动/条款3 聚合健康式「(1−ρ̂)E_dig−ρ̂V_mine≥0」只留下限 0/旗边际引理+条件二旗溢价「E[标中兑付]≥(1+δ)·E_dig」δ=0.25 provisional 形态 a 兑付溢价);条件二落文按登记已知破·T4 机制闭合;β 比值带 [1.2,2.5] 判读入文(u=3 登记态微破下限);η 降格读数入文(分母=全部插旗数);推导节变量表换代(E_dig/V_mine/ρ̂/β/δ 五锚);旧界形式与「惩罚当量对账模型归调参批重立」挂账句全部清偿 |
|
||||
| v0.9 | 2026-10-07 | **生命周期轴裁决随批(框架正主=核心循环「生命周期轴」节同批落文)**:「每轮预算与价目」节首补 AP 两账定义段——AP 上限=冒险级角色属性(开局基值+冒险中秘宝/属性提升抬高,兑现细则归「跨冒险行动点加成轴」节)、当前 AP=回合级池(每轮灌满、归零收轮,本账本只管后者);既有规则面零改动 |
|
||||
| v0.9 | 2026-10-07 | **生命周期轴裁决随批(框架现行事实源=核心循环「生命周期轴」节同批落文)**:「每轮预算与价目」节首补 AP 两账定义段——AP 上限=冒险级角色属性(开局基值+冒险中秘宝/属性提升抬高,兑现细则归「跨冒险行动点加成轴」节)、当前 AP=回合级池(每轮灌满、归零收轮,本账本只管后者);既有规则面零改动 |
|
||||
| v0.10 | 2026-10-09 | 文档正确性审查批:巢穴约束表「资格认危险格实例」行重复短语清除(「堵死重复计费重插刷收益的农场」一句两写删一) |
|
||||
| v0.11 | 2026-10-09 | 文档正确性审查批·独立复核(worktree docaudit-2026-10-09):依赖与输出表排雷玩法行「挖/插/**拔**的调用方」退役动作残留清除——拔旗已随插旗不可逆批(2026-09-19)退役,v0.4 批六处删「拔旗」时本处漏网 |
|
||||
| v0.0 | 2026-10-11 | 术语统一补扫批(2026-10-11):「巢穴」机制表述两处换代危险格 |
|
||||
@@ -129,7 +129,7 @@ HUD框架站在玩家与全部玩法系统之间:挖掘期它是输入的翻
|
||||
|
||||
### 未开格类型微光:相邻未开格的类型先读通道
|
||||
|
||||
> 本节是「未开格类型微光」在全项目的唯一正主定义(2026-09-30 用户裁决落位):其他文档引用这个概念只许指路本节,不许复述口径。定义一句话:**英雄周围 8 格内的未开格,在格面上显示该格资源类型的微光**——玩家由此读到「相邻哪些格大概是什么类型的收益」,但读不出这格是安全格还是雷。
|
||||
> 本节是「未开格类型微光」在全项目的唯一权威定义(2026-09-30 用户裁决落位):其他文档引用这个概念只许指路本节,不许复述口径。定义一句话:**英雄周围 8 格内的未开格,在格面上显示该格资源类型的微光**——玩家由此读到「相邻哪些格大概是什么类型的收益」,但读不出这格是安全格还是雷。
|
||||
|
||||
| 要素 | 口径 |
|
||||
|---|---|
|
||||
@@ -139,11 +139,11 @@ HUD框架站在玩家与全部玩法系统之间:挖掘期它是输入的翻
|
||||
| 关联与边界 | 信息本体(格面资源身份)归[地图战斗资源](../战斗循环/地图战斗资源.md);棋盘格态与动作合法性归[排雷玩法](../排雷循环/排雷玩法.md);与「接触带微光」同圈不同职责——接触带微光=可挖域的交互反馈光(「这里能挖」),类型微光=相邻格的类型先读(「这格是什么类型」) |
|
||||
| 实装状态 | 呈现契约已定稿(五组色相经样张 v2 冻结 2026-09-28);**游戏内待实施批**(2026-09-30 核证:呈现层仅接触带微光在跑,类型微光无独立实现;实施状态挂 06-待办清单「未开格类型徽章呈现时机」条) |
|
||||
|
||||
口径史注记(防复发):本概念曾只活在 06-待办清单登记与 art-bible 复述里,「常显」「全部未开格」等无范围表述于 2026-09-30 酿成理解事故;用户裁决「英雄周围 8 格」为正确口径并落位本节。教训=概念必须落地正主文档,零散复述不是定义。
|
||||
口径史注记(防复发):本概念曾只活在 06-待办清单登记与 art-bible 复述里,「常显」「全部未开格」等无范围表述于 2026-09-30 酿成理解事故;用户裁决「英雄周围 8 格」为正确口径并落位本节。教训=概念必须落地权威文档,零散复述不是定义。
|
||||
|
||||
### 可挖域指示(接触带微光):「这里能挖」的交互反馈光
|
||||
|
||||
> 本节是「接触带微光」(可挖域交互反馈光)的呈现规则正主(2026-09-30 用户裁决落位——目录职责三分工:概念/玩法内容归 GDD、美术风格指导归 art-bible、UI 设计归 UX;各目录只干职责内的事,引用走文档链接,不贴异域内容)。
|
||||
> 本节是「接触带微光」(可挖域交互反馈光)的呈现规则现行事实源(2026-09-30 用户裁决落位——目录职责三分工:概念/玩法内容归 GDD、美术风格指导归 art-bible、UI 设计归 UX;各目录只干职责内的事,引用走文档链接,不贴异域内容)。
|
||||
|
||||
| 要素 | 口径 |
|
||||
|---|---|
|
||||
@@ -155,18 +155,18 @@ HUD框架站在玩家与全部玩法系统之间:挖掘期它是输入的翻
|
||||
|
||||
### 视野迷雾:菱形灯光区与黑暗边界
|
||||
|
||||
> 本节是「视野迷雾」在全项目的唯一正主定义(2026-09-30 用户拍板立项):其他文档引用只许指路本节。定义一句话:**棋盘只完整渲染以角色为中心的菱形灯光区,区外一切呈迷雾黑暗,移动角色才逐步照亮**——像在洞穴里举灯探索。与已退役的「雾格」无关:雾格是格面机制(2026-09-15 退役),视野迷雾是纯呈现层机制,不改任何游戏数据。
|
||||
> 本节是「视野迷雾」在全项目的唯一权威定义(2026-09-30 用户拍板立项):其他文档引用只许指路本节。定义一句话:**棋盘只完整渲染以角色为中心的菱形灯光区,区外一切呈迷雾黑暗,移动角色才逐步照亮**——像在洞穴里举灯探索。与已退役的「雾格」无关:雾格是格面机制(2026-09-15 退役),视野迷雾是纯呈现层机制,不改任何游戏数据。
|
||||
|
||||
| 要素 | 口径 |
|
||||
|---|---|
|
||||
| 作用对象与范围 | 棋盘渲染可见性:灯光区内照常渲染;区外**已开格=暗淡记忆态**(灰显可见、数字可读——2026-09-30 拍板),区外**未开格=全黑不渲染** |
|
||||
| 生命周期 | 随角色位置实时变化;战斗内持续;换图按新板重置;已开/未开格态、数字真值、清图判定零影响(纯呈现遮罩——同板同动作序列的结算结果与无迷雾逐位一致) |
|
||||
| 关联与边界 | 与「未开格类型微光」同边界——灯光区起步半径=微光环 8 格(同圈起步,实测后可调);格态数据归[排雷玩法](../排雷循环/排雷玩法.md);黑暗区域渲染规格(暗淡态明度、迷雾过渡)归 [art-bible](../../../art/art-bible.md) 修订随实施批;初始展开收窄不在本案(后置与 Alpha 差异化批窗口合并再议) |
|
||||
| 实装状态 | **已实装**(2026-10-03 迭代 11 第④批落籍;四裁决逐条对账与验收线转正见本节末「实施状态」注记;渲染规格 = [art-bible](../../../art/art-bible.md) §6.5) |
|
||||
| 实装状态 | **已实装**(2026-10-03 迭代 11 第④批已入库;四裁决逐条对账与验收线转正见本节末「实施状态」注记;渲染规格 = [art-bible](../../../art/art-bible.md) §6.5) |
|
||||
|
||||
配套拍板(同日):魔法提灯=灯甲形态(光照圈外扩 +2 格,flat 整数档)随迷雾立项;**类型微光不随视野扩大**(类型先读仍只贴身 8 格,微光锚=可挖域);提灯载体归 aux_items 新行(登记原文——2026-10-07 用户令改道为独立卡,2026-10-08 裁案A=秘宝·同调位新行落位,见下方实施状态注记;**2026-10-09 用户裁退役**——新目录 15 件未收提灯,fog_lantern 数据行与卡④接线拆除归退役删行批〔实装批〕,功能由新目录普通档「阔视野带」承接,06 登记条在册),呈现面挂「资产升档重产批」(挂账不动)。
|
||||
|
||||
**实施状态(2026-10-03 迭代 11 第④批落籍)**:迷雾遮蔽+菱形灯光区跟随+暗淡记忆态上线,探针断言随批扩(ui_input_probe case⑮)。四裁决逐条对账——①案甲视野迷雾立项(纯呈现层):迷雾开关分层验证可用(呈现态布尔,off 态=无迷雾基线),同板同动作序列与 MC 对拍逐位一致;②暗淡记忆态:区外已开格灰显+数字可读,明度按 [art-bible](../../../art/art-bible.md) §6.5 落文值(记忆板 #3A3A3A/记忆墨 #C4C4C4,provisional);③灯光半径=微光环 8 格同圈:LIGHT_RADIUS=8 参数化(曼哈顿菱形,常量);④提灯 +2、微光不扩:FOG_LANTERN_BONUS=+2(落码常量实名——本条旧记 LIGHT_RADIUS_LANTERN_BONUS 系文档侧拟名,随卡④落籍对齐),类型微光仍贴身 8 邻格零改动。**〔2026-10-05 迭代14⑤接线注记〕公共接线面已就位**——`board_view.set_fog_lantern(enabled)`(true=半径 8+2、false=复原 0;写入即 refresh 重算雾态),半径算式消费 `_fog_lantern` 迷雾批已在位;ui_input_probe case⑮ 增接线断言(开=dist 9 格转可见+lantern=2/关=复原)。**〔2026-10-08 迭代 19 卡④落籍注记〕载体到位+接线闭环=功能可达**——载体=秘宝·同调位新行 `fog_lantern`「魔法提灯」(treasure_items.tres 表尾追加,desc「灯光区半径+2」,slot_cost 1、营地秘宝匣同调装配获渠,行字段=用户「按推荐」全收);生产路径=runner set_attunement→enc.attunement→begin_battle 注入 orchestrator 装配集→公共只读出口 `attune_has`→组合根呈现桥 `main._sync_fog_lantern` 每战首轮装配链**显式重算含否**(🔴 复原语义=禁战斗结束隐式复原——卸装/未装配写 0,断点续玩/跨关天然正确);未装配=false 写 0=缺省零扰动基线逐位不变。测试随批:case⑮ 载体级段(装配→lantern=2+dist R+1 转可见+卸装复原)+smoke 行字段/同调目录投影(九件→十件)/装配贯通断言+存档回归 Part 6+单测 fog_lantern_wiring(run_all 17→18 套)。原「提灯载体归 aux_items 新行随 Alpha 信息件重定批」登记去向就此销账(改道留痕=需求卡片-提灯载体道具批-2026-10-07 §一)。验收线(本篇「验收标准」视野迷雾行)逐条转正式验收:区内完整渲染/区外已开格灰显可读/区外未开格不可见/灯光区随移动跟随/两态结算逐位一致;实机目检人闸(迷雾观感/记忆态可读性/移动跟随流畅度)随出口闸。黑暗区域渲染规格承载 = art-bible §6.5(v3.5)。
|
||||
**实施状态(2026-10-03 迭代 11 第④批已入库)**:迷雾遮蔽+菱形灯光区跟随+暗淡记忆态上线,探针断言随批扩(ui_input_probe case⑮)。四裁决逐条对账——①案甲视野迷雾立项(纯呈现层):迷雾开关分层验证可用(呈现态布尔,off 态=无迷雾基线),同板同动作序列与 MC 对拍逐位一致;②暗淡记忆态:区外已开格灰显+数字可读,明度按 [art-bible](../../../art/art-bible.md) §6.5 落文值(记忆板 #3A3A3A/记忆墨 #C4C4C4,provisional);③灯光半径=微光环 8 格同圈:LIGHT_RADIUS=8 参数化(曼哈顿菱形,常量);④提灯 +2、微光不扩:FOG_LANTERN_BONUS=+2(落码常量实名——本条旧记 LIGHT_RADIUS_LANTERN_BONUS 系文档侧拟名,随卡④入库对齐),类型微光仍贴身 8 邻格零改动。**〔2026-10-05 迭代14⑤接线注记〕公共接线面已就位**——`board_view.set_fog_lantern(enabled)`(true=半径 8+2、false=复原 0;写入即 refresh 重算雾态),半径算式消费 `_fog_lantern` 迷雾批已在位;ui_input_probe case⑮ 增接线断言(开=dist 9 格转可见+lantern=2/关=复原)。**〔2026-10-08 迭代 19 卡④入库注记〕载体到位+接线闭环=功能可达**——载体=秘宝·同调位新行 `fog_lantern`「魔法提灯」(treasure_items.tres 表尾追加,desc「灯光区半径+2」,slot_cost 1、营地秘宝匣同调装配获渠,行字段=用户「按推荐」全收);生产路径=runner set_attunement→enc.attunement→begin_battle 注入 orchestrator 装配集→公共只读出口 `attune_has`→组合根呈现桥 `main._sync_fog_lantern` 每战首轮装配链**显式重算含否**(🔴 复原语义=禁战斗结束隐式复原——卸装/未装配写 0,断点续玩/跨关天然正确);未装配=false 写 0=缺省零扰动基线逐位不变。测试随批:case⑮ 载体级段(装配→lantern=2+dist R+1 转可见+卸装复原)+smoke 行字段/同调目录投影(九件→十件)/装配贯通断言+存档回归 Part 6+单测 fog_lantern_wiring(run_all 17→18 套)。原「提灯载体归 aux_items 新行随 Alpha 信息件重定批」登记去向就此销账(改道留痕=需求卡片-提灯载体道具批-2026-10-07 §一)。验收线(本篇「验收标准」视野迷雾行)逐条转正式验收:区内完整渲染/区外已开格灰显可读/区外未开格不可见/灯光区随移动跟随/两态结算逐位一致;实机目检人闸(迷雾观感/记忆态可读性/移动跟随流畅度)随出口闸。黑暗区域渲染规格承载 = art-bible §6.5(v3.5)。
|
||||
|
||||
### 可访问性基线:看得清、不闪、纯鼠标玩得通
|
||||
|
||||
@@ -215,7 +215,7 @@ HUD框架站在玩家与全部玩法系统之间:挖掘期它是输入的翻
|
||||
| [地图战斗资源](../战斗循环/地图战斗资源.md) | 已开格的奖励身份常读;未开格类型微光(英雄周围 8 格内的未开格显示资源类型——概念定义见本篇「未开格类型微光」节) |
|
||||
| [秘宝](../跨局循环/秘宝.md) | 装配件与充能常读;使用交互与目标拾取;整图叠加层信息呈现(在役旧框架——随实装批整体替换,秘宝.md v1.7 同款口径) |
|
||||
| [棋盘生成](../排雷循环/棋盘生成.md) | 零合法板的诚实告知(数据面经战斗结算上抛,本系统只管提示形态) |
|
||||
| [地形变异](../排雷循环/地形变异.md) | 全局作用域型三层预告(2026-10-04 首发批——语义正主=地形变异 §全局作用域型):①开战横幅一行(整图变异非空时显示;减动效=静态驻留,轮横幅先例同款双态)②HUD 常驻角标(C 区战斗全程可见防中局遗忘,空态整节隐藏=奇物段先例;摆位 provisional)③帮助手册一行(零交互教学,承载=玩法帮助文案块);数据面经呈现快照 board_variants 投影(核心→呈现唯一读取面),普通图三层恒空态零打扰 |
|
||||
| [地形变异](../排雷循环/地形变异.md) | 全局作用域型三层预告(2026-10-04 首发批——语义现行事实源=地形变异 §全局作用域型):①开战横幅一行(整图变异非空时显示;减动效=静态驻留,轮横幅先例同款双态)②HUD 常驻角标(C 区战斗全程可见防中局遗忘,空态整节隐藏=奇物段先例;摆位 provisional)③帮助手册一行(零交互教学,承载=玩法帮助文案块);数据面经呈现快照 board_variants 投影(核心→呈现唯一读取面),普通图三层恒空态零打扰 |
|
||||
|
||||
## P0 最小闭环
|
||||
|
||||
@@ -275,7 +275,7 @@ HUD框架站在玩家与全部玩法系统之间:挖掘期它是输入的翻
|
||||
- 任一模态层打开时遮挡物隐藏或输入锁定、关闭逐层恢复;tooltip 与明细行等动态区固定槽高、换行裁剪不推挤布局。
|
||||
- 终局呈现只消费流水与快照:核心对象销毁后呈现层对生命周期状态零回读;终局后重放渲染与实时渲染一致。
|
||||
- 消费的每份载荷逐字段断言通过(缺字段、多字段都算失败)。
|
||||
- 地形变异三层预告(2026-10-04 全局作用域变异首发批——规则正主=地形变异 §全局作用域型):Boss 图开战横幅一行显示且普通图不显示;C 区常驻角标战斗全程可见、空态整节隐藏;帮助手册含整图变异说明行;减动效开启横幅走静态驻留(轮横幅同款双态);普通图三层零打扰(恒空态)。
|
||||
- 地形变异三层预告(2026-10-04 全局作用域变异首发批——规则现行事实源=地形变异 §全局作用域型):Boss 图开战横幅一行显示且普通图不显示;C 区常驻角标战斗全程可见、空态整节隐藏;帮助手册含整图变异说明行;减动效开启横幅走静态驻留(轮横幅同款双态);普通图三层零打扰(恒空态)。
|
||||
- 字号下限成立;无每秒超三次闪烁;减动效开启时时长减半或跳终态(结算兑现降速不跳过);全程纯鼠标可玩;中文渲染无缺字。
|
||||
- 呈现层零随机调用;切片临时名零残留。
|
||||
|
||||
@@ -298,9 +298,9 @@ HUD框架站在玩家与全部玩法系统之间:挖掘期它是输入的翻
|
||||
| v0.9 | 2026-09-23 | 渲染技术注记(棋盘 Node2D 迁移批 Phase A,代码实装同批;上位裁决 ADR-0006):棋盘本体 Node2D 化——BoardView 内部由 GridContainer+逐格控件改为 Control 壳 + SubViewport + Node2D 世界,类名/信号/公共方法契约不变、探针零改造;三区布局与性能预算(同屏 draw calls < 200)不变;程序化占位视觉等价平移,素材终稿按 art-bible §8.2 格面 32×32 暂定档槽位 1:1 换入 |
|
||||
| v0.10 | 2026-09-26 | 渲染技术注记(战斗舞台 Node2D 迁移批 Phase B,代码实装同批;上位裁决 ADR-0006):B 区战斗舞台 Node2D 化——BattleStageView 内部由 PanelContainer+Control 站桩改为 Control 壳 + SubViewportContainer + SubViewport + Node2D 世界(StageWorld/StandeeBody),类名/setter 面/公共方法契约不变、调用点零改造;状态图标行与悬停 tooltip 保留 Control 载体挂壳层(伴随件);C6 字体注入挂点复用(set_world_font);三区布局与性能预算(同屏 draw calls < 200)不变;占位表现等价平移(时序常量逐字对照——等价证明=git 提交 7f24b64,文件已按生命周期条款退役) |
|
||||
| v0.11 | 2026-09-27 | 关卡画面 UX spec 建档([level-map](../../ux/level-map.md),关卡画面 UX 批——用户拍板立项):义务清单「关卡节点地图」行挂屏级 spec 指针;屏级权威行与不负责表改按屏分治口径(战斗屏 = battle.md / 关卡画面 = level-map.md)。文档面零机制改动 |
|
||||
| v0.12 | 2026-09-30 | **未开格类型微光概念收口批(用户裁决落位)**:新增「未开格类型微光」节=全项目唯一正主定义(五要素——作用对象=英雄周围 8 格内的未开格〔与可挖域同圈〕/信息内容=只类型不泄危险格与安全格/生命周期=入圈亮出圈灭开格灭/关联边界/实装状态=契约定稿〔样张 v2〕游戏内待实施批);核心规则章六节改七节;呈现义务来源清单「地图战斗资源」行补微光指路;验收标准补微光呈现线。背景:该概念此前只活在 06 登记与 art-bible 复述,「常显/全部未开格」无范围表述酿成理解事故(2026-09-30 用户纠正口径),本批落位正主、他文只许指路 |
|
||||
| v0.13 | 2026-10-04 | **地形变异三层预告义务批(全局作用域变异首发批——迭代 14 ③号卡,代码同批)**:呈现义务来源清单补「地形变异」行(开战横幅一行〔减动效=静态驻留,轮横幅先例同款双态〕+ C 区常驻角标〔空态整节隐藏=奇物段先例,摆位 provisional〕+ 帮助手册一行〔零交互教学〕);验收标准补三层预告线(普通图恒空态零打扰);数据面走呈现快照 board_variants 投影(核心→呈现唯一读取面)。语义正主=地形变异.md §全局作用域型,本文只锁呈现承载 |
|
||||
| v0.14 | 2026-10-03 | **视野迷雾实施批落籍注记(迭代 11 第④批)**:迷雾节补「实施状态」注记(四裁决逐条对账:纯呈现两态逐位一致/暗淡记忆态灰显可读/LIGHT_RADIUS=8 参数化〔提灯 +2 插值位预留未接〕/类型微光仍贴身 8 邻格);实装状态行「待实施批」改「已实装」;验收标准迷雾行去「待实施批落地后验收」括注转正式验收。机制定义零改动(定义一句话/作用范围/生命周期/关联边界/配套拍板全段原样);黑暗区域渲染规格落 art-bible §6.5(v3.5) |
|
||||
| v0.13 | 2026-09-30 | **视野迷雾概念落位批(用户拍板立项)**:新增「视野迷雾」节=正主定义(菱形灯光区+黑暗边界;区外已开格=暗淡记忆态灰显可读、区外未开格=全黑;灯光半径起步=微光环 8 格同圈;纯呈现层,与已退役雾格无关);验收标准补迷雾线;配套拍板随节登记(魔法提灯灯甲外扩 +2 格、类型微光不随视野扩、初始展开收窄后置 Alpha 差异化批)。实施待主线编卡 |
|
||||
| v0.12 | 2026-09-30 | **未开格类型微光概念收口批(用户裁决落位)**:新增「未开格类型微光」节=全项目唯一权威定义(五要素——作用对象=英雄周围 8 格内的未开格〔与可挖域同圈〕/信息内容=只类型不泄危险格与安全格/生命周期=入圈亮出圈灭开格灭/关联边界/实装状态=契约定稿〔样张 v2〕游戏内待实施批);核心规则章六节改七节;呈现义务来源清单「地图战斗资源」行补微光指路;验收标准补微光呈现线。背景:该概念此前只活在 06 登记与 art-bible 复述,「常显/全部未开格」无范围表述酿成理解事故(2026-09-30 用户纠正口径),本批落位权威文档、他文只许指路 |
|
||||
| v0.13 | 2026-10-04 | **地形变异三层预告义务批(全局作用域变异首发批——迭代 14 ③号卡,代码同批)**:呈现义务来源清单补「地形变异」行(开战横幅一行〔减动效=静态驻留,轮横幅先例同款双态〕+ C 区常驻角标〔空态整节隐藏=奇物段先例,摆位 provisional〕+ 帮助手册一行〔零交互教学〕);验收标准补三层预告线(普通图恒空态零打扰);数据面走呈现快照 board_variants 投影(核心→呈现唯一读取面)。语义现行事实源=地形变异.md §全局作用域型,本文只锁呈现承载 |
|
||||
| v0.14 | 2026-10-03 | **视野迷雾实施批入库注记(迭代 11 第④批)**:迷雾节补「实施状态」注记(四裁决逐条对账:纯呈现两态逐位一致/暗淡记忆态灰显可读/LIGHT_RADIUS=8 参数化〔提灯 +2 插值位预留未接〕/类型微光仍贴身 8 邻格);实装状态行「待实施批」改「已实装」;验收标准迷雾行去「待实施批落地后验收」括注转正式验收。机制定义零改动(定义一句话/作用范围/生命周期/关联边界/配套拍板全段原样);黑暗区域渲染规格落 art-bible §6.5(v3.5) |
|
||||
| v0.13 | 2026-09-30 | **视野迷雾概念落位批(用户拍板立项)**:新增「视野迷雾」节=权威定义(菱形灯光区+黑暗边界;区外已开格=暗淡记忆态灰显可读、区外未开格=全黑;灯光半径起步=微光环 8 格同圈;纯呈现层,与已退役雾格无关);验收标准补迷雾线;配套拍板随节登记(魔法提灯灯甲外扩 +2 格、类型微光不随视野扩、初始展开收窄后置 Alpha 差异化批)。实施待主线编卡 |
|
||||
| v0.15 | 2026-10-09 | **文档正确性审查批·独立复核(worktree docaudit-2026-10-09)**:①视野迷雾配套拍板段补魔法提灯退役注(2026-10-09 用户裁——fog_lantern 数据行与卡④接线拆除归退役删行批,功能由新目录「阔视野带」承接,06 登记条在册);②呈现义务清单秘宝行「库存条常读」改「装配件与充能常读」(同调形态无库存条——与秘宝.md v1.7 依赖表对齐)+补在役旧框架注;③P0 闭环第 6 步与验收「终局」条的关卡末清库载体补机械惰性承载注(关卡域库存恒空、拆线归实装批——与战斗结算 v0.28 同款口径);④P1 相邻域屏行「节点奖励屏随秘宝内容重定批」过期批次名清偿(node-reward.md v2.5 令牌池已在役) |
|
||||
| v0.16 | 2026-10-10 | 柜台名扫改(2026-10-10 天赋树设计会话裁「道具工坊」改名「秘宝匣」):迭代 19 卡④落籍注记内「营地道具工坊同调装配获渠」改「营地秘宝匣同调装配获渠」。机制与接线零改动 |
|
||||
| v0.16 | 2026-10-10 | 柜台名扫改(2026-10-10 天赋树设计会话裁「道具工坊」改名「秘宝匣」):迭代 19 卡④入库注记内「营地道具工坊同调装配获渠」改「营地秘宝匣同调装配获渠」。机制与接线零改动 |
|
||||
@@ -116,5 +116,5 @@ HUD 框架定稿时已为教学留好两个承载位,本系统的内容将来
|
||||
| v0.1 | 2026-09-14 | 自归档线索整合为范围草案(旧体系未单独成文) |
|
||||
| v0.2 | 2026-09-15 | 雾格残留清理:删除「待拍板」的雾类教学条目失义登记(图例条目"迷雾 = 无雷盲区"与雾格首遇三要点提示),"待设计问题清单"第 3 条去掉雾条目删除的限定。教学条目清单与承载设施不变 |
|
||||
| v0.3 | 2026-09-17 | 数值纪律收口批:呈现常量复述改指路 HUD 框架调参表 |
|
||||
| v0.4 | 2026-10-04 | **地形变异手册行批(全局作用域变异首发批——迭代 14 ③号卡,代码同批)**:已登记的教学条目表补「Boss 图整图变异说明行」——三层预告中的手册层承载(帮助文案块一行,零交互教学),横幅/角标两层归 HUD 框架;语义正主=地形变异.md §全局作用域型 |
|
||||
| v0.4 | 2026-10-04 | **地形变异手册行批(全局作用域变异首发批——迭代 14 ③号卡,代码同批)**:已登记的教学条目表补「Boss 图整图变异说明行」——三层预告中的手册层承载(帮助文案块一行,零交互教学),横幅/角标两层归 HUD 框架;语义现行事实源=地形变异.md §全局作用域型 |
|
||||
| v0.5 | 2026-10-09 | **文档正确性审查批·独立复核(worktree docaudit-2026-10-09)**:①内容原则与 P1 后置「里程碑定位 Alpha」改排 **Beta 阶段**(2026-10-04 用户拍板教学引导整体改排,06 节头注记在案——本文漏同步);②教学条目「库存关卡末清空」行补机械惰性承载注(清空对象=关卡域库存恒空、拆线归实装批,本条目随拆线失效——与战斗结算 v0.28 同款口径) |
|
||||
@@ -7,7 +7,7 @@
|
||||
|
||||
元进度管的是跨局成长:一场冒险结束,局内的血、库存与随机种子全部清零重来,而存档里攒下的东西不清零。玩家在下探途中夺得一种叫钥石的永久资源(渠道 = Boss / 精英怪击杀掉落——原「关卡大奖励入账」渠道随迭代 10 奖励重构退役,见核心规则),在冒险与冒险之间用它换永久强化——这就是核心循环里「存档在变厚」的故事线,本系统就是这条线的归属地。
|
||||
|
||||
定名(2026-09-18 用户拍板):**元进度**(Meta Progression)是系统族名,本作落地名叫**永久强化**——伴随存档生命周期、可被钥石换取的成长资源集合。归档线索里的旧概念「天赋树」随定名退役的是其旧义;树形结构本身已随迭代 12 以锻造脉形态落地在役——存档域 tree_nodes / fork_sides(save v5)、营地树面板,系统正主 = [天赋树](天赋树.md)。**营地**是存档内消费钥石的枢纽场所,只是界面壳(呈现层概念),不是机制实体——机制主语一律用「永久强化」。
|
||||
定名(2026-09-18 用户拍板):**元进度**(Meta Progression)是系统族名,本作落地名叫**永久强化**——伴随存档生命周期、可被钥石换取的成长资源集合。归档线索里的旧概念「天赋树」随定名退役的是其旧义;树形结构本身已随迭代 12 以锻造脉形态落地在役——存档域 tree_nodes / fork_sides(save v5)、营地树面板,系统现行事实源 = [天赋树](天赋树.md)。**营地**是存档内消费钥石的枢纽场所,只是界面壳(呈现层概念),不是机制实体——机制主语一律用「永久强化」。
|
||||
|
||||
**独立资源口径**(框架见[核心循环](../../01-核心循环.md)「生命周期轴」节):钥石与 GP 是两条平行独立资源,不立统一上位概念,按生命周期各归各档——钥石=存档级账归本文,GP=冒险级账归[冒险结构](../冒险循环/冒险结构.md)「GP 冒险账本」节。
|
||||
|
||||
@@ -62,14 +62,14 @@
|
||||
| 柜台 | 内容 | 解锁渠道 |
|
||||
|---|---|---|
|
||||
| 属性锻造 | 生命上限、基础攻击、护甲等级——三档可重复升级的属性强化 | 钥石直购 |
|
||||
| 秘宝匣 | 秘宝解锁与同调装配——**件的目录与效果正主归[秘宝](../跨局循环/秘宝.md)「目录(重设计 v1)」**(15 件三档;旧目录全退役只作素材库,本行旧「现行六行」登记 2026-10-09 用户令删旧写新作废) | 解锁门槛=谓词分级(普通 0 门槛/优秀中里程碑/稀有高里程碑,具体阈值归调参批——设计正主见秘宝.md 三档骨架);谓词表形态与同调装配段已随同调实施批落地(2026-10-03,见版本历史 v1.6);通关次数渠道与钥石直购价归定价批后补 |
|
||||
| 秘宝匣 | 秘宝解锁与同调装配——**件的目录与效果现行事实源归[秘宝](../跨局循环/秘宝.md)「目录(重设计 v1)」**(15 件三档;旧目录全退役只作素材库,本行旧「现行六行」登记 2026-10-09 用户令删旧写新作废) | 解锁门槛=谓词分级(普通 0 门槛/优秀中里程碑/稀有高里程碑,具体阈值归调参批——设计权威文档见秘宝.md 三档骨架);谓词表形态与同调装配段已随同调实施批落地(2026-10-03,见版本历史 v1.6);通关次数渠道与钥石直购价归定价批后补 |
|
||||
| 奖励格图鉴 | 特殊奖励格的解锁——更强效果的格面 | 结构位现定;格子内容排 Alpha,随[地图战斗资源](../战斗循环/地图战斗资源.md)差异化批落地 |
|
||||
|
||||
属性锻造的树形节点结构(脊柱四线 + 锻造脉)已随迭代 12 落地在役,树形节点结构正主 = [天赋树](天赋树.md);本柜台三档直线强化与树四线 flat 在注入面叠加生效。
|
||||
属性锻造的树形节点结构(脊柱四线 + 锻造脉)已随迭代 12 落地在役,树形节点结构现行事实源 = [天赋树](天赋树.md);本柜台三档直线强化与树四线 flat 在注入面叠加生效。
|
||||
|
||||
属性锻造的攻击、护甲两档将按[武器锻造](武器锻造.md) v0.1 设计定案改造为武器与护甲的独立等级路线(实装待办在册 [06-待办清单](../../06-待办清单.md),冻结待排期;改造落地前本柜台三档直购维持现役)。
|
||||
|
||||
**营地统一(2026-10-11 天赋树设计会话裁案甲)**:树=营地本体,属性升级唯一入口=天赋树脊柱淬炼节点,本属性锻造柜台随 06「天赋树实装批」退役、功能吸收进脊柱(落地前维持现役);锻造柜台与秘宝匣转为树上钥匙节点(锻造工坊/秘宝匣)展开的工作间,奖励格图鉴常开不设钥匙。设计正主 = [天赋树](天赋树.md) v0.2「营地=树:统一模型」节。
|
||||
**营地统一(2026-10-11 天赋树设计会话裁案甲)**:树=营地本体,属性升级唯一入口=天赋树脊柱淬炼节点,本属性锻造柜台随 06「天赋树实装批」退役、功能吸收进脊柱(落地前维持现役);锻造柜台与秘宝匣转为树上钥匙节点(锻造工坊/秘宝匣)展开的工作间,奖励格图鉴常开不设钥匙。设计权威文档 = [天赋树](天赋树.md) v0.2「营地=树:统一模型」节。
|
||||
|
||||
**投值语言锁定(2026-09-18 数值语言拍板)**:三柜台属性强化一律 **flat 整数加减**("每级 +1 基础攻击"式,而非"+50% 攻击"式)——避开百分比词条被数值成长稀释的先例陷阱、守住数字可读性锚;具体每级数值仍归元进度设计批投值。
|
||||
|
||||
@@ -170,11 +170,11 @@ MVP 不要求本系统的闭环([不做清单](../../05-不做清单.md)整体
|
||||
| v1.4 | 2026-09-23 | **换算率标定批(用户指令「现在标定」;与切片代码 / registry / 06-待办清单 / 判定端工具同批)**:换算率节回填现行表值(生命 6 / 攻击 9 / 护甲 1 点每级——OFAT 冒险注入档与白板同种子配对的逐关条件通关率差实测,冒险条件口径;同日单关直入口口径退役使首轮直入口面读数作废重测);护甲行强条目重测履行并暴露修复护甲断链(begin_battle hero_armor_class 参数零消费→_defender_ac 接线);判定端带平移表值驱动接线(带重锚后随换算率平移判);排期表 P1 行销项 |
|
||||
| v1.5 | 2026-10-01 | **钥石渠道改一批(迭代 10 奖励重构——用户 2026-09-30 拍板;与冒险结构 v0.12 / registry 同批)**:钥石渠道自二改一——「关卡大奖励入账(keystone_per_level)」随大奖励三件套退役,渠道 = Boss/精英怪击杀掉落(逐杀实时入账,行值读 meta.tres boss_keystone 首杀/复杀两档;精英掉 1 预留);首杀大额/复杀小额规则不变。**产出重标义务重开**:现行两关冒险产出结构从「大奖励 10×2 + Boss 首杀 5」改「Boss 掉落 ×N(精英未实装零贡献)」,标定随元进度设计批/调参批重开(06 登记) |
|
||||
| v1.6 | 2026-10-03 | **同调位账本批(迭代 11 第①批同调实施批——save v4 / meta.tres attune_refresh_upgrade 行族 / registry 同批)**:①道具工坊柜台职责改写——解锁→谓词表形态(unlock_requires 行,首批全解锁=空谓词合法态,底稿 §2.2 用户裁),柜台内新增「同调装配」段(装配/换装/Slots 点亮 + Y 刷新升级行购买——程序占位面,视觉终稿归营地批;满位禁选/写档持久 MetaProgression.toggle_attunement 唯一写口);②Boss 击杀总数计数登记(boss_kill_count 含重复,收束入账=apply_adventure_summary 逐通关关次 +1,attunement_growth 谓词表计数源);③Y 刷新升级行登记(attune_refresh_upgrade 行族 L1→Y1/L2→Y2,钥石直购,provisional);④装配关系入存档持久(attunement_equipped save v4 域,冒险中途不可换装——底稿 §8.5) |
|
||||
| v1.7 | 2026-10-07 | **生命周期轴裁决随批(框架正主=核心循环「生命周期轴」节同批落文)**:设计目的节补独立资源口径——钥石与 GP=两条平行独立资源不立统一上位概念,钥石=存档级账归本文、GP=冒险级账归冒险结构(同批落文);既有账本语义零改动 |
|
||||
| v1.7 | 2026-10-07 | **生命周期轴裁决随批(框架现行事实源=核心循环「生命周期轴」节同批落文)**:设计目的节补独立资源口径——钥石与 GP=两条平行独立资源不立统一上位概念,钥石=存档级账归本文、GP=冒险级账归冒险结构(同批落文);既有账本语义零改动 |
|
||||
| v1.8 | 2026-10-09 | **文档正确性审查批(用户令——状态记录与证据对齐)**:①设计目的「渠道有二:关卡大奖励入账、关底 Boss 掉落」与核心规则「渠道自迭代 10 起改一」自相矛盾——订正为 Boss/精英怪击杀掉落单渠道;②道具工坊行订正——工兵令已退役(treasure_items.tres retired 旗),可解锁在役=探巢摆钟/爆破工兵包两件;「本柜台职责随同调实施批改写」的未来式订正为已落地(2026-10-03 v1.6);③定名节补审查注——「本作不存在树形结构」失义(属性锻造随迭代 12 T9 落地为锻造脉节点结构,存档域 tree_nodes/fork_sides),章节归后续修订;④里程碑前缀按 2026-10-09 口径删「M-3」(视觉终稿行)只留「迭代 9」;⑤调参表钥石产出行删「每关入账值 keystone_per_level」(行值已退役)改 boss_keystone 行指路。 |
|
||||
| v1.9 | 2026-10-09 | 文档正确性审查批(定点):解锁双入口框架节「局内暂停层入口未实装(随 HUD 批 M-4)」过期订正——暂停层只读入口已实装(2026-10-06 迭代 17 卡③,实机目检待用户;06 登记条在册);裸 M-4 标签随订正消除 |
|
||||
| v1.10 | 2026-10-09 | **B2 裁决落文(用户令「删除旧的、直接写新的」)**:道具工坊行删旧写新——旧「现行六行」登记作废(旧目录已随秘宝 v1.5 全退役),改写=件的目录与效果正主指路秘宝.md「目录(重设计 v1)」+解锁门槛谓词分级(普通 0 门槛/优秀中里程碑/稀有高里程碑,阈值归调参批)+通关次数渠道与钥石直购价归定价批后补 |
|
||||
| v1.11 | 2026-10-09 | **B1 裁决落文(用户令「元进度让他们都独立去写」——天赋树独立成文)**:①定名节冲突表述换代——「归档线索里的『天赋树』一词就此退役」与 v1.8 审查注(「本作不存在树形结构」失义登记)同步摘除,改写 = 退役的是归档线索旧概念的旧义、树形结构已随迭代 12 以锻造脉形态落地在役(系统正主 = 天赋树.md,本批新建 v0.1);②三柜台节补指路句——属性锻造树形节点结构正主 = 天赋树.md,旧三档柜台与树四线 flat 注入面叠加实态随句登记。机制零改动 |
|
||||
| v1.12 | 2026-10-09 | 武器锻造成文批随迁(用户令「完成文档编写、代码不实现、记录待办」):三柜台节补指路句——属性锻造攻击/护甲两档的路线化改造设计正主 = [武器锻造](武器锻造.md) v0.1(按 2026-10-07 提案推荐案成文、17 裁点开放在册、实装待办在册 06;改造落地前三档直购维持现役)。机制零改动 |
|
||||
| v1.10 | 2026-10-09 | **B2 裁决落文(用户令「删除旧的、直接写新的」)**:道具工坊行删旧写新——旧「现行六行」登记作废(旧目录已随秘宝 v1.5 全退役),改写=件的目录与效果现行事实源指路秘宝.md「目录(重设计 v1)」+解锁门槛谓词分级(普通 0 门槛/优秀中里程碑/稀有高里程碑,阈值归调参批)+通关次数渠道与钥石直购价归定价批后补 |
|
||||
| v1.11 | 2026-10-09 | **B1 裁决落文(用户令「元进度让他们都独立去写」——天赋树独立成文)**:①定名节冲突表述换代——「归档线索里的『天赋树』一词就此退役」与 v1.8 审查注(「本作不存在树形结构」失义登记)同步摘除,改写 = 退役的是归档线索旧概念的旧义、树形结构已随迭代 12 以锻造脉形态落地在役(系统现行事实源 = 天赋树.md,本批新建 v0.1);②三柜台节补指路句——属性锻造树形节点结构现行事实源 = 天赋树.md,旧三档柜台与树四线 flat 注入面叠加实态随句登记。机制零改动 |
|
||||
| v1.12 | 2026-10-09 | 武器锻造成文批随迁(用户令「完成文档编写、代码不实现、记录待办」):三柜台节补指路句——属性锻造攻击/护甲两档的路线化改造设计权威文档 = [武器锻造](武器锻造.md) v0.1(按 2026-10-07 提案推荐案成文、17 裁点开放在册、实装待办在册 06;改造落地前三档直购维持现役)。机制零改动 |
|
||||
| v1.13 | 2026-10-10 | **「道具工坊」改名「秘宝匣」(2026-10-10 天赋树设计会话裁——树上解锁节点与营地柜台同名)**:现行正文六处扫改(三柜台行 / 柜台行 / 柜台纪律 / 后续商品行 / 调参表 P1 / 定价表行);版本历史行一律不动;别名「道具工坊」登记 registry 术语条保留检索。机制零改动 |
|
||||
| v1.14 | 2026-10-11 | **营地统一案甲随迁(2026-10-11 天赋树设计会话终裁)**:三柜台节补「营地统一」段——树=营地本体、属性升级唯一入口=树脊柱淬炼节点、本属性锻造柜台随 06「天赋树实装批」退役吸收进脊柱(落地前维持现役)、锻造柜台与秘宝匣转工作间钥匙模型、图鉴常开;设计正主指路 = 天赋树.md v0.2。机制零改动(退役与公式换代随实装批) |
|
||||
| v1.14 | 2026-10-11 | **营地统一案甲随迁(2026-10-11 天赋树设计会话终裁)**:三柜台节补「营地统一」段——树=营地本体、属性升级唯一入口=树脊柱淬炼节点、本属性锻造柜台随 06「天赋树实装批」退役吸收进脊柱(落地前维持现役)、锻造柜台与秘宝匣转工作间钥匙模型、图鉴常开;设计权威文档指路 = 天赋树.md v0.2。机制零改动(退役与公式换代随实装批) |
|
||||
@@ -11,7 +11,7 @@
|
||||
|
||||
## 系统范围
|
||||
|
||||
边界这样划:天赋树管「树的结构与树域账 + 营地统一模型」——有哪些节点、节点怎么解锁、购买与切换守什么规则、工作间怎么被钥匙节点展开、树的效果怎么进下一局。钥石从哪来、余额怎么记,归元进度;工作间内的操作(路线升级、秘宝装配)各归其正主。
|
||||
边界这样划:天赋树管「树的结构与树域账 + 营地统一模型」——有哪些节点、节点怎么解锁、购买与切换守什么规则、工作间怎么被钥匙节点展开、树的效果怎么进下一局。钥石从哪来、余额怎么记,归元进度;工作间内的操作(路线升级、秘宝装配)各归其现行事实源。
|
||||
|
||||
负责:
|
||||
|
||||
@@ -29,7 +29,7 @@
|
||||
|---|---|
|
||||
| 节点数值行(价格 / 等级上限 / effects 取值 / 限次值) | [数据配置](../表现与支撑/数据配置.md)——行值读 `meta_tree.tres`,全 provisional 归数值批;本文只定规则与键结构 |
|
||||
| 钥石账本 | [元进度](元进度.md)——树是永久强化的承载结构,钥石余额是消费来源;旧柜台框架与退役面亦在对方登记 |
|
||||
| 锻造工坊工作间内的路线升级设计 | [武器锻造](武器锻造.md)——武器三路线+护甲三路线的等级、定价、满级特效正主在彼 |
|
||||
| 锻造工坊工作间内的路线升级设计 | [武器锻造](武器锻造.md)——武器三路线+护甲三路线的等级、定价、满级特效现行事实源在彼 |
|
||||
| 秘宝目录、同调装配与同调位求值 | [秘宝](../跨局循环/秘宝.md)——树只持同调位节点挂载位与秘宝匣钥匙 |
|
||||
| 奇物(局内流派件) | [奇物](../冒险循环/奇物.md)——规则改写型特性只走局内随机渠道,永不入树(层级纪律,见核心规则) |
|
||||
| 存档读写与版本迁移机制 | [存档序列化](../表现与支撑/存档序列化.md)——树域是存进去的内容之一 |
|
||||
@@ -103,9 +103,9 @@ A/B 面只放规则面:节点 effects 取封闭规则键词表(RULE_KEYS)
|
||||
|
||||
### 跨局注入:树效果怎么进下一局
|
||||
|
||||
树的效果经两条通道随冒险开始参数面下传(通道正主 = [元进度](元进度.md)「跨局注入」节):
|
||||
树的效果经两条通道随冒险开始参数面下传(通道现行事实源 = [元进度](元进度.md)「跨局注入」节):
|
||||
|
||||
① 属性通道——开局属性 = **角色基础值 + 树四线淬炼 flat(Σ 节点 effects × 等级)+ 锻造路线加值(当前武器 / 当前甲,正主 = [武器锻造](武器锻造.md))+ 局内加算区 flat**(2026-10-11 叠加公式换代:旧「柜台三档 flat」项随柜台退役移除,树脊柱成账号全局基础层、锻造路线成专精层,两层相加)。写入覆盖值通道(atk / max_hp / armor_class),开局显式传入战斗初始化。命中线已购等级在账但未入注入面——消费面(命中折扣档)归数值批(代码批注在册披露)。
|
||||
① 属性通道——开局属性 = **角色基础值 + 树四线淬炼 flat(Σ 节点 effects × 等级)+ 锻造路线加值(当前武器 / 当前甲,现行事实源 = [武器锻造](武器锻造.md))+ 局内加算区 flat**(2026-10-11 叠加公式换代:旧「柜台三档 flat」项随柜台退役移除,树脊柱成账号全局基础层、锻造路线成专精层,两层相加)。写入覆盖值通道(atk / max_hp / armor_class),开局显式传入战斗初始化。命中线已购等级在账但未入注入面——消费面(命中折扣档)归数值批(代码批注在册披露)。
|
||||
|
||||
② 规则通道——tree_rule_keys = 各 Fork 组激活侧节点 effects 键集,经冒险开始参数面 tree_rules 下传;每场战斗 begin_battle 时由效果引擎 rebuild 合成订阅行生效。开新冒险与继续上局两入口同参同值。
|
||||
|
||||
@@ -113,7 +113,7 @@ A/B 面只放规则面:节点 effects 取封闭规则键词表(RULE_KEYS)
|
||||
|
||||
三条已建表 / 已可购但消费面未接的实态,如实登记,处置权归 06「天赋树实装批」:
|
||||
|
||||
- 同调位数量的判定源仍是同调谓词表实时求值(Attunement.slots,正主 = [秘宝](../跨局循环/秘宝.md)同调面)——树同调位节点可购、是全部 Fork 的前置,但未接入槽位求值:买同调位 2/3 当前不改变同调位数量(槽位收编归实装批,与秘宝实装批存在槽位定序点)。
|
||||
- 同调位数量的判定源仍是同调谓词表实时求值(Attunement.slots,现行事实源 = [秘宝](../跨局循环/秘宝.md)同调面)——树同调位节点可购、是全部 Fork 的前置,但未接入槽位求值:买同调位 2/3 当前不改变同调位数量(槽位收编归实装批,与秘宝实装批存在槽位定序点)。
|
||||
- 刷新升级节点可购,但刷新能力实际生效仍走同调段 Y 升级账本(attune_refresh_level,行值读 `meta.tres` attune_refresh_upgrade 行族)——**定性为缺陷**(树上购买无消费面=白花钱):修复 = 树上购买写同一账本,随实装批接线。
|
||||
- 命中线 flat 不入注入面(见上节,归数值批)。
|
||||
|
||||
@@ -121,11 +121,11 @@ A/B 面只放规则面:节点 effects 取封闭规则键词表(RULE_KEYS)
|
||||
|
||||
| 方向 | 系统 / 文档 | 接口要点 |
|
||||
|---|---|---|
|
||||
| 上游 | [元进度](元进度.md) | 钥石账本——树是永久强化的承载结构与营地本体;消费经钥石余额(写口 SaveManager),注入通道正主在对方;旧柜台退役面在对方登记 |
|
||||
| 上游 | [元进度](元进度.md) | 钥石账本——树是永久强化的承载结构与营地本体;消费经钥石余额(写口 SaveManager),注入通道现行事实源在对方;旧柜台退役面在对方登记 |
|
||||
| 上游 | [数据配置](../表现与支撑/数据配置.md) | meta_tree.tres 承载与 schema 校验机制——本系统为结构 owner、数值回填归数值批 |
|
||||
| 上游 | [存档序列化](../表现与支撑/存档序列化.md) | tree_nodes / fork_sides 持久化与迁移承载 |
|
||||
| 上游 | [秘宝](../跨局循环/秘宝.md) | 同调位谓词表求值(同调位节点的判定源侧);秘宝匣工作间内目录与装配正主在彼 |
|
||||
| 上游 | [武器锻造](武器锻造.md) | 锻造工坊工作间内武器/护甲路线升级正主在彼——树持钥匙节点,工作间=其柜台改造对象 |
|
||||
| 上游 | [秘宝](../跨局循环/秘宝.md) | 同调位谓词表求值(同调位节点的判定源侧);秘宝匣工作间内目录与装配现行事实源在彼 |
|
||||
| 上游 | [武器锻造](武器锻造.md) | 锻造工坊工作间内武器/护甲路线升级现行事实源在彼——树持钥匙节点,工作间=其柜台改造对象 |
|
||||
| 下游 | [冒险结构](../冒险循环/冒险结构.md) | 冒险开始参数面——树四线淬炼 flat(叠加进覆盖值通道)与 tree_rules 键集的注入通道 |
|
||||
| 下游 | [HUD 框架](../表现与支撑/HUD框架.md) | 树=营地主界面呈现(案甲);信号 = tree_buy_requested / tree_fork_toggled |
|
||||
| 下游 | 战斗侧效果引擎 | 规则键消费面——begin_battle rebuild 合成订阅(机制硬编码,无表行) |
|
||||
@@ -154,7 +154,7 @@ v0.2 换代定案后,P0 语义升级为:29 节点结构 + 营地统一(树
|
||||
| 节点表 `data/tables/meta_tree.tres`(换代后 29 行:价格 / 等级上限 / row / requires〔含等级阈值形态〕/ effects 取值 / 限次值) | schema MetaTreeTable,本文 owner | 全 provisional,归数值批投值 |
|
||||
| 脊柱行门槛常量 SPINE_ROW_GATE = 4 | `meta_tree_table.gd` 常量,本文 owner | 常量即规则(层 N 需全树总等级 ≥ 4×(N−1)) |
|
||||
| Fork 组词表 FORK_GROUPS(三组)/ 规则键词表 RULE_KEYS(换代后六键,扩表随实装批) | `meta_tree_table.gd` 封闭词表 | 词表即规则;规则键效果值硬编码于效果引擎 rebuild |
|
||||
| 钥石产出、Y 升级行族 | 正主 = [元进度](元进度.md)调参表 | `data/tables/meta.tres` |
|
||||
| 钥石产出、Y 升级行族 | 现行事实源 = [元进度](元进度.md)调参表 | `data/tables/meta.tres` |
|
||||
|
||||
## 验收标准
|
||||
|
||||
|
||||
@@ -47,7 +47,7 @@
|
||||
|
||||
就地改造属性锻造柜台为「武器与护甲锻造」:攻击档改造为武器锻造区(三件武器路线),护甲档改造为护甲锻造区(三型甲路线),**生命档原样保留**。营地三柜台结构不动,界面零重排。不新开第四柜台、不并入道具工坊(工坊职责=秘宝解锁与同调装配,职责混装淘汰)。
|
||||
|
||||
**树侧解锁门(2026-10-10 天赋树设计会话裁)**:本柜台以天赋树「锻造工坊」解锁节点为前置——免费节点,前置 = 攻击淬炼累计 ≥2 级 且 护甲淬炼累计 ≥2 级(等级阈值前置属新机制);节点解锁对象 = 营地锻造柜台(武器三路线+护甲三路线,即本柜台)。树侧结构换代(锻造枝三属性节点删并、地脉共鸣、同调位根节点化)设计正主 = [天赋树](天赋树.md)(正文落文归设计文档批),实装归 [06-待办清单](../../06-待办清单.md)「天赋树实装批」条。
|
||||
**树侧解锁门(2026-10-10 天赋树设计会话裁)**:本柜台以天赋树「锻造工坊」解锁节点为前置——免费节点,前置 = 攻击淬炼累计 ≥2 级 且 护甲淬炼累计 ≥2 级(等级阈值前置属新机制);节点解锁对象 = 营地锻造柜台(武器三路线+护甲三路线,即本柜台)。树侧结构换代(锻造枝三属性节点删并、地脉共鸣、同调位根节点化)设计权威文档 = [天赋树](天赋树.md)(正文落文归设计文档批),实装归 [06-待办清单](../../06-待办清单.md)「天赋树实装批」条。
|
||||
|
||||
### 三件武器
|
||||
|
||||
|
||||
@@ -275,11 +275,11 @@ playtest 预警(预注册,归难度曲线与Boss):
|
||||
| v0.8 | 2026-10-03 | **反制契约作废批(用户终裁——层级错配失败设计)**:五维度「反制」行改终裁态;上游地形变异依赖行、P2 后置行同步;地形变异.md v0.6 同批落义务作废注记 |
|
||||
| v0.9 | 2026-10-05 | **消歧更名批(用户拍板):系统更名「魔法道具」→「秘宝」**——「魔法」已被本作征用为敌方侧伤害/护甲语汇;同调位机制名保留;本批仅改文档称谓,代码标识符 aux_* 沿用(对齐另批) |
|
||||
| v1.0 | 2026-10-06 | **效果声明换代(内容数据驱动扩展批)**:被动件改订阅行(on/when/do 由效果引擎统一解释)+主动件受理闸数据化——按件 id 硬编码清零;结构冻结零触碰,行为与迁移前逐位一致(MC 同种子 40 局对拍实证) |
|
||||
| v1.1 | 2026-10-07 | **生命周期轴裁决随批(框架正主=核心循环「生命周期轴」节)**:三选一刷新双源补两账语义(存量账/临时账/消耗顺序);「三选一呈现」=比节点更细的事件 |
|
||||
| v1.1 | 2026-10-07 | **生命周期轴裁决随批(框架现行事实源=核心循环「生命周期轴」节)**:三选一刷新双源补两账语义(存量账/临时账/消耗顺序);「三选一呈现」=比节点更细的事件 |
|
||||
| v1.2 | 2026-10-07 | **三层职责分界批(用户裁)**:头部一句话换代为「营地装配的角色机能件」(操作包络加强,不出裸属性值、不改战斗结算机制);机制向三件归留本层重设计批处置 |
|
||||
| v1.3 | 2026-10-07 | **三件机制向现件归留裁决(用户裁)**:淬毒刃纹→专长池;标中殉爆→专长池插旗系;惊巢反制→退役进素材库;现役目录九→六 |
|
||||
| v1.4 | 2026-10-07 | **同调位分档(用户裁)**:同调位分三档(普通格/优秀格/稀有格)、槽位可装 ≤ 槽位档位的件、里程碑分档发槽;费用制落选留档 |
|
||||
| v1.5 | 2026-10-08 | **新目录 15 件落地批(用户终审全落)**:新增「目录(重设计 v1)」节=新正主——三档骨架+15 件表;旧目录全数退役只作素材库;数据迁移与旧行删除归实装批 |
|
||||
| v1.5 | 2026-10-08 | **新目录 15 件落地批(用户终审全落)**:新增「目录(重设计 v1)」节=新现行事实源——三档骨架+15 件表;旧目录全数退役只作素材库;数据迁移与旧行删除归实装批 |
|
||||
| v1.6 | 2026-10-09 | **去毒批**:速览旧目录九件表加退役标注+魔法提灯归属待裁指路 06/老正文过期声称清扫——新老框架分家 |
|
||||
| v1.7 | 2026-10-09 | **文档正确性审查批**:头部横幅重写/沿革节两态表述换代/实现面表名失同步修正/老正文深层逐节收口+四节隔离标注/调参表与验收旧语境改写 |
|
||||
| v1.8 | 2026-10-10 | 营地柜台名扫改(天赋树设计会话裁「道具工坊」改名「秘宝匣」):两处改「营地·秘宝匣柜台」。机制零改动 |
|
||||
|
||||
@@ -13,7 +13,7 @@
|
||||
|
||||
- 石纹全屏底(样张 v2 冻结件,浅 dim 透出)+ 顶栏铭牌与钥石徽(余额常驻)。
|
||||
- 三柜台列:属性锻造(三档行:等级/价格/购买钮)、秘宝匣(行:解锁进度与状态呈现——「已解锁·能力封存中」=deferred 件、「已退役」=retired 件)、奖励格图鉴(结构位)。
|
||||
- 树面板(图鉴柜台下段,现役程序占位):营地内天赋树的节点购买与 Fork A/B 面切换承载——系统正主=[天赋树](../跨局循环/天赋树.md)(33 节点在役),呈现终稿归 [HUD框架](../表现与支撑/HUD框架.md);信号 `tree_buy_requested` / `tree_fork_toggled`。(本行 2026-10-09 补登——树侧跨文档欠账清偿:此前本 spec 零树面板登记。)
|
||||
- 树面板(图鉴柜台下段,现役程序占位):营地内天赋树的节点购买与 Fork A/B 面切换承载——系统现行事实源=[天赋树](../跨局循环/天赋树.md)(33 节点在役),呈现终稿归 [HUD框架](../表现与支撑/HUD框架.md);信号 `tree_buy_requested` / `tree_fork_toggled`。(本行 2026-10-09 补登——树侧跨文档欠账清偿:此前本 spec 零树面板登记。)
|
||||
- 底栏:关闭钮 + 操作注记;最近冒险收底栏条带(逐行只读账面)。
|
||||
- 购买意图 `buy_requested(attr)` 经组合根转发 MetaProgression(纯视图 setter 面——零核心写调用、零账本持有);购买成功 `refresh_camp` 就地重刷(零重建回流)。
|
||||
- 开合与开始层互斥:打开本层前由组合根隐藏开始层(遮挡纪律 2.3——开始覆盖层非模态且树序在后)。
|
||||
@@ -21,7 +21,7 @@
|
||||
## 口径
|
||||
|
||||
- 呈现数据源 = MetaProgression 只读投影经组合根喂入;本层不持有账本、不算价。
|
||||
- 退役/封存件呈现语义(探宝罗盘「已退役」;显影尘/地穴全图卷「已解锁·能力封存中」)为本层职责——2026-09-30 前该语义无 spec 正主(node-reward.md 曾悬空指认),随本 spec 落位。
|
||||
- 退役/封存件呈现语义(探宝罗盘「已退役」;显影尘/地穴全图卷「已解锁·能力封存中」)为本层职责——2026-09-30 前该语义无 spec 权威定义(node-reward.md 曾悬空指认),随本 spec 落位。
|
||||
- 双入口框架(主菜单入口+局内暂停层只读入口)的需求面归元进度「解锁双入口框架」节;暂停层入口已实装(2026-10-06 迭代 17 卡③——实机目检待用户,06 登记条在册),其呈现面不归本 spec。
|
||||
|
||||
## 版本历史
|
||||
|
||||
@@ -91,7 +91,7 @@
|
||||
| 三候选(件 id/名称/效果行值) | 冒险结构 bonus_pick 信号(令牌池洗牌不放回抽 3〔同 kind 去重——v0.14 令牌池换代口径,原「加权洗牌」退役〕,reward_pick 封闭流) | Read | 载荷自包含、despawn 前捕获;同种子同三候选(可复放) |
|
||||
| 部分回血读数(回血前后生命) | 冒险结构生命账本(clear_heal_pct 兑付) | Read | 满血回 0 合法态文案化 |
|
||||
| 兑付反馈载荷 | 冒险结构 bonus_resolved 信号 | Read | 选中件 id + 生效值 |
|
||||
| ~~同调位库存~~ | —— | —— | 替换子态随渠道退役;过渡键 transitional_sync_slots 已退役(迭代 11① T7——同调位正主 = attunement_growth.tres 谓词表实时求值) |
|
||||
| ~~同调位库存~~ | —— | —— | 替换子态随渠道退役;过渡键 transitional_sync_slots 已退役(迭代 11① T7——同调位现行事实源 = attunement_growth.tres 谓词表实时求值) |
|
||||
| 冒险摘要(五件事) | 冒险结构 adventure_finished 载荷 | Read | 末关分支数据锚(相邻域冒险结算屏消费) |
|
||||
| GP 账本 | 冒险结构 GP 冒险账本 | — | 不进本屏(维持 2026-09-27 拍板) |
|
||||
| 钥石入账 | 元进度 settle_adventure | Write(相邻域) | 唯一写档点不变;**本屏零钥石元素**(迭代 10 起,增量行迁战斗总结结算) |
|
||||
@@ -129,5 +129,5 @@
|
||||
| 2026-09-27 | GP 归属拍板对齐批(用户口径:战斗胜利→战斗总结结算展示获得资源〔目前 GP〕;战斗失败→冒险总结结算→确认回存档首页):OQ1 收口——GP 总量+增量归战斗胜利总结结算(battle.md OQ14 为准),本屏不承载 GP;OQ3 收口——「结算画面」指认 = 冒险总结结算,大奖励屏钥石进账 + 冒险总结结算明细两处并存维持;信息归属 GP 移入禁入清单;Data Requirements GP 行改零访问;06 归属行同步修正 |
|
||||
| 2026-09-27 | 关卡画面 UX spec 建档联动:§Navigation Position 下游屏行挂 level-map.md 屏级 spec 指针。零机制改动 |
|
||||
| 2026-10-01 | **三选一选择交互重写(迭代 10 奖励重构批——用户 2026-09-30 拍板案丙;T2 UX spec 卡)**:①Purpose/载体/导航/进出/层级/状态/交互/数据全节重写——「大奖励三件套快照展示」退役,改「部分回血反馈 + 提升三选一三卡点选 + 确认兑付 + 同调位替换子交互」;②钥石元素全屏退役(增量行迁战斗总结结算,禁入清单机检化);③交互范式 = choice_box 按钮族 + 选路两段式复用,零新增原语;④AC 五条改写 + 断点中断/减动效/禁入机检三条新增;⑤OQ3 改钥石三面化收口、OQ5 改替换子交互视觉归样张批 |
|
||||
| 2026-10-09 | 文档正确性审查批(在役态对齐):①三选一候选订正——自迭代 15② 渠道分离起通关三选一 = 纯专长(原「六种池加权抽三」与秘宝件直显条款退役);②同调位替换子交互全节退役(秘宝件迭代 11① 出池后本屏无道具件候选);③过渡键 transitional_sync_slots 引用删除(同调位正主 = attunement_growth.tres);④载体组件名订正 = curio_pick_overlay(与奖励节点共用面) |
|
||||
| 2026-10-09 | 文档正确性审查批(在役态对齐):①三选一候选订正——自迭代 15② 渠道分离起通关三选一 = 纯专长(原「六种池加权抽三」与秘宝件直显条款退役);②同调位替换子交互全节退役(秘宝件迭代 11① 出池后本屏无道具件候选);③过渡键 transitional_sync_slots 引用删除(同调位现行事实源 = attunement_growth.tres);④载体组件名订正 = curio_pick_overlay(与奖励节点共用面) |
|
||||
| 2026-10-09 | 文档正确性审查批·独立复核(worktree docaudit-2026-10-09):Data Requirements 三候选行「加权洗牌掷 3」漏网旧口径清偿——冒险结构 v0.14 令牌池换代后 = 令牌池洗牌不放回抽 3(同 kind 去重),与冒险结构/关卡节点地图/node-reward 同口径 |
|
||||
@@ -14,7 +14,7 @@
|
||||
- 头部行:「关卡奖励点 / 从提升池抽三选一(与通关三选一同池同权重同上限):选择一件带走:」(Narrator.node_bonus_header——文案「与通关三选一同池同权重同上限」滞后于迭代 15② 渠道分离,现行通关候选 = 纯专长;文案换代归内容批,已呈报)。
|
||||
- 三卡点选(✓ 高亮,确认前可改选)→「确认选择」→ 兑付反馈(选中件效果 + 丢弃提示)→「继续」→ 回图选路(零自动推进同款)。
|
||||
- ~~秘宝件直显/满位替换~~(v2.1 两面随池种退役——迭代 11 第①批 T7;秘宝改走营地同调装配面,见[秘宝](../systems/跨局循环/秘宝.md))。
|
||||
- **三选一刷新**(v2.2 新增——P1 甲 X/Y 双源;机制正主=[秘宝](../systems/跨局循环/秘宝.md)「三选一刷新双源」节,X 源承载件已随新目录批换代〔旧目录「三选一刷新件」退役→新目录「刷新练习」〕):装配「三选一刷新件」给 X 次(每次碰三选一重给、优先消耗、不结转)+ 营地「刷新升级」给 Y 次(每冒险开局注入冒险周期池、用完即无);刷新钮余量 >0 时现形,点按重抽三候选(reward_pick 既有洗牌流,池规则全保留:不放回/达上限剔牌/掷定前置直显/停点可中断)。autoplay 默认不刷(钓鱼归玩家)。
|
||||
- **三选一刷新**(v2.2 新增——P1 甲 X/Y 双源;机制现行事实源=[秘宝](../systems/跨局循环/秘宝.md)「三选一刷新双源」节,X 源承载件已随新目录批换代〔旧目录「三选一刷新件」退役→新目录「刷新练习」〕):装配「三选一刷新件」给 X 次(每次碰三选一重给、优先消耗、不结转)+ 营地「刷新升级」给 Y 次(每冒险开局注入冒险周期池、用完即无);刷新钮余量 >0 时现形,点按重抽三候选(reward_pick 既有洗牌流,池规则全保留:不放回/达上限剔牌/掷定前置直显/停点可中断)。autoplay 默认不刷(钓鱼归玩家)。
|
||||
|
||||
## 口径
|
||||
|
||||
@@ -34,5 +34,5 @@
|
||||
| v2.3 | 2026-10-03 | **商店并账注记(迭代 11 第②批 GP 商店房重构批——P1 共享池)**:口径节「同池同上限」扩第三渠道=商店货架(pool 模式付费渠道,买一件=奖励面少一件;库存=上限即库存全冒险一次性);本 spec 交互面零改动(商店货架面归 shop.md 与 ShopOverlay,非三选一覆盖层);GP 袋对商店面切边(负交易)、奖励面照常(牌库恒非空结构保证不变) |
|
||||
| v2.4 | 2026-10-03 | **令牌池落地(迭代 12 TP0——追认 b 实施批)**:三选一池改固定配额令牌池(普通 70/稀有 25/罕见 3=98 张;罕见档原列「道具件 2」随 aux_item 池种退役收窄——台账自决披露项);洗牌=令牌 Fisher-Yates 不放回抽 3 同 kind 去重每 kind 至多一枚、选中踢池未选回池、池耗即枯竭(空库=零候选直通合法态);种类次数上限退役;恢复件=新入池种类(rare 档 +6 当即回血);kind 词表扩 heal 六种;MC 策略 316-f 落地(1 级最稀有/2 级最左);货架=令牌级抽签(价格公式 tier-blind 维持批②裁定);断点扩键 bonus_deck(余库逐枚还原);现行基线锚=runsum_m4iter12_tp0_n20_20261003(normal 档配对读数同带) |
|
||||
| v2.5 | 2026-10-09 | 文档正确性审查批(在役态对齐):①定位节「与通关三选一共享同一令牌池」过期——迭代 15② 渠道分离后通关三选一候选 = 纯专长,本面与商店货架同库(六种令牌池);②载体组件名订正 = CurioPickOverlay;③头部文案引文加注「与通关三选一同池」字样滞后于渠道分离(文案换代归内容批,已呈报) |
|
||||
| v2.6 | 2026-10-09 | 文档正确性审查批·独立复核(worktree docaudit-2026-10-09):①定位节令牌池「六种」→**七种**(adventure_table.gd CURIO_KINDS 实测七类含 refresh——刷新件随迭代15② T6 入池,curio_quota_refresh_rare=2 在役;v2.5 修订漏登);②三选一刷新行补机制正主指路与 X 源承载件换代注(旧目录「三选一刷新件」退役→新目录「刷新练习」——秘宝.md「三选一刷新双源」节) |
|
||||
| v2.6 | 2026-10-09 | 文档正确性审查批·独立复核(worktree docaudit-2026-10-09):①定位节令牌池「六种」→**七种**(adventure_table.gd CURIO_KINDS 实测七类含 refresh——刷新件随迭代15② T6 入池,curio_quota_refresh_rare=2 在役;v2.5 修订漏登);②三选一刷新行补机制现行事实源指路与 X 源承载件换代注(旧目录「三选一刷新件」退役→新目录「刷新练习」——秘宝.md「三选一刷新双源」节) |
|
||||
| —— | 2026-10-09 | v2.2 双行同号系历史登记,2026-10-09 卫生批加 a/b 后缀区分 |
|
||||
@@ -68,3 +68,4 @@
|
||||
| v1.1 | 2026-10-11 | **怪物巢穴类型概念退役批(用户裁「目前没有具体的怪物巢穴类型,全部改成危险格」)**:删怪物巢穴词条、危险格与旗/控制两行换代;世界观风味层的「巢穴」隐喻〔00-游戏概念巢穴隐喻轴,产品名清巢者出处〕与美术纹样名保留,机制文档零巢穴 |
|
||||
| v1.0 | 2026-10-11 | 首版建立(用户令「做一个专用术语表,让读者查表阅读」):格与棋盘/资源与经济/秘宝系统/道具体系四节+退役词对照表;同批全库统一更名=危险格(原雷格/惩罚格)/整图(原板级)/专长凭证(原门票) |
|
||||
| v1.2 | 2026-10-11 | **机制表述巢穴补扫收尾(用户裁无类型划分)**:行动经济/音频/敌人系统等机制文档「惊动巢穴/巢穴被控制」系表述全量换代危险格(惊动 4/标中 1/被控制 2);对照表补巢穴行 |
|
||||
| v1.3 | 2026-10-11 | **正主/落籍全库扫尾批(用户令收尾)**:正主→现行事实源 130 行+落籍→已入库 79 行全库换代(39 文件 194 行;语境微调=权威文档/权威定义节/拼表制主选/入库注记等);雷格/惩罚格/板级/门票/工作日志五词终验零真残留(存量命中均系对照行/更名记载句/禁令引举等对照性文本);技能 SKILL.md 三件与记忆目录随批同扫 |
|
||||
@@ -1,6 +1,6 @@
|
||||
# 出口报告——迭代 19 卡③ CI 预接线批(2026-10-08)
|
||||
|
||||
> 需求卡片=`design/research/需求卡片-CI预接线批-2026-10-07.md`(v1.2);worktree=`D:\code\g-plan2-iter19-ciwire`(分支 iter19-ciwire-20261008,基点 9160942=master 顶部含卡⓪落籍);T0-T3 全履行,S2 未触发,**S1 命中一项(呈报待裁,未代修)**。
|
||||
> 需求卡片=`design/research/需求卡片-CI预接线批-2026-10-07.md`(v1.2);worktree=`D:\code\g-plan2-iter19-ciwire`(分支 iter19-ciwire-20261008,基点 9160942=master 顶部含卡⓪已入库);T0-T3 全履行,S2 未触发,**S1 命中一项(呈报待裁,未代修)**。
|
||||
|
||||
## 一、tests.yml 改动对照(T1,逐件)
|
||||
|
||||
@@ -53,13 +53,13 @@
|
||||
| 2. CI 段引用的每个 res:// 路径实存 | ✅ | `res://tests/run_all.gd` 实存;三探针调用点逐一核对:ui_input_probe.tscn/ui_struct_probe.tscn/ui_contrast_probe.tscn 全 [OK](脚本逐文件 isfile) |
|
||||
| 3. timeout 外壳+PASS 判定齐备;头注释含自动生效句 | ✅ | timeout 清单:300s 导入步/120s 冒烟/120s×3 探针;PASS 判定函数化定义一处三探针各执行;超时判 `-eq 124`/`-eq 137` 在位;「无需改本文件即自动生效」在头注释 |
|
||||
| 4. pyyaml 解析通过 | ✅ | `yaml.safe_load` OK;jobs.smoke 步骤序=[Checkout, Setup Godot 4.7.2, Import assets, Run smoke runner, Run scene probes, Upload Test Results](pyyaml 将 `on:` 读作布尔键系 YAML 1.1 已知怪癖,GitHub Actions 按 YAML 1.2 处理,非问题) |
|
||||
| 5. roadmap 邻行登记+B6 闭环注记;diff 面=tests.yml+账务行 | ✅ | roadmap 75 行卡③段内追加「✅ 卡③落籍」块(B6 闭环注记在册);git status 本批正文 diff 仅 tests.yml+roadmap.md,游戏代码/探针件/probe_gate.sh/CLAUDE.md 零 diff(契约 1 达成) |
|
||||
| 5. roadmap 邻行登记+B6 闭环注记;diff 面=tests.yml+账务行 | ✅ | roadmap 75 行卡③段内追加「✅ 卡③已入库」块(B6 闭环注记在册);git status 本批正文 diff 仅 tests.yml+roadmap.md,游戏代码/探针件/probe_gate.sh/CLAUDE.md 零 diff(契约 1 达成) |
|
||||
|
||||
术语口径对齐:新增注释用「轻闸」(×2)「--full 重闸」(×1)——与 probe_gate.sh 自称「轻闸探针正主」及需求卡片 v1.2 三闸口径一致。
|
||||
术语口径对齐:新增注释用「轻闸」(×2)「--full 重闸」(×1)——与 probe_gate.sh 注释自称及需求卡片 v1.2 三闸口径一致。
|
||||
|
||||
## 六、T3 账务
|
||||
|
||||
- roadmap 迭代 19 行卡③段内落籍登记(含 B6 闭环注记、S1 呈报项、首跑清单指针)——合并时与兄弟卡换代按 Q13 由主控串行重放。
|
||||
- roadmap 迭代 19 行卡③段内入库登记(含 B6 闭环注记、S1 呈报项、首跑清单指针)——合并时与兄弟卡换代按 Q13 由主控串行重放。
|
||||
- 「首次 push 后人工盯首跑」移交清单:需求卡片 v1.2 §七 已在册三条(首跑三查/ui_contrast Linux 字体环境差异预判/导入步首跑耗时观察),本批核对闭环、无再改需求卡片必要。
|
||||
- 台账:active.md 追加 **402** 条(397 条预配号卡③=402;记账前 `git show master:active.md` 查撞 400-409 零命中,未顺延)。
|
||||
|
||||
@@ -81,5 +81,5 @@
|
||||
| hash | 内容 |
|
||||
|---|---|
|
||||
| 3799e0c | 卡③T1——tests.yml 注释探针段解封改写为正式轻闸段(含导入步/分支修正/头注释) |
|
||||
| 7397603 | 卡③T3——roadmap 迭代19行卡③段内追加落籍登记 |
|
||||
| 7397603 | 卡③T3——roadmap 迭代19行卡③段内追加入库登记 |
|
||||
| (本笔) | 卡③出口报告+active.md 台账记账 402 |
|
||||
@@ -1,6 +1,6 @@
|
||||
# 迭代 19 尾裁微批「三件」出口报告(2026-10-08)
|
||||
|
||||
- worktree:`D:\code\g-plan2-iter19-followup`(分支 `iter19-followup-20261008`,基点 0ba3ddf = master 顶部,已含卡⓪③②落籍)
|
||||
- worktree:`D:\code\g-plan2-iter19-followup`(分支 `iter19-followup-20261008`,基点 0ba3ddf = master 顶部,已含卡⓪③②已入库)
|
||||
- 性质:用户 2026-10-08 六裁授权的落地批——裁甲(对比度存量 7 项另立修复批)+ 卡⓪ resume tree_rules 受理闭环 + 卡③ S1 换 setup-godot action
|
||||
- 台账号:**404**(记账前 `git -C D:/code/g-plan2 show master:active.md` 查撞——master 停 402 无 404 撞;403 = 卡④预配在飞,本条按预配 404 记)
|
||||
- MC/verifier:零跑(执行纪律)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 出口报告——迭代 19 卡④ 提灯载体道具批(2026-10-08)
|
||||
|
||||
> 需求卡片=`design/research/需求卡片-提灯载体道具批-2026-10-07.md`(v1.2);worktree=`D:\code\g-plan2-iter19-lantern`(分支 iter19-lantern-20261008,基点 568101b=master 卡③落籍态,含卡⓪①缺陷修复=本卡 T1 前置门 S1 天然满足);T0-T5 全履行,S0 行字段秒答已收(「按推荐」全收 2026-10-08),S2 未触发。**停机点:零**。
|
||||
> 需求卡片=`design/research/需求卡片-提灯载体道具批-2026-10-07.md`(v1.2);worktree=`D:\code\g-plan2-iter19-lantern`(分支 iter19-lantern-20261008,基点 568101b=master 卡③入库态,含卡⓪①缺陷修复=本卡 T1 前置门 S1 天然满足);T0-T5 全履行,S0 行字段秒答已收(「按推荐」全收 2026-10-08),S2 未触发。**停机点:零**。
|
||||
|
||||
## 一、行字段秒答记录与 provisional 追认单(S0)
|
||||
|
||||
@@ -56,16 +56,16 @@
|
||||
|
||||
| # | 位置 | 改前 | 改后 |
|
||||
|---|---|---|---|
|
||||
| 1 | board_view.gd :139(常量注释) | 「+2 预留不接效果——效果载体归 Alpha 信息件批;接线时写 _fog_lantern」 | 「+2=拍板值;载体=迭代 19 卡④ fog_lantern 秘宝行落籍 2026-10-08——原指路句随批换代」 |
|
||||
| 2 | board_view.gd :143-145(setter 注释) | 「〔aux_items 提灯新行——归 Alpha 信息件重定批〕到位后由组合根/库存挂接调用」 | 「〔fog_lantern 魔法提灯——迭代 19 卡④落籍〕已到位,组合根 main._sync_fog_lantern 每战首轮装配链显式重算调用」 |
|
||||
| 3 | art-bible.md :387 | 「LIGHT_RADIUS_LANTERN_BONUS=+2 预留不接效果(接线归 Alpha 信息件批)」 | 「FOG_LANTERN_BONUS=+2(**常量拟名顺手对齐落码实名**)已接效果落籍(载体=fog_lantern 行+每战装配链接线;呈现画法零改动——本节只管怎么画)」 |
|
||||
| 1 | board_view.gd :139(常量注释) | 「+2 预留不接效果——效果载体归 Alpha 信息件批;接线时写 _fog_lantern」 | 「+2=拍板值;载体=迭代 19 卡④ fog_lantern 秘宝行已入库 2026-10-08——原指路句随批换代」 |
|
||||
| 2 | board_view.gd :143-145(setter 注释) | 「〔aux_items 提灯新行——归 Alpha 信息件重定批〕到位后由组合根/库存挂接调用」 | 「〔fog_lantern 魔法提灯——迭代 19 卡④已入库〕已到位,组合根 main._sync_fog_lantern 每战首轮装配链显式重算调用」 |
|
||||
| 3 | art-bible.md :387 | 「LIGHT_RADIUS_LANTERN_BONUS=+2 预留不接效果(接线归 Alpha 信息件批)」 | 「FOG_LANTERN_BONUS=+2(**常量拟名顺手对齐落码实名**)已接效果入库(载体=fog_lantern 行+每战装配链接线;呈现画法零改动——本节只管怎么画)」 |
|
||||
| 4 | HUD框架.md :168(配套拍板段) | 「提灯载体归 aux_items 新行,随 Alpha 信息件重定批一并登记」 | 「登记原文+改道注记(2026-10-07 改道独立卡、2026-10-08 裁案A 落位)」 |
|
||||
| 5-6 | HUD框架.md :170(实施状态段,同段 2 处) | 「LIGHT_RADIUS_LANTERN_BONUS=+2 预留未接效果(接线归 Alpha 信息件批)」+「提灯载体〔aux_items 新行〕仍归 Alpha 信息件重定批」 | 常量实名对齐+「仍归」句删除,整段追加**〔2026-10-08 迭代 19 卡④落籍注记〕**(载体行/生产路径链/复原语义/测试随批/原登记去向销账声明) |
|
||||
| 5-6 | HUD框架.md :170(实施状态段,同段 2 处) | 「LIGHT_RADIUS_LANTERN_BONUS=+2 预留未接效果(接线归 Alpha 信息件批)」+「提灯载体〔aux_items 新行〕仍归 Alpha 信息件重定批」 | 常量实名对齐+「仍归」句删除,整段追加**〔2026-10-08 迭代 19 卡④入库注记〕**(载体行/生产路径链/复原语义/测试随批/原登记去向销账声明) |
|
||||
|
||||
- **残留核查**:全仓「Alpha 信息件」字样改后余三处——board_view.gd:139(换代声明句)、HUD框架.md:170(销账声明句)、roadmap.md(迭代 14 历史行+迭代 19 卡④改道留痕叙事)——均非活性指路,零旧口径残留。**qa 历史成文零触碰**(m4iter14 出口报告等原样)。
|
||||
- **06-待办清单.md :27-29**:菜单开局同调传参缺陷条回写落籍态(✅ 卡⓪ merge 9160942 修复面+冒烟 +6+resume tree_rules 受理缺口披露归属用户裁)。
|
||||
- **06-待办清单.md :27-29**:菜单开局同调传参缺陷条回写入库态(✅ 卡⓪ merge 9160942 修复面+冒烟 +6+resume tree_rules 受理缺口披露归属用户裁)。
|
||||
- **秘宝.md**:速览实现面文件名过时残留顺手订正(aux_items.tres→treasure_items.tres)+目录九件→十件(魔法提灯入册、被动六→七)+投放态注记十件口径+版本行 v1.1。
|
||||
- **roadmap.md :75**:迭代 19 行卡④段落籍登记(T1-T5 全记录+出口报告指路)——落籍顺序串行重放归主控合并时处理。
|
||||
- **roadmap.md :75**:迭代 19 行卡④段入库登记(T1-T5 全记录+出口报告指路)——入库顺序串行重放归主控合并时处理。
|
||||
|
||||
## 三、MC 对拍——静态论证(需求卡片 T5/裁 Q3:零实跑)
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 迭代 19 卡②「旧界面呈现断言回补批」出口报告(2026-10-08)
|
||||
|
||||
- worktree:`D:\code\g-plan2-iter19-uibackfill`(分支 `iter19-uibackfill-20261008`,基点 9160942 = master 顶部含卡⓪落籍)
|
||||
- worktree:`D:\code\g-plan2-iter19-uibackfill`(分支 `iter19-uibackfill-20261008`,基点 9160942 = master 顶部含卡⓪已入库)
|
||||
- 台账号:**401**(记账前以 `git -C D:/code/g-plan2 show master:active.md` 查撞——撞号结果随记账提交披露;397 条预配「卡②401」)
|
||||
- MC/verifier:零跑(需求卡片执行纪律)
|
||||
- **⚠ 停机点 S1 命中:新测点对首跑暴露存量对比度违例 7 项(§3 全量登记清单)——按需求卡片 §十 S1 停机呈报,处置权归用户;本批红线(旧屏零 diff)全程保持,7 项零修。S2 未命中(legend/node 结构首跑全绿)。**
|
||||
@@ -116,7 +116,7 @@ S2 未命中:两屏首跑零红、**WL 零新增**(WL 常量表现状仍=空
|
||||
3. **字面量墨收测前置**:bcard 描述/脚注/✓章/primary_button 字四处内联 Color8 收测,需先在 ui_kit 立常量(呈现批顺路件,本批越面禁改)。
|
||||
4. **TG_* 装饰带非文字判据**:如需机检化(WCAG 1.4.11 3:1),另立探针段裁决;本批不收理由见 §2 白名单记录。
|
||||
5. settlement_review_overlay 退役处置:已按 T4 在 06 登记落位(生涯节承接条目尾部追加登记行),去向二选一归生涯实装批/用户裁。
|
||||
6. probe_gate 整闸时长复测:建议主控在兄弟卡落籍后空窗复测一次默认段(本批本体配对数据 §5 已给,预期增幅 <1s)。
|
||||
6. probe_gate 整闸时长复测:建议主控在兄弟卡入库后空窗复测一次默认段(本批本体配对数据 §5 已给,预期增幅 <1s)。
|
||||
|
||||
## 7. 范围红线核验声明
|
||||
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
# 迭代 19 卡①「自动化验收补齐批」出口报告——**完工终版**(2026-10-08;前版=S1 停机点版,同日续接完工全量改写)
|
||||
|
||||
- worktree:`D:\code\g-plan2-iter19-verify`(分支 `iter19-verify-20261008`,基点 9160942 = master 顶部含卡⓪落籍;批末顶端见 §5 提交清单)
|
||||
- worktree:`D:\code\g-plan2-iter19-verify`(分支 `iter19-verify-20261008`,基点 9160942 = master 顶部含卡⓪已入库;批末顶端见 §5 提交清单)
|
||||
- 台账号:**399**(T0-T2 段)+ **400**(T3-T6 段;记账前以 `git -C D:/code/g-plan2 show master:active.md` 复查撞号——master 台账至 404,399/400 空缺未撞未顺延)
|
||||
- MC/verifier:零跑(本迭代零跑+静态论证口径,全程未触)
|
||||
- **停机点命中两次,均闭环或呈报**:①S1(render_gate 首跑存量 FAIL 三件锚漂移)——用户裁甲清障,本批续接落籍转绿;②S2(golden L2_underdark 越限 2.53%>2%)——停机诊断定位根因为探针抓帧时序缺陷(非视觉回归非平台差异),根因修复+基线换代后三连跑 0.00% 全绿,**容差 2%/16 用户冻结口径未动**(全案见 §2)
|
||||
- **停机点命中两次,均闭环或呈报**:①S1(render_gate 首跑存量 FAIL 三件锚漂移)——用户裁甲清障,本批续接入库转绿;②S2(golden L2_underdark 越限 2.53%>2%)——停机诊断定位根因为探针抓帧时序缺陷(非视觉回归非平台差异),根因修复+基线换代后三连跑 0.00% 全绿,**容差 2%/16 用户冻结口径未动**(全案见 §2)
|
||||
|
||||
---
|
||||
|
||||
## 1. S1 停机点全案(前版立案,本批闭环)
|
||||
|
||||
首跑判定存量红 3 条,全部为 shot_checker B 类对比度断言取样锚漂移(呈现层无缺陷)。**用户 2026-10-08 裁甲清障,三件已全部落籍(提交 a623ec3)**:
|
||||
首跑判定存量红 3 条,全部为 shot_checker B 类对比度断言取样锚漂移(呈现层无缺陷)。**用户 2026-10-08 裁甲清障,三件已全部入库(提交 a623ec3)**:
|
||||
|
||||
| # | 锚漂移 | 裁后落法 | 转绿实证 |
|
||||
|---|---|---|---|
|
||||
@@ -38,14 +38,14 @@
|
||||
| T0 | 基线复读记档+归属核对+环境修正两课(§5 前版) | ✅ |
|
||||
| T1 | `tools/render_gate.sh`+shot_probe 扩屏七屏+board_shot_probe 取证三件套+两辅助件 | ✅(前版) |
|
||||
| T2 | `game/tests/golden/` 三张基线+golden_board_crop.py+golden_baseline_refresh.sh+golden_compare 接线 | ✅(前版;**本批 S2 换代**,触发原因提交说明强制记载) |
|
||||
| S1 | 06-待办清单条目级登记→用户裁甲→三件清障落籍(shot_probe.gd+shot_checker.py,提交 a623ec3) | ✅ 闭环 |
|
||||
| S1 | 06-待办清单条目级登记→用户裁甲→三件清障已入库(shot_probe.gd+shot_checker.py,提交 a623ec3) | ✅ 闭环 |
|
||||
| S2 | board_shot_probe 时制等待+golden 三张换代(提交 3317076) | ✅ 闭环 |
|
||||
| T3 | `tools/probe_gate.sh` --full 段=ui_probe/ui_tune_probe/t17_defer_probe/fx_probe 四探针收编(timeout 120=实测 17.4/49.6/63.0/21.9s 的 2-7×余量;PASS+退出码+残留三闸随骨架);头注「shot_probe 禁入本闸……归真人目检」纪律句删除改写(2026-10-07 用户授权);轻闸默认段零删减零改动(提交 b523f7d) | ✅ |
|
||||
| T3 | `game/smoke/ui_layout_probe.gd` 零断言诊断件补最小布局断言转断言件:1280/1920 两档(基座 1280x800/顶层三区互斥不越界/board_view 含于 D 区/1920 档钉迭代 9 分辨率案甲契约——stretch 下逻辑视口与四区矩形恒定);首跑 PASS 退出码 0;闸归属归卡③裁点②候裁本批不入闸(同提交) | ✅ |
|
||||
| T3/T4 | config_fatal_probe 退役(.gd+.uid——与 run_all config_db_fatal_oob_test 断言面重复,2026-10-02 呈报退役还账)+数据配置.md:205 指路句连带改指+v0.4 版本史行不动(历史记载);damage_probe 头注「诊断工具·非验收件」出一切闸;skill_rhythm_probe/board_stat_probe 头注「分析工具·非验收件」;全仓引用清查零残留(提交 b3404e8) | ✅ |
|
||||
| T4 | tests/README.md 订正:套件数十五→**18**(第 18 套=卡④ `unit/core/fog_lantern_wiring_test` 注名;本分支基点早于卡④合并实测 17 套全绿,合并后 18)+断言数「752+」改**双口径**(运行时=run_smoke 打印〔分支基点 840 项 0 失败;master 合并卡②④后 846〕/静态=smoke 源码 `check(` 764 处——两口径不同各自浮动禁写死)+「十场景探针」去数化;**integration 空壳目录删除**(Q8),章程句并入 tests/README(提交 fcb91ce+57a7919 前笔) | ✅ |
|
||||
| T5 | CLAUDE.md 分级周期口径**重闸定义正式扩容**:自此批末重闸=轻闸+--click+--full+render_gate+run_all+doc 三闸/熵增闸;真人目检仍归用户;MC 仍按触发细则。落点=硬性红线·分级周期口径句(重闸定义在 CLAUDE.md 唯一在册处=需求卡片所称 loop §5)(提交 57a7919) | ✅ |
|
||||
| T6 | 07-体验验证清单 ⑮ **机器补跑半核销注记**(五闸归宿落籍实测绿;真人目检半仍归用户不销号);熵增闸图像白名单收编 game/tests/golden/(T2 落库漏改致红——同批修订 commit 留痕);批末重闸全跑(§4);出口报告本篇;台账 400 | ✅ |
|
||||
| T6 | 07-体验验证清单 ⑮ **机器补跑半核销注记**(五闸归宿已入库实测绿;真人目检半仍归用户不销号);熵增闸图像白名单收编 game/tests/golden/(T2 落库漏改致红——同批修订 commit 留痕);批末重闸全跑(§4);出口报告本篇;台账 400 | ✅ |
|
||||
| T6 | roadmap 迭代 19 行换代:**未动,归主控**——本分支 roadmap 落后 master 多个合并(卡②④已改该行),合并时行冲突重放归主控(goal 既有分工) | ⏭ 移交 |
|
||||
|
||||
## 4. 闸数字(改前/改后全列)
|
||||
@@ -68,7 +68,7 @@
|
||||
|
||||
| hash | message 摘要 |
|
||||
|---|---|
|
||||
| a623ec3 | 卡①锚清障(续)——S1 裁甲三件落籍+render_gate 清障后首跑 shot_checker 全 PASS 实证 |
|
||||
| a623ec3 | 卡①锚清障(续)——S1 裁甲三件已入库+render_gate 清障后首跑 shot_checker 全 PASS 实证 |
|
||||
| 3317076 | 卡①S2 观察项根因修复——board_shot_probe 抓帧时序+golden 三张基线换代(触发原因强制记载) |
|
||||
| b523f7d | 卡①T3——probe_gate --full 四探针收编+头注改写+ui_layout_probe 1280/1920 两档断言 |
|
||||
| b3404e8 | 卡①T3/T4——config_fatal_probe 退役+数据配置.md:205 改指+三件头注标注 |
|
||||
@@ -77,7 +77,7 @@
|
||||
| (台账笔) | 卡①T6——07⑮ 机器补跑半核销注记 |
|
||||
| (本笔) | 卡①T6——熵增闸白名单收编 golden+README 840 订正+出口报告完工终版+台账 400 |
|
||||
|
||||
(过程披露:中途一次 reset 分批重整——git rm 暂存先行混入 T3 提交,soft reset 重新分五批干净落籍;reflog 在案,零改动丢失。)
|
||||
(过程披露:中途一次 reset 分批重整——git rm 暂存先行混入 T3 提交,soft reset 重新分五批干净已入库;reflog 在案,零改动丢失。)
|
||||
|
||||
## 6. 未决移交项
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 迭代 18 四卡实机目检总清单(2026-10-07 交付)
|
||||
|
||||
迭代 18 四卡已全部落籍 master:卡③ 提案批(merge de067ae)/卡⑤ 混编投放批(merge 0dbe3c3)/卡⑦ 种子随机化批(merge b91b973)/卡④ 生涯界面批(本批)。目检归用户逐项过;每节标注详细判据所在的出口报告。目检不阻塞后续开发,但发现的问题按正常缺陷修复流程登记。
|
||||
迭代 18 四卡已全部已合并进 master:卡③ 提案批(merge de067ae)/卡⑤ 混编投放批(merge 0dbe3c3)/卡⑦ 种子随机化批(merge b91b973)/卡④ 生涯界面批(本批)。目检归用户逐项过;每节标注详细判据所在的出口报告。目检不阻塞后续开发,但发现的问题按正常缺陷修复流程登记。
|
||||
|
||||
## 一、卡③ 武器锻造系统设计提案(纯文档批——无实机目检)
|
||||
|
||||
|
||||
@@ -68,4 +68,4 @@
|
||||
|
||||
| 提名 | 提名出处 | 结构前提现状 |
|
||||
|---|---|---|
|
||||
| 商店置换服务「符文重铸」(商店攻击类型转换服务) | 奇物.md P2 后置括注 + 06 二期件组一行(花 GP 重掷攻击类型相关件——商店新交互) | 提名前提是「换型=营地改 `hero.attack_type` 字段」(2026-09-18 营地扩展前置批休眠轴);该预留位已被[武器锻造](../gdd/systems/跨局循环/武器锻造.md)接管——现行口径=当前武器单选出场、类型由武器决定(选长枪=穿刺),局外永久换型渠道已有正主设计。**本服务在武器锻造前提下是否还成立(局内临时重掷 vs 局外选型)、改主角字段还是重掷件、价格与触发点,全部未设计**;重启时先裁与武器锻造的关系 |
|
||||
| 商店置换服务「符文重铸」(商店攻击类型转换服务) | 奇物.md P2 后置括注 + 06 二期件组一行(花 GP 重掷攻击类型相关件——商店新交互) | 提名前提是「换型=营地改 `hero.attack_type` 字段」(2026-09-18 营地扩展前置批休眠轴);该预留位已被[武器锻造](../gdd/systems/跨局循环/武器锻造.md)接管——现行口径=当前武器单选出场、类型由武器决定(选长枪=穿刺),局外永久换型渠道已有权威定义。**本服务在武器锻造前提下是否还成立(局内临时重掷 vs 局外选型)、改主角字段还是重掷件、价格与触发点,全部未设计**;重启时先裁与武器锻造的关系 |
|
||||
@@ -66,7 +66,7 @@
|
||||
|
||||
| # | 事实 | 读数 |
|
||||
|---|---|---|
|
||||
| F15 | 读数义务 A | **T6 MC 四带复算**(初始展开收窄批后置,2026-10-05 落籍时按切分预案挂 07 现行义务):收窄批(剃雷域 r=1 + R₀≤cap 重掷闸)后的四带通关率复算。⚠️ **与 F8 同一测量(v1.2 并账)**:件③「通关率带重扫」与本义务口径同为现行构建四带通关率(balance_verifier 冒险段派生),**一次跑批双认账**,禁两个卡各跑一遍(R3 先推算后重跑)。另:07「现行义务」节尾还有「真人侧读数换 81000 锚补算 k 终值」一段,是否随 T5 履行 T0 呈报定性,禁默认顺延 |
|
||||
| F15 | 读数义务 A | **T6 MC 四带复算**(初始展开收窄批后置,2026-10-05 入库时按切分预案挂 07 现行义务):收窄批(剃雷域 r=1 + R₀≤cap 重掷闸)后的四带通关率复算。⚠️ **与 F8 同一测量(v1.2 并账)**:件③「通关率带重扫」与本义务口径同为现行构建四带通关率(balance_verifier 冒险段派生),**一次跑批双认账**,禁两个卡各跑一遍(R3 先推算后重跑)。另:07「现行义务」节尾还有「真人侧读数换 81000 锚补算 k 终值」一段,是否随 T5 履行 T0 呈报定性,禁默认顺延 |
|
||||
| F16 | 读数义务 B | **T7 技能池节奏重测**(07 现行义务,技能池执行批挂单):≥50 distinct seeds 节奏重测,过涝判读带 = Boss 半血后特殊技密度上探;S2 过涝越带 → 解锁技权重/倍率回调**呈报禁自动调**。⚠️ **判读带换代复核(v1.2 补)**:判读带挂单于 2026-10-05(案C 之前),案C 移动地图伤害兑付时点 → 战斗轮数与 Boss 血量曲线移位 → 「半血后」窗口与密度分母都漂——T7 执行前先复核判读带在案C 新行为下是否仍有权,失权即停机呈报重立带 |
|
||||
| F17 | 顺路修复 | **damage_probe A1 红灯**(`smoke/damage_probe.gd:72`「A1 攻击链健康(fresh 池·掷点口径):非蓄力拍 d_tick = max(下限, 掷点档位基线+附加)」)——判式换代批出口报告 §四.7 在册:**改前既有红**(26374ac 复跑同败,非任何在册批引入),原登记「归独立 mini-loop 处置」,现按用户令编入本批顺路修复 |
|
||||
|
||||
@@ -106,7 +106,7 @@
|
||||
|---|---|---|---|---|
|
||||
| **T0** | 开工:worktree + 基线重测回填 + §2 事实表复核(重点 F1/F7/F11/F17/F19 + 按卡⓪/卡①出口报告重取受影响事实)+ 四件欠账的静态推算稿(每件先给推算结论与建议值区间;**件①含 β 约束下的 magnitude 可行子区间推算**——[60,85] 带有效性复核,v1.2 补)+ 对拍锚按案C 新序重推导(F19) | 1.0d | 冒烟基线 | 推算稿五件齐(含对拍锚按案C 新序重推导+可行子区间)+ 基线回填;推算结论呈用户并**请批跑批计划**(R1/R3) |
|
||||
| **T1** | 件①削弱终值:duration 终值与当量锚复算(推算 → 用户批跑批 → 投值;**投值值非 65 时同步刷新 `tools/clear_dominance_audit.py` WEAKEN_PCT 常量**,v1.2 补)+ 文档四类同步 | 0.75d | 冒烟 | β 带检算行随 commit;工具常量同步或值=65 的说明随 commit;provisional 归出口追认 |
|
||||
| **T2** | 件②数值点评五条逐条裁决呈报(每条:维持/调整 + 依据;调整项推算先行) | 0.75d | 冒烟(动值轮) | 五条全有结论落文(难度曲线与Boss.md 或对应正主文档 + 06 状态行) |
|
||||
| **T2** | 件②数值点评五条逐条裁决呈报(每条:维持/调整 + 依据;调整项推算先行) | 0.75d | 冒烟(动值轮) | 五条全有结论落文(难度曲线与Boss.md 或对应权威文档 + 06 状态行) |
|
||||
| **T3** | 件③联动欠账:钥石产出重标(F7 读数推算 + 现行产出结构对账)+ 通关率带重扫(F8——**与 T5 的 T6 四带复算并账,一次跑批双认账,v1.2**;须用户批跑批) | 1.0d | 冒烟 | ①②两条 06 状态行收口;重扫读数落报告 |
|
||||
| **T4** | 件④定价剩余面:柜台定价数字终值 + Boss 两档终值(推算 → 批跑 → 投值)+ 06 文本滞后句刷新(F11,**两句全刷**——base 句+Boss 两档死数字句) | 0.75d | 冒烟 | meta.tres 终值落 + 四类同步 |
|
||||
| **T5** | 读数义务两件:T6 MC 四带复算(案C 新行为首采——旧锚全作废,新锚自本批立,F19;**与 T3 重扫并账同一次跑批**)+ T7 技能池节奏重测(用户批准后发起,判读带先按 F16 换代复核;可与其他卡窗口期并行等结果) | 0.75d | — | 两份读数报告落 design/qa/;S2 越带按呈报口径处理 |
|
||||
@@ -205,7 +205,7 @@
|
||||
5. design/gdd/07-体验验证清单.md「验收读数重测义务」节(T6/T7 挂单原文)
|
||||
6. design/qa/m4iter14-mineq-exit-report-2026-10-05.md §四.7(damage_probe A1 改前既有红的在册登记)
|
||||
7. design/qa/m4iter14-narrow 相关读数与 design/qa/m3-iter10-clear-rate-readings-2026-10-01.md(重扫基线——仅历史参照,锚已随 F19 作废)
|
||||
8. 06-待办清单「旧行为 MC 行为锚全数作废——重锚归数值批」条(2026-10-06 登记——F19 正主)
|
||||
8. 06-待办清单「旧行为 MC 行为锚全数作废——重锚归数值批」条(2026-10-06 登记——F19 现行事实源)
|
||||
9. game/core/battle_orchestrator.gd 暂存闸 `_defer_board_damage`/`_deferred_board`(案C 实现载体——T6 读数判读前须读案C 批提交 58dfb56 diff)
|
||||
10. tools/clear_dominance_audit.py(β 带/当量锚复算常设工具,:51 WEAKEN_PCT 硬编码——F4b/T1 同步义务载体,v1.2 补)
|
||||
```
|
||||
|
||||
@@ -4,9 +4,9 @@
|
||||
> 性质:实施批需求卡片(零拍板点——八裁全落,本批只做实现;provisional 数值随出口人闸追认)
|
||||
> 裁决事实源:[提案-冒险前资源配比预设-2026-10-04](提案-冒险前资源配比预设-2026-10-04.md) §八备选全列 + §九立项五裁 + §十盘问四裁与自答六件(**唯一裁决源,本需求卡片不复述推导、只引用结论**)
|
||||
> 排位:roadmap 迭代 14 ⑥号卡(2026-10-04 用户令编入);06-待办清单「冒险前资源配比预设(构筑提案)」条(已裁待实施)
|
||||
> **开工门 = ②号卡(判式换代)与③号卡(全局变异首发)出口落籍 master**——理由见 §三
|
||||
> **开工门 = ②号卡(判式换代)与③号卡(全局变异首发)出口已合并进 master**——理由见 §三
|
||||
> 估时:T0-T8 ≈ **6.0 日**(两段切分预案见 §十)
|
||||
> **⚠ 已冻结挂起(2026-10-05 用户令)**:本批移出 roadmap 迭代 14(⑥号卡撤销)——暂不实施,需求卡片冻结保留;06-待办清单同条目转挂起。重启须用户另行发令;届时按届时 master 态重校 §三开工门(②判式换代与③全局变异若已落籍则自动解)。
|
||||
> **⚠ 已冻结挂起(2026-10-05 用户令)**:本批移出 roadmap 迭代 14(⑥号卡撤销)——暂不实施,需求卡片冻结保留;06-待办清单同条目转挂起。重启须用户另行发令;届时按届时 master 态重校 §三开工门(②判式换代与③全局变异若已入库则自动解)。
|
||||
|
||||
---
|
||||
|
||||
@@ -19,7 +19,7 @@
|
||||
| # | 裁决 | 结论一行 |
|
||||
|---|---|---|
|
||||
| P1 | 预算机制 | 组合制:总量挪点(九型正向权重总和恒 77,ΣΔ=0)+ 每型上下限包络 + 容量解锁渐进;gp 首发不可调〔包络 (2,2)〕/预设档 3 套/下限 >0 |
|
||||
| P2 | 主权与验收 | 设计者定包络与默认、玩家包络内分配;验收 = 默认分布锚(现行四带正主读数不动)+ 极端构筑护栏带 |
|
||||
| P2 | 主权与验收 | 设计者定包络与默认、玩家包络内分配;验收 = 默认分布锚(现行四带权威读数不动)+ 极端构筑护栏带 |
|
||||
| P3 | 容量柜台 | 奖励格图鉴承接,**逐型商品**(每型可调权一件、玩家自选解锁顺序) |
|
||||
| P4 | 注入语义 | 差值向量(存相对默认偏移 ΣΔ=0;集合操作只保留在解锁层——可调型集扩容用追加语义) |
|
||||
| P5 | 渠道边界 | 清图槽差异化先行 + 三句不混池口径随批入文(板图分工/配比域封闭/格型无差) |
|
||||
@@ -29,8 +29,8 @@
|
||||
|
||||
## 三、序位与开工门
|
||||
|
||||
- **开工门 = ②③号卡出口**。理由两条:① Q1 合成序的插入位 = ③号卡扩参后的同一摇号投影点(`reward_economy._biased_cell_rows()` 一带,偏运硬币先例)——②③先行落籍使本批只做一次合成层改造,不做二次返工;② 包络数值的定值锚 = ②号新判式当量账(提案 §十自答①)——不在旧账上投值。
|
||||
- 出口读数与②③**分开归因**(roadmap 在册口径);本批 MC off 态对拍锚以②③落籍后的现行锚为基线。
|
||||
- **开工门 = ②③号卡出口**。理由两条:① Q1 合成序的插入位 = ③号卡扩参后的同一摇号投影点(`reward_economy._biased_cell_rows()` 一带,偏运硬币先例)——②③先行入库使本批只做一次合成层改造,不做二次返工;② 包络数值的定值锚 = ②号新判式当量账(提案 §十自答①)——不在旧账上投值。
|
||||
- 出口读数与②③**分开归因**(roadmap 在册口径);本批 MC off 态对拍锚以②③入库后的现行锚为基线。
|
||||
|
||||
## 四、红线(批内零触碰面)
|
||||
|
||||
@@ -42,7 +42,7 @@
|
||||
## 五、任务卡
|
||||
|
||||
### T0 开工三查 + 基线锚确认(0.25d)
|
||||
查前序出口(②③号卡落籍在 master log + 06 状态吻合);查主区脏文件(在飞件标旗不碰);查 ②③ 落籍后的现行 MC off 对拍锚(本批 off 对拍正主,只测不判口径沿用)。**出**:开工闸记录。
|
||||
查前序出口(②③号卡已入库(master log 与 06 状态吻合));查主区脏文件(在飞件标旗不碰);查 ②③ 入库后的现行 MC off 对拍锚(本批 off 对拍权威锚,只测不判口径沿用)。**出**:开工闸记录。
|
||||
|
||||
### T1 配比参数表 schema + registry + provisional 投值(0.5d)
|
||||
新建 `ratio_preset_table`(配比参数表,`data/tables/`):每容量档一行(可调型集合 / 每型包络 [下限,上限] / 预设档位数);九型默认分布引用(=现行 `reward.tres` 正向行权重,**不复制值、引用表**);gp 白名单行(包络 (2,2) 恒定,不上柜台)。数值全部 provisional:包络按②号新判式当量账复算起步(pierce/magic 代价轴最贵 → 包络上界收紧方向),下限统一 2 起步,容量三档排布(一档 2 型可调+窄包络 → 二档 5 型+中包络 → 三档 8 型+全包络,具体归 T7 读数后调)。registry 新条目 + save_file 域登记(配比三档 + 逐型解锁位 + 容量档 + 上次使用档)。**验收**:加载校验(词表成员/包络下限>0/ΣΔ=0 格式校验)通过;白板存档(无解锁无配比)逐位等于现行。
|
||||
@@ -65,7 +65,7 @@
|
||||
### T7 验收闸(1d)
|
||||
冒烟断言批:off 逐位 / 钳制边界 / 锁档 / 解锁门控 / 柜台满购 / ΣΔ 校验拒非法。MC:off 态与 T0 锚逐位对拍;on 态极端构筑代表组(最大化直伤 / 最大化续航 / 最大化经济三组 + 默认对照,N 按现行 MC 纪律二档)——**极端角与默认分布的带差 = 护栏带首批读数**(带值判定归出口人闸,本批只测不判)。行动经济对账按包络复算(总量恒 77,只余分布位移变量)。**停机点 S1**:极端角把现行带打穿且包络收窄不能救 → 停机呈报(见 §七)。
|
||||
|
||||
### T8 文档六正主 + registry + 06 + 出口包(0.5d)
|
||||
### T8 文档六现行事实源 + registry + 06 + 出口包(0.5d)
|
||||
[地图战斗资源](../gdd/systems/战斗循环/地图战斗资源.md)(候选集合节:权重来源 = 表值 × 玩家覆盖合成,Q1 序落文;三句不混池口径入纪律表);[元进度](../gdd/systems/跨局循环/元进度.md)(图鉴柜台职责改写 + 容量商品 + 存档第五件);[冒险结构](../gdd/systems/冒险循环/冒险结构.md)(参数面字段);[难度曲线与Boss](../gdd/systems/冒险循环/难度曲线与Boss.md)(护栏带 + 包络 provisional 行);[HUD 框架](../gdd/systems/表现与支撑/HUD框架.md)(构筑界面槽位 + 视觉终稿后置登记);[行动经济](../gdd/systems/排雷循环/行动经济.md)(对账窗口注记)。registry 全条目。06 状态推进(已裁待实施 → 随批落地状态)。出口包 = 人工检查清单 + provisional 追认清单 + off/on 读数对照。
|
||||
|
||||
## 六、provisional 清单(出口人闸逐项追认)
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# 需求卡片:天赋树实装批
|
||||
|
||||
> 日期:2026-10-11 | 状态:v1.0 待 grilling(待裁点 Q1-Q5 裁决后零待裁开工)
|
||||
> 设计正主:[天赋树](../gdd/systems/跨局循环/天赋树.md) v0.2(2026-10-11 设计会话终裁,零设计待裁点)
|
||||
> 设计权威文档:[天赋树](../gdd/systems/跨局循环/天赋树.md) v0.2(2026-10-11 设计会话终裁,零设计待裁点)
|
||||
> 在册条目:[06-待办清单](../gdd/06-待办清单.md)「天赋树实装批」(原「已建未接面两件」+「结构重构批」合并条)
|
||||
> 关联批:「武器锻造系统实装批」(共用面,时序见 Q5)|「秘宝体系实现重构落地批」(槽位定序点)
|
||||
|
||||
@@ -11,7 +11,7 @@
|
||||
|
||||
- `meta_tree.tres` 29 节点过 schema 零违例;树上购买面(四件套+等级阈值前置)可玩。
|
||||
- 营地打开即树:属性唯一入口=树淬炼;锻造工坊/秘宝匣两把钥匙展开工作间;图鉴常开;旧属性锻造柜台购买面退役。
|
||||
- 三组 Fork 两侧各挂真效果(六规则键),开局窗/限次语义按设计正主生效。
|
||||
- 三组 Fork 两侧各挂真效果(六规则键),开局窗/限次语义按设计权威文档生效。
|
||||
- 注入公式换代(基础值+树淬炼+锻造路线加值+局内加算);旧柜台 flat 项退役移除。
|
||||
- 存档迁移重做(forge_levels→脊柱线,零亏损幂等);同调位槽位判定源收编树节点;树上刷新升级写同账。
|
||||
- 验证闸全绿(§7)。
|
||||
@@ -70,12 +70,12 @@
|
||||
| active.md | 状态记录随批记账 | **机械面**随批更新 |
|
||||
| design/gdd/06-待办清单.md | 本批条目状态随批推进 | **机械面**随批更新 |
|
||||
| game/README.md | 营地/柜台描述句(如有)随实态换 | **机械面**随批核对 |
|
||||
| design/gdd/systems/跨局循环/天赋树.md | 「已建未接面」三条清账;P0 段 33→29 落地态;验收实态 | **设计正主**=反哺点(收口呈报,用户裁决后另批落文) |
|
||||
| design/gdd/systems/跨局循环/元进度.md | 注入公式终态句;属性柜台退役终态(v1.14 已预登记过渡态) | **设计正主**=反哺点 |
|
||||
| design/gdd/systems/排雷循环/秘宝.md | 同调位判定源终态(谓词表→树节点);谓词表去留随 Q2 | **设计正主**=反哺点 |
|
||||
| design/gdd/systems/跨局循环/武器锻造.md | 「树侧解锁门」接线落地态;注入公式「锻造路线加值」项落地态 | **设计正主**=反哺点 |
|
||||
| design/gdd/systems/表现与支撑/存档序列化.md | 迁移规则重做终态(forge_levels→脊柱线映射+版本注记) | **设计正主**=反哺点 |
|
||||
| design/gdd/systems/表现与支撑/HUD框架.md | 树=营地主界面结构终态 | **设计正主**=反哺点(视觉终稿另批) |
|
||||
| design/gdd/systems/跨局循环/天赋树.md | 「已建未接面」三条清账;P0 段 33→29 落地态;验收实态 | **设计权威文档**=反哺点(收口呈报,用户裁决后另批落文) |
|
||||
| design/gdd/systems/跨局循环/元进度.md | 注入公式终态句;属性柜台退役终态(v1.14 已预登记过渡态) | **设计权威文档**=反哺点 |
|
||||
| design/gdd/systems/排雷循环/秘宝.md | 同调位判定源终态(谓词表→树节点);谓词表去留随 Q2 | **设计权威文档**=反哺点 |
|
||||
| design/gdd/systems/跨局循环/武器锻造.md | 「树侧解锁门」接线落地态;注入公式「锻造路线加值」项落地态 | **设计权威文档**=反哺点 |
|
||||
| design/gdd/systems/表现与支撑/存档序列化.md | 迁移规则重做终态(forge_levels→脊柱线映射+版本注记) | **设计权威文档**=反哺点 |
|
||||
| design/gdd/systems/表现与支撑/HUD框架.md | 树=营地主界面结构终态 | **设计权威文档**=反哺点(视觉终稿另批) |
|
||||
|
||||
## 6. 任务卡
|
||||
|
||||
|
||||
+23
-23
@@ -11,14 +11,14 @@
|
||||
| 2026-09-15 ~ 09-16 | 切片数值语言定型:格面资源批、加法核数值语言拍板、护甲等级掷点批落地(smoke 233)、AP6+AC 验收判读口径 v1.0、06-待办清单建账改版 |
|
||||
| 2026-09-17 ~ 09-19 | 切片机制完备:敌人技能池批落地(smoke 263)、关卡节点地图 v1.0 定稿+分支图批、加法核 80 遍试玩基线、无伤通关根因批(AP 压速)、验收读数重测批、掷点流种子偏置修复 A+B、插旗不可逆批、worktree 铁律立规 |
|
||||
| 2026-09-20 ~ 09-21 | **一局完整冒险闭合**:冒险结构实现批(三关正式序列,smoke 482)、GP+商店房批(smoke 437)、存档序列化批(smoke 518)、元进度实现批(跨局循环闭合,smoke 549)、第三关内容批、八型批 |
|
||||
| 2026-09-22 | Package B 七轮数值批+成长对齿落籍(用户拍板接受 B 曲线);美术圣经 §6–9 全章成文(v2.0);balance-verifier 数值验证工具批;美术文档过期账清偿批 |
|
||||
| 2026-09-22 | Package B 七轮数值批+成长对齿已入库(用户拍板接受 B 曲线);美术圣经 §6–9 全章成文(v2.0);balance-verifier 数值验证工具批;美术文档过期账清偿批 |
|
||||
| 2026-09-23 | 换算率标定批(6/9/1+护甲断链修复);停点前移批实施(关卡开局即出图+三区化+LevelStripView 退役);UI 复用候选批 |
|
||||
| 2026-09-24 | **垂直切片转正(prototypes/ → game/)**;棋盘 Node2D 迁移 Phase A(BoardView 五层叠序);伤害管线单据化(DamageController 唯一管线);棋盘立体中档定稿冻结;状态图标接入 |
|
||||
| 2026-09-25 | 棋盘小人贴图系列五批(1.5× 档+脚锚自底边+椭圆影);AI 生图退出角色资产管线(定位=上游草稿引擎);生图直出像素网格调研双报告 |
|
||||
| 2026-09-26 | **战斗舞台 Node2D 迁移 Phase B(循环 1 收口,MC 逐位对拍零漂移)**;高墙瓦片 v9.3 定稿+换肤批(格面瓦片/敌像槽/接触带微光接线);封印紫批;UX 文档欠账处置(level-clear 建档);GP 归属拍板对齐;目录三层收敛大重构(design/artwork/game+熵增闸前身) |
|
||||
| 2026-09-27 | 熵增闸落籍(repo_structure_audit 四查);单元测试与契约层补建登记 P0;UX 文档面三 spec 齐(battle 欠账处置 / level-clear / level-map 三拍板收口);关卡节点图生成 v0.1→v0.4 立项落文+ADR-0007 评估→用户裁丙→**统一随机流批落地(七流并一+全事件日志,329c7a2,状态记录 210)**;**roadmap 重整为批次执行制(本批,状态记录 208)** |
|
||||
| 2026-09-28 | **M-1 切片表现收口完成(迭代 1+2 落籍,初步验收通过)**:样张 v2 机检 16/16 四冻结(art-bible v2.13)/框材组 8 件换皮/演出密度终稿/棋盘数字终稿/关卡画面三拍板实装/单元九套件/瓦片换色两套;同日**关卡画面独立化立项 M-2 高优先级**(用户裁决独立屏为最终形态,本批) |
|
||||
| 2026-09-28 | **M-2 关卡画面独立化完成(迭代 3+4 落籍,出口闸目检通过)**:独立屏 LevelMapScreen+独立性断言(状态记录 224)/关卡画面样张 v1 机检 11/11 冻结+节点图标组接线+终稿落码+换层挂点(art-bible v2.14,状态记录 225);出口检查单 `design/qa/m2-exit-gate-checklist-2026-09-28.md` 用户八项目检通过(状态记录 227) |
|
||||
| 2026-09-27 | 熵增闸已入库(repo_structure_audit 四查);单元测试与契约层补建登记 P0;UX 文档面三 spec 齐(battle 欠账处置 / level-clear / level-map 三拍板收口);关卡节点图生成 v0.1→v0.4 立项落文+ADR-0007 评估→用户裁丙→**统一随机流批落地(七流并一+全事件日志,329c7a2,状态记录 210)**;**roadmap 重整为批次执行制(本批,状态记录 208)** |
|
||||
| 2026-09-28 | **M-1 切片表现收口完成(迭代 1+2 已入库,初步验收通过)**:样张 v2 机检 16/16 四冻结(art-bible v2.13)/框材组 8 件换皮/演出密度终稿/棋盘数字终稿/关卡画面三拍板实装/单元九套件/瓦片换色两套;同日**关卡画面独立化立项 M-2 高优先级**(用户裁决独立屏为最终形态,本批) |
|
||||
| 2026-09-28 | **M-2 关卡画面独立化完成(迭代 3+4 已入库,出口闸目检通过)**:独立屏 LevelMapScreen+独立性断言(状态记录 224)/关卡画面样张 v1 机检 11/11 冻结+节点图标组接线+终稿落码+换层挂点(art-bible v2.14,状态记录 225);出口检查单 `design/qa/m2-exit-gate-checklist-2026-09-28.md` 用户八项目检通过(状态记录 227) |
|
||||
| 2026-09-29 | **迭代重排(用户裁决「内容逻辑闭环先于验收」)**:M-3 更名「数值标定与 Alpha 创建」——战斗演出完善前移迭代 6、魔法道具+元进度标定编入迭代 7、Alpha 验收后移迭代 8;M-4 转 Alpha 后深化与内容扩展(本批,状态记录 242) |
|
||||
|
||||
## 当前位置(2026-09-29)
|
||||
@@ -34,11 +34,11 @@
|
||||
|
||||
### M-1 切片表现收口(Release 1)
|
||||
|
||||
**✅ 完成(2026-09-28 初步验收通过)**——迭代 1「测试兜底与表现先行」(六卡)+ 迭代 2「样张冻结与表现定稿」(五批次)落籍,出口检查真人目检过。明细归 git 历史 + 出口检查单 `design/qa/m1-exit-gate-checklist-2026-09-28.md` + active.md 状态记录 215-222。
|
||||
**✅ 完成(2026-09-28 初步验收通过)**——迭代 1「测试兜底与表现先行」(六卡)+ 迭代 2「样张冻结与表现定稿」(五批次)已入库,出口检查真人目检过。明细归 git 历史 + 出口检查单 `design/qa/m1-exit-gate-checklist-2026-09-28.md` + active.md 状态记录 215-222。
|
||||
|
||||
### M-2 关卡画面独立化(Release 2)
|
||||
|
||||
**✅ 完成(2026-09-28 出口闸通过)**——迭代 3「独立屏架构」(四批次)+ 迭代 4「关卡画面视觉终稿」(五批次)落籍,出口检查真人目检八项全过。明细归 git 历史 + 出口检查单 `design/qa/m2-exit-gate-checklist-2026-09-28.md` + active.md 状态记录 224-225。
|
||||
**✅ 完成(2026-09-28 出口闸通过)**——迭代 3「独立屏架构」(四批次)+ 迭代 4「关卡画面视觉终稿」(五批次)已入库,出口检查真人目检八项全过。明细归 git 历史 + 出口检查单 `design/qa/m2-exit-gate-checklist-2026-09-28.md` + active.md 状态记录 224-225。
|
||||
|
||||
### M-3 数值标定与 Alpha 创建(Release 3,**已关闭 2026-10-03——迭代 9 出口闸过、Alpha 到手**;2026-10-09 口径换代注:「已关闭」系旧口径=Alpha 验收到手,新口径 M3=Alpha 完整实现仍在进行——见 M-4 节头立规注)
|
||||
|
||||
@@ -46,36 +46,36 @@
|
||||
|
||||
| # | 迭代 | 门(进入条件) | 更改任务 |
|
||||
|---|---|---|---|
|
||||
| 迭代 5 | 读数重测与调参(原迭代 3) | M-2 出口闸;⑤号卡另需 ADR-0007 裁决(已裁丙落地) | ——**✅ 完成(2026-09-28 五卡落籍)**:基线重测〔三越带初判〕+杠杆扫描〔C3 组合锁值:岩浆1/plb0/percent4/卓尔100〕+AC 投值〔Boss-only 台阶 8/9/12〕+节点图生成特性批〔15 骨架+node_map 扩签+首次冒险脚本,冒烟 557→576〕;读数挂账〔完美 L1 丙·普通 L2 17.1% AC〕归出口人闸追认;明细=迭代 5 状态记录 230-241+design/qa 三报告。**2026-09-29 返工批**(U2 人闸三推翻两追认+目检 15/15 不过,状态记录 246/247):C1 两刀终态+AC v1 硬梯度重投+节点图池两规则重生成〔L1 前三位纯战斗/L2L3 层宽 4-5,模板 0 随重排〕——终态双窗读数〔普通 L1 ✓·普通 L2 10.6/13.6% ✗·完美 L1 84% 甲挂账→荆棘外延提案待批·完美 L2 22/32% ✗〕,缺口数字待批点丙追认;二轮目检=返工批出口人闸;**2026-09-30 出口三件全闭(收口批 fe520af/合并 3933723+补丁批,状态记录 290)**——①二轮目检 15/15 过(T-C 过闸)②普通 L2 带改 [10,15]+批点丙追认成立(10.6/13.6% 落带,组合基线转正;完美 L2 22/32% 越带用户整体表态知情接受、带不动)③荆棘外延提案否决→根因改判「战斗阶段数值问题」06 待讨论——**迭代 5 返工出口成立** |
|
||||
| 迭代 5 | 读数重测与调参(原迭代 3) | M-2 出口闸;⑤号卡另需 ADR-0007 裁决(已裁丙落地) | ——**✅ 完成(2026-09-28 五卡已入库)**:基线重测〔三越带初判〕+杠杆扫描〔C3 组合锁值:岩浆1/plb0/percent4/卓尔100〕+AC 投值〔Boss-only 台阶 8/9/12〕+节点图生成特性批〔15 骨架+node_map 扩签+首次冒险脚本,冒烟 557→576〕;读数挂账〔完美 L1 丙·普通 L2 17.1% AC〕归出口人闸追认;明细=迭代 5 状态记录 230-241+design/qa 三报告。**2026-09-29 返工批**(U2 人闸三推翻两追认+目检 15/15 不过,状态记录 246/247):C1 两刀终态+AC v1 硬梯度重投+节点图池两规则重生成〔L1 前三位纯战斗/L2L3 层宽 4-5,模板 0 随重排〕——终态双窗读数〔普通 L1 ✓·普通 L2 10.6/13.6% ✗·完美 L1 84% 甲挂账→荆棘外延提案待批·完美 L2 22/32% ✗〕,缺口数字待批点丙追认;二轮目检=返工批出口人闸;**2026-09-30 出口三件全闭(收口批 fe520af/合并 3933723+补丁批,状态记录 290)**——①二轮目检 15/15 过(T-C 过闸)②普通 L2 带改 [10,15]+批点丙追认成立(10.6/13.6% 落带,组合基线转正;完美 L2 22/32% 越带用户整体表态知情接受、带不动)③荆棘外延提案否决→根因改判「战斗阶段数值问题」06 待讨论——**迭代 5 返工出口成立** |
|
||||
| 迭代 6 | 战斗演出完善(原 M-4 迭代 7,2026-09-29 前移;2026-09-28 用户立项,收编历史登记「战斗表现批」——状态记录 106「真实立绘/动画密度终稿归战斗表现批」,前置 P0 样张已随 M-1 解除) | 迭代 5 出口(已解) | ①资产管线正式化:pixelfixer 网格段+封闭灰袋清除并入 `tools/pixelize_candidates.py`(--fixer)+九张 48px 站桩槽位档生成(8 敌种+主角 normal,底中锚/NEAREST)②敌种立绘落位:按 `ui_kit.gd` TEX_ENEMY_* 常量名入 `game/assets/art/character/`,字形「敌」回退退役,目检 ③主角 portrait 替换(新 normal 态)+attack/hit 两态素材入包(命名/路径随计划书定)④主角三态切换挂事件:攻击演出→attack 态/受击→hit 态/回 idle,槽位 2× 整数放大适配 ⑤命中特效密度终稿:命中瞬间打击特效(状态记录 106 动画密度欠账清偿)⑥受击白光/演出链复核:弹道→闪白→血条→灰化全链+flash_hit 强度时长 ⑦fx_probe 断言扩充+轻闸接线 ⑧用户实机目检清单(战斗演出专项,本迭代人闸);**2026-09-29 全流程审计追加四件(用户裁定归本迭代,状态记录 243)**:⑨终局面板「明细回看」z 序修复(main.gd:361 绕模态栈直开,回看层登记序在终局层下、被全屏遮罩压死——改走 _open_modal+ui_click_probe 补终局入口断言)⑩GP 冒险收束呈现(adventure_runner.gd:231 清零前,冒险终局面板补「本局 GP 入账」行,兑现 ui_assembler.gd:52 双展示位承诺)⑪主角受击反馈+死亡演出(敌→主角伤害弹道 main.gd:505 直接 return、无白光——补弹道+flash_hit,死亡补专属演出,与敌方演出密度对等)⑫flat_damage 变异格视觉标记(tex_mutation 槽恒空、数字照常显示——接变异纹理或角标,可归因)。**T0 注(2026-09-29 裁定)**:美术素材不入 git 维持,`game/assets/art/` 目录补 .gitignore(现行素材在盘不入库,缺位走字形回退;素材移交方式=用户放盘,打包发布方案随 Alpha 前另议);**2026-09-29 落地**:T0-T8 十轮全落(worktree m3-iter6-20260929,状态记录 247-255)——卡①-⑫全兑现+审计四件;重闸全绿(冒烟 576/0+五探针+doc 三闸/熵增零新增+素材机检 11/11+MC 对拍 400/400 逐位一致〔锚已重锚 HEAD,原迭代 5 锚过期〕);**出口人闸=T9 目检进行中**(检查单+代拍板追认五项=git 提交 8e74483(检查单已按生命周期条款退役),素材移交口径更新=八敌+主角三态已管线自产落盘用户无需放盘);**已完成(2026-09-29 用户 U2 目检过闸,状态记录 256)**——迭代 6 出口成立,迭代 7 门解 |
|
||||
| 迭代 7 | 魔法道具内容+元进度数值标定(原迭代 8+ 前两项编入) | 迭代 6 出口 | node-reward spec 随批出生+C 区道具槽接线+魔法道具内容(奖励节点空占位 node_overlay.gd:36 由本迭代兑现,营地工坊六件死解锁同批接局内效果);换算率复核/柜台定价标定;批末复跑 verifier 关键带(新力量源入局读数漂移属预期,破带才回调);**2026-09-29 落地**:T0-T8 八卡全落(worktree m3-iter7-20260929,状态记录 259-263)——八拍板点裁决落锁(①乙罗盘退役/②丙三选一/③甲解锁进投放池/④甲封存呈现/⑤甲两步交互/⑥甲三件 10/池 88/⑦⑧读数后裁与只测不判);重闸=冒烟 577/0+五探针+单测 12 套(含 aux 三新套件)+doc 三闸/熵增零新增+素材机检 11/11+MC 剥 additive 字段 0/400 逐位(门控空集=夹具态零投放零扰动);verifier 换算率复核读数出讫(生命 6→实测 1.7/攻击 9→4.1/护甲 1→0.0——U1 呈报待裁);**已完成(2026-09-29 用户 U2 目检过闸——七项目检过+追认五项全认+T5-hotfix 实机复验;状态记录 267)**——迭代 7 出口成立,迭代 8 门解 |
|
||||
| 迭代 8 | 冒险续玩断点+设置面+打磨包(2026-09-29 立项:用户裁「中断可续玩/退出即结算」两口径分离+审计 #5#6 随移;**同日二批:真人试玩反馈三件编入+排布与选型已追认**〔2026-09-29 用户拍板:雷当量甲·直伤当量抬升/胜利总结结算接线按既有拍板面/轮间节奏甲·演出层排播队列,三件全编本迭代——计划书 `.zcode/plans/m3-iter8-loop-plan-2026-09-29.md`〕) | 迭代 7 出口 | ①run 快照序列化:停点粒度断点(关卡序号/节点位/生命/本关加成区/GP 钱包/商店已购档/已抽模板),入 save.json 新域+schema 版本迁移;战斗中中断不存棋盘中局,续玩恢复至最近停点、当场战斗从头打 ②开始菜单「继续上局」按钮(存在断点才亮起;续玩与新冒险互斥确认)③中断/退出口径分离:中断=关游戏留断点可续;退出冒险=现行放弃流程(失败结算+清除断点)④最小设置面(音量/全屏/退出按钮/减动效开关从测试调整板转正+调试入口门控)⑤打磨包(RAP 与九徽章图例解码入 legend、封印旗纹理落位退役文字占位、放弃按钮文案收敛至 level-map 4 字上限、判定文案两处措辞统一)⑥**战斗胜利总结结算接线**(冒险模式普通战斗胜利挂 BattleEndOverlay 胜利形态:金蜡封+GP 增量+总量+判定行+「下一节点」——battle.md OQ14 已拍板面接线,Boss/失败分支不动;06「战斗胜利总结结算接线」条目)⑦**轮间结算节奏化**(演出层排播队列:结算行按段分组阶梯延迟进明细带+轮切换「第 N 轮」横幅驻留——核心层零 await 契约与 MC 对拍不破、减动效开=延迟归零横幅静态化,与卡④减动效开关联动;06「轮间结算节奏化」条目)⑧**危险格负向当量抬升**(直伤三行 power 抬档投值+挖掘风险不等式对账复跑+通关率双窗复测;前置=普通 L2 缺口数字批点丙追认;06「危险格负向当量抬升」条目)⑨冒烟/探针断言:断点写读往返、续玩幂等、退出清断点、无断点时按钮隐藏+卡⑥结算框呈现断言+卡⑦节奏断言(减动效双态)⑩实机目检人闸(中断重开续玩全流程+战后结算框+轮间节奏);**2026-09-29 落地(T0-T10 全落,worktree m3-iter8-20260929 六批次,状态记录 274-277+280,合并 77cc727)**:断点域 save v2(七字段+附随件,续玩确定性 400 局对拍零扰动)+继续上局/互斥确认/退出口径分离+最小设置面(减动效转正/DS_DEBUG 门控)+打磨包三件一降级(旗纹理缺盘 06 债务)+战斗胜利总结结算框+轮间排播队列与轮横幅(核心层零 await 零触碰,pacing_queue_test 第 15 套)+雷当量 4/5/5 provisional(MC 完美档读数逐位不动=只打踩雷轴反证;**普通 L2 7.9% 缺口加深四选一待裁**)+人闸三件交付=git 提交 d70f6c3(检查单已按生命周期条款退役);**已完成(2026-09-29 用户三轮目检过闸,状态记录 287)**——迭代 8 出口成立,迭代 9 门解(T7 数值四选一用户裁决挂起自行探讨,表值维持 4/5/5) |
|
||||
| 迭代 9 | **视觉规格落码 + Alpha 验收**(2026-09-29 用户验收样张新 v3.5 并立项插入:美术圣经 v3.0 中修+方向稿收敛后的落码批为 Alpha 验收前置——验收对象应是视觉完整版本;需求卡片已退役(git 710f9b7 出口批);**2026-09-30 用户扩编**:呈现欠账四件+样张闸同窗件全编入〔06 在册欠账清偿,状态记录 288〕) | 迭代 8 出口 | **前置卡组·视觉落码**(需求卡片批 A+批 B):⓪批 A 机检冻结(断言定值+产物转正+圣经 v3.1 记录,人闸已由 2026-09-29 方向稿验收豁免)①棋盘渲染落码(E 格高墙 30%/连接无边框/地板归一 L0.10)②数字承载切换(亮墨三档直画+色牌后备)③ui_kit 对比度修复(现行 4 处不达标+字号 16/14)④B 区舞台(暗背景+地台落影+顶光柱)⑤整屏样张闸首跑(四屏断言;**随闸三裁决**=1920 档缩放策略对照/动画帧数规格/资产升档与否〔06「美术资产规格两项」「资产升档重产批」两欠账随闸呈,裁升档→主角三态+八敌种重产转加卡〕)⑥探针与冒烟重闸;**扩编卡组·呈现欠账**(2026-09-30 用户拍板第一/二档全编):⑪关卡画面 GP 常驻徽章接线(level-map spec 顶栏徽章,纯呈现欠账——06「GP/钥石迁出展示面接线」剩余面)⑫C 区「本关强化列表」数据接线(壳已落,set_level_bonuses→runner 加算区投影)⑬封印旗纹理自产+tex_flag 接线(迭代 8 卡⑤降级债务清偿,程序槽位零改码)⑭营地界面视觉终稿(解锁界面剩余面,前置=本迭代样张闸过审)⑮分辨率档位与格边长落码+HUD 框架「两档定值 36/45px」条款修订(1280×800/1920×1080 已定案)⑯art-bible §8.2 缩放纪律分级修订落文(甲文本/乙角色两类,圣经 v3.0 落籍窗口已开)⑰B 档视口截图像素断言试点+C 档黄金图基准建立(测试分级批同窗件,C 档后置于⑤冻结);**Alpha 验收(原卡组不变)**:⑦draw calls 真机测量(270→<200)⑧真人目检清单总清 ⑨07-体验验证清单总对账 ⑩真人通关率标定(真人 k 补跑并入)。**代排待追认**:卡数超 8 卡上限,计划书按「视觉落码段(⓪-⑥+⑪-⑰)→ Alpha 验收段(⑦-⑩)」两段组织、一次合并,段排布随计划书 U0 追认;呈现/文档卡全不扰卡⑩真人读数(数值/内容面不编入本迭代,归 M-4)。**⚠ 2026-10-01 用户否决迭代 9 标完成(数值轴)**:真人实证推翻模拟尺(旧普通档=新手画像弱真人 20 倍/完美档非元游戏上界)——数值修复批落籍(数字可读甲案+模拟档位重构+数值三刀,报告 design/qa/numfix-newruler-readings-2026-10-01.md)后**迭代 9 维持未过闸,卡用户实机验收新数值+新带值拍板**;全旧带读数作废待新尺重锚;**✅ 完成(2026-10-03 出口闸过,状态记录 315)**:9B Alpha 验收段收口——T17 36 项全判(13✅/35 两处修复/32 环境限制)+T16 修复批 11 件全落(硬锁 v3.1/演播后排窗/出度≤2/掉落渠道退役等)+T19 真人批佐证级收口(有效局 2 用户裁+k=0.60 落 >0.5 带内)+带值四带甲案落正主(A[0,10]/B[50,85]/C[30,60] 预立/D 响应曲线 ≤15pp·S 形,旧三带作废)+81000 锚(非数值验证——k 源+出度重建位移存档)+06 draw calls 销号(504→196)+stage.txt 换代;批末闸=冒烟 636/0+run_all 15 套+探针 4/5 绿(click_probe 已知红挂 06 专项)。**出口检查单=design/qa/m3-iter9-exit-checklist-2026-10-03.md**——**迭代 9 出口成立、M-3 关闭、Alpha 到手、M-4 门解** |
|
||||
| 迭代 10 | **奖励结构重构——通关三选一 + 钥石掉落挪转 + 精英怪立项预留 + 通关部分回血**(2026-09-30 用户拍板案丙+P-A~P-E,计划书=`.zcode/plans/m3-iter10-loop-plan-2026-09-30.md`;**2026-10-01 用户提前开工拍板**:不合入 master、渲染层验证冻结——T0 开工门改规随批追认) | 迭代 9 出口(**改规注记**:Alpha 验收未过闸,用户拍板提前并行开工——并行安全性由「不合入」保证,master 读数面零污染) | **T0-T10+追加批全落**(worktree m3-iter10-20261001,10 提交 34dd8de→7f5caa3):①大奖励三件套退役改三层框架——部分回血 20%(clear_heal_pct)+提升三选一(池六种加权洗牌 E-S 不放回/reward_pick 扩签/属性件上限 3·AP 件上限 2 达上限剔牌库/选择停点零自动推进可中断)②加算区四轴+行动点(AP 件每战首轮 +1,排队通道兑现;行动经济.md 失同步清偿 AP 6→8)③钥石退役出大奖励改 Boss/精英逐杀掉落(boss_keystone 重锚首杀 3/复杀 2/2/3——a 裁备选;末关照常入账;收束无二次派生)④同调位过渡承载(transitional_sync_slots=1;三选一面替换子交互两路/战斗内沉没;正主归同调实施批)⑤**奖励节点共享池**(追加批用户拍板——与通关三选一同池同权重同上限,node-reward.md v2.1 掷定前置卡片直显具体道具)⑥断点 save v3(奖励选择态+件计数+aux_detail;v1/v2→v3 semver 兼容断言——g 裁)⑦BonusPickOverlay 共用面+目检修复批(候选一致降级为现状注记);**裁决面**:七项代拍板全裁(a 用备选/b-f 认同/g semver)+e 白话追认;**实机目检一轮**:1/3/4/5/6/9/14 PASS(8 项根因=减动效开关遗留已翻回;2/12 延后同调批;逐行结算演出定性迭代 8 事项不追);**合并 master 数值修复批**(bc737fb 解 2 冲突——autoplay 注释双留/smoke_all 取新断言+模拟档购血容差窗)后冒烟 628/0+run_all 15 套+五探针+三闸零新增(死链 4=存量;master 新引 1 条环境死链已修)+熵增 PASS;**MC 四代锚** 77000/78000/79000/80000 各 400 局(普通 L1 41.8%/L2 10.2% 带内、完美 L1 86.5%/L2 15.6%、钥石 1.38/3.01——报告 design/qa/m3-iter10-clear-rate-readings-2026-10-01.md);**人工参与项入 07 清单⑩**;**已完成(2026-10-01 开发闭合)**——迭代 11 门解(M-3 内顺延),Alpha 总闸仍卡迭代 9 数值实机验收 |
|
||||
| 迭代 9 | **视觉规格落码 + Alpha 验收**(2026-09-29 用户验收样张新 v3.5 并立项插入:美术圣经 v3.0 中修+方向稿收敛后的落码批为 Alpha 验收前置——验收对象应是视觉完整版本;需求卡片已退役(git 710f9b7 出口批);**2026-09-30 用户扩编**:呈现欠账四件+样张闸同窗件全编入〔06 在册欠账清偿,状态记录 288〕) | 迭代 8 出口 | **前置卡组·视觉落码**(需求卡片批 A+批 B):⓪批 A 机检冻结(断言定值+产物转正+圣经 v3.1 记录,人闸已由 2026-09-29 方向稿验收豁免)①棋盘渲染落码(E 格高墙 30%/连接无边框/地板归一 L0.10)②数字承载切换(亮墨三档直画+色牌后备)③ui_kit 对比度修复(现行 4 处不达标+字号 16/14)④B 区舞台(暗背景+地台落影+顶光柱)⑤整屏样张闸首跑(四屏断言;**随闸三裁决**=1920 档缩放策略对照/动画帧数规格/资产升档与否〔06「美术资产规格两项」「资产升档重产批」两欠账随闸呈,裁升档→主角三态+八敌种重产转加卡〕)⑥探针与冒烟重闸;**扩编卡组·呈现欠账**(2026-09-30 用户拍板第一/二档全编):⑪关卡画面 GP 常驻徽章接线(level-map spec 顶栏徽章,纯呈现欠账——06「GP/钥石迁出展示面接线」剩余面)⑫C 区「本关强化列表」数据接线(壳已落,set_level_bonuses→runner 加算区投影)⑬封印旗纹理自产+tex_flag 接线(迭代 8 卡⑤降级债务清偿,程序槽位零改码)⑭营地界面视觉终稿(解锁界面剩余面,前置=本迭代样张闸过审)⑮分辨率档位与格边长落码+HUD 框架「两档定值 36/45px」条款修订(1280×800/1920×1080 已定案)⑯art-bible §8.2 缩放纪律分级修订落文(甲文本/乙角色两类,圣经 v3.0 入库窗口已开)⑰B 档视口截图像素断言试点+C 档黄金图基准建立(测试分级批同窗件,C 档后置于⑤冻结);**Alpha 验收(原卡组不变)**:⑦draw calls 真机测量(270→<200)⑧真人目检清单总清 ⑨07-体验验证清单总对账 ⑩真人通关率标定(真人 k 补跑并入)。**代排待追认**:卡数超 8 卡上限,计划书按「视觉落码段(⓪-⑥+⑪-⑰)→ Alpha 验收段(⑦-⑩)」两段组织、一次合并,段排布随计划书 U0 追认;呈现/文档卡全不扰卡⑩真人读数(数值/内容面不编入本迭代,归 M-4)。**⚠ 2026-10-01 用户否决迭代 9 标完成(数值轴)**:真人实证推翻模拟尺(旧普通档=新手画像弱真人 20 倍/完美档非元游戏上界)——数值修复批已入库(数字可读甲案+模拟档位重构+数值三刀,报告 design/qa/numfix-newruler-readings-2026-10-01.md)后**迭代 9 维持未过闸,卡用户实机验收新数值+新带值拍板**;全旧带读数作废待新尺重锚;**✅ 完成(2026-10-03 出口闸过,状态记录 315)**:9B Alpha 验收段收口——T17 36 项全判(13✅/35 两处修复/32 环境限制)+T16 修复批 11 件全落(硬锁 v3.1/演播后排窗/出度≤2/掉落渠道退役等)+T19 真人批佐证级收口(有效局 2 用户裁+k=0.60 落 >0.5 带内)+带值四带甲案落现行事实源(A[0,10]/B[50,85]/C[30,60] 预立/D 响应曲线 ≤15pp·S 形,旧三带作废)+81000 锚(非数值验证——k 源+出度重建位移存档)+06 draw calls 销号(504→196)+stage.txt 换代;批末闸=冒烟 636/0+run_all 15 套+探针 4/5 绿(click_probe 已知红挂 06 专项)。**出口检查单=design/qa/m3-iter9-exit-checklist-2026-10-03.md**——**迭代 9 出口成立、M-3 关闭、Alpha 到手、M-4 门解** |
|
||||
| 迭代 10 | **奖励结构重构——通关三选一 + 钥石掉落挪转 + 精英怪立项预留 + 通关部分回血**(2026-09-30 用户拍板案丙+P-A~P-E,计划书=`.zcode/plans/m3-iter10-loop-plan-2026-09-30.md`;**2026-10-01 用户提前开工拍板**:不合入 master、渲染层验证冻结——T0 开工门改规随批追认) | 迭代 9 出口(**改规注记**:Alpha 验收未过闸,用户拍板提前并行开工——并行安全性由「不合入」保证,master 读数面零污染) | **T0-T10+追加批全落**(worktree m3-iter10-20261001,10 提交 34dd8de→7f5caa3):①大奖励三件套退役改三层框架——部分回血 20%(clear_heal_pct)+提升三选一(池六种加权洗牌 E-S 不放回/reward_pick 扩签/属性件上限 3·AP 件上限 2 达上限剔牌库/选择停点零自动推进可中断)②加算区四轴+行动点(AP 件每战首轮 +1,排队通道兑现;行动经济.md 失同步清偿 AP 6→8)③钥石退役出大奖励改 Boss/精英逐杀掉落(boss_keystone 重锚首杀 3/复杀 2/2/3——a 裁备选;末关照常入账;收束无二次派生)④同调位过渡承载(transitional_sync_slots=1;三选一面替换子交互两路/战斗内沉没;现行事实源归同调实施批)⑤**奖励节点共享池**(追加批用户拍板——与通关三选一同池同权重同上限,node-reward.md v2.1 掷定前置卡片直显具体道具)⑥断点 save v3(奖励选择态+件计数+aux_detail;v1/v2→v3 semver 兼容断言——g 裁)⑦BonusPickOverlay 共用面+目检修复批(候选一致降级为现状注记);**裁决面**:七项代拍板全裁(a 用备选/b-f 认同/g semver)+e 白话追认;**实机目检一轮**:1/3/4/5/6/9/14 PASS(8 项根因=减动效开关遗留已翻回;2/12 延后同调批;逐行结算演出定性迭代 8 事项不追);**合并 master 数值修复批**(bc737fb 解 2 冲突——autoplay 注释双留/smoke_all 取新断言+模拟档购血容差窗)后冒烟 628/0+run_all 15 套+五探针+三闸零新增(死链 4=存量;master 新引 1 条环境死链已修)+熵增 PASS;**MC 四代锚** 77000/78000/79000/80000 各 400 局(普通 L1 41.8%/L2 10.2% 带内、完美 L1 86.5%/L2 15.6%、钥石 1.38/3.01——报告 design/qa/m3-iter10-clear-rate-readings-2026-10-01.md);**人工参与项入 07 清单⑩**;**已完成(2026-10-01 开发闭合)**——迭代 11 门解(M-3 内顺延),Alpha 总闸仍卡迭代 9 数值实机验收 |
|
||||
### M-4 Alpha 后深化与内容扩展(Release 4)
|
||||
|
||||
> **里程碑语义换代(2026-10-09 用户立规)**:**M3=Alpha 版本的完整实现;M4=Beta 版本的完整实现**。用户未明令宣布 M3 完成前,项目停留在 M3 阶段——迭代规划只编排 M3(Alpha 完整实现)相关需求,M4 内容一律不排期、不进迭代。按新口径:本节迭代 11 起各行皆属 M3(Alpha 完整实现面);2026-10-03「M-3 关闭、Alpha 到手」为验收史记录保留;M4(Beta)未开启,门=用户明令 M3 完成;本节旧状态句「现行里程碑(2026-10-03 M-3 关闭升现行)」由本注取代。
|
||||
|
||||
| # | 迭代 | 门(进入条件) | 更改任务 |
|
||||
|---|---|---|---|
|
||||
| 迭代 11+ | **✅ 三批已落籍(2026-10-03,状态记录 323-325)**:①魔法道具同调实施批 bc17b66(冒烟 645/0→671/0 基线演进)→ ②GP 商店房重构批 395b2ab(共享池账本+抽 3 买 1 全重抽+A=1.8/b=1.1 provisional+MC off 对拍逐位 PASS+on 新锚 N=60)→ ④视野迷雾实施批 e6260a5(菱形灯光区 R8+区外全黑+暗淡记忆态+探针 case⑮;纯呈现 MC 零跑)——各批合并后主区全量冒烟复跑全绿;**迭代 11 门=待出口人闸关闭(人闸材料包=design/qa/m4-iter11-exit-package-2026-10-03.md:三批检查单+追认清单 18 项+迷雾目检指引+读数报告)**。原登记:**2026-10-03 用户裁迭代 11 范围(三批,推荐序)**:①魔法道具同调实施批 → ②GP 商店房重构批 → ④视野迷雾实施批(各批独立出口闸;同调批先行——商店批共享池账本与通关率复测建在 aux 卡退役后的终局池上,读数只锚一次;迷雾批纯呈现不扰读数,序位可穿插);**反制批移迭代 12**(前置=双层 BD 外部调研+仲裁后重新立项;2026-10-03 用户终裁=同调位反制道具层级错配失败设计废弃,「每变异≥1反制道具」契约作废——地形变异.md v0.6/魔法道具.md v0.8 同批落文(06 条目已收口移除));**Beta 方向立项撤出本窗口**(待 Alpha 内容填充+试玩轮次后再议);关卡内容扩展留讨论位(世界观设定待用户补正主——摩索不达城 repo 无载)。↓ 原登记:反制批 Alpha · **魔法道具同调实施批**(需求卡片 v1.1 全裁 P1-P8(需求卡片已退役,落籍=①bc17b66),2026-10-02 用户裁 P7 乙归本窗口,发令即开工——需求卡片含 T0-T10 可升 loop 计划书)· **GP 商店房重构批**(2026-10-02 用户裁三选一同构化:买一全重抽/重抽绑购买/价格=基价×b^(关序−1)×A^(进店已购次数)〔系数归 game-balancer 研究〕,取代 09-20 无刷新裁决——06「GP 商店房重构」条在册待立项)· 关卡内容扩展 · Beta 方向立项(原迭代 10+ 三主题顺延——迭代 10 位已由奖励结构重构批占用,2026-09-30 用户拍板 P-E;各批顺序按 Alpha 读数定;含营地 2D 画面议题——2026-09-29 裁缓至此再议) | M-3 出口闸(**已解**——2026-10-03 迭代 9 出口闸收官:M-3 关闭、Alpha 到手) | 立项时按「迭代粒度界定」拆任务卡 |
|
||||
| 迭代 12 | **双层 BD 实施批(反制批位移承接——变异应对局内化在本批落地)**:**2026-10-03 用户五裁全落**=R1 甲(树形态融合案:主干脊柱 row-gating+三脉+彩蛋 ≤3+A/B 集中同调脉)/R2 乙(**两层全入本迭代**:批次一 T0-T7=机制件基建+七流派全量铺〔R3 乙〕+地形转化件+商店保底+MC 锚;批次二 T8-T10=天赋树+存档 v4+营地 UI 重构;超软时间盒切 12/12b,切分点=批次一出口)/R3 乙(七流派批次一全量铺)/R4 甲(**信息型永不对冲**+复查闸=T10 呈报信息型真人读数仅呈报不提案;净化工兵仅限伤害型、清除工具件族不做、深挖钻头改非信息税设计)/R5 甲(喂雷流不做,06 留正式待办+kill-switch 判据)。未落地备选内容已自包含迁 06「双层 BD 延期与备选内容总登记」。设计事实源=`design/research/双层BD体系-整合定稿-2026-10-03.md`(双模型并行调研仲裁版),需求卡片已退役(落籍=e780063)。**✅ 已全批落籍(2026-10-04,状态记录 328-333)**:TP0 令牌池先行(normal 重锚)→批次一 T0-T7(27 件七流派+MC 成型锚 L1 5%→75% 分岔+红线自检①过)→批次二 T8-T10(天赋树 33 节点+存档 v5+营地树 UI+A/B 面 0.0pp)一次合并 e780063;试玩反馈四连修复(钻头 AP 锁死/v2 收益重投/流派件呈现双界面/清图奖励 toast)至 c43276d;批末冒烟 718/0+run_all 15+探针绿+doc 三闸基线同款+熵增 PASS;**出口人闸待用户**(人工检查清单=状态记录 328-333+design/qa/m4iter12 两报告);前置=迭代 11 三批出口+M-4 数值批令牌池落地+商店批共享池 | 迭代 11 出口 | T0-T10 两段式(需求卡片 §四) |
|
||||
| 迭代 13 | **工程债与测试基建批(含 D6 爆破工兵包实施)**:六条目=ui_click_probe 完整局适配(D1——分派链序修正+停点/锁期/重放三态断言)/探针只读出口(D2——六出口 26 直入清零)/ArmedTimer helper(D3——P4 乙三处计时收口缝零动)/main.gd 二期瘦身(D4——bonus_interact_controller+camp_shop_presenter 拆件 1370→1119,家族②契约3绑定面留置;~900±50 锚差=族级清单上限不自洽已归因)/aux 二期合并(T5 判不合收口)/杂项尾差四件(D5)/爆破工兵包中立移除危险格(D6——P1 甲邻接冻结/P2 甲退色降档,判定逻辑零改动,充能表驱动零新码)。**✅ 已落籍(2026-10-04,状态记录 342)**:worktree m4iter13-debt-20261004 八提交 cd7d3ea…2402877 合并 eff8cb8;闸=冒烟 718/0(断言数持平基线)+run_all 15+click 三种子绿+全探针绿+doc 三闸零新增+熵增 PASS+MC 零跑(静态零漂移证明);合并后主区全量复跑同绿 | 迭代 12 出口 | T0-T9 ≈4.8-5.3d(知情超限单批,实际单会话) |
|
||||
| 迭代 14 | **初始展开收窄批(2026-10-04 用户拍板甲乙混合立项)**:甲=先布后删剃雷域收窄至出生 3×3∪外扩 r 环(参数化半径,现值 r=1——开阔地均值从板面 66.5% 根因性降至约三成)+乙=生成重掷闸 R₀≤cap(合法性门序列、cap=板面 30% 锚〔10×10=30/12×12=43/13×13=51〕、重试耗尽走既有三分出口);**玩法侧零改动路线**(排雷玩法「初始展开恰等」验收原样为真,minesweeper_rules.gd 零 diff);裸数字截断路否决退役(可见 0 格+未开邻居=扫雷不可能态)。可行性报告=`design/research/研究-初始展开收窄可行性-2026-10-04.md`,需求卡片=`design/research/需求卡片-初始展开收窄批-2026-10-04.md`(T0-T8≈5.25d,读数批 T5-T6 可切独立后批;拍板点 P1-P3 全读数后置;停机点 S1 相变警戒/S2 带越界回调)。**✅ 实施批落地(2026-10-05,worktree m4iter14-narrow-20261005 状态记录 357;S1 停机呈报已裁=用户方案A)**:T0-T4+T7+T8 全落(T5 结构读数随批出讫;T6 MC 四带复算读数批按切分预案后置,跑批待用户批准挂 07 现行义务)——甲=剃雷域收窄(shave_ring_radius 参数化,r=1→出生 5×5,全域 flood 剃雷退役,零 RNG 消费变化)+乙=R₀≤cap 重掷闸(合法性闸序列+同流重试+耗尽三分出口诚实降级+r0_cap_rejected 指标)+参数面两列(schema 域校验加载期致命+19 行投值)+断言面 +12(R₀≤cap/ring_removed 量级/cap 压线诚实降级/确定性逐位)+夹具复核 3 处(relic 候选身份按 TP0 v2.2=kind|tier|relic_id、商店购买笔数推导防 GP 流漂移、极性探针种子自愈);**S1 停机实录**=r=1 自然 R₀ 均值 39>cap30 锚结构性倒挂(94% 拒绝/inf 0.976→0.719/常态非法板)→用户裁方案A「10×10 cap 30→45」〔P1 上调预案字面〕,12×12/13×13 健康侧维持;改后结构读数=R₀ 均值 39.7/37.9/42.8/46.6(收窄自 68.6/83.2——10×10 −42%、12×12 −54%)/尾部闸精确截断/雷密度 19.2-21.6%<25% 相变线/inf 全行达标;玩法侧零改动(minesweeper_rules.gd 零 diff、「初始展开恰等」验收原样为真);闸=冒烟 767/0(+12);registry initial_expansion_narrowing 条+棋盘生成.md v0.5+07⑬ 四信号组;06 视野条目已于 745b92ea 清账批退役(收窄立项即正主)。**②挖掘风险不等式判式换代批(2026-10-04 用户裁编入本迭代,作为迭代内需求)**:判式三层换代(条款2 标中旗锚/条款3 聚合健康式「(1−ρ̂)E_dig−ρ̂V_mine≥0」/旗边际引理+条件二旗溢价)+β 比值带判读 [1.2,2.5](u=3 登记态)+标中兑付溢价 δ=1.25(形态 a 兑付公式一处·危险格与安全格同池冻结不动)+runsum 旗行为五字段+audit 工具常量刷新(池 77/直伤 6-8-8/AP 8);裁决全落零新拍板点(方案报告 §九(已退役,git 1da9a41)),需求卡片=`.zcode/plans/mine-inequality-revision-miniloop-plan-2026-10-04.md`(T0-T5≈2.5d;条件二 T3 落文按登记已知破·T4 机制转绿;契约红线=DamageController 零改/直伤雷 6-8-8 与 p_perfect 不动——iter8 缺口四选一解绑独立在案;开工门=U0)。**✅ 实施批落地(2026-10-05,worktree m4iter14-mineq-20261005 状态记录 356)**:T0-T5 全落——audit 工具常量刷新(改前静态锚与方案报告 §四 逐位吻合)+runsum 五字段(行侧判据考证=授予行专带 highlight,87行==87插旗1:1)+F1 条款3 重立三层口径(v0.8)+战斗结算 v0.25+难度联动表+6 行+registry clause3_inequality 重立条(改前锚+P7 修正注记)+06 破线条收口+**T4 标中兑付溢价机制**(settlement.flag_hit_premium=125 provisional,grant 单点只挂 flag_hit 正向·percent 幅度贯穿应用与呈现,标空/挖格不乘,DamageController 零改/同池冻结)+smoke 750/0(+3 断言;max 路径种子 42→43 重采);判读三件=β 带 u=1/2 带内 u=3 登记态/δ 敏感度行为无感(η 位移 <1.4pp<5pp,保留+登记)/条件二判式口径等号压线转绿(整数量级实现 u=1/2 绿·u=3 微欠 −1.1% 登记面);改后锚换代 runsum_m4iter14mineq_post_n200_20261005(perfect 冒险通关 65.3%→72.0% 增强向位移,四带判读归 M-4);出口报告=design/qa/m4iter14-mineq-exit-report-2026-10-05.md(provisional 追认单 8 项+07⑫ 人工项);damage_probe A1 红灯=改前既有非本批新增(在册)。**③全局作用域变异首发批(2026-10-04 用户拍板立项——调研报告 P1-P8+盘问 Q1-Q4 全按推荐案落,批内序位待排)**:L2/L3 Boss 图恒定一型 scope=global 变异,首发型=**案A 资源面·微贫向偏斜**(正向格面池合计不变、进攻族 attack/blast/pierce/magic 权重上浮/生存族 heal/defense 明显下调、EV 微降 3-5% provisional、gp/action 白名单不动;v1.0「沃土+雷密Line truncated
|
||||
| 迭代 15 | **①调试功能整合批(2026-10-05 用户令自「14.5」临时卡改编入册——原周期外 0.5 卡,落地事实与验证读数零变化,只改编号归属)**:主菜单三调试散件(随机种子输入框/角色数值调整板/两层调试入口)收一张调试浮窗 DebugOverlay——入口=开始覆盖层右下角「调试」角标(与主按钮组非平级,DS_DEBUG=1 环境变量门控沿用迭代 8 卡④口径);浮窗=悬浮菜单之上 Dialog(不隐藏开始层,同确认弹窗形态;旧 TunePanel「与开始层互斥」形态与类整体吸收退役含 .uid);可扩展滚动列表页四区块(随机种子/数值调整/批量模拟/两层调试入口——后续调试项往下追加滚轮下探)。四拍板全落(2026-10-04 用户裁)=P1 甲 DS_DEBUG 门控/P2 乙全摊平/P3 仅开始菜单可开·对局不可达(_show_debug_overlay 门禁护栏+对局发起随开随收)/P4 可扩展列表。**✅ 已全批落籍(2026-10-05,worktree iter145-debug-hub 两提交 48c0b34/46dadbb,主区 merge --no-ff d0a3c6b/10c301b,状态记录 352)**:闸=冒烟 747/0+探针 ui_tune/ui_click/ui 三绿(worktree+主区双跑,主区跑前 --import 重刷类名缓存在册坑);遗留=实机目检归用户(DS_DEBUG=1 启动→右下角角标→浮窗四区块→两层调试入口) | 卡①门:迭代 14 出口(注:本卡先于迭代 14 出口落籍——编入时点迭代 14 ③已闭/①②④⑤进行中/⑥挂起,门列仅记编入时点状态,不构成追溯闸) | 单批已落地(原估 0.5d,实际一次会话);后续扩调试项=debug_overlay.gd _build() 列表区追加区块(P4 扩展口径) |
|
||||
| 迭代 15 | **②奇物概念收口与词族对齐批(2026-10-05 用户令编入本迭代)**:概念层已由用户逐轮裁定定稿(《奇物》v1.0→v2.7,7 轮),本批只做**落地对齐**、不做二次设计。三批内容:**①三套旧词族全面对齐**(顶层已改名「奇物」而代码仍叫旧名=用户最初抱怨的"文档与代码分开"):`feature_*`→`curio_*`(103 处/7 文件)、`relic_*`→`feat_*`(162 处/12 文件)、运行层 `bonus_*`→`curio_*`(160 处/8 文件)。**硬约束:`reward_*` 已被 `reward_pick`/`reward_node`/`reward_preview` 占用,统一词族不得使用**;`relic_table.gd` 与两个控制器类改名须同步 Godot `.uid`/`.tscn`(非文本层无法自证)。**②三条渠道按分类分离**(现行三渠道共用同一个 98 张池、三类混编):关底 Boss 击败=通过这一关→只出专长;奖励节点/商店→属性值提升+资源、专长在此**只以凭证形式**出现。**兑付频率红线**:奇物不是打一场战斗给一份,关内普通战斗节点打完不给任何奇物,一关之内只兑付一次(用户 2026-10-05 纠错)。**③两个新种类入池**=刷新次数(须先与"商店独立刷新机制"划清边界)+ 专长获取凭证(拿到即开不可囤积/罕见只在概率/一局限购一次/计步保底:连续 5 次三选一展示未出→第 6 次必出,刷新重展计入、奖励节点与商店共享计数);附带 `shop.tres` 补回复(默认原则要求分类内成员都在该出现的渠道池里)与 charge 标签补至 ≥4 件(现仅 3 件,档二永远达不到——数据缺陷)。设计事实源=`design/gdd/systems/冒险循环/奇物.md` v2.7,需求卡片=`design/research/需求卡片-奇物词族对齐与渠道分离批-2026-10-05.md`(T0-T8≈4.5d,两段切分预案在册〔段一词族 T0-T3≈2d/段二渠道+入表 T4-T8≈2.5d〕,切分点=T3 出口;11 条设计契约含 6 条 🔴 停机级;12 条批末验收断言;代拍板白名单 5 项;待用户裁点 4 项〔玩家可见面违规/第四关档二复裁/凭证四参数终值/存档键正式迁移〕)。**开工门**:与在途 M-4 各批(判式换代/全局变异/配比预设)撞同一批文件(`adventure_table.gd`/`level_runner.gd`/`adventure.tres`),须确认不并行或用户明示插队 | 卡②门:迭代 14 出口 | 卡①已落籍(原估 0.5d);卡② ✅ **已全批落籍(2026-10-05,worktree curio-wordfamily 七提交 d4cde73..049aa62+master 同步 23547b5,主区 merge 见状态记录;出口报告=[iter15-2-curio-exit-report](design/qa/iter15-2-curio-exit-report-2026-10-05.md))**:三套词族代码层全换(feature_→curio_ 93 处/bonus_ 运行层→curio_/relic_→feat_——feat_table.gd/feats.tres/feats_engine.gd 改名);渠道白名单分离(总池-渠道子集多级缓存形=用户裁);凭证入表(四参数 provisional 20%/2/1/5+拿到即开+计步保底+限购 1+节点商店共享计数);refresh 入池(B 案 heal 5→3 挤占)+shop.tres 补 heal 行+凭证行;T2 裁点甲案=六存档键禁改(含需求卡片漏登记的 "relics" 键);charge 缺陷登记不硬补;autoplay 凭证分支缺陷批内实测修复(MC timeout 形态);闸=冒烟 782/0(+10)+run_all 16 套历史首次全绿(reward_overlay 红转绿=M7 bcard 成因修复)+五探针绿+doc 三闸零新增+MC n200 只测不判(normal 0.5%/perfect 77.5%);遗留=07⑰ 目检归用户+C1 呈现批/C2 第四关批/C3 调参批/C4 存档批四移交。原估 T0-T8≈4.5d(实际一次会话);迭代 15 三卡全落籍(①352/②本批/③8944dca 前身③批+本批) |
|
||||
| 迭代 15 | **③秘宝代码词族对齐批(2026-10-05 用户令编入本迭代)**:设计侧已完成(消歧更名批 `430419c`+`06e94b7`,26 个设计文档「魔法道具」→「**秘宝**」,同调位机制名保留不变),本批只做**代码侧对齐**、不做二次设计。内容:`aux_*`/`AuxItem*` 词族全族换词 **358 处 / 36 文件**(重灾 `adventure_runner.gd`79 / `level_runner.gd`27 / `bonus_interact_controller.gd`19 / `battle_orchestrator.gd`18 / `config_db.gd`14 / `main.gd`13),分五组落:**A 玩家可见文案(P0,5 处)**=`battle_narrator.gd:117-118` + `bonus_interact_controller.gd:76` + `hero_info_panel_view.gd:56`(槽位标题 `UiKit.label`)+ `:178`(tooltip)· B schema 与数据表(`aux_item_table.gd`/`aux_items.tres`/`aux_items.gd` 文件名+类名+`ConfigDB` 持有变量与访问器全链跟改,**须同步 Godot `.uid`/`.tscn` + `--import` 重刷类名缓存**——迭代 14.5 实证在册坑)· C 文档链接修复(含 `architecture.md` 两处既有断债顺带清偿)· D 中文注释层(**须分色**:`魔法矢`/`魔法反噬`/`魔法族`/`魔法护甲` 属敌方伤害护甲语汇🔴不动)· E 测试文件名+内部变量。**用户三项拍板**:全族彻底改(含数据表)· **断点存档键一律保留**(`bonus_aux_carry`/`aux_detail`/`aux_cleared`/`aux_cleared_last`/`aux_items` 断点数组/`attunement_charges` 共 34 处引用一字不改,破档即进度丢失)· registry 条目键 `aux_items` 不改(数据契约键)。设计事实源=`design/gdd/systems/跨局循环/秘宝.md` v0.9,需求卡片=`design/research/需求卡片-秘宝代码词族对齐批-2026-10-05.md`(T0-T9≈5.0d,**超软盒 3 日上限·知情预挂**:T7 段末闸后 L3 呈报切点不擅切;**三档降级面 G1/G2/G3 在册**〔G3 下限=仅组 A 完成〕;5 条设计契约含 5 条 🔴 停机级〔存档兼容零破坏/数值零漂移/schema 契约面零变更/零字段更名/核心层零 await〕;代拍板白名单 5 项;**C1/C2 已裁关闭·全改保一致·待裁点 0 项**)。**撞批已消解**:② 奇物批 2026-10-05 收口落库(合并 `c571af2`),并行风险解除,本批为迭代 15 唯一在途需求;**T0 须重取基线**(判式换代批 T5 读数 750/0、② 又动数据层,§1.2 的 747 为②前旧数禁沿用)并复核事实表。**✅ 裁决(用户 2026-10-05「全改保一致」)**:C1 `"aux_item"` 域串**照改**(实测连锁面收窄——`reward.tres` 已零 aux_item 数据行,池种随迭代 11 T7 退役;16 处字面量全在代码内闭合无存档依赖;唯一连锁项=`smoke_all.gd:3932` 断言须同步)· C2 `aux_items` 一名两义**拆分**(ConfigDB 持有变量+表注册键✅改 / 断点存档键+冒烟夹具🔴禁改——**「键名禁改」与「变量名禁改」是两回事**,禁改的只是落盘字面量)。新增**组 F**(分派语汇与域串 16 处),任务卡扩为 T0-T10≈5.5d。**开工门**:✅ 已无待裁点,可直接发 T0 | 卡③门:迭代 14 出口(**裁点已全决·可开工**) | 卡①已落籍(原估 0.5d);卡② ✅ 已全批落籍(2026-10-05 merge 3c6f2c9,状态记录 362——c571af2 文档+数据层之上的实施段全量补完);**卡③ ✅ 已全批落籍(2026-10-05,worktree m4iter15-mibao 九提交 b4b8bb3..收口笔,主区 merge --no-ff 哈希见状态记录/active.md 快照行;出口报告=[iter15-3-mibao-exit-report](design/qa/iter15-3-mibao-exit-report-2026-10-05.md))**:词族实数 364 处/36 文件全换尽(例外 43+2 处=存档键引号字面量+夹具,穷举在报告 §五);闸=冒烟 755/0+run_all 14/15(唯一红=②批遗留基线红 reward_overlay,对照零新增)+行为探针四件全绿+doc 三闸/熵增闸零新增+存档键六键普查零差异+MC 按 goal 令豁免(静态零漂移证明代);渲染像素五闸屏蔽挂账 07⑮;遗留=实机目检归用户(07⑮)+reward_overlay 基线红归②批处置 |
|
||||
| 迭代 16 | **UI 设计对齐批(2026-10-05 用户令:迭代 16 改编为 UI 优化需求实现,原四卡全数顺延迭代 17;美术线用户自理立规的例外面=本批只改 UI 设计代码、零美术资源改动)**:三路改进整合轴的代码侧落地——事实源=`design/research/UI预览demo三路改进整合对照-2026-10-04.md`(A 落码差异对照+OPT-A 机检+WB 变体三路整合,基线原型 v2.1)。**红线=不修改美术资源**:game/assets/art 与 artwork/ 均不动、不生新素材不重烘,只改 UI 设计代码(ui_kit 色板 token/字号档/布局纪律/对比度垫底/抖动呈现/panel_skinned 接线等)。无分歧可直接收项=对比度 7 处 FAIL 修法(血数 2.09→12.29 垫底等已复算)/站桩溢出 3.2px/4 处裸色收 ui_kit/status 图标 preload 违规/tg-* 类型色接线。**前置待裁=六分歧点**(①底色冷暖 ②棋盘格边长 32/44/45 ③字号档位 ④九宫格切片 ⑤圆角去留 ⑥图标尺寸解法,对照表 §三)+开放项(抖动范围/色板唯一来源,§五)。需求卡片=`design/research/需求卡片-UI设计对齐批-2026-10-05.md`(T0-T11≈7.25d,**超软盒 3d 预挂**,三段切分=段一 2.0d 无阻断〔T0-T4a〕/ 段二 4.0d 待裁〔T4b-T8〕/ 段三 1.0d 收口〔T9-T11〕;🔴 契约 7 条 R1-R7;无分歧收项 N1-N6 已逐处 file:line 考证;**待用户裁点 11 项**=六分歧 P1 底色冷暖/P2 棋盘格边长/P3 字号档位/P4 九宫格切片/P5 圆角去留/P6 图标尺寸解法 + 开放项 P7 色板唯一来源/P8 抖动范围/P9 §五 已决注销清单/P10 记忆态口径/P11 装饰 caption 豁免;**六分歧与开放项一律呈全备选案含淘汰依据**)。**事实校正(实查,2026-10-05)**:9 处色板漂移实测 4 已收 5 未收;`tg-*` 五族在 ui_kit 并不存在(以裸 Color8 内联于 bonus_pick_overlay/shop_overlay_view,缺第五族);panel_skinned 消费面实测 8 处+工厂 1 处;棋盘格边长=动态公式 clamp[26,46] 与 §8.1 锚点 45/36 三方互不等;手绘图标十枚 20×20 已入库,真问题转为 64×64 柜台四枚显示倍率;站桩溢出实机存在 1px 余量同型写法(standee_body.gd:476);demo 基线 md5 已再次漂移(实测 78ebbee0…)。状态=**需求卡片已起草(2026-10-05)+ 取向已定(2026-10-06)**:✅ P1=甲(维持暖化零改动)/ P2=丁(棋盘格边长零改动,46/45/44 不一致登记为已知偏差);✅ **其余八项取向已定**(用户采纳推荐)——**跟 demo**:P4 九宫格切片 8→16 / P7 五处色板向 demo / P10 记忆态纹理灰罩;**按条款解**:P3 字号立 FS_* 档(demo 34 处<14、54 处<16 不可跟)/ P6 图标显示档(demo 自身 0.3125× 违规)/ P8 抖动只做卡顶色带(demo 渐变+blur 违反像素纪律)/ P11 装饰 caption 12px 豁免;P5 两路同结论。**「以 demo 为准」三层优先级栈=需求卡片 §8.3**(①用户终裁>②冻结条款>③demo);三条结构级差异(卡片 232×352 / 商店全屏化 / 地图底栏合并)**不入本批、已登记 06 待立项**。估时 T0-T11≈**6.9d**(段一 2.15d 无阻断可发令 / 段二 3.75d / 段三 1.0d;三段同属一迭代、**只在段三末合并一次**);**拷打轮一 9 问已全部落地**(Q1 `panel_skinned` content margin clamp / Q2 不走独立样张闸改并进 T10 目检 / Q3 柜台图标统一 32px / Q4 商店补类型分族 / Q5 血数 11px 与装饰 caption 合并写一条豁免 / Q6 槽两态不新增通道 / Q7 一次合并 / Q8 已知偏差已登记 06 / Q9 demo 取值抄录表为唯一引用源)。**✅ 已全批落籍(2026-10-06 单会话,worktree g-plan2-iter16ui 分支 iter16-ui-20261005 十二提交 85ea024..T11 收口笔,主区 merge --no-ff 哈希见 active.md 快照行;出口报告=[iter16-ui-exit-report](design/qa/iter16-ui-exit-report-2026-10-06.md))**:T0-T10 全落(T10 人闸材料包=[iter16-ui-human-gate-checklist](design/qa/iter16-ui-human-gate-checklist-2026-10-06.md)——实机目检+代拍板追认八项归用户);闸=冒烟 782/0(断言数持平基线)+run_all 16 套全绿+探针五件全绿(新增 ui_contrast_probe 11 对测点+ui_struct⑥standee 断言族入默认段)+doc 三闸/熵增零新增+MC 零跑(纯呈现批——核心/数据层 diff=0 实证)+素材零触碰;T0 实机复算三处修法改向(意图徽标垫牌/槽位字深化/RAP 零改动——demo 口径在实机反向)+N4a 裸色实数 25 处/10 文件全收 ui_kit(需求卡片 5 处系漏记)+字号 107 位点归档 FS_* 六档;偏差八条在出口报告§汇总;遗留=06 新登记「呈现层残余 <4.5:1 文字位」一条(名行四墨/顺位徽标/RAP 反馈——批外邻接发现) | 迭代 15 出口 | 预算 T0-T11≈6.9d(三段切分)——**实际单会话一次跑完(2026-10-06)** |
|
||||
| 迭代 17 | **⓪内容数据驱动扩展批(2026-10-06 用户令插队为头卡——①-④卡顺延,其需求卡片与裁点状态原样保留)**:把内容效果行为从结算代码硬编码搬进数据行「订阅事件(on)+条件(when)+效果类型(do)」,通用解释器 EffectEngine 统一执行——完成后加「已有效果类型」的新专长/秘宝=纯改 `.tres` 零代码。裁决八条全落(R1 发布订阅同步 emit 确定性优先/R2 仅一个改写窗口不做拦截器链/R3 一事件多订阅+组合规则封冲突面/R4 旧 23 挂点枚举删除·2 个退化条件行/R5 现有实现全改造+06 在册只登记〔curio_roll/shop_purchase/gp_settle 三事件登记不实施〕/R6 框架先行发射点不论有无订阅者全埋/R7 一个迭代四模块垂直切一次合并/R8 术语纪律:事件=发布订阅 topic、效果类型=订阅后逻辑、组合规则=叠加规则,禁 hook/合并律等自造词)。词汇表定稿=**实施 16 事件**+效果类型 19 行 23(v1.1 扩 damage_mult/open_ticket 两型装下减半/开单现状)+组合规则 6;存档零改动;文案表值化随批(现有实现判据);luck_coin 经 reward_roll 迁移随批。需求卡片=`design/research/需求卡片-内容数据驱动扩展批-2026-10-06.md`(v1.1 2026-10-06 联审修订:level_clear 归登记不实施/对拍判据两套〔确定性复放与冒烟=逐位、MC 统计量=成型画像同带 m4iter12 口径〕/映射表五处语义修正/断言面随迁与订阅重建时机补列;T0-T7≈4.5d,零待裁点,🔴 契约 5 条含行为等价两套判据+护栏保留+确定性;停机点 S1 首流派对拍/S2 批末闸;开工门=U0) | 迭代 15 出口(已解) | T0-T7≈4.5d |**状态**:**已合并落籍 master e535436(2026-10-07 编排会话收口;worktree iter17-dd 分支 iter17-dd-20261006 五提交,六闸全绿+主区复跑全绿〔合并后冒烟 805/0〕)**——T1 效果引擎框架+16 发射点(7d157b3)/T2 词汇落码(225765f)/T3 专长 27 行迁移+旧挂点消亡(e28a6cb)/T4+T5 秘宝六件+令牌树收尾(a33ddaf);六闸全绿(冒烟 800 项 0 失败/单元 17 套/探针含 click/MC 二档对拍 40 局同种子逐位一致);出口报告 design/qa/iter17-datadrive-exit-report-2026-10-06.md,遗留人闸两项随报告 |
|
||||
| 迭代 17 | **①敌人表行集多行批(2026-10-05 用户令编入本迭代,纯功能与数值轴四卡之一)**:放开敌人表「同一(关卡序号 × 节点深度)行集恰一敌种」加载期校验(enemy_table.gd:108-112 考证在册),允许同场遭遇混编多种敌人——生成(unit_container spawn 行集受理)/编排(battle_orchestrator/narrator)/断言面全链接通 + GDD 结构冻结面修订先行(敌人系统.md:75/:263)。事实源=06「同深度第二敌种与精英/Boss 编码位」条剩余面(前半已由关卡节点地图 v1.0 消解);前置=技能池实施批已落籍(d3fa887)开工门已解。需求卡片=`design/research/需求卡片-敌人表行集多行批-2026-10-05.md`(**v1.1 2026-10-06 联审修订**:F7 勘误 19 行 9 敌种/P1 补遭遇骰交互〔每行一骰·RNG 扩签先报批〕与实例总数≤4 消歧/P3 改裁丙撤投放/新增契约 R6 混编行行序纪律/expect_pools 断言换代入组 D;T0-T8≈3.75d〔T5 撤投后,超软盒预挂,T4 末切分点〕;🔴 契约 6 条;**✅ 裁点全裁(2026-10-06 用户令:P1甲〔Q8/Q9 二裁补全〕/P2甲/P3丙〔Q3 二裁撤投放——一裁乙与首遇教学位纪律三面冲突〕/P4乙 Boss 行亦放开·知情代价六面在册);开工=U0**) | 迭代 15 出口 | **✅ 已全批落码落籍(2026-10-07,主区 merge --no-ff 9cc4b8b,闸全绿+主区复跑全绿〔合并后冒烟 811/0〕,worktree g-plan2-iter17-enemy 分支 iter17-enemy-20261007 基点 e535436,批内提交 a0b06b4(L3 报告)/5b9cf59(甲案裁决)/18cdcb0(T0)/ab5ddad(T1)/8690230(T2)/bc73fa3(T3)/c583940(T4)+收口批;一次 L3 停机=卡⓪改前锚随 worktree 删除丢失不可恢复→用户裁甲案补采改前锚 40 局·总量 80 局明示批准;出口报告=[iter17-enemy-exit-report](design/qa/iter17-enemy-exit-report-2026-10-07.md))**:行集构成纪律三条落码(同坐标多行混编放开含 Boss 行集 P4乙+行序相邻加载校验 R6+实例总数≤4 spawn 守卫 P1甲)+floor 版解析退役全仓统走 ceil 行集数组(P2 甲,状态记录 312 销号)+spawn 行集受理逐行实例化+遭遇骰逐行各掷(Q8——单行行集消费序/次数逐位一致=零内容期随机流零变化)+断言面换代(expect_pools 三元键/双表精确行集契约/L2L3 定点行集口径)+混编正反断言十一条(冒烟六+单测五);文档=敌人系统 v0.15/难度曲线与Boss v0.24/registry/06 状态行;闸=冒烟 811/0(基线 805/0,+6 混编断言)+run_all 17 套+probe_gate 含 click 全绿+doc 三闸/熵增存量红零新增+MC 改前改后 40 局同种子全字段零差异(零漂移铁证;补采锚 L1 口径读数 off 4/20·formed 16/20 与卡⓪出口报告逐位同值=等价旁证);**人闸=实机目检四项+代拍板追认九项**(design/qa/iter17-enemy-人闸材料-2026-10-07.md。原估 T0-T8≈3.75d) |
|
||||
| 迭代 17 | **③暂停层只读入口批(2026-10-05 用户令编入本迭代)**:新增局内暂停层,承载钥石余额与解锁态(营地三柜台进度)只读查看——事实源=06「解锁界面与钥石呈现的交互形态(残余:暂停层只读入口)」条。考证在册:现行无暂停层;模态栈/设置面/调试浮窗三先例齐;UiKit 公共件(modal_shell/bcard/verb_button/徽章形制)与色板 token 单点现成;MetaProgression 只读访问器面齐全;战斗屏 GP/钥石已迁出=局内零查看入口正是本批由来。**美术红线:复用现行公共件与色板,零新素材零新色值(2026-10-05 用户立规)**。需求卡片=`design/research/需求卡片-暂停层只读入口批-2026-10-05.md`(T0-T5≈3.0d;🔴 契约 5 条含公共件单点/模态登记纪律;**✅ 裁点全裁(2026-10-06 用户令全按推荐:P1丁/P2甲/P3甲/P4甲);开工=U0**) | 迭代 15 出口 | **✅ 已全批落码落籍(2026-10-06/07,主区 merge --no-ff c8beaa2,闸全绿,worktree g-plan2-iter17-pause 分支 iter17-pause-20261006 两会话接力完成,提交 c08a901/fc9eb1e/d44fdd5+收口笔;出口报告=[iter17-pause-exit-report](design/qa/iter17-pause-exit-report-2026-10-06.md))**:暂停层本体+badge 工厂件收编(Q10 甲,营地钥石徽同步迁移观感零变化)+两屏常驻角标入口与 has_open 守卫+四探针断言(结构/点击/输入锁 case⑯/只读巡检/零动效契约/对比度对)+冒烟投影一致性 5 断言;闸=冒烟 788/0(基线 783/0)+run_all 17 套+probe_gate --click 全绿+doc 三闸零新增+MC 零跑(纯呈现零数值);存量移交=熵增闸 design/diagrams 越界(00712d5 总图批落籍漏步,主区同红)+06/07 gdd_lint 存量注记红(本批零触碰);**人闸=用户实机目检**(design/qa/iter17-pause-human-gate-checklist-2026-10-06.md,重点含排播排空副作用确认项 D2。原估 T0-T5≈3.0d 贴软盒内) |
|
||||
| 迭代 11+ | **✅ 三批已入库(2026-10-03,状态记录 323-325)**:①魔法道具同调实施批 bc17b66(冒烟 645/0→671/0 基线演进)→ ②GP 商店房重构批 395b2ab(共享池账本+抽 3 买 1 全重抽+A=1.8/b=1.1 provisional+MC off 对拍逐位 PASS+on 新锚 N=60)→ ④视野迷雾实施批 e6260a5(菱形灯光区 R8+区外全黑+暗淡记忆态+探针 case⑮;纯呈现 MC 零跑)——各批合并后主区全量冒烟复跑全绿;**迭代 11 门=待出口人闸关闭(人闸材料包=design/qa/m4-iter11-exit-package-2026-10-03.md:三批检查单+追认清单 18 项+迷雾目检指引+读数报告)**。原登记:**2026-10-03 用户裁迭代 11 范围(三批,推荐序)**:①魔法道具同调实施批 → ②GP 商店房重构批 → ④视野迷雾实施批(各批独立出口闸;同调批先行——商店批共享池账本与通关率复测建在 aux 卡退役后的终局池上,读数只锚一次;迷雾批纯呈现不扰读数,序位可穿插);**反制批移迭代 12**(前置=双层 BD 外部调研+仲裁后重新立项;2026-10-03 用户终裁=同调位反制道具层级错配失败设计废弃,「每变异≥1反制道具」契约作废——地形变异.md v0.6/魔法道具.md v0.8 同批落文(06 条目已收口移除));**Beta 方向立项撤出本窗口**(待 Alpha 内容填充+试玩轮次后再议);关卡内容扩展留讨论位(世界观设定待用户补权威定义——摩索不达城 repo 无载)。↓ 原登记:反制批 Alpha · **魔法道具同调实施批**(需求卡片 v1.1 全裁 P1-P8(需求卡片已退役,已入库=①bc17b66),2026-10-02 用户裁 P7 乙归本窗口,发令即开工——需求卡片含 T0-T10 可升 loop 计划书)· **GP 商店房重构批**(2026-10-02 用户裁三选一同构化:买一全重抽/重抽绑购买/价格=基价×b^(关序−1)×A^(进店已购次数)〔系数归 game-balancer 研究〕,取代 09-20 无刷新裁决——06「GP 商店房重构」条在册待立项)· 关卡内容扩展 · Beta 方向立项(原迭代 10+ 三主题顺延——迭代 10 位已由奖励结构重构批占用,2026-09-30 用户拍板 P-E;各批顺序按 Alpha 读数定;含营地 2D 画面议题——2026-09-29 裁缓至此再议) | M-3 出口闸(**已解**——2026-10-03 迭代 9 出口闸收官:M-3 关闭、Alpha 到手) | 立项时按「迭代粒度界定」拆任务卡 |
|
||||
| 迭代 12 | **双层 BD 实施批(反制批位移承接——变异应对局内化在本批落地)**:**2026-10-03 用户五裁全落**=R1 甲(树形态融合案:主干脊柱 row-gating+三脉+彩蛋 ≤3+A/B 集中同调脉)/R2 乙(**两层全入本迭代**:批次一 T0-T7=机制件基建+七流派全量铺〔R3 乙〕+地形转化件+商店保底+MC 锚;批次二 T8-T10=天赋树+存档 v4+营地 UI 重构;超软时间盒切 12/12b,切分点=批次一出口)/R3 乙(七流派批次一全量铺)/R4 甲(**信息型永不对冲**+复查闸=T10 呈报信息型真人读数仅呈报不提案;净化工兵仅限伤害型、清除工具件族不做、深挖钻头改非信息税设计)/R5 甲(喂雷流不做,06 留正式待办+kill-switch 判据)。未落地备选内容已自包含迁 06「双层 BD 延期与备选内容总登记」。设计事实源=`design/research/双层BD体系-整合定稿-2026-10-03.md`(双模型并行调研仲裁版),需求卡片已退役(已入库=e780063)。**✅ 已全批入库(2026-10-04,状态记录 328-333)**:TP0 令牌池先行(normal 重锚)→批次一 T0-T7(27 件七流派+MC 成型锚 L1 5%→75% 分岔+红线自检①过)→批次二 T8-T10(天赋树 33 节点+存档 v5+营地树 UI+A/B 面 0.0pp)一次合并 e780063;试玩反馈四连修复(钻头 AP 锁死/v2 收益重投/流派件呈现双界面/清图奖励 toast)至 c43276d;批末冒烟 718/0+run_all 15+探针绿+doc 三闸基线同款+熵增 PASS;**出口人闸待用户**(人工检查清单=状态记录 328-333+design/qa/m4iter12 两报告);前置=迭代 11 三批出口+M-4 数值批令牌池落地+商店批共享池 | 迭代 11 出口 | T0-T10 两段式(需求卡片 §四) |
|
||||
| 迭代 13 | **工程债与测试基建批(含 D6 爆破工兵包实施)**:六条目=ui_click_probe 完整局适配(D1——分派链序修正+停点/锁期/重放三态断言)/探针只读出口(D2——六出口 26 直入清零)/ArmedTimer helper(D3——P4 乙三处计时收口缝零动)/main.gd 二期瘦身(D4——bonus_interact_controller+camp_shop_presenter 拆件 1370→1119,家族②契约3绑定面留置;~900±50 锚差=族级清单上限不自洽已归因)/aux 二期合并(T5 判不合收口)/杂项尾差四件(D5)/爆破工兵包中立移除危险格(D6——P1 甲邻接冻结/P2 甲退色降档,判定逻辑零改动,充能表驱动零新码)。**✅ 已入库(2026-10-04,状态记录 342)**:worktree m4iter13-debt-20261004 八提交 cd7d3ea…2402877 合并 eff8cb8;闸=冒烟 718/0(断言数持平基线)+run_all 15+click 三种子绿+全探针绿+doc 三闸零新增+熵增 PASS+MC 零跑(静态零漂移证明);合并后主区全量复跑同绿 | 迭代 12 出口 | T0-T9 ≈4.8-5.3d(知情超限单批,实际单会话) |
|
||||
| 迭代 14 | **初始展开收窄批(2026-10-04 用户拍板甲乙混合立项)**:甲=先布后删剃雷域收窄至出生 3×3∪外扩 r 环(参数化半径,现值 r=1——开阔地均值从板面 66.5% 根因性降至约三成)+乙=生成重掷闸 R₀≤cap(合法性门序列、cap=板面 30% 锚〔10×10=30/12×12=43/13×13=51〕、重试耗尽走既有三分出口);**玩法侧零改动路线**(排雷玩法「初始展开恰等」验收原样为真,minesweeper_rules.gd 零 diff);裸数字截断路否决退役(可见 0 格+未开邻居=扫雷不可能态)。可行性报告=`design/research/研究-初始展开收窄可行性-2026-10-04.md`,需求卡片=`design/research/需求卡片-初始展开收窄批-2026-10-04.md`(T0-T8≈5.25d,读数批 T5-T6 可切独立后批;拍板点 P1-P3 全读数后置;停机点 S1 相变警戒/S2 带越界回调)。**✅ 实施批落地(2026-10-05,worktree m4iter14-narrow-20261005 状态记录 357;S1 停机呈报已裁=用户方案A)**:T0-T4+T7+T8 全落(T5 结构读数随批出讫;T6 MC 四带复算读数批按切分预案后置,跑批待用户批准挂 07 现行义务)——甲=剃雷域收窄(shave_ring_radius 参数化,r=1→出生 5×5,全域 flood 剃雷退役,零 RNG 消费变化)+乙=R₀≤cap 重掷闸(合法性闸序列+同流重试+耗尽三分出口诚实降级+r0_cap_rejected 指标)+参数面两列(schema 域校验加载期致命+19 行投值)+断言面 +12(R₀≤cap/ring_removed 量级/cap 压线诚实降级/确定性逐位)+夹具复核 3 处(relic 候选身份按 TP0 v2.2=kind|tier|relic_id、商店购买笔数推导防 GP 流漂移、极性探针种子自愈);**S1 停机实录**=r=1 自然 R₀ 均值 39>cap30 锚结构性倒挂(94% 拒绝/inf 0.976→0.719/常态非法板)→用户裁方案A「10×10 cap 30→45」〔P1 上调预案字面〕,12×12/13×13 健康侧维持;改后结构读数=R₀ 均值 39.7/37.9/42.8/46.6(收窄自 68.6/83.2——10×10 −42%、12×12 −54%)/尾部闸精确截断/雷密度 19.2-21.6%<25% 相变线/inf 全行达标;玩法侧零改动(minesweeper_rules.gd 零 diff、「初始展开恰等」验收原样为真);闸=冒烟 767/0(+12);registry initial_expansion_narrowing 条+棋盘生成.md v0.5+07⑬ 四信号组;06 视野条目已于 745b92ea 清账批退役(收窄立项即现行事实源)。**②挖掘风险不等式判式换代批(2026-10-04 用户裁编入本迭代,作为迭代内需求)**:判式三层换代(条款2 标中旗锚/条款3 聚合健康式「(1−ρ̂)E_dig−ρ̂V_mine≥0」/旗边际引理+条件二旗溢价)+β 比值带判读 [1.2,2.5](u=3 登记态)+标中兑付溢价 δ=1.25(形态 a 兑付公式一处·危险格与安全格同池冻结不动)+runsum 旗行为五字段+audit 工具常量刷新(池 77/直伤 6-8-8/AP 8);裁决全落零新拍板点(方案报告 §九(已退役,git 1da9a41)),需求卡片=`.zcode/plans/mine-inequality-revision-miniloop-plan-2026-10-04.md`(T0-T5≈2.5d;条件二 T3 落文按登记已知破·T4 机制转绿;契约红线=DamageController 零改/直伤雷 6-8-8 与 p_perfect 不动——iter8 缺口四选一解绑独立在案;开工门=U0)。**✅ 实施批落地(2026-10-05,worktree m4iter14-mineq-20261005 状态记录 356)**:T0-T5 全落——audit 工具常量刷新(改前静态锚与方案报告 §四 逐位吻合)+runsum 五字段(行侧判据考证=授予行专带 highlight,87行==87插旗1:1)+F1 条款3 重立三层口径(v0.8)+战斗结算 v0.25+难度联动表+6 行+registry clause3_inequality 重立条(改前锚+P7 修正注记)+06 破线条收口+**T4 标中兑付溢价机制**(settlement.flag_hit_premium=125 provisional,grant 单点只挂 flag_hit 正向·percent 幅度贯穿应用与呈现,标空/挖格不乘,DamageController 零改/同池冻结)+smoke 750/0(+3 断言;max 路径种子 42→43 重采);判读三件=β 带 u=1/2 带内 u=3 登记态/δ 敏感度行为无感(η 位移 <1.4pp<5pp,保留+登记)/条件二判式口径等号压线转绿(整数量级实现 u=1/2 绿·u=3 微欠 −1.1% 登记面);改后锚换代 runsum_m4iter14mineq_post_n200_20261005(perfect 冒险通关 65.3%→72.0% 增强向位移,四带判读归 M-4);出口报告=design/qa/m4iter14-mineq-exit-report-2026-10-05.md(provisional 追认单 8 项+07⑫ 人工项);damage_probe A1 红灯=改前既有非本批新增(在册)。**③全局作用域变异首发批(2026-10-04 用户拍板立项——调研报告 P1-P8+盘问 Q1-Q4 全按推荐案落,批内序位待排)**:L2/L3 Boss 图恒定一型 scope=global 变异,首发型=**案A 资源面·微贫向偏斜**(正向格面池合计不变、进攻族 attack/blast/pierce/magic 权重上浮/生存族 heal/defense 明显下调、EV 微降 3-5% provisional、gp/action 白名单不动;v1.0「沃Line truncated
|
||||
| 迭代 15 | **①调试功能整合批(2026-10-05 用户令自「14.5」临时卡改编入册——原周期外 0.5 卡,落地事实与验证读数零变化,只改编号归属)**:主菜单三调试散件(随机种子输入框/角色数值调整板/两层调试入口)收一张调试浮窗 DebugOverlay——入口=开始覆盖层右下角「调试」角标(与主按钮组非平级,DS_DEBUG=1 环境变量门控沿用迭代 8 卡④口径);浮窗=悬浮菜单之上 Dialog(不隐藏开始层,同确认弹窗形态;旧 TunePanel「与开始层互斥」形态与类整体吸收退役含 .uid);可扩展滚动列表页四区块(随机种子/数值调整/批量模拟/两层调试入口——后续调试项往下追加滚轮下探)。四拍板全落(2026-10-04 用户裁)=P1 甲 DS_DEBUG 门控/P2 乙全摊平/P3 仅开始菜单可开·对局不可达(_show_debug_overlay 门禁护栏+对局发起随开随收)/P4 可扩展列表。**✅ 已全批入库(2026-10-05,worktree iter145-debug-hub 两提交 48c0b34/46dadbb,主区 merge --no-ff d0a3c6b/10c301b,状态记录 352)**:闸=冒烟 747/0+探针 ui_tune/ui_click/ui 三绿(worktree+主区双跑,主区跑前 --import 重刷类名缓存在册坑);遗留=实机目检归用户(DS_DEBUG=1 启动→右下角角标→浮窗四区块→两层调试入口) | 卡①门:迭代 14 出口(注:本卡先于迭代 14 出口已入库——编入时点迭代 14 ③已闭/①②④⑤进行中/⑥挂起,门列仅记编入时点状态,不构成追溯闸) | 单批已落地(原估 0.5d,实际一次会话);后续扩调试项=debug_overlay.gd _build() 列表区追加区块(P4 扩展口径) |
|
||||
| 迭代 15 | **②奇物概念收口与词族对齐批(2026-10-05 用户令编入本迭代)**:概念层已由用户逐轮裁定定稿(《奇物》v1.0→v2.7,7 轮),本批只做**落地对齐**、不做二次设计。三批内容:**①三套旧词族全面对齐**(顶层已改名「奇物」而代码仍叫旧名=用户最初抱怨的"文档与代码分开"):`feature_*`→`curio_*`(103 处/7 文件)、`relic_*`→`feat_*`(162 处/12 文件)、运行层 `bonus_*`→`curio_*`(160 处/8 文件)。**硬约束:`reward_*` 已被 `reward_pick`/`reward_node`/`reward_preview` 占用,统一词族不得使用**;`relic_table.gd` 与两个控制器类改名须同步 Godot `.uid`/`.tscn`(非文本层无法自证)。**②三条渠道按分类分离**(现行三渠道共用同一个 98 张池、三类混编):关底 Boss 击败=通过这一关→只出专长;奖励节点/商店→属性值提升+资源、专长在此**只以凭证形式**出现。**兑付频率红线**:奇物不是打一场战斗给一份,关内普通战斗节点打完不给任何奇物,一关之内只兑付一次(用户 2026-10-05 纠错)。**③两个新种类入池**=刷新次数(须先与"商店独立刷新机制"划清边界)+ 专长获取凭证(拿到即开不可囤积/罕见只在概率/一局限购一次/计步保底:连续 5 次三选一展示未出→第 6 次必出,刷新重展计入、奖励节点与商店共享计数);附带 `shop.tres` 补回复(默认原则要求分类内成员都在该出现的渠道池里)与 charge 标签补至 ≥4 件(现仅 3 件,档二永远达不到——数据缺陷)。设计事实源=`design/gdd/systems/冒险循环/奇物.md` v2.7,需求卡片=`design/research/需求卡片-奇物词族对齐与渠道分离批-2026-10-05.md`(T0-T8≈4.5d,两段切分预案在册〔段一词族 T0-T3≈2d/段二渠道+入表 T4-T8≈2.5d〕,切分点=T3 出口;11 条设计契约含 6 条 🔴 停机级;12 条批末验收断言;代拍板白名单 5 项;待用户裁点 4 项〔玩家可见面违规/第四关档二复裁/凭证四参数终值/存档键正式迁移〕)。**开工门**:与在途 M-4 各批(判式换代/全局变异/配比预设)撞同一批文件(`adventure_table.gd`/`level_runner.gd`/`adventure.tres`),须确认不并行或用户明示插队 | 卡②门:迭代 14 出口 | 卡①已入库(原估 0.5d);卡② ✅ **已全批入库(2026-10-05,worktree curio-wordfamily 七提交 d4cde73..049aa62+master 同步 23547b5,主区 merge 见状态记录;出口报告=[iter15-2-curio-exit-report](design/qa/iter15-2-curio-exit-report-2026-10-05.md))**:三套词族代码层全换(feature_→curio_ 93 处/bonus_ 运行层→curio_/relic_→feat_——feat_table.gd/feats.tres/feats_engine.gd 改名);渠道白名单分离(总池-渠道子集多级缓存形=用户裁);凭证入表(四参数 provisional 20%/2/1/5+拿到即开+计步保底+限购 1+节点商店共享计数);refresh 入池(B 案 heal 5→3 挤占)+shop.tres 补 heal 行+凭证行;T2 裁点甲案=六存档键禁改(含需求卡片漏登记的 "relics" 键);charge 缺陷登记不硬补;autoplay 凭证分支缺陷批内实测修复(MC timeout 形态);闸=冒烟 782/0(+10)+run_all 16 套历史首次全绿(reward_overlay 红转绿=M7 bcard 成因修复)+五探针绿+doc 三闸零新增+MC n200 只测不判(normal 0.5%/perfect 77.5%);遗留=07⑰ 目检归用户+C1 呈现批/C2 第四关批/C3 调参批/C4 存档批四移交。原估 T0-T8≈4.5d(实际一次会话);迭代 15 三卡全已入库(①352/②本批/③8944dca 前身③批+本批) |
|
||||
| 迭代 15 | **③秘宝代码词族对齐批(2026-10-05 用户令编入本迭代)**:设计侧已完成(消歧更名批 `430419c`+`06e94b7`,26 个设计文档「魔法道具」→「**秘宝**」,同调位机制名保留不变),本批只做**代码侧对齐**、不做二次设计。内容:`aux_*`/`AuxItem*` 词族全族换词 **358 处 / 36 文件**(重灾 `adventure_runner.gd`79 / `level_runner.gd`27 / `bonus_interact_controller.gd`19 / `battle_orchestrator.gd`18 / `config_db.gd`14 / `main.gd`13),分五组落:**A 玩家可见文案(P0,5 处)**=`battle_narrator.gd:117-118` + `bonus_interact_controller.gd:76` + `hero_info_panel_view.gd:56`(槽位标题 `UiKit.label`)+ `:178`(tooltip)· B schema 与数据表(`aux_item_table.gd`/`aux_items.tres`/`aux_items.gd` 文件名+类名+`ConfigDB` 持有变量与访问器全链跟改,**须同步 Godot `.uid`/`.tscn` + `--import` 重刷类名缓存**——迭代 14.5 实证在册坑)· C 文档链接修复(含 `architecture.md` 两处既有断债顺带清偿)· D 中文注释层(**须分色**:`魔法矢`/`魔法反噬`/`魔法族`/`魔法护甲` 属敌方伤害护甲语汇🔴不动)· E 测试文件名+内部变量。**用户三项拍板**:全族彻底改(含数据表)· **断点存档键一律保留**(`bonus_aux_carry`/`aux_detail`/`aux_cleared`/`aux_cleared_last`/`aux_items` 断点数组/`attunement_charges` 共 34 处引用一字不改,破档即进度丢失)· registry 条目键 `aux_items` 不改(数据契约键)。设计事实源=`design/gdd/systems/跨局循环/秘宝.md` v0.9,需求卡片=`design/research/需求卡片-秘宝代码词族对齐批-2026-10-05.md`(T0-T9≈5.0d,**超软盒 3 日上限·知情预挂**:T7 段末闸后 L3 呈报切点不擅切;**三档降级面 G1/G2/G3 在册**〔G3 下限=仅组 A 完成〕;5 条设计契约含 5 条 🔴 停机级〔存档兼容零破坏/数值零漂移/schema 契约面零变更/零字段更名/核心层零 await〕;代拍板白名单 5 项;**C1/C2 已裁关闭·全改保一致·待裁点 0 项**)。**撞批已消解**:② 奇物批 2026-10-05 收口落库(合并 `c571af2`),并行风险解除,本批为迭代 15 唯一在途需求;**T0 须重取基线**(判式换代批 T5 读数 750/0、② 又动数据层,§1.2 的 747 为②前旧数禁沿用)并复核事实表。**✅ 裁决(用户 2026-10-05「全改保一致」)**:C1 `"aux_item"` 域串**照改**(实测连锁面收窄——`reward.tres` 已零 aux_item 数据行,池种随迭代 11 T7 退役;16 处字面量全在代码内闭合无存档依赖;唯一连锁项=`smoke_all.gd:3932` 断言须同步)· C2 `aux_items` 一名两义**拆分**(ConfigDB 持有变量+表注册键✅改 / 断点存档键+冒烟夹具🔴禁改——**「键名禁改」与「变量名禁改」是两回事**,禁改的只是落盘字面量)。新增**组 F**(分派语汇与域串 16 处),任务卡扩为 T0-T10≈5.5d。**开工门**:✅ 已无待裁点,可直接发 T0 | 卡③门:迭代 14 出口(**裁点已全决·可开工**) | 卡①已入库(原估 0.5d);卡② ✅ 已全批入库(2026-10-05 merge 3c6f2c9,状态记录 362——c571af2 文档+数据层之上的实施段全量补完);**卡③ ✅ 已全批入库(2026-10-05,worktree m4iter15-mibao 九提交 b4b8bb3..收口笔,主区 merge --no-ff 哈希见状态记录/active.md 快照行;出口报告=[iter15-3-mibao-exit-report](design/qa/iter15-3-mibao-exit-report-2026-10-05.md))**:词族实数 364 处/36 文件全换尽(例外 43+2 处=存档键引号字面量+夹具,穷举在报告 §五);闸=冒烟 755/0+run_all 14/15(唯一红=②批遗留基线红 reward_overlay,对照零新增)+行为探针四件全绿+doc 三闸/熵增闸零新增+存档键六键普查零差异+MC 按 goal 令豁免(静态零漂移证明代);渲染像素五闸屏蔽挂账 07⑮;遗留=实机目检归用户(07⑮)+reward_overlay 基线红归②批处置 |
|
||||
| 迭代 16 | **UI 设计对齐批(2026-10-05 用户令:迭代 16 改编为 UI 优化需求实现,原四卡全数顺延迭代 17;美术线用户自理立规的例外面=本批只改 UI 设计代码、零美术资源改动)**:三路改进整合轴的代码侧落地——事实源=`design/research/UI预览demo三路改进整合对照-2026-10-04.md`(A 落码差异对照+OPT-A 机检+WB 变体三路整合,基线原型 v2.1)。**红线=不修改美术资源**:game/assets/art 与 artwork/ 均不动、不生新素材不重烘,只改 UI 设计代码(ui_kit 色板 token/字号档/布局纪律/对比度垫底/抖动呈现/panel_skinned 接线等)。无分歧可直接收项=对比度 7 处 FAIL 修法(血数 2.09→12.29 垫底等已复算)/站桩溢出 3.2px/4 处裸色收 ui_kit/status 图标 preload 违规/tg-* 类型色接线。**前置待裁=六分歧点**(①底色冷暖 ②棋盘格边长 32/44/45 ③字号档位 ④九宫格切片 ⑤圆角去留 ⑥图标尺寸解法,对照表 §三)+开放项(抖动范围/色板唯一来源,§五)。需求卡片=`design/research/需求卡片-UI设计对齐批-2026-10-05.md`(T0-T11≈7.25d,**超软盒 3d 预挂**,三段切分=段一 2.0d 无阻断〔T0-T4a〕/ 段二 4.0d 待裁〔T4b-T8〕/ 段三 1.0d 收口〔T9-T11〕;🔴 契约 7 条 R1-R7;无分歧收项 N1-N6 已逐处 file:line 考证;**待用户裁点 11 项**=六分歧 P1 底色冷暖/P2 棋盘格边长/P3 字号档位/P4 九宫格切片/P5 圆角去留/P6 图标尺寸解法 + 开放项 P7 色板唯一来源/P8 抖动范围/P9 §五 已决注销清单/P10 记忆态口径/P11 装饰 caption 豁免;**六分歧与开放项一律呈全备选案含淘汰依据**)。**事实校正(实查,2026-10-05)**:9 处色板漂移实测 4 已收 5 未收;`tg-*` 五族在 ui_kit 并不存在(以裸 Color8 内联于 bonus_pick_overlay/shop_overlay_view,缺第五族);panel_skinned 消费面实测 8 处+工厂 1 处;棋盘格边长=动态公式 clamp[26,46] 与 §8.1 锚点 45/36 三方互不等;手绘图标十枚 20×20 已入库,真问题转为 64×64 柜台四枚显示倍率;站桩溢出实机存在 1px 余量同型写法(standee_body.gd:476);demo 基线 md5 已再次漂移(实测 78ebbee0…)。状态=**需求卡片已起草(2026-10-05)+ 取向已定(2026-10-06)**:✅ P1=甲(维持暖化零改动)/ P2=丁(棋盘格边长零改动,46/45/44 不一致登记为已知偏差);✅ **其余八项取向已定**(用户采纳推荐)——**跟 demo**:P4 九宫格切片 8→16 / P7 五处色板向 demo / P10 记忆态纹理灰罩;**按条款解**:P3 字号立 FS_* 档(demo 34 处<14、54 处<16 不可跟)/ P6 图标显示档(demo 自身 0.3125× 违规)/ P8 抖动只做卡顶色带(demo 渐变+blur 违反像素纪律)/ P11 装饰 caption 12px 豁免;P5 两路同结论。**「以 demo 为准」三层优先级栈=需求卡片 §8.3**(①用户终裁>②冻结条款>③demo);三条结构级差异(卡片 232×352 / 商店全屏化 / 地图底栏合并)**不入本批、已登记 06 待立项**。估时 T0-T11≈**6.9d**(段一 2.15d 无阻断可发令 / 段二 3.75d / 段三 1.0d;三段同属一迭代、**只在段三末合并一次**);**拷打轮一 9 问已全部落地**(Q1 `panel_skinned` content margin clamp / Q2 不走独立样张闸改并进 T10 目检 / Q3 柜台图标统一 32px / Q4 商店补类型分族 / Q5 血数 11px 与装饰 caption 合并写一条豁免 / Q6 槽两态不新增通道 / Q7 一次合并 / Q8 已知偏差已登记 06 / Q9 demo 取值抄录表为唯一引用源)。**✅ 已全批入库(2026-10-06 单会话,worktree g-plan2-iter16ui 分支 iter16-ui-20261005 十二提交 85ea024..T11 收口笔,主区 merge --no-ff 哈希见 active.md 快照行;出口报告=[iter16-ui-exit-report](design/qa/iter16-ui-exit-report-2026-10-06.md))**:T0-T10 全落(T10 人闸材料包=[iter16-ui-human-gate-checklist](design/qa/iter16-ui-human-gate-checklist-2026-10-06.md)——实机目检+代拍板追认八项归用户);闸=冒烟 782/0(断言数持平基线)+run_all 16 套全绿+探针五件全绿(新增 ui_contrast_probe 11 对测点+ui_struct⑥standee 断言族入默认段)+doc 三闸/熵增零新增+MC 零跑(纯呈现批——核心/数据层 diff=0 实证)+素材零触碰;T0 实机复算三处修法改向(意图徽标垫牌/槽位字深化/RAP 零改动——demo 口径在实机反向)+N4a 裸色实数 25 处/10 文件全收 ui_kit(需求卡片 5 处系漏记)+字号 107 位点归档 FS_* 六档;偏差八条在出口报告§汇总;遗留=06 新登记「呈现层残余 <4.5:1 文字位」一条(名行四墨/顺位徽标/RAP 反馈——批外邻接发现) | 迭代 15 出口 | 预算 T0-T11≈6.9d(三段切分)——**实际单会话一次跑完(2026-10-06)** |
|
||||
| 迭代 17 | **⓪内容数据驱动扩展批(2026-10-06 用户令插队为头卡——①-④卡顺延,其需求卡片与裁点状态原样保留)**:把内容效果行为从结算代码硬编码搬进数据行「订阅事件(on)+条件(when)+效果类型(do)」,通用解释器 EffectEngine 统一执行——完成后加「已有效果类型」的新专长/秘宝=纯改 `.tres` 零代码。裁决八条全落(R1 发布订阅同步 emit 确定性优先/R2 仅一个改写窗口不做拦截器链/R3 一事件多订阅+组合规则封冲突面/R4 旧 23 挂点枚举删除·2 个退化条件行/R5 现有实现全改造+06 在册只登记〔curio_roll/shop_purchase/gp_settle 三事件登记不实施〕/R6 框架先行发射点不论有无订阅者全埋/R7 一个迭代四模块垂直切一次合并/R8 术语纪律:事件=发布订阅 topic、效果类型=订阅后逻辑、组合规则=叠加规则,禁 hook/合并律等自造词)。词汇表定稿=**实施 16 事件**+效果类型 19 行 23(v1.1 扩 damage_mult/open_ticket 两型装下减半/开单现状)+组合规则 6;存档零改动;文案表值化随批(现有实现判据);luck_coin 经 reward_roll 迁移随批。需求卡片=`design/research/需求卡片-内容数据驱动扩展批-2026-10-06.md`(v1.1 2026-10-06 联审修订:level_clear 归登记不实施/对拍判据两套〔确定性复放与冒烟=逐位、MC 统计量=成型画像同带 m4iter12 口径〕/映射表五处语义修正/断言面随迁与订阅重建时机补列;T0-T7≈4.5d,零待裁点,🔴 契约 5 条含行为等价两套判据+护栏保留+确定性;停机点 S1 首流派对拍/S2 批末闸;开工门=U0) | 迭代 15 出口(已解) | T0-T7≈4.5d |**状态**:**已合并进 master e535436(2026-10-07 编排会话收口;worktree iter17-dd 分支 iter17-dd-20261006 五提交,六闸全绿+主区复跑全绿〔合并后冒烟 805/0〕)**——T1 效果引擎框架+16 发射点(7d157b3)/T2 词汇落码(225765f)/T3 专长 27 行迁移+旧挂点消亡(e28a6cb)/T4+T5 秘宝六件+令牌树收尾(a33ddaf);六闸全绿(冒烟 800 项 0 失败/单元 17 套/探针含 click/MC 二档对拍 40 局同种子逐位一致);出口报告 design/qa/iter17-datadrive-exit-report-2026-10-06.md,遗留人闸两项随报告 |
|
||||
| 迭代 17 | **①敌人表行集多行批(2026-10-05 用户令编入本迭代,纯功能与数值轴四卡之一)**:放开敌人表「同一(关卡序号 × 节点深度)行集恰一敌种」加载期校验(enemy_table.gd:108-112 考证在册),允许同场遭遇混编多种敌人——生成(unit_container spawn 行集受理)/编排(battle_orchestrator/narrator)/断言面全链接通 + GDD 结构冻结面修订先行(敌人系统.md:75/:263)。事实源=06「同深度第二敌种与精英/Boss 编码位」条剩余面(前半已由关卡节点地图 v1.0 消解);前置=技能池实施批已入库(d3fa887)开工门已解。需求卡片=`design/research/需求卡片-敌人表行集多行批-2026-10-05.md`(**v1.1 2026-10-06 联审修订**:F7 勘误 19 行 9 敌种/P1 补遭遇骰交互〔每行一骰·RNG 扩签先报批〕与实例总数≤4 消歧/P3 改裁丙撤投放/新增契约 R6 混编行行序纪律/expect_pools 断言换代入组 D;T0-T8≈3.75d〔T5 撤投后,超软盒预挂,T4 末切分点〕;🔴 契约 6 条;**✅ 裁点全裁(2026-10-06 用户令:P1甲〔Q8/Q9 二裁补全〕/P2甲/P3丙〔Q3 二裁撤投放——一裁乙与首遇教学位纪律三面冲突〕/P4乙 Boss 行亦放开·知情代价六面在册);开工=U0**) | 迭代 15 出口 | **✅ 已全批落码入库(2026-10-07,主区 merge --no-ff 9cc4b8b,闸全绿+主区复跑全绿〔合并后冒烟 811/0〕,worktree g-plan2-iter17-enemy 分支 iter17-enemy-20261007 基点 e535436,批内提交 a0b06b4(L3 报告)/5b9cf59(甲案裁决)/18cdcb0(T0)/ab5ddad(T1)/8690230(T2)/bc73fa3(T3)/c583940(T4)+收口批;一次 L3 停机=卡⓪改前锚随 worktree 删除丢失不可恢复→用户裁甲案补采改前锚 40 局·总量 80 局明示批准;出口报告=[iter17-enemy-exit-report](design/qa/iter17-enemy-exit-report-2026-10-07.md))**:行集构成纪律三条落码(同坐标多行混编放开含 Boss 行集 P4乙+行序相邻加载校验 R6+实例总数≤4 spawn 守卫 P1甲)+floor 版解析退役全仓统走 ceil 行集数组(P2 甲,状态记录 312 销号)+spawn 行集受理逐行实例化+遭遇骰逐行各掷(Q8——单行行集消费序/次数逐位一致=零内容期随机流零变化)+断言面换代(expect_pools 三元键/双表精确行集契约/L2L3 定点行集口径)+混编正反断言十一条(冒烟六+单测五);文档=敌人系统 v0.15/难度曲线与Boss v0.24/registry/06 状态行;闸=冒烟 811/0(基线 805/0,+6 混编断言)+run_all 17 套+probe_gate 含 click 全绿+doc 三闸/熵增存量红零新增+MC 改前改后 40 局同种子全字段零差异(零漂移铁证;补采锚 L1 口径读数 off 4/20·formed 16/20 与卡⓪出口报告逐位同值=等价旁证);**人闸=实机目检四项+代拍板追认九项**(design/qa/iter17-enemy-人闸材料-2026-10-07.md。原估 T0-T8≈3.75d) |
|
||||
| 迭代 17 | **③暂停层只读入口批(2026-10-05 用户令编入本迭代)**:新增局内暂停层,承载钥石余额与解锁态(营地三柜台进度)只读查看——事实源=06「解锁界面与钥石呈现的交互形态(残余:暂停层只读入口)」条。考证在册:现行无暂停层;模态栈/设置面/调试浮窗三先例齐;UiKit 公共件(modal_shell/bcard/verb_button/徽章形制)与色板 token 单点现成;MetaProgression 只读访问器面齐全;战斗屏 GP/钥石已迁出=局内零查看入口正是本批由来。**美术红线:复用现行公共件与色板,零新素材零新色值(2026-10-05 用户立规)**。需求卡片=`design/research/需求卡片-暂停层只读入口批-2026-10-05.md`(T0-T5≈3.0d;🔴 契约 5 条含公共件单点/模态登记纪律;**✅ 裁点全裁(2026-10-06 用户令全按推荐:P1丁/P2甲/P3甲/P4甲);开工=U0**) | 迭代 15 出口 | **✅ 已全批落码入库(2026-10-06/07,主区 merge --no-ff c8beaa2,闸全绿,worktree g-plan2-iter17-pause 分支 iter17-pause-20261006 两会话接力完成,提交 c08a901/fc9eb1e/d44fdd5+收口笔;出口报告=[iter17-pause-exit-report](design/qa/iter17-pause-exit-report-2026-10-06.md))**:暂停层本体+badge 工厂件收编(Q10 甲,营地钥石徽同步迁移观感零变化)+两屏常驻角标入口与 has_open 守卫+四探针断言(结构/点击/输入锁 case⑯/只读巡检/零动效契约/对比度对)+冒烟投影一致性 5 断言;闸=冒烟 788/0(基线 783/0)+run_all 17 套+probe_gate --click 全绿+doc 三闸零新增+MC 零跑(纯呈现零数值);存量移交=熵增闸 design/diagrams 越界(00712d5 总图批已入库漏步,主区同红)+06/07 gdd_lint 存量注记红(本批零触碰);**人闸=用户实机目检**(design/qa/iter17-pause-human-gate-checklist-2026-10-06.md,重点含排播排空副作用确认项 D2。原估 T0-T5≈3.0d 贴软盒内) |
|
||||
| 迭代 17 | **④生涯界面设计立项(2026-10-05 用户令编入本迭代;只做设计提纲不做实装)**:事实源=06「『生涯』界面——冒险中数据回看的唯一承接处」条(P-C7 裁:M9 已退役局内结算明细回看,历史数据现无承接面=用户知情裁决)。考证在册:回看退役已落码(battle_end_overlay/battle_log_view/ui_assembler 三处注记)+settlement_review_overlay.gd 遗留件在盘+跨局持久面=save v5 meta 域+recent_summaries 现役逐局留痕(cap=10,save_manager.gd SUMMARY_CAP——2026-10-06 联审勘误:原记「无历史冒险记录面」系事实错误;真实缺口=cap 扩容+用时埋点+总局数/通关局数 lifetime 计数域〔涉存档 schema〕+营地既有最近冒险清单的去留设计)。需求卡片形态=设计提纲版:信息架构+承载内容清单(跨局汇总/历史冒险回看/图鉴承接)+与既有界面关系+三期实装建议+待裁点,标注「实装批另行立项」。需求卡片=`design/research/需求卡片-生涯界面设计立项-2026-10-05.md`(**v1.1 2026-10-06 联审修订**:F4 改正 recent_summaries 现役/P2 甲口径重述=扩容+用时埋点/总局数通关局数标注涉 schema/营地清单去列入设计稿必答项/N 候选补「维持 10」;T0-T2≈1.25d 纯文档零测试;**✅ 裁点全裁(2026-10-06 用户令全按推荐:P0甲/P1甲/P2甲〔N 实装期定〕/P3甲/P4甲/P5甲);开工=U0**) | 迭代 15 出口 | ✅ **设计提纲已成文待用户评审(2026-10-06 卡④设计批完成,worktree iter17-career-20261006,纯文档零代码零测试)**:提纲=design/gdd/systems/跨局循环/生涯.md v0.1(范围草案——信息架构/承载内容清单/界面关系/分期建议/待裁点五节,P0-P5 已裁结论落文,新发现待裁点 P6 营地最近冒险条带去留随评审一并裁);02 根索引补行+06 状态行换代「设计提纲已成文待评审」。**人闸=用户评审提纲**;评审通过后期一/二/三实装批另行立项(不预占排期。原估 T0-T2≈1.25d 软盒内) |
|
||||
| 迭代 18 | **③武器锻造系统设计提案批(2026-10-06 用户令入迭代 18;纯文档零代码——提案源=playnote 2026-10-06)**:用户提案=攻击力提升改造为「武器锻造」——剑(普攻)锻造升级加攻击、满级附带额外效果;后续增列长枪/法杖,攻击类型分别走穿刺/魔法;护甲由轻甲起级(先只提 AC)→解锁重甲/魔法甲(基础 AC 各异、可续升、满级各带额外效果)——武器/护甲差异化。产出=系统设计提案文档(与奇物属性值提升分类/护甲克制轴/营地柜台/锻造经济边界对齐,数值框架 provisional 终值归 Alpha 收官 M4 数值批统一调整〔未排期〕),裁点呈用户裁决;实装批另行立项。06 已登记专条。需求卡片=`design/research/需求卡片-武器锻造系统设计提案批-2026-10-07.md`(提纲版 v1.0——设计裁点在提案产物内全备选呈裁,需求卡片零待裁点;开工=U0) | 🔨 提案已成文交付(2026-10-07)待盘问裁决(异步不阻塞) | T0-T2≈1.5d(一轮呈裁基线,盘问轮次扩展另计) |
|
||||
| 迭代 18 | **④生涯界面实装批(2026-10-06 用户令入迭代 18)**:按迭代 17 卡④设计提纲(design/gdd/systems/跨局循环/生涯.md v0.1,master 44328b1)实装「生涯」界面——跨局汇总/历史冒险回看/图鉴承接;提纲在册要点=recent_summaries 现役 cap10 扩容+用时埋点/总局数与通关局数(涉存档 schema)/营地最近冒险清单去留(P6 必答项随评审定);分期建议随提纲。需求卡片=`design/research/需求卡片-生涯界面实装批-2026-10-07.md`(v1.0——范围=提纲期一〔汇总页+主菜单入口+终身计数域存档 v6〕,期二/期三零触碰;裁点 P1 通关局数口径/P2 汇总条目集/P3 模态登记序待裁;提纲评审若改期一范围则需求卡片升版) | **✅ 已落地(2026-10-07 worktree iter18-career:提纲期一追认+裁点全裁〔2026-10-07 用户令代解/全甲;P6 随期二〕后 T0-T5 全落——生涯页六类九项+主菜单入口+终身计数域存档 v6;批末重闸全绿=冒烟 834/0〔基线 814/0,+20〕+run_all 17 套+四探针+ui_contrast 15 对+doc 三闸/熵增闸零新增;MC 零跑;实机人闸挂账待用户〔⑲目检条目随 07〕;出口报告=[iter18-career-exit-report](design/qa/iter18-career-exit-report-2026-10-07.md))** | T0-T5≈2.5d |
|
||||
| 迭代 18 | **⑤混编遭遇首批投放批(2026-10-06 用户令入迭代 18;纯内容批——机制前置=迭代 17 卡①敌人表行集多行批)**:07「后续内容批义务」落地——首个混编遭遇行+Boss 多行内容投放(敌种候选与坐标=本批裁点);首遇教学位纪律与 expect_pools 断言面逐项复核(巨蜘蛛首遇位「固定 2 不加骰」等表注释为准);难度带读数义务随批登记 07,MC 取证跑批**顺延 Alpha 收官 M4 数值批统一执行**〔未排期,届时另令——2026-10-06 用户令:数值统一调整殿后;投放本身不阻塞〕。需求卡片=`design/research/需求卡片-混编遭遇首批投放批-2026-10-07.md`(v1.0——纯内容批零代码,机制面全由卡①承载,机制缺口=L3 停机;裁点 P1 首批投放方案〔荐甲=L2 单点试水〕/P2 Boss 多行不入首批/P3 教学界保护待裁) | 迭代 17 卡①落籍(✅ 已满足 9cc4b8b)+**✅ 裁点全裁(P1-P4 甲,2026-10-07)**——开工=U0 | T0-T5≈1.75d(MC 取证顺延另计)——**✅ 已全批落表(2026-10-07,worktree g-plan2-iter18-mixenc 分支 iter18-mixenc 基点 adadf56,批内提交 ad36e35(T1 设计稿)/6272fc8(T3 落表)/43b1306(T4 断言)/⑤T5 收口批;出口报告=[iter18-mixenc-exit-report](design/qa/iter18-mixenc-exit-report-2026-10-07.md))**:(2,5) 双行混编落表〔重击手+巨蜘蛛巢群(行值复制 (2,6),P4 甲零数值新增),R6 行序=重击手在前〕;d5/d7 候选与行值来源全案留痕(d5 案选定);断言面随迁(expect_pools 三元键新池模板+行集构成/行序/Σ≤4 断言);首遇教学位 (2,4)/(3,0)/(3,1) 零触碰;07 ⑱ 目检与读数义务登记+:174 逐行骰措辞订正;闸=冒烟 814/0(基线 811/0,+3)+run_all+doc 三闸/熵增零新增(批末重闸数字见出口报告);实机目检三项归用户(同场两敌种/行序/总数 ≤4);MC 零跑(顺延 Alpha 收官 M4 数值批在案) |
|
||||
| 迭代 18 | **⑦新冒险种子随机化+调试浮窗升级(2026-10-07 用户令入迭代 18,同日两裁点全裁+浮窗目标态已定)**:**(a) 种子随机化**——现状考证 main.gd:1210 `_seed_value()` 调试种子框为空时硬编码返回 42=每次新冒险同一种子全程可复现;改法=玩家界面入口(主菜单开新冒险)默认分支随机生成;**✅ 裁点全裁(2026-10-07 用户令):①首次冒险维持固定种子(教学态可复现)/②测试脚本与调试接口维持显式指定种子(冒烟·MC·探针全链显式传种子零影响,锚零作废)/③种子不进玩家 UI**;断点续玩零影响(存档已载 master_seed 回填,main.gd:447 现役);与⑥收官批零耦合、排序自由。**(b) 调试浮窗升级**(承载「调试浮窗可查当局数据」裁点=种子的唯一查看位;**本项修订迭代 15 卡① P3 甲「仅开始菜单可开·对局不可达」裁决**)——目标态三件:独立于整体界面的**最高层浮窗**(对局中也可开)/DS_DEBUG=1 调试态下**默认打开**/新增**当局数据只读区块**(当前局种子/关卡/节点/HP/GP/钥石等——玩家 UI 不展示、调试浮窗可查)。考证在册(2026-10-07 实查):现行=开始覆盖层角标入口〔main.gd:292-293,DS_DEBUG=1 点亮〕+main.gd:1189 门禁「仅开始菜单可开」+Dialog 形态走 ModalStack 模态栈登记〔非最高层〕+visible=false 初始非默认开+五区块(胜利演出/种子输入/数值滑条/批量模拟/两层调试)无当局数据面。需求卡片待裁点:最高层与模态栈登记制的关系〔置顶/登记序末+move_child 或独立层〕/输入吞噬边界〔浮窗矩形外透传游戏输入〕/对局发起「随开随收」逻辑改向/ui_tune_probe 断言面换代/入口形态(角标宿主迁移或热键)。需求卡片=`design/research/需求卡片-种子随机化与调试浮窗升级批-2026-10-07.md`(v1.0——实装级裁点 P1 遮挡语义〔荐甲=维持登记制〕/P2 入口形态〔荐甲=角标迁宿主〕/P3 默认打开范围〔荐甲=启动即开〕/P4 当局数据字段集〔荐甲=六项〕/P5 首局种子值〔荐甲=沿用 42〕待裁;估时勘误 1d→2.0d 含探针换代与收口) | **✅ 已落地(2026-10-07 worktree iter18-seed:C1 种子三分+浮窗升级 P1-P6 甲全落;批末重闸全绿=冒烟 811/0+四探针+run_all 17 套+doc 三闸/熵增闸零新增;MC 零跑;实机人闸挂账待用户〔不阻塞落籍与后续卡④〕)** | T0-T5≈2.0d |
|
||||
| 迭代 18 | **⑤混编遭遇首批投放批(2026-10-06 用户令入迭代 18;纯内容批——机制前置=迭代 17 卡①敌人表行集多行批)**:07「后续内容批义务」落地——首个混编遭遇行+Boss 多行内容投放(敌种候选与坐标=本批裁点);首遇教学位纪律与 expect_pools 断言面逐项复核(巨蜘蛛首遇位「固定 2 不加骰」等表注释为准);难度带读数义务随批登记 07,MC 取证跑批**顺延 Alpha 收官 M4 数值批统一执行**〔未排期,届时另令——2026-10-06 用户令:数值统一调整殿后;投放本身不阻塞〕。需求卡片=`design/research/需求卡片-混编遭遇首批投放批-2026-10-07.md`(v1.0——纯内容批零代码,机制面全由卡①承载,机制缺口=L3 停机;裁点 P1 首批投放方案〔荐甲=L2 单点试水〕/P2 Boss 多行不入首批/P3 教学界保护待裁) | 迭代 17 卡①已入库(✅ 已满足 9cc4b8b)+**✅ 裁点全裁(P1-P4 甲,2026-10-07)**——开工=U0 | T0-T5≈1.75d(MC 取证顺延另计)——**✅ 已全批落表(2026-10-07,worktree g-plan2-iter18-mixenc 分支 iter18-mixenc 基点 adadf56,批内提交 ad36e35(T1 设计稿)/6272fc8(T3 落表)/43b1306(T4 断言)/⑤T5 收口批;出口报告=[iter18-mixenc-exit-report](design/qa/iter18-mixenc-exit-report-2026-10-07.md))**:(2,5) 双行混编落表〔重击手+巨蜘蛛巢群(行值复制 (2,6),P4 甲零数值新增),R6 行序=重击手在前〕;d5/d7 候选与行值来源全案留痕(d5 案选定);断言面随迁(expect_pools 三元键新池模板+行集构成/行序/Σ≤4 断言);首遇教学位 (2,4)/(3,0)/(3,1) 零触碰;07 ⑱ 目检与读数义务登记+:174 逐行骰措辞订正;闸=冒烟 814/0(基线 811/0,+3)+run_all+doc 三闸/熵增零新增(批末重闸数字见出口报告);实机目检三项归用户(同场两敌种/行序/总数 ≤4);MC 零跑(顺延 Alpha 收官 M4 数值批在案) |
|
||||
| 迭代 18 | **⑦新冒险种子随机化+调试浮窗升级(2026-10-07 用户令入迭代 18,同日两裁点全裁+浮窗目标态已定)**:**(a) 种子随机化**——现状考证 main.gd:1210 `_seed_value()` 调试种子框为空时硬编码返回 42=每次新冒险同一种子全程可复现;改法=玩家界面入口(主菜单开新冒险)默认分支随机生成;**✅ 裁点全裁(2026-10-07 用户令):①首次冒险维持固定种子(教学态可复现)/②测试脚本与调试接口维持显式指定种子(冒烟·MC·探针全链显式传种子零影响,锚零作废)/③种子不进玩家 UI**;断点续玩零影响(存档已载 master_seed 回填,main.gd:447 现役);与⑥收官批零耦合、排序自由。**(b) 调试浮窗升级**(承载「调试浮窗可查当局数据」裁点=种子的唯一查看位;**本项修订迭代 15 卡① P3 甲「仅开始菜单可开·对局不可达」裁决**)——目标态三件:独立于整体界面的**最高层浮窗**(对局中也可开)/DS_DEBUG=1 调试态下**默认打开**/新增**当局数据只读区块**(当前局种子/关卡/节点/HP/GP/钥石等——玩家 UI 不展示、调试浮窗可查)。考证在册(2026-10-07 实查):现行=开始覆盖层角标入口〔main.gd:292-293,DS_DEBUG=1 点亮〕+main.gd:1189 门禁「仅开始菜单可开」+Dialog 形态走 ModalStack 模态栈登记〔非最高层〕+visible=false 初始非默认开+五区块(胜利演出/种子输入/数值滑条/批量模拟/两层调试)无当局数据面。需求卡片待裁点:最高层与模态栈登记制的关系〔置顶/登记序末+move_child 或独立层〕/输入吞噬边界〔浮窗矩形外透传游戏输入〕/对局发起「随开随收」逻辑改向/ui_tune_probe 断言面换代/入口形态(角标宿主迁移或热键)。需求卡片=`design/research/需求卡片-种子随机化与调试浮窗升级批-2026-10-07.md`(v1.0——实装级裁点 P1 遮挡语义〔荐甲=维持登记制〕/P2 入口形态〔荐甲=角标迁宿主〕/P3 默认打开范围〔荐甲=启动即开〕/P4 当局数据字段集〔荐甲=六项〕/P5 首局种子值〔荐甲=沿用 42〕待裁;估时勘误 1d→2.0d 含探针换代与收口) | **✅ 已落地(2026-10-07 worktree iter18-seed:C1 种子三分+浮窗升级 P1-P6 甲全落;批末重闸全绿=冒烟 811/0+四探针+run_all 17 套+doc 三闸/熵增闸零新增;MC 零跑;实机人闸挂账待用户〔不阻塞已入库与后续卡④〕)** | T0-T5≈2.0d |
|
||||
<<<<<<< HEAD
|
||||
| 迭代 19 | **卡⓪主菜单开局缺陷修复批(原迭代 20 头卡A;2026-10-08 用户令并入本迭代、执行序第一)**:①**主菜单开新冒险+继续上局两入口补传同调三键**(attunement/attune_refresh_y/tree_rules——main.gd:510/:470,接收面 adventure_runner.gd:129-138/215-217 现成;静态考证缺陷成立:全仓无补偿路径、真实入口同调/X/Y 恒空、仅冒烟夹具喂值);②**关卡开场行攻血改传当前生效值**(main.gd:519-521 现传初始表值,与战斗面板不一致=用户确认缺陷;「含面板加成」后缀判断同步改为认局外加成);③冒烟补主菜单入口传参断言;④顺手删 adventure_runner.gd:129-134 三行重复赋值(零行为变化)。范围外=被动同调件呈现(用户令不动)、Fork 规则归因行(呈现层)、X/Y 刷新双源语义倒置(实现与用户口径镜像互换——X=刷新件源每节点重置不结转/Y=营地源整局持久/先扣 X,见 adventure_runner.gd:658-659/:706-709;用户口径=X 持久·Y 每节点重置·先扣 Y;真实局因①此前恒 0 未暴露——待用户裁定甲改实现/乙认现状,裁定落 GDD)。**卡①自动化验收补齐批(2026-10-07 用户令立项——全迭代两阶段验收盘点〔功能性+展示性,均自动化口径,不含人工目检〕的落地批)**:三件主内容——①**渲染闸自动化**:新增 `tools/render_gate.sh` 窗口化自动闸(shot_probe 四屏→shot_checker.py A-D 语义断言自动判定+fx_shot/board_shot 抓帧取证),棋盘 L1-L3 golden 逐像素基线入库 `game/tests/golden/`(测试资产入库先例,.gitignore 已核只挡 artwork/);**probe_gate 头注释「渲染闸归真人目检」纪律句删除改写**(用户 2026-10-07 明示授权=历史偷懒标记),迭代 15③ 屏蔽挂账的机器补跑半随批核销〔07⑮ 目检半仍归用户不销号〕;②**探针收编**:ui_probe/ui_tune_probe/t17_defer_probe/fx_probe 四件游离探针(实测 17.4s/49.6s/63.0s/21.9s 全绿)收进 probe_gate `--full` 段挂重闸,轻闸默认段零改;damage_probe 出闸留盘标注诊断件、config_fatal_probe 删除(与 run_all 致命类单测重复)、零断言三件标注分析工具+ui_layout 补 1280/1920 最小断言;③**账务修正**:tests/README 套件数/断言数漂移(十五→17、752+→双口径说明)+integration 空目录处置(代拍板)。〔2026-10-07 范围改道:原「明示不收」的 B4/B5/B6 三缺口经用户令各立需求卡片并入本迭代,本卡改称卡①,新增卡②③④见后〕。需求卡片=`design/research/需求卡片-自动化验收补齐批-2026-10-07.md`(v1.1——**待裁点 0 项**,P1-P5+拷打轮一 Q1-Q8 全裁 2026-10-07〔重闸定义正式扩容 CLAUDE.md/过程截图即弃/shot_probe 扩屏三新屏/1280 单档/素材缺位 SKIP 而基线禁锚回退态/基线换代权限呈现批 agent/取证失败=闸红/integration 删空壳〕;🔴 契约 6 条含运行时代码零 diff/轻闸零删减/并行避让;停机点 S1 首跑存量 FAIL 全量呈报登记 06+S3 基线生成素材缺位停机;代拍板白名单四项)。**卡②旧界面呈现断言回补批(B5,2026-10-07 用户令立项)**:迭代 16 前落地旧屏追溯补 ui_contrast 测点对+ui_struct 契约——普查结论=对比度测点对旧屏 0 对(15 对现役全属 HUD/锚点/徽章/生涯)、专项契约仅 pause/career、legend/node 两屏从未过结构族;优先级=战斗结算框>商店>营地柜台+天赋树>设置面>三选一>迷雾锚定对;红线=只加断言零改旧屏、违例登记呈报不修(处置权归用户);需求卡片=`design/research/需求卡片-旧界面呈现断言回补批-2026-10-07.md`(v1.1 grilling 三轮全裁——待裁点 0 项,WL 豁免边界/迷雾合成对最坏判据/时长闸 ≤2s/出口报告/06 遗留件登记全钉死;停机点 2〔对比度首跑存量违例/legend-node 结构首跑〕,T0-T4≈1.0d,worktree iter19-uibackfill)〔2026-10-08 施工落籍·**S1 停机态**——T1+T2 测点对 15→38 对(+23:battle_end 3/shop 5/camp 9/settings 2/curio 2/迷雾合成对 1,全 UiKit 常量实时求值);**新对首跑暴露存量对比度违例 7 项**(结算 GP 账行 2.67:1/商店 legacy 行卡名 1.12:1/货架价签 1.46:1/营地铭牌副题 3.59:1/行价格 4.02:1/树分组头 2.67:1/工坊状态 3.00:1)——全量登记清单+修复建议案〔全现役常量换墨可落〕随出口报告呈用户裁,处置权归用户、批内零修(红线);违例对在册=闸红登记存量形态,修复批落后自然转绿;T3 struct 13→15 根(legend/node 全真路径开合)首跑全绿 S2 未命中、WL 零新增;冒烟 840/0+run_all 17 套件持平;出口报告=`design/qa/iter19-uibackfill-exit-report-2026-10-08.md`;settlement_review 遗留件已在 06 登记落位〕。**卡③CI 预接线批(BLine truncated
|
||||
| 迭代 19 | **卡⓪主菜单开局缺陷修复批(原迭代 20 头卡A;2026-10-08 用户令并入本迭代、执行序第一)**:①**主菜单开新冒险+继续上局两入口补传同调三键**(attunement/attune_refresh_y/tree_rules——main.gd:510/:470,接收面 adventure_runner.gd:129-138/215-217 现成;静态考证缺陷成立:全仓无补偿路径、真实入口同调/X/Y 恒空、仅冒烟夹具喂值);②**关卡开场行攻血改传当前生效值**(main.gd:519-521 现传初始表值,与战斗面板不一致=用户确认缺陷;「含面板加成」后缀判断同步改为认局外加成);③冒烟补主菜单入口传参断言;④顺手删 adventure_runner.gd:129-134 三行重复赋值(零行为变化)。范围外=被动同调件呈现(用户令不动)、Fork 规则归因行(呈现层)、X/Y 刷新双源语义倒置(实现与用户口径镜像互换——X=刷新件源每节点重置不结转/Y=营地源整局持久/先扣 X,见 adventure_runner.gd:658-659/:706-709;用户口径=X 持久·Y 每节点重置·先扣 Y;真实局因①此前恒 0 未暴露——待用户裁定甲改实现/乙认现状,裁定落 GDD)。**卡①自动化验收补齐批(2026-10-07 用户令立项——全迭代两阶段验收盘点〔功能性+展示性,均自动化口径,不含人工目检〕的落地批)**:三件主内容——①**渲染闸自动化**:新增 `tools/render_gate.sh` 窗口化自动闸(shot_probe 四屏→shot_checker.py A-D 语义断言自动判定+fx_shot/board_shot 抓帧取证),棋盘 L1-L3 golden 逐像素基线入库 `game/tests/golden/`(测试资产入库先例,.gitignore 已核只挡 artwork/);**probe_gate 头注释「渲染闸归真人目检」纪律句删除改写**(用户 2026-10-07 明示授权=历史偷懒标记),迭代 15③ 屏蔽挂账的机器补跑半随批核销〔07⑮ 目检半仍归用户不销号〕;②**探针收编**:ui_probe/ui_tune_probe/t17_defer_probe/fx_probe 四件游离探针(实测 17.4s/49.6s/63.0s/21.9s 全绿)收进 probe_gate `--full` 段挂重闸,轻闸默认段零改;damage_probe 出闸留盘标注诊断件、config_fatal_probe 删除(与 run_all 致命类单测重复)、零断言三件标注分析工具+ui_layout 补 1280/1920 最小断言;③**账务修正**:tests/README 套件数/断言数漂移(十五→17、752+→双口径说明)+integration 空目录处置(代拍板)。〔2026-10-07 范围改道:原「明示不收」的 B4/B5/B6 三缺口经用户令各立需求卡片并入本迭代,本卡改称卡①,新增卡②③④见后〕。需求卡片=`design/research/需求卡片-自动化验收补齐批-2026-10-07.md`(v1.1——**待裁点 0 项**,P1-P5+拷打轮一 Q1-Q8 全裁 2026-10-07〔重闸定义正式扩容 CLAUDE.md/过程截图即弃/shot_probe 扩屏三新屏/1280 单档/素材缺位 SKIP 而基线禁锚回退态/基线换代权限呈现批 agent/取证失败=闸红/integration 删空壳〕;🔴 契约 6 条含运行时代码零 diff/轻闸零删减/并行避让;停机点 S1 首跑存量 FAIL 全量呈报登记 06+S3 基线生成素材缺位停机;代拍板白名单四项)。**卡②旧界面呈现断言回补批(B5,2026-10-07 用户令立项)**:迭代 16 前落地旧屏追溯补 ui_contrast 测点对+ui_struct 契约——普查结论=对比度测点对旧屏 0 对(15 对现役全属 HUD/锚点/徽章/生涯)、专项契约仅 pause/career、legend/node 两屏从未过结构族;优先级=战斗结算框>商店>营地柜台+天赋树>设置面>三选一>迷雾锚定对;红线=只加断言零改旧屏、违例登记呈报不修(处置权归用户);需求卡片=`design/research/需求卡片-旧界面呈现断言回补批-2026-10-07.md`(v1.1 grilling 三轮全裁——待裁点 0 项,WL 豁免边界/迷雾合成对最坏判据/时长闸 ≤2s/出口报告/06 遗留件登记全钉死;停机点 2〔对比度首跑存量违例/legend-node 结构首跑〕,T0-T4≈1.0d,worktree iter19-uibackfill)〔2026-10-08 施工已入库·**S1 停机态**——T1+T2 测点对 15→38 对(+23:battle_end 3/shop 5/camp 9/settings 2/curio 2/迷雾合成对 1,全 UiKit 常量实时求值);**新对首跑暴露存量对比度违例 7 项**(结算 GP 账行 2.67:1/商店 legacy 行卡名 1.12:1/货架价签 1.46:1/营地铭牌副题 3.59:1/行价格 4.02:1/树分组头 2.67:1/工坊状态 3.00:1)——全量登记清单+修复建议案〔全现役常量换墨可落〕随出口报告呈用户裁,处置权归用户、批内零修(红线);违例对在册=闸红登记存量形态,修复批落后自然转绿;T3 struct 13→15 根(legend/node 全真路径开合)首跑全绿 S2 未命中、WL 零新增;冒烟 840/0+run_all 17 套件持平;出口报告=`design/qa/iter19-uibackfill-exit-report-2026-10-08.md`;settlement_review 遗留件已在 06 登记落位〕。**卡③CI 预接线批Line truncated
|
||||
| 迭代 20 | (**空位待编**〔**2026-10-09 用户令:迭代 20/21/22 规划冻结**——先解决眼前问题,重启=用户直接发令〕——原头卡A 主菜单开局缺陷修复批已并入迭代 19 卡⓪〔2026-10-08 用户令:其为迭代 19 卡④的 T1 前置门且随同 goal 执行,归属随执行落位〕;候选 B-F 留档〔奇物改名/商店刷新收尾/C 三件/D 敌系/E 生涯/F 典检〕编入待用户点名) | —— | —— |
|
||||
| 迭代 21+ | **M4 数值批(**Alpha 收官位·未排期**〔2026-10-09 语义换代:M4=Beta 阶段、非 Alpha 收官位,M3 未由用户明令关闭前不排期维持〕——2026-10-05 用户令编入迭代 17 卡②;2026-10-06 用户令移出独立成批并定序「Alpha 阶段最后——内容补全先行、统一数值调整殿后」〔当日曾被编入迭代 18 为收官卡,2026-10-07 用户令撤回〕;**2026-10-07 用户令二次后移:后续新迭代(迭代 20 起)一律不先做 M4,除非用户明确要求启动 M4 批次**)**:四件数值欠账合一批——①削弱档位终值(weaken 现值 −65/duration 2/refresh 考证在册;叠层改续时语义已定案,差 duration 终值+当量锚复算)②调参批数值点评(06 条目现行登记五条——任务口径「八条」与条目五条不符,需求卡片 §2.2 已呈报差异以条目为准)③迭代 10 奖励重构联动欠账①②(钥石产出重标 boss_keystone 首杀 3/3/3·复杀 2/2/3 provisional + 通关率带重扫〔通关回血 20%+AP 件首轮 +1〕)④元进度定价剩余面(forge base 20/比 150 考证在册——06 条目文本「base 10」滞后于 2026-09-22 对齿批已呈报;Boss 两档终值)。读数义务随批=迭代 14 两件后置复算(T6 MC 四带复算+T7 技能池节奏重测,均挂 07);顺路修复 damage_probe A1 改前既有红灯(判式换代批出口报告 §四.7 在册)。**硬约束:一切 MC/verifier 跑批发起前须用户批准;调参联动禁独立调参网络(β 带 [1.2,2.5] 逐 u 检算)**。需求卡片=`design/research/需求卡片-M4数值批-2026-10-05.md`(**v1.2 2026-10-06 案C 增补+联审修订**:v1.1 三事实与第五推算件照旧;联审=P3 转正顺延至重扫读数后/检算工具 WEAKEN_PCT 入同步面/F11 两句死文本全刷/T3·T5 四带复算并账一次跑批双认账/R5 改前锚=本批新立案C 锚/估时段一勘误 4.25d;案C 增补内容照旧=§2.6 三事实〔行为换代/锚全作废/难度预判〕+T0 推算稿第五件=对拍锚按新序重推导+T6 四带复算按案C 新行为首采;T0-T8≈6.25d,天然切分点 T4 末;🔴 契约 5 条含跑批批准制;**✅ 裁点全裁(2026-10-06 用户令:P1甲=维持 2 场·magnitude [60,85] 带内当量锚复算、具体值随出口 provisional 追认/P2甲 不对称有意/P3甲 3-3-3·2-2-3 维持、转正顺延至重扫读数到账且带内(Q4 二裁)/P4甲 不立直购价);开工=U0**) | 迭代 18 全部内容卡(③④⑤⑦)出口+全部内容批行为变更落定+**用户发令(未排期)**——重锚窗口须收尽全部内容批行为变更 | T0-T8≈6.25d(超软盒预挂,段一 T0-T4≈4.25d〔v1.2 勘误,原 4.5 系加总错误〕/段二 T5-T8≈2.0d) |
|
||||
|
||||
|
||||
Reference in new issue
Block a user