Skip to content

fix(webview): 旧缓存迁移 + LTSC 文档补充(#423 follow-up) - #426

Merged
shadow01a merged 1 commit into
SlimeBoyOwO:developfrom
Ylsssq926:fix/webview-storage-migration-and-docs
May 26, 2026
Merged

shadow01a merged 1 commit into
SlimeBoyOwO:developfrom
Ylsssq926:fix/webview-storage-migration-and-docs

Conversation

@Ylsssq926

Copy link
Copy Markdown
Contributor

#423 合并后 @shadow01a 提到的两个点,这里补上:

1. 缓存迁移逻辑

后端从 winforms 切到 edgechromium 后,webview_storage_path 目录下的缓存格式不兼容。加了一个 _migrate_webview_storage(),在 webview 启动前检测:

  • 如果目录里有 EBWebView/(edgechromium 特征)→ 已经是新格式,跳过
  • 如果目录存在但没有 EBWebView/ → 旧后端遗留,重命名为 webview_storage_path_legacy 备份,让新后端从干净状态启动

这样老用户升级后不会因为旧缓存导致新后端异常,同时旧数据也没丢(备份在旁边)。

2. LTSC 文档

docs/faq/ui/index.md 加了一段,说明 Win10 LTSC 用户需要手动装 WebView2 Runtime,附了下载链接。

- 后端从 winforms 切到 edgechromium 后旧缓存格式不兼容,
  新增 _migrate_webview_storage() 在启动前检测并备份旧缓存目录,
  避免新后端读取不兼容数据导致异常
- FAQ 文档补充 Win10 LTSC 用户需手动安装 WebView2 Runtime 的说明
@shadow01a
shadow01a merged commit bba6238 into SlimeBoyOwO:develop May 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants