joywayerandClaude Opus 5
3e45ef0059
【计划 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>
docs_dev —— 开发过程 / 归档文档
本目录存放开发过程中产生的计划、追踪与历史归档类文档，与
docs/（面向产品的设计规范与架构参考）区分开。产品文档索引见
../docs/README.md。
| 文档 | 类型 | 内容简述 |
|---|---|---|
| doc_code_audit_2026-07-20.md | 审计 | 文档 vs 代码交叉审计：三大结构性分歧、更优/偏离/未实现分类清单、潜在 bug、文档内部矛盾（2026-07-20） |
| 2026-07-23-native-migration-notes.md | 笔记 / 迁移备忘 | ① GDScript 陷阱：PackedArray 返回值是活引用别名，复用缓冲会被重入覆写（query_circle 优化翻车教训）；② C#/C++ 激活期接缝一致性项：SpatialGridCs 常量对齐（已修）、EnemyManager 原型字典需 C# 侧自建原生数组（待办·迁移期） |
| development_plan.md | 计划 / 追踪 | S0–S6 骨架垂直切片开发计划、技术风险登记表、各切片验收与出口检查、P-S* 任务勾选 |
| certification_checklist.md | 计划 / 追踪 | Steam / Nintendo Switch 平台发行认证清单，映射到对应切片，含状态列 |
| archived_cocos_architecture_draft.md | 归档（已废弃） | 早期基于 Cocos Creator 3.x / TypeScript 的架构草案。项目已迁移至 Godot 4.6，权威架构见 ../docs/technical/architecture_design.md |
说明：这些文档中以文件名（如
architecture_design.md §4.5）方式引用的权威架构/实现文档，均位于../docs/technical/下。