入门与计算方法
ExCoil 入门
设置工作环境、运行并检查计算、组织项目，以及保存可重复使用的工程记录。
修订日期
1. 登录并选择计算器
打开 /dashboard 的计算页面，按提示登录。首次访问教程介绍计算、湿空气分析和方案差异。可用下一步和上一步浏览，也可关闭继续；完成状态保存在当前浏览器中，并不代表已保存工程项目。
计算是单个换热器的记录；项目是按客户或交付任务组织计算和设备的独立容器。开始计算前不必先建立分组项目。
- 在计算页面选择新建计算。
- 填写计算名称，可选填说明，并选择换热器类型。
- 选择创建计算，进入对应计算器。点击已有计算的行可重新打开。
- DX Evaporator：直接膨胀空气冷却。DX Condenser：制冷剂向空气排热。
- Chilled Water 和 Hot Water：液体冷却、加热盘管。Steam：蒸汽加热盘管。Dry Cooler：利用环境空气冷却流体。
- Shell & Tube 有独立计算器和额外访问权限，不应假设盘管订阅已包含。除湿机入口打开独立的系统构建器，不是另一种盘管计算类型。
2. 输入条件、计算并检查
Rating 评估输入的几何和运行条件。Sizing 和 TXV 是各计算器特定的流程，并非通用的自动几何设计器。请求完成或能量平衡残差很小，都不能证明物理准确性或适用性。
- 在计算区域检查空气/工艺条件、流体或制冷剂条件及几何参数。输入数值前确认每个字段旁的单位。
- 选择该计算器提供的模式，不要照搬其他换热器的模式或假设。不清楚输入含义时先查阅模块指南。
- 点击计算并等待当前结果。比较容量前先阅读选型状态和警告。
- 检查出口状态、热负荷及提供的空气侧/流体侧压降。冷却盘管还应检查提供的显热/潜热表现；DX 应检查达到的出口条件和水力可行性。
- 有控制地修改输入，保存或生成报告前重新计算。此前显示或导入的结果不能证明当前性能。
3. 使用八个工程区域
区域及子面板由计算器、数据和方案决定。可见的锁定入口不等于获得权限。窄屏上可在输入参数和工作区视图间切换；桌面上可折叠/展开输入或拖动分隔条调整宽度。返回计算会回到输入。
报告章节必须有实际数据支持。方案不能生成缺失章节，PDF 也不嵌入可编辑的 STEP 或 DXF 制造文件。
| 区域 | 实际用途 |
|---|---|
| 计算 | 编辑输入；计算器提供时可在此使用回路配置。 |
| 结果 | 阅读输出；图表和 Intelligence 取决于模块与权限。 |
| 二维图纸 | 查看总体尺寸视图；详细生产图纸另有权限限制。 |
| 三维模型 | 查看总体可视化，并非详细生产工作区。 |
| 制造 | 使用提供的构造、集管或机械面板；制造细节仅限 Manufacturer。 |
| 报告 | 打开报告中心，选择可用的 Full Report 内容并导出 PDF。 |
| 文件 | 打开/保存 .excl、保存到云端，以及导出支持的数据格式。 |
| 成本 | 查看可用的 BOM/成本面板；估算不是供应商报价。 |
4. 设置语言和工程单位
计算数据保持为规范 SI；单位包影响显示，不改变物理模型。SI Engineering 常见显示为 kW、°C、m³/h、kg/h、kPa 和 mm。以实际字段标签为准：温差与绝对温度是不同量。增加显示小数位不会提高求解精度。
- 打开 /settings 设置。主语言可选英语、葡萄牙语、西班牙语、中文、印地语或阿拉伯语；数字格式单独设置。
- 在工程单位中选择 SI Engineering、US HVAC / IP 或 Refrigeration。切换单位包会清除自定义单位和小数位覆盖，并采用该包的数字区域格式。
- 需要时可单独设置功率、温度、温差、体积流量、质量流量、压力、长度、速度、面积及传热系数的单位和小数位。
- 恢复按钮清除单位/精度覆盖；放弃按钮撤销尚未保存的编辑。点击保存并等待已保存状态；语言在保存后生效。
5. 设置公司信息和标志
设置 → 公司位于 /settings/company，包含公司名称、地址、电话、邮箱和网站，以及 PDF 页眉预览。文字字段需要明确保存；放弃只撤销这些字段的草稿编辑。
可上传不超过 2 MB 的 PNG、JPEG、WebP 或 GIF 标志。上传和移除标志会立即保存，与公司文字草稿分开处理，因此放弃不能撤销标志变更。等待成功提示并检查预览。报告品牌显示取决于方案，填写公司信息不会解锁导出。
6. 用项目组织计算
添加对话框目前提供 DX 蒸发器、DX 冷凝器、冷水、热水、蒸汽和除湿机记录；不要假设所有计算器都能在此关联。从项目移除条目与删除单个计算不同。仔细阅读确认提示：界面中的计算删除不可撤销。
Free 项目管理器显示三个项目的上限。组织数量限制不同于计算使用量，创建命名记录也不等于保存已计算版本。
- 打开 /projects，选择新建项目。填写必需的名称及相关客户、设备、负责人、截止日期和跟踪信息，然后保存。
- 打开项目，在换热器中选择添加。从提供的类型中选择，再选已有计算或除湿机记录并确认。如果列表为空，先创建该类型的计算。
- 用状态、评论和活动跟踪工作。在项目列表中按项目/客户/设备搜索并按状态筛选。
- 继续工程工作时，从计算页面重新打开单项计算。比较备选方案时，可在该行菜单中复制并指定新名称。
7. 保存快照和重新打开 .excl
符合方案权限时，在已有计算内使用保存或文件 → 保存到云端。计算器在该记录下保存输入/结果快照；重新打开会加载最近保存状态。成功计算不等于自动云端保存。离开前等待保存确认。
Professional 包含项目保存。中央权限中的版本管理/历史属于 Enterprise 或 Manufacturer；不能把保存按钮理解为所有计算器都提供版本比较或恢复界面。
文件 → 保存项目 (.excl) 会下载基于 JSON 的 ExCoil 可移植文件，包含计算器元数据、输入以及提供时的结果和尺寸。它独立于云端快照、CSV/JSON 数据导出和制造 CAD。请自行备份；它不是完整账户或分组项目的导出。
- 打开其他文件前保护当前工作。在兼容计算器中使用文件区域或文件菜单的打开项目，选择 .excl。
- ExCoil 检查扩展名、JSON 结构、ExCoil 标识、版本元数据和支持的计算器类型。其他类型可能转到对应计算器。
- 检查所有导入条件、单位、几何及回路设置，依赖结果前重新计算。导入不会自动创建云端记录，也不构成文件内容的独立验证。
8. 了解输出权限
Shell & Tube 另有额外访问要求。REST 面向 Enterprise 和 Manufacturer；MCP 仅限 Manufacturer，且与 REST 分开。枚举或锁定菜单并不表示未来模块已经交付。
Free 最多使用五个不同换热器名额，每个换热器十次计算；在持久计算记录之外的计算共用一个名额。请以当前计数器和服务器提示为准；这些限制并非每日额度。付费方案取消这些 Free 计算限制。付费层级要求订阅状态为 active 或 trialing；历史订阅名称本身不赋予权限。
| 方案 | 当前边界 |
|---|---|
| Free | 使用相同盘管计算引擎，有使用量限制；不提供保存或导出。 |
| Professional | 项目保存、性能报告/数据导出、图表和简单总体二维视图。 |
| Enterprise | Professional 加总体三维可视化、批量计算和 REST API；具备版本管理权限。 |
| Manufacturer | 在 Enterprise 基础上提供详细制造图纸、DXF/STEP/STL 等制造 CAD、生产细节和 MCP。 |
9. 排查问题并使用已核实快捷键
采用此工程布局的计算器中，Ctrl+Enter 计算；Ctrl+S 调用提供的云端保存，否则调用提供的 .excl 保存；Ctrl+O 打开 .excl；Ctrl+P 导出 PDF；Ctrl+E 导出 JSON。提供输入历史时，Ctrl+Z 撤销，Ctrl+Y 或 Ctrl+Shift+Z 重做。Ctrl+/ 打开快捷键列表。macOS 使用 Cmd。操作仍取决于计算器和方案，并非所有页面的全局快捷键。
需要复现问题时，请自行打开支持页面，提供模块/模式、带单位的输入、准确错误/状态、附来源的预期结果及截图。仅在适当时附上脱敏文件；不要包含凭据、令牌或不必要的客户数据。
- 无法创建或打开：先登录，确认名称不为空并阅读错误。通过计算列表中的有效行打开，不要修改 URL 中的 ID 或类型。
- 结果异常：检查单位、模式、入口条件、几何和回路后重新计算。目标未达到或水力警告需要工程复核，而非再导出一次。
- 设置加载失败：使用重试。保存失败时保持页面打开并记录错误，不要认为草稿已保存。
- 文件被拒绝：选择原始 .excl，不要把 CSV/JSON 导出改名使用。保留原件及准确错误。兼容性检查不能保证所有历史设置都完全一致地恢复。
- 保存/报告/CAD 被锁定：检查当前方案和订阅状态。快捷键不能绕过权限。