[rainRb]

问题与修改

本次测试的音响为 2026 新款漫步者/花再 Halo PixelBar，现场枚举得到 VID 0x2D99、PID 0xA160。原项目只接受 0xA106，因此新款会在路径筛选阶段被排除，导致“可用设备”列表为空、无法选择 HID。

官方于 2026 年 9 月发布 HALO PIXELBAR 强化版，并提供了常规版与强化版的升级说明。这里的新旧款 USB 参数来自原项目定义与本次设备实测；官方公开资料未提供 USB PID 对照表。

项目	原项目已适配的旧款	本次实测的 2026 新款
VID	0x2D99	0x2D99
PID	0xA106	0xA160
屏幕集合	MI_04 / Col02	MI_04 / Col02
UsagePage	0xFF24	0xFF14
Usage	原实现未限制	0x0001
输入/输出报告	原实现筛选 64 字节输入报告	均为 64 字节

修改使设备发现同时接受 A106 和 A160，保留 VID、Col02、64 字节输入报告筛选，并更新设置页说明、设备文档和变更记录。没有更改 HID 控制报文或扩大为任意 HID 设备匹配。

变更类型

• 问题修复
• 协议 / SDK
• 文档
• 新功能
• 持续集成 / 发布
• 其他

检查清单

• dotnet build PixelBar.slnx -c Release 通过（0 个错误；原歌词代码有 2 条 CS8604 警告）。
• 已阅读项目免责声明与 CONTRIBUTING。
• 未将构建产物、本地抓包、用户路径、设备唯一实例路径纳入补丁。
• 不涉及控制协议修改，附设备集合描述符实测信息。

验证结果

• 同一台 A160 音响：原 ListScreenEndpoints 返回 0 个设备，修改后返回 1 个正确的 MI_04 / Col02 屏幕接口。
• 新构建的 .NET 10 CLI 列出该音响，报告 UsagePage 0xFF14、Usage 0x0001，输入/输出均为 64 字节。
• 普通用户权限、TempoHub 运行期间，屏幕接口的元数据和共享读写句柄均打开成功。
• 完整 WinUI 客户端构建及本地安装完成，启动后显示“已连接 · 花再 Halo PixelBar”。
• A106 的匹配分支保留；本次没有旧款实机可供回归测试。
• 新款的文字、歌词、灯光等控制功能尚未逐项验证。本 PR 解决设备发现兼容问题。

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.