Commit Graph
117 Commits
Author SHA1 Message Date
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 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 5f2ef77863 docs(迭代24): 文档同步面五件随批——06三条销号+卡片条收口/08行注摘除v1.2/07㉓三目检/registry三处/Alpha梳理三注订正 2026-10-13 07:30:34 +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 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 9cf977ed07 Merge branch 'master' into iter22-treasure
# Conflicts:
#	roadmap.md
2026-10-12 19:46:54 +08:00
DKChan 44fee05b14 T7(迭代22秘宝批): 文档同步闸——registry三代目换代注记(aux_items迭代22批/attunement_growth表删史注/attunement_slots树点亮+档位格/save域boss_kill_count语义换代+vision_used新域)+06秘宝条已入库状态+07㉑秘宝解锁-装配正常流程观测项+roadmap迭代22行✅+实现报告(代拍板追认单十五条/GDD反哺点七条/实机目检=07㉑/闸读数/余项去向) 2026-10-12 19:45:28 +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 8fd99092db docs(sync): 迭代20 机械面文档随批同步(同步闸 v2)——registry curio/adventure_table 换代注记+roadmap 迭代20 行已入库换代+06 两处销号(秘宝批③拆出/生命比例前置条)+07 目检项五件登记 2026-10-12 00:45:09 +08:00
DKChan be1cf39e97 docs(structure): 秘宝.md 系统目录归位——自排雷循环迁入跨局循环(2026-10-10 用户发现结构问题)
- 生命周期裁定:解锁/装配/存档持久全在跨局侧,排雷循环仅生效现场;成因=前身辅助道具系切片期掉落形态旧置排雷循环,同调换代未随迁
- git mv+文内同目录引用改跨目录路径;全仓反向引用 33 处同步(版本历史/注记行内历史路径按纪律保留)
- 02-系统清单 v1.19:文档树两区换行+系统总表行移区+命名对照表不动(AUXILIARY_ITEMS/a5 不变)
2026-10-10 17:28:38 +08:00
DKChan c79c8e8f34 docs(sweep): 状态记录更名扫尾——仓库旧称残留3文件5处普通引用换代+两处引述豁免保留+active.md 434登记(2026-10-10 用户令)
- entities.yaml:283「双算法销号,工作日志 312」→「状态记录 312」
- design/research/需求卡片-M4数值批-2026-10-05.md:97(两处)+:182 流程记录去处→「状态记录」
- game/data/schemas/enemy_table.gd:137 注释「〔工作日志 312 待裁项〕」→「状态记录 312」(仅注释行零逻辑触碰)
- 引述豁免保留两处:active.md 更名批快照行+doc-conventions §10 定性句(句子本身在记载更名动作,先例在册)
- active.md:快照行+434 条登记;随批入库主区未提交改动=433 条按「状态清除即任务完成证明」新规自清删除
- 范围外呈报不改:.zcode 工具件 5 文件(commitmsg_20261009/补丁脚本×2/tmp 旧卡八份)
- 摸底口径=git grep 含未跟踪件(design/ 全目录+根目录 md+game/ md 与代码注释);EOL/编码逐文件保持,git 历史零触碰
- 用户级技能目录与记忆目录换代在仓外同批执行,不入本提交
- 基点 6da823c;worktree statuslog-sweep 自治提交合入
2026-10-10 16:24:28 +08:00
DKChan 6da823c960 docs(curio): registry 三处现行旧称「魔法道具」修正+06 秘宝实装批补进展注记(2026-10-10 用户令;秘宝体系文档正确性检查通过)
- entities.yaml L603 boundary 两处+L611 referenced_by+L623 字段注:指称系统名旧称改「秘宝」(历史注记行不动)
- 06「秘宝体系实现重构落地批」补注:不依赖武器锻造/天赋树两线(用户裁)+文档检查通过待发令开工+magic_vs_magic 与 27 件名单交叉核对点随批 T0
2026-10-10 15:32:37 +08:00
DKChan 9ae7c60c9c docs(sync): 天赋树裁定跨文档同步——锻造工坊解锁门登记+06重构批条+「道具工坊」改名「秘宝匣」九文件扫改(2026-10-10 用户令)
- A 武器锻造.md v0.2:柜台承载节补树侧解锁门(本柜台前置=树「锻造工坊」免费节点,攻/甲淬炼累计各≥2)
- B 06:新登「天赋树结构重构批」实装待办条(meta_tree 33→31/v4→v5 迁移重做/schema 等级阈值前置/柜台解锁门/秘宝匣改名连带面/地脉共鸣/同调位1)+武器锻造实装批条补关联句
- C 九文件现行正文「道具工坊→秘宝匣」扫改+各记版本行(版本历史行零触碰):元进度 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/ 代码数据表零触碰;design/research 与 design/qa 零触碰
- active.md:快照条+工作日志 431 随批
2026-10-10 06:48:08 +08:00
DKChan bb371cabc3 docs(tree): 天赋树欠账三分流——已建未接面记 06+registry 过期词条换代+camp.md 补树面板(2026-10-09 用户三令)
- 06 新条「天赋树已建未接面两件——设计定案、实现缺失」:同调位 2/3 槽位收编+命中线 flat 注入(设计正主《整合定稿》git 8e02dcf 取证定性质=实现缺失非设计缺口;处置=实装批+数值批,冻结待排期)
- registry entities.yaml「永久强化」词条:「『天赋树』同日退役——本作无树形结构」过期句按最新口径换代(树迭代 12 在役+正主指路+新旧概念划界);L870 批注行系历史留痕不动
- camp.md 补树面板结构位行(图鉴柜台下段程序占位;呈现终稿归 HUD框架;两信号名)——树侧跨文档欠账清偿
- 设计灰色地带(刷新升级节点/树四线×武器锻造叠加关系)不入本批=用户另会话设计讨论,prompt 已交付 chat
- worktree g-plan2-wforge 分支 tree-debt-gdd 基点 e39a4d6;纯文档零测试
2026-10-09 23:36:17 +08:00
DKChan 03c4b4c933 docs: 文档正确性审查批+去毒+命名统一+天赋树成文等十一批落籍(2026-10-09 用户令)
一、里程碑语义立规:M3=Alpha 完整实现/M4=Beta 完整实现,未明令关闭 M3 前只排 M3 需求(roadmap M-4 节头立规注+M-3 节头口径指针+迭代 21+ 行注+06 倍率差条注);迭代 20/21/22 规划冻结(roadmap 迭代 20 行注——先解决眼前问题,重启=用户直接发令)
二、文档正确性审查批三波:全 GDD 29 份过审——状态记录按代码证据订正/里程碑删前缀(M-x+迭代N→迭代N,裸 M-4→Beta 阶段(未排期))/退役词退役件当现役清零/在役旧实现节加隔离横幅;重件=秘宝.md v1.7 老正文深层清算(横幅重写消「过渡形态已退役」误读/沿革节换代/六件旧件登记摘除/验收与 charges 矛盾订正)+奇物 v3.8+冒险结构 v0.18+关卡节点地图 v1.7+图生成 v0.7+难度曲线与Boss v0.26+战斗结算 v0.27+敌人系统 v0.16+地图战斗资源 v0.21+增益状态 v0.13+战斗表现 v0.6+元进度 v1.9+生涯 v0.3+00 v1.3+02 v1.16+03 v1.1+ux 八份(battle 23 处/camp/shop/node-reward/level-clear/interaction-patterns/settlement-summary/level-map)
三、去毒批:奇物 v3.7(魔法道具→秘宝/档名三档→四级/门票与刷新「尚未入表」假话订正/验收第 3 条改令牌口径/资源成员指路凭证件表)+秘宝 v1.6(速览旧目录退役标注/退役件示例换现役)
四、道具退役素材库新建(design/research/道具退役素材库.md,案乙已追认):秘宝退役 9 件含去向+专长退役 27 件名单+待核 4 行;魔法提灯(fog_lantern)裁退役(06 条目已裁+秘宝.md 注记换代+素材库迁表一;拆线归实装批)
五、B2/B3/B4 裁决落文:元进度.md 道具工坊行删旧写新(v1.10——旧六行登记作废、指路秘宝新目录+解锁门槛谓词分级);奇物.md P1「两项合成高阶项」注销(v3.9——用户定性脏信息);§3 刷新句按最新口径换代(刷新券替代、不进持有集)
六、天赋树独立成文(B1 裁决):新建 design/gdd/systems/跨局循环/天赋树.md v0.1(33 节点机制全按 meta_tree.tres 实态+迭代 12 落籍裁决+被删底稿 git 取证——脊柱行门槛/钥石单币/Fork A/B 面/存档 v5 域/注入双通道)+元进度.md 定名节换代(v1.11)+02-系统清单跨局循环区加行(v1.17)
七、A 类卫生包:版本历史表理排四份(秘宝/奇物含 v2.7 断裂行修复/敌人系统/图生成,只调行序)+缺号注记三处(增益状态 v0.6 未考/冒险结构 v0.15/关卡节点地图 v1.6=MC-1 批)+node-reward v2.2 双号改 a/b+07 补建版本历史表+06 删「设置与本地化」空节+「文档/结构闸存量欠账」块挪文末「文档与结构」节+「L1 商店编排」两悬空指针改指 GP 换算失衡条+难度曲线两处过期指向核销注记(v0.27)+B5「现役 UI/文案两处自相冲突」登记 06 待办(battle_narrator.gd:160 旧话/hero_info_panel 两段同标「特性」——随后续迭代修)
八、命名统一(用户令「任务书」全库改「需求卡片」):167 文件约 800 处(design/ 全部文档+roadmap+CLAUDE.md+active.md+entities.yaml+game/ 注释与数据批注);两文件改名(需求卡片-M4数值批/需求卡片-冒险前资源配比预设批);残留=自造短语全量清单(黑话证据文档故意跳过)
九、CLAUDE.md:批次工作流标准清单收口段新增第 12 条「文档同步闸」(需求卡片必列关联文档同步面、合并前同步完毕方算收口,原 12/13 顺延);呈报六问铁规适用范围补立(前序批随批落籍)
十、active.md 快照节+工作日志 414-421(并行会话 416 黑话清扫条目按共享工作日志惯例一并入库);06 中并行会话「active.md 定性与裁剪」条目未提交,按零吞并纪律留在工作区未入库

