Files
spellforge/docs_dev
joywayerandClaude Opus 5 f86d6cd20e docs(plan): 记录 CACHE_MODE_IGNORE 为验证 class_name 脚本的首选手段 + 加回填步骤
Task 1 实测发现:改完源码后经全局类名直调会拿到**过时结果**(返回修复前的
数值),是假通过陷阱——编辑器持有的已编译类是旧的。正确手段是
ResourceLoader.load(path, "GDScript", CACHE_MODE_IGNORE),它保留 class_name
原样且走引擎自己的编译器,故顺带证明静态类型标注真能被引擎编译。

另记 var x := <Variant 方法调用> 在 4.7.1 是无行号的编译错误而非警告。

新增 Task5 Step8:回填计划为实际执行版并勾复选框——归航那期踩过
「计划里留着过时代码和失效断言」的坑。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-31 11:04:44 +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/ 下。