docs(rules): 「工作日志」废止全仓改「状态记录」+会话状态清除新规+秘宝实装待办登记(2026-10-10 用户令)

- 五文件 105 处「工作日志」→「状态记录」(active.md 31/doc-conventions 13/CLAUDE.md 5/06 10/roadmap 46;残留 2 处系更名动作引述保留)
- doc-conventions §10 章程:定性补「状态记录,不是工作日志——旧叫法废止」+退役规则首句落新规「用户确认任务完成时清除当前会话写过的状态条目——状态清除即任务完成证明」
- 06 新条「秘宝体系实现重构落地批」(冻结待发令):新 15 件实装+旧数据行清理(deferred 清零)+27 专长行删除+空配置验收闸+池选型三案+效果引擎扩签核实+两疑似漏项 T0
This commit is contained in:
DKChan committed 2026-10-10 15:17:08 +08:00
1 parent c6727e2cc4
commit c848cefe9a
5 files changed
+78 -65

No files matched your search

+5 -5
View File
@@ -18,7 +18,7 @@
工作目录 = 切片目录本身(含 `project.godot` 的那一层):
- 冒烟(全量 headless 断言):`python tools/run_smoke.py`(包装器三闸:退出码+摘要失败数+SCRIPT ERROR 扫描——脚本错误不计冒烟失败数且静默中断所在函数剩余断言,2026-09-19 工作日志 84 立闸)。底层命令 = `…console.exe --headless --path . --script res://smoke/smoke_all.gd`
- 冒烟(全量 headless 断言):`python tools/run_smoke.py`(包装器三闸:退出码+摘要失败数+SCRIPT ERROR 扫描——脚本错误不计冒烟失败数且静默中断所在函数剩余断言,2026-09-19 状态记录 84 立闸)。底层命令 = `…console.exe --headless --path . --script res://smoke/smoke_all.gd`
- 场景级探针(呈现层回归):`…console.exe --headless --path . res://smoke/ui_probe.tscn`;另有 `ui_tune_probe.tscn`(调试浮窗——2026-10-04 迭代 14.5 起原数值调整板收进 debug_overlay)、`ui_click_probe.tscn`(合成鼠标事件行为探针)
- 调参期批量工具:`--script res://smoke/adventure_monte_carlo.gd`(全冒险期望扫描)· `--script res://smoke/reward_expectation.gd`(奖励获取期望)——单关直入口口径已退役(2026-09-23 用户拍板),通关率/难度类测量一律走全冒险(原 level_monte_carlo/level_debug 已删)
- 数值验证工具:`python tools/balance_verifier.py`(零强化冒险逐关条件通关率+止步节点归因+营地循环爬升战役——采集端 `--script res://smoke/verifier_batch.gd`,报告落 `design/qa/`;元进度换算率标定与曲线调参的自动化评判面,2026-09-22 数值验证工具批;直入口带判定随口径退役暂停,带重锚归曲线调参批)
@@ -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 侧,用户本人手工改动不受限
@@ -105,7 +105,7 @@
**收口**
9. **批末四闸全绿才合并**——冒烟 + 单元测试 + 场景探针 + 改前改后读数对拍,四项全绿方可在主工作区合并
10. **合并后主区全量复跑**——合并本身可能引入冲突或环境差异,落回 master 后再跑一遍全套验证
11. **会话收口落记**——`active.md` 快照与工作日志更新(含删除已完结旧条目,退役规则见 `design/dev/doc-conventions.md` §10);跨会话有效的教训写入记忆库
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,勿把旧文当现行事实。需求卡片仍必列「关联文档同步面」,同步义务按两层标注(机械面=随批更新;设计面=报告反哺)
13. **实机目检归用户**——真机人闸由用户执行,用户亲口确认才算验收通过
14. **中间产物吸收即死**——结论先迁入正主文档(GDD/待办清单/路线图),中间文件即删且永不提交(细则见硬性红线)
@@ -116,7 +116,7 @@
- **测试执行两入口铁规(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-04 用户立规,黑话审计后落文)**:面向用户的一切输出——文档、工作日志(active.md)、报告、清单、对话——禁止自造黑话与代号式命名;判据 = 业内读者没读过项目历史也能一遍看懂,需要作者解释才能懂的词必须展开成完整白话句(三种固定形态、本仓反例全表与正确写法见 `design/dev/doc-conventions.md` 第 4 节)
- **用语红线(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 缺陷或相关方案**的呈报;同一方案的后续对答(追问、讨论、细化、执行汇报)不再套用六问结构,除非用户显式要求
- **数值单一事实源**:玩法数值只存 `data/tables/`(.tres),经 `ConfigDB` autoload 类型化单点读取;禁止数值字面量与自建 `load()` 表路径
+25 -22
View File
@@ -16,30 +16,32 @@
- **工程路线图**:根目录 `roadmap.md`(2026-09-17 建——里程碑时间线 + 路线图;实时状态看下方快照节)
## 当前状态快照(收口批先更新本节,再追加工作日志;≤10 行)
- **更新于**:2026-10-10(**第一版秘宝全弃用收官批**——worktree treasure-lib-13 自治合入;用户裁「退役与封存都进素材库,无留待 Alpha 重定的挂起」并质询出我此前对封存态的处理偏差;工作日志 432):显影尘/地穴全图卷 deferred→retired(2026-09-29 拍板④甲终结)+秘宝.md v1.9 四处正文换代(豁免面/五维度表信息行/投放态/护栏验收)+素材库四件(探宝罗盘/工兵令/显影尘/地穴全图卷)迁表一(表一 9→14 件〔顺带修正标题 9 件漏计提灯〕、表三摘除留指路句);数据表四行删除归退役删行批
## 当前状态快照(收口批先更新本节,再追加状态记录;≤10 行)
- **更新于**:2026-10-10(**状态记录更名+新规落文+秘宝实装待办登记批**——worktree status-record-batch 自治合入;用户三令):「工作日志」旧叫法全仓清扫改「状态记录」(五文件 105 处——active.md/doc-conventions/CLAUDE.md/06/roadmap;残留来源=立宪时只改定性未扫正文,我每条照抄标题格式延续旧词)+doc-conventions §10 章程落新规「用户确认任务完成时清除当前会话写过的状态条目——状态清除即任务完成证明」+06 新条「秘宝体系实现重构落地批」(文档层已换代/代码数据层未落——新 15 件实装+旧数据行清理+27 专长行删除+验收闸+池选型,冻结待发令);本条编号 433 起用「状态记录」新词
- **更新于**:2026-10-10(**第一版秘宝全弃用收官批**——worktree treasure-lib-13 自治合入;用户裁「退役与封存都进素材库,无留待 Alpha 重定的挂起」并质询出我此前对封存态的处理偏差;状态记录 432):显影尘/地穴全图卷 deferred→retired(2026-09-29 拍板④甲终结)+秘宝.md v1.9 四处正文换代(豁免面/五维度表信息行/投放态/护栏验收)+素材库四件(探宝罗盘/工兵令/显影尘/地穴全图卷)迁表一(表一 9→14 件〔顺带修正标题 9 件漏计提灯〕、表三摘除留指路句);数据表四行删除归退役删行批
- **更新于**:2026-10-10(**天赋树裁定跨文档同步批**——worktree tbox-docsync 自治合入,用户令「本批只做文档同步,勿再开裁」;纯文档零测试):武器锻造.md v0.2 柜台承载补树侧解锁门(前置=天赋树「锻造工坊」免费节点:攻/甲淬炼累计各 ≥2)+06 新登「天赋树结构重构批」实装待办(meta_tree 33→31/v4→v5 迁移重做/schema 等级阈值前置/柜台解锁门/秘宝匣改名连带面+地脉共鸣·同调位 1 两已裁项)+武器锻造实装批条补关联句+「道具工坊→秘宝匣」改名扫改九文件现行正文(元进度 v1.13/秘宝 v1.8/HUD框架 v0.16/camp v1.2/art-bible v3.13/03 v1.2/07 v0.5/README 新节/art-assets-checklist 补建版本表)+registry 术语条「秘宝匣」(别名道具工坊保留检索);天赋树.md 与 game 代码零触碰〔清单外残留呈报:存档序列化.md 两处+tools/balance_verifier.py 一处+武器锻造.md 两处未在扫改清单未动〕
- **更新于**:2026-10-10(**三段开发流程立规+文档同步闸 v2 落文**——worktree rules-3stage 自治合入 b56a7b8,用户令「修改这个规则,用我最新的指导意见」;纯文档零测试):设计→写需求卡片→实现三段定规——设计段=用户点头心智模型一致才落文档+裁点清零才算完成(带裁点=讨论稿);写卡段=用户发令触发+grilling 多轮复核零待裁+入库必登记 06,缺陷修复/工程债/测试基建/重构类凭证据直接写卡无设计前置;实现段=迭代号 U0 开工+**GDD/art-bible 等设计正主批内一律不更新**——收口出迭代实现报告(design/qa/iter<N>-实现报告-<日期>.md,迭代级一份,替代每卡出口报告),GDD 反哺点经用户逐点裁决后另批落文;落文=CLAUDE.md 三段节+第 12 条 v2+doc-conventions v15+/iter·req-card 技能;首例=武器锻造 GDD 17 裁点未清属讨论稿不得转写卡〔本条系规则批会话写入工作区未提交,2026-10-10 由卫生批随批并入入库〕
- **更新于**:2026-10-09(**小尾巴卫生批**——worktree hygiene-batch 自治合入;用户裁「秘宝 v0.6 双行加 a/b 后缀」+三件打包;工作日志 430):秘宝.md 版本表 v0.6 双行改 v0.6a/v0.6b(取证=非并行撞号,系 10-04 批落行未查前账;内容两行均合法批次记录)+06 欠账块粗体首行与标题重复精简+素材库表三「待核 4 行」换代「已核」(核实结论落盘:罗盘/工兵令=退役、显影尘/地穴全图卷=有意封存;摘标,正式入库归删行批);难度曲线 L122 销账=已由 03c4b4c(421 批 v0.27)清偿(交接文档写作时点早于落籍致误列)——**交接文档第五事项至此全部闭环**
- **更新于**:2026-10-09(**天赋树欠账三分流批**——worktree tree-debt-gdd 自治合入;用户三令「设计定案实现缺失记 06/registry 9.18 过期词条按最新清除/乙丙销账确认」;工作日志 429):06 新条「天赋树已建未接面两件」(同调位 2/3 槽位收编+命中线注入——设计正主《整合定稿》git 取证定性质=实现缺失非设计缺口;冻结待排期);registry「永久强化」词条过期句换现役口径(树在役+正主指路+新旧概念划界;同文 L870 批注系历史留痕不动);camp.md 补树面板结构位行;设计灰色地带(刷新升级节点/树×武器锻造叠加)=用户另会话讨论,prompt 已交付 chat;销账两项=entities.yaml 树域登记(迭代 18 存档批已补)+存档序列化 v5 域(并行复核批已换代)
- **更新于**:2026-10-09(**武器锻造成文批提交合入**——worktree wforge-gdd 独立完成,用户令「完成文档编写、代码不实现、记录待办」+提交合入会话自治不再交用户跑;工作日志 428):新建 systems/跨局循环/武器锻造.md v0.1(按提案推荐案落文定案口径——17 裁点开放在册待用户逐点裁决、推翻即改;数值 provisional 归 M4;零代码)+02 v1.18 加行+元进度 v1.12 指路+06 专条转正+实装待办条新登记(冻结待排期);随批入库=主区积压三件(active.md 大裁新版含 424-428/06 大裁四条迁移/提案-武器锻造 3 处命名替换),主区本批涉及文件零残留脏件
- **更新于**:2026-10-09(**交接续作·武器锻造实态核实+命名替换暂存就绪**,文档会话——用户立会话规则=本会话只做文档处理,代码/bug 修复不承接〔B5 已 handoff 另会话〕;工作日志 426):核实=HEAD 03c4b4c 未动/武器锻造系统零实现零正式 GDD(仅提案 17 裁点待裁决+playnote 手记+06 专条;转正落点=systems/跨局循环/即元进度目录);动作=提案-武器锻造 3 处「任务书→需求卡片」核验系前会话已改毕(diff 无夹带)+已入暂存区(暂存区仅此一件),提交命令已交付 chat 等用户自跑;挂起=提案盘问裁决与否/active.md 快照节「工作日志」残余词清理/active.md+06 大裁迁移四条过目放行——三项均待裁
- **更新于**:2026-10-09(**会话收尾·交接文档交付**;工作日志 425):C:\Users\DK\.zcode\handoff-doc-consolidation-2026-10-09.md——已完成清单(03c4b4c 十一批,勿重做)/待办六类(两小件入库·B5 承接·树双轨四问·文档复审·小尾巴·冻结线)/规则与坑(主区 hook 双拦·零吞并·并行会话活跃·quotepath 伪象·呈报配上下文);本会话指派事项全部闭环,新会话凭交接文档续作
- **更新于**:2026-10-09(**active.md 立宪+大裁批落盘**,用户令先定规则再清历史;纯文档零代码零测试;工作日志 424):定性=状态文件落文六处(doc-conventions §10 章程+§11 定性句、CLAUDE.md 四处、体检技能新增「active.md 状态卫生」第九闸)+大裁执行——941 行 1020989 字节裁至约 60 行,只留头指针(死路径当场修正六处)+当前位置重写+快照 10 条+未决面+当前迭代条目(414-423 号);删除前吸收扫描全量过门(98% 删除集逐行旗标扫描非抽样,漏网 2 项已迁 06:美术审计两项 P0+filter-repo 待批计划书;低置信观察 1 项入探讨备忘);提交待用户过目摘要后放行
- **更新于**:2026-10-09(**落籍完成 03c4b4c**,用户自跑提交绕过守卫;工作日志 423):74 文件 +1153/−773 十一批全落 master;核验全过=四新文件(天赋树.md/道具退役素材库/需求卡片×2)入库/旧「任务书」文件名清零/06 并行「active.md 定性」条目未吞(HEAD 0 处、工作区 1 处保留)/排除件(.gitignore/.zcode/config.json/playnote 等)未带/.zcode 工具件被忽略;残留两小件=提案-武器锻造 3 处命名替换漏暂存未入库(可 `git add`+`--amend` 并笔)+active.md 422/423 系暂存后追加未随批(随下一笔记账)
- **更新于**:2026-10-09(**落籍批就绪但被守卫拦截,等用户选路**;工作日志 422):提交前核验 12 关键落点全过=文档批全部完成;74 项已入暂存区(06 已摘并行会话「active.md 定性」条目按零吞并留工作区;提交信息=**.zcode/commitmsg_20261009.txt** 十一条明细),执行被 worktree 铁律 hook 两次拦截(主区直提+中转 worktree 路径形态均拦);**等用户三选一**=自跑 `git commit -F .zcode/commitmsg_20261009.txt` / 临时放行守卫 / 明示授权绕行;代码修复规划 prompt(B5 两件主线+树侧双轨四问呈报面)已交付 chat
- **更新于**:2026-10-09(**天赋树独立成文+A 类卫生包+B5 登记全落**,用户三令、双 subagent 并行;工作日志 421):新建 systems/跨局循环/天赋树.md v0.1(33 节点机制全按代码实态+迭代 12 裁决+被删底稿 git 取证)+元进度定名节换代 v1.11+02 索引 v1.17;A 类卫生包 11 文件落毕(四份版本表理排/node-reward v2.2a·b/三份缺号注记/07 补版本表/06 删空节+欠账块挪「文档与结构」节/「L1 商店编排」指针改指 GP 换算失衡条/难度曲线两过期指向核销 v0.27)+06 新增「现役 UI/文案两处自相冲突」待办条(B5);**新呈报=树侧双轨欠账四问**(ks_refresh/socket/命中线零消费面+元进度属性锻造行未同步)与三处跨文档欠账(registry/存档序列化/camp spec)归后续
- **更新于**:2026-10-09(**B2/B3/B4 三裁落文+B1 现状呈报**,用户令;工作日志 420):B2 元进度道具工坊行删旧写新(v1.10——旧六行登记作废、指路秘宝新目录+解锁门槛谓词分级)/B3 奇物「两项合成高阶项」注销(脏信息非用户意图)/B4 §3 刷新句按最新口径换代(刷新券替代、不进持有集,v3.9);B1 呈报元进度.md 现状清单(写了钥石/三柜台/换算率/注入,没写天赋树且「不存在树」与实现矛盾、无武器作坊)+信息架构建议(秘宝维持独立、天赋树荐独立成文)待用户定;B5 澄清=两小错系「现役码 vs 现役码」(纯专长早已落码、文案是落码前旧话)非新设计未实装的必然错
- **更新于**:2026-10-09(**素材库案乙追认+迭代规划冻结两裁落文**,用户令;工作日志 419):素材库头注改「案乙已追认」;roadmap 迭代 20 行落「迭代 20/21/22 规划冻结——先解决眼前问题、重启=用户直接发令」(X/Y 刷新语义裁与空配置闸随之一并悬置);审查批呈报册按用户要求重组为「卫生件打包荐/真裁点逐件带上下文」呈报
- **更新于**:2026-10-09(**命名统一批+提灯定性+审计 prompt 交付**,用户三令,纯文档零测试零提交;工作日志 418):「任务书→需求卡片」全库统一=147 文件 797 处+两份需求卡片文件改名+技能 taskbook→req-card(残留仅自造短语清单 52 处=证据文档故意跳过);提灯定性=非本次秘宝设计讨论产物(09-30 灯甲拍板+迭代 19 卡④ 补载体)→按归口原则当旧件=素材库表一在册无需再动,归口规则立=秘宝件只能出自秘宝设计讨论、越口件一律挪素材库;文档正确性审查(另一会话独立 worktree 执行)prompt 已交付 chat——**开工门=主区未提交落文先落籍**(否则另一会话从 master 拉 worktree 看不到本会话修正、会重复报已修项)
- **更新于**:2026-10-09(**文档正确性审查批三波收官**,用户正式立项「文档必须正确」、三 subagent 分区执行,纯文档零测试零提交;工作日志 417):全 GDD 29 份过审——秘宝.md v1.7 老正文深层清算(横幅重写消误读/沿革节换代删 M-4/六件旧件登记摘除)+systems 16 份+根文档与 ux 12 份修正;统一口径=里程碑删前缀/裸 M-4→Beta 阶段(未排期)/状态记录按代码证据订正/在役旧实现节加隔离横幅;同批落=魔法提灯裁退役(06+秘宝.md+素材库迁表一)/CLAUDE.md 第 12 条**文档同步闸**+用户级技能 taskbook 固化(实现与文档同批收口);呈报未改项一册待裁(元进度天赋树归口/06 裸 M-x 登记行/版本表乱序等)
- **更新于**:2026-10-09(自造黑话清扫批第一批收工+active.md 裁剪方案呈报待裁,会话讨论+subagent 文档批;工作日志 416):用户点名对话中一个自造压缩速记词非行业标准词(英语 in-flight 之意,中文压缩形系自造)、对话用语违反 CLAUDE.md:97 红线,下令全部自造词改成标准词或平常人能看懂的词——清扫批已收工:active.md 全文(速记词清零 0 处、工作日志改名前旧称清零 0 处、「工作日志」333 处;444+167 处替换)+记忆目录 354 个文件(206 个变更)+CLAUDE.md/roadmap/doc-conventions 三规范,全程零 git 写命令、换行风格保持;GDD 正文约三千处流程动词族存量留第二批逐句展开。同会话成因定案:active.md 只追加不删除=收口协议只写追加无退役步(遗漏而非规定)+doc-conventions.md:177「工作日志=历史变更记录」豁免句系起草越权(用户从未裁决永久保留),历史职能已由 git 提交史覆盖;三落点裁决清单已呈报(①177 行定性句改写②清旧条目时机三选一荐每迭代收口③大裁保留线五项+九月死节五节全删),等用户逐项裁后执行大裁。
- **更新于**:2026-10-09(**里程碑语义立规落文**,设计讨论会话——纯文档零代码零测试;工作日志 414):用户立规 **M3=Alpha 版本的完整实现、M4=Beta 版本的完整实现**——未明令宣布 M3 完成前项目停留 M3 阶段,迭代规划只排 M3 需求、M4 一律不排期;落文=roadmap M-4 节头立规注+M-3 节头指针+迭代 21+ 行注+06 倍率差条注(未提交随发令落籍)。同会话呈报待裁=道具退役清单三层/缺陷修批转删除/空配置验收闸/素材库荐乙;迭代 20-22 规划前提换代(M4 撤出)下轮重谈;文档去毒批(奇物/秘宝新老框架分家)派工进行中
- **更新于**:2026-10-09(**小尾巴卫生批**——worktree hygiene-batch 自治合入;用户裁「秘宝 v0.6 双行加 a/b 后缀」+三件打包;状态记录 430):秘宝.md 版本表 v0.6 双行改 v0.6a/v0.6b(取证=非并行撞号,系 10-04 批落行未查前账;内容两行均合法批次记录)+06 欠账块粗体首行与标题重复精简+素材库表三「待核 4 行」换代「已核」(核实结论落盘:罗盘/工兵令=退役、显影尘/地穴全图卷=有意封存;摘标,正式入库归删行批);难度曲线 L122 销账=已由 03c4b4c(421 批 v0.27)清偿(交接文档写作时点早于落籍致误列)——**交接文档第五事项至此全部闭环**
- **更新于**:2026-10-09(**天赋树欠账三分流批**——worktree tree-debt-gdd 自治合入;用户三令「设计定案实现缺失记 06/registry 9.18 过期词条按最新清除/乙丙销账确认」;状态记录 429):06 新条「天赋树已建未接面两件」(同调位 2/3 槽位收编+命中线注入——设计正主《整合定稿》git 取证定性质=实现缺失非设计缺口;冻结待排期);registry「永久强化」词条过期句换现役口径(树在役+正主指路+新旧概念划界;同文 L870 批注系历史留痕不动);camp.md 补树面板结构位行;设计灰色地带(刷新升级节点/树×武器锻造叠加)=用户另会话讨论,prompt 已交付 chat;销账两项=entities.yaml 树域登记(迭代 18 存档批已补)+存档序列化 v5 域(并行复核批已换代)
- **更新于**:2026-10-09(**武器锻造成文批提交合入**——worktree wforge-gdd 独立完成,用户令「完成文档编写、代码不实现、记录待办」+提交合入会话自治不再交用户跑;状态记录 428):新建 systems/跨局循环/武器锻造.md v0.1(按提案推荐案落文定案口径——17 裁点开放在册待用户逐点裁决、推翻即改;数值 provisional 归 M4;零代码)+02 v1.18 加行+元进度 v1.12 指路+06 专条转正+实装待办条新登记(冻结待排期);随批入库=主区积压三件(active.md 大裁新版含 424-428/06 大裁四条迁移/提案-武器锻造 3 处命名替换),主区本批涉及文件零残留脏件
- **更新于**:2026-10-09(**交接续作·武器锻造实态核实+命名替换暂存就绪**,文档会话——用户立会话规则=本会话只做文档处理,代码/bug 修复不承接〔B5 已 handoff 另会话〕;状态记录 426):核实=HEAD 03c4b4c 未动/武器锻造系统零实现零正式 GDD(仅提案 17 裁点待裁决+playnote 手记+06 专条;转正落点=systems/跨局循环/即元进度目录);动作=提案-武器锻造 3 处「任务书→需求卡片」核验系前会话已改毕(diff 无夹带)+已入暂存区(暂存区仅此一件),提交命令已交付 chat 等用户自跑;挂起=提案盘问裁决与否/active.md 快照节「状态记录」残余词清理/active.md+06 大裁迁移四条过目放行——三项均待裁
- **更新于**:2026-10-09(**会话收尾·交接文档交付**;状态记录 425):C:\Users\DK\.zcode\handoff-doc-consolidation-2026-10-09.md——已完成清单(03c4b4c 十一批,勿重做)/待办六类(两小件入库·B5 承接·树双轨四问·文档复审·小尾巴·冻结线)/规则与坑(主区 hook 双拦·零吞并·并行会话活跃·quotepath 伪象·呈报配上下文);本会话指派事项全部闭环,新会话凭交接文档续作
- **更新于**:2026-10-09(**active.md 立宪+大裁批落盘**,用户令先定规则再清历史;纯文档零代码零测试;状态记录 424):定性=状态文件落文六处(doc-conventions §10 章程+§11 定性句、CLAUDE.md 四处、体检技能新增「active.md 状态卫生」第九闸)+大裁执行——941 行 1020989 字节裁至约 60 行,只留头指针(死路径当场修正六处)+当前位置重写+快照 10 条+未决面+当前迭代条目(414-423 号);删除前吸收扫描全量过门(98% 删除集逐行旗标扫描非抽样,漏网 2 项已迁 06:美术审计两项 P0+filter-repo 待批计划书;低置信观察 1 项入探讨备忘);提交待用户过目摘要后放行
- **更新于**:2026-10-09(**落籍完成 03c4b4c**,用户自跑提交绕过守卫;状态记录 423):74 文件 +1153/−773 十一批全落 master;核验全过=四新文件(天赋树.md/道具退役素材库/需求卡片×2)入库/旧「任务书」文件名清零/06 并行「active.md 定性」条目未吞(HEAD 0 处、工作区 1 处保留)/排除件(.gitignore/.zcode/config.json/playnote 等)未带/.zcode 工具件被忽略;残留两小件=提案-武器锻造 3 处命名替换漏暂存未入库(可 `git add`+`--amend` 并笔)+active.md 422/423 系暂存后追加未随批(随下一笔记账)
- **更新于**:2026-10-09(**落籍批就绪但被守卫拦截,等用户选路**;状态记录 422):提交前核验 12 关键落点全过=文档批全部完成;74 项已入暂存区(06 已摘并行会话「active.md 定性」条目按零吞并留工作区;提交信息=**.zcode/commitmsg_20261009.txt** 十一条明细),执行被 worktree 铁律 hook 两次拦截(主区直提+中转 worktree 路径形态均拦);**等用户三选一**=自跑 `git commit -F .zcode/commitmsg_20261009.txt` / 临时放行守卫 / 明示授权绕行;代码修复规划 prompt(B5 两件主线+树侧双轨四问呈报面)已交付 chat
- **更新于**:2026-10-09(**天赋树独立成文+A 类卫生包+B5 登记全落**,用户三令、双 subagent 并行;状态记录 421):新建 systems/跨局循环/天赋树.md v0.1(33 节点机制全按代码实态+迭代 12 裁决+被删底稿 git 取证)+元进度定名节换代 v1.11+02 索引 v1.17;A 类卫生包 11 文件落毕(四份版本表理排/node-reward v2.2a·b/三份缺号注记/07 补版本表/06 删空节+欠账块挪「文档与结构」节/「L1 商店编排」指针改指 GP 换算失衡条/难度曲线两过期指向核销 v0.27)+06 新增「现役 UI/文案两处自相冲突」待办条(B5);**新呈报=树侧双轨欠账四问**(ks_refresh/socket/命中线零消费面+元进度属性锻造行未同步)与三处跨文档欠账(registry/存档序列化/camp spec)归后续
- **更新于**:2026-10-09(**B2/B3/B4 三裁落文+B1 现状呈报**,用户令;状态记录 420):B2 元进度道具工坊行删旧写新(v1.10——旧六行登记作废、指路秘宝新目录+解锁门槛谓词分级)/B3 奇物「两项合成高阶项」注销(脏信息非用户意图)/B4 §3 刷新句按最新口径换代(刷新券替代、不进持有集,v3.9);B1 呈报元进度.md 现状清单(写了钥石/三柜台/换算率/注入,没写天赋树且「不存在树」与实现矛盾、无武器作坊)+信息架构建议(秘宝维持独立、天赋树荐独立成文)待用户定;B5 澄清=两小错系「现役码 vs 现役码」(纯专长早已落码、文案是落码前旧话)非新设计未实装的必然错
- **更新于**:2026-10-09(**素材库案乙追认+迭代规划冻结两裁落文**,用户令;状态记录 419):素材库头注改「案乙已追认」;roadmap 迭代 20 行落「迭代 20/21/22 规划冻结——先解决眼前问题、重启=用户直接发令」(X/Y 刷新语义裁与空配置闸随之一并悬置);审查批呈报册按用户要求重组为「卫生件打包荐/真裁点逐件带上下文」呈报
- **更新于**:2026-10-09(**命名统一批+提灯定性+审计 prompt 交付**,用户三令,纯文档零测试零提交;状态记录 418):「任务书→需求卡片」全库统一=147 文件 797 处+两份需求卡片文件改名+技能 taskbook→req-card(残留仅自造短语清单 52 处=证据文档故意跳过);提灯定性=非本次秘宝设计讨论产物(09-30 灯甲拍板+迭代 19 卡④ 补载体)→按归口原则当旧件=素材库表一在册无需再动,归口规则立=秘宝件只能出自秘宝设计讨论、越口件一律挪素材库;文档正确性审查(另一会话独立 worktree 执行)prompt 已交付 chat——**开工门=主区未提交落文先落籍**(否则另一会话从 master 拉 worktree 看不到本会话修正、会重复报已修项)
- **更新于**:2026-10-09(**文档正确性审查批三波收官**,用户正式立项「文档必须正确」、三 subagent 分区执行,纯文档零测试零提交;状态记录 417):全 GDD 29 份过审——秘宝.md v1.7 老正文深层清算(横幅重写消误读/沿革节换代删 M-4/六件旧件登记摘除)+systems 16 份+根文档与 ux 12 份修正;统一口径=里程碑删前缀/裸 M-4→Beta 阶段(未排期)/状态记录按代码证据订正/在役旧实现节加隔离横幅;同批落=魔法提灯裁退役(06+秘宝.md+素材库迁表一)/CLAUDE.md 第 12 条**文档同步闸**+用户级技能 taskbook 固化(实现与文档同批收口);呈报未改项一册待裁(元进度天赋树归口/06 裸 M-x 登记行/版本表乱序等)
- **更新于**:2026-10-09(自造黑话清扫批第一批收工+active.md 裁剪方案呈报待裁,会话讨论+subagent 文档批;状态记录 416):用户点名对话中一个自造压缩速记词非行业标准词(英语 in-flight 之意,中文压缩形系自造)、对话用语违反 CLAUDE.md:97 红线,下令全部自造词改成标准词或平常人能看懂的词——清扫批已收工:active.md 全文(速记词清零 0 处、状态记录改名前旧称清零 0 处、「状态记录」333 处;444+167 处替换)+记忆目录 354 个文件(206 个变更)+CLAUDE.md/roadmap/doc-conventions 三规范,全程零 git 写命令、换行风格保持;GDD 正文约三千处流程动词族存量留第二批逐句展开。同会话成因定案:active.md 只追加不删除=收口协议只写追加无退役步(遗漏而非规定)+doc-conventions.md:177「状态记录=历史变更记录」豁免句系起草越权(用户从未裁决永久保留),历史职能已由 git 提交史覆盖;三落点裁决清单已呈报(①177 行定性句改写②清旧条目时机三选一荐每迭代收口③大裁保留线五项+九月死节五节全删),等用户逐项裁后执行大裁。
- **更新于**:2026-10-09(**里程碑语义立规落文**,设计讨论会话——纯文档零代码零测试;状态记录 414):用户立规 **M3=Alpha 版本的完整实现、M4=Beta 版本的完整实现**——未明令宣布 M3 完成前项目停留 M3 阶段,迭代规划只排 M3 需求、M4 一律不排期;落文=roadmap M-4 节头立规注+M-3 节头指针+迭代 21+ 行注+06 倍率差条注(未提交随发令落籍)。同会话呈报待裁=道具退役清单三层/缺陷修批转删除/空配置验收闸/素材库荐乙;迭代 20-22 规划前提换代(M4 撤出)下轮重谈;文档去毒批(奇物/秘宝新老框架分家)派工进行中
## 项目当前位置(2026-10-09 重写;实时细节以根目录 `roadmap.md` 与 06-待办清单 为准)
- **里程碑**:M3=Alpha 版本的完整实现(2026-10-09 立规:用户未明令宣布 M3 完成前停留 M3,迭代只排 M3 需求,M4 一律不排期)
- **迭代**:迭代 19 五卡全部落籍(2026-10-08);迭代 20 尚未开工(候选=主菜单开局缺陷修复批等,待用户点名);迭代 21/22 规划前提换代后重谈
- **近期主战场**:文档治理连续批(存量超期清理/里程碑语义立规/文档去毒/黑话清扫第一批/文档正确性审查/本批立宪大裁)——批次详情见工作日志 414 号起各条与 git 提交史
- **近期主战场**:文档治理连续批(存量超期清理/里程碑语义立规/文档去毒/黑话清扫第一批/文档正确性审查/本批立宪大裁)——批次详情见状态记录 414 号起各条与 git 提交史
## 未决面(进行中/待人闸/待裁点指针;正主登记处=`design/gdd/06-待办清单.md`)
- 待用户裁决:美术审计两项 P0(art-bible 死样张指涉+主角像素管线重产;06 新迁入);filter-repo 计划书待批准或放弃(06 新迁入);去毒残留词(魔法道具约 30 处/罕见约 18 处)扫否(呈报在案);X/Y 刷新语义倒置(06 在册)
@@ -47,10 +49,10 @@
- 进行中:黑话清扫第二波(GDD 正文流程动词族约三千处,待本批落定后派)
- 本批收尾:active.md 立宪+大裁已落盘,摘要呈报后待用户放行提交
## 工作日志(滚动窗口:仅当前迭代;退役规则见 doc-conventions §10)
414. **里程碑语义立规落文+道具重设计后续规划讨论(2026-10-09,设计讨论会话——纯文档零代码零测试〔两入口铁规〕;补丁法落盘未提交)**:①**拍板=用户立规里程碑语义**:M3=Alpha 版本的完整实现、M4=Beta 版本的完整实现;用户未明令宣布 M3 完成前项目停留 M3 阶段——迭代规划只编排 M3(Alpha 完整实现)相关需求,M4 内容一律不排期不进迭代。落文四处=roadmap.md M-4 节头立规注+M-3 节头口径换代指针+迭代 21+ 行「Alpha 收官位」注记+06-待办清单倍率差条「下一迭代数值批」表述作废(.zcode/patch_milestone_semantics_20261009.py 四锚 count==1+grep 复核)。②**讨论产出(呈报态)**:道具退役清单三层=秘宝删 9 行+待核 5 行(fog_lantern 魔法提灯系迭代 19 卡④在役件勿误删)/专长 27 行全删/地图层零删除;缺陷修批摘除=刷新件写错账 F-1 转删除需求+爆破工兵包漏洞随退役消解;空配置验收闸建议(三选一池空兜底/商店空货架/装配面空目录无断言面);引擎适配核证=骨架同构(on/when/do=迭代 17 卡⓪落的 schema)+新发现两疑似漏项(件级跨事件状态账≈8 件/秘宝参数注入面≈7 件)归实装批 T0;素材库甲乙案讨论荐乙;文档误导源审计(新老框架同文件混居/事实性过期/退役术语/schema 作废字段仍必填)→用户立「文档去毒」为首要任务,派 subagent 执行中。③**迭代规划前提换代**:实装批后置(用户令)+M4 数值批撤出迭代排期,迭代 20/21/22 规划下轮重谈。④**事故在案**:本条初以 410 落笔,因并行会话将主区 active.md 复原至 HEAD(工作日志已推进 413)被覆写,重录为 414;并行会话在主区活动痕迹已呈报用户。
## 状态记录(滚动窗口:仅当前迭代;退役规则见 doc-conventions §10)
414. **里程碑语义立规落文+道具重设计后续规划讨论(2026-10-09,设计讨论会话——纯文档零代码零测试〔两入口铁规〕;补丁法落盘未提交)**:①**拍板=用户立规里程碑语义**:M3=Alpha 版本的完整实现、M4=Beta 版本的完整实现;用户未明令宣布 M3 完成前项目停留 M3 阶段——迭代规划只编排 M3(Alpha 完整实现)相关需求,M4 内容一律不排期不进迭代。落文四处=roadmap.md M-4 节头立规注+M-3 节头口径换代指针+迭代 21+ 行「Alpha 收官位」注记+06-待办清单倍率差条「下一迭代数值批」表述作废(.zcode/patch_milestone_semantics_20261009.py 四锚 count==1+grep 复核)。②**讨论产出(呈报态)**:道具退役清单三层=秘宝删 9 行+待核 5 行(fog_lantern 魔法提灯系迭代 19 卡④在役件勿误删)/专长 27 行全删/地图层零删除;缺陷修批摘除=刷新件写错账 F-1 转删除需求+爆破工兵包漏洞随退役消解;空配置验收闸建议(三选一池空兜底/商店空货架/装配面空目录无断言面);引擎适配核证=骨架同构(on/when/do=迭代 17 卡⓪落的 schema)+新发现两疑似漏项(件级跨事件状态账≈8 件/秘宝参数注入面≈7 件)归实装批 T0;素材库甲乙案讨论荐乙;文档误导源审计(新老框架同文件混居/事实性过期/退役术语/schema 作废字段仍必填)→用户立「文档去毒」为首要任务,派 subagent 执行中。③**迭代规划前提换代**:实装批后置(用户令)+M4 数值批撤出迭代排期,迭代 20/21/22 规划下轮重谈。④**事故在案**:本条初以 410 落笔,因并行会话将主区 active.md 复原至 HEAD(状态记录已推进 413)被覆写,重录为 414;并行会话在主区活动痕迹已呈报用户。
415. **文档去毒批(2026-10-09,用户立「文档去毒=首要任务、让它保持正确完整」;general-purpose subagent 主区补丁法执行;纯文档零代码零测试零提交)**:动因=另一会话按文档做专长扩充讨论时大量幻觉,主会话审计坐实四类毒源(新老框架同文件混居/事实性过期/退役术语/schema 作废字段仍必填)。**改动**:①奇物.md v3.7——魔法道具→秘宝 4 处(含任务单外 L388 一处)/「罕见门票」→「专长门票」/§1.3 资源四项加凭证件表指路/P1 已落籍注记/调参表四行订正(去「标签」字段、门票与刷新「尚未入表」假话改已入表迭代15②、三档→四级)/验收第 3 条改令牌口径(拿消耗、令牌数=上限、只刷出不计)/档名扫改(罕见→稀有等)/待办门票条〔已清偿〕——v3.6 被同日并行批占用顺延 v3.7;②秘宝.md v1.6——速览旧目录九件表加退役标注+魔法提灯归属待裁指路 06/五维度表两行退役件示例换现役(线香/天眼、晨操令/双管装填/试炼镐)/投放态与验收首条补时点指针;③新建 design/research/道具退役素材库.md(头注常驻参考档案乙待追认——秘宝退役 9 件含去向/专长退役 27 件名单〔feats.tres 抄录〕/待核 5 行〔含 fog_lantern 勿删标注〕);④06 新增「魔法提灯(fog_lantern)在秘宝新旧目录的归属」待裁条(去留三案:留任/退役并入阔视野带/改型重定)。**残留呈报**:魔法道具 30 处/6 文件、罕见 18 处/6 文件——多为版本历史、更名批注记与现行 schema 三档配额(70/25/3)语境,未动待用户裁是否扫;秘宝老正文深层(设计目的/调参表六行)判冻结留痕随实装批整体替换。**异常**:备份在 .zcode/backup-detox-20261009/;06 无「档名扫改/老正文清扫」在册条目故无状态可换;补丁脚本两条写后校验断言过严非零退出但落盘与独立复核全绿。未提交内容(奇物 20-131 新正主/验收第 4 条/注销注记/秘宝 15 件表)抽查零触碰。
416. **自造黑话清扫批第一批收工+active.md 裁剪方案呈报(2026-10-09,会话讨论+subagent 文档批,纯文档零代码零测试)**:①**拍板与执行**:用户点名对话中使用的自造压缩速记词非行业标准词(英语 in-flight 虽系真实术语,中文压缩形系自造),对话用语已违反 CLAUDE.md:97 红线;用户令全部自造词改为标准词或平常人能看懂的词,subagent 后台执行——第一批范围=active.md 全文+记忆目录+CLAUDE.md/doc-conventions/roadmap 三规范顺带。**收工统计**:active.md 旧称改「工作日志」444 处+速记词族约 167 处(并行会话竞态 28/进行中批次 4/未提交语境约 73/状态语义约 62),994,384→997,662 字节(改后净增 3,278 字节,改名扩长的副作用,再添大裁一条理由)、行数 925 不变;记忆目录 354 个文件扫 206 个变更(旧称 771 处+速记词族 155 处);CLAUDE.md 4 处、roadmap 47 处、doc-conventions 9 处;主会话独立复核=速记词 0 处、旧称 0 处、「工作日志」333 处;禁令表引用被禁词本身的记载形态按例保留(含 1 处误替换已由执行方自检还原);全程零 git 写命令、CRLF 与编码逐文件保持。**遗留**:流程动词族(收口/落籍/追认/对拍等 §4 在册词)机械换词会失真,留第二批逐句展开;「义务台账」系 registry 概念与日志无关待裁改名;「在途」同族词不在 2026-10-04 清单建议第二批一并裁;GDD 正文约三千余处存量待第二批,避让文档去毒批未提交改动。②**只追加不删除成因定案**(用户三问:谁规定的/是否项目要求/如何纠正):收口协议(CLAUDE.md:54/:87)只定义追加从未定义退役=遗漏非规定;doc-conventions.md:177「工作日志=历史变更记录」豁免句系 agent 2026-10-02 落文吸收即死铁律时起草越权,用户从未裁决永久保留;2026-10-04 废除每条三行上限(动机正确=防黑话)拆掉自然刹车但未配退役机制;历史职能自始被 git 提交史覆盖,豁免句解决的是不存在的问题。③**三落点裁决清单已呈报待裁**:其一 doc-conventions:177 定性句改「工作日志=当前状态与最近批次的记录;历史变更一律以 git 提交史为准」并保留引用不阻塞功能;其二收口协议补退役步、清旧条目时机三选一=每迭代收口(荐)/每里程碑/超 30 条兜底,规则原文已预览(吸收即死后半句系既有铁律自动适用非新增);其三 active.md 大裁保留线五项(头指针/当前位置重写/快照真 10 条/未决面/最近一迭代日志)+九月死节五节全删(删前按吸收即死先吸收独有规则)。④**默认声明**:工作日志编号 416 起继续递增不重排(提交信息与记忆均引编号);大裁=独立小批、无并行批次窗口动 active.md、先给用户摘要再提交。
416. **自造黑话清扫批第一批收工+active.md 裁剪方案呈报(2026-10-09,会话讨论+subagent 文档批,纯文档零代码零测试)**:①**拍板与执行**:用户点名对话中使用的自造压缩速记词非行业标准词(英语 in-flight 虽系真实术语,中文压缩形系自造),对话用语已违反 CLAUDE.md:97 红线;用户令全部自造词改为标准词或平常人能看懂的词,subagent 后台执行——第一批范围=active.md 全文+记忆目录+CLAUDE.md/doc-conventions/roadmap 三规范顺带。**收工统计**:active.md 旧称改「状态记录」444 处+速记词族约 167 处(并行会话竞态 28/进行中批次 4/未提交语境约 73/状态语义约 62),994,384→997,662 字节(改后净增 3,278 字节,改名扩长的副作用,再添大裁一条理由)、行数 925 不变;记忆目录 354 个文件扫 206 个变更(旧称 771 处+速记词族 155 处);CLAUDE.md 4 处、roadmap 47 处、doc-conventions 9 处;主会话独立复核=速记词 0 处、旧称 0 处、「状态记录」333 处;禁令表引用被禁词本身的记载形态按例保留(含 1 处误替换已由执行方自检还原);全程零 git 写命令、CRLF 与编码逐文件保持。**遗留**:流程动词族(收口/落籍/追认/对拍等 §4 在册词)机械换词会失真,留第二批逐句展开;「义务台账」系 registry 概念与日志无关待裁改名;「在途」同族词不在 2026-10-04 清单建议第二批一并裁;GDD 正文约三千余处存量待第二批,避让文档去毒批未提交改动。②**只追加不删除成因定案**(用户三问:谁规定的/是否项目要求/如何纠正):收口协议(CLAUDE.md:54/:87)只定义追加从未定义退役=遗漏非规定;doc-conventions.md:177「状态记录=历史变更记录」豁免句系 agent 2026-10-02 落文吸收即死铁律时起草越权,用户从未裁决永久保留;2026-10-04 废除每条三行上限(动机正确=防黑话)拆掉自然刹车但未配退役机制;历史职能自始被 git 提交史覆盖,豁免句解决的是不存在的问题。③**三落点裁决清单已呈报待裁**:其一 doc-conventions:177 定性句改「状态记录=当前状态与最近批次的记录;历史变更一律以 git 提交史为准」并保留引用不阻塞功能;其二收口协议补退役步、清旧条目时机三选一=每迭代收口(荐)/每里程碑/超 30 条兜底,规则原文已预览(吸收即死后半句系既有铁律自动适用非新增);其三 active.md 大裁保留线五项(头指针/当前位置重写/快照真 10 条/未决面/最近一迭代日志)+九月死节五节全删(删前按吸收即死先吸收独有规则)。④**默认声明**:状态记录编号 416 起继续递增不重排(提交信息与记忆均引编号);大裁=独立小批、无并行批次窗口动 active.md、先给用户摘要再提交。
417. **文档正确性审查批三波收官+提灯裁退役+文档同步闸固化(2026-10-09,用户正式立项「文档正确性审查」+三令;三 subagent 分区执行〔排雷域/冒险·战斗·跨局域/根文档·ux 域〕,主区补丁法,纯文档零测试零提交;备份 .zcode/backup-audit-20261009-{pd,ad,root}/)**:①**审查批**——全 GDD 29 份过审,统一口径=R1 状态记录按代码证据订正(已实现标未实现/退役标在役/「尚未入表」类)/R2 里程碑口径(M-x+迭代N→迭代N;裸 M-4→Beta 阶段(未排期);版本历史与批次登记行不动)/R3 退役词退役件(魔法道具全库清零)/R4 在役旧实现节加隔离横幅;重件=秘宝.md v1.7 老正文深层清算(用户点名两处必修:L4-5 横幅重写消「过渡形态已退役」误读/沿革节换代删 M-4 前缀+两态表述改单一现行形态,另 30 处=表名 aux→treasure/六件旧件登记摘除/设计目的与范围按同调形态重写/调参表留痕/验收「同一件不能使用第二次」与 charges 2/冒险矛盾订正)+行动经济 v0.10+冒险结构 v0.18+关卡节点地图 v1.7+图生成 v0.7+难度曲线 v0.26+战斗结算 v0.27+敌人系统 v0.16+地图战斗资源 v0.21+增益状态 v0.13+战斗表现 v0.6+元进度 v1.9+生涯 v0.3+奇物 v3.8+00 v1.3+02 v1.16+03 v1.1+06 两处+07 两处+ux 八份(camp/shop/node-reward/level-clear/interaction-patterns/settlement-summary/level-map/battle 23 处);②**魔法提灯裁退役**(用户令「新目录没收就去掉;有也不需要」)——06 提灯条状态改已裁退役+秘宝.md 注记换代+素材库迁表一(拆线归退役删行批/实装批);③**文档同步约束固化**(用户立)——CLAUDE.md 批次工作流标准清单收口段新增第 12 条「文档同步闸」(需求卡片必列关联文档同步面、合并前同步完毕方算收口,原 12/13 顺延)+用户级技能 taskbook 建成(C:\Users\DK\.zcode\skills\taskbook\SKILL.md——需求卡片必备结构十节含关联文档同步面必填+末卡文档同步闸);④**呈报未改项一册**(归用户裁):元进度天赋树/锻造脉成文归口〔save v5 在役无 owner 文档〕/treasure_items 扩行(迭代11①七件+提灯)未登记工坊/奇物 P1「两项合成高阶项」残句/奇物 §3 刷新持有账张力/06 裸 M-x 嵌登记行(L267/L281/L322 等)/06 L223/L227「L1 商店编排」悬空指针/难度曲线 r_boss 与减伤复验两过期指向/各版本历史表乱序(秘宝/奇物/敌人系统/图生成/增益状态缺 v0.6/冒险结构缺 v0.15/关卡节点地图缺 v1.6/node-reward v2.2 双行同号)/battle_narrator.gd:160 游戏内文案与通关纯专长不符(代码面)/hero_info_panel_view.gd 两段同标「特性」(代码面)/07 无版本表/06「设置与本地化」空节与欠账块归属错位;⑤**事故在案**:第三波作业中 06 被并行会话追加 L434-455(active.md 定性条),锚点未受影响、内容原样保留;本条编号经 416 被并行清扫批占用顺延 417。
418. **命名统一批+提灯定性+审计 prompt 交付(2026-10-09,用户三令;主会话直执,纯文档零测试零提交)**:①**命名统一**(用户令「统一把任务书改成需求卡片」)——「任务书→需求卡片」全库字节级清扫=.zcode/rename_taskbook_reqcard_20261009.py 两轮合计 147 文件 797 处(design/ 全部 .md〔跳过自造短语全量清单=黑话证据文档 52 处在册故意保留〕+roadmap 17+CLAUDE.md 9+active.md 96+entities.yaml+game/ 全部 .gd/.tres/.md 30 处+记忆目录 91 文件)+两份在库文件改名(design/research/需求卡片-M4数值批-2026-10-05.md、需求卡片-冒险前资源配比预设批-2026-10-04.md)+技能目录 taskbook→req-card(name 字段与首段语义顺手修正);终核 grep 全库仅自造短语清单残留;今后一律用需求卡片(记忆已立)。②**提灯定性**(用户问「是不是我们本次设计里的」)——考证:非本次道具三层重设计讨论产物,系 2026-09-30 灯甲拍板(视野+2 机制)→迭代 14⑤ 只落接线未造载体→迭代 19 卡④(B4 验收缺口)用户令立项+「按推荐」裁案A 补载体落成第十件;用户亲裁但非设计讨论产物,按归口原则当旧件=素材库表一在册(2026-10-09 已裁退役、功能由阔视野带承接、拆线归实装批),无需再动;**归口规则立=秘宝件只能出自用户主导的设计讨论、其他任务线新增秘宝件=越口件一律挪素材库**(记忆已立)。③**文档正确性审查(另一会话独立 worktree 执行)prompt 已交付 chat**——含开工门(主区未提交落文先落籍否则重复报已修项)/worktree 隔离规范/审查范围=R1-R5 口径/报告格式;用户自行发射。
419. **素材库案乙追认+迭代规划冻结两裁落文(2026-10-09,用户令;.zcode/patch_rulings_20261009b.py)**:①素材库案乙**已追认**——design/research/道具退役素材库.md 头注换代(去「待追认」);②**迭代 20/21/22 规划冻结**——用户令「先不要去做了,先解决眼前的问题。后续要做的话,我会直接跟你说」,roadmap 迭代 20 行落冻结注,重启=用户直接发令;关联悬置件随冻=X/Y 刷新语义裁(甲改实现/乙认现状)与空配置验收闸落 06;③用户对呈报方式立要求=裁点必须配足上下文(「我得知道你所有事项的上下文,才能好去做裁断」)——审查批呈报册重组为 A 类卫生件(打包荐直接做)/B 类真裁点(逐件带现状/证据/候选+推荐)呈报;记忆已立三条(冻结令/归口规则/命名统一)。
@@ -60,9 +62,10 @@
423. **落籍完成 03c4b4c+核验全过(2026-10-09,用户自跑 `git commit -F .zcode/commitmsg_20261009.txt` 绕过守卫;主会话核验)**:74 文件 +1153/−773 十一批全落 master(提交信息十一条明细完整);核验=①四新文件入库确认(systems/跨局循环/天赋树.md、design/research/道具退役素材库.md、需求卡片-M4数值批、需求卡片-冒险前资源配比预设批〔quotepath=false 实照,首查空结果系中文路径转义伪象〕)②旧「任务书-」文件名 HEAD 清零(改名完成)③06 并行会话「active.md 定性与裁剪」条目 HEAD 0 处、工作区 1 处保留=零吞并成立 ④排除件未带(.gitignore/.zcode/config.json/playnote 仍脏、untracked 五件仍未跟踪)⑤.zcode 工具件(补丁脚本/提交信息)确认被忽略;**残留两小件**=design/research/提案-武器锻造系统-2026-10-07.md 3 处命名替换漏暂存未入库(可 `git add` 该件+`git commit --amend --no-edit` 并笔,或随下一批)+active.md 422/423 两笔系暂存后追加未随批(随下一笔记账入库);game/project.godot 已转净(并行会话处置,非本会话动作)。
424. **active.md 立宪+大裁批(2026-10-09,用户令先定规则再清历史;纯文档零代码零测试)**:①**拍板链**:用户裁定性=active.md 是状态文件非历史日志(论据=文件头自述「唯一状态源」/职能全是现在时态/git 已承载历史+active.md 自身 140 个历史提交版本证明删除不销毁记录;「日志对读者的价值集中在尾巴,尾巴的学名就是状态」);裁退役节奏=每迭代收口清+超 30 条兜底(每里程碑清随日志身份废弃);裁保留线五项含当前迭代条目(进行中的尾巴不是历史);裁九月死节全删。②**立宪六处落盘**:doc-conventions §10 新增 active.md 定性章程+§11 引用面口径定性句改写;CLAUDE.md 四处(运行文件登记/会话进度记录行/收尾步骤补删除已完结旧条目/收口落记);用户级技能 doc-consistency-check 增第九检查「active.md 状态卫生」(总行数/快照条数/死节残留/完结条目残留,只报不修)。③**吸收扫描硬门**:只读子代理对删除集 985,501 字节(约 98%)逐行旗标词扫描(非抽样,①-⑦节全覆盖),漏网 2 项已迁 06(美术审计两项 P0=art-bible 第 68/527 行死样张指涉+像素管线重产未登记;filter-repo 历史清理计划书待批悬空——原登记死亡清单已随存量批删除)+低置信观察 1 项(迭代 18 卡②孤儿点棋盘观感定性/关卡节点图改版)入探讨备忘;其余判定已吸收。④**大裁执行**:941 行 1020989 字节→新文件(本文件);头指针六处死路径当场修正(production/ 三处、docs/architecture、docs/prototype-report、06-待拍板清单 旧名);保留=改写头+快照 10 条+当前位置重写+未决面+条目 414-423 号+本条 424 号。⑤**过程与事故规避**:工作树守卫拦主区直改 doc-conventions→python 补丁法过闸(先例在册);并行会话写入期主动挂起(用户令),文件 929→941 行(417-423 号新增)后经用户确认窗口安静(25 分钟无写入+核对补丁在位)恢复执行;组装前重新定位节区、尾部条目动态提取(≥414 全保,实测 414-423),写入单窗口原子完成;并行重录造成的条目乱序(414/415 在前)已归位升序。⑥立宪六处已随用户自跑提交 03c4b4c 入库(全部会话含 worktree 即时按新规矩运行);本批残余改动=本文件大裁+06 四条(裁决条状态留痕+扫描迁移三条),提交待用户过目摘要后放行。
425. **会话收尾·交接文档交付(2026-10-09,用户问「是否还有未完成任务」并索 handoff;主会话)**:本会话指派事项全部闭环(十一批文档落籍 03c4b4c/用户历次裁全落文/B 类五项+A 类卫生包完结/代码修复规划 prompt 已交付用户另会话);**交接文档=C:\Users\DK\.zcode\handoff-doc-consolidation-2026-10-09.md**——已完成清单(勿重做)/待办六类=①两小件入库(提案-武器锻造系统 3 处命名替换 `git add`+`--amend --no-edit` 或随批;本文件 422/423 两笔随下批)②B5 代码修复承接(06「现役 UI/文案两处自相冲突」条,用户已另会话产需求卡片)③树侧双轨欠账四问+跨文档欠账三处(421 ④)④文档复审(用户持独立 worktree 审计 prompt,开工门=落籍已满足)⑤小尾巴(素材库待核 4 行/秘宝 v0.6 双行 a/b/难度曲线 L122/06 欠账块标题重复精简)⑥冻结线(退役删行批+实装批+迭代规划,重启=用户直接发令)/规则与坑(主区 hook 双拦〔Write/Edit+git commit,豁免 active.md 与 .zcode〕、零吞并摘条目法〔hash-object+update-index〕、并行会话活跃三实证〔覆写/追加/推 HEAD〕、quotepath 中文转义伪象、呈报必须配上下文、里程碑语义与需求卡片现行口径);新会话凭交接文档续作,先问用户当日意图。
426. **交接续作·武器锻造实态核实+命名替换收尾暂存(2026-10-09,交接文档续作会话首轮;用户立会话规则=本会话只做文档处理,代码/bug 修复不承接〔B5 已 handoff 另会话〕;主会话直执,零文件内容改动〔仅 git add〕)**:①**会话规则与用词纠正**:用户立本会话范围=只做文档相关处理,核心工作方式=与用户逐项确认要做/不做/待设计/待纠正;自造词「未随批」被纠正(非通用工程术语)→改用平实说法「写于提交之后、尚未提交」。②**active.md 新职责确认**:状态文件非历史日志(2026-10-09 立宪)——快照节标题行「再追加工作日志」与条目「工作日志 NNN」字样系定性后残余,清理待用户裁(本轮呈报未裁)。③**武器锻造系统实态核实**(用户三问全答「是,未做」):零实现=代码无武器实体、营地属性锻造系现役买数值非武器系统、hero.tres 攻击类型/甲型两字段休眠无消费;正式 GDD 零份=仅 design/research/提案-武器锻造系统-2026-10-07.md(17 裁点全部待裁决)+playnote.md 手记(想法来源)+06 L109-115 专条;流程位=提案待盘问裁决→裁后写正式 GDD(落点 design/gdd/systems/跨局循环/=元进度目录,用户已指认)→实装另立批次;提案下一步(盘问裁决 or 留档待议)待裁。④**命名替换收尾**:提案-武器锻造 3 处「任务书→需求卡片」经 diff 核验系前会话已改毕在工作区(3 段 4 处无夹带),用户授权后 git add 入暂存区(暂存区仅此一件),提交命令已交付 chat 等用户自跑(主区 commit 被 hook 拦);active.md/06 大裁迁移四条仍待用户过目摘要放行,未混入本次暂存。⑤登记纪律:本条与快照行为写入后尚未提交(随用户下次提交或后续批次入库);快照节现 12 条超立宪 ≤10 上限,瘦身口径待裁未擅删。
426. **交接续作·武器锻造实态核实+命名替换收尾暂存(2026-10-09,交接文档续作会话首轮;用户立会话规则=本会话只做文档处理,代码/bug 修复不承接〔B5 已 handoff 另会话〕;主会话直执,零文件内容改动〔仅 git add〕)**:①**会话规则与用词纠正**:用户立本会话范围=只做文档相关处理,核心工作方式=与用户逐项确认要做/不做/待设计/待纠正;自造词「未随批」被纠正(非通用工程术语)→改用平实说法「写于提交之后、尚未提交」。②**active.md 新职责确认**:状态文件非历史日志(2026-10-09 立宪)——快照节标题行「再追加状态记录」与条目「状态记录 NNN」字样系定性后残余,清理待用户裁(本轮呈报未裁)。③**武器锻造系统实态核实**(用户三问全答「是,未做」):零实现=代码无武器实体、营地属性锻造系现役买数值非武器系统、hero.tres 攻击类型/甲型两字段休眠无消费;正式 GDD 零份=仅 design/research/提案-武器锻造系统-2026-10-07.md(17 裁点全部待裁决)+playnote.md 手记(想法来源)+06 L109-115 专条;流程位=提案待盘问裁决→裁后写正式 GDD(落点 design/gdd/systems/跨局循环/=元进度目录,用户已指认)→实装另立批次;提案下一步(盘问裁决 or 留档待议)待裁。④**命名替换收尾**:提案-武器锻造 3 处「任务书→需求卡片」经 diff 核验系前会话已改毕在工作区(3 段 4 处无夹带),用户授权后 git add 入暂存区(暂存区仅此一件),提交命令已交付 chat 等用户自跑(主区 commit 被 hook 拦);active.md/06 大裁迁移四条仍待用户过目摘要放行,未混入本次暂存。⑤登记纪律:本条与快照行为写入后尚未提交(随用户下次提交或后续批次入库);快照节现 12 条超立宪 ≤10 上限,瘦身口径待裁未擅删。
428. **武器锻造成文批提交合入——worktree wforge-gdd(2026-10-09,用户令「完成文档的编写并提交合入到master;代码实现可以不用实现,只要记录一份待办事项」+严批「为什么要我跑?在独立 worktree 里编辑并按规范合入,自己的屁股自己擦」=提交合入会话自治立规,不再把提交交给用户跑;主会话直执,纯文档零测试零游戏跑批)**:①**成文**:新建 design/gdd/systems/跨局循环/武器锻造.md v0.1——按 2026-10-07 提案 v1.1 推荐案收录定案口径(柜台就地改造属性锻造柜台〔生命档保留〕/三武器剑枪杖三甲型轻重魔法甲各自独立等级路线/当前武器与当前甲单选营地免费切换战斗中禁换/纯钥石零材料/前缓后陡曲线/解锁锻造内自闭环/满级特效复用为主——四条零代码三条新参数位零新效果类型/与奇物·克制矩阵·商店货架·专长联动·天赋树·配比冻结批六处相邻边界显式化);**17 裁点用户未逐点拍板=文档按推荐案记录+开放表在册(「待裁决清单」节),任一推翻即改文档**,裁决权始终在用户;数值 provisional 终值归 M4 数值批。②**关联面同步**:02-系统清单 v1.18(文档树跨局循环区+系统总表两处补行,代号随实装批对齐)/元进度 v1.12(三柜台节补指路句——攻击护甲两档路线化改造设计正主=武器锻造,落地前三档直购维持现役)/06 武器锻造专条状态改「已成文转正」(归属改指新文档,提案过程稿保留作成文底稿〔备选案与淘汰依据在彼〕)+新登记「武器锻造系统实装批」待办条(迁移面七项:meta.tres 两行改造/hero 两轴启用/feats 死行改值 magic_vs_ward/存档域新增/特效三参数位/术语登记/同种子配对读数验证——前置=17 裁点裁决,状态=冻结〔迭代规划冻结令覆盖〕)。③**worktree 流程自治**:worktree g-plan2-wforge 分支 wforge-gdd 基点 bbc849e(master 已被并行复核批会话推进合入 docaudit 独立复核批=427 号,建 worktree 时核对基点后动工);主区积压三件最新版拷入随批=active.md 立宪大裁新版(含 424-428 条)/06 大裁四条迁移(active.md 定性条〔状态已改已裁决并执行〕+美术 P0 两条+filter-repo+奇物备忘——并行复核批 merge 时经 stash 避让原样放回工作区,本批随批入库)+提案-武器锻造 3 处命名替换;427 号已被并行会话占用本条顺延 428(先查尾部再落笔惯例生效)。④**注意事项**:主区 .gitignore/.zcode/config.json/playnote.md 脏件与五件 untracked 仍按前序纪律不带;快照节现 14 条超立宪 ≤10 上限持续在涨,瘦身口径仍待裁未擅删。
429. **天赋树欠账三分流批——worktree tree-debt-gdd(2026-10-09,用户三令:①「设计完整、实现缺失的记录到 06;设计有问题的给 prompt 另会话讨论」②「9.18 的内容已过期,按最新为准删除」③「乙丙销账确认」;主会话直执,纯文档零测试)**:①**06 新条「天赋树已建未接面两件——设计定案、实现缺失」**:同调位 2/3 槽位收编(设计原稿「Socket 节点=同调位 0→3;树管容量」——实装判定源留秘宝谓词表)+命中线 flat 注入(设计第四线、值域归数值批)——《整合定稿》git 8e02dcf 取证定性质=实现缺失非设计缺口,处置=实装批+数值批,冻结待排期;**设计灰色地带不入此条**=刷新升级节点(设计正主全文零出处、实装自造、双入口冲突=设计没做好)+树四线×武器锻造柜台改造叠加关系(新交叉面)——用户另会话设计讨论,prompt 已交付 chat。②**registry 词条换代**:entities.yaml「永久强化」词条「『天赋树』同日退役——本作无树形结构」过期句按最新口径替换(树形承载迭代 12 在役 e780063+正主指路天赋树.md+新旧概念划界「9-18 所退役系旧归档线索同名概念」);同文 L870 批注行系 9-18 批次修订历史留痕按惯例不动(批次登记行不改原文的既有口径)。③**camp.md 补树面板结构位行**(三柜台列后:图鉴柜台下段程序占位/系统正主天赋树/呈现终稿归 HUD框架/两信号名)——树侧跨文档欠账丁清偿。④**销账确认两项**(用户问「乙丙是否不需再处理」=是):乙=entities.yaml 树域登记系迭代 18 存档 v6 批补(669c1c7 自述「v5 批漏账补齐」);丙=存档序列化 v5 树域系并行复核批换代补齐(docaudit v1.4)——均无需本会话动作。⑤**三缺口性质定案呈报**(git 取证):同调位=实现问题(设计有实现断线)/命中线=实现未完成且时序系设计安排(数值批定值后接线)/刷新升级节点=设计灰色地带(实装超出设计稿产物)。⑥并行动态:master 期间被复核批会话推进 e39a4d6(427 号按立宪退役规则自清),本批基点随之更新;主区本批涉及三文件(06/entities.yaml/camp.md)合入前均干净。
430. **小尾巴卫生批——worktree hygiene-batch(2026-10-09,用户裁「秘宝 v0.6 双行加 a/b 后缀区分,后续号不挪」+三件打包收官交接文档第五事项;主会话直执,纯文档零测试)**:①**秘宝.md 版本表双 v0.6 改 v0.6a/v0.6b**(用户问询后取证呈报=非并行撞号:两行差 4 天〔9-30 拍板点 1 收口批/10-04 迭代 13 D6 实装修订〕,10-04 批落行未查前账致重号,当时序列已到 v0.8;两行内容均系用户裁决过的合法批次记录无脏信息;顺延方案否决=级联改 v0.9-v1.7 九行且秘宝 v1.5/v1.6/v1.7 被素材库头注与 06 等外部引用会全部失配;v0.6b 行尾补改注说明);②**06 欠账块标题重复精简**(L464 #### 标题与 L466 粗体首行逐字重复——删粗体行,括号补注〔新重闸首跑翻出/复测确认存量旧债〕降为正文首句);③**素材库表三「待核 4 行」→「已核」**(核实结论落盘=探宝罗盘/工兵令已退役〔罗盘系 9-29 拍板①乙/工兵令系 10-08 旧目录退役连带、treasure_items.tres 表头注 T7 逐件销账在册〕+显影尘/地穴全图卷 deferred 能力封存〔9-29 拍板④甲有意封存非废弃〕;待核标记摘除,正式入库归退役删行批);④**难度曲线与Boss.md L122 销账**(git -S 取证=「该指向已过期……随数值批重开时核销」注记系 03c4b4c〔421 批 A 类卫生包 v0.27〕写入——交接文档把已清偿项误列为待办,系其写作时点〔422-425 追加期〕早于落籍核验;零改动)。**交接文档待办六类至此全部闭环**:①随 621f8f4 清偿/②B5 已 handoff 且 06 在册/③树侧欠账分流完毕〔429+设计讨论 prompt 用户另会话进行中〕/④文档复核=并行批 bbc849e/⑤本批收官/⑥冻结线等发令。
431. **天赋树裁定跨文档同步批——worktree tbox-docsync(2026-10-10,用户令「本批只做文档同步,勿再开裁」;主会话直执,纯文档零测试零代码)**:背景=天赋树设计会话(另会话)已裁锻造枝删并+改名+两附随项,本批纯同步落文零新裁。①**A 面**:武器锻造.md v0.2——「柜台承载」节补登记树侧解锁门(本柜台以天赋树「锻造工坊」解锁节点为前置:免费节点,前置 = 攻击淬炼累计 ≥2 级 且 护甲淬炼累计 ≥2 级〔等级阈值前置属新机制〕;解锁对象=武器三路线+护甲三路线营地柜台;树侧结构换代设计正主=天赋树.md〔归设计文档批落文,允许短期新旧名并存〕,实装归 06 重构批条)+版本历史一行。②**B 面 06 两处**:新登「天赋树结构重构批—实装待办」条七项(meta_tree.tres 33→31 锻造枝三删一换/存档 v4→v5 迁移规则重做〔forge_levels 不再映射锻造枝〕/schema 前置机制扩等级阈值形态/营地锻造柜台树侧解锁门接线/秘宝匣改名连带面〔柜台 UI 名+表行语义,代码标识符 workshop_items 归本批〕/地脉共鸣=四条淬炼线全部买满〔已裁登记〕/同调位 1 改无前置根节点〔已裁登记〕;状态=冻结待发令);「武器锻造系统实装批」条补关联句(树侧解锁门+迁移面共域,排期两批合并评估)。③**C 面「道具工坊→秘宝匣」改名扫改九文件现行正文**(版本历史行零触碰):元进度.md v1.13 六处+版本行/秘宝.md v1.8 两处+版本行/HUD框架.md v0.16 迭代 19 卡④注记内一处+版本行/camp.md v1.2 两处+版本行/art-bible.md v3.13 两处(§2.8+§6.2 三柜台括注)+版本行/art-assets-checklist.md §3.5 一处+补建版本历史表/03-内容规模.md v1.2 一处+版本行/07-体验验证清单.md v0.5 一处+版本行/game/README.md 一处+文末新节〔注记代码标识符与界面文案未动归实装批〕;registry entities.yaml 术语条新登「秘宝匣」(别名「道具工坊」保留检索)+meta_progression_conversion_table first_version_rows 一处扫改(registry 无版本表=指令豁免)。④**红线遵守**:天赋树.md 零触碰;game/ 代码与数据表零触碰(仅 README 文档面);design/research 与 design/qa 零触碰。⑤**收口自验**:C 清单九文件现行正文 grep「道具工坊」全零;残留均属红线保留面=元进度版本历史四行(v1.0/v1.6/v1.8/v1.10,用户红线「版本历史行一律不动」优先于 grep 清零自验,如实呈报)+各文件本批改名记录行+registry 别名;**清单外残留三处未动待裁**=存档序列化.md 两处(表行+迁移描述——后者所述 v4→v5 迁移本就要随重构批重做)+tools/balance_verifier.py 一处+武器锻造.md 两处(柜台承载淘汰理由句+5a 裁点表「塞进道具工坊」——裁点表系裁决记录留痕)。⑥流程=worktree tbox-docsync 基点 c563505 自治提交合入;快照节 15 条持续超立宪 ≤10 上限,瘦身口径仍待裁未擅删。
432. **第一版秘宝全弃用收官批——worktree treasure-lib-13(2026-10-10,用户裁「第一版全部弃用入素材库——退役与封存都是放到素材库,无留待 Alpha 重定的挂起」+质询「你做的跟我想的有无不一致」=有:我此前把显影尘/地穴全图卷的 deferred「能力封存」当 9-29 拍板④甲的待定活状态尊重、未迁表一;用户口径下封存=弃用,偏差即纠;主会话直执,纯文档零测试)**:①**状态改裁**:显影尘(probe_dust)/地穴全图卷(catacomb_scroll)deferred→retired——2026-09-29 拍板④甲「能力封存、Alpha 重定」就此终结(用户以「第一版全弃用」总裁决覆盖);②**素材库**:四件(探宝罗盘 loot_compass〔9-29 拍板①乙退役〕/工兵令 sapper_order〔10-08 旧目录退役连带〕/显影尘/地穴全图卷)迁表一——表一 9→14 件(顺带修正标题「9 件」漏计魔法提灯的旧不一致),每行补原效果一句话(按数据表 effect_kinds:罗盘=未开格类型微光 reward_preview/工兵令=行动点补给 ap_grant/显影尘与地穴全图卷=未投值 effect_kinds 空仅维度标签),表三整节摘除留指路句(数据表四行删除归退役删行批);③**秘宝.md v1.9 四处正文换代**:豁免面段「信息维度随显影尘/地穴全图卷能力封存悬置」→「退役失义」/五维度表信息行改「无有效承载(豁免)+已退役+未来承载走新体系三关」/投放态注记 deferred 呈现改 retired/护栏验收行同步;④**术语澄清在案**(对用户质询的答复):retired=废弃不投放;deferred「能力封存」=设计在案暂时关掉留位待定(9-29 拍板的原意=Alpha 期重定)——本批后本仓不再有 deferred 态秘宝;⑤基点 4e66ee9(天赋树裁定跨文档同步批已合入——另一会话设计讨论产出,武器锻造解锁门+秘宝匣改名等);master 本批涉及两文件合入前干净。
433. **状态记录更名+会话状态清除新规+秘宝实装待办登记批——worktree status-record-batch(2026-10-10,用户四令;主会话直执,纯文档零测试)**:①**旧叫法来源答复**(用户问「是上下文旧文档还是现行文档残留」=现行文档残留:active.md 快照节标题行本身写着「再追加工作日志」、doc-conventions/CLAUDE.md 条款带旧词——立宪时只改了定性正文未做全量扫改;且我每写一条快照照抄标题格式延续旧词,本轮清扫前 active.md 内 31 处,系我的格式惯性加重残留)。②**全仓清扫**:「工作日志」→「状态记录」五文件 105 处(active.md 31/doc-conventions 13/CLAUDE.md 5/06 10/roadmap 46);§10 章程定性句补「2026-10-10 用户再立:它是状态记录,不是工作日志——旧叫法废止」。③**新规落文**(用户立「当我确认任务完成时,把当前会话写过的状态都清除掉——状态清除证明任务已完成,不是正在执行中」):落 doc-conventions §10 退役规则首句;后续执行=用户每确认任务完成,清当会话状态条目。④**06 新条「秘宝体系实现重构落地批」**(用户令「文档层面已修改完成,记录待办=新设计的实现重构落地」):新 15 件实装/旧数据行清理(表外四行 deferred 清零+九件行+提灯拆线)/feats 27 行删除/空配置验收闸/池选型三案/效果引擎扩签/两疑似漏项 T0——状态=冻结待发令;文档与数据表窗口期不一致随本批消解。⑤冻结线呈报随本条交付 chat(退役删行/实装散件/迭代规划三类+已登记四条盘点),登记形态等用户裁。
+7 -7
View File
@@ -62,11 +62,11 @@
|---|---|---|
| 给工作包起代号 | "样张批""八型批""资产升档重产批" | 叙述名 = 日期 + 做什么,如"2026-10-01 按新分辨率规格重做素材" |
| 给机制、检查、基线、区域造名词 | "熵增闸""形象锚""判读口径""暗淡记忆态""变异纹带" | 用行业通用词;确实要长期复用的概念走上面的登记通道(正常名字 + 首现白话定义 + registry 登记) |
| 给流程步骤造动词 | "收口""落籍""在飞""随批""对拍""销账""正主""台账" | 用日常动词:完成 / 合并进 master / 执行中 / 顺带 / 与基线数据逐项比对 / 注销 / 定义所属的那份文档 / 工作日志 |
| 给流程步骤造动词 | "收口""落籍""在飞""随批""对拍""销账""正主""台账" | 用日常动词:完成 / 合并进 master / 执行中 / 顺带 / 与基线数据逐项比对 / 注销 / 定义所属的那份文档 / 状态记录 |
**通行检验标准**:读者是业内人士,但没读过本项目的历史。一个词如果需要作者另外解释才能懂,这个词就不合格,包含它的句子必须重写成完整的白话句——换一个新名词不算改,展开才算改。
**写后自查**:每写完一条工作日志、一篇文档,重读一遍——凡是自己都要停顿一下才能想起意思的词,一律展开成完整句子。
**写后自查**:每写完一条状态记录、一篇文档,重读一遍——凡是自己都要停顿一下才能想起意思的词,一律展开成完整句子。
## 5. 结构纪律
@@ -161,9 +161,9 @@
## 10. 会话记录纪律
**active.md 定性:状态文件(2026-10-09 用户裁决)**。根目录 `active.md` 是会话状态的唯一状态源,**每一行都必须在当下为真**;它不是历史档案——历史变更一律以 git 提交史为准(删除条目不销毁任何记录:`active.md` 自身的每个历史提交版本都完整可查)。只许写入三类内容:①当前状态快照(≤10 条滚动窗口);②未决面(进行中批次/待人闸/待裁点的指针);③当前迭代的滚动工作条目。禁止写入:已完结批次的历史叙述(归 git 与各正主文档)、待办裁决事项(归 `06-待办清单.md`)、跨会话教训(归记忆库);并行会话禁止将本文件整体复原/回退(2026-10-09 覆写事故规矩化)。退役规则:条目完结判据=批次已落籍+结论已进快照+未决面无条目指向它;每个迭代收口时删除已完结条目,工作日志超过 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 用户立规)
@@ -176,8 +176,8 @@
| 吸收即死 | 中间文档的结论写进正主文档(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 提交史为准) |
| 工作日志记结论 | 工作日志条目记裁决结论本身,不记中间文档文件指针;中间文档删除后不留死链指针 |
| 引用面口径 | 活文档(`design/gdd`+`design/art`+`design/dev`+`design/registry`+`roadmap.md`+`tools/`)对中间文档的指路阻塞删除:先把指路句改写为结论内联或 git 提交号,再删文件;根 `active.md` 状态记录引用不阻塞(状态记录=当前状态与最近批次的记录;历史变更一律以 git 提交史为准) |
| 状态记录记结论 | 状态记录条目记裁决结论本身,不记中间文档文件指针;中间文档删除后不留死链指针 |
| sim-data 白名单 | `sim-data/` 只保留 README、日志、分析工具 .py、现行 MC 对拍锚(显式清单)、设计文档 md;可再生原始数据(runsum/raw jsonl/逐局 CSV/report txt/样例输出)不入库 |
| 出口清理项 | 每迭代出口检查单必含清理项:本迭代中间产物逐份核对(结论已吸收、未决已迁移)后删除 |
| 暂存地非档案库 | `design/research/` 与 `design/qa/` 是中间文档的暂存地,不是永久档案库;入此两处的文件默认按本节规则到期即死 |
@@ -200,7 +200,7 @@
| 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 条自造短语),且未明确覆盖对话输出与工作日志命名 |
| 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 定性为格式机检面 |
+16 -6
View File
@@ -143,6 +143,16 @@
**状态**:待办(冻结——2026-10-09 迭代规划冻结令覆盖,重启=用户发令;天赋树.md 正文落文归设计文档批,本条只承载实装面)
#### 秘宝体系实现重构落地批 — 待办(冻结:迭代规划冻结中,重启=用户发令)(2026-10-10 用户令「文档层已改完,记录新设计的实现重构落地」登记)
**背景**:文档层已全部换代完毕——现行正主=秘宝.md「目录(重设计 v1)」新 15 件(三档骨架+解锁谓词分级,数值 provisional 归调参批);第一版 14 件(旧九件+表外四件+魔法提灯)已全数裁退役入素材库(2026-10-10 用户裁「退役与封存都进素材库」,deferred 态清零——显影尘/地穴全图卷原 deferred 封存态一并终结);「道具工坊」更名「秘宝匣」(2026-10-10 天赋树裁定批,文档正文已扫改)。**代码与数据层未落**——`treasure_items.tres` 现行行仍系旧体系:表外四行(显影尘/地穴全图卷字段值 deferred、工兵令/探宝罗盘 retired)+旧九件行+魔法提灯行及卡④接线。
**内容**:① 新 15 件按「目录(重设计 v1)」实装(数据行重建/迁移、解锁谓词、装配与同调位面、秘宝匣柜台语义);② 旧数据行清理(表外四行+旧九件行+提灯行拆线+卡④接线拆除,deferred 态清零——文档与数据表的窗口期不一致随本批消解);③ 专长侧联动:`feats.tres` 27 件旧行删除(名单=素材库表二)+新专长框架实装衔接;④ 空配置验收闸(三选一池空兜底/商店空货架/装配面空目录);⑤ 池结构选型三案(概率上限解耦的耦合案随批选型)与配额数字;⑥ 效果引擎扩签核实与停手挂点;⑦ 件级跨事件状态账、秘宝参数注入面两疑似漏项 T0 核实。
**归属**:[秘宝](systems/排雷循环/秘宝.md)「目录(重设计 v1)」实装 + [道具退役素材库](../research/道具退役素材库.md) 对应清理面
**状态**:待办(冻结——2026-10-10 迭代规划冻结令覆盖,重启=用户直接发令)
#### 内部分类禁写入玩家可见面——奇物呈现三处违规待改(2026-10-04 用户立意登记)
**现状**:用户立意(方向已明确):形态(规则改写型/属性加成型)等内部分类**不得写进玩家可见的名称、介绍词或界面**——玩家可根据效果自行推断类别,游戏不得直接点破。查证实态:26 项专长奖励的 display_name 全风味名(奥术余烬/贯穿射击/矿工的执拗等,合规,符合 2026-09-29 playnote 既有批评);**违规三处**(均系迭代 12 呈现补齐批所落,承载用户「局内奖励选了什么看不到」反馈——缺口承载需求仍成立,撤的只是分类字样):① 三选一+商店特性卡面第二行印流派名(`battle_narrator.gd` relic_card_text,「奥术余烬 · 魔法」式);② 战斗屏 C 区列表标题(现为「特性」)+逐流派聚合行「魔法 ×2 · 档一」(`hero_info_panel_view.gd` + `hud_presenter.gd` relic_holdings_lines);③ 关卡选择页复用同一聚合文案(`level_map_screen.gd`)。**边界**:效果摘要行(「普攻附加必中伤害」)保留——那是件本身在做什么,是玩家推断归类的依据。
@@ -448,18 +458,18 @@
#### active.md 定性与裁剪 — 裁决零(定性)+ 四项推论待裁(2026-10-09 会话呈报)
**背景**:根目录 active.md 已从状态文件漂移成追加式日志——928 行约 1MB,快照节标题写「≤10 行」实际堆了 129 条,编号条目四百多条,另有五个 2026 年 9 月时代的死节;「只追加不删除」成因已定案=收口协议只定义追加从未定义退役(遗漏而非规定)+doc-conventions.md:177「工作日志=历史变更记录」豁免句系 agent 起草越权(用户从未裁决永久保留)。2026-10-09 用户指出定性是前置问题:若是工作日志(历史变更记录),可全量记录+定期归档成文件链;若是状态文件,只追加的做法本身不成立。先定性,其余裁断随之收敛。完整论证见 active.md 工作日志 416 号条目。
**背景**:根目录 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 条+当前迭代条目),删前迁移检查(吸收即死程序)保证没被正主吸收的结论零丢失。
备选定性=工作日志:名正言顺全量记录+按里程碑滚入归档文件形成文件链(如 worklog-2026-09→2026-10);自洽且常见,收益=单一入口可翻全部历史,代价=多养一份资产+一套归档流程+与 git 双份记账。agent 不荐:先按状态定性跑,日后若发现 git 提交史不够翻,归档链随时可从 git 生成,届时建链零成本。裁=定性为状态文件(荐)/定性为工作日志+建归档链。
**裁决零: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),未吸收的先迁再删。」(末句系吸收即死既有铁律自动适用。)
- 推论一(doc-conventions.md:177 定性句):就是把裁决零落文的动作——改为「状态记录=当前状态与最近批次的记录;历史变更一律以 git 提交史为准」,同行「日志引用不阻塞其他文档删除」功能保留。裁=认可措辞或改字。
- 推论二(清旧条目时机):窗口怎么滑——甲=每迭代收口时清已合入 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。裁=照准全删。
**若定性为工作日志**:推论三改为近期条目留正文+旧条目按里程碑滚入归档文件;推论四死节先归档再删;推论一、二不变(177 句改为「工作日志=历史变更记录,按里程碑归档」口径)。
**若定性为状态记录**:推论三改为近期条目留正文+旧条目按里程碑滚入归档文件;推论四死节先归档再删;推论一、二不变(177 句改为「状态记录=历史变更记录,按里程碑归档」口径)。
**执行方式**(不另设裁决):大裁=独立小批、无并行批次窗口、主区直改 active.md(豁免面)、改完先给用户摘要再提交。
+25 -25
View File
@@ -16,17 +16,17 @@
| 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-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-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)
- **阶段**:Vertical Slice Implementation(`stage.txt`)
- **已达成**:一局完整三关冒险+存档+元进度+营地闭合(数值 provisional,归 M-3 调参批标定);**M-1 切片表现收口关闭**(初步验收 2026-09-28,出口检查单 `design/qa/m1-exit-gate-checklist-2026-09-28.md`);**M-2 关卡画面独立化关闭**(出口闸 2026-09-28 通过,出口检查单 `design/qa/m2-exit-gate-checklist-2026-09-28.md`);UX 文档面四 spec 齐(battle / level-map / level-clear / interaction-patterns)
- **挂起待用户输入(批次解锁点)**:① 真人试玩批次(并入 M-3 迭代 5 读数)——已解闸存档:M-1 出口闸目检(2026-09-28 通过);**M-2 出口闸目检(2026-09-28 通过,八项全过)**;ADR-0007 裁决(裁丙,工作日志 210);高墙档=D 投影+字体=Fusion Pixel OFL;样张 v1 否决原因四条(已断言化,样张 v2 冻结);关卡画面独立形态(2026-09-28 用户裁决——M-2 立项依据)
- **已知挂账**:魔法道具内容批(迭代 7 承接,node-reward spec 随批出生);元进度柜台定价标定(迭代 7);反制批 Alpha(M-4);迭代 5 出口三件**已全闭**(2026-09-30 收口批工作日志 290——目检 15/15 过/带改普通 L2 [10,15]+丙追认/荆棘外延否决根因改判);完美 L1 越带处置已并入带换代承接(难度曲线与Boss.md 带换代节:落带收敛归全局难度批、M-4 排序——先带 D 悬崖修复后带值收敛;原「战斗阶段数值问题」06 条目随四带换代收口移除)
- **挂起待用户输入(批次解锁点)**:① 真人试玩批次(并入 M-3 迭代 5 读数)——已解闸存档:M-1 出口闸目检(2026-09-28 通过);**M-2 出口闸目检(2026-09-28 通过,八项全过)**;ADR-0007 裁决(裁丙,状态记录 210);高墙档=D 投影+字体=Fusion Pixel OFL;样张 v1 否决原因四条(已断言化,样张 v2 冻结);关卡画面独立形态(2026-09-28 用户裁决——M-2 立项依据)
- **已知挂账**:魔法道具内容批(迭代 7 承接,node-reward spec 随批出生);元进度柜台定价标定(迭代 7);反制批 Alpha(M-4);迭代 5 出口三件**已全闭**(2026-09-30 收口批状态记录 290——目检 15/15 过/带改普通 L2 [10,15]+丙追认/荆棘外延否决根因改判);完美 L1 越带处置已并入带换代承接(难度曲线与Boss.md 带换代节:落带收敛归全局难度批、M-4 排序——先带 D 悬崖修复后带值收敛;原「战斗阶段数值问题」06 条目随四带换代收口移除)
## 主线路线(里程碑 × 迭代序列)
@@ -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,11 +46,11 @@
| # | 迭代 | 门(进入条件) | 更改任务 |
|---|---|---|---|
| 迭代 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 门解** |
| 迭代 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 数值实机验收 |
### M-4 Alpha 后深化与内容扩展(Release 4)
@@ -58,16 +58,16 @@
| # | 迭代 | 门(进入条件) | 更改任务 |
|---|---|---|---|
| 迭代 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 基线红归②批处置 |
| 迭代 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 用户令编入本迭代,纯功能与数值轴四卡之一)**:放开敌人表「同一(关卡序号 × 节点深度)行集恰一敌种」加载期校验(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(一轮呈裁基线,盘问轮次扩展另计) |
@@ -81,8 +81,8 @@
## 执行纪律(2026-09-27 用户立规)
1. **一迭代一 loop**:所有更改任务(功能/文档/数值/素材接线)一律进本路线图的迭代,每迭代先立计划书再开工,一个迭代一次合并登记——**零散并行会话退场**(多会话并行 = 冲突源+介入成本;2026-09-27 起单迭代串行执行)。工作日志记「批」= 本文件记「迭代」,同物异名。
2. **例外 = 零碎 bug**:单独会话 mini-loop 修复(修→轻闸→工作日志登记),不立计划书、不占迭代位;同屏同类 bug 攒够一笔可并入下一个迭代当任务卡。
1. **一迭代一 loop**:所有更改任务(功能/文档/数值/素材接线)一律进本路线图的迭代,每迭代先立计划书再开工,一个迭代一次合并登记——**零散并行会话退场**(多会话并行 = 冲突源+介入成本;2026-09-27 起单迭代串行执行)。状态记录记「批」= 本文件记「迭代」,同物异名。
2. **例外 = 零碎 bug**:单独会话 mini-loop 修复(修→轻闸→状态记录登记),不立计划书、不占迭代位;同屏同类 bug 攒够一笔可并入下一个迭代当任务卡。
3. **用户输入闸显式化**:迭代门里所有需要用户表态的点(否决原因/裁决/试玩)在「当前位置」挂起清单可见,解一个开一个。
## 批次 loop 规范(loop engineering)
@@ -93,13 +93,13 @@
>
1. **计划书**(`.zcode/plans/<迭代名>-loop-plan-<日期>.md`):迭代目标与完成定义 / 现状事实(代码级,开工自行复核)/ 设计契约(违反即返工,标 🔴 触碰=L3 停机)/ 范围边界 / 任务卡 T0..Tn(逐卡估时)/ 验证闸 / 异常分级 / 代拍板白名单。
2. **T0 开工**:建 worktree + 基线复读记档(冒烟/探针/三闸/MC 对拍基准)+ `git status` 归属核对(并行遗留只标旗不碰)。
3. **循环骨架**:一轮 = 一个任务卡——读卡 → 对事实源 → 实装 → 轻闸全绿 → 提交(代拍板随 commit 记录)→ 工作日志追加(查撞号)→ 下一轮。单 worktree 多点提交一次合并;轮内禁开第二个 worktree;基线每轮开工时点重测;断点续跑 = `git log` 对任务卡定轮次 + 重跑当轮轻闸。
3. **循环骨架**:一轮 = 一个任务卡——读卡 → 对事实源 → 实装 → 轻闸全绿 → 提交(代拍板随 commit 记录)→ 状态记录追加(查撞号)→ 下一轮。单 worktree 多点提交一次合并;轮内禁开第二个 worktree;基线每轮开工时点重测;断点续跑 = `git log` 对任务卡定轮次 + 重跑当轮轻闸。
4. **轻闸**(每轮必跑,headless):run_smoke 全量 + ui_input_probe(十一断言);触碰 presentation 加跑 ui_click_probe + ui_layout_probe。
5. **重闸**(批末 Tn):全量轻闸 + doc 三闸(doc_link / gdd_lint / doc_term,对基线零新增)+ 熵增闸 + MC 逐位对拍(涉核心)+ 素材批加机检断言。
6. **人闸**(停机交付):真人目检清单 + 代拍板追认清单 + 异步终审触点(样张类)——本循环内唯一必经人审。
7. **异常分级**:L1 自救(一次重试)→ L2 记录继续(连续 3 次同红灯升级)→ L3 停机写报告等用户。
8. **收口五步**:①active.md 快照 ②工作日志条目 ③里程碑移动更新本文件 ④阶段变更改 stage.txt ⑤批末闸序列全绿留痕(loop_dashboard 已随目录收敛退役,透视职责由 06+工作日志承接)。
8. **收口五步**:①active.md 快照 ②状态记录条目 ③里程碑移动更新本文件 ④阶段变更改 stage.txt ⑤批末闸序列全绿留痕(loop_dashboard 已随目录收敛退役,透视职责由 06+状态记录承接)。
## 维护纪律
同「批次 loop 规范」第 8 条收口五步;本文件由里程碑移动触发更新(批次开工/收口不强制改本文件,改的是 active.md 与 06)。快照节 ≤10 行,装不下的细节进工作日志。
同「批次 loop 规范」第 8 条收口五步;本文件由里程碑移动触发更新(批次开工/收口不强制改本文件,改的是 active.md 与 06)。快照节 ≤10 行,装不下的细节进状态记录。