AIDOCS：AI编码智能体的编排层与持久化记忆系统

本文介绍AIDOCS——一个为Claude Code、Codex、OpenCode、Cursor等AI编码工具提供统一编排层的系统。它解决智能体上下文丢失、重复探索代码库等核心痛点，实现跨会话的持久记忆与多智能体协作，且不改变现有工具，仅在其上构建能力。

随着Claude Code、GitHub Copilot、Cursor等AI编码助手普及，开发者面临核心痛点：每次新会话启动时，智能体需重新"认识"整个代码库，导致token浪费、时间消耗及开发体验碎片化。AIDOCS旨在解决此问题，作为编排层为现有工具提供持久化记忆与智能编排能力。

AIDOCS（AI Documentation and Orchestration System）是开源MCP（Model Context Protocol）兼容运行时，由CodeNexus团队开发，基于Apache 2.0协议发布。它定位为现有智能体的增强工具，而非替代品，集成主流编码工具提供记忆持久化、任务编排等基础设施。核心架构分三层：Core层（可移植Markdown记忆、路由规则等）、MCP运行时层（索引、检索、编排、宿主集成）、Dashboard层（Tauri桌面应用，图形化监控控制）。

AIDOCS的核心机制包括：1.路由式记忆启动：通过启动链逐步加载所需上下文，避免盲目dump整个仓库；记忆文件存于/.MEMORY/路径，采用纯Markdown格式（如INDEX.md、session文件等），开放透明且版本控制友好。2.Conductor编排器：长生命周期，负责任务分发、Lane Agent管理、冲突解决，支持会话隔离，多智能体协作时按任务类型路由到合适模型（如Claude生成代码、GPT重构等）。3.索引式检索：基于符号、语义、关系的高级检索，支持大型monorepo的多模块/项目索引。

AIDOCS内置完整安全门控机制：启发式裁判（评估操作风险等级）、输出守卫（拦截敏感信息泄露）、工具策略（细粒度控制可用工具集）、RBAC权限模型（基于角色的访问控制）。这些安全层与编排逻辑深度集成，确保多智能体协作行为可预测、可审计、可回滚。

AIDOCS采用"零迁移"理念，作为覆盖层工作于现有工具之上。安装方式多样：Python包（pip install aidocs-mcp && aidocs setup）、Windows安装包（Releases下载AIDOCS-Setup.exe）、macOS/Linux一键脚本（curl命令）。配置完成后，IDE中输入/aidocs激活托管模式，常用命令包括/aidocs（启动/恢复会话）、/reingest（刷新记忆）、/archive（归档工作到CHANGELOG）、/clean（清理代码）。

AIDOCS支持多语言分类系统，通过action_tokens/目录下的TOML文件定义不同语言的用户意图描述符，目前提供英语、意大利语等支持，可在aidocs.toml中启用特定语言（如[languages] enabled="en"）。系统行为可通过配置文件定制：aidocs.toml（静态定义如日志限制、索引跳过目录）、action_hooks/*.toml（交互文本模板）、aidocs-plugin.json（OpenCode插件行为）。

AIDOCS代表AI编码工具演进方向：从"单会话智能"转向"持久化组织智能"，解决上下文连续性问题且兼容现有工具链。对个人开发者：更连贯的编码体验，智能体记住项目结构与偏好；对团队：共享集体记忆，新成员快速理解项目约定；对企业：安全门控与审计满足合规要求。随着MCP生态成熟，AIDOCS这类编排层将成标准组件，其开源策略（Apache2.0）与活跃测试（1287个用例）为社区贡献与长期维护奠定基础。