joywaygamess/spellforge
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
147 Commits 1 Branch 0 Tags
4b09cd10648b0a713dbae431f2d00cdc6a41c820
Commit Graph
44 Commits
Author SHA1 Message Date
joywayerandClaude Opus 5 d498097005 docs(roadmap): E1-③ 子弹归航完成，勾除现状项 + 记录快照删除这一有意偏离 
「现状」归航行与切分列表第 3 项改为完成态，格式对齐已完成的 ①②。
显式记录与本文档原方案的偏离：未消费 _enemy_pos_snapshot 而是删除之 ——
锁定式目标需 entity_id，而快照按槽位存位置、不含 id，结构上支撑不了该语义。
另记退避 + 抖动这一同期落地的性能措施（详见 spec §5）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-30 16:54:13 +08:00
joywayerandClaude Opus 5 ffc75acead docs(spec): §5.6 触发条件改为弹数阈值 + 新增 §5.7 退避墙钟不免疫时间缩放 
§5.6：把重新立项的触发条件从场景描述改为可直接计算的弹数阈值 —— 成本严格线性于
「同帧创建且首次选目标全部失败的归航弹数」约 9.5µs/颗，附 200/500/1000/1750 颗的
对照表，约 1750 颗为理论击穿点（MAX_BULLETS=2048 故容量内可达）。并注明 visited
类场景因 visited_targets 线性扫描，实测高于线性外推，实际击穿点更低。

§5.7 新增潜在项（休眠，不修）：退避基于 Time.get_ticks_msec() 是墙钟，不受
Engine.time_scale 影响，而 TimeManager 正是为慢动作/冻结时间 Core 驱动 time_scale 的。
grep 确认 set_time_scale 当前零调用方，故今日无害；若落地 0.2× 慢动作，200ms 只跨
约 2.4 个物理帧而非 12，抖动摊薄失效，且表现为慢动作期间掉帧。
记录替代方案（触发时再实施）：改用物理帧计数 HOMING_RETRY_FRAMES=12，免疫时间缩放、
略便宜、消除 ms↔帧量纲错配；项目已有现成的 TimeManager.game_tick 且注释明写不受
time_scale 影响，正合用。触发条件为 set_time_scale 出现第一个调用方。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-30 16:26:36 +08:00
joywayerandClaude Opus 5 4ef8012b6e docs: 首帧锁定尖峰决策为「接受」+ Task4 Step7 改为两场景单帧峰值回归守卫 
spec §5.6：残余的首帧尖峰（1500 弹同帧创建且首次选目标全失败时 16~22ms）
决策接受不处理——触发条件是三个苛刻条件的合取属合成最坏情况、一次性不复发、
压下它需牺牲「首次锁定即时」的手感或改变归航/bounce 语义。附重新立项触发条件。

plan Task4 Step7：原只测「敌人全在射程外」，补上评审发现的更严重场景
「射程内全在 visited」（visited 只增不减故为永久状态）；指标由 60 帧均值
改为单帧峰值——退避把成本摊成 1 重选帧 + 11 退避帧，均值会掩盖尖峰，
而帧预算 16.67ms 下尖峰才是玩家可见的。性质由决策关卡降级为回归守卫。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-30 16:15:01 +08:00
joywayerandClaude Opus 5 5cc40e72e8 docs(spec): §5 补「朴素退避会同步而非打散」二次发现 + 抖动方案 + 单帧峰值对比 
新增 §5.4「二次发现」：固定退避下尖峰每 12 帧复发（附逐帧耗时序列证据），
根因是同帧失败的子弹到期时刻相同、被退避锁进同相；这与「退避能摊薄尖峰」的
直觉相反，且摊薄均值会掩盖它 —— 后来人写类似退避/重试逻辑会踩同一个坑，故写清。
含抖动实现、为何用占比式而非 bullet_idx % 窗口宽度、HOMING_RETRY_MS 一值两用的理由。

§5.5 抖动前后单帧峰值对比表（稳态峰值全部回到帧预算内，超预算帧数 0/39）。
§5.6 记录残余：初次锁定帧（1500 弹 16.2/22.0ms）非退避问题，而是「首次锁定即时」
手感属性的直接结果，压下它需牺牲手感，属设计决策，未擅自处理。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-30 16:13:00 +08:00
joywayerandClaude Opus 5 3bf04c9fc0 docs(spec): R-H1 由「暂不实现」改为「已实测触发并启用」，补两种病态状态实测数据 
如实记录：
- 原风险分析只预见「敌人全在射程外」，漏掉「射程内敌人全在 visited_targets 里」——
  后者经 bounce+homing 组合是该子弹的永久状态而非瞬态，且成本更高，是本次发现；
  原文把 R-H1 定性为瞬态尖峰不准确。