零测试(文档批两入口铁规);主区前序脏件(.gitignore/.zcode/config.json/playnote/project.godot/.zcodeignore/美术审计报告 html 等)未带
2026-10-09 19:12:46 +08:00
DKChan 8e02dcf05b 清理: design/存量超期批——删86件(dev四组11+qa证据39=只留最新规首跑+research 34)+引用改写17处/15文件+doc-conventions §11新增证据只留最新(v13)+美术审计报告留置呈报(工作日志 413) 2026-10-09 03:58:50 +08:00
DKChan 442cd511a0 修复: design/结构批——diagrams 迁入 dev/architecture(案甲,熵增闸红灯清零)+旧档 GDD 引用全量摘除(31处/29文档+code/schema头注13文件+registry 5行)+doc双工具摘design/ux死路径(工作日志 412) 2026-10-09 03:29:09 +08:00
DKChan 669c1c7d01 ④T1: 存档 v6 生涯终身计数域——SAVE_FORMAT_VERSION 5→6(版本史注释随批换代)+meta 两新域 adventure_total〔总局数,开局即计含放弃与失败〕/adventure_cleared〔通关局数,三关全通才计 1——判定字段 summary.cleared 现成直用〕+迁移函数 _migrate_v5_v6(沿现役迁移链 _init 自注册;旧档缺键 _normalize 按默认补零、只增不改=幂等,v3→v4 先例)+只读访问器 adventure_total()/adventure_cleared()+写入单口=apply_adventure_summary 收束口头部自增(三结局同经本口恰计一次,禁第二写入点——契约 2;迁移链陈旧注释 v1→v3/v1→v6 顺手校正)+域清单 owner 注记(生涯.md)+registry save_file 条目 v4→v6 换代(v5 批漏账补齐)+冒烟随批:硬断言「写盘 version==5」两处改 6(迁移链段+v1 旧档段)+①往返段收束自增恰一/往返相等两断言+②新档段缺省全零断言+⑬新增段(v5 旧档升 v6 缺省补零且既有余额原样/升档幂等写盘再载零漂移/通关局 cleared+1 夹具)——冒烟 821/0(基线 814+7) 2026-10-07 08:35:47 +08:00
DKChan ab5ddad438 T1组A·GDD修订先行(敌人表行集多行批——R2契约:先落文后落码): 敌人系统.md v0.15(开战生成节改行集逐行实例化口径+规则表「每坐标只出一种敌种」改行集构成纪律三条[enemy_id唯一/同坐标多行文件内相邻行序=声明序=生成序/实例总数≤4单种数语义]+敌方效果全体生效前提句去同种假设+调参表头/结构冻结/验收两条同步+版本历史);难度曲线与Boss.md v0.24(混编行集难度归属注记——各行值独立生效叠加零新轴,首投放归内容批+MC先报批+带读数义务);entities.yaml rowset_rule契约换代(含floor版退役登记);06待办清单「同深度第二敌种」条状态改已实施完成(遗留面=内容投放归后续批+unlock_hp_pct无闸面复核义务);轻闸=doc三闸对基线零新增(link死链4存量/lint2存量/term3存量) 2026-10-07 01:56:51 +08:00
DKChan 6e7b5d17e9 文档正主换代+出口报告落档(T7——内容数据驱动扩展批收口)
- 奇物.md v2.8:专长效果声明换代(挂点→订阅行五处)+feats.tres 行结构字段表换代+版本行。
- 秘宝.md v1.0:效果声明形态节(被动六件订阅行/掘进蓄能受理闸数据化/desc 文案表值化)+版本行。
- 敌人系统.md v0.14:半血解锁判定点=通用事件 enemy_hp_threshold 发射点登记(非 Boss 专属——
  Boss 语义留给订阅条件判定;本批零订阅者零行为变化,R6 框架先行登记面)+版本行。
- registry/entities.yaml:专长 data_sources 换代+effect_declaration 新条(四词表封闭/组合规则六族/
  遍历序写死/每战重建时机——效果行为唯一事实源登记)。
- registry/architecture.yaml:core_decisions 新条 effect_engine_interpreter(ADR-0011 候选——
  发布订阅解释器立场+禁拦截器链边界)。
