Commit Graph
224 Commits
Author SHA1 Message Date
DKChan bbd49abfb0 docs(术语): 设计文档术语刷新批全量入库——2026-10-18 用户裁定(金币/插旗/旗/雷格/惩罚格 五词)design/+tools/ 域落文
- 术语表 v1.13:GP 唯一正式命名(删「局内金币」别名)+旗/控制词条更名封印/控制+封印定性由「插旗的对外表达」更正为正式动作名(全库统一、非比喻)+禁用字面从对外命名扩为全库+删「机制文档内部用语不受限」条款+退役词对照表补三行(金币→GP/插旗→封印/旗→封印印记)+危险格词条「被旗控制」→「被封印控制」+B3 豁免例举去旗
- 机检扩容 tools/doc_term_audit.py:RETIRED_TERMS 新增 金币→GP、插旗|标旗→封印 两行(DEFAULT_DIRS 不变,game/ 扫描归代码批);拔旗|撤旗行继任措辞随批换代(插旗不可逆→封印不可逆)
- GDD 全域正文换代约 200 行/31 文件:金币→GP(金币袋→GP 袋)、插旗/标旗→封印、雷格/惩罚格→危险格(2026-10-11 退役批存量补扫)、旗概念→封印印记(旗判定→封印判定/标中旗→封印标中/标错旗→标错封印/旗格→封印格/旗位→封印位等复合词系);00-游戏概念「封印降级为类型风味词」定性翻转;修订记录/版本历史/禁令引举/更名记载等留档行零动
- registry/entities.yaml(信标网络可达性/事件序/回执驱动三处)+art 五件(art-bible 封印印记六处/comfyui 背旗→背负封印印记/两清单)+dev 七件(architecture 旗集→封印集/code-conventions-cases/test-conventions/架构图 html json 四件)随批换代
- tools 四脚本注释与图内标注换代(clear_dominance_audit/render_sample_sheet×2/analyze_playtest;代码标识符零动归代码批)
- design/qa/代码术语审计报告-2026-10-18.md 随批入库(本批参考素材,06:578 引用闭合 doc_link 死链)
- 06-待办清单/术语表两在途脏件(代码术语批 06 登记+A 表头「不用→禁用」)随批一并入库

自检:doc_term_audit --strict 零疑似现行(45 文件 434 命中全留档类);文档域六闸验收通过无新增红(gdd_lint R3 对 00 正文修订注记一次打回已去注记化改写;doc_link 死链经报告入库闭合);正文残留仅 06:73「拔旗」一处(件派生动词白名单豁免语境、机检同款豁免,设计意图记录不动)
2026-10-18 06:15:38 +08:00
DKChan 34f3cdb36d docs(iter30-fb): 迭代 30 卡① 文档批——代拍板七项追认+反哺点七条回写
用户令「追认没有问题;反哺点可以都进行回写」两项一波走完(文档批,
不占迭代号,分支 iter30-fb-20261017,基于 master 0a164958)。

追认:
- reports/iter30-代拍板追认单-2026-10-17.md 文末加追认结果行——§9
  白名单 7 项全部同意。

反哺点七条全部回写:
- 06-待办清单:徽章条状态待办→已完成(入库 7ffd1dc0、冒烟 1151/0、
  单测 34 套、探针 case⑰、07 ㉘ 人闸五项);色相措辞修正为「样张
  v2 冻结既裁值,本批只动明度」;2026-10-05 实查读数刷新
  (bonus_pick_overlay.gd 已改名 curio_pick_overlay.gd:97、TG_* 五族
  在役 ui_kit.gd:49-53、裸 Color8 读数作废);新增「卡顶色带与格面
  微光两带统一」待办条(Q3 甲案)。
- HUD框架:实装状态行转「已实装(迭代 30 卡① 2026-10-17 入库,
  合并 7ffd1dc0)」;验收行转正式验收;版本历史 v0.19;口径史注记
  后补两带分工注记(卡顶带=条目级静态色带/格面微光=棋盘格内动态
  微光,禁互为引用)。
- 08-Alpha版本标准:「五 · 表现」表新增「未开格类型微光(五组色相+
  明度档)」行(在役;明度档 provisional 值,样张批复核转正);
  版本历史 v1.9;文头状态行 v1.8→v1.9。
- art-bible:五组明度档 provisional 值(芥末黄 #F7DF43/黄绿 #68D042/
  青 #30A6A6/紫罗兰 #7B5BD6/绯红 #A61D37=冻结 #FF2D55 的 V=0.65
  档,五组 ΔH ≤0.13° 色相零移动)+生成口径(渲染合成空间伽马阶梯、
  相邻组模型 CR 1.245/1.234/1.239/1.270、判据线 1.20、实测最弱对
  1.232、群伤暗档停机呈报留痕)落版本历史 v3.15;§4.2/§4.6.3 权威面
  零改动、§2.1 未追加(Q5 甲案静态);头注「现行为」v3.11→v3.15
  漏更订正。
- roadmap:迭代进度行、近期主战场行与迭代 30 表行状态列同步卡①已
  入库(②③待 /iter 发令)。
- 07-体验验证清单:新增 ㉘ 节五项人闸(五组一眼可分/不遮数字
  〔环不外溢〕/出圈灭入圈复亮/整屏不脏/群伤暗档 #A61D37 观感
  〔provisional,读数归样张批〕);版本历史 v1.5。
- reports/iter30-反哺点-2026-10-17.md 加「回写结果」节逐条标已回写。
- active.md:快照「更新于」行追加文档批从句;未决面待用户追认行补
  iter30 七项已同意;追加状态记录 511。

验收:文档域闸 tools/run_all_gates.sh --docs 五闸(06 gdd_lint/07
doc_link/08 doc_term/08b active.md 体量/10 熵增)全绿,闸况与
基线一致无新增红,回执 commit=分支尖。

