Matomo设备检测库中Windows 11识别问题解析

问题背景

在使用Matomo设备检测库时，开发者发现Windows 11系统被错误识别为Windows 10。这是由于Windows 11的User-Agent字符串中仍然包含"Windows NT 10.0"标识，与Windows 10相同。

技术原理

现代浏览器通过两种方式提供设备信息：

1. 传统的User-Agent字符串
2. 新的Client Hints(客户端提示)机制

Windows 11的识别问题源于User-Agent字符串未更新。微软官方文档明确指出，要区分Windows 10和Windows 11，必须使用Client Hints中的platformVersion参数。

解决方案

要正确识别Windows 11系统，需要以下步骤：

1. 启用Client Hints接收：服务器必须明确声明支持接收哪些Client Hints参数。这可以通过HTTP响应头实现：

header('Accept-CH: Sec-CH-UA, Sec-CH-UA-Mobile, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version, Sec-CH-UA-Full-Version, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Arch, Sec-CH-UA-Model, Sec-CH-UA-Form-Factors, Sec-CH-UA-Bitness, Sec-CH-UA-WoW64');

2. 解析platformVersion：获取到Client Hints后，检查platformVersion值：
   • 1.0.0到12.0.0之间：Windows 10
   • 14.0.0及以上：Windows 11

实现建议

对于PHP开发者，完整的实现示例应包含：

1. 在响应中设置Accept-CH头部
2. 在后续请求中解析$_SERVER变量中的Client Hints
3. 使用Matomo设备检测库的ClientHints类处理这些信息

注意事项

1. 不是所有浏览器都默认发送Client Hints，必须显式请求
2. 某些平台可能不支持Client Hints机制
3. 为兼容性考虑，应同时处理传统User-Agent和Client Hints

总结

正确识别Windows 11需要开发者主动启用并处理Client Hints信息。Matomo设备检测库已支持这一机制，但需要开发者正确配置服务器以接收这些提示。这一解决方案不仅适用于Windows 11识别，也为未来新操作系统版本的识别提供了可扩展的框架。