- 06-待办清单:数据驱动批状态=已实施完成收口(五提交号+闸读数+遗留两项+出口报告指路)。
- roadmap:迭代 17 卡⓪行换代(状态=已实施完成待合并)。
- active.md:快照节追加台账 381(预配号——379/380 留并行在飞三线)。
- 出口报告:design/qa/iter17-datadrive-exit-report-2026-10-06.md(各卡提交号含前任两条/六闸读数/
  MC 锚名与对拍结论/代拍板八项/遗留人闸两项+实机目检/基线既有闸项声明)。

闸读数终态:冒烟 800 项 0 失败(三闸过)· 单元 17 套全绿 · 探针闸含 click 全绿 · MC 二档对拍
40 局同种子逐位一致(off L1 4/20、formed L1 16/20 与改前逐位同值——契约两套判据全过)·
doc 三闸与熵增闸零新增(gdd_lint 2 处与 design/diagrams 越界均 stash 对比实证为基线既有)。

任务书:design/research/任务书-内容数据驱动扩展批-2026-10-06.md §六 T7。
2026-10-07 00:13:51 +08:00
DKChan ffb0e36bcd docs: 另账修正批——悬空指路句13处+architecture旧API三处+06登记MC重锚(用户令『文档修改现在就修正』)——①docs/proposal-*两提案悬空引用13处(敌人系统4/战斗结算2/增益状态1/registry2/README2/unit_container/enemy_table/skill_table/smoke_all注释4处)改指路句〔提案已吸收退役git a6833b6a——事实源=敌人系统.md〕,系7f24b640三层收敛搬迁+a6833b6a死亡清单批漏改的登记遗留(7f24b640提交信息『余7条全为搬前幽灵链』);②architecture.md活契约面三处旧API换代——:190调用序query_attack→apply_damage→advance改按摇定技能行兑现→apply_damage→commit_action+案C段内序、:152图示行stock/advance退役改伤害单据submit、:176 clear_inventory随库存轴下线退役改通关结算指路(:105/:222/:252系历史记录/已自带注记不动);③06-待办清单新登记『旧行为MC行为锚全数作废——重锚归数值批』(用户确认系影响数值难度重要变量;归属M-4);gdd_lint对基线零新增(8文件2存量) 2026-10-06 09:43:37 +08:00
DKChan 58dfb56272 fix(battle): 地图伤害账殿后批(案C 2026-10-06 用户裁——「主角先手攻击一次」歧义质询触发)——①结算顺序定死=①授予段兑非伤害账(资源/增益/治疗/行动点/GP/警觉,伤害形态单据暂存不兑)→③战斗段「主角先基础攻击→敌人按生成序逐个还手→地图伤害账殿后」→④衰减→⑤判定;②切片=battle_orchestrator 暂存闸 _defer_board_damage/_deferred_board+_submit 案C分流(sync同闸——清图批一致延后)+_outcome_of(暂存单按「将兑付」回报——完美第二份依据开单时点事实)+授予段四处直提改走闸+战斗段末补提交块(主角死于怪物→暂存单整体不兑逐单留「未生效(主角已倒下)」行 forfeit=hero_down);③文档=战斗结算 v0.26(五段表①③行/授予段节/兑付形态表/结账时机双模式/战斗段节/P0闭环/三分量遗留顺手清+三处普通分量改基础分量)+敌人系统(P0第4步战斗段限定+地图账+死亡来源改述)+地图战斗资源(流程图/负向恒即时节/五步清单)+01-核心循环(「怪物的先手」用词相撞改警觉)+README案C批节+registry两处案C注记+编排器头部注释;④测试=行相位分类器换代(damage恒战斗段/reward_ineffective按forfeit分流)+先手断言收紧(存在或授予段终局→必存在)+新增案C段内序断言(地图账不得先于先手或插入敌方还手中间)——冒烟783/0三闸过+run_all 17套全绿+probe_gate --click全绿+gdd_lint与基线一致;⑤旧行为MC锚全数作废(授予段伤害致死短路先手语义消失),重锚归数值批 2026-10-06 09:14:59 +08:00
DKChan ccd95c8215 奇物批T6b+T7+缺陷修:refresh入池(用户裁B案——CURIO_KINDS扩第七类/heal_rare 5→3挤占refresh_rare=2/总量98锚不变/match表两行/兑付=_attune_refresh_x增量不进加算区+registry pool_architecture多级缓存总池-渠道子集语义+契约10按裁更新);T7 charge缺陷登记(3件<4档二不可达——白名单4只登记不硬补,registry charge_defect);autoplay门票拿到即开分支(缺分支=节点停点悬空选路卡死——MC timeout形态批内实测,n20复现1/2空终局修后与基线逐位一致);任务书T6b裁决回写(冒烟782/0) 2026-10-05 20:58:34 +08:00
DKChan 95b66f0d60 奇物批T5+T6a:专长门票入表(schema四字段provisional 20%/2/1/5+域校验+runner保底/限购/出现三计数+节点与商店双注入(替换末位占一席,同scope取数零漂移)+拿到即开三入口分支(节点本地重绘/店内临时停点payload.context)+断点扩列两键向后兼容+shop.tres门票行base5+SHELF_KINDS扩+校验豁免+A5/A6断言7条);T6a商店补回复heal行(默认原则:分类内成员都入该渠道池)+registry刷新边界写死(商店自身服务vs奇物授予重抽次数);终局池读数断言4→6键适配(冒烟782/0) 2026-10-05 20:03:20 +08:00
DKChan 6812ebbb73 奇物批T3+T4:relic_*→feat_*词族全换(feat_table.gd/feats.tres/feats_engine.gd三文件改名+.uid+feat_flags/feat_id/feat_row等全token+config_db注册键feats两端+entities.yaml换代注记——kind值relic/身份前缀relic:/relics存档键/摘要键按数据契约保留);T4渠道白名单过滤(_draw_curio_candidates(channel):通关渠道只出专长/节点渠道零专长——过滤式不拆池,TIER_QUOTAS锚零改动,devour货架保底随渠道定位退役,迁移保feat_id,pick_curio测试feat_id透传;冒烟773/0+run_all 16全绿+断点往返PASS) 2026-10-05 19:28:20 +08:00
DKChan d4cde73976 奇物批T1:feature_*→curio_*词族换名(CURIO_KINDS/curio_quota/curio_value/curio_candidate_count+adventure.tres键名+entities.yaml换代登记续写,值零变更实测;T0差异回写:93处/7文件+bonus_aux_carry语义澄清剔除改名面+基线772/0) 2026-10-05 18:30:44 +08:00
DKChan 97b8589a4c 技能池执行批T0-T6+⑤提灯(迭代14④+⑤):T0表盘点零漂移(19行池+9技能行+Boss三行对照报告§2);T1敌人系统.md v0.13五件(池构成表8敌种/护甲列读表口径/三代错峰/半血解锁弹出规格);T2 skills有效倍率表批注(D4整数基线半点矩阵)+enemy EV锚整数口径重登记+巨蜘蛛1.11消歧+registry enemy/skill换代;T3-T4机制件=unlock_hp_pct可选键(schema域校验缺省无=无门槛)+容器check_skill_unlocks单向闩(零随机)+rollable/special双面过滤(保底不逼锁定)+编排归因行「XX解锁了YY」(type=highlight高光键skill_unlock零行型新增)+row_pacer一次性技能名toast(排除perfect_sweep误触);T5三Boss解锁技落表(震地怒击×2.5/CD4·遏毒×2.0/CD3·岩崩×2.5/CD4案甲provisional+池尾weight2/unlock50)+断言基线换代3处(技能表12行/池模板/酋长EV锚重锚1.10-1.30实测1.1948);T6单测skill_unlock_test22断言(run_all注册15套)+smoke+5集成(半血→次轮解锁行恰一次/文本/行型零新增);⑤提灯+2接线=board_view.set_fog_lantern公共面+case⑮接线断言+HUD框架注记(载体道具归信息件批=接缝就绪态);T7读数后置挂07;闸=冒烟772/0+run_all15套+探针绿+doc三闸零新增;出口报告design/qa/m4iter14-skillpool-exit-report-2026-10-05.md 2026-10-05 09:26:25 +08:00
DKChan 74678d80bc Merge branch 'master' into m4iter14-narrow-20261005 2026-10-05 08:36:32 +08:00
DKChan e1beb2555a 初始展开收窄批T5/T7/T8(迭代14①):改后结构读数(calibrate 200板/行:R₀均值39.7/37.9/42.8/46.6——10×10收窄42%自68.6、12×12收窄54%自83.2;尾部被闸精确截断r0_max==cap全行;雷密度19.2-21.6%<25%相变线;闸触发22%/42%/42%/24%全<S1线;inf 0.939/0.881/0.929/0.921全达标)+registry initial_expansion_narrowing条(S1方案A裁定+改前锚只测不判声明)+棋盘生成.md v0.5(反退化规则表换代+R₀≤cap行+调参表两行+验收两条)+07⑬四信号组观察项;06视野条目已于745b92ea清账批退役(收窄立项即正主)——T7的06收口面空记入台账 2026-10-05 08:36:27 +08:00
DKChan cf799b32a3 退役批:12份已完成中间文档删除(用户令2026-10-05)——git rm 五任务书(视野迷雾/GP商店房重构/魔法道具同调/双层BD/美术圣经v3.5)+全局作用域变异任务书+挖掘风险不等式方案+ux-review+perfect-l1+三提案(秘宝底稿/A3奖励格差异/playnote机制);指路句改写13文件全数git留痕(roadmap六处/06/行动经济/entities三处/art-bible三处/地形变异改指调研§7/秘宝两处改指57da58c/冒险结构/关卡节点地图/元进度/clear_dominance_audit)+reward_expectation旧基准注释核正(七型79→九型77按reward.tres实证)+死亡清单四行勾销+执行注记⑤;死链闸6=基线同款零新增;秘宝提案八拍板/A3否决/playnote题二均git号留痕(57da58c/a404a65/12e934b) 2026-10-05 08:07:28 +08:00
DKChan c571af226f merge: 奇物概念收口与词族对齐(迭代15②号卡·文档与数据层)
概念层由用户逐轮裁定定稿(《奇物》v1.0→v2.7),本批只做落地对齐。