遗留:卡②③待 /iter 发令;07 ㉘ 实机目检五项待用户过目;群伤暗档
provisional 待样张批转正;g-plan2-iter30-fb 工作区待合回后清理。
2026-10-17 17:40:29 +08:00
DKChan 9846a29f4c fix(呈现): 主菜单副标题「扫雷的因 · 逐行兑现的果」整个删除(2026-10-16 用户令——无意义标语,玩家可见面禁扫雷字眼)
- ui_assembler.gd: 副标题 label 两行删除(标题与分隔线之间;局部变量无外部依赖,VBox 回流)
- shot_probe.gd: menu_sub 文字锚/自检腿退役(menu_title 保留)+ 菜单段头部历史注记换代
- shot_checker.py: 菜单·副标题 box/presence 两断言腿同撤(_meta 记录端随 pair 列表自断),不重锚
- golden: menu_boot.png 基线换代——触发原因=副标题件删除画面少一行字(呈现类批内换代,Q6 口径;提交说明强制成因即本条)
- 文档四面同步: 01-核心循环 节标题改「一场战斗的流程」(口号句无承载价值,正文已释流程);HUD框架 双舞台段删口号句保留因果论点并句;教学引导 P0 最小集合候选删「归因提示」项;07 ㉗ 目检判据删副标题字样
- 验证: shot_probe 问题=0;render_gate 全绿(shot_checker PASS / 棋盘三屏 golden OK / 菜单 golden changed=0.00% / 残留 Godot=0);改动面 7 文件(含基线 PNG)
2026-10-16 04:33:17 +08:00
DKChan f1663ef935 docs(同步): 贫矿脉屏蔽的机械面四件——07 ⑪ 转记/架构行数/数据配置清单/06 条目
- 07 ⑪:加「✅ 转记(2026-10-16 用户令屏蔽——前提失效,无需验)」注记,六项判据
  全部失效,重建设计立项时随新卡重立目检项
- architecture.md:96 variation 定义行:现行 7 行 → 6 行(global 型机制代码保留)
- 数据配置.md:61 变异表行:现行七行 → 六行(删行注记)
- 06 战斗节点地图类型差异化条:「已实装的部分」改写为贫矿脉已屏蔽删行、剩余面不变
- 设计语义面(地形变异.md §全局作用域型/HUD 框架三层预告/教学引导手册行/难度曲线
  两行/art-bible §4.6.3 括注)按「设计权威文档不随批直改」立反哺点,待用户裁决另批
2026-10-16 03:11:55 +08:00
DKChan 86169065af docs(用语): A 表全量词面换代批(2026-10-16 用户令第一步)——design 四域 36 文件机械替换约 371 处:随批→顺带 123、收口→完成 114、落文→写入文档 76、不得→禁止 53、台账→状态记录 35、对拍→逐项比对 12、销号/销账→注销 12、在飞→正在执行中 3、不报错→不返回错误 1;豁免面零触碰——版本历史既有行、对照性替换记载句(「X」→「Y」)、术语表与 doc-conventions 条文自身、engine-reference 留档区、美术审计会话存档、buff/debuff 代码标识符、「不得不」惯用语;难度曲线与Boss「随批次扩展」改「随后续批次扩展」避词面误中;三闸全绿(gdd_lint 0 不通过/doc_link 死链 0/doc_term 疑似现行 0 含 --strict 复核);闸门升级(--strict 入钩子+豁免基线清单)按用户令留待后续讨论 2026-10-16 02:17:00 +08:00
DKChan bfa44b138e docs: ADR 清除批补漏两处——①.github/workflows/tests.yml 6 处 ADR-0004 引用(原批 --include 过滤遗漏 .yml 扩展名;该文件存废归迭代 29 CI 批,本次只清 ADR 关联);②冒险结构.md:187 的 ADR-0007 裁丙复活(并行会话 4d3f8d66 合并冲突解法倒回未清除版,重新清除) 2026-10-16 01:23:26 +08:00
DKChan 4d3f8d6653 merge: master 二次吸收(ADR 体系废除批+布局闸入库)
# Conflicts:
#	design/gdd/02-系统清单.md
#	design/gdd/systems/冒险循环/冒险结构.md
#	design/gdd/systems/表现与支撑/数据配置.md
#	design/gdd/ux/battle.md
2026-10-16 00:08:01 +08:00
DKChan 6c2dbc37c1 docs: ADR 体系废除 + architecture.md 确立为架构唯一事实源(2026-10-15 用户令:决策记录归 git commit log,不另存决策文档)
- 删除 design/dev/architecture/adr-0001~0007 共 7 份文件(内容留 git 历史可查)
- architecture.md:删「ADR 审计」「ADR 立项清单」两节;清除全文 ADR-000X 注记、QQ 表/S 表 ADR 引用;未决表关闭已落定项(QQ-01/02/03),立项清单在途事项转登记 QQ-11~14;补 A1 生成姿态事实、autoload 四件清单、board_generator 性能姿态;文档状态立「事实源地位」条
- CLAUDE.md:恢复 RNG 单点硬性红线(去 ADR-0007 引用);新增「架构事实唯一源」红线;规范导航架构行标注唯一事实源
- doc-conventions:§5 增「架构事实唯一源」行;§11 活文档清单补架构文档
- registry:architecture.yaml 删 18 处 adr 字段、autoload_set 补 SaveManager/MetaProgression、board_rending 更新为 Node2D 已落地事实;entities.yaml 12 处引用清除
- game/ 代码注释约 60 处清 ADR-000X 引用(事实与日期保留);豁免标记 ADR-0007-exempt → rng-seed-exempt(main.gd/static_scan.sh/architecture.md/06/iter27 五处同步)
- GDD/qa 实现报告/research 卡片/roadmap/tests README 引用全清;死链校验 1206 链接 0 死链、gdd_lint 0 不通过
- 代码中 adr/adr5 等为 adventure_runner 既有局部变量名(非 ADR 引用),未动
2026-10-15 23:52:30 +08:00
DKChan c963004236 merge: master 吸收(收口机制批+闸收敛批二+10-15 文档落库)——冲突五件解毕:术语表/02/数据配置取本批超集(用语规范节/同源两行/死链史实版),元进度 v1.12 与天赋树 v0.5 取主区侧(更名记载显示文字保真),doc_term_audit 语境豁免并集(主区六组+本批 buff 组) 2026-10-15 23:32:01 +08:00
DKChan 07382a4e70 docs(gdd): 用语规范批 W4——06 在办现役条目词面 32 处(随批 11/落文 8/收口 5/不得 3/台账 2/销号 1/对拍 1/语序适配 1),已办结与裁决记载 87 处按豁免保留并逐条分类;战斗表现/敌人系统台账引路 3 处换代状态记录(终扫)。06 无版本历史节不新增 2026-10-15 23:28:10 +08:00
DKChan 83c88c4566 docs(gdd): 用语规范批 W3——表现与支撑 16 处+ux 55 处词面换代(收口 19/台账 17/随批 11/不得 12/buff 1 等按 A 表)+死链终清(config_fatal_probe 迭代19退役去向双证并入数据配置 v0.4 行注)+camp 文头 v1.5/level-clear Last Updated 失同步补齐。伏击者留痕与验收口径子串误报按豁免保留 2026-10-15 23:11:18 +08:00
DKChan 59fdb15567 docs(gdd): 用语规范批 W2——systems 十九篇词面换代 74 处(收口 21/不得 13/报错 7/若干 8/对拍 3/在飞 1/落文 2/随批 2 等按 A 表与语境义改写)+死链修复 2 处(武器锻造→锻造工坊漏改指路)+锻造工坊文头 v0.7→v0.8 失同步补齐;doc_term_audit 增设随批/台账专项补扫通道(白名单自豁免词的版本历史节外可见性)。秘宝充能 2 处与对照性收口 3 处按豁免保留 2026-10-15 22:45:56 +08:00
DKChan 1d4ac91e3b feat(闸收敛批): 验收闸唯一入口 run_all_gates.sh + 合回闸回执强制 + t17 探针隔离修复 + 文档闸清单单一事实源
用户令「迭代完成前必须全量跑一遍所有测试」。起因是 iter27 台账只记 probe --click 未记
--full,t17_defer_probe 红了整个迭代无人发现——根因是闸清单散落 CLAUDE.md /
process-conventions.md / test-conventions.md 三处、彼此不一致、且无任何机器校验。

