92 lines
3.0 KiB
Markdown
92 lines
3.0 KiB
Markdown
# 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工具列表 |
|