33 lines
8.5 KiB
JSON
33 lines
8.5 KiB
JSON
{
|
||
"projectId": 40,
|
||
"generationId": "codegen_6d0a60df3dd54f38821ac69f5d5e946a",
|
||
"language": "python",
|
||
"status": "completed",
|
||
"fileIds": [
|
||
563
|
||
],
|
||
"outputDir": "D:\\workspace\\agent\\DocumentGenerateAgent\\agents\\ai_agents\\project-files\\codegen-runs\\codegen_6d0a60df3dd54f38821ac69f5d5e946a",
|
||
"relativeOutputDir": "codegen-runs/codegen_6d0a60df3dd54f38821ac69f5d5e946a",
|
||
"generatedFiles": [
|
||
"README.md",
|
||
"app/__init__.py",
|
||
"app/main.py",
|
||
"app/models.py",
|
||
"app/routes.py",
|
||
"app/services.py",
|
||
"events.ndjson",
|
||
"requirements.txt",
|
||
"tests/__init__.py",
|
||
"tests/test_basic.py"
|
||
],
|
||
"analysisSummary": "### **业务目标** \n开发一款面向军工领域的智能化文档编制与辅助研发平台（MACP），通过集成大语言模型、向量数据库、沙箱执行环境及GJB标准规则库，实现军工软件文档的自动化生成、合规性校验、智能编辑和全生命周期管理。核心目标是提升研制效率、确保文档严格符合GJB438C等军用标准、降低人工错误率，并支持研发过程的数字化与智能化转型。\n\n---\n\n### **功能清单（按模块化划分）**\n\n| 模块名称 | 功能项 | 功能描述 |\n|--------|-------|---------|\n| **1. 文档模板管理模块** | SRS-MACP_F-001 | 提供模板增删改查、导入导出、分类管理功能，内置GJB标准文档模板库，支持用户自定义与复用。 |\n| **2. GJB合规验证模块** | SRS-MACP_F-002 | 基于内置GJB规则库自动校验文档结构、章节完整性与格式规范，生成可视化报告并高亮不符合项及修改建议。 |\n| **3. 在线编辑与预览模块** | SRS-MACP_F-003 | 集成OnlyOffice实现所见即所得编辑与AI对话式编辑双模式，支持版本历史对比与一键回滚。 |\n| **4. MCP工具接入模块** | SRS-MACP_F-004 | 提供MCP工具的可视化注册、JSON Schema拖拽配置、沙箱调试及调用链路全链路展示功能。 |\n| **5. Skills流程编排模块** | SRS-MACP_F-005 | 支持预置与自定义Skills创建，通过可视化编辑器串联多个Skill，构建自动化研发工作流，支持条件分支与循环逻辑。 |\n| **6. 智能体记忆管理模块** | SRS-MACP_F-006 | 实现短期与长期记忆存储，基于语义相似度检索相关记忆并注入上下文，支持用户对记忆条目进行查看、搜索、编辑与删除。 |\n| **7. 安全沙箱执行模块** | SRS-MACP_F-007 | 构建基于容器技术的安全隔离环境，用于AI生成代码的安全执行，具备资源限制、网络隔离、监控日志记录与结果返回能力。 |\n| **8. 知识库交互模块** | SRS-MACP_F-008 | 提供知识库内容浏览器，支持按文档/章节/段落三级粒度选择、加权、排除，并将选中内容精准注入对话上下文。 |\n| **9. 统一大模型接入模块** | SRS-MACP_F-009 | 通过统一代理层（LiteLLM）对接多厂商大模型，支持健康检查、故障转移、热更新与无缝切换。 |\n| **10. 多模态输入处理模块** | SRS-MACP_F-010 | 支持图片、音频、视频文件上传，执行OCR识别、语音转写、关键帧提取等处理，输出文本或结构化数据供后续使用。 |\n\n---\n\n### **数据结构**\n\n#### **1. 核心数据实体**\n- **模板（Template）**：包含模板ID、名称、类型（如需求说明书）、所属GJB标准、版本号、内容结构、创建时间、作者。\n- **文档（Document）**：包含文档ID、标题、关联模板ID、当前版本、编辑历史、状态（草稿/已提交/已审核）、权限信息。\n- **GJB规则（Rule）**：包含规则ID、对应章节、要求描述、是否必选、适用文档类型、修正建议。\n- **验证报告（ValidationReport）**：包含报告ID、文档ID、验证时间、合规项数量、不合规项列表（含位置、原因、建议）。\n- **Skill**：包含Skill ID、名称、Prompt模板、关联工具列表、输入输出定义、编排顺序。\n- **记忆条目（Memory Entry）**：包含记忆ID、会话ID、内容摘要、原始对话、嵌入向量、时间戳、有效期（短期/长期）。\n- **知识库片段（Knowledge Chunk）**：包含片段ID、来源文档、层级（文档/章节/段落）、内容文本、元数据标签、向量表示。\n- **模型配置（Model Profile）**：包含模型ID、厂商、API地址、认证密钥、健康状态、权重、是否为主用。\n- **多模态处理结果**：包含源文件ID、文件类型、OCR文本、ASR转录、关键帧图像列表、提取时间。\n\n#### **2. 状态数据**\n- **系统运行状态**：正常运行状态 / 维护状态\n- **文档编辑模式**：人工编辑 / Agent对话编辑\n- **模型调用状态**：主用 / 故障转移中 / 不可用\n\n---\n\n### **接口或命令**\n\n#### **外部接口**\n| 接口名称 | 协议/方式 | 功能说明 |\n|--------|----------|---------|\n| 用户交互接口（SRS-MACP_I_UI） | HTTPS/WebSocket | 用户指令下发、界面数据渲染、实时编辑同步 |\n| OnlyOffice接口（SRS-MACP_I_OO） | REST API | 文档加载、保存、协同编辑控制 |\n| 模型代理接口（SRS-MACP_I_LLM） | LiteLLM Proxy API | 统一调用不同大模型，支持路由与负载均衡 |\n| 知识库接口（SRS-MACP_I_KB） | gRPC/HTTP | 向量数据库查询、知识片段读写操作 |\n| 沙箱控制接口（SRS-MACP_I_SB） | Docker API | 创建、启动、监控、销毁安全容器实例 |\n\n#### **内部模块间通信机制**\n- 模块间通过事件总线或微服务API进行松耦合通信。\n- 关键流程如“文档验证”需触发规则引擎服务，“Agent执行”需调用沙箱服务与模型服务协同完成。\n\n---\n\n### **约束**\n\n#### **技术约束**\n- **前端框架**：Vue.js 3.0 + TypeScript\n- **后端语言**：Spring Boot（Java） / Python FastAPI\n- **数据库**：PostgreSQL（关系型数据） + Milvus/Elasticsearch（向量与全文检索）\n- **部署方式**：Docker/Kubernetes容器化部署\n- **通信协议**：HTTP/HTTPS、gRPC、WebSocket\n- **安全协议**：国密算法加密传输与存储\n\n#### **标准与合规约束**\n- 必须严格遵循GJB438C、GJB437B等军用标准进行文档结构设计与测试流程。\n- 编码需符合公司级Java/Python编码规范，注释率 > 30%，模块圈复杂度 ≤ 10。\n- 所有交付物需满足《软件研制任务书》中规定的文档清单与质量要求。\n\n#### **运行环境约束**\n- 服务器操作系统：CentOS 7.9\n- CPU：Intel Xeon Gold，至少2颗\n- 内存：≥256GB（集群），单节点最大占用32GB\n- 网络：内网部署，禁止外联，涉密环境物理隔离\n\n#### **安全性硬性要求**\n- 沙箱必须禁用网络访问、限制文件系统权限，防止逃逸。\n- 敏感信息上传时自动触发脱敏处理。\n- 访问控制策略严格执行RBAC模型，管理员权限独立审计。\n\n---\n\n### **测试建议**\n\n| 测试类型 | 测试重点 | 推荐方法 |\n|--------|--------|--------|\n| **功能测试** | 各模块核心功能完整性 | 黑盒测试 + 场景用例覆盖（T/D） |\n| **接口测试** | 外部接口数据交互正确性 | 使用Postman/gRPC Client模拟请求（T） |\n| **性能测试** | 响应延迟与资源占用 | JMeter/Locust压测：<br>• 文档加载 <3s<br>• 编辑保存 <1s<br>• 知识检索 <200ms |\n| **可靠性测试** | 故障转移与数据持久化 | 模拟主模型宕机，验证自动切换；断电恢复测试文档未丢失（T/A） |\n| **安全测试** | 沙箱逃逸防护、数据脱敏 | 使用容器扫描工具（Trivy）、渗透测试工具（Metasploit）验证逃逸率为0%（特殊方法E） |\n| **合规性验证** | GJB规则匹配准确率 | 分析+人工审查结合，抽样比对标准条款（A/Z） |\n| **用户体验测试** | 易用性与操作流畅度 | 典型用户试用反馈收集，评估界面友好度（D） |\n| **回归测试** | 模块变更后影响范围 | 自动化测试套件覆盖关键路径，CI/CD集成执行（T） |\n\n> 注：合格性方法依据表24，关键功能采用“测试+分析”组合方式（T/A），一般功能可采用“测试+演示”（T/D）。",
|
||
"eventLogFile": "D:\\workspace\\agent\\DocumentGenerateAgent\\agents\\ai_agents\\project-files\\codegen-runs\\codegen_6d0a60df3dd54f38821ac69f5d5e946a\\events.ndjson",
|
||
"repoSettings": {
|
||
"username": "root",
|
||
"password": "pAssW0rd",
|
||
"repoUrl": "http://47.108.255.216:3000/root/more_agent.git",
|
||
"branch": "main"
|
||
},
|
||
"repoUrl": "http://47.108.255.216:3000/root/more_agent.git",
|
||
"branch": "main"
|
||
} |