game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
2,348 Commits 23 Branches 0 Tags
bee73db51bbabbd9ccac0ae14dbbaf4e4049cd0f
Commit Graph
34 Commits
Author SHA1 Message Date
DKChan 215da31591 修复(迭代 41 测试债批): 9 套件归绿＋静态扫描 S9/S10/S11 清零＋删死常量 SCHEMA_VERSION——两个产品回归随批修（standee 补间目标改子对象 st／tune_sim 运行态收尾归还 run），测试面按 iter41 拆件改址（slots/meta_state/crossrun/_forge/_side）；S9 类型闸 24 处（node_map 三处给 Array[int] 真类型，其余动态边界 type-hint: ignore 逐处注记）＋S10 头注日期 4 处＋S11 退役词 1 处；config_db 头注「--script 无 autoload」订正为实测事实（autoload 并存、共享 .tres resolver 归最后装载者） 2026-10-29 06:04:40 +08:00
DKChan a613a3cb90 iter41-卡1：核心数据面结构收敛批：85键全清——三族拆域＋config_db归位容器＋存档拆件＋meta瘦身＋adventure拆段＋spawn束化；行为零变化，8新件在阈 2026-10-29 01:33:50 +08:00
DKChan 92ae63c299 feat(通关口径换代·提前实施卡批 T3/T4): C 面注释清扫 61 条(core 六件 29/adventure_runner 14+save_manager 9+level_runner 3+其余 3/表头注 5/enemy 768 验收判据+871 设计基准/treasure_items 11/adventure 51/meta 55/schema 4/sim 11/README 7/呈现层四件 8)＋S11 豁免单 7→20 处(.tres 段 12+level_autoplay:560,头注避词「口径换代」防自撞)＋tests/README S11 豁免计数 4→20 订正(quotaface 漏同步随批修)＋体验验证清单 3 行(:107 关卡完成率/:193 冒险成功局数+各关完成次数+才计冒险成功/:198 引语);件核三判据过(S11 等价验证器零命中+豁免撤销证明 hero.tres:21 去豁免即红/冒险终结零命中/清单对账零差异);grep 残留=豁免单 13 行+被检字形态,非豁免残留清零——208 处基线全数消化(12 产品+111 随动+84 注释+体验清单 3+README tests 1=211 改动行,其中豁免保留 13) 2026-10-26 07:32:40 +08:00
DKChan 89605e42e6 feat(令牌配额口径清扫·提前实施卡批): 照需求卡片 v1.2（reports/需求卡片-令牌配额口径清扫批-2026-10-26.md，用户 2026-10-26 裁准提前实施并从简）落地十一处清扫＋两处配套——q1 schema 头注四处（:32-36 段并单口径现行句 70/25/7/0＝102、:49 位序句、:58「总量 98 锚」→102、:202 deck_total 旧 104 句按实算改写＝tier_total 四档求和 102，凭证走 feat_ticket_* 不进牌库）；q3 tres 头注五处（批次1 已并，本笔订正一处失实：删「配额键未载表补表归待办」句——写卡会话实查 B1 论断：ap_rare 显式载表与默认同值、rap/时沙走缺省合法，validate 含默认求和恰=常量 7 且绿，无补表义务）；q4 golden README「魔法道具 HUD」→「秘宝 HUD」（采直换新名形态，不落「时名」括注以免撞 S11——卡片措辞方向内）＋宿主断言标签（批次1）＋验证集清单重生成 1583 条对账零差异；B4b 三处「罕见」按裁定原文保留，S11 显式留档豁免单登记 4→7 处（adventure_table:26 档名映射注＋:93 与 curio_deck:130 契约④原名引述，附出处注）——补齐卡片关联同步面未列的闸口缺口。契约1 数值与断言条件零触碰（TIER_QUOTAS/三处默认/tres 数值行/条件表达式逐字不动）。卡片与待办条目随批删除（用户裁：活干完登记即毁），验收证据随本信息与下笔撤销证明留档 2026-10-26 04:59:17 +08:00
DKChan 1b8d8f7267 docs(文档回写批): 阔视野带表述订正为视野照亮范围＋adventure_table 注释「资源类」换代「补给」＋两条待办销账 
阔视野带两处旧述「类型微光范围 8→12」与实际效果不符：该件参数面为 light_radius_bonus（+4），扩的是视野迷雾灯光区，类型微光按 HUD框架 拍板恒贴身 8 格不随视野扩大（HUD框架:169/:271 在册）。秘宝.md 普通档表与 treasure_items.tres 该行 desc 同步订正。

