求平均值

📖 节点概述

多输入数学节点，计算所有输入数值的算术平均值（总和 ÷ 数量）。支持动态增减输入端口（右键菜单），至少 2 个数值。输出格式可选择自动推断、强制整数或强制浮点，灵活适应下游需求。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 数据统计分析：计算一组传感器读数、销售数据、测试分数的平均值。
• 性能指标汇总：获取多个时间点的平均响应时间、平均 CPU 占用率。
• 批量数值归一化：先计算平均值，再用于后续的偏差计算或数据标准化。
• 动态评分系统：评委打分后自动计算平均分（可增减评委端口）。
• 报表生成：在报表中展示某类数据的平均单价、平均销量等。

🎮 实战连线指南：如何正确使用它？

节点通过动态端口接收至少 2 个数值，自动求和后除以数值个数。结果类型由输出格式决定。

场景案例：计算三次测试的平均分

1. 准备分数：使用【常量】或【变量获取】节点提供：
   • score1 = 85.5
   • score2 = 92.0
   • score3 = 78.5
2. 连接节点：
   • 右键单击【求平均值】节点，选择“添加端口”增加至 3 个输入。
   • 依次连接 score1、score2、score3 到 数值 1、数值 2、数值 3。
3. 设置输出格式：选择 自动推断 (Auto) → 平均值 (85.5 + 92.0 + 78.5) / 3 = 85.333... 为浮点数。
4. 获取结果：结果 输出 85.33333333333333，可继续用于评级或存储。

💡 强制整数输出：若选择 强制整数 (Int)，结果会被截断（如 85.333 → 85）。强制浮点 (Float) 则始终返回浮点数。

⚙️ 引脚与参数说明

📥 输入引脚（动态）

⚙️ 控件参数

📤 输出引脚

🔧 核心运算逻辑

• 收集所有可用动态端口（自动排除末尾未连线的幽灵端口）。
• 依次读取每个端口的数值（失败则使用控件默认值 0.0），转换为浮点数。
• 计算总和，除以可用端口个数。
• 根据输出格式进行类型转换：
  • 自动：若所有输入均为整数且平均值为整数（如 (2+4)/2=3），返回 INT，否则 FLOAT。
  • 强制整数：int(平均值)（向零截断）。
  • 强制浮点：float(平均值)。

⚠️ 注意事项

• 空输入保护：若没有可用输入端口（理论上不会发生，因为至少 2 个），返回 0.0。
• 动态端口清理：当后一个输入端口没有连线时，该端口会被视为“幽灵端口”并在计算时自动忽略，避免空值参与平均。
• 浮点精度：平均值可能涉及小数（如 1/3），结果以双精度浮点数存储，后续使用时可配合【截断保留小数】节点控制精度。
• 输出格式强制转换：强制整数会丢失小数部分（直接截断，不四舍五入）。如需四舍五入，请在平均值后连接【数学运算】中的 round() 或专用节点。

💎 小贴士：

• 如需计算加权平均值，可先用【数学运算】节点计算加权和与权重和，再使用本节点（或直接做除法）。
• 动态端口支持右键删除，当不再需要某个输入时，删除端口可使界面简洁。
• 结合【列表操作】节点，可以将列表中的所有值一次性展开连接到平均值节点（通过【列表展开】辅助节点）。
• 自动推断模式下，若所有输入均为整数但平均值不是整数（如 (1+2)/2=1.5），结果仍为浮点数，保持精度。