主要内容:
- 新建 design/gdd/systems/冒险循环/奇物.md v2.7(本概念唯一定义文档)
- 新建 design/research/任务书-奇物词族对齐与渠道分离批-2026-10-05.md
  (loop engineering 八件成文 + 12 条批末验收断言 + 11 条设计契约含 6 条停机级)
- 代码词族对齐:feature_* → FEATURE_KINDS/feature_quota_*/feature_value_*
  (adventure_table.gd 24 字段 + 方法 + 常量,adventure.tres 21 键,值零变更)
- 三个 schema 补概念指路注释;relic_table.gd / adventure_table.gd 概念注释指向奇物.md
- ux/battle.md、level-map.md、HUD框架.md、06-待办清单.md、02-系统清单.md、
  registry/entities.yaml 同步称谓与元信息

六处冲突解法:
- 02-系统清单.md:版本历史整段重编(master v0.1-v1.3 原号复原,奇物系列从 v1.4 起)
- ux/battle.md:取分支侧新称谓,但「魔法道具槽」须写「秘宝槽」(master v1.3 已更名)
- adventure_table.gd:合成并集(取本批改名 + 保留 master SR-1 商店刷新三字段)
- level_map_screen.gd:块1 取 master M5 底栏结构,块2 取本批配色与称谓
- registry/entities.yaml:7 处三方混战,块1-5/7 取 master,块6 取本批
- roadmap.md:迭代 15 两卡并存(①调试 已落籍 / ②奇物 待开工)

合并后自查修正:
- 批量替换误伤 70 处(清图奖励/安全格奖励/关卡大奖励/奖励身份预读 等
  属地图战斗资源域;「奖励道具经济」旧文件名与「迭代 10 奖励重构」属历史留痕)→ 全部回退
- battle.md 历史修订行误改 → 恢复 master 原文
- 奇物.md 5 处死链(../ux/ 少一层、魔法道具.md 已更名)→ 修
- registry 条目 markdown 链接 → 改纯路径(同文件惯例)
- 奇物.md R1 散文段 656 字 → 拆段,现在零结构性告警

验证读数(合并后主区全量复跑):
- 冒烟 755 项 / 0 失败,三闸全过
- ui_input_probe 十六断言全绿
- ui_layout_probe 四区尺寸逐位吻合 battle.md 规格
- doc_link 死链 0;doc_term 与基线同;gdd_lint 零新增
- 旧标识符残留全 0;_status_box 未成死代码,四个投喂键齐全
2026-10-05 07:24:15 +08:00
DKChan 3e2c564b59 merge: 判式换代批T0-T5全落(迭代14②号卡;冒烟750/0+run_all 15套+探针绿+doc三闸零新增) 2026-10-05 07:00:42 +08:00
DKChan 430419cf01 消歧更名批:魔法道具 → 秘宝(仅文档层,代码零改动)
用户拍板 2026-10-05。命名理由:「魔法」一词在本作已被征用为敌方侧
伤害/护甲语汇(magic_bolt 魔法矢 / magic_recoil 魔法反噬 / magic 魔法族
格面微光 / ward 魔法护甲),「魔法道具」易被读成"魔法属性的道具";
「秘宝」取"神秘·强大·稀有"义,与九件内容气质(工兵/工程/手艺向)契合,
且与局内道具(奇物)不冲突。**同调位机制名保留不变**(attunement 仍为
DND 词,机制血统不受更名影响)。

改动面(26 个文件,仅 design/ 目录):
- 正主重命名 systems/排雷循环/魔法道具.md → 秘宝.md,正文 17 处 + v0.9 版本行
- 称谓权威源 02-系统清单:文档树行 + 命名对照表 a5 行;英文代号
  AUXILIARY_ITEMS 沿用不变(代码标识符口径,另批对齐)
- registry/entities.yaml 30 处(referenced_by 九处 / owner 路径三处 /
  存档域注释 / 承重规则段);文件头新增 2026-10-05 注记并还原
  2026-09-16 段旧名原文
- GDD 现行文档 16 个 + 美术 2 个 + 架构 1 个
- 历史定稿加名称已变更横幅(正文不改):同调提案底稿(现行形态设计权威)、
  同调实施批任务书
- 修复 research 内 2 处指向旧文件名的活链接(历史文档不改称谓但链接须可达)