adventure_table.gd 三处注释「资源类」随奇物第三类改名换代「补给」（:21/:24/:59，待办原记两处、实测第三处 :59 一并改；数据零改动，kind 字面是账名不是分类名）。两条待办按完成态整条删除。
 2026-10-23 00:53:29 +08:00
DKChan b6629d6848 feat(T2-T6): 五词注释换代——完美排雷→完美封印/板级→整图/门票→专长凭证/正主→现行事实源/落籍→已入库 
全局 sed 替换 89 处命中清零（S11 绿）。修复：
- 移交 3 处保留原词（shop.tres:86 display_name、curio_controller:165-166 玩家文案）
- 豁免 enemy.tres:653 历史注记保持"已落籍"
- static_scan.sh 词表追加行与头注恢复禁「」引举句式
- S11 规则文件自身不被自身规则误伤（闸门自指豁免生效）
 2026-10-20 20:41:50 +08:00
DKChan 6d601d23dc chore(禁写变更记录批): 版本历史节/日期批注全面废除——gdd_lint R4 反转禁设＋三工具去豁免＋48 文档删节＋game/README 流水段删＋代码注释 900 余行轨迹标签清偿（约束句保留）＋规约/skills 五层指令面同批改指 git 沿革 2026-10-20 00:22:18 +08:00
DKChan 072c19b4a5 feat(凭证件裁削): 卡② 同调电池删除＋完美保险迁专长＋配额净删落地（迭代 31 卡②） 
用户 2026-10-18 逐裁四项落码：
- T1/T2 同调电池整件删除：CURIO_KINDS 摘 kind、三字段与三处分发表分支删净、
  runner 侧 _battery_pending/断点键/getter/choose_battery_target 全清（呈现层零接线=有账本无入口）。
- T3 完美保险出池：kind/字段/分发摘除，_pending_insurance 与 level_runner 注入通道
  （voucher_insurance 键、set_voucher_grants 第三参）整链拆除，battle_orchestrator._fx_insurance 删。
- T4 引擎扩签 forgive_seal_miss（EFFECT_KINDS 31→32）＋两账相减：新增 _perfect_forgiven 单向累加、
  谓词抽成 perfect_sweep_earned()（有效误标=误标总数−豁免数），_perfect_hit_false 保持纯净=契约 2；
  seal_missed 发射时机与消费点零改动=契约 3（危险直觉·守同事件订阅面在验收组里对拍）。
- T5 feats.tres 第 30 行完美保险专长：rarity rare／cap 省略／domain=battle 显式写出（战斗域首例）／
  desc「本场首次封印落空，不计入完美封印判定」；限次由行 when counter(insurance_used) lt 1 承载，
  do 自带 counter_id 记账由授予段消费点落账（代拍板 3 选型：单行落表，理由见实现报告）。
- T6 配额净删：TIER_QUOTAS rare 9→7、令牌池总量 104→102，validate() 硬断言过；smoke 配额锚/牌库
  构成/专长行数随批换代。
- T7 验收：feat_vouchers_test 39 项全绿（出池反例/断点缺键兼容/账本保留/配额锚/装载/限次一次/
  计数纯净/两账相减真值表/跨战清零/事件不吞）＋forge_table 词表闭集断言 31→32。
  变异验证 6 条：5 条证红；「domain battle→adventure」在本 rig 不可观测（未红），已如实登记。
- 存量缺陷顺带修：旧 _emit_row("insurance_used","",…) 空来源会触发行来源断言（旧路径无消费点故从未走红），
  新订阅面给出 source_class=seal_miss。

基线（卡① 合回后 master 4f953ce8）：冒烟 1151/0、单元 34 套全绿、探针 --click 全绿（user:// 存档移开态）。
 2026-10-19 04:45:49 +08:00
