merge: 迭代17卡④生涯界面设计立项落籍(设计提纲v0.1成文待用户评审——systems/跨局循环/生涯.md五节+02根索引CAREER行+06状态行+roadmap卡④行换代+台账379预配号;F1-F10代码级复核全绿两处行号勘误+registry存档版本注记滞后v4移交在册;纯文档零代码零测试,人闸=用户评审提纲+随裁P6营地最近冒险条带去留)

This commit is contained in:
DKChan committed 2026-10-06 21:09:03 +08:00
commit 44328b18d2
6 files changed
+175 -2

No files matched your search

+4
View File
@@ -11,6 +11,7 @@
- **工程路线图**:`production/roadmap.md`(2026-09-17 建——里程碑时间线 + 路线图;实时状态看下方快照节)
## 当前状态快照(收口批先更新本节,再追加台账;≤10 行)
- **更新于**:2026-10-06(**生涯界面设计提纲批完成**,迭代 17 卡④纯设计批——零代码、零数据面、零测试执行,worktree iter17-career-20261006 基点 fc4dbde,全部提交在 worktree 内未合并):设计提纲已按 P0 甲裁定写成正式设计文档 design/gdd/systems/跨局循环/生涯.md v0.1(状态=范围草案),五节写全(信息架构/承载内容清单/与既有界面关系/分期实装建议/待裁点);P0-P5 六个已裁决结论全部落进对应章节,任务书 §2 十条现状事实(F1-F10)逐条对照代码复核全绿;复核新发现一项待用户裁决点「P6 营地底栏『最近冒险』条带去留」(数据源与生涯历史回看同一份存档摘要、条带拼行无上限,扩容后会爆——建议期二时撤下、逐局回看整体归生涯)。同批改动:02-系统清单.md 根索引补生涯行与 CAREER 代号行、06 生涯条状态行改「设计提纲已成文待评审」、roadmap 迭代 17 卡④行改已交付待评审、出口报告落 design/qa/iter17-career-exit-report-2026-10-06.md。**下一步待用户=评审设计提纲**(评审时随裁 P6);评审通过后期一/二/三实装批另行立项,本批未预占任何排期。
- **更新于**:2026-10-06(**迭代17五任务书联审修订落籍 master 68b8f15**,纯文档零代码零测试,工作日志 378):五个 subagent 并行审查五份任务书(卡0①②③④),挖出约 50 处问题、8 处开工即停机级;用户十裁(Q1-Q10)全落——卡0 v1.1 效果闭集扩 2 型+charge_full 事件+level_clear 归登记+对拍判据两套(确定性复放=逐位/MC 统计量=同带 m4iter12 口径)+映射表五处修正;卡① v1.1 **P3 改裁丙撤投放**(一裁乙与首遇教学位纪律三面冲突)+P1 补遭遇骰交互(每行一骰·RNG 扩签先报批)+实例总数≤4 消歧+R6 行序契约+F7 勘误 19 行 9 种,估时 3.75d;卡② v1.2 P3 转正顺延重扫读数后+检算工具 WEAKEN_PCT 入同步面+T3/T5 并账+估时勘误段一 4.25d;卡③ v1.1 R4 快照口径收敛+Q10 甲 badge 工厂化(营地徽迁入 ui_kit)+P1 丁 06 Esc 登记补办+基线换代 iter16ui 后;卡④ v1.1 F4 事实改正(recent_summaries 现役 cap=10,非「无历史记录面」)+P2 甲口径重述(扩容+补用时埋点)+总局数/通关局数涉 save v6;roadmap 四行+06 四处+07 两条义务(T7 判读带案C 复核+后续内容批投放六面)随批换代;**五卡零待裁点重建,开工门=U0**。
- **更新于**:2026-10-06(**迭代17四卡18项裁点全裁落籍 master d5df1f6**,纯文档零代码零测试,工作日志 376):卡①P1甲/P2甲/P3乙投放教学位行/P4乙否推荐Boss行亦放开(零内容投放不变,Boss多行内容归后续批);卡②P1甲维持2场·magnitude[60,85]当量锚复算/P2甲不对称有意/P3甲转正/P4甲不立直购价;卡③P1丁/P2甲/P3甲/P4甲;卡④甲×6;四任务书裁决回填+roadmap四行+06六处换代,**四卡全部零待裁点,开工门=U0**;四段发射prompt已交付chat(用户逐卡贴goal,卡0段本会话早前已交付)。
- **更新于**:2026-10-06(**批次工作流标准清单固化进 CLAUDE.md**,worktree g-plan2-workflow-checklist 单提交 8438d4c+主区 merge --no-ff,工作日志 375;纯文档零代码零测试):用户确认十三条链路工作流无问题并选 A 案固化——CLAUDE.md 新增「批次工作流标准清单」节(开工前三步/环境与基线三步/实施两步/收口四步,每步附既往事故出处,总索引定位与细则冲突以细则为准)。
@@ -864,3 +865,6 @@
376. **迭代17四卡18项裁点全裁落文(2026-10-06,用户在本会话逐卡裁断:卡①P4乙否决推荐其余按推荐/卡②P1甲其余按推荐/卡③卡④全按推荐;worktree g-plan2-rulings4 分支 rulings-iter17-cards-20261006 单提交 de44416,主区 merge --no-ff d5df1f6,worktree 已清;纯文档零代码零测试)**:四份任务书 §8 待裁点逐项裁决回填——卡①敌人行集多行批 P1甲(每行各自 unit_count·行集总数≤4·UNIT_COUNT_MAX 改单种数语义)/P2甲(floor 版退役全仓统 ceil,工作日志 312 待裁销号)/P3乙(投放 L2 教学位混编行巨蜘蛛1+钩爪恐魔1·行值 provisional·MC 取证先报批)/P4乙(**用户否决推荐甲**——Boss 行集校验同样放开;知情代价=半血解锁/难度带读数面可被 Boss 行内容变量影响;本批零内容投放不变、Boss 多行内容投放归后续内容批、节奏重测义务 07 在册);卡②M4数值批 P1甲(维持 2 场·magnitude 终值当量锚复算 [60,85] 带内落定随出口追认)/P2甲(不对称有意落文设计立场零改动)/P3甲(钥石 3-3-3·2-2-3 转正)/P4甲(不立直购价维持次数阈值单一渠道);卡③暂停层 P1丁/P2甲/P3甲/P4甲;卡④生涯设计 P0甲/P1甲/P2甲(N=20/50 实装期定)/P3甲/P4甲/P5甲;roadmap 四行换代「✅ 裁点全裁+开工=U0」+06 状态行全收;**迭代17五卡全部零待裁点**(卡0 早零裁点),发射 prompt 四段交付 chat,用户逐卡串行贴 goal。
377. **M4 数值批移批迭代 18(2026-10-06 用户令「不要影响迭代17,放到迭代18中」;worktree g-plan2-m4move 分支 m4-to-iter18 单提交 c38489a7,主区 merge --no-ff ed38c54,worktree 已清)**:缘起=用户质询「迭代17已在另一会话开发且编排封板,你的修改是否影响别人开发」——查证=iter17dd worktree(⓪数据驱动扩展头卡在飞,基线 7d3e88f 零提交)与我的改动执行路径零交集但 roadmap/06 共享文档构成合并冲突候选+②M4 行被我 v1.1 增补时提前改写(封板越权);用户裁=移批。落面:①roadmap 迭代 17 删 ②M4 行(余 ⓪①③④,③④卡号维持原号不重排=零影响在飞引用),行尾新立迭代 18 行=M4 全量内容原样迁移(含 v1.1 案C 增补+用户四裁点全裁注记 P1甲/P2甲/P3甲/P4甲——该注记系并行会话 d5df1f6 迭代17四卡18项裁点全裁落籍所加,迁移时原样保留),前置列改「迭代 17 出口」;②任务书归属行改迭代 18;③06 五处「迭代 17 卡② M4 数值批」状态行改「迭代 18」+移出注记。**台账撞号史实**=master 现存两个 373(并行会话 373=数据驱动扩展任务书 v1.0、本线 373=M4 任务书 v1.1——本线未提交行被并行快照 9c6d5e2「原样落籍零丢失」吸收所致),不改史只登记;下个空号=377。闸=gdd_lint 对基线零新增(纯文档)。**现行编排态**=迭代 17(⓪①③④,iter17dd 在飞)→ 迭代 18(M4 数值批,任务书 v1.1+四裁点全裁,开工=U0 待发令)。
379. **生涯界面设计提纲批完成(2026-10-06,迭代 17 卡④纯设计批——零代码、零数据面、零测试执行;worktree g-plan2-iter17-career 分支 iter17-career-20261006 基点 fc4dbde,提交 10df8ba 加批次收尾提交;本条为编排会话预配号,落籍序以合并为准)**:设计提纲写成正式设计文档 design/gdd/systems/跨局循环/生涯.md v0.1(状态=范围草案,2026-10-06 用户裁 P0 甲案)——五节写全:信息架构(主菜单一级入口与营地平级=P1 甲,局内不放入口、生涯内零跳转=P4 甲)、承载内容清单(跨局汇总/历史冒险回看/图鉴三段逐项标数据源与可行性,历史回看=P2 甲每局一行摘要加扩容加补用时埋点,图鉴=P3 甲敌人优先、奖励格图鉴只登记不激活,单局明细由 settlement_review_overlay 复活承接=P5 甲)、与既有界面的关系(营地/暂停层/结算屏/帮助手册/图例五界分工矩阵)、分期实装建议(期一汇总页/期二历史回看/期三图鉴,均为另行立项不预占排期,实装批前置义务=对齐迭代 16 UI 基线与 N 终值读数、用时埋点口径呈报)、待裁点(新发现 P6=营地底栏「最近冒险」条带去留,三案全列含淘汰依据,建议期二撤下归生涯——该条带与生涯历史回看读同一份存档摘要且拼行无上限,扩容后会把底栏撑爆,是本批复核发现的实际耦合)。任务书 §2 十条现状事实 F1-F10 逐条对照代码静态复核全绿(回看退役三处注记、settlement_review 遗留件在盘无引用、recent_summaries 现役 cap=10、用时零采集点、终身计数域缺失、营地最近冒险清单渲染行等全实证;一处既有滞后顺带记录=registry 存档条目版本注记停在 v4 而代码已 v5,不属本批范围移交后续对齐批)。同批落:02-系统清单.md 根索引补生涯行+CAREER 代号行+v1.12 版本行、06 生涯条状态行改「设计提纲已成文待评审」、roadmap 迭代 17 卡④行改已交付待评审、出口报告=design/qa/iter17-career-exit-report-2026-10-06.md(完成定义五条判定+事实复核差异记录+提交哈希)。**下一步待用户=评审设计提纲**(评审时随裁 P6);实装批另行立项。
+3
View File
@@ -52,6 +52,7 @@
| 文件 | 一句话概要 | 状态 |
|---|---|---|
| `元进度.md` | 跨局成长(旧体系未单独成文) | 已定稿·已实现 |
| `生涯.md` | 主菜单一级的局外只读界面——跨局汇总、历史冒险回看、图鉴承接(冒险中数据回看的唯一承接处,P-C7 裁决) | 范围草案·待评审 |
### 表现与支撑(`systems/表现与支撑/`)
@@ -99,6 +100,7 @@
| 冒险循环 | 难度曲线与Boss | `DIFFICULTY_CURVE` | c3 |
| 冒险循环 | 奇物 | `ADVENTURE_CURIO` | `ADVENTURE_FEATURE`(v1.0)→ `ADVENTURE_REWARD`(v2.0,v2.4 退役) |
| 跨局循环 | 元进度 | `META_PROGRESS` | c4 |
| 跨局循环 | 生涯 | `CAREER` | —(新立无旧代号,无代码实现面) |
| 表现与支撑 | HUD框架 | `HUD_FRAMEWORK` | d1 |
| 表现与支撑 | 数据配置 | `DATA_CONFIG` | d2 |
| 表现与支撑 | 存档序列化 | `SAVE_SERIALIZATION` | d3 |
@@ -137,3 +139,4 @@
| v1.9 | 2026-10-05 | 《奖励》改名为《奇物》并升 v2.4:顶层定名 Wondrous Item(DND 魔法物品九分类中的兜底杂类,官方中文译名「奇物」)。文档树冒险循环行改名;命名对照表 `ADVENTURE_REWARD` → `ADVENTURE_CURIO`(**不用 `reward_*`**——`reward_pick` 流 / `reward_node` context / `reward_preview` kind 已占用该词族) |
| 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` 行(无代码实现面,代号随实装批对齐) |
+1 -1
View File
@@ -401,7 +401,7 @@
**归属**:新界面立项(用户发令后排批);退役落码随 UI 落码批 M8/M9
**状态**:待办(生涯未做前,冒险中无任何历史回看入口——已知代价,用户知情裁决)——**已编入 roadmap 迭代 17 卡④(2026-10-05——设计提纲版裁点已全裁〔2026-10-06 用户令全按推荐:P0甲/P1甲/P2甲/P3甲/P4甲/P5甲〕,并经同日五任务书联审修订〔v1.1〕:历史摘要面实为 recent_summaries 现役 cap=10 非空白、P2 甲口径重述=扩容+补用时埋点、总局数/通关局数标注涉存档 schema、营地既有最近冒险清单去留列入设计稿必答项;待 U0:design/research/任务书-生涯界面设计立项-2026-10-05.md,实装批另行立项)**
**状态**:待办(生涯未做前,冒险中无任何历史回看入口——已知代价,用户知情裁决)——**设计提纲已成文待评审**(2026-10-06 迭代 17 卡④设计批完成:提纲 = [systems/跨局循环/生涯.md](systems/跨局循环/生涯.md) v0.1 范围草案,五节成文〔信息架构/承载内容清单/与既有界面关系/分期实装建议/待裁点〕,现状描述经代码级复核;P0-P5 六裁点已全裁落文〔P0甲 提纲落正主 / P1甲 主菜单一级入口 / P2甲 每局一行摘要+cap 扩容 N+补用时埋点 / P3甲 敌人图鉴优先 / P4甲 局内不放入口+生涯零跳转 / P5甲 settlement_review 复活承接〕,新发现待裁点 P6 营地最近冒险条带去留随评审一并裁。**人闸 = 用户评审提纲**;实装批另行立项,期一/二/三均未预占排期)
### GP 经济
+105
View File
@@ -0,0 +1,105 @@
# 生涯
> **一句话定位**:主菜单里与营地平级的**局外只读界面**——营地管「花」(花钥石买永久强化),生涯管「看」(看自己跨局攒下的一切:累计战绩、历史冒险、图鉴收集)。冒险进行中不给任何数据回看(2026-10-04 用户裁决 P-C7 的延续),生涯是历史数据唯一的家。
> **状态**:范围草案(2026-10-06 迭代 17 卡④设计提纲批成文,待用户评审;评审通过后期一/二/三实装批另行立项,本文不预占排期)。
> **来源**:[06-待办清单「『生涯』界面——冒险中数据回看的唯一承接处」条](../../06-待办清单.md)(2026-10-04 用户裁决 P-C7——冒险中不给数据回看,历史战报与结算明细的查看去向 = 新「生涯」界面)。
## 一、信息架构
生涯入口是主菜单一级按钮,与营地平级(2026-10-06 用户裁,备选案与淘汰依据见任务书 P1)。现行主菜单按钮组由 `build_start_overlay` 构造(`game/presentation/ui_assembler.gd:104`):「冒险」组(继续上局 :138 / 开始冒险 :144)与「营地与系统」组(营地 :150 / 设置 :152 / 退出游戏 :156),另有右下角调试角标(DS_DEBUG=1 门控,与主按钮组非平级)。生涯按钮与营地平级同列一级;具体组帽归属与按钮排位属布局细节,归期一实装批(本文不画布局稿)。
```
主菜单(开始覆盖层)
├─ 冒险组:继续上局 · 开始冒险
├─ 营地与系统组:营地 · 生涯(本提纲新增) · 设置 · 退出游戏
└─ 调试角标(DS_DEBUG=1 门控,非平级)
生涯(局外只读面)
├─ 跨局汇总(累计战绩与解锁总览)
├─ 历史冒险回看(逐局摘要与单局明细)
└─ 图鉴(敌人优先,秘宝/奇物随后)
```
边界三条(均为 2026-10-06 用户裁 P4 甲):
1. **局内不放生涯入口**。冒险进行中玩家只看暂停层(迭代 17 卡③并行批——局内只读查看钥石与解锁进度);若历史回看能从局内到达,等于绕回 P-C7 退役前的形态,禁止。
2. **生涯内零跳转**。不放「去营地」之类的操作引导,生涯纯只读。
3. **与 P-C7 的关系**:生涯的成立正是 P-C7 裁决的补偿面——「冒险中无回看」的已知代价由生涯承接(06 条目原文口径),本文不提议在冒险中恢复任何回看入口。
## 二、承载内容清单(逐段标数据可行性)
生涯装三段内容:跨局汇总、历史冒险回看、图鉴。这三段是 06 条目给定的骨架,本节在其上逐项落到数据源。跨局汇总与图鉴的收集类数据大多现成;历史回看的数据面已在存(见下),缺口只有三件,已随 P2 甲裁决定方向。
### 跨局汇总(期一)
| 内容 | 数据源 | 现状 |
|---|---|---|
| 冒险总局数 / 通关局数 | 无现成数据源——`first_adventure_done` 是布尔(`save_manager.gd:117`)、`level_clear_counts` 按关计次(`:109`)反推不出总局数、`recent_summaries` 有上限截断不能累总 | 须新增两个终身计数域,涉存档 schema 迁移(save v6 义务,2026-10-06 用户裁归期一实装批) |
| 各关通关次数 | `clear_count(level_index)`(`save_manager.gd:238`) | 现成 |
| Boss 首杀与总击杀 | `boss_first_kill_marked`(`save_manager.gd:242`)/ `boss_kill_count`(`:250`) | 现成 |
| 钥石余额 | `keystone_balance`(`save_manager.gd:202`) | 现成。累计收支流水不在存(加钥石与花钥石只动余额,`:206`/`:211`)——如要做属新增流水域,期一实装批另呈报,本文只登记 |
| 三柜台解锁完成度概览 | 锻造 `forge_level`(`save_manager.gd:218`)/ 工坊 `workshop_status`(`meta_progression.gd:90`)/ 天赋树 `tree_nodes`(`save_manager.gd:256`) | 现成只读投影 |
### 历史冒险回看(期二)
数据面现役事实:每局冒险收束时已有逐局摘要自动入档——`recent_summaries`(默认域 `save_manager.gd:116`、值拷贝访问器 `:316`、入账原语 `:325-338` 逐局插最前并按上限截断),上限 `SUMMARY_CAP := 10`(`:40`)。摘要字段在冒险收束时组装(`adventure_runner.gd:1005-1018`:结局 result、通关关数 levels_cleared、止步关 stopped_at、钥石合计 keystone_total、本局主种子 master_seed,另附逐杀掉落 keystone_drops 与终局特性 relics 等);摘要的内容口径 owner = [冒险结构](../冒险循环/冒险结构.md),本文不复述其口径。
2026-10-06 用户裁(P2 甲):每局一行摘要,行内给**结局 / 到达关卡 / 钥石收入 / 用时**四件事,上限存最近 N 局。对应三件实绩(本批代码级复核确认的缺口,非新建数据面):
1. **扩容**:cap 10 → N。N 候选 20 / 50 / 维持 10,实装期按存档体积读数三选一;读数方法与列表形态的参数化维度由设计稿给出、实装期执行。
2. **补「用时」埋点**:全仓现在没有任何用时采集点(`game/core/` 内 grep elapsed / ticks / duration / Time 零命中;摘要字段集 `adventure_runner.gd:1007-1018` 无此项)——属新增埋点,随期二。
3. **旧档迁移**:旧档既有 ≤10 条摘要原样保留迁移,向后兼容。
单局结算明细回看:遗留件 `settlement_review_overlay.gd`(`game/presentation/views/`,文件本体在盘、全仓无实例化引用——仅 `ui_kit.gd:356` 样式注记提及)由期二实装批复活承接,改挂生涯(2026-10-06 用户裁 P5 甲)。
可选增强(不占期、不上列):关键构筑列——摘要已附终局特性集 relics(`adventure_runner.gd:1017`),实装期评估是否呈现。
### 图鉴(期三)
- **敌人图鉴(优先,2026-10-06 用户裁 P3 甲)**:直接承接 06 在册「敌方技能图鉴 / 学习呈现」条(P2——见过 → 认得 → 记谱;归属 [HUD 框架](../表现与支撑/HUD框架.md) 与 [敌人系统](../战斗循环/敌人系统.md))。「见过」记账面 = 新增 meta 域,涉存档 schema 迁移(与期一终身计数域同属 schema 义务面;版本号按实装时点的现行版本顺延)。
- **秘宝 / 奇物图鉴(随后)**:无在册条目,立项时另行登记。
- **奖励格图鉴:只登记不激活**(P3 甲)。营地柜台三「奖励格图鉴」现况 = 柜台框在(`camp_overlay_view.gd:121`)、下段由天赋树行占用(`:128` 注记),图鉴本体空置;该柜台已随配比预设批整体挂起冻结(2026-10-05 用户令,06 在册),重启须用户另行发令。
## 三、与既有界面的关系
| 界面 | 管什么(现状指证) | 与生涯的边界 |
|---|---|---|
| 营地([camp UX spec](../../ux/camp.md)) | 跨局成长**操作**面(花钥石买强化 / 装配 / 点树)+ 底栏「最近冒险」条带——`camp_overlay_view.gd:431` `_rebuild_recent()` 逐局拼行(`:442`「完成/放弃/失败 · 通关 N 关 · 钥石 +N · 种子 N」,无截断上限),数据源 = `camp_shop_presenter.gd:85` 投影的同一份 `recent_summaries` | 营地不改生涯只读定位;生涯不做任何购买入口,也不放「去买」按钮。营地条带的去留是本提纲必答项——见 §五 P6 |
| 暂停层(迭代 17 卡③,并行批开发中) | **局内**只读查看这一局进行中的钥石与解锁进度 | 暂停层看当局当前值,生涯看跨局累计与历史;局内无生涯入口(P4 甲) |
| 结算屏([settlement-summary UX spec](../../ux/settlement-summary.md)) | 冒险收束当下的入账明细——`main.gd:537` `_on_adventure_finished` 收束时呈现摘要与钥石明细(复用终局面账行,`battle_end_overlay.gd:118-129`) | 收束当下的呈现保留不动;生涯承接的是收束之后的任意时刻回看 |
| 帮助手册(Beta 批,未实装——教学内容归 Beta 帮助手册,`ui_assembler.gd:99` 注记) | 讲「怎么玩」 | 生涯讲「我玩过什么」。图鉴条目文案与手册是否共用内容源,接口登记归 Beta 批一并裁 |
| 图例面板(legend_overlay) | 局内符号/徽标即时解码 | 不合并——图例是局内解码面,图鉴是跨局收集面 |
## 四、分期实装建议
三期均为**另行立项**的实装批,下表是建议不是排期,roadmap 迭代位由用户逐期点名。本提纲不含布局稿、视觉稿、素材需求清单(美术由用户独立成批自理,2026-10-05 立规)。
| 期 | 内容 | 前置 | 建议窗口(候选) |
|---|---|---|---|
| 期一 | 跨局汇总页 + 主菜单生涯入口落位。总局数/通关局数两个终身计数域随该批做存档 schema 迁移 | 提纲评审通过。实装批前置义务 = 对齐迭代 16 UI 批后的现行基线:`FS_*` 六档字号 / `TG_*` 语义色 / `BUTTON_MIN_H=40`(`ui_kit.gd:437`)/ 色板单源 / `page_shell` 模态栈纪律(`ui_kit.gd:394`)——与卡③任务书同款红线,本文只登记、不展开 | Alpha 后最近一个 UI 窗口 |
| 期二 | 历史冒险回看整段:N 扩容 + 用时埋点 + 旧档摘要迁移 + 逐局列表 + 单局明细(`settlement_review_overlay.gd` 复活承接)+ 营地条带处置(P6 裁案落地) | 期一。实装批开工前须向用户呈报两件:N 终值读数(20 / 50 / 维持 10 三选一)与「用时」埋点口径(计时起点、暂停是否计入——字段级细节本文不做) | 期一落地后独立批 |
| 期三 | 图鉴承接(敌人优先,范围与顺序随 P3 甲);「见过」记账面 schema 义务随该批执行 | 期二或独立评估 | Beta 窗口候选(与教学引导同段评估——图鉴的「认得」轴与教学相关;06 教学引导节各条 2026-10-04 起已整体标 Beta 阶段) |
本地化文案权:生涯界面本体按钮、页签、空态文案归[设置与本地化](../表现与支撑/设置与本地化.md)线(全仓无多语言实装——`game/` 内 grep TranslationServer 零命中;文案权先例 = 教学文案定稿权登记于 06),实装批承接。
## 五、待裁点
P0-P5 六点已于 2026-10-06 用户全裁(案甲 × 6,备选案与淘汰依据在任务书 §8),结论已落文上文对应节,不重复列。本批新发现的待裁点一项:
### P6 · 营地底栏「最近冒险」条带去留(期二必答项)
**现状与问题**:营地底栏「最近冒险」条带把传入的摘要逐行全部拼进一个 Label(`camp_overlay_view.gd:431-443`,`:442` 行模板,无截断上限),数据源与生涯历史回看是同一份 `recent_summaries`(`camp_shop_presenter.gd:85`)。生涯期二把上限扩到 N 后,条带按现行逻辑会把 N 行全拼进底栏——这是本批复核发现的实际耦合点,期二落地时必须给条带一个去处。
| 案 | 内容 | 淘汰/保留依据 |
|---|---|---|
| 甲(建议) | 期二生涯历史回看落地时,营地条带撤下、逐局回看整体归生涯;期一(汇总页上线、数据面未动)期间条带原样保留零改动 | 分工矩阵干净——「看」归生涯、「买」归营地;逐局历史只剩一个权威呈现面,去重问题自然消解;顺带解开 N 扩容后底栏无上限拼行的实耦合 |
| 乙 | 两处并存——营地留最近几条速览、生涯给完整列表 | 营地顺手一眼仍有价值;淘汰候选:同一数据两处呈现,玩家要猜哪边全;条带须另加截断逻辑 = 新增一处维护面;「看」留在操作面违反分工矩阵 |
| 丙 | 条带原样永久保留(固定存 10 条,不随 N 动) | 改动最小;淘汰候选:与生涯列表长期双轨,上限语义分裂(营地固定 10 / 生涯 N),N 大于 10 后两处看到的条数对不上 |
裁决方式:随本提纲评审一并定案,期二实装批执行。
## 版本历史
| 版本 | 日期 | 说明 |
|---|---|---|
| v0.1 | 2026-10-06 | 设计提纲首版(迭代 17 卡④设计批,纯文档):五节成文;P0-P5 已裁结论落文;新发现待裁点 P6(营地最近冒险条带去留);现状描述全部经代码级复核(F1-F10,见 design/qa/iter17-career-exit-report-2026-10-06.md)。状态 = 范围草案待评审 |
@@ -0,0 +1,61 @@
# 出口报告:生涯界面设计立项(迭代 17 卡④设计批)
> 批次:纯设计批(零代码、零数据面、零测试执行——两入口铁规:非 loop 实施批且用户未点名)。
> worktree:`g-plan2-iter17-career`(分支 `iter17-career-20261006`,基点 = master fc4dbde)。
> 任务书:`design/research/任务书-生涯界面设计立项-2026-10-05.md`(v1.1 零待裁点,U0 已发)。
> 本报告按「吸收即死」纪律属中间文档,寿命 = 迭代寿命;五条判定与 F1-F10 复核结论已同步写进各正式文档(生涯.md / 06 / roadmap)。
## 一、完成定义五条逐条判定(任务书 §1.2)
| # | 判定项 | 判定 | 依据 |
|---|---|---|---|
| 1 | 提纲成文 | ✅ | `design/gdd/systems/跨局循环/生涯.md` v0.1(P0 甲裁定的载体,状态=范围草案),五节齐:一、信息架构;二、承载内容清单;三、与既有界面的关系;四、分期实装建议;五、待裁点 |
| 2 | 事实对齐 | ✅ | §2 事实表 F1-F10 逐条代码级复核全绿(见本报告 §二);提纲中每句现状描述带 file:line 指证(R1) |
| 3 | 裁点齐备 | ✅ | P0-P5 已裁结论全部落文对应节;本批新发现待裁点一项(P6 营地最近冒险条带去留),三案全列含淘汰依据、有明确建议案;全文无「待定」悬空 |
| 4 | 零实装 | ✅ | diff 仅含:新建生涯.md、02-系统清单.md 三行(树行/代号行/版本行)、06 状态行、roadmap 卡④行、active.md、本报告;`game/` 零改动、存档零改动、零测试执行 |
| 5 | 人闸 | ✅(待用户执行) | 06 状态行已更新为「设计提纲已成文待评审」;**人闸 = 用户评审提纲**(评审时随裁 P6) |
## 二、T0 事实复核 F1-F10(2026-10-06 静态阅读,行号以实核为准)
| # | 事实 | 结论 | 实核证据(file:line) |
|---|---|---|---|
| F1 | 冒险中回看已退役 | ✅ 绿 | `battle_end_overlay.gd:9`(signal continue_pressed,注记 review_pressed 退役)、`:106`(明细回看钮退役注记)、`:90` 现为 GP 账目行 add_child——任务书 v1.0 的 :90 漂移勘误属实;`battle_log_view.gd:47`(「上轮摘要(回看归「生涯」」提示)、`:115`(带点击回看入口退役注记);`ui_assembler.gd:67`(明细回看 overlay 退役注记) |
| F2 | settlement_review_overlay.gd 在盘 | ✅ 绿 | `game/presentation/views/settlement_review_overlay.gd` 在盘(含 .uid);全仓无实例化引用——仅 `ui_kit.gd:356` 样式注记提及「settlement_review 同款」;无 .tscn 引用 |
| F3 | 跨局持久面 = save v5 meta 域 | ✅ 绿 | `save_manager.gd:39`(SAVE_FORMAT_VERSION=5 版本链注记)、meta 默认域键集 `:106-117`(keystone_balance/forge_levels/item_unlocks/level_clear_counts/boss_first_kill/boss_kill_count/attunement_equipped/attune_refresh_level/tree_nodes/fork_sides/recent_summaries/first_adventure_done)+ 访问器面 :202-:316 |
| F4 | recent_summaries 现役 + 三件真实缺口 | ✅ 绿 | `save_manager.gd:40` SUMMARY_CAP=10;`:316` 值拷贝访问器;`:325-338` apply_adventure_summary(push_front + cap 截断 + boss_drops 副本 :334);`meta_progression.gd:129` settle_adventure 经 `:133` 归档(:125 注记)。缺口①cap 扩容、②用时零采集点(game/core grep elapsed/ticks/duration/Time 零命中;摘要字段集 `adventure_runner.gd:1007-1018` 无用时)、③总局数/通关局数无 lifetime 域(first_adventure_done 布尔 :117、level_clear_counts 按关 :109)——三条全实证 |
| F5 | 当局结算呈现仍在 | ✅ 绿 | `main.gd:537` `_on_adventure_finished` 收束当下呈现摘要五件事+钥石入账明细;终局面三行账 `battle_end_overlay.gd:118-129`(open_victory 账行装配) |
| F6 | 跨局汇总数据源现状 | ✅ 绿 | 各关通关次数 `save_manager.gd:238`、Boss 首杀/总击杀 :242/:250、钥石余额 :202(累计收支无流水——:206/:211 只动余额)、锻造/工坊/天赋树访问器 :218/:230/:256;总局数/通关局数两格无数据源(同 F4③) |
| F7 | 图鉴承接候选内容 | ✅ 绿 | 06:192「敌方技能图鉴 / 学习呈现」(P2,见过→认得→记谱);奖励格图鉴柜台空置——06:244(随配比预设批挂起冻结)、`camp_overlay_view.gd:121`(柜台三框在)、`:128`(下段天赋树行占用注记) |
| F8 | 相邻界面分工现状 | ✅ 绿 | 营地 `camp_overlay_view.gd:431` `_rebuild_recent()`、`:442` 行模板「完成/放弃/失败 · 通关 N 关 · 钥石 +N · 种子 N」(无截断上限)、`camp_shop_presenter.gd:85` recent 投影;主菜单按钮组 `ui_assembler.gd:104-160`(营地 :150);设置面 :152;暂停层 = 迭代 17 卡③并行批(本 worktree 基点未含其实码,提纲按任务书口径引用) |
| F9 | 06 条目原文口径 | ✅ 绿 | 06:400「新「生涯」界面(跨局汇总/历史冒险回看/图鉴承接)」三段骨架原文在册 |
| F10 | 阶段语境 | ✅ 绿 | 06 教学引导节各条状态行 Beta 阶段注记(:375/:383/:391,2026-10-04 拍板改排);生涯条目(06:396-404)无阶段标注——提纲分期建议以候选窗口作答 |
**差异记录(两处,均不阻塞)**:
1. `ui_assembler.gd` 实际路径为 `game/presentation/ui_assembler.gd`(任务书 F1 只写文件名未带路径,无歧义;提纲已用全路径引证)。
2. 复核顺带发现一处**既有**登记滞后(非本批引入、不属本批范围):`design/registry/entities.yaml` 存档条目 version 注记仍写「SAVE_FORMAT_VERSION=4 / v1→v4 迁移链」,代码已至 v5(`save_manager.gd:39`,v5=天赋树域,迭代 12);domains 行的 meta 域九件明列与 recent_summaries cap 10 记载仍准确。属 registry 与代码的同步欠账,owner 文档 = 存档序列化.md,建议归后续文档对齐批或 doc 一致性检查呈报——本批 diff 范围不含 registry,未动。
## 三、交付物与落点
| 交付物 | 落点 | 状态 |
|---|---|---|
| 设计提纲(本批主体) | `design/gdd/systems/跨局循环/生涯.md` v0.1 | 范围草案,待用户评审 |
| 根索引同步 | `design/gdd/02-系统清单.md`(跨局循环树行 + 命名对照表 CAREER 行 + v1.12 版本行) | 已落 |
| 06 状态行 | `design/gdd/06-待办清单.md` 生涯条 →「设计提纲已成文待评审」 | 已落 |
| roadmap 卡④行 | `roadmap.md` 迭代 17 卡④ →「✅ 设计提纲已成文待用户评审……人闸=用户评审提纲」 | 已落 |
| 会话记录 | `active.md`(快照节追加 + 台账 379) | 已落 |
## 四、提交哈希清单
| 提交 | 内容 |
|---|---|
| 10df8ba | T1:生涯.md v0.1 成文 + 02 根索引三处(树行/CAREER 行/v1.12) |
| (本提交) | T2 加批次收尾:06 状态行、roadmap 卡④行、active.md、本报告 |
终态 = worktree 内全部提交完成,**未合并、未 push**(合并落回 master 由用户/编排会话执行)。
## 五、遗留与移交
1. **人闸(唯一)**:用户评审设计提纲 `design/gdd/systems/跨局循环/生涯.md`,评审时随裁新发现的 P6(营地底栏「最近冒险」条带去留——建议甲:期二时撤下归生涯)。评审通过后期一/二/三实装批另行立项。
2. 实装批前置义务已在提纲 §四登记(非本批工作):期一=对齐迭代 16 UI 基线 + save v6 两个终身计数域;期二=N 终值读数呈报(20/50/维持 10 三选一)与用时埋点口径呈报;期三=「见过」记账面 schema 义务。
3. registry 存档条目 version 注记滞后(§二差异记录 2)——移交后续文档对齐批,非本批范围。
+1 -1
View File
@@ -67,7 +67,7 @@
| 迭代 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 |
| 迭代 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 出口 | T0-T8≈3.75d(超软盒预挂,T4 末切分点) |
| 迭代 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 出口 | T0-T5≈3.0d(贴软盒,T2 末切分点) |
| 迭代 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 出口 | T0-T2≈1.25d(软盒内) |
| 迭代 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 | **M4 数值批(2026-10-05 用户令编入迭代 17 卡②;2026-10-06 用户令移出独立成批——不影响迭代 17 在飞开发,17 卡号 ③④ 维持原号不重排)**:四件数值欠账合一批——①削弱档位终值(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**) | 迭代 17 出口 | T0-T8≈6.25d(超软盒预挂,段一 T0-T4≈4.25d〔v1.2 勘误,原 4.5 系加总错误〕/段二 T5-T8≈2.0d) |
## 执行纪律(2026-09-27 用户立规)