Skip to main content

更新 Elftia

Elftia 内置了自动更新机制，确保你始终使用最新版本。本页介绍更新的工作原理和手动更新方法。

自动更新​

Elftia 使用 electron-updater 实现自动更新。默认情况下，应用会在后台自动检查更新。

更新流程​

  1. 检查更新：Elftia 启动时以及运行期间，会定期向更新服务器查询是否有新版本。
  2. 下载更新：发现新版本后，安装包会在后台自动下载。下载过程中你可以继续正常使用应用。
  3. 提示安装：下载完成后，应用会显示更新通知，告知你新版本已准备就绪。
  4. 重启安装：点击通知中的「重启并安装」按钮，应用会关闭并安装更新，然后自动重新启动。
info

更新过程不会影响你的数据。所有对话记录、配置、API Key 等数据在更新后完好保留。

更新频道​

Elftia 根据版本号字符串自动确定更新频道：

频道版本格式示例说明
latest1.0.0正式稳定版，推荐所有用户使用
beta1.1.0-beta.1测试版，包含新功能但可能存在问题
alpha1.2.0-alpha.3早期预览版，面向开发者和测试者

默认情况下，你只会收到 latest 频道的更新。如果你希望提前体验新功能，可以参与测试版本的更新。

手动检查更新​

如果你希望立即检查是否有可用更新：

  1. 打开 设置 → 关于。
  2. 你会看到当前版本号和更新状态。
  3. 点击 检查更新 按钮。
  4. 系统会立即查询更新服务器：
    • 如果有新版本，会显示版本号和更新说明，并开始下载。
    • 如果已是最新版本，会显示「已是最新版本」的提示。

下载进度​

更新包下载时，你可以在关于页面查看下载进度：

  • 显示下载百分比和下载速度。
  • 下载可以在后台进行，不影响正常使用。
  • 如果网络中断，下载会在恢复后自动重试。

重启安装​

更新下载完成后：

  1. 应用会显示通知或在关于页面显示「重启并安装」按钮。
  2. 点击按钮后，Elftia 会：
    • 保存当前所有未保存的状态
    • 关闭应用
    • 执行更新安装
    • 自动重新启动
  3. 更新安装通常只需几秒钟到一分钟。
tip

你可以选择稍后重启。更新包已经下载完毕，下次正常关闭并重新启动应用时也会自动安装。

Steam 版本更新​

如果你使用的是 Steam 版本的 Elftia，更新方式有所不同：

对比标准版Steam 版
更新检查应用内自动Steam 客户端自动
下载方式应用内后台下载Steam 下载
安装方式重启应用Steam 自动安装
手动触发设置 → 关于 → 检查更新Steam → 右键游戏 → 检查更新

Steam 版本的更新完全由 Steam 客户端管理，你不需要在 Elftia 内进行任何操作。

便携版手动更新​

如果你使用的是便携版（Portable），自动更新可能不可用。手动更新步骤：

  1. 从官方网站或 GitHub Releases 下载最新版本的安装包。
  2. 关闭当前运行的 Elftia。
  3. 安装新版本：
    • Windows：运行新的安装程序，它会自动替换旧版本。
    • macOS：将新的 .app 替换到 Applications 文件夹。
    • Linux：替换旧的 AppImage 文件。
  4. 启动新版本。
info

你的数据存储在用户数据目录中（而非应用安装目录），因此手动更新不会丢失数据。

更新失败处理​

如果自动更新失败，请尝试以下步骤：

下载失败​

  • 网络问题：检查网络连接，如果使用代理请确保代理配置正确（参见 使用代理）。
  • 磁盘空间：确保系统有足够的磁盘空间用于下载更新包（通常需要 200-500 MB 的临时空间）。
  • 防火墙：确认防火墙未阻止 Elftia 访问更新服务器。

安装失败​

  • 权限问题：Windows 上可能需要管理员权限来安装更新。尝试以管理员身份运行 Elftia。
  • 文件锁定：确保没有其他程序锁定了 Elftia 的安装目录中的文件。
  • 手动更新：如果自动安装持续失败，请下载最新版本手动安装。

回滚​

如果新版本存在问题：

  1. 从 GitHub Releases 下载上一个稳定版本。
  2. 卸载当前版本。
  3. 安装旧版本。
  4. 你的数据会被保留，因为数据存储在用户数据目录中。
caution

极少数情况下，新版本可能包含数据库迁移。回滚到旧版本后，如果新版本已执行了数据库迁移，可能会导致兼容性问题。建议在更新前通过 设置 → 系统 → Export Diagnostics 导出诊断信息作为备份。

版本号说明​

Elftia 的版本号遵循 语义化版本规范：

主版本号.次版本号.修订号[-预发布标识]
部分含义示例
主版本号有重大变更或不兼容更新2.0.0
次版本号新增功能，向后兼容1.1.0
修订号Bug 修复和小改进1.0.1
预发布标识测试版本1.1.0-beta.1

如果更新后遇到问题，请参阅 常见问题 或 诊断工具。