game-group/game-code-4
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
9 Commits 1 Branch 0 Tags
main
Commit Graph
9 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
程基岩（engineering-lead） 42aff596f7 W5 收尾：文档同步+W6 备忘 — #13 方案 A 代码侧同步（RESTART_TARGETS/tune_restart_curve/gates 注释/测试断言改 1:0.48:0.42:0.40），门 #13 restart.pass=true R1-R4 全入带；架构文档 §4.2 宿慧公式注释+目录树补 meta_upgrades；CLAUDE.md 新增文档落点规则 §9.7；test_runner 752 检查 8/8
CI / data-gate（schema v0 数据门） (push) Canceled after 0s
Details
2026-10-21 18:48:19 +08:00
程基岩（engineering-lead） c0a5c52cb7 W5: sim一轮裁定落地+二轮校准 — 冤煞独立表(wrath_layers 22行)/宿慧渐近封顶F-1/跳过钳制F-2/验收门#2#3#10#13#14修订；二轮4/5 FAIL转PASS，#13 R4残留0.396(带外0.021)，硬门#5#10不回归，红线9.5e15→7.007B，test_runner 750检查8/8用例 2026-10-21 17:41:21 +08:00
程基岩（engineering-lead） c534e95458 fix: 首跑错误批次（Godot 4.7.2 引擎实证修复 R1-R14） 
本机首次具备引擎自验证能力后的首跑修复。四条命令 + 主场景 180 帧全绿：
- --import exit=0（漂移门 git diff data/build 空）
- --validate-only exit=0 RESULT: PASS
- test_runner exit=0 PASS（584 检查，8/8 用例）
- sim_main exit=0（报告落 tests/sim_reports/report-2026-10-20.json）
- 主场景 --quit-after 180 exit=0 零 ERROR/WARNING（F5 可玩）

预定位错误（team-lead 清单）：
- R1 economy_state.gd:596 enthone_ready -> enthrone_ready（单点故障连锁）
- R2 hud_root.gd:142,160 HorizontalAlignment.LEFT -> HORIZONTAL_ALIGNMENT_LEFT
- R3 boss_arena.gd 补 var _pending_hall_index := -1
- R4 hall_band_world.gd:95 删 "_ = ext"（非法语句；--check-only 定位）
- R5 sheet_importer._type_ok 补 object->Dictionary / array->Array（9 条假违规）
- R6 game_state.gd econ==null 防护（防 autoload 崩每帧刷错打满管道挂死）

引擎新暴露错误：
- R7 prestige_model floor() Variant 推断（4.7.2 按错误）连锁编译失败
- R8 gates.gd var pass 保留字；R9 %g/%.*f 格式符 ×6 处
- R10 greedy.gd Dictionary.get() 推断；R11 probe_p1 条件表达式推断
- R12 测试用例 data 参数统一标 BalanceData（无类型参数成员调用返 Variant）
- R13 boss_battle 用例 Dictionary 下标运算显式 float 化
- R14 band_world_root.compute_ranges 返回 Array[Vector2]（类型化数组不隐式转换）

测试侧数值修正（根因已核实，实现符合设计）：
- gen3 可购断言 merit 1000->2000（800 文书 + 1200 首购）
- 开场伤害断言改"循环至 ACTIVE 即停"（INTRO 结束 tick 不计军列伤）
- 容量断言预算 30->34s（战斗真实给 intro 3s + active 30s）

工程加固：
- EconomyState 红线守卫首次越线才报（sim 长跑日志 6.5MB->1KB）
- stage_world.gd stretch=false（SubViewport 手动尺寸驱动生效）

知识缺口登记：docs/engineering/2026-10-20-f-engine-first-run-notes.md
sim 首轮数据：主口径 11/14 过（#2/#3/#12/#13/#14 FAIL 待文策渊裁定）
 2026-10-20 18:47:07 +08:00
程基岩（engineering-lead） cdec918a5b W4 首跑包：first_run.bat 一键 headless 校验 + README Quick start + logs/ 忽略 
- first_run.bat（纯 ASCII / CRLF）：GODOT_EXE 顶部可覆写；where godot + 5 条便携路径探测；四步 headless（import / schema-validate / 单测 8 用例 / sim 门）；任一步失败不中断，末尾汇总表 + logs\first_run.log 合并日志；双击运行自动 pause；已用 stub godot 实测三条路径（全 PASS / 全 FAIL / not found）

- README.md：顶部 Quick start（首跑）3 行指向 first_run.bat 与首跑指南；.gitignore 增加 logs/
 2026-10-20 17:45:10 +08:00
程基岩（engineering-lead） 08dc5020c3 W4 批次：三项设计裁定落地（Boss 战 Plan B / 离线契约 v2 / 长明灯加法化） 
Boss 战修复（Plan B，用户拍板）：
- HP 公式 15xPxhall_factor -> HP = P x boss_army_seconds_n（S=23.0→28.0 递增，
  每场军列约 23-28 秒清空，战斗时长成为可直接书写的设计旋钮，结构性消除
  高殿 P 抵消导致不可胜的旧 bug）；hall_factor 降级为纯叙事/视觉参数
