Emacs Application Framework (EAF) 浏览器模块的持久化存储改进

背景介绍

Emacs Application Framework (EAF) 是一个将现代图形应用集成到 Emacs 中的框架，其中包含了一个基于 Qt WebEngine 的浏览器模块。在 Qt6 版本的 WebEngine 中，默认使用了"off the record"（无痕）模式，这导致浏览器每次关闭后都会清除 localStorage 数据，影响了如即时通讯应用、在线文档编辑等现代 Web 应用的使用体验。

问题分析

Qt WebEngine 的无痕模式会带来以下影响：

1. 本地存储（localStorage）数据在会话结束后被清除
2. 网站无法持久化保存登录状态
3. 依赖本地文件系统 API 的应用无法正常工作
4. 每次都需要重新登录 Web 应用

解决方案

通过修改 EAF 的 webengine.py 文件，实现了以下改进：

1. 创建持久化配置：

   • 建立了一个名为'eaf'的持久化 WebEngine 配置
   • 强制启用持久化 cookies 策略
   • 设置磁盘 HTTP 缓存

2. 配置调整：

   • 启用 localStorage 支持
   • 处理配额请求和文件系统访问请求
   • 保持默认的用户代理设置功能

3. 移除冗余功能：

   • 移除了自定义的 CookiesManager 类（在后续提交中）
   • 将 cookie 管理完全交给 Chromium 引擎处理

技术实现细节

1. 配置初始化：

webengine_profile = QWebEngineProfile('eaf')
webengine_profile.setPersistentCookiesPolicy(QWebEngineProfile.PersistentCookiesPolicy.ForcePersistentCookies)
webengine_profile.setHttpCacheType(QWebEngineProfile.HttpCacheType.DiskHttpCache)

2. 页面和视图初始化：

def __init__(self, profile, buffer_id):
    super(QWebEngineView, self).__init__(profile)
    # ...
    self.page().quotaRequested.connect(lambda request: request.accept())
    self.page().fileSystemAccessRequested.connect(lambda request: request.accept())

3. 存储设置：

self.settings.setAttribute(QWebEngineSettings.WebAttribute.LocalStorageEnabled, True)

影响与优势

1. 用户体验提升：

   • Web 应用可以记住登录状态
   • 本地编辑的文档能够保存
   • 应用设置和偏好可以持久化

2. 兼容性增强：

   • 支持更多现代 Web 应用
   • 正确处理大尺寸 cookies
   • 符合现代 Web 标准

3. 代码简化：

   • 移除了自定义 cookie 管理逻辑
   • 减少了维护成本
   • 提高了稳定性

总结

这项改进使 EAF 浏览器模块更适合日常使用，特别是对于那些依赖现代 Web 技术的应用。通过利用 Qt WebEngine 的内置持久化功能，不仅解决了存储问题，还简化了代码结构，提高了整体可靠性。对于 Emacs 用户来说，这意味着可以在熟悉的编辑环境中无缝使用各种现代 Web 应用，而无需担心数据丢失的问题。