第19篇：更新 MASTER_INDEX
项目资料完成归档确认后，下一步必须更新 MASTER_INDEX.md。
这个文件可以理解为项目资料总地图。没有它，Codex 每次都要重新猜资料在哪里，效率低，也容易引用错误。
很多项目一开始建了索引，但后面资料归档、目录调整、版本变化后没有同步更新。两三周之后，索引和真实目录已经对不上，Codex 仍然按旧索引工作，输出自然会跑偏。
第 19 篇只讲一个操作点：根据资料归档确认结果更新 MASTER_INDEX.md，让项目资料地图跟上真实状态。
一、为什么要更新 MASTER_INDEX
MASTER_INDEX.md 不是装饰性目录，而是 Codex 识别项目资料位置的重要依据。
如果资料已经完成归档，但索引没有同步更新，后续就会出现几个问题：
- Codex 仍按旧路径查找文件。
- 已经移动到正式目录的资料，在索引中仍显示为收件箱资料。
- 版本状态已经确认，但索引里没有体现。
- 暂缓归档或待确认资料，被误当成正式依据引用。
所以，资料归档不是最后一步。归档确认完成后，还要把资料路径和状态同步进项目总索引。
二、怎么用
MASTER_INDEX.md 不需要记录每一个临时文件，但必须记录关键资料。
建议至少记录以下信息：
- 资料名称。
- 文件路径。
- 资料类型。
- 版本或状态。
- 来源。
- 适用业务模块。
- 是否正式依据。
- 备注。
这里有一个原则：宁可标注“待确认”，也不要把不确定资料写成“已确认”。
三、如何操作
- 打开
00_项目总控/MASTER_INDEX.md。如果还没有这个文件，应先建立项目资料总索引。 - 打开《资料归档确认表》，只筛选确认结论为“同意归档”的文件。
- 暂缓归档和退回补充确认的资料，不要直接纳入正式索引。
- 按业务模块更新索引。例如合同资料写入“01_合同及招投标资料”，施工方案写入“02_施工组织设计及专项方案”，进度计划写入“03_进度计划管理”。
- 让 Codex 根据确认表生成
MASTER_INDEX更新建议。 - 人工检查更新建议，重点看路径是否正确、资料状态是否过度确认、是否把待确认资料写成正式资料。
- 确认无误后，再更新正式
MASTER_INDEX.md。 - 更新完成后，在资料同步记录中记录本次更新内容。
如果担心覆盖旧版，可以先生成 MASTER_INDEX_更新建议.md，人工确认后再替换正式文件。
四、MASTER_INDEX 建议字段
每条索引建议包含以下字段：
- 资料名称。
- 文件路径。
- 资料类型。
- 版本或状态。
- 来源。
- 适用业务模块。
- 是否正式依据。
- 备注。
其中“文件路径”和“是否正式依据”最容易被忽略，但这两项非常关键。路径不清，Codex 后续找不到资料；依据状态不清，后续判断容易失真。
五、可直接复制给 Codex 的提示词
请读取《资料归档确认表》和当前 MASTER_INDEX.md，根据人工确认结果提出 MASTER_INDEX.md 更新建议。
要求：
1. 只将确认结论为“同意归档”的资料纳入正式索引；
2. 暂缓归档、退回补充确认的资料不得写成正式依据；
3. 每条索引应包含资料名称、文件路径、资料类型、版本或状态、来源、适用业务模块、是否正式依据、备注；
4. 不得删除历史索引内容，如需调整，请说明调整原因；
5. 对版本不清、路径不明、状态不明的资料，必须标注“待项目部确认”。
本次请先生成《MASTER_INDEX 更新建议》，不要直接覆盖正式 MASTER_INDEX.md。六、一些注意事项和经验
不要把收件箱里的未确认资料写入正式索引。收件箱只是入口，不等于正式资料库。
不要在索引里只写文件名，不写路径。Codex 后续要按路径查找资料，路径缺失会直接降低检索效率。
不要把“疑似最终版”“别人说是最新版”的资料写成“审批版”或“正式版”。涉及合同、工期、质量、安全、索赔等内容时，更要区分正式依据、参考资料和待确认资料。
更新索引时不要随手删除旧内容。确实需要调整历史索引时，应说明调整原因，例如资料作废、路径迁移、版本替换。
索引不是越细越好。关键资料必须有，临时碎片资料可以先归入类别说明，避免把 MASTER_INDEX.md 变成难以维护的大杂烩。
建议每次资料归档后立即更新索引，不要等到月底集中补。索引滞后越久，后续补起来越痛苦。
七、到这里你应该能……
- 知道资料归档后为什么还要更新
MASTER_INDEX.md。 - 根据《资料归档确认表》筛选“同意归档”的资料。
- 让 Codex 先生成
MASTER_INDEX更新建议，而不是直接覆盖正式文件。 - 检查索引中的路径、资料状态、来源和是否正式依据。
- 避免把未确认资料写成正式依据。
- 把本次索引更新纳入资料同步记录。
一句话记住：资料入库后，总地图也要跟着更新。
