Companion项目中布尔变量反馈更新的Bug分析与修复

问题背景

在Companion v3.5.3版本中，用户发现当使用布尔类型的模块变量作为反馈条件时，"internal: Variable: Check boolean expression"功能存在一个关键缺陷。具体表现为：在Companion重启后，虽然变量值确实发生了变化（通过按钮文本可以验证），但反馈状态却未能正确更新。

技术现象

该Bug的主要特征包括：

1. 反馈表达式使用布尔变量时无法实时响应变量变化
2. 仅当手动修改表达式内容（如添加/删除空格或换行）后，反馈功能才恢复正常
3. 使用字符串形式的比较（如$(var)==true）或"Check value"反馈类型可正常工作
4. 该问题仅影响模块提供的布尔变量，不影响自定义变量（因为自定义变量会被转换为字符串）

根本原因分析

经过技术团队调查，发现该问题源于布尔表达式的解析机制存在缺陷。在Companion重启后，布尔变量的监听器未能正确建立与反馈系统的连接，导致变量变更事件无法触发反馈更新。

解决方案

Companion开发团队在v3.5.4版本中修复了此问题。修复方案主要涉及：

1. 改进了布尔表达式的解析和监听机制
2. 确保了变量变更事件能够正确传播到反馈系统
3. 增强了表达式解析器的健壮性

开发者建议

对于需要使用布尔变量反馈的场景，建议：

1. 升级到v3.5.4或更高版本以获得完整修复
2. 如果暂时无法升级，可采用以下临时解决方案：
   • 使用字符串形式的比较表达式
   • 改用"Check value"反馈类型
   • 在表达式后添加注释或空格以强制刷新解析

技术启示

这个案例展示了动态表达式解析系统中的一个常见陷阱：变量监听机制的失效。在开发类似系统时，需要特别注意：

1. 持久化状态的恢复过程
2. 变量引用与监听器的生命周期管理
3. 表达式解析缓存的处理

Companion团队通过这次修复，不仅解决了具体问题，还进一步巩固了其变量系统的可靠性。