刻意保留旧名:8 处版本历史行 + 自造短语全量清单 16 处(出口即删的
中间审计底稿,改称谓会令统计失真)。

代码层零改动(用户明令),遗留欠债 4 项待可跑冒烟批次收口:
1. 代码标识符仍为 aux_* / AUXILIARY_ITEMS(auxiliary 词根为过渡形态遗留)
2. battle_narrator.gd:117-118 仍输出"魔法道具",且与同文件 139 行
   arch_names["magic"]="魔法" 同屏两义共现——"魔法道具"进入玩家视野的
   唯一残余通道
3. bonus_interact_controller.gd:76 清空 toast 仍写"魔法道具"
4. Godot 类名与文件名(AuxItemTable 等)改需同步 .uid 与 .tscn 引用

校验:registry 键集合前后一致(214 键零丢失零新增,仅增 7 行注记);
改动文件正文类零残留(残留 8 处全在版本历史/换名说明内);owner 路径
全部可达;链接检查除 2 处既有欠债(architecture.md 的 ../../design/ 多一层,
改动前即存在)外零断链。

注:局内道具名「奇物」全仓 md 零命中,本批未碰,避免两个换名批纠缠。
2026-10-05 06:50:44 +08:00
DKChan b6b43ebc2f 奇物 v2.7:三个子节点正式定名(专长 / 属性值提升 / 资源)
用户指出缺口:父节点有专名,子节点只有描述没有专名。理由站得住——帮助 /
百科 / 成就页一定会把分类露给玩家(「首次集齐 4 件专长」「三件属性值提升」),
效果描述里的指代也需要名字;卡面不带分类是**呈现面规则**,与命名是两件事。

定名:**专长(Feat)/ 属性值提升(ASI)/ 资源**——去掉「类」字后缀。
- 前两个是 DND 官方中文,且与用户 v1.1 原话一致(当时原话就是
  「属性提升(ASI)」与「专长」,v1.1 落文时被加了后缀而退化成描述)
- 「机制类」这个叫法另有硬伤:28 个成员里没一件是"机制",实际是
  "在结算挂点上改一条规则",读者会误解为游戏机制
- 「资源」虽偏泛,但 1.3 已有判据句托底,且是用户自己的裁定

新增 1.6 节「三层结构与命名」——用户拍板的玩家可见三层:
  一层 奇物(总称)/二层 专长·属性值提升·资源/三层 具体单件
明确写成规矩:**命名归本节,呈现归 battle.md / node-reward.md 裁决**,
并记明代码侧四套词族对应(curio_* / feat_* / asi_* / res_*)。

连带修掉批量替换撞出的七处自撞(专长(专长)、专长 = 专长、资源(资源))、
1.1 节标题的「专长:专长」、1.5 节残留的「命名待定」与旧括注、
02-系统清单文档树行的重嵌套。另把五处「这一类/这类」改为专名指代——
专名定下后仍用「这一类」指代会让读者不知道在说哪个。

同步:entities.yaml(categories 补专名与定名依据、新增 hierarchy 字段、
naming_note 记 v2.7)、06-待办清单、02-系统清单 v1.9、任务书 T3 词族目标
(顶层 curio_* 与内层 feat_* 分属两套词族)、两个 schema 概念指路注释。

数据层零变更;未 merge 回 master(本会话零测试)。
2026-10-05 06:42:48 +08:00
DKChan 3c5515aec4 奇物 v2.6:修正核心循环图——奇物不是打一场战斗给一份
用户纠错:原图把「关内 排雷推理 → 战斗结算 → 通关 → 得到一份奇物」
画成一条链,读起来就是每场战斗通关都给一份。

**错在哪**:把关内普通战斗的"打完"与关底 Boss 的"击败"混为一谈。
按 [冒险结构](冒险结构.md) 的定义,**通关一关 = 该关关底 Boss 被击杀**
——所以"击败 Boss"与"通过这一关"是**同一个时刻,不是一条链上的两步**。
用户原话点得准:"击败 boss 之后通过关卡,这跟打败 boss 是一个渠道。"

改法(五处,链条口径与渠道名一并统一):

1. **图改分支结构**:普通战斗节点 → 打完不给、往下走;奖励节点 / 商店
   各自兑付;关底 Boss 击败 ═ 一次专长三选一 + 通关回血 → 进下一关
2. **显式口径"一关只兑付一次,不是一场战斗给一份"**——写在图下方
3. **2.1 节渠道名**:「终局前 Boss 击败后」→「关底 Boss 击败(即通过这一关)」,
   并写明触发点就是关卡推进本身那一刻,不是"战斗结算之后再奖一次"
4. **文首引言加"兑付频率"条**(标为三条渠道的共同前提,先看那条);
   交叉表渠道名、registry 的 acquisition 字段同步
5. 06-待办清单新增"兑付频率(用户纠错后写死)"条目,注明勿再改回链式

连带修掉一处 v2.4 遗留污染:2.1 节节点类型封闭枚举五种里的"奖励"
曾被批量替换误伤成"奇物"(节点类型里没有奇物这一类),已复原为
「战斗 / Boss / 奖励 / 恢复 / 商店」。

术语微调:「终局 Boss 不给」→「末关的 Boss 击败后不给」——前者读起来
像在讲一个叫"终局 Boss"的实体,实际是"最后一关的那个 Boss"。

数据层零变更;未 merge 回 master(本会话零测试)。
2026-10-05 06:02:21 +08:00
DKChan 128078780f 奇物 v2.5:第三类定名「资源类」+ 回复归属定案
父节点定为「奇物」后,Q6(第三类命名)解锁,本批收口。

一、第三类定名「资源类」(用户拍板)
四个成员——行动点上限 / 刷新次数 / 金币 / 回复——都是可以调动、可以
花掉的余量,故名资源类。「资源」偏泛(能力资源、财富资源都叫资源),
因此在两处写死判据句,这是把泛用词收回本类定义的唯一凭据:
- 1.3 节新增专属判据:**给的是可以调动、可以花掉的余量,不是角色基础
  属性的永久抬升**。拿不准时问一句:它会不会进角色自己的属性数值?
  会进的归属性提升类,不会进、变成手里多出的次数或钱的,归资源类
- 1.5 命名出处节记明该偏泛性并指回 1.3 的判据句
(1.4 是三分类总判据,1.3 是资源类专属判据,层次不同不重复)

二、回复归属定案:留在资源类,不拆第四类
理由是它与金币同为**即时兑付**、都给的是可花掉的余量,判据完全同源。
拆出去之后第四类只剩两项,且与资源类的判据重合——分类的价值在于判据
能一刀切得开,拆一个判据同源的类只会让读者多查一张表。

三、附带修掉两处结构问题
- **1.5 段末与「### 2. 渠道轴」标题粘连**(缺换行,导致第 2 节标题被
  吞进 1.5 段落里,目录层级失真)
- entities.yaml open_questions 编号跳号(缺②、含两条已解决项③⑦),
  重排为五项:类内异质性登记 / 门票四参数无事实源 / 档二不可达延后复裁 /
  charge 仅 3 件数据缺陷 / 断点存档键换名待裁
- entities.yaml naming_note 笔误:「v2.0 曾名「奇物」」→ 修正为
  「v2.0 改名为「奖励」,v2.4 定名为「奇物」」