DKChan 32fdf957fd refactor(代码术语): 卡① flag→seal 全族换代＋game/ 禁用词清扫（迭代 31 卡①） 
标识符面：flag_*→seal_ 族（含 Godot 信号 flag_judged→seal_judged 与连接/回调同名、
FACTS 两键 flags_count→seals_count／dug_under_flag→dug_under_seal 全链、
.tres 键名与 schema .gd 同批同步）；显式豁免零改动=size_flags_*（Godot 布局属性）＋_fatal_flag。
中文面：金币→GP（金币袋→GP 袋）／插旗→封印／雷格→危险格／惩罚格→危险格／旗→封印·封印印记族，
game/ 内 *.gd/.tres/.md/.json 四类禁用词与 flag 双双零命中（V1/V4）。
守卫字面量不动（被检查的禁字不是使用）：smoke_all V21 零「雷/旗」检查面、
ui_font_asset_test 字形集攻/雷/旗/封 保持原断言逻辑。
代拍板：板面单字槽 glyph「旗」→「封」（禁字纪律＋单字位宽，消费面四处同名随动）。
素材换代（2026-10-18 用户裁案甲）：assets/art/board/flag_seal.png→seal_mark.png（素材不入 git，
盘上改名＋导入重刷），代码两处 res:// 字符串＋COL_FLAG/CURSOR_FLAG 常量同步，
闸件四处随批（run_all_gates.sh/render_gate.sh/golden_baseline_refresh.sh/path_check.py）。
anchor.json 键名手改，重锚与改前改后 diff 随本卡收口（同裁案甲）。

基线读数（改前，主区 ed2dfaf6）：冒烟 1151 检查 0 失败／单元 34 套全绿／探针 --click
存量红仅 screen_flow_probe（user:// 断点污染在册已知项）。
改后同批读数（本 worktree）：冒烟 1151 检查 0 失败／探针 --click 同一存量红、其余全绿。
 2026-10-19 02:52:38 +08:00
DKChan 9a72394652 chore(代码卫生): 头注存量清偿批——82 文件按两类白名单改写为 ## 文档注释载体 
按 code-conventions §1.4.1 第三轮定稿执行：core 22+schemas 18+presentation 根 14+views 28，全部头注 #→##、删日期/变更叙事/GDD 与架构反向链接/字段与域清单/机制描述，保留职责摘要+真实使用约束（防事故禁令/单一入口/信号契约每信号一行）。main.gd 31→5 行、save_manager 45→5 行、adventure_runner 37→5 行为最大单件。子代理分模块执行（波一 core+schemas、波二 presentation+views，并发≤2）。验收=tools/verify_comment_only_change.py 逐字节校验（82 文件头注区外逐行一致=零行为变更）+audit_file_headers 全绿；纯注释批免冒烟（先例 5843270）
 2026-10-16 23:28:07 +08:00
DKChan 5f9d8e7b77 chore(代码卫生): 文件头零工作日志红线落文+全仓头注变更叙事清偿（2026-10-15 用户令） 
- CLAUDE.md 硬性红线新增「文件头零工作日志」；code-conventions.md 新增 §1.4.1（含反面案例）
- 全仓 .gd 文件头注清偿：删除全部带日期条目、批次叙事段与迁移退役叙述，保留并改写为
  现在时的职责、接口契约、GDD 锚内容（main.gd 头注 42→31 行、save_manager.gd 49→45 行）
- 纯注释改动零行为变更，按用户令免测试免冒烟
 2026-10-15 04:08:38 +08:00
DKChan 3333187351 feat(close): 迭代20 T5+T8+T9+T10 C段收尾（专长实装批） 
T5 Boss 兑付面换代：通关渠道三选一改按档配比加权抽取（无放回加权抽 boss_feat_weight
100/45/15/5 provisional 归调参批——奇物.md v3.1 rarity 语义约束兑付面）；信号注释换代
「提升三选一」→「专长三选一」（V11 正名）；V12 频带断言（300 停点档位频率出带±15pp）。

