BooAi 施工进度图表生成器

Boo哥AI智写 · 智写万象，标定未来
联系 QQ邮箱：409966830@qq.com

从招标文件及清单文件内容自动生成表格式施工进度横道图和双代号网络图。

Workflow

生成施工进度图表涉及以下步骤：

1. 安装依赖 — 确保所需的 Python 库已安装
2. 解析文件 — 从招标文件/清单中提取工序数据（运行 scripts/parse_bid_docs.py）
3. 审查与调整 — 检查解析结果，调整工序逻辑和工期
4. 生成横道图 — 生成 Excel + HTML 横道图（运行 scripts/generate_gantt.py）
5. 生成网络图 — 生成 HTML 交互网络图 + Excel 参数表（运行 scripts/generate_network.py）

Step 1: Install Dependencies

所需 Python 包（通过命令行安装）：

pip install openpyxl python-docx pdfplumber

其中仅 openpyxl 为基本功能所必需。python-docx 和 pdfplumber 分别用于 Word / PDF 文件解析。

Step 2: Parse Input Documents

运行解析脚本，从招标文件和 BOQ 文件中提取工作项：

python scripts/parse_bid_docs.py file1.xlsx file2.docx file3.pdf --output schedule_data.json

可选参数：

• --no-merge：输出原始工作项，不合并为阶段级活动
• --duration N：将项目总工期覆盖为 N 天
• --start-date YYYY-MM-DD：覆盖项目起始日期

该脚本自动识别 Excel / Word / PDF 中的 BOQ 表格结构，将条目归类至各施工阶段，并合并为进度计划活动。

详细解析规则与阶段分类说明，请参阅 references/parsing_guide.md。

Step 3: Review and Adjust

完成解析后，请审阅 schedule_data.json 并按需调整：

1. 检查活动列表 — 确认所有施工阶段均已涵盖
2. 调整依赖关系 — 增加或删除前置活动，确保符合实际施工逻辑
3. 覆盖工期值 — 将系统自动估算的工期替换为实际工期值
4. 添加并行活动 — 在适用场景下设置重叠活动

JSON 数据结构示例：

{
  "project_info": {
    "project_name": "项目名称",
    "total_duration": 365,
    "start_date": "2026-01-01"
  },
  "activities": [
    {
      "id": "A1",
      "name": "施工准备",
      "duration": 7,
      "predecessors": []
    }
  ]
}

Step 4: Generate Gantt Chart（横道图）

生成表格形式的横道图（Excel 和 HTML 格式）：

python scripts/generate_gantt.py schedule_data.json --output-dir ./output --format both

可选参数：

• --format excel：仅输出 Excel 文件
• --format html：仅输出 HTML 文件
• --format both：同时输出两种格式（默认）

输出文件：

• 施工进度横道图.xlsx — 含彩色进度条、关键路径法（CPM）数据、月度时间轴的 Excel 文件
• 施工进度横道图.html — 具备响应式布局的交互式 HTML 文件

主要功能：

• 自动计算关键路径法（CPM）参数：ES / EF / LS / LF / TF
• 关键路径以红色高亮显示
• 支持月/日两级时间轴
• 排版适配打印需求

Step 5: Generate Network Diagram（双代号网络图）

生成交互式双代号网络图：

python scripts/generate_network.py schedule_data.json --output-dir ./output --format both

可选参数：

• --format html：仅输出交互式 HTML 文件
• --format excel：仅输出 Excel 参数表
• --format both：同时输出两种格式（默认）

输出文件：

• 双代号网络图.html — 支持缩放、关键路径筛选、悬浮提示信息的交互式 SVG 网络图
• 双代号网络图参数表.xlsx — 包含全部 CPM 参数的 Excel 表格

主要功能：

• 采用双代号（Activity-on-Arrow，箭线图）表示法
• 关键路径以红色显示，虚工作以虚线表示
• 节点标注事件最早时间（TE）与最迟时间（TL）
• 鼠标悬停时显示完整 CPM 参数
• 工具栏支持：显示全部/仅关键路径、切换标签可见性、缩放控制

Typical Construction Sequence

默认依赖链（可自定义）：

施工准备 → 土方工程 → 地基与基础 → 基础工程 → 主体结构
→ 砌体工程 → 装饰装修 → 门窗工程 → 竣工验收
                                          ↑
                          屋面工程 ────────┘
                          安装工程（与装饰装修并行）
                          电气工程（与装饰装修并行）
                          室外工程 → 竣工验收

详细的依赖逻辑与并行活动规则，请参阅 references/parsing_guide.md。

Output File Summary

Tips

• 对于大型项目（活动数 > 50），HTML 输出更便于评审和交互查看
• Excel 横道图更适合打印输出，以及嵌入投标文件中
• 务必验证 CPM 计算结果：确认关键路径符合实际施工逻辑
• 若某阶段自动估算工期明显偏短或偏长，请手动调整对应工期值