3.0 KiB
3.0 KiB
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
安装依赖
cd codegen-runs/codegen_6d0a60df3dd54f38821ac69f5d5e946a
pip install -r requirements.txt
启动服务
# 默认启动方式
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
测试
# 运行所有测试
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工具列表 |