T8 MC 对账适配：formed 画像 14 旧件→五事件族 14 新件（开格 4/插旗 3/踩雷 4/节奏 2/战斗 1）；
新基线取证：normal/off 100 局 71000 档 通关 0%（master 对照同为 0%=零配基线本相），
止步分布 90/10→93/7 可归因曝光槽候选构成；同种子重放 30 局逐位复现 ✓（V15）。

T9 迁出收尾：treasure_items 删 venom_edge/flag_burst 两行（同调目录收窄）；schema 词面
venom_rider/flag_burst 摘除（EFFECT_KINDS/MAGNITUDE_KINDS）；rewrite_board 效果类型除名
（净化工兵退役——V14 连带清理闭环）；V13 断言入 smoke。

T10 空配置验收闸：三选一池空 skip_empty_curio 消化+非空拒绝反例+商店空货架合法态断言。

测试：pool_case_d 17 checks（+V12/T10）/feat_vouchers 23 checks（+V16 断点往返）；
冒烟 864/0+run_all 21 套全绿。
 2026-10-12 00:28:22 +08:00
DKChan 1387aedc94 feat(vouchers): 迭代20 T4 凭证件五件实装+F-1 刷新写错账修复（专长实装批 B段二） 
五件路由（_apply_curio_pick 通道面）：刷新券→刷新存量账 _refresh_stock（**F-1 修复**：
退役 _attune_refresh_x 写口——X 每停点重置吞存量=写错账缺陷正主；消耗序 X→Y→存量，
attune_refresh_left 扩第三源；旧早退路径零摘牌缺陷同批修正=选中即消尽）/储备金袋→
_pending_rap 战首 RAP 注入（action_economy.grant_reserve_ap 新口）/同调电池→
_battery_pending+choose_battery_target 玩家点选跨层写 attune_charges（禁自动替选——
装配集/主动充能件双校验拒绝）/时沙→_time_sand_queue 战首首轮 AP 队列（池增量不改上限，
hero_ap_bonus 同通道）/完美保险→_pending_insurance 战首豁免次数（flag_miss 首见判定
_perfect_hit_false 回退=完美谓词无痕，节点级未用即过期）。

注入链：runner set_voucher_grants 三账→enc voucher_*→编排器消费，节点级一次性注入即清零。
配额投放：凭证四件入稀有档（rap 2/battery 1/时沙 2/保险 1）→结构锚 rare 9/总量 104
（已裁换代授权内 provisional——偏离 GDD 占位记录随代拍板追认单）。
断点扩列（T7 前置）：refresh_stock/battery_pending 随档+resume 回填（旧档缺键缺省 0）。

测试：feat_vouchers_test 新套 20 checks（V9 逐件路由+F-1 反例钉面/V10 留任路由+AP 属性轴）
入 run_all 21 套全绿；冒烟 863/0；smoke 牌库数 98→104 系换代。
 2026-10-12 00:08:00 +08:00
DKChan 0640b0c06d feat(pool): 迭代20 T2 池结构案D 换代（专长实装批 A段二） 
四级档位：TIERS common/excellent/rare/legendary（跨层框架档名映射承袭）——TIER_QUOTAS
70/25/3/0=98 直映射零偏离已裁结构锚（传说=头奖位留空）；配额/件值字段物理改名
（旧 rare→excellent、旧 rarest→rare）+凭证四 kind 占位（rap/attune_battery/time_sand/
perfect_insurance，配额暂 0=T4 落路由同批投放）。

概率与上限解耦（案②令牌池+提前退役）：curio_cap_* 每 kind 独立字段（99=无上限占位，
实数归调参批）+专长 cap 行字段面；taken 身份维计数（relic:<feat_id>）拿了才计刷出不计；
cap 满在候选视图剔除（牌库本体不动=概率位独立存活）；断点 bonus_taken 身份维键随档还原。

曝光槽：三选一=2 格全池+1 格优秀档以上子池（子池独立洗牌同 stream 续消费；子池空回退
全池；池空直通同族兜底）；凭证（feat_ticket）不进抽签池只经保底注入；商店货架同 cap 过滤。