- tools/run_all_gates.sh(新):全部验证闸的唯一入口与唯一清单,串跑冒烟/单元/探针
  --click/--full/渲染/doc 三闸/静态扫描/熵增闸共十道,写回执 game/tests/.gates/receipt.json。
  与 baseline.json 比对判定:基线红且红项清单未变=存量红零新增(不判失败),
  基线绿转红或红项清单变化=新增红(判红)。python 解释器自动解析带 PIL 的解释器
  并前置 PATH(渲染闸三个脚本依赖 PIL,用错解释器会假红)。
- .zcode/hooks/worktree-guard.sh:Bash 分支加合回闸——merge/rebase/cherry-pick 进
  master 前按目标分支反查 worktree 回执,校验 commit 匹配/非 quick/无新增红三态,
  任一不满足 exit 2 拦截(九态实测:匹配放行、commit 错/quick/含红/无回执/rebase 全拦)。
- game/smoke/t17_defer_probe.gd:隔离面从 main.save_manager = iso_c 改
  ProbeUiUtil.isolate_save(iter27 已确立口径)。原写法对 getter-only 属性赋值无效
  ——组合根 save_manager/meta 是 autoload 读视图,隔离必须落在单例上。修复后 --full 转绿。
- doc_link 三处死链归零:数据配置.md 已退役探针指路、元进度.md/天赋树.md 已改名文档链接。
- CLAUDE.md / process-conventions.md §3第10条 / test-conventions.md §4 三处
  「交付前跑什么」统一为一句话=跑 run_all_gates.sh,删散落清单。

闸况:冒烟 0 / 单元 0 / --click 0 / --full 0 / 渲染 0 / doc_link 0 / doc_term 0 /
熵增 0;gdd_lint 与 static_scan 为存量红,已落 baseline.json 待判读清偿。
2026-10-15 21:16:38 +08:00
DKChan 4fba0d036e docs(qa收尾): 实现报告未处理项清零——14 条反哺落文+29 项追认+孤儿 7 项补登+人闸核销+14 份报告退役
用户四裁(2026-10-14):反哺点 14 条全部按呈报落文 / 追认单 29 项全部追认通过 /
孤儿遗留 7 项全部补登 06 / 实机目检已全部完成(回报未呈报问题)。

反哺落文 14 条:
- iter24 五条 → 敌人系统.md v0.18(敌表 attack_type 字段行+矩阵消费面双向在役/
  技能错峰两轨/敌种表两行池构成/hobgoblin 缺口登记)+ 难度曲线与Boss.md v0.29
  (N1/N2/N3 只测不判读数登记,数值终值归 M4)
- iter25 三条 → art-bible.md v3.14 §7.6(二) 原生控件组件规格 + 06「UI 元素细节修」
  条①措辞订正(「同一个深棕色」不符代码面,实为 2.84:1)+ §7.6 末注主题色值双源
- iter26 四条 → art-bible.md v3.14(§7.6(一) 按钮五态矩阵 / §4.1 三 token 语义岗
  登记+色板 42→45 / §7.6(三) 氛围层两派并存留样张批 / §8.2 Nearest+LINEAR 豁免清单)

追认单 29 项全追认(iter24 §四 8 含 #6 敌方克制消费补行=验收闸强制最小补点 /
iter25 §四 8 / iter26 §四 13),三报告追认单节已标注;iter20/21 按前序既有裁决
记录补齐簿记标注(十条/十二条前序已裁)。

孤儿七项补登 06 专条「qa/ 实现报告收尾·孤儿遗留七项」(design/diagrams 越界/
开场行后缀认加算区/STONE 外溢位/迷雾三关扩对/字面量墨收测前置/TG_* 装饰带判据/
数据配置 223+商店房截图纳屏)。

人闸核销:07 ⑮真人半+⑳㉑㉒㉓㉔㉕ 七节加核销注记(版本行升 v1.0)+iter20 五件
与 V20+iter19 存活八项+迭代18 清单 18 项(卡④ 提灯三项与卡③ 盯梢项标过期失效)。

报告退役:qa/ 下 14 份迭代实现报告删除(iter19 七份+iter20/21/24/25/26 本批+
iter22/23 前会话已删件经用户确认一并清出)——清理口径三条件(反哺全落文+追认全
通过+无报告自身未结项;07「不阻塞」人闸不计入)全部满足;保留 ui-audit 目录/
ui-audit-vs-demo/迭代18 清单(非实现报告)。06 五处指向已删报告的链接改
「已退役,git 历史可考」措辞。

