  joywayerandClaude Opus 5
|
a119ec9ab1
|
docs(arch): 补删 ProjectileDef.reset() 里遗留的 homing_force 赋值
上一提交删了声明与注释、漏了 31 行后 reset() 内的赋值，
导致同一代码块自相矛盾（注释声明该字段不存在，正文仍在赋值）。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-07-30 17:47:56 +08:00 |
|
|
joywayerandClaude Opus 5
|
3e45ef0059
|
docs: 计划回填实际执行的验收脚本 + 订正权威文档自相矛盾处 + 性能数字改区间
【计划 Task 4】原稿四个脚本有缺陷，照它复跑会得到假失败与空通过，现已替换为
实际执行并通过的版本，每处旁注「原脚本为何有缺陷」，并勾上完成的复选框：
- Step 2 敌人摆位 (400,200) 距原点 447px 已出 homing_range=400，实测 FAILS=1；
这是测试摆位错误而非实现缺陷（精确距离过滤行为正确）。改到 (300,150)。
- Step 6 内联复刻了折叠逻辑与商店谓词——在测自己；改调真实 _apply_modifier
与 ShopManager._available_pool()，另补 compile_wand→execute_compiled 端到端。
- Step 7 无墙钟起搏，40 帧全停在退避窗内、守卫沦为空断言；且几何让子弹直穿
敌人簇，多计约 1.5ms 碰撞开销。改为 60fps 起搏 + spec §5.2 环形摆位，
frame1 与稳态峰值分开报。
- Step 8 只对源码 grep 字符串，不是往返；改为真实实例化 spell_tab 对真实
spells.json 做 8 条 type-1 的回读→写回比对。
回溯表补「观测方式」列，标出⑥是唯一一条状态推断而非直接观测。
【architecture_design.md】同一文档内自相矛盾：
- CastStats 块 homing_force（「归航强度，向最近敌人偏转」）与 §4.2 新写的
「最大转向角速度 + 锁定式目标」冲突 → 订正为 homing_add(弧度/秒)；
顺带订正确证过的 pierce_add / bounce_add（原写 *_count）。该块其余字段
仍有既有漂移，加 ⚠️ 注明未核对、以 cast_stats.gd 为准，不扩大改动范围。
- ProjectileDef 的 homing_force 删除——projectile_def.gd 无任何 homing 字段，
归航冷数据由 _push_projectile 直接写入 BulletManager。
- §4.2 bounce 协同散文补上实际存在的 if cold.has("homing_strength") 前置守卫。
- get_nearest_pos 代码片段：_enemy_count → _active_count（前者不存在）、
未命中返回值 Vector2.ZERO → origin、删除不存在的 _visible_flags 过滤。
【spec】
- §4 第⑥条措辞「不触发 query_circle」字面为假（_check_collision 每帧无条件
发一次），改为「不因归航触发」，并写明这是唯一一条间接验证及其封闭性论证。
- §5.5 峰值改为区间表述（① 4~5ms / ② 5~7ms @1500），注明编辑器/调试构建、
运行间离散（同场景三次得 5.61/5.09/7.29ms），判定回归看是否出现周期性复发
尖峰与是否越过 16.67ms，勿拿单值比对；并记录几何对测量的影响。
- §5.4 勘误：「1493 个互异到期值」不可能成立（jitter 只能产出约 200 个整数值，
同帧失败又共用同一 now），复测为跨度 223ms / 222 个互异值，结论不变。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-07-30 17:33:16 +08:00 |
|
|
joywayerandClaude Opus 5
|
14136b1223
|
docs: 退役 P6-N2/P6-N25 并订正 §4.2 归航设计——删除快照的连带订正
E1-③ 归航实现删除了 _enemy_pos_snapshot 与 EnemyManager.fill_pos_snapshot
（锁定式目标需 entity_id，快照按槽位存位置不含 id），权威文档随之失准，一并订正：
- docs/README.md：P6-N25（快照须为类成员）与 P6-N2（Homing 弹共用快照）双双失去
约束对象，改为删除线 + ⚠️ 已退役(2026-07-30) 并指向 spec §2.4/§2.7。不删条目，
避免编号规范留下悬空引用。
- architecture_design.md §4.2：homing 伪代码整段改写为实际算法——冷数据
homing_strength(弧度/秒)/homing_range/homing_target_id、发射不解析目标首帧惰性
锁定、仅目标失效时经 _find_nearest_unvisited 重选、wrapf 最短转向 + clampf 限
角速度 + rotated() 保速率、空场守卫、失败退避+抖动、bounce 协同改写目标并撤销
退避键。性能数字一律指向 spec §5，不另起一套。
- 冷数据字段表 homing_force → homing_strength/homing_range/homing_target_id。
- EnemyManager API：fill_pos_snapshot 换成实际存在的 get_pos_by_id（含哨兵约定）；
get_nearest_pos 与自动瞄准改为「直接扫描 SoA」，原文称与 homing 快照共用属误述。
- S0 性能表 EnemyManagerCs 行标注该实测含已删除的 fill_pos_snapshot（保留历史数字）。
- MinionManager.fill_pos_snapshot 标注为未实现提案，并纠正其「供 homing 用」的注释。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-07-30 17:01:56 +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 |
|
|
joywayer
|
7bcc0026e0
|
初次提交
|
2026-07-20 10:56:52 +08:00 |
|