Project Chameleon AI Agent 平台

Project Chameleon 是一个面向复杂业务流程的 AI Agent 平台。文档站当前采用“先按阅读意图入门，再按系统、操作、参考和专题深入”的信息架构，原先分散在 guides/、core/、api/、timelines/ 等目录下的内容已经并回主导航，而不是作为独立的兜底区存在。

从哪里开始

你的目标	从这里进入
第一次接触仓库，想先跑起来	快速开始
想先建立统一术语和心智模型	核心概念
已经知道自己要看哪个子系统	系统文档
想看具体操作步骤和 Studio 用法	操作指南
想部署、配置、排障或做管理操作	运维
想查接口、配置、存储或代码入口	参考
想看产品线方案、业务专题或规划设计	专题方案
想看系统是怎么演进到当前状态的	历史演进

文档站结构

• 快速开始：新读者入口，本地开发、项目地图和推荐阅读顺序都放在这里。
• 核心概念：跨系统共享的概念，例如 agents、sessions、knowledge sources、MCP、orchestrator runtime。
• 系统：RAG、编排器、MCP、Fusion、评测、单证识别等主要子系统的稳定首页。
• 操作指南：偏“怎么用”的实操文档，包括配置、部署、Studio 控制台与 Outlook Add-in。
• 运维：部署、配置、访问控制、Studio 日常运行手册和备份恢复。
• 参考：API、配置、存储、数据模型和代码索引等“查表型”内容，以及更贴近源码对象的 API 深度参考。
• 专题方案：面向产品线、领域方案和规划设计的专题文档，如 Chameleon、Marketplace、货代智能 Agent 与路线图。
• 历史演进：RAG、MCP、编排器等系统的时间线与历史设计背景。

推荐阅读路径

场景	推荐路径
新加入研发	快速开始 -> 项目地图 -> 核心概念
后端开发	核心概念 -> 编排器系统 -> 源码级 API 参考
平台运营 / 实施	操作指南 -> 运维概览 -> Studio Runbooks
Agent / Runtime 设计	Agents -> 平台架构概览 -> Fusion
方案规划 / 领域专题	专题方案 -> 货代智能 Agent -> 路线图

平台总览

flowchart LR
  User[业务用户] --> DemoFE[Demo Frontend]
  Operator[管理员] --> AdminFE[Studio Admin]
  DemoFE --> DemoBE[Demo Backend]
  DemoBE --> Api[AI Service API]
  AdminFE --> Api
  Api --> Orchestrator[Chat Orchestrator]
  Api --> FusionRuntime[Fusion Runtime]
  Orchestrator --> RAG[RAG Retrieval]
  Orchestrator --> MCP[MCP Tooling]
  Api --> DocRec[Document Recognition]
  Api --> Eval[Evaluation]
  Api --> DB[(PostgreSQL)]
  Api --> Blob[(MinIO)]
  Api --> Vector[(Qdrant)]

文档维护约定

• 新主题先判断它属于 概念、系统、操作指南、运维、参考、专题方案 还是 历史演进，不要再新增一套平行分类。
• 系统页负责解释职责、边界、关键入口和阅读顺序；对象签名与字段细节优先放进 参考。
• 业务逻辑、接口、配置或导航结构变化后，必须同步更新对应文档和 mkdocs.yml。

更多写作与放置规则见 文档规范。