闸:doc 三闸对基线零新增(gdd_lint FAIL=06/07/术语表基线三件;doc_link 死链=
存量 2;term 命中=存量 3)。git 历史可恢复全部已删报告。
2026-10-15 00:24:31 +08:00
DKChan 6e1b52a450 feat(R1机制位): requires_level等级阈值前置随批重立——用户推翻迭代21追认单#1裁撤案(裁「b)推翻,补机制位小批」)=schema字段Dictionary{node_id:n}+validate悬空/阈值<1/类型错加载即拒+tree_can_buy判定分支+行板门槛呈现(未达标🔒+悬停gate_text)+新单测tree_requires_level_test八断言(run_all 24→25套;首跑抓出测试自身时序bug:零配置行断言跑在cap满状态后,重排修正)+现役12行零配置空转零行为影响(冒烟938/0+probe --click/--full+render_gate全绿零漂移;MC豁免=零数值零行为变化)+天赋树v0.10六处R1表述换代+iter21报告§四#1推翻标注与§八兑现注——doc三闸对基线零新增+熵增PASS 2026-10-13 06:13:10 +08:00
DKChan c767174ca4 docs(反哺落文): 迭代21 GDD反哺六条全落文(用户裁「按你的来回写」)=天赋树v0.9(①实装落地态七处换代:状态行/范围表/总表前言三行/schema连带/依赖表/P0段/验收实态注+③设计避让句按卡片v1.7⑪②裁决改写为折扣定义边界gp_cost_mult+⑥机检读数与命中线契约6括注+已建未接面两接一维持)/元进度v1.20(②营地统一段落地终态:柜台退役已发生,过渡态终结)/锻造工坊v0.8(④树侧钥匙句:forge_workshop已随iter21在役,「实装归06」死指针终结)/HUD框架v0.17(⑤新增营地四柜台并排小节=登记缺口补齐,视觉终稿归营地视觉批)——doc三闸对基线零新增(死链3逐条存量/term5组一致/lint 3存量同款)+熵增PASS 2026-10-13 05:49:51 +08:00
DKChan c5a09fd90c refactor(改名批): 暂停层/暂停角标→状态面板/状态角标——用户令全量改名(文案4处+标识符全套PauseOverlay→StatusPanel/pause_overlay.gd→status_panel.gd/成员方法族+探针快照键+注释与探针消息86处清零;行为契约四件零动——只读R4/模态遮罩P2甲/输入锁R3/零动效P4甲)+render_gate截图键shot_pause→shot_status同步+文档六面(元进度v1.19/07/生涯/06条/architecture json+html;camp零命中;08-Alpha版本标准untracked禁碰留置)——冒烟938/0+run_all24套+probe --click/--full+render_gate全绿;rg 暂停|pause game/归零 2026-10-13 05:41:59 +08:00
DKChan a865ada91f docs: 迭代23收尾批——追认单九项全追认(报告§四标注)+GDD反哺三条落文(报告§五标注)=锻造工坊v0.7(Q1正文衔接×2+闭集24→31×2+实装边界1实态回填)/元进度v1.18(effective_ac第一层终态句+钥石入口族三写口+待发令句换代)/术语表v1.9(路线id与存档域键名词条)+祝福registry漏项补登(terminology祝福词条旧名锻升退役+石肤近义词占用=06改名小批配套文档面②③)+06两处换代(实装批条收尾段/改名小批条)+active.md(快照换代+482条+并行合并重复479条去重保留forge.tres命名版+主区脏件v0.6续裁行⑤⑥保史随批);doc三闸对基线零新增(lint 3存量同款/死链3逐条一致/term五组一致);零代码零数值零游戏文件 2026-10-13 02:58:31 +08:00
DKChan 8e04807d4a fix(缺陷修批): Y断点随存——attune_refresh_y 入断点快照+续玩优先读断点(堵「用完 Y 退菜单再续玩满血复活」可利用漏洞;旧断点缺键回退参数面=旧档行为零变化)——06「天赋树实装批登记欠账三条」③,2026-10-13 用户令提前单独开修(按正常流程走)
代码两处(adventure_runner.gd):①_snapshot_breakpoint 断点字典扩列 "attune_refresh_y"(refresh_stock/battery_pending 同款六先例,扩列向后兼容);②resume_adventure Y 注入行改 bp.get("attune_refresh_y", params 回退)——花掉不回血,续玩保持已消耗态。

单测:curio_refresh_paid_test 新增⑥段两断言(断点有键=余量随断点还原花1剩2/旧断点缺键=回退参数面整额注入旧档零变化)。

文档三件随批(机械面同步):①存档序列化.md v1.8——断点随件键 attune_refresh_y 登记,v7 域后扩列不升版(v1.6 vision_used 先例同款,SAVE_FORMAT_VERSION 仍 7 无迁移分支);②冒险结构.md v0.21——「冒险断点」节附随件清单扩 Y 刷新池余量(断点字段口径 owner);③06-待办清单——欠账三条专条③✅销号注记+状态行换代(①②维持归 M4,本条转记账条无待裁点)。