潜伏缺陷修正：效果引擎 has 算子 null 安全（敌技伤害载荷无 terrain_kind 事实回落 null 时
判「不在场」而非 String(null) 抛错——候选流变化后 devour 件首次被持有而暴露）。

测试：pool_case_d_test 新套（V6 令牌三态/V7 曝光槽回退/V8 解耦提前退役）入 run_all 20 套；
smoke 三档锚/数值对/池构成/上限带四处断言换代（V14），冒烟 848/0+probe_gate --click 全绿。
 2026-10-11 23:18:35 +08:00
DKChan a33ddaf542 秘宝六件迁移+掘进蓄能受理闸数据化+令牌兑付 match 收敛进效果类型（T4+T5——内容数据驱动扩展批） 
T4 秘宝侧（六件按 id 硬编码全部拆除，行为与迁移前逐位一致）：
- 淬毒刃纹：begin_battle attune_venom 注入+伤害控制器特判分支拆除——行 triggers clamp_check
  modify(mode:clamp_bonus) 双订阅（pierce_vs_ward / magic_vs_heavy eq 行=旧「pierce|magic × 矩阵>0」
  的精确集；mode 路由=主角攻击面专享，棋盘克制窗只消费无模式 delta——棋盘不吃毒面保持）。
- 偏运硬币：reward_economy.luck_bias 注入拆除——行 triggers reward_roll bias_rewards 订阅，
  发射点命中合计经 _biased_cell_rows 入参（合成序「图级先件级后」不变）；冒烟偏斜段断言面随迁。
- 工兵晨令：编排器两处直调入队拆除——行 triggers round_start grant_ap(mode:queue) 订阅，
  when round_index ≤ effective_rounds（when value_from 行字段定影——新查询面，悬空校验同面补齐）。
- 惊巢反制：_grant_routed 按 id 减半特判拆除——mine_hit damage_mult(50) 订阅命中经 halve_pct
  入参（ceil(power×50%) 与旧 ceil(power/2) 逐位一致）+ open_ticket(channel:reflect) 订阅施加。
- 标中殉爆：flag_hit 按 id 开单特判拆除——行 triggers open_ticket(channel:blast, value_from
  magnitude) 订阅施加（施加位=迁移前开单位：殉爆→净化→图谱）。
- 掘进蓄能：use_treasure 按 id 受理闸特判拆除——treasure_used counter_spend 订阅施加（消耗成功
  才受理、积点不足拒绝零消耗，进度文案逐字保留）；积点账本迁效果引擎计数器 dig_charge_bank
  （模判定留编排器侧：「每 N 格积 1 点」在发射点施加架构下无法行内表达先增后判——when 于
  dispatch 预评估，逐位等价优先；词汇表边界注记留档，遗留观察项随出口报告呈报）。
- pick_refresh：adventure_runner 按 id 特判拆除——effect_kinds bonus_refresh kind 分发查询
  （装配集行 magnitude 合计；刷新件类加件零 id 分支）。
- 主动件 kind 词族换代（reveal_tiles/preview/grant_ap/remove_mines/refresh_pick）挂账保留：
  本批只要求 pick_refresh 合流；全词族 rename 波及库存/呈现/单测零行为收益，不随批（出口报告
  遗留人闸项呈报）。
- curio_interact_controller 秘宝卡片文案表值化：kind 硬编码映射拆除，读行 desc——13 件 desc
  补齐（措辞按现行卡片文本逐字迁移；掘进蓄能/失义件补实际摘要=文案微调呈报级）。
- schema 适配：triggers 与 effect_kinds 互斥校验收窄至 passive 行（active_charged 双形合法=
  effect_kinds 主动分发+triggers 受理闸）；trigger 行豁免「非 N 值 kind magnitude 应 0」与
  「非 ap_rounds_front 行 effective_rounds 应 0」两面（行字段=value_from 取数源）。

T5 令牌/树收尾：
- _apply_curio_pick match 收敛进效果类型：属性值提升四类（attack/max_hp/armor/ap）改
  adventure_table.CURIO_APPLY_ROUTES 声明路由（加算落点键，与效果引擎加法族同构）——加新加算类
  令牌=表行+配额/件值键零代码；gp/heal/refresh/relic 副作用通道面显式分支保留。
