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工具列表