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