Web 版 Chaldea 使用——免安装随时随地打开

两个版本

两个版本数据一致，但下载源和服务器地址不同。国内用户用国内版能避免网络问题。

浏览器要求

从 2.5.0 版本起，Web 版使用了 WebAssembly / WeakRef 等较新的浏览器特性，老版本浏览器无法运行。

两种渲染器

Web 版有两种渲染模式，在设置 → 通用设置 → Web 渲染器 里可以切换：

HTML 渲染器

• 优点：下载体积小，使用系统字体，加载快
• 缺点：页面布局可能有轻微错位，字体计算偶尔不准；不支持应用内截图（Laplace 编队截图不可用）
• 场景：网络慢的环境、移动端浏览器、不常用截图功能的用户

CanvasKit 渲染器

• 优点：和 Flutter 原生平台渲染完全一致；支持应用内截图（Laplace 编队保存 PNG 截图）
• 缺点：首次加载需要下载 CanvasKit 引擎（几 MB）和 Google Fonts（运行时渲染，可能有几秒字体缺失）
• 场景：桌面端 Chrome/Edge/Firefox、需要 Laplace 截图功能的用户

自动选择

默认选项是"自动"，由 Flutter 引擎根据当前环境判断。大部分情况下自动模式的选择是合理的。

移动端浏览器注意事项

移动端不推荐使用 Web 版——性能和兼容性都比原生 App 差。主要问题：

• CanvasKit 渲染器在手机浏览器上卡顿明显
• 部分页面布局错位（Flutter 的移动端适配在 Web 上不完整）
• 浏览器会回收 IndexedDB 存储，可能导致数据丢失

如果只能用手机浏览器访问，建议切换到 HTML 渲染器、定期备份数据。

Firefox 特殊说明

Firefox 用户注意：

• 隐私模式 / 清除历史设置会禁用 IndexedDB，导致 Chaldea 无法启动。退出隐私模式或关闭相关设置即可
• 部分 Beta 版 Firefox 可能有 WebAssembly 兼容性问题

数据存储

Web 版的数据存储在浏览器的 IndexedDB 中。这意味着：

• 清除浏览器数据 = 丢失所有 Chaldea 数据（包括你的练度和素材库存）
• 换浏览器、换电脑 = 看不到之前的数据（除非用在线备份）
• 定期导出备份很重要

Web 版支持在线备份和 GitHub 同步，强烈建议开启其中之一。

与桌面端的协同

Web 版和桌面版（Windows / macOS / Linux）的数据不互通，除非：

• 你在两边都登录同一个 Chaldea 用户账号，并手动上传 / 下载备份
• 或在 GitHub 同步同一个仓库的同一个文件

数据文件结构在各端都一样——核心就是一个 userdata.json 文件。手动导出这个文件在不同端之间复制也可以实现同步。

PWA 安装

Chrome / Edge 浏览器支持把 Web 版"安装"成一个 PWA 应用：

• 访问 chaldea.center 或 cn.chaldea.center
• 浏览器地址栏应该会显示一个"安装"图标
• 点击后会在桌面或启动器生成一个独立图标
• 打开后是全屏无浏览器壳的窗口

PWA 安装后数据还是存在浏览器里，清除浏览器数据仍然会丢失。但体验上更接近原生应用。