EGC 完全指南：让你的 AI 编码 Agent 拥有持久记忆，告别每次从零开始
你是否遇到过这样的场景：在 Claude Code 里花了一下午调试一个复杂 bug，记录了决策树、实验了 N 种方案，第二天打开终端却发现 AI 对昨天的一切毫无所知，只能重新从零开始描述上下文？这不是你一个人的困扰——所有 AI 编码 Agent（Claude Code、Cursor、Codex、Gemini CLI）都有一个共同短板：每次新会话都是一张白纸。
EGC（Extended Global Context）正是为解决这个问题而生。它是一个本地优先的 MCP 运行时，让你使用的每一个 AI 编码工具都拥有跨会话的持久记忆。安装后，你的 AI 会自动记住项目中的决策、技术栈偏好、已探明的死胡同，甚至能在下次会话开始时主动提示「上次我们卡在了哪里」。
什么是 EGC？
EGC 的全称是 Extended Global Context，一个开源的本地 MCP 运行时。它不是在云端同步聊天记录——它在你的机器上、在你每个项目的 .egc/ 目录下，保存的是 AI 的「记忆」而非「对话」。这有什么区别？记忆是你提炼后的知识：这个项目的测试框架是 Vitest 而不是 Jest、数据库连接字符串的格式、API 认证方式、以及你们团队约定俗成的代码风格。这些信息在下一次会话中会被自动加载，无需你重新描述。
EGC 同时还是一个安全层。它的 Guardian 模块会拦截每一个即将执行的 Shell 命令和文件写入操作，在它们真正运行之前进行安全检查，防止 AI 意外执行破坏性操作。
安装与初始化
EGC 的安装极其简洁，一行命令即可完成：
npm install -g @egchq/egc egc install
如果你不想全局安装，也可以用 npx 实现同样的效果：
npx @egchq/egc install
安装过程会自动完成以下操作：
- 在当前项目目录创建
.egc/记忆存储目录 - 注册 Claude Code、Cursor、Gemini CLI 等工具的 MCP 服务器连接
- 启动 Guardian 后台守护进程
安装后，你只需要正常使用你的 AI 编码工具即可。EGC 完全在后台运行，无需手动操作。
核心功能详解
1. 跨会话持久记忆
这是 EGC 的核心能力。当你在 Claude Code 中工作结束时，EGC 会自动调用 update_state 工具，将当前会话中的决策、偏好和未完成任务保存到 .egc/state/ 目录中。下一次你进入同一个项目时，AI 会自动加载这些状态：
State loaded from egc-memory via ~/.egc/state/MyApp/main.md Context and preferences acknowledged. Ready to pick up: • Fix the rate limiter edge case on concurrent requests • Add integration tests for the new auth module • Review open PR from @contributor before merging
EGC 提供了完整的记忆管理工具集：
| 工具 | 作用 |
|---|---|
get_state | 会话打开时自动加载项目已知信息 |
update_state | 保存当前会话的新决策和上下文 |
store_decision | 永久记录一个重要的决策 |
query_history | 按时间顺序查看历史决策 |
search_history | 按关键词搜索任意历史记录 |
working_memory_set/_get/_list | 快速笔记，过期自动清理 |
lesson_save/_recall/_reinforce | 学习到的经验，多次确认后持久保留 |
detect_patterns | 自动发现重复出现的错误模式 |
compress_observations | 压缩原始历史节省 Token |
每个项目分支拥有独立的加密记忆存储空间，完全离线、不经过云端。
2. Guardian 安全守护
Guardian 是一个隐形的安全层，在后台自动拦截高风险操作：
| 工具 | 作用 |
|---|---|
validate_command | 每个命令执行前检查，拦截危险操作 |
validate_write | 阻止 AI 意外写入敏感文件 |
reduce_context | 压缩大文件以免消耗过多 Token |
orchestrate_task | 自动选择最合适的工具处理请求 |
auto_learn | 从当前会话的错误中自动学习 |
这些工具不需要手动调用——EGC 在每次 Shell 命令和文件写入之前自动触发 Guardian 检查。默认以 observe 模式运行（记录但不拦截），你可以通过配置开启 enforce 模式。
3. 多工具统一记忆
你同时使用 Claude Code 和 Cursor？EGC 的记忆是统一的。运行一次 egc watch 后，你在 Cursor 中做的决策，下次在 Claude Code 或 Gemini CLI 中打开项目时会自动可用：
egc watch # 监视当前项目 egc watch /path/proj # 监视指定项目 egc watch --quiet # 静默模式
EGC 目前支持 Claude Code、Cursor、Gemini CLI、Windsurf、Zed、以及安装了 GitHub Copilot Chat 扩展的 VS Code。
实际使用场景
场景一：跨天调试复杂 Bug
周一你用 Claude Code 调查一个并发请求下的竞态条件，记录了三种方案并锁定了最优解。周二回到工位，打开项目，AI 已经知道：
你直接说「继续昨天的修复」，AI 立刻从停下的地方继续工作。
场景二：团队项目知识传承
新加入项目时，EGC 的记忆中已经存储了：
- 项目的技术栈（TypeScript + Node.js + Vitest）
- 团队的编码规范（函数式风格、ESM 模块）
- 常用的 CLI 命令和配置路径
- 已知的架构决策和设计约束
AI 不再是「新人」——它从第一分钟就开始高效工作。
场景三：安全隔离
Guardian 会自动拦截以下危险命令：
rm -rf /级别的破坏性文件操作- 向
/etc/、/usr/等系统目录的写入 - 意外的生产数据库连接
- 超出项目范围的网络请求
进阶：Prompt 库
作为额外功能，EGC 附带了一个预置的 Prompt 库，包含 63 个 Agent、230 个技能、77 个命令和 111 条规则。这些来自真实工程场景，覆盖代码审查、最佳实践、语言特定指南等场景。你可以选择性启用或全部忽略——持久记忆功能完全不受影响。
总结
EGC 解决的是 AI 编码工具最根本的痛点之一：会话间知识断裂。通过本地优先的持久记忆系统，它让 AI 编码 Agent 真正成为能够积累经验的「长期协作者」。加上 Guardian 安全层的防护，EGC 是一个既提升效率又降低风险的双赢工具。
项目是 MIT 开源的，由一位独立开发者维护。如果你也受够了每天跟 AI 重复描述同样的上下文，EGC 值得一试。
相关链接