批末闸:冒烟 938/0+单测 24 套全绿(含新⑥段)+doc 三闸对基线零新增(死链 3/term 旗与 gdd_lint 3 件 FAIL 均存量——迭代 23 并入后基线,本批三文档零新增旗);零数值零表值改动。
2026-10-13 02:05:17 +08:00
DKChan 3392ea7e2d Merge branch 'master' into iter23-forge-20261012
# Conflicts:
#	design/gdd/systems/表现与支撑/存档序列化.md
2026-10-13 01:34:15 +08:00
DKChan 31e12c8813 docs(迭代23-T7): 总收口——四闸全绿留痕+机械面文档七件+实现报告落档
- 批末重闸全绿:冒烟 938/0+run_all 24 套+probe --click/--full+render_gate golden 0.00%+doc 三闸/熵增对基线零新增;MC 同种子配对 80 局逐位零漂移+锻造满配档方向性补充(30/80 局差)
- 机械面同步:roadmap 迭代 23 行入库态/entities.yaml forge_workshop 回填实态(impl+save_domain+currency)/06 状态+①② v0.6 措势订正/存档序列化 v1.6(forge_routes 落地态+v7 沿革)/07 ㉒ 目检节+版本行/game/README 批次段
- 实现报告=design/qa/iter23-实现报告-2026-10-12.md(代拍板追认单九条+GDD 反哺点三条+残留人闸)
- active.md 快照换代+状态记录 479/480
2026-10-13 01:21:56 +08:00
DKChan f22b2036a0 迭代22裁决落文批: A单十五条裁决收口+B单七条反哺全落文+⑤改自动兑付代码批——追认单(①②③⑥⑦⑧⑨⑩⑪⑫⑬⑭⑮追认/④追认+积点账裁战斗级/⑤推翻改自动兑付)收口; ⑤代码=满charge_n=8自动当轮grant_ap无玩家入口(_on_cell_revealed揭示缓冲点兑付=cell_revealed批先于本格扣费故AP归零恰逢满点先兑再扣轮不结束/授予段积点段迁除/use_attune_convert受理口消解/attune_convert_state改造进度读数口+item_id键/use_treasure的ap_charge_safe死分支与_usable_now死条件删/tres试炼镐desc换代+counter_spend受理闸删)——HUD兑换钮整链退役(ap_bar convert信号+钮/board_zone转发/main接线与_sync_convert_button/_on_convert_pressed)+C区秘宝槽悬停浮窗进度(controller投影note字段/hero_info_panel tooltip拼接/main _refresh_presentations加refresh_slots重查); 单测④段重写自动兑付断言(7格零兑付/第8格AP+1/读数口/未装配反例); B落文=秘宝.md v3.0(目录三表实态三列+试炼镐自动兑付换代+代价轴转化获取行含战斗级重置与兑付时序+解锁条件实录钥石10/25四条件件三计数键+实装批落地前句全换代+退役指针补代码旧行已删)/元进度.md v1.17/camp.md v1.3(柜台呈现细则节+暂停层12行)/存档序列化.md v1.6(vision_used域+断点随件+bonus_aux_carry退役+v6扩列不升版)/行动经济.md v0.12(finish_round_stop转存率参数化)+术语表v1.2(自动兑付/真视使用计数两词条)+07㉑观测点随⑤换代; 报告修正=⑮提交号勘正(master实际T5=73db171,原记7095505系amend前被弃旧提交——merge-base实证)+十五条裁决标注+反哺七条已落文标注; 06收口=状态行换代+裁决小节。冒烟898/0+单测22套+probe_gate --click --full全绿(worktree拷.godot/字体与图标边车/art素材后) 2026-10-12 23:23:01 +08:00
DKChan 6f561642a6 docs(roadmap/06/gdd): 锻造工坊实装批编入迭代 23 + 两处假裁点表述订正(用户 A/C/D 续裁)
B(用户令编入):锻造工坊实装批 → 迭代 23——roadmap 主线序列插入迭代 23 行 + 「当前位置」节进度/主战场两句更新 + M4 数值批行顺延「迭代 24+」并补编入注记;06 实装批条状态行「待办(冻结)」→「已编入迭代 23(开工门=U0 发令)」。

C(用户裁:非裁点):存档域 forge_routes 独立成域(Q6 已预登记存档序列化.md v7 计划行),「排期两批合并评估」语境随树批入库消失——06:119 订正。我此前把 06 的过时表述包装成裁点,错误。

D(用户裁:时序问题不存在):敌方 attack_type 是敌方定义数据(enemy.tres/skills.tres 行级,与敌种名字/血量同批同时读写),「两批排期协商」句删除——锻造工坊.md 实装边界 6 + 06:119 同句订正;本批只按 3b 裁落结构面(矩阵查表现役已支持)。

A(确认口径):未解锁时默认值从锻造工坊配置表取(静态配置常驻持有、解锁只门控交互不门控读取)——v0.6 正文已落此文,版本行补记同日续裁(不升版本)。

附呈未动(归属 06 线):06:163 天赋树条关联句「排期两批合并评估」同源过时(树批已入库),归 06 自改。
2026-10-12 17:16:04 +08:00
DKChan f5215c75f6 docs(gdd): 锻造工坊 v0.6 完备性检查批——现役基线换代+两轴所有权移交+两处无依据表述订正(grilling 用户逐条裁)
三路并行核查(现役代码事实/关联文档/引用一致性)后按用户逐条裁决落文,5 文件:

① 锻造工坊.md v0.6:
- 现役基线换代——meta.tres forge_products 行族已随迭代 21 T5 整体退役(三处退役登记),「改造现役行(吸收)」语义五处订正为「新建行族」;定价「现役参数沿用」改「历史考古参数(20 钥石/150% 公比,meta.tres:82-84 退役批注)、实装投值归 M4」
- 两根类型轴所有权移交(用户裁)——attack_type/armor_type 默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除;选中态写存档域+冒险开始参数面注入(订正原「写 hero.tres」口径——与现役「表运行期只读」纪律 meta_progression.gd:12-13/119 及本文存档域条目双重冲突);默认值与柜台解锁状态解耦(未解锁=无交互入口但配置常驻可读,不存在读不到默认值的窗口)
- 两处无依据表述订正:「与秘宝混合制同构」删除(「同构」非本项目概念;改为平实事实陈述:共享钥石单币+直购/条件解锁成分语义、通道结构不同);「选长枪激活穿刺系专长」删除(现役专长均为跨攻击类型通用件、不按 attack_type 分系,feats.tres 29 行实证)
- 货架坐标订正(CURIO_KINDS 实为 adventure_table.gd:29 schema 常量、feat_ticket 显式豁免 5/6 命中)+ 改名小批执行态回写

② 元进度.md v1.16(用户令:有缺漏即补齐):「跨局注入」节补开局属性四层叠加公式(锻造工坊与天赋树共指本节为事实源而公式缺位)+ 锻造工坊引用 v0.1→v0.6 连带校正。

③ 存档序列化.md v1.5(用户令:新内容现在补、不等实装批):预登记锻造路线域(计划 v7,forge_routes);清偿 forge_levels 残留(JSON 示例/域清单/迁移链 v4→v5 三体系迁移体已删);补登两漏域(代码实证 save_manager.gd:119-139):tree_struct、first_adventure_done。

