Skip to content
ywjzsPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

建筑工程技术方案智能编制与合规审核系统

基于 LangGraph 多 Agent 协同 的施工前技术方案编制系统:建筑规范检索 → 技术方案自动生成 → 三层合规校验 → 人工复核路由 → 归档导出 全链路自动化,产出满足 GB/T 50328-2019《建设工程文件归档规范》 审计要求的技术方案。

针对施工前方案设计三大痛点:

痛点 方案
建筑规范繁杂难找 FastMCP 规范检索微服务(Milvus 向量 + BM25 混合检索,按专业/建筑类型自动过滤废止与无关规范)
施工方案人工编写周期长 两段式 LLM 生成(先大纲后正文,逐节绑定规范编号,本地 Ollama 免 API Key)
人工合规审核易遗漏强制条款 三层确定性规则引擎(时效/专业匹配/施工参数)识别三类风险并分级,高危强制人工复核

功能一览

  • 主控 Agent:LangGraph 状态机,结构化 DocState(专业/规范编号/合规风险/复核标记),Langfuse 对齐的本地 JSONL 全链路追踪
  • 规范检索 Agent:FastMCP 独立子进程;Milvus Lite 向量库 + BGE-M3 稠密向量 + BM25 混合 + 术语词典加权;按专业/建筑类型过滤;输出带规范编号、生效日期的结构化引用
  • 方案生成 Agent:模板变量映射(结构类型/抗震等级/层高/跨度…),两段式生成,约束后校验引用编号 ∈ 依据表,支持人工批注局部重生成并保留版本历史
  • 合规校验 Agent:三层 12+ 条规则,high/medium/low 三级风险;高危强制人工复核;结果回写全局状态并写入审计
  • 人工复核:interrupt() 挂起 + Command(resume=...) 恢复同一图;批准归档 / 驳回重生成回环(最多 5 轮)
  • 审计与归档:7 类归档文件 + GB/T 50328 档案要素清单,一键导出 ZIP

快速开始

前置:本机已安装 Python 3.12、Node 24、Ollama(模型 qwen2.5:3b、bge-m3)。

# 首次启动:建 venv → 装依赖 → 灌规范种子 → 构建前端 → 启动服务
python start.py

# 也可手动启动(保持前端已 build)
cd backend && python -m uvicorn app.main:app --port 8000

打开 http://localhost:8000 ,在「方案编制」录入工程参数提交,观察流水线进度;高危项目自动进入「人工复核」;归档后可到「审计追踪」导出 ZIP。

默认端口 8000 被其他服务占用时:python start.py --port 8001;跳过前端构建:--no-build;跳过灌库:--no-seed。

单独灌规范种子

cd mcp_server && python -m mcp_server.ingest        # 从 data/standards_seed.json 灌库

测试

cd backend && python -m pytest        # 44 个用例全绿

覆盖:全图流转与人审回环(test_graph_flow)、检索过滤/融合/词典加权(test_retrieval_filter)、合规三层规则(test_compliance_rules)、生成约束校验与重试(test_generate_mock)、追踪(test_tracing)、API 端到端与归档导出(test_api_flow)。

目录结构

techplan/
├── start.py / start.bat          # 一键启动
├── backend/                      # FastAPI 后端 + LangGraph
│   ├── app/graph/                # DocState / 8 节点 / 条件路由
│   ├── app/services/             # executor 后台跑图 / compliance 规则 / export 归档 / mcp_client
│   ├── app/routers/              # projects / plans / compliance / review / standards / audit
│   ├── app/llm/ + tracing/       # Ollama 客户端 / Langfuse 对齐 JSONL 追踪
│   └── tests/                    # 44 个 pytest 用例
├── mcp-server/                   # FastMCP 规范检索微服务(独立子进程)
├── frontend/                     # Vue3 + Element Plus + Vite(构建产物由后端托管)
└── docs/                         # 需求规格说明书 / 系统设计文档

配置

通过环境变量 TECHPLAN_* 覆盖(见 backend/app/config.py):

变量 默认 说明
TECHPLAN_LLM_MODEL qwen2.5:3b 生成/审核模型
TECHPLAN_EMBED_MODEL bge-m3 向量化模型
TECHPLAN_OLLAMA_URL http://localhost:11434 Ollama 地址
TECHPLAN_DATABASE_URL 空(SQLite) 切 MySQL 示例:mysql+pymysql://root:pass@localhost:3306/techplan
TECHPLAN_USE_MCP_SUBPROCESS true false 时进程内直连检索模块

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages