Files
spellforge/docs_dev
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
..

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/ 下。