- 实测两种场景在 300 弹规模已达 3.14 / 4.34 ms，越过本节自定的 2.0 ms 触发线，
  故方案 3（0.2s 退避）随 Task 2 落地，摊薄约 12×。
- 残余未收敛项另立 §5.4：1500 弹摊薄后仍 3.9 / 4.5 ms，且退避会使同波齐射的
  子弹同步重试、留下 15.9 / 22.2 ms 单帧尖峰；错帧方案待决策，本次未擅自扩大范围。
§2.4 补一句指向 §5，避免「一生只查 1–2 次」与失败路径重试自相矛盾。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-30 16:04:03 +08:00
joywayerandClaude Opus 5 364ebe4c62 docs(plan): E1-③ 子弹归航逐任务实现计划（5 任务 · 含 wrapf 跨 ±π 判据与 R-H1 性能守卫） 
Task0 建分支 / Task1 法术 VM 侧 / Task2 bullet_manager 转向+删死快照 /
Task3 设计器字段（含补漏的 bounce）/ Task4 MCP 运行时验收。

验收脚本全部用确定性数值断言：单帧转角上限、速率守恒、跨 ±π 的最短转向
（该摆位下有无 wrapf 会给出符号相反的结果，是有效判据）、目标失效重选、
空场直行、bounce 协同改写 homing_target_id、两层折叠 6.0。

Task4 Step7 实测 spec R-H1 病态场景（50 敌全在射程外 + 300 归航弹），
超 2ms/帧则按 spec §5 启用失败退避逃生方案。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-30 13:51:18 +08:00
joywayerandClaude Opus 5 049d1dda1b docs(spec): E1-③ 子弹归航设计——受限角速度中度制导 + 锁定式目标 + 删除无人消费的位置快照 
手感定位为中度制导：homing_strength 即最大转向角速度(rad/s)，
单层词条 3.0（350 速度下转弯半径 117px），rotated() 保持速率不变。

目标策略为发射后锁定，仅在目标死亡(get_pos_by_id 返回哨兵)或首帧时
经 _find_nearest_unvisited 重选，配 get_active_count()==0 空场守卫，
避免 query_circle(r=400, 约196格且每次新建数组)进入每帧热路径。

与 bounce 协同：bounce 命中重定向时改写 homing_target_id，
由 bounce 选目标、homing 追上去；复用 visited 过滤规避"绕已命中敌打转"死循环。

偏离路线图原文：锁定语义需 entity_id，而 _enemy_pos_snapshot 按槽位存位置
不含 id，无法支撑，故快照连同 EnemyManager.fill_pos_snapshot 一并删除
（全项目唯一调用方），净减每帧 O(敌人数) 开销。

顺带补设计器 MODIFIER schema 遗漏的 bounce 字段（现掉在 JSON 逃生舱里）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-30 13:36:42 +08:00
joywayerandClaude Opus 4.8 04e8cf9c09 docs(spec): 明确 bounce+pierce 组合语义——visited 持续使每敌至多命中一次（刻意，非bug） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-24 15:28:31 +08:00
joywayerandClaude Opus 4.8 bf9bea78d8 docs(roadmap): E1-② 子弹弹跳完成，勾除现状项 + 修正 Step3 为确定性速度判据 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-24 15:21:26 +08:00
joywayer e5cf6089ed docs(spec): 弹跳补充——命中循环跳过已访问敌人(防密集群重复命中) 2026-07-24 14:56:49 +08:00
joywayer 9403f80aa4 docs(plan): E1-② 子弹弹跳逐任务实现计划（3 任务·含密集群跳过已访问·SpatialGrid.insert 实测） 2026-07-24 14:56:37 +08:00
joywayerandClaude Opus 4.8 4a86ffb2c4 docs(spec): E1-② 子弹弹跳设计——镜像 pierce 管线 + 命中弹向最近未命中敌+伤害递减 
缺失功能路线图 E1 子计划②。冷数据 bounce_remaining/visited_targets/decay/range；
CastStats.bounce_add + _apply_modifier 折叠 + _push_projectile 写 cold（含分支快照）；
_check_collision 弹跳分支(bounce优先于pierce)+_find_nearest_unvisited；modifier_bounce 词条。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-24 14:44:53 +08:00
joywayerandClaude Opus 4.8 cd5f4d5892 docs(roadmap): E1-① 元素抗性完成，勾除现状项（含 DOT 抗性已知限制→E2） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-24 12:12:32 +08:00
joywayer abe057edf8 docs(plan): E1-① 元素抗性逐任务实现计划（3 任务 · lambda-MCP 实测） 2026-07-24 11:49:51 +08:00
joywayerandClaude Opus 4.8 e87e453abf docs(spec): E1-① 元素抗性设计——apply_damage_from_context 查表 + enemies.json resistances + 弱点(负抗) 
缺失功能路线图 E1 子计划①。元素链路已通，仅补敌人抗性数据+命中查表：
enemies.json 每型可选 resistances{元素名:-0.9~0.9}，EnemyManager 按 ctx.damage_type
查表传入 calc_damage(0,res)；护甲不动；物理无抗性；设计器加抗性网格。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-24 11:45:28 +08:00
joywayerandClaude Opus 4.8 83dc1196ae docs(roadmap): E6-a 玩家无敌帧完成，勾除现状项 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-24 09:32:02 +08:00
joywayer c756423d57 docs(plan): E6-a 玩家无敌帧逐任务实现计划（5 任务 · TDD-MCP 实测） 2026-07-24 09:11:33 +08:00
joywayerandClaude Opus 4.8 383791db14 docs(spec): E6-a 玩家无敌帧设计——take_damage 单点门控 + 复活 hurt 反馈 + 数据驱动时长 
缺失功能路线图 E6-a 先行小项。受击后 0.5s 无敌窗口（时间戳门控，
杜绝多弹同帧连扣血）；顺带复活当前死代码的 PLAYER_DAMAGED emit 与
hurt 音效；spend_hp_cost 自伤不受影响；时长入 balance.json + 设计器。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-24 09:08:04 +08:00
joywayerandClaude Opus 4.8 1215b08e88 docs(dev): 新增原生迁移笔记——GDScript 别名陷阱 + C#/C++ 激活期接缝一致性项 
沉淀两类内容并登记 docs_dev 索引：
① GDScript 陷阱：PackedArray 返回值是活引用别名（非 CoW 副本），复用成员缓冲后 return
   会被调用方遍历期间的嵌套调用就地覆写（query_circle 复用优化翻车、已回退的教训），
   附实测证据 + 通用规则（默认每次新建；省分配用 out 参数+各调用点独立缓冲）。
