更新 Elftia

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

自动更新

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

更新流程

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

信息

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

更新频道

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

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

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

手动检查更新

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

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

下载进度

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

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

重启安装

更新下载完成后：

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

提示

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

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. 启动新版本。

信息

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

更新失败处理

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

下载失败

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

安装失败

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

回滚

如果新版本存在问题：

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

警告

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

版本号说明

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

主版本号.次版本号.修订号[-预发布标识]

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

---

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