# 2026-06-25 CODEGRAPH 初始化

## 用户目标

用户要求先重新读取 `/Users/ar/.codex/AGENTS.md` 和项目根目录 `AGENTS.md`，再继续检查 Mindraw 主项目是否已有 `CODEGRAPH.md`；如果没有，则按规则初始化，并确保 `CODEGRAPH.md` 纳入 Git 管理范围。

## 已完成事项

- 重新读取全局 `/Users/ar/.codex/AGENTS.md` 和项目根 `AGENTS.md`。
- 读取 `code-governance.md`、`work-continuity.md`、`session-memory.md` 和项目 `INDEX.md`。
- 确认主项目根目录原本没有 `CODEGRAPH.md`；唯一既有 `CODEGRAPH.md` 位于 `p.mindrawforcodex/03-O/C1.source/CODEGRAPH.md`，属于独立子项目。
- 只读扫描主项目源码入口、状态模型、Tauri 命令、导入/导出模块、测试入口和打包脚本。
- 新增根目录 `CODEGRAPH.md`，记录稳定模块、核心文件、入口符号、依赖关系、关联测试、受保护行为、修改前阅读路线和验证入口。
- 更新 `AGENTS.md`，声明 Mindraw 主项目工程地图位置和更新规则。
- 更新 `INDEX.md`，登记 `CODEGRAPH.md` 为根目录入口和源码配置入口。
- 更新 `03-O/K2.项目管理/经验-项目文件夹管理.md`，允许根目录保留 `CODEGRAPH.md`。
- 更新 `02-P/plan-progress.markdown`，记录 `P-20260625-codegraph-init` 完成。
- 验证 `CODEGRAPH.md` 不被 `.gitignore` 排除。
- 暂存相关文件：`CODEGRAPH.md`、`AGENTS.md`、`INDEX.md`、`02-P/plan-progress.markdown`、`02-P/plan.markdown` 删除、`03-O/K2.项目管理/经验-项目文件夹管理.md`。

## 关键决策

- Mindraw 主项目工程地图使用默认根路径：`/Users/ar/Projects/ExcalidrawX/CODEGRAPH.md`。
- `p.mindrawforcodex/03-O/C1.source/CODEGRAPH.md` 不作为主项目工程地图。
- `CODEGRAPH.md` 是人工维护的工程地图，不提交 `.codegraph/`、LSP 索引或其他自动缓存。
- 非平凡代码修改前必须先读 `CODEGRAPH.md`，再读其指向的源码和测试。

## 文件变更

- `CODEGRAPH.md`
- `AGENTS.md`
- `INDEX.md`
- `02-P/plan-progress.markdown`
- `03-O/K2.项目管理/经验-项目文件夹管理.md`
- `.codex-sessionhistory/2026-06-25-codegraph初始化.md`

## 验证记录

- `find ... -name CODEGRAPH.md`：主项目根此前无 `CODEGRAPH.md`，仅发现独立子项目 `p.mindrawforcodex/03-O/C1.source/CODEGRAPH.md`。
- `git check-ignore -v CODEGRAPH.md`：无 ignore 命中，输出确认 `CODEGRAPH.md is not ignored`。
- 未运行构建或测试；本轮只新增和更新项目治理文档，不改业务源码。

## 未决问题

- 工作区仍存在与本轮无关的未暂存 / 未跟踪内容，例如 `.gitignore`、`.codex/`、`01-I/X-参考-cafe/`、`02-P/Round01-mindraw-defstart/`、`Txtflowy/`、`canvas/`、`p.mindrawforcodex/` 等。本轮未处理。

## 后续建议

- 后续代码任务开始前，按顺序读 `INDEX.md`、`CODEGRAPH.md`、`02-P/plan-progress.markdown`。
- 修改 `CODEGRAPH.md` 指向的核心模块时，同轮同步更新工程地图和相关测试 / QA 记录。