工具简介
AOCI-CODE 源于 AOCI(AI-Oriented Cognition Infrastructure,AI 导向认知基础设施)范式与协议,当前发布版本 v0.2.0-rc2。它对源代码、数据库结构等真正影响 AI 理解与修改的关键信息进行压缩,形成符号与语义结合的高信息密度纯文本索引(Whole-Index),供 AI Agent 在行动前一次性读取项目大部分关键信息,减少反复搜索与重新理解代码的成本,提高跨任务、跨会话的开发衔接效率。索引不是一次性摘要:它会随系统持续演进,长期保存在项目中,可通过 Git 比较差异、审查、版本化与回滚;除『文件在哪里』外,还保存对象职责、强关系、公开契约、事务边界与兼容性约束等难以从代码结构直接推断的语义。索引以 Volume-first 布局组织为 aoci.txt(Root)、aoci.meta.txt(Meta)、aoci.code.txt(Code)与可选 aoci.database.txt(Database)等纯文本认知资产,工作流分三阶段:建立受治理的认知 → 行动前交付认知 → 变更验证后维护认知。它通过 aoci CLI 与 MCP Server 落实到项目:接入任意支持标准 stdio MCP 的宿主(Codex、Claude Code、Cursor、OpenCode 等),模型负责语义判断,AOCI-CODE 负责治理(Safe Inventory、Managed Scope、Baseline、确定性 Plan 与 SHA-256、跨进程锁/CAS/AtomicWrite 原子提交、写后故障的不可变 Intent 与 Recovery/回滚)。仓库内置四套黑盒验证套件(协议一致性 62 项、故障注入 107 场景、冻结真实项目生命周期、升级轴 80 项×十种仓库形状)以在进程外检验公开合同。许可为 FSL-1.1-MIT 的 Fair Source/source-available 软件(非 OSI 开源定义),可从 GitHub Releases 下载签名包或从 canonical 源码构建(Go 工具链)。
本页内容来自 KGABC 结构化知识库。带「未验证」标记的字段表示官方资料未明确说明,不等同于「不支持」。
核心功能
- Whole-Index 纯文本认知索引(符号+语义高密度)
- 随系统演进,Git 版本化/审查/回滚
- 保存职责/强关系/公开契约/事务边界/兼容性约束
- Code + Database 统一认知(表级索引)
- Volume-first 布局(aoci.txt/meta/code/database)
- aoci CLI + MCP Server 双入口
- 接入 stdio MCP 宿主(Codex/Claude Code/Cursor/OpenCode)
- 模型语义 + 工具治理分工
- Safe Inventory/Managed Scope/Baseline 治理
- 确定性 Plan + SHA-256 + CAS/AtomicWrite 原子提交
- 写后故障恢复(不可变 Intent/Recovery/精确回滚)
- 黑盒验证套件(协议/故障注入/生命周期/升级轴)
- 签名 Release 包(三种校验层级)
适用场景
- 为 AI Agent 建立跨会话的项目系统认知
- 大仓库减少反复搜索与上下文消耗
- 代码 + 数据库结构统一理解
- 多 Agent/多会话复用同一份索引
- 变更后增量维护认知并重新对齐(aligned)
优势
- 索引随项目保存,不绑定特定模型或会话
- 纯文本可 Git 版本化,治理严谨
- CLI + MCP 双入口,宿主无关
- 代码与数据库统一认知
- 内置四套黑盒验证,工程可信度高
- 免费使用(FSL-1.1-MIT Fair Source)
技术能力
部署与平台
编程语言
协议
信息来源与可信度
| 来源类型 | 依据 | 状态 |
|---|---|---|
| aoci-spec/aoci-code (官方仓库) https://github.com/aoci-spec/aoci-code | 官方 README(中文)说明 AOCI 定位、Whole-Index 组织、CLI/MCP 接入、工作流三阶段与黑盒验证套件 | 已验证 |
| README.zh-CN: aoci CLI 和 MCP Server https://github.com/aoci-spec/aoci-code/blob/main/README.zh-CN.md | 明确通过 aoci CLI 与 MCP Server 落实,接入标准 stdio MCP 宿主(Codex/Claude Code/Cursor/OpenCode) | 已验证 |
| LICENSE (FSL-1.1-MIT) https://github.com/aoci-spec/aoci-code/blob/main/LICENSE | README 明确 v0.2.0-rc2 为采用 FSL-1.1-MIT 的 Fair Source/source-available 软件,非 OSI 开源 | 已验证 |
| 安装指南(签名 Release 包/源码构建) https://github.com/aoci-spec/aoci-code/blob/v0.2.0-rc2/docs/install.md | 本地构建或使用签名二进制,Go 工具链/make,本地运行接入 MCP 宿主 | 已验证 |