35 lines
1.9 KiB
Markdown
35 lines
1.9 KiB
Markdown
# MapLibreParticleLab 项目总则目录
|
||
|
||
## 定位
|
||
`docs/00_项目总则/` 是本项目长期规则层（Source of Truth）。保存经用户与 GPT 确认的长期设计决策、开发环境、系统构建规范、Codex 协作规则、Step/执行报告规范，以及当前正式基线与路线。普通 Step 默认禁止修改本目录。
|
||
|
||
## 当前有效文件
|
||
1. `粒子系统项目规则与设计决策_v1.md`
|
||
2. `开发环境与系统构建规范_v1.md`
|
||
3. `Step指令书与执行报告规范_v1.md`
|
||
4. `当前基线与开发路线_v2.md`（当前）
|
||
|
||
`当前基线与开发路线_v1.md` 保留为 2026-08-29 历史冻结，不再作为当前构建/发布依据。
|
||
|
||
## 阅读顺序
|
||
`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 范围。
|
||
|
||
## 换窗口/换会话恢复
|
||
1. 读本目录全部当前有效总则；2. 读当前基线；3. 读上一 Step 执行报告；4. 检查 Git branch/commit/working tree/submodule；5. 再继续下一 Step。
|
||
|
||
分层：GPT 项目讨论=设计过程；项目总则=冻结规则；Step 指令书=工作合同；执行报告=实际事实；Git=最终代码事实。
|