Gateway 文档索引

本目录包含 Gateway 的完整文档。

文档维护规范

先改文档，再动代码 - 新功能或重大修改需先完成文档更新、并完成审阅后，再进行代码实现
文档分层，链接代码 - 关键实现需标注代码文件路径；格式：module/file.py:function_name
简洁快照，日志分离 - 只记录已确认的需求和设计，避免推测和未确认的内容

核心文档

需求规划

状态： ✅ 已确认

已确认的功能需求和范围：

Agent 生命周期管理
对话管理（Conversations）
消息路由（Routing）
两种 Agent 类型（个人助理、数字员工）
两种接入方式（内部、外部）
企业功能（可选）

架构设计

状态： ✅ 已确认

Gateway 的架构设计和核心模块：

分层架构（Core 层、API 层）
三大核心模块（Lifecycle、Conversations、Routing）
两种接入方式
企业功能

模块文档

核心模块（Core）

状态： ✅ 已创建

lifecycle.md - 生命周期管理模块
conversations.md - 对话管理模块
routing.md - 消息路由模块

API 文档

状态： ✅ 已创建

lifecycle.md - 生命周期管理 API
conversations.md - 对话管理 API
routing.md - 消息路由 API

客户端文档

状态： ✅ 已创建

python.md - Python SDK 使用指南

使用指南

状态： ✅ 已创建

quickstart.md - 快速开始
internal-agent.md - 内部 Agent 集成指南
external-agent.md - 外部 Agent 集成指南
personal-assistant.md - 个人助理型 Agent 配置
digital-employee.md - 数字员工型 Agent 配置

其他文档

设计决策

状态： ✅ 保留

架构决策记录（ADR）。

部署指南

状态： ✅ 保留

部署方式和配置说明。

企业功能文档

状态： ✅ 保留（可选）

enterprise/overview.md - 企业功能概览
enterprise/implementation.md - 企业功能实现

文档完成状态

已完成 ✅

requirements.md - 需求规划
architecture.md - 架构设计
docs/README.md - 文档索引（本文件）
core/ - 核心模块文档（3 个文件）
api/ - API 文档（3 个文件）
client/ - 客户端文档（1 个文件）
guides/ - 使用指南（5 个文件）

总计： 15 个文档文件已创建

相关文档

Agent Core 架构：Agent 框架核心设计
Gateway README：项目概览
Gateway 客户端：客户端 SDK 和 CLI 工具