② C#/C++ 激活期接缝一致性项：SpatialGridCs 网格常量已对齐（已修）；
   EnemyManager 原型字典 _SPEED/_ARMOR 内循环逐敌查，迁移期须在 C# 侧从 enemies.json
   自建原生数组以守 ADR-L1 铁律(a)，现在不改（避免投机 churn）。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-23 16:38:55 +08:00
joywayerandClaude Opus 4.8 09b2e1dd1d docs(roadmap): 缺失功能路线图 —— 7 史诗分组+优先级+切分+验收（战斗深度/经济/循环/Boss深化 为 P0/P1） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-23 15:11:10 +08:00
joywayerandClaude Opus 4.8 fb90e13dd7 docs(plan): Boss 阶段+攻击模式系统实现计划（12 任务，MCP 运行时验证） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-23 09:39:25 +08:00
joywayerandClaude Opus 4.8 049e5930d6 docs(spec): Boss 招式增加近战 melee（原地近身范围打击） 
区别于 dash 横穿冲撞，melee 为原地劈砍/砸地：前摇预警→melee_radius
内判定扣血→后摇。同步更新范围/设计器 kind 列表/验证项。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-23 09:29:50 +08:00
joywayerandClaude Opus 4.8 7989d8d0fd docs(spec): Boss 阶段+弹幕/位移攻击模式系统设计 
阶段状态机 + 攻击模式注册表（环/扇/瞄准/旋转 + 冲刺/蓄力）+ 新建
EnemyBulletManager 敌方子弹 + 保留召唤援军 + 事件 29/30 + bosses.json
与设计器 Boss 分页。范围外：场地机制/通关演出/无敌帧/.tres。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-23 09:17:40 +08:00
joywayer 064b225e0b docs(designer): 修正计划 — 行编辑器成员变量不标注类型 2026-07-22 12:08:15 +08:00
joywayer 4fee708287 docs(designer): 整数元组列表编辑器实现计划 2026-07-22 12:05:56 +08:00
joywayer 0967b3f10b docs(designer): 整数元组列表编辑器设计（edges/aether 去 JSON） 2026-07-22 12:02:46 +08:00
joywayer 7b0843d8a9 docs(designer): UI 优化实现计划 2026-07-22 10:57:43 +08:00
joywayer 48d417d049 docs(designer): 既有双语标签归一为「中文 English」序 2026-07-22 10:54:14 +08:00
joywayer d95ed67e63 docs(designer): UI 优化设计（布局撑满 + 元素复选框 + 双语标签） 2026-07-22 10:39:52 +08:00
joywayer 1a86757a77 docs(spell-editor): 字段化表单实现计划 2026-07-21 16:00:14 +08:00
joywayer c7b6c9c0fa docs(spell-editor): 法术编辑器并入 game_designer + 字段化表单设计 2026-07-21 15:54:09 +08:00
joywayerandClaude Opus 4.8 ea01ff1939 docs: Mana 完整化实现计划（11 任务，MCP 运行时验证） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-21 15:03:35 +08:00
joywayerandClaude Opus 4.8 150ec7aa1c docs: Mana 完整化设计规范（递增蓝耗+infinite_spells+魔力虹吸+UI+平衡，待评审） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-21 14:21:35 +08:00
joywayerandClaude Opus 4.8 14c0709d74 docs: 元进展 MVP 实现计划（10 任务，MCP 运行时验证） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-21 11:35:44 +08:00
joywayerandClaude Opus 4.8 72543be204 docs(meta): 碎片奖励曲线改数据驱动(balance.json 阈值表)+编辑器可调（评审反馈） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-21 11:29:48 +08:00
joywayerandClaude Opus 4.8 fec2f34ce3 docs: 元进展 MVP（碎片+解锁树·法术only）设计规范（待评审） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-21 11:17:10 +08:00
joywayerandClaude Opus 4.8 022017e551 docs(mana): spec §2.4 记录 LOOP/CIRCUIT 也扣蓝（复审修复 8b9565e） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-20 16:44:11 +08:00
joywayer 06e993bea7 docs(mana): Mana 现状 callout 更新为已实现(MVP) 2026-07-20 16:34:58 +08:00
joywayerandClaude Opus 4.8 2d764532cf docs: Mana 精实 MVP 实现计划（8 任务，MCP 运行时验证） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-20 16:21:16 +08:00
joywayerandClaude Opus 4.8 39e05f1f9a docs: Mana 系统精实 MVP 设计规范（待评审） 
单一法杖蓝池 + 逐效果扣蓝 + 蓝空停施 + HUD 蓝条；数值取 numerical_design §2。
暂不做：递增蓝耗、infinite_spells 扣血、全局+法杖取Min、cast_delay 重构。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-20 16:05:06 +08:00
joywayerandClaude Opus 4.8 707e1269b7 fix: 商店防呆警告 Label 移出按钮行 + 记录 D5 端到端验收 
MCP 端到端验收 D5 时发现警告 Label 原位置 (120,448) 遮挡背包/语言/设置按钮行；
移至 (250,502) 商店按钮下方空白区，实测红字警告清晰可读、不遮挡。
端到端结果：纯 Modifier 卡组点『出发下一波』被拦截且波次不推进；含 ACTION 正常进入下一波。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-20 15:46:19 +08:00
joywayerandClaude Opus 4.8 ab6e3ce359 docs: 记录 3 个 bug 修复的 Godot 运行时验收结果 
经 godot-mcp-pro（Godot 4.6.2，0 编译错误）实测：
- D1 CoreFeatureTag：tags=1 持久 [0,0,1,0]，tags=3 碰撞 [0,0,0,0]（旧 & bug 会误得 [0,0,1,0]）
- D2 pierce：[pierce+2, spark_bolt] 子弹 pierce_remaining=2，对照组无误加
- D5 Deck 防呆：has_castable_action 四例正确，SHOP_NEED_ACTION 键解析正常

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-20 15:27:31 +08:00
joywayerandClaude Opus 4.8 5e3d80ad85 docs: 记录 3 个潜在 bug 的修复状态（对齐 dc05eea） 
- 审计报告 D 节 + G.2 表标注 D1/D2/D5 已修复（待运行时验收），修正 D1
  修复方案为「单选枚举 + ==」（复核发现设计器 core_tab 以下标写入 feature_tags，
  不宜改 2 的幂位标志）
