# acps-docs

**Repository Path**: acps_1/acps-docs

## Basic Information

- **Project Name**: acps-docs
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-21
- **Last Updated**: 2026-02-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ACPs系统文档索引

**文档日期**: 2025-12-14  
**版本**: v1.0

## 文档概述

本文档集提供了ACPs（Agent Collaboration Protocols，智能体协作协议体系）系统的完整技术文档，包括系统架构、接口文档、部署指南和交互流程等。

## 文档列表

### 1. [系统架构总览](./20251222-ACPs系统架构总览.md)

**内容**:
- 系统概述和核心目标
- 系统架构图
- 核心实体关系
- 模块职责说明
- 数据同步机制概述
- 安全机制
- 协议规范
- 技术选型

**适合读者**: 系统架构师、技术负责人、新加入的开发者

### 2. [注册中心接口文档](./20251222-注册中心接口文档.md)

**内容**:
- 认证相关接口
- 账户管理接口
- Agent管理接口（公开/客户端/工作人员）
- ATR协议接口
- DRC数据同步接口
- 文件管理接口
- 错误响应格式
- 接口调用示例

**适合读者**: 前端开发者、API集成开发者、测试人员

### 3. [发现中心接口文档](./20251222-发现中心接口文档.md)

**内容**:
- 智能体发现接口
- 发现机制说明
- DRC管理接口（测试用）
- 配置参数
- 性能优化
- 使用示例

**适合读者**: 前端开发者、API集成开发者、测试人员

### 4. [证书中心接口文档](./20251222-证书中心接口文档.md)

**内容**:
- ACME协议接口
- 证书管理接口
- CRL接口
- OCSP接口
- 证书吊销管理接口
- 证书Subject设计
- HTTP-01验证流程
- 证书申请完整流程

**适合读者**: 证书管理员、安全工程师、API集成开发者

### 5. [数据同步机制详解](./20251222-数据同步机制详解.md)

**内容**:
- DRC协议概述
- 数据同步架构
- 数据模型（Envelope）
- 同步方式（全量快照、增量快照、增量变更、Webhook）
- 数据一致性保障
- 快照实现机制
- ChangeLog生成机制
- 发现中心同步客户端
- 配置参数
- 监控和调试
- 最佳实践
- 故障处理

**适合读者**: 系统运维人员、架构师、开发人员

**关键问题解答**: 
- **Q: 注册中心和发现中心是否需要共享数据库？**
- **A: 不需要。** 它们可以是完全独立的系统，通过DRC协议进行HTTP API数据同步。

### 6. [部署指南](./20251222-部署指南.md)

**内容**:
- 环境准备（Python、PostgreSQL、Qdrant）
- 注册中心部署步骤
- 发现中心部署步骤
- 证书中心部署步骤
- Demo项目部署步骤
- 部署验证
- 常见问题
- 生产环境部署建议
- 启动脚本

**适合读者**: 系统管理员、运维人员、部署工程师

### 7. [模块交互流程](./20251222-模块交互流程.md)

**内容**:
- Agent注册到使用的完整流程
- 证书申请详细流程
- 数据同步流程
- 智能体发现流程
- AIP协议交互流程
- mTLS身份认证流程
- 群组模式交互流程
- 完整场景示例
- 错误处理流程

**适合读者**: 开发人员、系统集成人员、业务分析师

## 快速开始

### 对于新用户

1. 首先阅读 [系统架构总览](./20251222-ACPs系统架构总览.md) 了解整体架构
2. 然后阅读 [部署指南](./20251222-部署指南.md) 进行环境搭建
3. 参考 [模块交互流程](./20251222-模块交互流程.md) 理解业务流程

### 对于开发者

1. 阅读 [系统架构总览](./20251222-ACPs系统架构总览.md) 了解技术架构
2. 查看对应的接口文档了解API使用
3. 参考 [数据同步机制详解](./20251222-数据同步机制详解.md) 理解数据同步

### 对于运维人员

1. 阅读 [部署指南](./20251222-部署指南.md) 进行系统部署
2. 参考 [数据同步机制详解](./20251222-数据同步机制详解.md) 进行监控和故障处理
3. 查看各服务的接口文档了解管理接口

## 核心概念

### AIC（Agent Identity Code）
32位智能体身份码，全局唯一标识符。

### ACS（Agent Capability Specification）
智能体能力描述，JSON格式，包含智能体的功能、技能等信息。

### ATR（Agent Trusted Registration）
智能体可信注册协议，定义Agent注册和证书申请的流程。

### DRC（Discovery and Registration Coordination）
发现与注册数据同步协议，实现注册中心和发现中心之间的数据同步。

### AIP（Agent Interaction Protocol）
智能体交互协议，定义智能体之间的通信和协作方式。

### mTLS（Mutual TLS）
双向TLS认证，确保智能体间通信的安全。

## 系统组件

### 注册中心（Registry Server）
- **端口**: 8001
- **职责**: Agent注册、审批、AIC分配、数据同步服务端
- **文档**: [注册中心接口文档](./20251222-注册中心接口文档.md)

### 发现中心（Discovery Server）
- **端口**: 8005
- **职责**: Agent发现、语义匹配、数据同步客户端
- **文档**: [发现中心接口文档](./20251222-发现中心接口文档.md)

### 证书中心（CA Server）
- **端口**: 8003
- **职责**: 证书颁发、ACME协议、CRL/OCSP服务
- **文档**: [证书中心接口文档](./20251222-证书中心接口文档.md)

### Demo项目
- **端口**: 3000（Web界面）
- **职责**: 展示多智能体协作示例
- **文档**: 参考Demo项目README

## 数据流转

```mermaid
graph LR
    A[用户注册Agent] --> B[注册中心审批]
    B --> C[分配AIC]
    C --> D[证书中心申请证书]
    D --> E[获得CAI证书]
    E --> F[Agent服务上线]
    F --> G[数据同步到发现中心]
    G --> H[被其他Agent发现]
    H --> I[建立mTLS连接]
    I --> J[AIP协议协作]
```

## 协议规范

系统实现了以下ACPs协议规范：

1. **AIC规范**: 智能体身份码定义
2. **ACS规范**: 智能体能力描述格式
3. **ATR规范**: 智能体可信注册流程
4. **AIA规范**: 智能体身份认证流程
5. **ADP规范**: 智能体发现协议
6. **AIP规范**: 智能体交互协议
7. **DRC规范**: 发现与注册数据同步协议

详细规范文档请参考 `Agent-Interconnection-Protocol-Project` 目录。

## 技术支持

如有问题，请参考：
- 各模块的README文档
- 接口文档中的错误处理章节
- 部署指南中的常见问题章节

## 文档更新记录

- **2025-12-14**: 初始版本，包含完整的系统文档