Emacs Plus 项目中 xwidget-webkit 用户代理的现代化改造

在 Emacs 29 及以上版本中，xwidget-webkit 组件默认使用了一个过时的用户代理(User Agent)字符串，这会导致许多现代网站无法正确识别浏览器版本，从而影响用户体验。本文将深入分析这一问题，并探讨解决方案。

问题背景

xwidget-webkit 是 Emacs 中用于嵌入 WebKit 浏览器的组件，其核心代码位于 src/nsxwidget.m 文件中。当前实现中硬编码了一个非常古老的用户代理字符串：

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/603.3.8 (KHTML, like Gecko) Version/11.0.1 Safari/603.3.8

这个字符串对应的是 2017 年发布的 Safari 11 浏览器，而现代 macOS 系统(如 macOS 14.6)搭载的是 WebKit 618.3.11 引擎(Safari 17)。这种版本差异会导致网站将浏览器识别为过时版本，可能触发降级体验或安全警告。

技术分析

现代 Safari 浏览器的用户代理字符串模式已经发生了变化。当前最新版本的模式为：

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6 Safari/605.1.15

值得注意的是，Safari 从版本 14 开始就固定了 WebKit 版本号为 605.1.15，仅通过 Safari 版本号来区分不同发布版本。

解决方案探讨

理想的解决方案应该动态获取当前系统 Safari 浏览器的版本信息，自动生成匹配的用户代理字符串。这可以通过以下 shell 命令实现：

/usr/libexec/PlistBuddy -c "Print :CFBundleShortVersionString" /Applications/Safari.app/Contents/Info.plist

获取版本号后，可以构建如下的用户代理字符串：

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6 Safari/605.1.15

作为临时解决方案，也可以直接硬编码更新后的字符串。虽然不够灵活，但相比当前使用的过时代码已有显著改进。

实施建议

由于这个问题源于 GNU Emacs 的上游代码，最佳实践是向 Emacs 开发团队提交补丁。同时，用户可以通过以下方式自行解决：

1. 创建本地补丁文件
2. 修改 nsxwidget.m 中的相关代码
3. 使用 homebrew 的本地构建功能应用补丁

这种方案既保持了与上游代码的一致性，又解决了实际问题，是当前最合理的折中方案。

总结

xwidget-webkit 的用户代理现代化是提升 Emacs 网页浏览体验的重要一步。虽然目前需要通过补丁方式解决，但这个问题凸显了开源软件生态中维护浏览器组件兼容性的挑战。随着 Web 标准的快速演进，类似的兼容性问题可能会持续出现，需要开发者社区的持续关注和协作解决。