- architecture_design ADR-R5-N2 与 core_wand §1 的现状 callout 同步更新为已修复

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-20 14:53:27 +08:00
joywayerandClaude Opus 4.8 ad2f4c0bc6 docs: 整理文档目录并对齐代码现状 
- 将开发过程/归档文档迁至 docs_dev/（development_plan、certification_checklist、
  已废弃的 Cocos 架构草案 archived_cocos_architecture_draft），并修正全部跨引用
- 新增根 README.md（项目介绍，暂定名 Spellforge）与 docs_dev/README.md 索引
- 新增 docs_dev/doc_code_audit_2026-07-20.md：文档 vs 代码交叉审计报告（经 6
  路对抗性复核，零证伪），含「代码更优 / 文档更优 / 中性」判定汇总
- 在 docs/ 各设计·技术·机制文档就地加「实现现状 (2026-07-20)」callout：
  追认代码更优实现（纯 JSON 数据驱动、SpatialGrid-only 碰撞、MultiMesh 单档、
  存档选最新槽等），订正陈旧/矛盾内容（.tres→JSON、Boss HP/阈值/波次、EventID、
  StatusManager.apply 签名等），标记未实现功能（C# 热路径、Mana、元进展、
  Boss 阶段/抗性、Tutorial、轨迹/连锁/催化等）与 latent bug（CoreFeatureTag 位运算、
  pierce 空操作、MAX_OPS 不读 cpu_limit）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-20 14:35:55 +08:00