MapLibreParticleLab 项目总则目录
定位
docs/00_项目总则/ 是本项目长期规则层（Source of Truth）。保存经用户与 GPT 确认的长期设计决策、开发环境、系统构建规范、Codex 协作规则、Step/执行报告规范，以及当前正式基线与路线。普通 Step 默认禁止修改本目录。
当前有效文件
粒子系统项目规则与设计决策_v1.md开发环境与系统构建规范_v1.mdStep指令书与执行报告规范_v1.md当前基线与开发路线_v1.md
阅读顺序
AGENTS.md → 本目录 README → 四份当前有效总则 → 当前 Step 指令书 → 上一 Step 执行报告 → 其他阶段文档。
维护职责
- GPT：参考“粒子系统”GPT 项目讨论，提出总则更新。
- 用户：确认或否决长期规则。
- Codex：普通 Step 只读；只有明确授权的总则更新任务才可修改。
冲突处理
若 Step 与总则冲突，Codex 停止冲突部分，在执行报告记录，不得自行改总则。
版本规则
同主题仅递增 _v1、_v2、_v3；不使用“最终版/最新版/final/new/修正版”。
大阶段目录
建议：10_架构调查/、20_测试App/、30_粒子核心/、40_天气数据链/、50_渲染与视觉/、60_性能与后端/、70_NavSea集成/、80_iOS与Metal/、90_升级与维护/。进入新大阶段前，GPT 先告诉用户目录名、目的、预计 Step 范围。
换窗口/换会话恢复
- 读本目录全部当前有效总则；2. 读当前基线；3. 读上一 Step 执行报告；4. 检查 Git branch/commit/working tree/submodule；5. 再继续下一 Step。
分层：GPT 项目讨论=设计过程；项目总则=冻结规则；Step 指令书=工作合同；执行报告=实际事实；Git=最终代码事实。