---
title: MemRelay 为主、本地 aidocs 仅作离线暂存
type: rule
permalink: main/global/mem-relay-为主、本地-aidocs-仅作离线暂存
stable_id: 25332e63-48d0-4daa-8c08-d676bb2d310d
scope: global
project_id: null
memory_type: rule
status: active
revision: 1
restored_from_commit: 6a6a895eafcca6052e81a14fca103a42635dd1c2
created_at: '2026-09-23T14:49:55.371432+00:00'
updated_at: '2026-09-23T14:49:55.371484+00:00'
tags:
- rules
- memory
- memrelay
- offline-fallback
---

会话开始先调用 capabilities_get 检查 MemRelay，并按当前目录、Git remote、项目名解析项目。MemRelay 可用时它是唯一的记忆存储：所有全局和项目记忆都写入 MemRelay，不创建或更新本地 aidocs。仅当 MemRelay 工具不存在、不可访问、鉴权失败或写入不可用时，才把待同步记忆临时保存到项目的 aidocs/project_context.md（最新优先、秒级时间戳，记录做了什么/为什么/如何验证/问题/下一步），并确保 aidocs 已加入 .gitignore、不提交。每次会话开始若发现 aidocs/project_context.md 存在且 MemRelay 可用，立即将有效记忆按正确范围去重同步；逐条确认成功且无遗漏后删除整个 aidocs 目录。不主动调用 project_export_prepare 向 aidocs 导出副本，除非用户明确要求；导出副本不视为待同步记忆。线上与本地冲突时不得静默覆盖线上内容，冲突条目暂留本地并向用户说明，待用户裁定后再写入。重要里程碑保存检查点；会话结束前若有实质进展，保存交接级检查点（未完成线索、临时约定、要避开的坑）。记忆仓库的历史恢复、记忆仓库 Git 同步和破坏性清理只在用户明确要求时执行，此限制不涉及代码仓库的提交推送。推测、临时数据、闲聊、未裁定的冲突内容和任何密文均不得写入 MemRelay。