从 v1.x 本地数据库迁移到 v2.x

LobeHub v1.x 桌面端曾提供 本地数据库 模式 —— 数据保存在你的设备上。自 v2.x 起，我们转向 云端优先架构，移除了本地数据库。带来的变化：客户端更轻量、迭代更快、在浏览器、桌面和手机间体验一致。

<Callout type="info"> **为什么要改？** v1.x 的本地数据库占用更多系统资源，而实际使用的用户占比较小。简化客户端、聚焦云端优先后，我们可以提升整体性能并更快交付新功能。 </Callout>

本文引导你完成 从 v1.x 导出 和 导入到 v2.x。你的助理、对话和设置都可以迁移过来 —— 通常只需几分钟。

开始前准备

• 先不要卸载 v1.x —— 确认迁移成功后再卸载。
• 确保网络稳定 —— 对话记录较多时，导入可能需要更长时间。
• 登录 v2.x —— 云端版（app.lobehub.com）或你的自托管实例。

希望自托管？先按自托管指南部署 v2.x，再将数据导入该实例。

如果你已经升级到 v2.x

依然可以完成迁移。升级到 v2.x 不会删除本地数据库文件 —— 它们会保留在磁盘上，直到你手动删除。

1. 从 GitHub Releases 下载 v1.x 版本。
2. 安装并打开 v1.x，导出数据：设置 → 数据存储 → 导出数据。
3. 在 v2.x 中进入 设置 → 数据存储 → 导入数据，上传导出的文件。

本地数据库文件在哪里？

v1.x 本地数据库默认位于：

• Windows： %APPDATA%/lobehub-storage/lobehub-local-db
• macOS： ~/Library/Application Support/lobehub-storage/lobehub-local-db

如需手动恢复数据，这些路径可能有用。

可以迁移的内容

根据你的 v1.x 版本和导出格式，通常可迁移：

项目	是否迁移
助理	是 —— 名称、提示词、模型设置
对话与话题	是 —— 消息和话题结构
提示词模板	是（若 v1.x 版本支持）
基础偏好	是 —— 语言、主题、快捷键（若版本支持）

不会迁移的内容

项目	说明
API Key 与密钥	出于安全，请在 v2.x 重新填写。v2.x 使用不同的存储方式。
仅本地的临时文件 / 缓存	不适用于云端的临时数据。
设备相关设置	部分设置与旧版本地环境绑定。

<Callout type="warning"> 若导出文件包含敏感内容，请妥善保管，避免在公开渠道分享或提交到版本库。 </Callout>

第一步：在 v1.x 导出数据

在 v1.x 桌面端：

1. 进入 设置 → 数据存储 → 导出数据。
2. 你会得到一个 JSON 文件（例如：2026-01-22-10-02_LobeHub-data.json）。
3. 将文件保存到容易找到的位置 —— 桌面或专用文件夹。

提示：

• 历史记录很多时，导出可能需要几分钟。建议在设备空闲时操作。
• 在 v2.x 中确认导入成功前，请保留该文件。

第二步：在 v2.x 导入数据

在任意 v2.x 应用中（桌面端、网页端或自托管）：

1. 登录你的 LobeHub 账号。
2. 进入 设置 → 数据存储 → 导入数据。
3. 上传第一步导出的 JSON 文件。
4. 等待导入完成。若界面未更新，可刷新页面或重启应用。

提示：

• 导入过程中不要关闭应用或离开页面，等待完成。
• 若 v1.x 中有多个配置或空间，可分别导出并逐个导入（若版本支持）。

迁移后如何验收

导入完成后，建议检查：

• 助理 —— 是否齐全？提示词和配置是否正确？
• 对话 —— 近期话题和消息能否正常打开、内容是否完整？
• 设置 —— 语言、主题、快捷键是否符合预期？

如有缺失，请保留 v1.x 导出文件。升级到最新 v2.x 后再试一次导入 —— 新版本的导入逻辑可能已改进。

故障排查

导入失败或长时间卡住

• 检查网络 —— 需要稳定连接。可尝试更换网络后重试。
• 更新 v2.x —— 使用最新版本，导入逻辑会持续优化。
• 缩小范围 —— 若有多个导出文件，可先导入较小的一个，排查是否为数据量导致的问题。

导入后部分数据缺失

• 不同 v1.x 版本 —— 数据结构可能略有差异。建议从你一直在用的同一 v1.x 版本重新导出。
• 多配置 / 多空间 —— 若 v1.x 中使用过多个配置或空间，可分别导出并逐个导入。

导出文件很大

• 对话很多时，导出文件较大是正常的。导入可能需要几分钟，请耐心等待并保持应用或标签页打开。

获取帮助

若遇到问题：

• 帮助与支持 —— 通用资源与社区链接
• GitHub Issues —— 反馈 Bug 或请求迁移帮助

反馈时请注明 v1.x 版本、v2.x 版本以及具体问题。如有可能，说明导出是否成功完成、导入在哪个环节失败。