DKChan
39523dd424
用户 2026-10-18 逐裁：①同调电池删除（秘宝＝局外同调件、冒险中零更换途径，
与 cf04bd66 撤换装券／删回能器同一原则，UI 层从未接线选件入口）；②完美保险
改归专长（给的是规则豁免而非可调动的余量，符合 §1.1 判据）；③配额处置＝净删
（rare 9→7／总量 104→102）；④计数器寿命域本批不动，完美保险按现役
domain=battle 落地。
文档面（奇物.md v3.18）：
- 凭证件表「新 5+留任 2」→「新 3+留任 2」，删同调电池行、完美保险行
- §1.3 异质性「被写入的账」注销「秘宝充能」「完美资格」两账；attune_charges
账本与 _seed_attune_charges 仍属秘宝基础设施保留（迭代 11）
- 迁入登记节增写「资源类迁出件（完美保险）」段
- 头注删除「2026-10-07 五件新凭证用户裁准写入文档」失实陈述（当日所裁实为
池结构案D；「资源成员＝转换源」判据句本身本批不动，是否复裁归 06 在册）
- entities.yaml:633 凭证五件入池句加裁削注（104 读数保留代码现值）
- 07-体验验证清单两处加注销标；需求卡片-专长实装批五处加失效／改判注记
- 06-待办清单新增三条：计数器寿命域未统一／凭证件裁削批·代码侧迁移／
2026-10-18 冒记案遗留待裁两项
卡②写卡与编入：
- 新增 design/research/需求卡片-凭证件裁削批-2026-10-18.md——T0–T8 共
≈2.75–4.75d；设计契约 8 条；验证闸 11 个需求点＋6 条变异注入表；
代拍板白名单 5 条；D1–D3 已裁（forgive_flag_miss／rarity rare＋cap 省略＋
desc「本场首次封印落空，不计入完美封印判定」／roadmap 措辞不变）
- roadmap 迭代 31 改为双卡：卡①代码术语刷新批＋卡②凭证件裁削批·代码侧，
周期改 ≈1.5 周
闸：run_all_gates.sh --docs 验收通过。首轮曾报 8 项红（06 三条标题元数据词
不在词表、需求卡片列多卡写法不合 CARD_SEP_RE、周期非「≈N 周」形态），
已按闸规修正：元数据归一（会话提及／审计发现／文档轨／工程直入）、
多卡改「、」分隔纯路径、周期改 ≈1.5 周。
代码零改动——代码侧迁移归迭代 31 卡②另行实施。
97 lines
15 KiB
Markdown
97 lines
15 KiB
Markdown
# 工程路线图（批次执行制：里程碑 + 批次序列 + loop 规范）
|
||
|
||
> 一句话：项目级进度视图——走到哪了、接下来按什么顺序走、每个批怎么跑。待办与待裁事项以 [06-待办清单](design/gdd/06-待办清单.md) 为唯一登记处（条目级）；批次过程与结论查 git 提交信息与 `reports/`（2026-10-18 用户裁：根目录会话状态文件已废除，本节顶部「当前位」三行即其替代）。
|
||
|
||
## 当前位（只回答「现在该做什么」；三行内随批次换代，禁止在此扩写成状态快照）
|
||
|
||
- **阶段**：M3——Alpha 版本的完整实现（2026-10-09 立规：未明令宣布完成前停留 M3，迭代只排 M3 需求，M4 不排期；根目录 stage.txt 为旧阶段开关仅存档）。
|
||
- **迭代位**：迭代 1–30 全部已完成或已终止；**迭代 31 待开工**（两卡串行：卡①代码术语刷新批＋卡②凭证件裁削批·代码侧，均 2026-10-18 编入）。
|
||
- **下一步**：迭代 31 开工令（U0）归用户发。其余候选在 06 状态列——营地交互重做五卡（已写卡待编迭代）、迭代 30 原卡②③（待美术／设计定稿后重新立卡）。
|
||
|
||
## 里程碑时间线
|
||
|
||
| 时间 | 里程碑 |
|
||
|---|---|
|
||
| 2026-09-07 ~ 09-14 | Systems Design 阶段：玩法系统 GDD 全树收口；概念原型 v3 终验 PROCEED（09-12，垂直切片承接）；GDD 体系重构（09-14，旧树封存） |
|
||
| 2026-09-15 ~ 09-16 | 切片数值语言定型：格面资源批、加法核数值语言拍板、护甲等级掷点批落地（smoke 233）、AP6+AC 验收判读口径 v1.0、06-待办清单建账改版 |
|
||
| 2026-09-17 ~ 09-19 | 切片机制完备：敌人技能池批落地（smoke 263）、关卡节点地图 v1.0 定稿+分支图批、加法核 80 遍试玩基线、无伤通关根因批（AP 压速）、验收读数重测批、掷点流种子偏置修复 A+B、插旗不可逆批、worktree 铁律立规 |
|
||
| 2026-09-20 ~ 09-21 | **一局完整冒险闭合**：冒险结构实现批（三关正式序列，smoke 482）、GP+商店房批（smoke 437）、存档序列化批（smoke 518）、元进度实现批（跨局循环闭合，smoke 549）、第三关内容批、八型批 |
|
||
| 2026-09-22 | Package B 七轮数值批+成长对齿已入库（用户拍板接受 B 曲线）；美术圣经 §6–9 全章成文（v2.0）；balance-verifier 数值验证工具批；美术文档过期账清偿批 |
|
||
| 2026-09-23 | 换算率标定批（6/9/1+护甲断链修复）；停点前移批实施（关卡开局即出图+三区化+LevelStripView 退役）；UI 复用候选批 |
|
||
| 2026-09-24 | **垂直切片转正（prototypes/ → game/）**；棋盘 Node2D 迁移 Phase A（BoardView 五层叠序）；伤害管线单据化（DamageController 唯一管线）；棋盘立体中档定稿冻结；状态图标接入 |
|
||
| 2026-09-25 | 棋盘小人贴图系列五批（1.5× 档+脚锚自底边+椭圆影）；AI 生图退出角色资产管线（定位=上游草稿引擎）；生图直出像素网格调研双报告 |
|
||
| 2026-09-26 | **战斗舞台 Node2D 迁移 Phase B（循环 1 收口，MC 逐位对拍零漂移）**；高墙瓦片 v9.3 定稿+换肤批（格面瓦片/敌像槽/接触带微光接线）；封印紫批；UX 文档欠账处置（level-clear 建档）；GP 归属拍板对齐；目录三层收敛大重构（design/artwork/game+熵增闸前身） |
|
||
| 2026-09-27 | 熵增闸已入库（repo_structure_audit 四查）；单元测试与契约层补建登记 P0；UX 文档面三 spec 齐（battle 欠账处置 / level-clear / level-map 三拍板收口）；关卡节点图生成 v0.1→v0.4 立项落文+统一流评估→用户裁丙→**统一随机流批落地（七流并一+全事件日志，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-10-09 用户立规，现行口径）**：现行里程碑 = **M3「Alpha 版本的完整实现」**；M4 = Beta 版本的完整实现。用户未明令宣布 M3 完成前，项目停留在 M3 阶段——迭代规划只编排 M3（Alpha 完整实现）相关需求，M4 内容一律不排期、不进迭代，M4 的门 = 用户明令 M3 完成。2026-10-03「M-3 关闭、Alpha 到手」为验收史记录保留（旧口径 = Alpha 验收到手）；上表旧编号 M-1~M-4 保留作历史序列（M-3 旧名「数值标定与 Alpha 创建」，M-4 旧义「Alpha 后深化与内容扩展」），语义以本注为准。
|
||
|
||
## 迭代总表
|
||
|
||
一行一个迭代，回答一个问题：这个迭代编入了哪些卡、做到哪一步。各列格式与判据见 doc-conventions §12.2，由流水线闸（`tools/pipeline_gate.py`）机检。
|
||
|
||
| 迭代代号 | 状态 | 需求卡片 | 编入时间 | 预计周期 | 实现报告 |
|
||
|---|---|---|---|---|---|
|
||
| 迭代 1 | 已完成（2026-09-28） | — | — | — | 已退役（git 历史可考） |
|
||
| 迭代 2 | 已完成（2026-09-28） | — | — | — | 已退役（git 历史可考） |
|
||
| 迭代 3 | 已完成（2026-09-28） | — | — | — | 已退役（git 历史可考） |
|
||
| 迭代 4 | 已完成（2026-09-28） | — | — | — | 已退役（git 历史可考） |
|
||
| 迭代 5 | 已完成（2026-09-30） | — | — | — | 已退役（git 历史可考） |
|
||
| 迭代 6 | 已完成（2026-09-29） | — | — | — | 已退役（git 历史可考） |
|
||
| 迭代 7 | 已完成（2026-09-29） | — | — | — | 已退役（git 历史可考） |
|
||
| 迭代 8 | 已完成（2026-09-29） | — | — | — | 已退役（git 历史可考） |
|
||
| 迭代 9 | 已完成（2026-10-03） | 已退役（git 历史可考） | 2026-09-30 | — | 已退役（git 历史可考） |
|
||
| 迭代 10 | 已完成（2026-10-01） | — | 2026-09-30 | — | 已退役（git 历史可考） |
|
||
| 迭代 11 | 已完成（2026-10-03） | 已退役（git 历史可考） | 2026-10-03 | — | 已退役（git 历史可考） |
|
||
| 迭代 12 | 已完成（2026-10-04） | 已退役（git 历史可考） | 2026-10-03 | — | 已退役（git 历史可考） |
|
||
| 迭代 13 | 已完成（2026-10-04） | 已退役（git 历史可考） | — | — | 已退役（git 历史可考） |
|
||
| 迭代 14 | 已完成（2026-10-05） | 已退役（git 历史可考） | 2026-10-04 | — | 已退役（git 历史可考） |
|
||
| 迭代 15 | 已完成（2026-10-05） | 已退役（git 历史可考） | 2026-10-05 | — | 已退役（git 历史可考） |
|
||
| 迭代 16 | 已完成（2026-10-06） | 已退役（git 历史可考） | 2026-10-05 | — | 已退役（git 历史可考） |
|
||
| 迭代 17 | 已完成（2026-10-07） | 已退役（git 历史可考） | 2026-10-06 | — | 已退役（git 历史可考） |
|
||
| 迭代 18 | 已完成（2026-10-07） | 已退役（git 历史可考） | 2026-10-07 | — | 已退役（git 历史可考） |
|
||
| 迭代 19 | 已完成（2026-10-08） | 已退役（git 历史可考） | 2026-10-08 | — | 已退役（git 历史可考） |
|
||
| 迭代 20 | 已完成（2026-10-11） | design/research/需求卡片-专长实装批-2026-10-11.md | 2026-10-11 | — | 已退役（git 历史可考） |
|
||
| 迭代 21 | 已完成（2026-10-12） | design/research/需求卡片-天赋树实装批-2026-10-11.md | 2026-10-11 | — | 已退役（git 历史可考） |
|
||
| 迭代 22 | 已完成（2026-10-12） | design/research/需求卡片-秘宝体系实现重构落地批-2026-10-11.md | 2026-10-11 | — | 已退役（git 历史可考） |
|
||
| 迭代 23 | 已完成（2026-10-12） | design/research/需求卡片-锻造工坊实装批-2026-10-12.md | 2026-10-12 | — | 已退役（git 历史可考） |
|
||
| 迭代 24 | 已完成（2026-10-13） | design/research/需求卡片-敌人表内容修批-2026-10-13.md | 2026-10-13 | — | 已退役（git 历史可考） |
|
||
| 迭代 25 | 已完成（2026-10-13） | design/research/需求卡片-UI全局主题批-2026-10-13.md | 2026-10-13 | — | 已退役（git 历史可考） |
|
||
| 迭代 26 | 已完成（2026-10-14） | design/research/需求卡片-UI交互与观感批-2026-10-13.md | 2026-10-14 | — | 已退役（git 历史可考） |
|
||
| 迭代 27 | 已完成（2026-10-14） | design/research/需求卡片-代码架构技术债修复批-2026-10-14.md | 2026-10-14 | — | reports/iter27-实现报告-2026-10-14.md |
|
||
| 迭代 28 | 已完成（2026-10-15） | 已退役（git 历史可考） | 2026-10-15 | — | reports/iter28-实现报告-2026-10-15.md |
|
||
| 迭代 29 | 已完成（2026-10-16） | design/research/需求卡片-测试分层与门禁语义修正批-2026-10-15.md | 2026-10-16 | — | reports/iter29-实现报告-2026-10-16.md |
|
||
| 迭代 30 | 已完成（2026-10-17） | design/research/需求卡片-未开格类型徽章批-2026-10-16.md | 2026-10-16 | — | reports/iter30-实现报告-2026-10-17.md |
|
||
| 迭代 31 | 待开工 | design/research/需求卡片-代码术语刷新批-2026-10-18.md、design/research/需求卡片-凭证件裁削批-2026-10-18.md | 2026-10-18 | ≈1.5 周 | — |
|
||
|
||
- 历史行的「—」= 该列事实不可考：迭代 1~8 早于需求卡片制；编排时点与预计周期不再回溯，细节查 git 提交史。
|
||
- 「已退役（git 历史可考）」= 需求卡片或实现报告曾存在，已按「证据只留最新」退役；已完成迭代的实现报告列只填 reports/ 现存路径或本保留字，不填「—」。
|
||
- 新迭代行的编排与各列判据见 doc-conventions §12.2 与 iter-plan 技能，由流水线闸（`tools/pipeline_gate.py`）机检。
|
||
|
||
## 执行纪律（2026-09-27 用户立规）
|
||
|
||
1. **一迭代一 loop**：所有更改任务（功能/文档/数值/素材接线）一律进本路线图的迭代，每迭代先立计划书再开工，一个迭代一次合并登记——**零散并行会话退场**（多会话并行 = 冲突源+介入成本；2026-09-27 起单迭代串行执行）。状态记录记「批」= 本文件记「迭代」，同物异名。
|
||
2. **例外 = 零碎 bug**：单独会话 mini-loop 修复（修→轻闸→状态记录登记），不立计划书、不占迭代位；同屏同类 bug 攒够一笔可并入下一个迭代当任务卡。
|
||
3. **用户输入闸显式化**：迭代门里所有需要用户表态的点（否决原因/裁决/试玩）登记在 [06-待办清单](design/gdd/06-待办清单.md) 的状态列（待裁决／待美术设计／待写卡），解一个开一个。
|
||
|
||
## 批次 loop 规范（loop engineering）
|
||
|
||
> 模板先例 = 循环 1 计划书（`.zcode/plans/battle-stage-node2d-loop-plan-2026-09-26.md`，已完整跑通收口）。每迭代照此八件成文，缺件不开工。
|
||
>
|
||
> **迭代粒度界定（对齐敏捷迭代/Sprint）**：一个迭代 = 一句迭代目标 + **3–8 个更改任务** + 一份计划书 loop + 一次合并登记，交付一个可验证增量（≈一次迭代交付）。单交付物不成迭代——并入相邻迭代当任务卡；用户输入闸未解的任务不进迭代（留 06 当 backlog，解闸后编入下一个迭代）；**迭代周期 ≈ 一周左右**（2026-10-11 用户裁定——原「软时间盒 ≤3 个工作日，超限即切迭代」系 3abb3bd2 成文时自造、用户从未立过此规，就此废弃）。**里程碑 = 2–4 个迭代的发布级目标 + 出口验收闸（≈Release）**。
|
||
>
|
||
1. **计划书**（`.zcode/plans/<迭代名>-loop-plan-<日期>.md`）：迭代目标与完成定义 / 现状事实（代码级，开工自行复核）/ 设计契约（违反即返工，标 🔴 触碰=L3 停机）/ 范围边界 / 任务卡 T0..Tn（逐卡估时）/ 验证闸 / 异常分级 / 代拍板白名单。
|
||
2. **T0 开工**：建 worktree + 基线复读记档（冒烟/探针/三闸/MC 对拍基准）+ `git status` 归属核对（并行遗留只标旗不碰）。
|
||
3. **循环骨架**：一轮 = 一个任务卡——读卡 → 对事实源 → 实装 → 轻闸全绿 → 提交（代拍板随 commit 记录）→ 状态记录追加（查撞号）→ 下一轮。单 worktree 多点提交一次合并；轮内禁开第二个 worktree；基线每轮开工时点重测；断点续跑 = `git log` 对任务卡定轮次 + 重跑当轮轻闸。
|
||
4. **轻闸**（每轮必跑，headless）：`tools/run_all_gates.sh --quick`（迭代中段自检档）。
|
||
5. **重闸**（批末 Tn）：`tools/run_all_gates.sh` **按本批改动域跑**（只碰 `game/`、`tools/`、`artwork/` → `--code`；只碰 `design/` 与根规则文件 → `--docs`；跨两域或改闸件本身 → 不带参数全量），所选域全绿——闸件清单、顺序与域划分只在该脚本里定义，本文件与 CLAUDE.md/规约均不另列；MC 逐位对拍（涉核心）+ 素材批加机检断言另行。
|
||
6. **人闸**（停机交付）：真人目检清单 + 代拍板追认清单 + 异步终审触点（样张类）——本循环内唯一必经人审。
|
||
7. **异常分级**：L1 自救（一次重试）→ L2 记录继续（连续 3 次同红灯升级）→ L3 停机写报告等用户。
|
||
8. **批次完成后的五步登记**：①06 条目状态按 doc-conventions §12.1 推进（做完整条删除）②本文件顶部「当前位」三行换代，涉及里程碑移动时同步里程碑表 ③**实现批禁写本文件与 `design/`**（2026-10-17 用户裁：代码实现批只准写 `reports/`），该改哪一行写进 `reports/iter<N>-反哺点-<日期>.md`，由文档批执行 ④阶段变更改 stage.txt ⑤批末闸序列**按本批改动域**全绿留痕（回执 commit 对齐分支尖）。
|
||
|
||
## 维护纪律
|
||
|
||
同「批次 loop 规范」第 8 条五步登记；本文件由里程碑移动与「当前位」换代触发更新（批次开工不强制改本文件，待办明细改 06）。「当前位」限三行，装不下的细节进 06 条目与 git 提交信息。
|