同步:06-待办清单(条目标题、交叉表行、待拍板项由三项减为两项、现状
描述)、02-系统清单(文档树行 + v1.8)、两个 schema 概念指路注释。
全文「资源与机会类」零残留(仅 02-系统清单 v1.5 版本历史行保留原名,
按规范版本历史不改写)。

数据层数值与表结构零变更;未 merge 回 master(本会话零测试)。
2026-10-05 05:46:54 +08:00
DKChan a2ce5d7e01 奇物 v2.4:顶层定名 Wondrous Item(奇物)
顶层概念由「奖励」改名为「奇物」(Wondrous Item)。

定名依据:DND 魔法物品九分类中的 Wondrous Item,官方中文译名即「奇物」,
是专装"不好归类但有奇效之物"的兜底杂类。选它的理由——本概念下三个分类
(规则 / 数字 / 余量)本来就没有共同点,能把它们拢在一起的只有一个
"不好归类但有用"的名字,而奇物天生就是干这个的。

落选者(都登记在 06 备查):
- Treasure(宝物):DMG 第 7 章正式术语,定义含 coins/gems/art objects/
  magic items,四条筛选全中,但偏"财物",装不下专长这种
  "你会了件以前不会的事"
- Relic:roguelike 品类惯例(杀戮尖塔 / Soulbound / 铲子骑士 Pocket Dungeon /
  Die in the Dungeon,后两个明确"局内可买可捡、run 结束清零",与本作同构),
  但用户已否决「遗物」
- 全部自造词(进益 / 造化 / 机缘 / 遇获):用户否决

**代码词族定为 curio_* / ADVENTURE_CURIO,不用 reward_***——
reward_pick(rng 封闭流 scope)/ reward_node(grant_aux_item context)/
reward_preview(道具 kind)已占用 reward 词族,照 reward_* 对齐会撞车。
06 里原「feature_* → reward_* 对齐」待办据此改写为 → curio_*。

改名范围(文档名 奖励.md → 奇物.md):
- 全文称谓、判据句(当局清零的是奇物,跨局带走的是魔法道具)
- 1.5 命名出处节重写(补 Wondrous Item 出处与落选理由)
- 02-系统清单:文档树行改名、ADVENTURE_REWARD → ADVENTURE_CURIO、v1.7/v1.8
- 06-待办清单:链接与称谓、三层约束表、命名统一后续条目(目标词族改 curio_*)、
  「顶层命名待定」条目改为已定
- entities.yaml:reward → curio、owner 路径、正文称谓(保护「奖励节点」)
- battle.md / level-map.md:奇物列表;HUD框架.md:奇物段先例
- 两个 schema 概念指路注释

**保护未动**:「奖励节点」(渠道名)、格面奖励 / 清图奖励 / 大奖励 /
节点奖励 / 奖励重构等历史与他概念用词——全部逐条核对未误伤。

数据层数值零变更;未 merge 回 master(本会话零测试)。
2026-10-05 05:25:28 +08:00
DKChan eaf1ae9184 奖励 v2.3:门票机制细化 + 默认原则表述修正
一、门票机制四条(用户 2026-10-05 定)
- **拿到即开、不可囤积**:不进持有集,选中/买下同一时刻开专长三选一。
  可囤积会让玩家把关键决策无限推迟,且把持有物语义从后门放回来;
  "道具"只是卡面表现,不是持有物
- **罕见只在概率,不在价格**:货架价与其他商品相当,不靠高价劝退
- **一局限购一次**(现行口径)
- **计步保底**:连续 5 次三选一展示未出现 → 第 6 次展示必定出现。
  计数对象=**展示次数**(刷新后的重新展示计入,用户明定含刷新——
  若刷新不计入,保底与刷新两套机制会打架,玩家可用刷新绕开计数语义);
  计数范围=奖励节点与商店**共享**;触发后清零;**限购用满后不再触发**

二、修正 v2.2 的误读(用户指出)
v2.2 把"分类在某渠道不出现"当成需理由的缺格,这是错的。
**渠道出哪些分类,是渠道轴自己的定位决定,不是例外**——Boss 只出专长,
另两类"不出现"是它的同义表述。默认原则**只管分类内部**:一个渠道一旦
确定要出某分类,该分类的成员就都要在池子里。两句话管辖范围不同,
已在文档与 registry 分开写死。

三、档位问题按用户决定延后,但两块都登记
- 专长总量 vs 档位阈值(≥2 档一 / ≥4 档二):三关下确定性 2 次 + 门票
  最多 3 次,**档二几乎不可达**。用户定"先不调整"(后续有第四关),
  复裁触发=第四关内容批落地后实测。登记防忘。
- **charge 标签仅 3 件**(relics.tres),永远达不到 4 件档二——
  数据层缺陷,与渠道结构无关,单独登记勿被上条盖掉。

四、顶层命名待定(用户否决了「奖励」与「收益」,要自造词)
新增待办,并记一条硬约束:**代码 reward 词族已被占用**——
reward_pick(rng 封闭流 scope)/ reward_node(grant_aux_item context)/
reward_preview(道具 kind)。因此 06 里「feature_* → reward_* 对齐」
那条待办**不能照做**,会撞车。候选词:进益 / 造化 / 机缘 / 遇获。

同步 06-待办清单、entities.yaml;验收标准补 11/12 条。数据层零变更。
2026-10-05 04:25:54 +08:00
DKChan 26374accb3 判式换代批T0-T3(迭代14②):audit常量刷新(池77/直伤6-8-8/heal2/清图24-40/AP8/off_guard-1/伏击退役/九型字典/β带+逐型输出——改前静态锚判值与方案报告§四逐位吻合)+runsum五字段落码(flag_placed/hit/miss/gain/penalty——行侧判据考证=授予行专带highlight,状态复发行排除,实测87行==87插旗1:1)+F1条款3重立三层口径(聚合健康式只留下限0/旗边际引理/条件二旗溢价δ=0.25登记已知破)+β带[1.2,2.5]判读入文+η读数入文+战斗结算gp/ap当量注记+验收条款3对账+难度联动表+6行+P1改判读回执+registry clause3_inequality重立条(改前锚+P7两点修正)+06破线条收口+07⑫旗溢价目检项;闸=冒烟747/0+doc三闸对基线零新增(worktree死链+2系gitignored路径环境性) 2026-10-05 03:43:42 +08:00
DKChan d6c13809a5 奖励 v2.2:门票形态 + 约束分层 + 默认原则
一、非 Boss 渠道给「专长获取」门票(用户明确)
奖励节点与商店不直接给专长,而是给一个道具——拿到后开专长三选一。
交叉表机制类在两渠道由"不出现"改为"**门票形式**"。
- 门票归**机制类**不归资源与机会类:它给的是"一件你以前不会的事",
  只是把选择推迟到一次三选一(按 1.4 判据)
- 为什么只给门票:若商店能直接买到指定专长,玩家能用金币把构筑买出来,
  Boss 渠道"打赢才拿到"就失去意义;门票保留惊喜(三选一不是指定),
  但不让钱定点购买

二、用户质疑「计价物不自售」本质是特判——质疑成立,重构为三层
诚实结论:**形式上它确实是特判**(在分类白名单之外加的一道过滤,
不是从分类推出来的)。与死特判的实质区别在于:
  死特判 = "GP 不进商店"(一条记录,每多一个例外加一条,靠记忆维护)
  可计算谓词 = "X 是渠道 C 的计价物 → X 不进 C"(一个函数,自动判定)
