more_agent/README.md

# MACP - 军工智能化文档编制与辅助研发平台

## 项目概述

MACP（Military Aerospace Collaboration Platform）是一款面向军工领域的智能化文档编制与辅助研发平台。通过模块化架构集成大语言模型、向量数据库、沙箱执行环境及GJB标准规则库，实现军工软件文档的自动化生成、合规性校验、智能编辑和全生命周期管理。

## 技术栈

- **后端框架**: Python FastAPI
- **数据层**: 内存假数据（开发阶段，生产环境使用 PostgreSQL + Milvus/ES）
- **部署**: Docker/Kubernetes 容器化部署

## 模块架构

| 模块 | 说明 |
|------|------|
| `template_manager` | 文档模板管理模块（SRS-MACP_F-001） |
| `gjb_validator` | GJB合规验证模块（SRS-MACP_F-002） |
| `editor` | 在线编辑与预览模块（SRS-MACP_F-003） |
| `mcp_tools` | MCP工具接入模块（SRS-MACP_F-004） |
| `skills_orchestrator` | Skills流程编排模块（SRS-MACP_F-005） |
| `memory_manager` | 智能体记忆管理模块（SRS-MACP_F-006） |
| `sandbox` | 安全沙箱执行模块（SRS-MACP_F-007） |
| `knowledge_base` | 知识库交互模块（SRS-MACP_F-008） |
| `llm_proxy` | 统一大模型接入模块（SRS-MACP_F-009） |
| `multimodal_processor` | 多模态输入处理模块（SRS-MACP_F-010） |

## 安装与运行

### 环境要求

- Python 3.11+
- pip

### 安装依赖

```bash
cd codegen-runs/codegen_6d0a60df3dd54f38821ac69f5d5e946a
pip install -r requirements.txt
```

### 启动服务

```bash
# 默认启动方式
python -m app.main

# 或使用 uvicorn 直接启动
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
```

### 访问服务

- API 服务: http://localhost:8000
- API 文档 (Swagger): http://localhost:8000/docs
- API 文档 (ReDoc): http://localhost:8000/redoc

## 测试

```bash
# 运行所有测试
pytest tests/ -v

# 运行指定测试
pytest tests/test_basic.py -v
```

## API 接口一览

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/health` | 健康检查 |
| GET | `/api/v1/templates` | 获取模板列表 |
| POST | `/api/v1/templates` | 创建模板 |
| GET | `/api/v1/templates/{id}` | 获取模板详情 |
| DELETE | `/api/v1/templates/{id}` | 删除模板 |
| GET | `/api/v1/documents` | 获取文档列表 |
| POST | `/api/v1/documents` | 创建文档 |
| GET | `/api/v1/documents/{id}` | 获取文档详情 |
| POST | `/api/v1/documents/{id}/validate` | GJB合规验证 |
| GET | `/api/v1/rules` | 获取GJB规则列表 |
| GET | `/api/v1/skills` | 获取Skills列表 |
| POST | `/api/v1/skills/execute` | 执行Skill |
| GET | `/api/v1/memory` | 获取记忆列表 |
| POST | `/api/v1/memory` | 创建记忆条目 |
| GET | `/api/v1/knowledge` | 获取知识库片段 |
| POST | `/api/v1/knowledge/search` | 搜索知识库 |
| GET | `/api/v1/models` | 获取模型配置列表 |
| POST | `/api/v1/multimodal/process` | 多模态内容处理 |
| POST | `/api/v1/sandbox/execute` | 沙箱执行代码 |
| GET | `/api/v1/mcp-tools` | 获取MCP工具列表 |