用途：qto-report 依据 DDC 方法论（第 3.2 章）自动化从 BIM/CAD 数据中提取并分组工程量，是成本估算、进度安排与项目规划的基础，属于 5D BIM（3D 几何、4D 时间、5D 成本）中的核心环节。
主要能力：按类别、楼层、材料、类型等单级或多级分组汇总体积、面积、长度与元素数量；生成透视表；套用 Excel 中定义的计算规则（volume/area/length/count 及系数）；合并单价表计算总成本与成本占比；应用损耗系数得到净体积、毛体积与损耗量；对比设计版与竣工版工程量差异；输出材料明细拆分。
使用方式：以 pandas 读取 Revit 导出的 CSV 或经 IfcOpenShell 解析的 IFC 文件，调用 generate_qto、generate_multi_level_qto、generate_qto_pivot、calculate_cost_from_qto、apply_excel_rules、qto_with_waste、compare_qto 等函数，最后用 export_qto_report 导出 xlsx、csv、json。Revit 导出默认单位为立方英尺，需乘 0.0283168 换算为立方米。
适用场景：施工前工程量统计、成本估算、材料采购、设计变更对比、碳足迹与进度集成的前置数据准备。
限制：资料未提供具体安装命令、收费方式、平台支持与运行环境要求；示例中的单价与损耗系数仅为演示值，实际使用需替换为项目真实数据；IFC 提取依赖 IfcOpenShell，且仅覆盖 IfcBuildingElement 与 IfcElementQuantity 中的体积、面积属性。