Companion项目中Stream Deck页面变量显示异常的Bug分析与修复

问题背景

在Companion 3.5.0版本中，用户发现一个与Stream Deck页面导航相关的变量显示异常。该变量$(internal:surface_streamdeck_XXX_page)原本设计用于显示当前Stream Deck的页面编号，但在新版本中却显示为类似"z9dnivw6XnQidNpisVOl1"的随机字符串。

技术细节

这个变量是Companion内部用于追踪Stream Deck设备当前显示页面的特殊变量。用户通常将其用于：

• 创建智能导航按钮（短按翻页、长按返回）
• 在按钮上动态显示当前页面号
• 构建复杂的页面导航逻辑

在正常情况下，该变量应该返回一个简单的数字字符串（如"1"、"2"等），表示当前所在的页面编号。但在3.5.0版本中，由于底层代码变更，它错误地返回了内部使用的唯一标识符(UID)而非页面编号。

影响范围

该Bug主要影响：

1. 依赖此变量显示当前页面号的用户界面元素
2. 使用此变量进行页面跳转逻辑判断的自动化脚本
3. 需要动态显示页面信息的自定义按钮配置

解决方案

Companion开发团队在3.5.1版本中修复了此问题。修复内容包括：

1. 恢复变量返回页面编号而非UID的设计
2. 确保变量与页面导航系统的兼容性
3. 保持对可变页面数量的支持

最佳实践建议

对于需要使用页面导航功能的用户，建议：

1. 升级到3.5.1或更高版本
2. 对于关键导航功能，可考虑添加备用显示方案
3. 在复杂导航逻辑中，可结合使用多个变量进行交叉验证

总结

这个Bug虽然看似简单，但对依赖页面导航功能的用户影响较大。Companion团队快速响应并在下一版本中修复了问题，体现了对用户体验的重视。用户应及时更新到修复版本以确保功能正常。