文章目录
- 一、为什么你的 AI Agent 总是"失忆"？
- 二、AOCI-CODE 到底是什么？
- 三、四大核心能力：它到底能帮你做什么？
- 3.1 能力一：在 Agent 里持续迭代大型系统
- 3.2 能力二：一键理解已有系统，直接接手开发
- 3.3 能力三：换人、换 Agent、换对话，认知不丢
- 3.4 能力四：首次索引建立后自动维护
- 四、整体架构：一张图看懂 AOCI-CODE
- 五、索引结构揭秘：FRAS——每条记录只有一行，但信息量爆炸
- 5.1 一条真实的索引记录
- 5.2 标签字典：给每个文件精准定位
- 5.3 S 字段为什么是灵魂？
- 六、Volumes 架构：四个文件组成的 Whole-Index
- 七、三阶段工作流：建立 → 读取 → 维护
- 7.1 阶段一：建立受治理的认知
- 7.2 阶段二：行动前读取认知
- 7.3 阶段三：变更验证后维护认知
- 八、Agent 与 AOCI 的交互时序：一次开发任务发生了什么？
- 九、快速上手：三步接入你的项目
- 9.1 第一步：下载并初始化
- 9.2 第二步：重启 Agent 并建立索引
- 9.3 第三步：正常开发
- 十、手动安装与构建：关键命令
- 10.1 从源码构建（关键代码）
- 10.2 手动初始化项目
- 10.3 验证与诊断
- 十一、MCP 工具全景：9 个工具搞定一切
- 11.1 Overview 交付机制：大索引如何可靠传输？
- 11.2 长会话与上下文压缩
- 十二、数据库认知：让 Agent 同时懂代码和表结构
- 12.1 数据库认知的安全边界
- 12.2 数据库接入：你不需要懂 DSN 细节
- 12.3 openGauss 的严格安全策略
- 十三、系统认知：在索引之上派生五大观察能力
- 13.1 关键命令示例
- 十四、新建项目 vs 已有项目：两条接入路径
- 十五、宿主集成：Codex / Claude Code / Cursor / OpenCode 各有不同
- 十六、AOCI 面板：可视化你的认知索引
- 十七、与 RAG / LSP / CodeGraph 的本质区别
- 十八、三种执行模式与隐私边界
- 十九、治理状态：如何判断索引是否可靠？
- 二十、写入安全：失败时绝不留半完成状态
- 二十一、技术栈一览
- 二十二、实战避坑指南
- 22.1 初始化后哪些文件要提交 Git，哪些不要？
- 22.2 确认宿主真正连着哪个 AOCI
- 22.3 关于"只读"命令
- 22.4 模型负责语义，AOCI 负责治理
- 二十三、总结：AOCI-CODE 为什么值得你投入？
- 附录：常用 CLI 命令速查表
一、为什么你的 AI Agent 总是"失忆"？
你有没有过这样的经历：用 AI Agent 写了一个项目，代码量涨到几万行后，每次开新对话，Agent 都要从头搜索、重读整个仓库，半天才能进入状态？换个 Agent、换台电脑，之前的"理解"全部清零？这篇文章带你彻底解决这个痛点——用 AOCI-CODE 给你的代码库建一张永久的、可版本化的认知地图，让任何 Agent 读一次就懂整个系统。
先看一个真实场景：你用 Cursor 或 Claude Code 开发了一个电商系统，前后端加起来 15 万行代码。某天你开了个新对话，说"给订单模块加个优惠券功能"，Agent 的反应是：
- 搜索
order相关文件，找到 30 个候选 - 逐个打开阅读，花了 2000 token 才搞清楚订单服务的入口
- 又搜索
coupon，发现已有一个优惠券表但没人用 - 再读数据库迁移文件、前端页面、测试用例……
一个简单的需求，光"理解上下文"就花了十几分钟、上万 token。更糟的是，下次开新对话，这一切还要重来一遍。
这不是 Agent 不够聪明，而是它没有"系统级记忆"。每次对话都是从零开始，代码库对它来说永远是陌生的。
AOCI-CODE 就是来解决这个问题的。