- 新增 souls_par 列（0→90000）：开场冲锋 intro_dmg = HP x 10% x clamp(souls/souls_par,0,1)，
  上限 20%->10%；删 hp_factor/intro_dmg_souls_factor/intro_dmg_cap_ratio 三列
- 点击伤害 P x κ x combo_mult，κ = (0.010 + 0.052 x click_ratio) x (1 + 0.30 x m06_owned)，
  click_ratio = 已购点击升级 / 12（κ 0.010→0.0806，满配点击占比约 20.5%±3pp）
- 防双重计入：L5-12 点击升级 +1% output/s 留全局区（抬 P 同时抬军列 DPS 与点击
  伤害，可接受），不得再计入 κ 分子（recompute 注释固化）

离线契约 v2（P-8，改契约不改表）：
- OfflineModel.settle 第三参 offline_mult -> offline_add（加法）；各档效率
  min(rate+add, 1.0) 硬顶 100%，离线永不超在线
- 长明灯 x1.15 乘性 -> +5%/级 加法（满级 +30%，各档封顶 100%）
- 0-2h 100% 保持；8h = 6.2 等效小时（77.5% 效率）
- Gate #9 拆 9a/9b/9c：9a FAIL->PASS（0-2h 全额 + 8h∈[5.5,6.5]），
  9b 长明灯满级 8h∈[7.5,8.0] 且 ≤100%，9c 任意配置效率 ≤100%

数据与工具：
- gen_balance_sheets.py 补登 W3 遗留 7 行 tune（防重跑静默丢失），self_check 更新
- boss_battles/upgrades schema 同步（offline_mult->offline_add enum，漏改会违反导入）

测试（runner 7->8 用例，Node 交叉验证 145 断言全过）：
- 可胜性哨兵重写为「十殿全可胜」：每殿 S_n<30、军列+点击≥HP、余时∈[2,8]、
  满配余时差≥4、点击占比∈[15,25]、H10≈20.5%±3pp
- κ 四档断言（0.010/0.036/0.062/0.0806，分母 12）
- 新增 test_offline_contract.gd：契约 v2 数值面 + 9a/9b/9c 全 PASS + β 缓议
 2026-10-20 17:01:25 +08:00
程基岩（engineering-lead） 4f650aeb39 W3：相机 rig + band 组装器 + 事件系统 + 殿王战（灰盒）；ADR-5 落定 
P0 文档
- 架构文档：殿王战 HP 系数 50× → 15×（Balance Bible [B§5] 口径），全文档无残留
- 新增 ADR-5：2D 骨骼动画（Spine）取代 ADR-1 的单位/殿王 billboard 条目
  * 背景/决策/后果/三项被否决方案（多帧 billboard、Skeleton2D、DragonBones）
  * Godot 4.7 接入方式标注"需立项时复核"，不臆造 API；挂探针 P12
  * 资产规格约束：部件分离 PNG / 图集 / 锚点命名 / 动画命名 / AI 绑骨质检门槛
  * 数据行纪律影响：sprite_row → 动画资源路径行，坚持"新资产 = 加行"
  * 美术工时对照（pipeline 报告 115-185h）
  * 3D 特效落地约定：走 flipbook 序列帧，理由是 3D 粒子直塞 2D 会绕过单趟
    后处理（ADR-2 红线）导致风格撕裂；挂探针 P13
- ADR-1 标注"单位/殿王条目被 ADR-5 取代"，降级为回退规格（§5.1 保留）
- 架构 §8 清单 / §11 探针表 / 【确定】【探针】标注段同步；CLAUDE.md ADR 节同步

P1 横版核心
- camera.csv（10 行，一行一殿）+ camera.schema.json + core/data/camera_def.gd
  * 独立成表的四条理由写入 schema description，不污染 halls.csv
  * 全局标量（弹簧刚度/阻尼/平滑 tau/偷看上限/战前预告分钟）进 balance_tuning.csv
- presentation/stage：camera_rig.gd（进度锚定 + 偷看回弹 + 殿王战推近）
  + hall_band_world.gd + band_world_root.gd（四层视差）+ stage_world.gd
- stage_root 接入横版舞台，取代 W2 十殿色带（hall_band.gd 保留作回退）

P2 玩法系统
- game/event_director.gd：events.csv 四事件 → 触发/持续/效果/二选一/失败哗变
  * 效果全走 EconomyState 既有 API（瞬时区 set_event_mult / set_event_click_mult /
    set_mutiny），不直接改字段；四个出口统一 _clear_runtime 防"漏清永久 ×N"