即:没有消除"白名单外加过滤",但把**枚举例外变成计算谓词**。
渠道约束改写为三层:
  一层 分类白名单(分类轴决定渠道)
  二层 可计算谓词(结构性关系,新渠道/新奖励自动判定,不用改表)
  三层 显式例外清单(人为设计选择,只能逐条加,**每条须写理由**)
判据:结构性原因(计价物/即时兑付/先决条件)写成谓词;设计性原因进清单。
**要害不是有没有例外,而是例外能不能被算出来。**
三方案代价并列摆出不藏折中:甲 GP 单独立类(例外 0 但两轴缠回)/
乙 谓词(现行,1 条)/丙 死特判(靠记忆维护)。
在册约束就两条:①金币不进商店(二层·谓词)②机制类非 Boss 渠道只给门票(一层)。

三、立默认原则(用户定):除已登记的特殊规则外,分类内的东西都要在
它该出现的渠道池子里——任何"不出现"都要登记理由,没理由的缺格是缺陷。
据此**回复应在商店内**(回复不是计价物,套不上计价物不自售)。现行
shop.tres 货架只有 attack/max_hp/armor/ap 四项,缺回复=现状与表格
不对齐,须在实施批补上。

同步:06-待办清单(交叉表改门票 + 三层约束表 + 待拍板项增为三项)、
entities.yaml(acquisition 收口、channel_rule → channel_constraint_layers、
open_questions 更新)、02-系统清单 v1.7。验收标准补第 10 条(默认原则)。
专长门票尚未入表(出现概率/配额/全局限量无事实源)已登记。

数据层数值零变更;未 merge 回 master(本会话零测试)。
2026-10-05 03:34:26 +08:00
DKChan d472ef061f 奖励 v2.1:交叉表收口 + 计价物不自售规则
一、Boss 渠道收口(用户拍板)
- Boss 渠道**只出专长**:属性提升类与资源与机会类在此均不出现
- 兑付只发生在**终局前**的 Boss;终局 Boss 不给(打赢时冒险已结束,
  无后续关卡可消费)——此前"最终关是否也给"的待定项由此收口
- 交叉表形状定为「一块独占 + 两块并行」:专长靠打赢,其余靠抽取与购买,
  两者的获取节奏由完全不同的机制决定

二、金币不进商店:写成规则,不拆分类也不开特例(用户提问)
用户问"资源与机会是否拆开?GP 是单独分类还是特判"。定为第三条路:
  **计价物不自售**——凡是以某渠道的计价物为内容的奖励,不进该渠道货架。
  商店计价物=GP,故 GP 不进商店。
- 不拆第四个分类:分类轴回答"给的是什么",GP 给的是余量,与 AP/刷新
  同类;按"能不能进商店"反推分类=用渠道轴去切分类轴,两根轴缠回去
- 不开特例:特例是孤立的、靠记忆维护的;规则对所有渠道成立,将来
  任何渠道用自己的计价物当奖励内容时自动适用,不需补第二个特例
- 它是**两轴交叉处的一条约束**,实现上是货架候选构建的过滤条件,
  不是奖励自身的属性

三、待确认
- 回复当前也不在商店货架(现行 shop.tres 货架只有攻击/生命上限/护甲/
  行动点四项)。回复不是计价物,严格说不适用于「计价物不自售」——
  它不进商店是同一条规则管还是另有口径,待拍板
- 专长总量:终局 Boss 不给已定,一局确定性兑付次数=终局前 Boss 个数
  (三关=两次),而档位阈值是同标签 2 件档一 / 4 件档二,档二须靠
  罕见旁路补齐——归曲线调参批观察

同步:06-待办清单(BD 分层条目改写为交叉表 + 待拍板项由四项减为两项)、
entities.yaml(acquisition 收口 + 新增 channel_rule + open_questions 去重)、
02-系统清单 v1.6。验收标准补第 9 条(金币不进商店是规则结果而非分类)。

数据层数值零变更;未 merge 回 master(本会话零测试)。
2026-10-05 03:21:56 +08:00
DKChan 33fcac79e8 奖励 v2.0:顶层改名 + 重构为两根轴(分类轴 × 渠道轴)
顶层概念「特性」改名为「奖励(Reward)」。改名动因:这个筐里既装
"角色自身的变化"也装金币这类一次性兑付物,用"自身提升 vs 持有物"
已经切不开——边界判据改由生命周期承担:
  一次冒险内获得、冒险收束即清零的是奖励;跨冒险跟着你走的是魔法道具。

分类由两类扩为三个枚举(分类轴 = 给的是什么):
- 机制类(专长 Feat)      → relics.tres
- 属性提升类(ASI,生命/AC/攻击三轴)→ adventure.tres
- 资源与机会类(命名待定:行动点上限/刷新次数/金币/回复)→ adventure.tres
  类内异质性显式登记:金币与回复是即时兑付,不进持有集、不持续生效,
  与行动点上限/刷新次数生命周期不同。

新增第 2 节「渠道轴 × 分类轴」交叉开关表:机制类主渠道=关底 Boss
击败后(不新增节点类型),罕见旁路=奖励节点/商店的「专长获取」;
属性提升类与资源与机会类=奖励节点 + 商店。两根轴互不决定。

gp/heal 不再当作"该移出去的脏东西"(用户 2026-10-05 选暂不处置=
不做结构性迁移、不动配额),改为安置在资源与机会类里并登记异质性。

同步:02-系统清单(文档树改名 + ADVENTURE_FEATURE → ADVENTURE_REWARD +
v1.5)、06-待办清单(BD 分层条目改写 + 新立「两个新种类入池」条目 +
「命名统一后续」补 feature_* → reward_* 对齐项)、entities.yaml
(feature 条目 → reward,新增 axes / 三类 categories / open_questions)、
两个 schema 的概念指路注释、battle.md / level-map.md / HUD框架.md 称谓。

未动:数据层数值与表结构(值零变更);feature_* 标识符尚未换到
reward_*(属临时态,已登记待办,须在可跑冒烟批次收口);game/ 下
运行层称谓换名同批。本会话按测试执行两入口铁规零测试。
2026-10-05 03:01:13 +08:00
DKChan 8e7acaa903 特性 v1.1/v1.2:分类重构 + 专长渠道落定
v1.1 分类重构(用户拍板):
- 两类由「规则改写型 / 属性加成型」改为「属性提升(ASI)/ 专长(Feat)」
- 属性提升内部再分纯属性组(生命上限 / AC / 攻击)与特殊组
  (行动点上限 / 刷新次数 / 专长获取)
- 刷新次数的作用对象是选择界面而非角色,作为例外显式登记,不进加算区
- 回答「刷新次数是否构成第三个枚举」:否——枚举轴(是什么)与
  渠道轴(从哪来)是两根轴,同项出现在两个渠道不改枚举数量

v1.2 专长渠道落定(用户拍板):
- 专长的专属渠道 = 关底 Boss 击败后兑付;不新增节点类型,
  节点类型仍为封闭枚举五种,改动落在 Boss 节点兑付面
  (「是否扩类」悬案由此收口)
- 罕见旁路明确为「普通奖励里的专长 N 选一」,罕见且全局限量

