idfkit EnergyPlus 工具包 - 开源 Python 建筑能耗模拟套件翻译站点

idfkit.com 是面向 EnergyPlus 的开源建筑能耗模拟工具包 idfkit 的官方网站。EnergyPlus 是建筑能耗模拟领域的主流整栋模拟引擎，其输入长期以文本格式 IDF 为主，手工编辑容易产生引用错误。idfkit 由建筑模拟领域的开发者维护，采用 MIT 许可证开源，目标是围绕 EnergyPlus 提供一套现代工具，覆盖模型编写、校验、模拟执行到结果处理的完整流程。官方在页面顶部提示这些工具仍处于积极开发阶段。

主要资源：

• idfkit 核心库：用于解析与组织 IDF 和 epJSON 两种格式，采用字典式索引实现接近常数级别的对象查找，自动维护对象之间的引用关系，内置三维几何与热工计算，支持同步、异步和批量模拟，兼容 EnergyPlus 8.9 至 26.2 版本，且不依赖第三方库，可通过 pip 安装。
• idfkit-mcp：把建筑能耗建模能力开放给人工智能代理的 MCP 服务器，提供 37 个工具，覆盖结构发现与校验、模型编写与修改、气象站点接入、模拟执行和结果读取。
• idfkit-lsp 与 VS Code 扩展：为 idfkit 代码提供对象类型与字段自动补全、行内文档、签名提示和基于语法树的类型推断。
• idfkit-docs：可检索的 EnergyPlus 输入输出对象参考文档，字段级说明包含单位与约束条件，支持交叉链接跳转。
• Envelop 网页版编辑器：免费、免安装，在浏览器中完成可视化暖通节点图设计、三维几何查看、日程表编辑，并可直接运行 EnergyPlus 模拟，支持导入导出 IDF 与 epJSON。
• idfkit-plugin：面向 Claude Code 与 Codex 的插件，打包了 MCP 服务器、技能、代理与斜杠命令，一条命令即可安装。
• 气象与性能数据：官方页面列出可接入的气象站点超过一万七千个，并称字典式索引相比传统遍历方式的查找速度提升数千倍。

对建筑行业的价值：参数化模拟、敏感性分析和多工况批量计算已经成为建筑节能优化的常规需求。传统做法靠脚本反复读写文本输入文件，效率低而且容易破坏对象引用一致性；idfkit 用对象索引与引用图降低出错概率，适合把围护结构参数、窗墙比、遮阳和设备效率做成批量工况，再统一后处理结果。网页版编辑器的意义在于让不写代码的设计人员也能直接查看和修改模型，降低能耗模拟的使用门槛。对外提供能耗计算结果的团队，可复现的代码流程也便于做质量控制和第三方复核。项目采用开源许可，模型文件格式、对象文档和接口都公开，遇到疑问可以查看源码或在社区讨论区反馈，不必依赖单一商业软件的授权与版本节奏。需要留意的是部分工具仍在快速迭代，用于正式交付前建议锁定版本并自行校核关键结果。项目提供独立文档站点与讨论区，模型对象、字段单位与取值范围都有说明，配合参考文档可以较快定位语法与结构问题。

适合人群：建筑能耗模拟工程师、暖通空调与建筑物理研究人员、节能咨询与绿色建筑顾问、需要批量处理 EnergyPlus 模型的开发者，以及建筑技术相关专业的学生。