④ 术语表.md:新增「锻造工坊」节 6 词条。
⑤ entities.yaml:terminology 补 6 词条 + 新建 forge_workshop 系统条目(用户令:术语登记现在做,验收文档不等实现迭代)。

不在本批(只呈报归属,谁的问题谁改):registry ac_up 显示名失同步(改名小批 D 项)、「魔法甲」4 处残留(敌人系统/美术三档)、registry meta_table 条目 forge_products 滞后(元进度线)、天赋树.md 状态行、06 提案条标题、元进度三柜台节属性锻造现役表述、「祝福」registry 条目(奇物/货架线)。
2026-10-12 16:58:58 +08:00
DKChan 5d254f7e11 merge: master 并入分支(并行十八笔——active 清理批/改名批/奇物呈现批;冲突=active 快照与记录块手工融合,469 弃用上游清档口径、收口条顺延 476) 2026-10-12 14:28:50 +08:00
DKChan c8bc193c77 docs(gdd): 锻造工坊 v0.5 定案落文 + C/D 改名小批执行收口(文档跟随面全批)
A. 锻造工坊.md v0.5 定案落文(B 组 15 裁点逐裁 + 同日五点澄清):
- 「待裁决清单」换代为「裁决结果清单(17 裁点全表)」+ 新增「工作间内容清单」两件交付
- 2a 伪裁点消解(统一伤害轴)/ 2b 随 3a 消解 / 3a 魔法护甲统一命名(「魔法甲」笔误不立别名)/ 3b 敌方攻击缺省普通(跨系统汇合点登记)/ 6 满级特效留扩展位本期不实装 / 8a 两区定名+路线行名(长剑锻造等)
- 02-系统清单.md 锻造工坊行版本注、06 实装批条 v0.5 口径、active.md 471/472 登记

B. 玩家向显示名改名小批执行收口(代码侧已由 0c93a71/0144f60 合入 master,本提交=文档跟随面):
- 06 改名小批条状态「已完成」:C 执行路径(worktree rename-blessing-20261012→0c93a71)、D 解阻过程(smoke_all.gd:1199 断言同步)、残留肃清(blessing-residue-sweep-20261012→0144f60)三段登记
- 跟随版本行:地图战斗资源.md v0.23、增益状态.md v0.14、战斗结算.md v0.20、敌人系统.md v0.17
- 现役描述跟随:art-bible §4.6.1/§4.6.2 键名列、07 体验验证清单⑫、地图战斗资源九型字典表+设计意图句、增益状态五处、战斗结算/敌人系统各一处
- active.md:474 状态记录、第二条 472 撞号接续指针、未决面过期项(货架锻升改名)摘除