- meta_tree 规则键同面：先手压制/稳健拓荒两键已在 T3/T4 随 round_start/damage_taken 订阅行
  走效果引擎同面（rebuild 合成订阅+发射点施加），旧直调零残留。

验证：冒烟 800 项 0 失败（三闸过）· 单元 17 套全绿。

设计权威：design/research/研究-内容数据驱动扩展架构-2026-10-06.md（案乙）。
任务书：design/research/任务书-内容数据驱动扩展批-2026-10-06.md §六 T4/T5、§五映射表秘宝侧。
 2026-10-06 23:54:58 +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 5294b12efa 秘宝批T3组F：aux_item域串16处→treasure_item+TREASURE_ITEM_TYPE常量族+reward_dangling_treasure诊断码（任务书漏计的常量消费方4处自查补齐，冒烟755/0） 2026-10-05 08:27:16 +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 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 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 ac3cee7daa MC-1 商店独立刷新机制（UI落码第三波收官核心批）——level_runner新增shop_refresh/free_left/cost三面(GP扣费+货架整架重抽shop_draw同签+付费计数进离清零)+adventure_table三旋钮(免费0/基价20/曲线1.8 provisional)+shop_overlay刷新钮转正(set_refresh_display投喂面)+presenter on_shop_refresh+main接线+冒烟5断言(752/0)+关卡节点地图v1.6换代+冒险结构v0.15回写。机制=P-C2+Q2裁(基础免费0/天赋增益位预留/GP ceil(20×1.8^n)/池源同源)。闸=冒烟752/0+probe_gate全绿+layout 0 2026-10-05 03:51:10 +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 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 d1460327a4 T5 core/data结构段: config_db拆R1解析器+跨表校验器两类（门面38消费方签名零变化）+三选一双渠道参数化（_apply_bonus_pick共享/守卫收AuxItems.can_accept/替换子交互保守分轨注记）+rest回血单点+行主序键单点+魔法数结构化（bonus_candidate_count默认3/出生区9/数量域常量——值零改动）+level_runner Phase enum（外部读面零变化）+表访问收口（aux走访问器/行集直扫三处收口/删clamped_pool壳与死变量erow/_minesweeper_ref包装）+tune_sim反向依赖解除（构造注入缺省null兜底）+类型注批量；闸=冲烟636/0+run_all 15套+探针全绿+MC对拍200局逐位一致 2026-10-02 08:46:12 +08:00
DKChan 71502ceecd iter10 T3-T9: 奖励重构实装——adventure表扩列(回血20/池六种/权重/上限/同调位过渡键)+boss_keystone重锚3-2+rng扩签reward_pick+E-S加权洗牌+三选一停点(零自动推进/可中断)+加算区四轴AP(BattleOrchestrator排队兑现)+钥石逐杀掉落(收束无二次派生)+同调位约束(停点替换两路/战斗沉没/节点拒绝)+BonusPickOverlay+Narrator文案族+save v3迁移+冒烟619/0(+23断言)+断点P5往返单测+run_all 15套全绿 2026-10-01 04:30:13 +08:00
DKChan 104cea6461 fix(review-batch3): 类型收紧生产清零137处(P1-2三步+延伸)+autoload class_name(ConfigDb/RngServiceCore)与_init标注(P2-1)+validate_skill_pool_links/ShopTable标注(P2-4)+相位enum外String面(P2-2)+typed-rows探针实证.tres装载转换；smoke缝合20处rows.assign+str(bb)同语义；审计生产双归零(240→103/83→59全测试链)，单测7套绿，冒烟576/0同基线 2026-09-29 07:01:29 +08:00
DKChan 13f93c74ff chore(structure): 垂直切片转正——prototypes/dungeon-sweeper-vertical-slice 迁为 game/，26 文件路径同步（CLAUDE.md/tools×4/tests×3/QA脚本×3/GDD×6/架构文档），static_scan S1/S2+S4 规则集首跑收敛（用户拍板 2026-09-24，台账 148） 2026-09-24 04:02:21 +08:00