新增待拍板 / 待观察:
- gp(金币袋)与 heal(恢复)不进持有集、不持续生效、无生命周期,
  按「自身得到提升」的定义是否仍属本类待拍板(甲案移出另立即时兑付 /
  乙案放宽定义;动池须重裁档位结构锚 70/25/3)
- 最终关 Boss 后是否也兑付专长
- 确定性渠道一局两次专长 vs 档位阈值(同标签 2 件档一 / 4 件档二)

同步:02-系统清单 v1.4、06-待办清单 BD 分层条目改写 + 新立「两个新种类
入池」条目、entities.yaml feature 条目(form → categories、新增
open_questions)、两个 schema 的概念指路注释换用新分类名。

未动:数据层数值与表结构(值零变更);game/ 下运行层旧称谓换名
留待可跑冒烟批次(本会话按测试执行两入口铁规零测试)。
2026-10-05 02:48:17 +08:00
DKChan 5cf7f4b6ae 立《特性》概念:局内加强物品统一命名为「特性」,两种形态收敛为枚举值 + 文档/称谓/数据层标识符统一
- 新增 design/gdd/systems/冒险循环/特性.md(概念唯一定义文档)
  定义=一次冒险内角色自身得到的提升(不是持有物);作用范围、生命周期、
  获取途径(战场奖励/商店·训练)、关联与边界五要素齐全;数值一律指路表不入正文
- 02-系统清单:冒险循环补行 + 命名对照表补 ADVENTURE_FEATURE
- registry entities.yaml:新增 feature 概念条目(owner/referenced_by)+ adventure_table 字段名同步
- 数据层标识符 112 处换名(值零变更):BONUS_IDS→FEATURE_KINDS、bonus_token_count→feature_quota、
  bonus_value→feature_value、token_*/bonus_*_flat→feature_quota_*/feature_value_*
- 称谓统一 94 处:旧称「流派件/数值件/本关强化」→ 特性 + 形态修饰语(规则改写型/属性加成型)
- 两张 schema 顶部加概念指路注释,代码可直接查到定义文档
- 06-待办清单:BD 分层条目现状改写 + 新增「命名统一后续」条目(relic 词族与类名对齐待实施)

未动:类名与文件名(Godot .uid/.tscn 引用需跑测试自证)、断点存档键(兼容)
2026-10-05 01:46:35 +08:00
DKChan fd6a8325f0 TP0令牌池落地(迭代12条件卡——node-reward v2.2追认b实施批):三选一池改固定配额令牌池70/25/3=98张(罕见档道具件2席随aux池种退役收窄=台账自决披露项;schema validate结构锚硬断言)+抽签Fisher-Yates同kind去重+选中踢池未选回池+池耗即枯竭+种类次数上限退役+恢复件+6新入池rare档+数值对全落;MC策略316-f落地(autoplay 1级最稀有/2级最左_pick_token单点);货架=令牌级抽签价格tier-blind维持批②裁定+消费在架令牌本体;断点扩键bonus_deck余库逐枚还原(旧断点缺键=满库重建防御单版本周期);跨表校验⑥改令牌配额检查;文档四正主=node-reward v2.4+冒险结构v0.14+registry+06落地状态;normal档重锚runsum_m4iter12_tp0_n20_20261003(seed0=90000配对读数同带0/5/0零结构位移+316-f构成佐证)——闸=冒烟670/0三闸+run_all 15套+探针五绿click存量红零新增+doc三闸零新增+熵增PASS 2026-10-04 00:17:39 +08:00
DKChan d79afd2241 迭代11第②批:GP商店房重构——三选一同构化(P1共享池账本+抽3买1全重抽+A/b乘法定价ceil+断点扩键+货架同构呈现+MC off/on分层;冒烟671/0+off对拍off_n60逐位PASS+探针三件绿) 2026-10-03 18:19:57 +08:00
DKChan a6a2bf885e 迭代11第①批:魔法道具同调实施批 T0-T10 全落(重闸 645/0 + MC off 逐位 PASS)
- T1 表与schema:attunement_growth.tres 谓词表(m1/m2/m3+Σgrant≤slot_cap 校验+slots() 求值口径)+道具表扩列(form/charges/slot_cost/unlock_requires/effective_rounds/charge_n+effect_kinds 九kind+KEY_WHITELIST 零裸flat护栏)+七同调行
- T2 save v4(boss_kill_count 收束入账+attunement_equipped+attune_refresh_level+断点 attunement_charges+迁移链 v3→v4)
- T3 Attunement 求值服务(纯函数零 await 零 RNG)
- T4 营地装配覆盖层(工坊扩容程序占位+Y 升级行 attune_refresh_upgrade 行族)
- T5 被动六件接线+装配注入链+刷新 X/Y 双源(BonusPickOverlay 刷新钮,autoplay 默认不刷)
- T6 掘进蓄能全链+摆钟能力面(骑库存面差额注入+断点充能键);炸格 P5 甲影响评估破面大→用户裁拆后批,blast_kit deferred 留位
- T7 退役面五件(BONUS_IDS 除名 aux_item+transitional_sync_slots 过渡键退役=迭代10欠账③清偿+授予路/四容量闸拆除+nest_pendulum 换装 active_charged)
- T8 冒烟六新断言(645/0)+MC attune 开关+贪心画像分层 off/on 各 N=60 双策略(on 画像功率显著带平移归调参批;off 新锚=对拍正主留盘主区 sim-data,81000 降批入口基准)
- T9 连带修订九件(魔法道具定位重写/元进度v1.6/地图战斗资源v0.16/行动经济v0.7/05不做v1.3/关卡节点地图v1.4/node-reward v2.2/registry 三处/06 收口+炸格拆后批新条)
- T10 重闸全绿:冒烟 645/0+熵增 PASS+doc 三闸零新增+MC off 复跑同种子逐位一致 PASS;出口人闸后移迭代 12(用户 2026-10-03 令)
2026-10-03 15:41:30 +08:00
DKChan a6833b6ac3 docs: 中间产物死亡清单 A/B 桶执行批——git rm 83 件(A1跟踪12+A2全部8+B1跟踪19+B2全部9含playtests/conversion-calibration/t5预览两目录)+指路句改写13文件37处改结论内联或git提交号(art-bible/level-map/07/魔法道具/HUD框架/难度曲线/关卡节点地图/元进度/entities/06/roadmap+三render脚本);删前核三过一留(alpha-acceptance-battle-screen系Alpha验收销项底单留待裁);在飞域四件挂债未碰;死亡清单补执行记录节(部分执行不自删);闸=死链4环境差+术语1既有+熵增PASS全回基线;依2026-10-01吸收即死铁律与doc-conventions§11 2026-10-02 05:39:51 +08:00
DKChan 4f62a489b6 iter10 追加批: 奖励节点三选一共享池(用户拍板)——AdventureRunner 节点API+AuxItems 句柄面+main 共用面分派+node_overlay 道具面退役+autoplay 节点驱动+reward_overlay_test 随面迁移+a裁备选(L3复杀3)+g裁semver(v2兼容断言+存档序列化v1.3)+f裁调研待办(06新条)+文档五件+任务书(冒烟628/0+run_all 15套+五探针+三闸零新增+熵增PASS) 2026-10-01 06:12:25 +08:00