registry entities.yaml「祝福」条目登记未执行——归锻造工坊实装批术语登记面。零代码零数值改动。
2026-10-12 07:54:46 +08:00
DKChan 73acee05e6 docs(gdd/roadmap): 迭代21需求卡片 v1.7——2026-10-12 完备性审查十一裁落地
卡片:新增契约4补款(开发阶段无视文档层条款、禁为本批增设豁免/例外条款)与契约12(守侧=失误补偿,触发主语=当回合标错动作非在场标错旗,单格最多一次,末轮不返);T3 六键实现口径重写(锋挂点现成不用改/守挂 _flag_miss_seen 闸后走 grant_ap mode:queue 下轮到账/限次复用 adventure_counters+关卡切换清零不升v7/散只覆盖商品购买价改键名 gp_cost_mult/聚乘算落入账前);T0 缩至0.25d(标错机制与 boss_kill_count 消费面两项已预查结案,contingency 作废);T5 生涯三投影整行删;V1/V8/V10/V15/V20/V21 同步;新增 §11 完备性审查裁决表。roadmap:迭代21行 v1.1/29节点/v0.4 → v1.7/33→12节点/v0.8,补开工门=U0。06/02-系统清单/元进度:状态同步,树侧实质内容收敛为纯指路(唯一事实源=天赋树.md)。
2026-10-12 06:18:50 +08:00
DKChan 74215b66ff docs(gdd): 迭代20反哺落文批②③④——关卡大奖励换代+投放读数注记+奇物行换代(2026-10-12 用户逐裁)
- 冒险结构.md v0.20:通关兑付=专长三选一(按档配比加权)+回血——标题/概览/框架表/生命周期图/序列图/验收/结构冻结七处换代;提升池七种表+洗牌抽取段退役移交奇物.md池结构节(案D四级104事实源单点化);本节留结构层(共享池单例/库存=剩余令牌/reward_pick封闭流/MC 316-f/断点余库)
- 难度曲线与Boss.md v0.28:期望值带节新增迭代20投放读数只测不判注记(四级104构成+止步90/10→93/7归因曝光槽;数值零变更)
- 02-系统清单.md v1.24:奇物行状态格换代(29行=27+2/流派机制退役/案D四级104)
- 06反哺点①-④全部销号(⑤归奇物呈现条)+active.md状态记录466
- doc三闸:gdd_lint回基线3失败(全存量);link/term零新增
2026-10-12 03:46:46 +08:00
DKChan 0507f5e4f0 docs(奇物): 迭代20反哺落文批——奇物.md v3.16(追认①裁决齐,2026-10-12 用户令)
- 设计原则落行注记:每第N次/积满触发=N-1预评估落行
- 疼痛记忆「下场战斗」→「下一次攻击」(用户定性笔误)
- 弃图兑换=停手后首攻全额附加不拆分;血税件表补「下一战起生效」+账列细则
- 时沙=下一战首轮AP队列兑付;§1.3判据句与异质性「当前AP」→「时沙挂账」随迁
- 扩签登记换代实装承载记录(6fact+4计数器改道/battle_won+mod_eq补位/rewrite_board除名)
- 专长/资源两节「落地前」过渡句expiry换代(29行+凭证已落表)
- 流派口径澄清随批记录(正文零改动);06反哺点①+追认条状态换代;active.md 465
2026-10-12 02:50:55 +08:00
DKChan 3f1e439fb5 docs(tree): 天赋树Fork一节点双态换代——三天赋=三节点购买解锁双态可切+同调脉9→6全树15→12(2026-10-11 用户裁)
- 用户明裁:开局姿态/危险直觉/财富之道三天赋=三节点、解锁之后切换形态——现役A/B双行结构(迭代12沿袭,'付一次钱得双态开关'裁决未落进节点组织=落文错误已纠正)收编为单行双态
- 节点语义=购买解锁cap1零重复购、解锁默认A态、营地零币切换(互斥由单态承载);fork_sides存档语义不变(组→激活态);tree_buy_fork=购买解锁/tree_toggle_fork=零币切态
- schema=Fork行持a/b双效果键、效果按激活态取值、组词表校验改每组恰一节点
- GDD v0.8 + 06条(33→12/①⑤/头/背景/归属/状态连带+锻造条33→15→12跨行修正)+ 需求卡片 v1.6(契约11红线/T1T2T5T6/V1V2V9V16V17V20V21V22连带)三文同批;R1不变仍开放待裁;编入迭代21不变
2026-10-12 02:21:19 +08:00
DKChan f100fb45d3 docs(tree): 天赋树一线一节点换代——脊柱8→2(生命/命中各一节点×4级)+全树21→15+行门槛平移节点等级(2026-10-11 用户裁)
- 一线一节点:一个内容一个节点、等级在节点内、不拆多节点(用户明裁)——生命淬炼/命中淬炼各收编单节点4级(层=级,原4层×层内3购作废;12级系旧表临时cap机械推算误读已纠正);立契约10红线(脊柱同一内容禁再拆多节点)
- 行门槛不删:节点等级可区分可计数(用户驳'合并破坏统计')——SPINE_ROW_GATE=4公式不变,主语平移=节点第N级需全树总投入≥4×(N−1),row字段随层行退役
- 彩蛋条件随结构换代=生命/命中两节点4级拉满且同调位1/2/3全解锁
- GDD v0.7 + 06天赋树实装批条(33→15/①⑤/头部/背景/归属/状态连带+锻造条跨行33→21→15修正)+ 需求卡片 v1.5(契约10/T1T2T6/V1V2V4V8V16V17V20V21V22连带)三文同批;R1(等级阈值前置形态去留)不变仍开放待裁;编入迭代21不变
2026-10-12 01:17:14 +08:00
DKChan a369a22af7 docs(tree): 天赋树攻防所有权切分落文——脊柱16→8全树29→21+钥匙无前置+彩蛋两线换代+注入公式换代+四柜台呈现对齐(2026-10-11 锻造工坊裁决会话定案交接)
- 脊柱换代:攻击淬炼×4层+护甲淬炼×4层删除,脊柱=生命/命中两线×4层(每根数值轴全游戏单一来源:生命/命中→树脊柱、攻击→武器路线、AC→甲路线,树零攻防来源=红线);SPINE_ROW_GATE=4 规则保留、达成节奏重算注记在册值归数值批
- 锻造工坊钥匙节点前置改无(free、直接可点亮,原等级阈值前置随两线砍除作废);连带开放待裁点 R1=schema「等级阈值前置」新形态去留(现无消费者,推荐裁撤)
- 地脉共鸣换代:条件=生命/命中两线全满(8节点全上限)且同调位1/2/3全解锁、效果=生命/命中两线 flat(攻/护分量摘除,上限3枚不变)
- 叠加公式换代:开局属性=基础值+树生命/命中淬炼flat+锻造路线加值(只按当前选中生效)+局内加算区(命中在账未注入披露不变)
- 营地呈现措辞对齐四柜台并排(树淬炼柜台=树脊柱界面形态、锻造工坊柜台钥匙点亮前=锁定态;机制语义=树营地本体/钥匙模型/图鉴常开不变)
- GDD v0.6 + 06「天赋树实装批」条(33→21/①②③⑤④/头部/背景/归属/状态连带)+ 需求卡片 v1.4(契约9攻防红线、T1/T2/T6换代、V1/V2/V4/V7/V8/V12/V16/V17/V20/V21/V22连带、估时≈7.0-8.0d)三文同批;卡片编入迭代21不变
2026-10-11 23:59:31 +08:00
DKChan 8e78792678 docs(forge): 锻造工坊 A 组定案落文——四柜台承载+生命归树脊柱+攻防所有权切分+钥匙无前置(2026-10-11 用户逐裁)
- 承载节换代:营地四柜台并排(树淬炼/锻造工坊/秘宝匣/奖励格图鉴)、攻防独立、工作间两区并列、滚动条兜底、视觉终稿归 HUD 批;道具工坊退役词清除
- 生命档移除:生命唯一入口=树脊柱生命线,工作间纯攻防(实装边界①同步)
- 攻防所有权切分:攻击唯一入口=武器路线、AC 唯一入口=甲路线,树零攻防来源(红线);注入衔接=当前武器攻击+当前甲 AC,只按当前选中生效
- 树侧钥匙改无前置直接可点亮(原等级阈值前置随两线砍除作废;树侧 29→21 归天赋树会话交接批)
- 2c 结案(D 组核结:魔网织者在素材库表二退役名单,复活作废)+5a 结案(A② 吸收)落 17 裁点表
- 存档域改旧档废弃口径(开发阶段无迁移)
- 06 锻造工坊实装批条①③④与前置/关联换代+秘宝批 T0 核结落文;02 系统清单 v1.23 随迁
- B 组 15 裁点挂起待用户发令
2026-10-11 23:36:10 +08:00
DKChan bafc5567f8 docs(forge): 系统更名批——武器锻造→锻造工坊(2026-10-11 用户令)
- 设计文档改名 锻造工坊.md(v0.3 更名行落版本历史),与树上钥匙节点同名
- 全库现行指路换代:天赋树×5 链接(v0.5 机械随迁行)/元进度指路句(v1.15)/02-系统清单两行(v1.22)/06 实装批条名与归属链接/三张需求卡片/素材库符文重铸行
- 历史记载保留:提案过程稿文件名、playnote 用户原案引文、迭代 18 qa 清单、各版本历史行、06 提案专条(2026-10-06)、旧树节点名(武器锻造/护身锻造/甲胄锻造)
- 区名「武器锻造区/护甲锻造区」暂留,随承载裁决收口另改
- 机制设计零改动
2026-10-11 22:21:16 +08:00
DKChan 081027c579 docs(fix): 文档一致性修复批(定时检查呈报项①②:死链7处+lint三文件清零;纯文档零测试)
①死链修复7处:秘宝.md 10-10目录归位批漏网5处改指 systems/跨局循环/秘宝.md(01-核心循环v1.6行/02-系统清单v1.3行/奇物.md v3.5行〔连反斜杠路径一并改正〕/地形变异.md负责表+依赖表两行)+camp.md树面板行两处补../systems/前缀(天赋树/HUD框架);数据配置.md:221存量挂账维持(iter19基线在册)
②gdd_lint三文件清零:01-核心循环 R10版本历史v1.5同号顺延(10-10分界尺行→v1.7)+R5「生命周期轴(五档)」节补五档嵌套字符画〔报错原文误记「死了之后」系工具prev/cur错位——tools/gdd_lint.py R5报错节名一行修正〕+「死了之后」节顺带补死亡重开环字符画;02-系统清单 R6术语表行多余版本列摘除+R3三行状态格改写现行白话句并换代(天赋树v0.4换代定稿29节点/武器锻造v0.2/奇物27件扩容后)+版本v1.21;03-内容规模 R1超长段拆两段+目录计数换代15→12件(普通7/优秀3/稀有2——回能器删/换装券撤/第四只手删三轮漏网面)+版本v1.3
闸:gdd_lint 9文件2不通过(=06/07基线存量,01/02/03转绿)/doc_link死链2(=06:505 worktree环境假象待主区复验+数据配置221存量)/熵增PASS;版本行01 v1.8/02 v1.21/03 v1.3
2026-10-11 16:14:08 +08:00
DKChan 1163147c4f docs(talent-tree): 天赋树.md v0.4 歧义扫描清零——/grilling 六裁落文+卡片 T3/Q5 对齐+06 注记(2026-10-11 用户逐裁) 2026-10-11 07:56:37 +08:00
DKChan 3e2ae8fd3e docs(treasure): 第四只手删除批——净收益为零的自指件(占一槽换一槽 3=3 且自锁唯一稀有格)+「跨域」概念撤回(2026-10-11 用户推导;秘宝.md v2.9,全目录 13→12 件) 2026-10-11 07:01:03 +08:00
DKChan a934aa2f45 docs(naming): 专长件第一版命名批——九件代号换代+对外命名纪律登记(2026-10-11 用户裁)
- 对外命名纪律:无「雷/插旗」字面;插旗对外=封印、危险格对外风味=地下城陷阱/怪物巢穴;适用件名/显示名/UI 文案/成就百科,机制文档内部用语不受限(术语表新增节 v1.6)
- 奇物.md 九件换代:旗语回响→封印回响/猎旗手→封印匠/铁旗→封印桩/爆芯→陷阱本能/连爆→连环陷阱/爆心冲击→陷阱爆发/雷蜜→血蜜/引信标定→破封一击/标中殉爆→封印爆裂;对账锚行随改;版本历史 v3.15;历史行引用旧代号留痕不动
2026-10-11 06:58:28 +08:00
DKChan 0ef6da5641 docs(curio): 实装前置两项裁定落文——Boss主渠道随实装批本批+池结构案D澄清(2026-10-11 用户裁)
- §2.5:Boss 渠道直接给专长已裁随专长实装批本批落地不再分期
- §2.5 池结构选型澄清:正主=案D(v3.3 定夺在案),解耦三案系实装侧自选非用户裁定项——会话误将实装侧自选升级为用户裁定项重问已定夺事项,经历史记录找回(TP0 令牌池天然兼顾核实结论)后澄清
- 06 渠道分工条状态行随批同步;奇物.md v3.14
2026-10-11 06:18:35 +08:00
DKChan aff8576ac9 docs(treasure): 拾取渠道废止批——装配只在冒险开始前配置+冒险中零更换途径(2026-10-11 用户终裁;秘宝.md v2.8+验收装配不可变条) 2026-10-11 06:10:51 +08:00
DKChan 448ab2df70 Revert "docs(reward): 奇物渠道轴补 2.5 未知秘宝兑现物锚点+秘宝拾取段双侧互锚(2026-10-11 用户令「确保奇物中有对应内容保证能够实现」)"
This reverts commit 00ca3b9eac.
2026-10-11 06:03:29 +08:00
DKChan 658c609651 merge master(奇物渠道锚点批 00ca3b9):带入行「机制正主」2 处随批补扫 2026-10-11 05:55:43 +08:00
DKChan 71d6160f18 Merge branch 'master' into glossary-retire-final 2026-10-11 05:55:16 +08:00
DKChan a8bf2d9a45 merge master(秘宝目录修正批+天赋树台账五提交):冲突四处取并行侧+带入行随批补扫(现行正主/内容正主等 6 行)+术语表并号(并行 v1.3 未知秘宝词条/我方让号 v1.4)+active 编号重排 445/446/447 2026-10-11 05:54:57 +08:00
DKChan 00ca3b9eac docs(reward): 奇物渠道轴补 2.5 未知秘宝兑现物锚点+秘宝拾取段双侧互锚(2026-10-11 用户令「确保奇物中有对应内容保证能够实现」) 2026-10-11 05:48:43 +08:00
DKChan ac19754374 docs(glossary): 退役词对照表全库强制清扫——正主→现行事实源130行+落籍→已入库79行(39文件194行,语境微调=权威文档/权威定义节/拼表制主选/入库注记等;对照性文本豁免保留)+五词终验零真残留+术语表v1.3+active 446(2026-10-11 用户令收尾) 2026-10-11 05:46:49 +08:00
DKChan 0ea0fb5494 docs(talent-tree): 天赋树.md v0.3 节点台账补全——台账指引升格文首+29 节点总表落文(2026-10-11 用户令) 2026-10-11 05:34:21 +08:00
DKChan b5232351f8 docs(treasure): 效果轴表头计数补换代(新目录 13 件) 2026-10-11 05:32:33 +08:00
DKChan 9d386bb382 docs(treasure): 目录修正批收尾——元进度秘宝匣行换代+06 计数+术语表未知秘宝词条 2026-10-11 05:31:43 +08:00
DKChan cf04bd6666 docs(treasure): 秘宝目录修正批——回能器删除+换装券撤消+冒险拾取未知秘宝渠道(2026-10-11 用户复核两裁;秘宝.md v2.7,优秀档 5→3 全目录 15→13 件) 2026-10-11 05:31:37 +08:00