项目记录｜维护 moc.md 与 log.md
在工作推进中更新 moc.md 和 log.md，核对记录并接续下一次工作。
项目能否接续，取决于下一次能否找到正确材料、理解已确认的决定，并知道还有什么没完成。moc.md 负责导航，log.md 记录关键进展，二者分工不同。
什么时候更新 moc.md
项目新增了重要输入、确认了目标、生成了可复用成果，或文件位置变化后，检查项目导航是否仍准确。MOC 应帮助人和 Agent 找到材料，不需要复制每篇正文。
可以给 Agent 这样的要求：
- 检查当前项目的 moc.md。把确认保留的背景和最终提纲链接进去，保留原有人工说明；先展示准备调整的条目，不要把临时文件都列成重要成果。
先读取现有 MOC，避免用新生成的全量索引覆盖人写的背景和判断。具体组织方法见知识组织。
测试项目文件树中的导航与日志入口，不表示本轮已更新这些文件。
什么时候记录 log.md
重要决定已经确认、工作方向发生变化，或完成了有意义的行动时，按项目日志约定留下简短记录。普通问答、重复进度和完整工具流水不需要逐条写入。
Orrery 的约定以当前工作区给出的真实目录定位 log.md。仅有聊天项目名称、没有关联目录时，不应猜测路径并创建一份全局项目日志。
项目管理中的日志补充方案只确认方向，本次没有生成正文。具体操作见项目治理。
一条记录写什么
用一行或短段落记清：
- 什么时候、由谁作出决定或执行行动。
- 属于决定、方向调整还是实际行动。
- 做了什么，结果和简短原因是什么。
- 还有哪些待办或验证。
例如下面只是格式示例，不是真实项目记录：
- 时间与时区｜执行者｜行动｜完成提纲初稿；保留两处待核实引用；下一步检查原书页码。
日期、执行者和“已完成”都要有依据。未确认建议不能写成用户决定；失败、缺少资料和未验证项必须保留。
更新后怎样核对
- 重读最新文件，避免覆盖其他会话刚写的内容。
- 只修改需要调整的导航，日志优先追加短记录。
- 检查链接能否打开，路径是否属于当前项目。
- 确认实际文件与“已完成”记录一致。
- 写入失败时明确说明，不能在回复里假称已经记录。
- 这是一项协作约定
- 项目日志依靠 Agent 与文件工具维护，不是后台自动记录所有操作的服务。只读任务、用户禁止写入或权限不足时，不应为了记日志执行写操作。
下一次怎样接续
让 Agent 先读项目 MOC 和近期 log.md，再核对相关文件，说明当前状态及下一步。较早日志按需查，不必整本加入每次请求。
日志保存历史判断，不替代今天的事实核查。发现旧结论错误时，追加更正并指向原记录，保留可追溯关系，而不是把旧内容改成好像从未发生。
MOC 要进入下一轮背景，还需核对知识视野配置。
文档核对说明
- 查看编写与验证范围
- 对应操作截图待补
- 当前配图展示项目空间和知识视野，尚未展示 moc.md、log.md 的具体内容或更新前后结果。
内容来自 Orrery Desktop 的 Wiki，文档仍在持续完善。功能开放情况以当前版本为准。