能源绩效综合考核生成器

这个技能解决什么问题

能源管理体系（EnMS）的能源绩效统计表通常散落在 docx 里：正文有计算过程段落，表格里有企业元信息。手工做同期对比时，常见的坑是口径不统一——折标系数乱用、评审期和基准期不是同一统计区间、节能率算出来负值却没人填原因。审核前临时拼一张考核表，往往要花一两个小时核对数字。

这个技能把整条链路固化下来：读入统计表，按 GB/T 2589 当量值口径折算，算出组织层与产品层指标，与同期基准对比得出节能量/节能率，按权重评分定级，输出一页式 Markdown 考核表。

它是怎么工作的

核心是四个脚本串起来的流水线：

• parse_docx.py：解析 docx，从正文的六个分节段落（各种能源消耗量、占比、产品能耗、万元产值能耗、能源成本比重、节能量节能率）用正则提取数值，同时从表格抽取企业名称、主要产品、统计起止日期、审核阶段等元信息，输出规范化 JSON。
• calc_performance.py：指标计算引擎，纯标准库。按 综合能耗 = Σ(能源用量 × 折标系数) 折算，再算单位产品综合能耗、产值综合能耗、能源成本占比、利用效率。
• assess.py：同期对比与评分。lower-better 类指标（能耗强度）用 (基准 − 评审) ÷ 基准 求改善率，higher-better 类指标符号反转。有目标值按线性插值算分，无目标值默认目标改善率 3%。60 分是持平基准的及格线，达到目标改善率给满分，劣于基准线性扣到 0。产品维度按各产品 Ei 占比加权，缺失维度权重自动重新归一。
• build_report.py：按模板生成七部分考核表——企业信息、能源折算、产品绩效、组织指标、同期对比考核、未达标原因、综合结论。

输入支持三种形态：直接给 docx（最省事）、直接给规范化 JSON、或交互式逐项采集。一键跑用 run_assessment.py，它会自动选路径。

适用边界与注意点

折标系数不能臆造。 默认给了电 0.1229、新水 0.2571、柴油 1.4571、汽油 1.4714（kgce/单位），完整表在 references/折标系数表.md。遇到缺失的能源品种必须让用户补充，脚本不会替你猜。

缺基准期就只能做绝对统计。 节能量和节能率都依赖「评审期 vs 同统计期基准期」的口径，比如 2025.1-9 对 2024.1-9。没有基准数据时技能会跳过评分，只输出绝对绩效。

节能率负值必须填原因。 未达标不是终点，references/边界处理.md 第 3 条规定了原因字段的写法，最终报告里会体现为 reasons.json 列表。

解析失败不会中断。 某个字段提取不到就留空并写入 _warnings，由调用方决定是手工补录还是忽略，不会静默填 0。

计算、评分、报告生成三个环节都只用 Python 标准库，只有 docx 解析需要 python-docx。