- game/boss_battle.gd：30s 状态机（INTRO/ACTIVE/RESOLVED）
  * HP = 15 × 进入时产出/s × 殿系数(1.0→2.2)，连击 +2%/层封顶 +60%
  * 胜 = 阴德爆发 HP×0.2（进本轮累计口径）；败 = 60s 冷却（购路引可消）
  * 不用随机数 → sim 门 #11 可直接复用
- EconomyState 接事件瞬时区与哗变惩罚；GameState 接线 + 快照扩展
- presentation：event_panel.gd（事件卡/二选一）+ boss_arena.gd
  （预告/HP/连击/倒计时/结算/再战）；stage_root 布局接入
- debug 构建 dev 热键 F1-F6/F9，走 GameState 既有命令口，不改数值

P3 质量
- 新增 3 个用例：test_camera_data / test_event_director / test_boss_battle
  （进 test_runner.CASE_FILES，共 7 个用例文件）
- 用户验证手册：docs/engineering/2026-10-19-w3-verification-manual.md（文档区）

修掉的两个潜伏缺陷（从根因修，非打补丁）
- gen_balance_sheets.py：halls.is_prestige_gate 落成字符串 "false"，
  Godot 的 bool("false") == true → 十殿会被全部判为 prestige gate。
  改为真布尔，并把自检查从 == "true" 收紧为 is True（再犯即断言失败）
- boss_battles.schema.json：hp_factor 漏 type，GDScript SheetImporter 会产出
  字符串 "15"（Python 生成器产出的是数字），两条路径不一致。补 type: number

上报（未擅自改动，等裁定）
- H9/H10 殿王战数学上不可胜：纯军列耗时 = 15 × 殿系数（与产出/s 无关），
  殿系数 >2.0 → 31.5s/33.0s > 30s 限时；而缺口 ∝ 产出/s，点击伤害是常数
  （上限 25.6，不随产出/s 增长）→ 玩家越强越打不过，难度曲线是反的。
  已在 test_boss_battle._test_winnability_doc 把当前事实钉成断言哨兵，
  一旦有人改 hall_factor/active_sec/hp_factor 立刻变红强制重评。修数权属文策渊。

本机验证（无 Godot，靠移植仿真，非代替引擎实跑）
- 把 CameraDef/BossBattle/EventDirector 逐行移植成 JS 喂真实 build JSON，
  134 条断言全绿；9 张表 schema 校验通过且 build 逐字节一致（含新增 camera）
- 静态检查：跨文件方法/字段引用审计、静态调用合法性、src/core 禁 extends Node、
  缩进/括号配平/空函数体 —— 全部 0 问题
- 待本机验证：全部 GDScript 从未被引擎执行过；SubViewport 舞台与 Camera2D
  在 gl_compatibility 下的行为未实测（探针 P12 范畴）
 2026-10-20 01:39:14 +08:00
程基岩（engineering-lead） 422dda6394 docs: 参考模板决策（三份只读参照，不套基底）+ 项目迁址 D 盘 2026-10-20 00:16:23 +08:00
程基岩（engineering-lead） 24e5b0c4cc feat: W2 经济核心+数据管线+灰盒 — Balance Bible v1.0 八表逐值落地，EconomyState/sim 14 门/灰盒主场景/单测（GDScript 待本机引擎验证） 2026-10-19 17:44:53 +08:00
程基岩（engineering-lead） 856326a766 chore: W1 项目骨架 — 基线 v1.0 架构落盘（Godot 4.7.2 / gl_compatibility） 
架构基线：docs/architecture/2026-10-19-F-architecture.md（v1.0）
范围：WRATH OF THE DEAD《怨返》单人挂机 · GDScript · 1280×720 · 12 班底数据驱动

- 骨架：project.godot（4.7 + GL Compatibility）、架构 §2.1 完整目录树（含占位说明）、
  .gitignore/.gitattributes（LF 纪律）、README.md、CLAUDE.md、export_presets.cfg 占位、
  pipeline/README.md（3ds Max 侧契约）
- 数据管线段 1：data/sheets/generators.csv（GDD §3.1 十二班底逐值抄录）
  + data/schema/generators.schema.json（v0）+ src/tools/sheet_importer.gd
  （import_all/import_sheet/validate + ImportReport + .tres stub + 行号/列名/原因失败策略）
  + src/tools/import_main.gd（CI CLI 入口）+ data/build/generators.json（字节级确定性产物）
- 探针：P1（SCREEN_TEXTURE/CanvasLayer 排序）与 P3（NoiseTexture2D seamless）场景代码与
  截图/统计工具；实测手册与结论模板在工作区 docs/engineering/（随仓库外文档树）
- CI：数据门激活（import_all + schema validate + build 漂移门）；单测/sim/导出 W3+ 注释占位；
  4.7.2 headless CLI 行为标注待本机验证

待用户侧：P1/P3 实测回填结论；P6 字体许可 / P7 GPU 实测；look-dev 游魂初版（Max 侧）
 2026-10-19 15:13:10 +08:00