核心用法
Estimate Builder 是一款面向建筑工程领域的结构化造价估算框架，采用 Python 原生实现，无需依赖外部造价数据库。核心工作流为：创建项目 → 添加分项（支持 WBS 编码、工程量、单价、成本分类）→ 配置 markup（间接费/利润/风险费）→ 计算总价 → 导出 Excel 多工作表报告。
显著优点
1. 分类体系清晰：强制区分 Labor/Material/Equipment/Subcontractor/Other 五大成本类别，便于后期成本归因分析；
2. Markup 机制灵活：支持基于直接费（direct）或累计小计（subtotal）的递进式费率计算，符合国际工程惯例；
3. 数据互操作性：原生支持 pandas DataFrame 导入/导出，便于与 ERP/BIM 量化工具集成；
4. Excel 专业输出：自动生成 Summary / Line Items / Cost Breakdown / Markups 四张工作表，可直接用于投标书；
5. 内置校验逻辑：自动检测零工程量、负单价、空描述等常见疏漏。
潜在缺点与局限性
- 无价格数据库：不提供地区材料指导价或劳务价格，需用户自行维护价格源；
- 单一币种：未内置多币种/汇率转换功能；
- 缺乏历史数据学习：无法基于历史项目自动推荐 markup 率或检测异常报价；
- Python 运行时依赖：要求目标环境具备 Python 3 及 pandas/openpyxl，对纯业务人员门槛较高。
适合人群
- 中小型承包商的成本工程师与估算师
- 需快速生成标准化报价单的 PMO 团队
- 将造价数据与数据分析管道（Python/pandas）打通的技术型用户
常规风险
- 数据精度风险：浮点数四舍五入采用 Python 默认 round，跨国项目需关注会计精度要求；
- Markup 堆叠顺序敏感：不同 markup base 设置（direct vs subtotal）对最终总价影响显著，需业务人员充分理解；
- 导出文件安全：Excel 输出路径由调用方控制，若接口暴露于不可信输入，存在目录遍历写入风险；
- 无审计日志：未记录谁、何时修改了 estimate，不满足大型工程审计合规要求。