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 记录。