# 数据备份 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：数据与同步。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/backup/ ## 先确认资料是否已备份 连接 Cube Agent 在线服务、登录华为账号或恢复购买，都不会自动备份聊天记录与知识库。请单独执行数据备份，确认上传成功；仅显示云盘已就绪或待上传，不代表备份已完成。当前备份需要手动执行，不是实时同步。 ## 本地导出 / 导入 可以把对话、附件与配置打包成一个备份文件。在新设备或重装应用后,使用 **设置 → 数据与同步 → 导入数据** 恢复。第三方应用备份导入请看“导入第三方备份”。 打开 **设置 → 数据与同步 → 导出数据**，默认使用 **备份迁移** 并选中可导出的内容，可取消不需要的条目，核对后保存文件、分享文件或使用实验性碰一碰传送。导入与碰一碰接收共用核对流程：对话、记忆和用量默认合并，对话冲突保留恢复分支，记忆不同内容同时保留；配置冲突默认跳过。也可主动选择跳过、保留完整副本或替换，替换需确认可能丢失本机独有内容。 ## 所选配置的凭据会一起导出 服务商 API Key、多 Key 池、自定义请求头、搜索密钥、MCP 鉴权、SSH 密码／私钥／口令及助手环境变量，都会随所属配置一起导出。选择 **分享内容** 也不会自动移除这些凭据；不希望传送某项配置时，应取消选择该配置。完整数据备份还会携带 SMB 连接配置及密码；当前选择性传送不包含 SMB 连接配置。 核对页会说明文件包含明文凭据，条目预览不显示凭据值。配置或凭据无法完整读取时，整次导出失败，需要解决错误后重试，不会生成缺少凭据的成功包。请仅保存到可信位置或交给可信接收方，不要把包附在反馈中。 若清单提示部分技能或文件名称不受支持，这些内容不会列入可选项。技能作为整体检查，不会只传一部分脚本或配置；请整理名称后重新读取清单。其他可选内容仍可正常导出。 历史消息的模型名称和 ID 会随导入保留；旧备份缺少凭据时保留本机已有密钥。知识库目录、助手规则与开场配置也随相应数据导出；导入后自动模型开场关闭，后续需要时再启用。知识库目录请使用支持该功能的版本恢复，旧版重写可能丢失层级。 选择性传送仍遵循导入规则，部分模型连接或助手工具绑定需要重新检查；生成图片分类不等于完整生图任务备份。重复导入并选择保留两份会继续增加副本，不等同于设备自动同步。 ## 数据备份（华为云盘 / WebDAV / SMB） 入口在 **设置 → 数据与同步 → 数据备份**。同一页面用顶部切换选择通道，共用立即备份与备份历史；华为云盘和 SMB 从 **恢复** 选择文件夹，WebDAV 可使用 **恢复最新**： - **华为云盘**：登录华为账号，并在系统云空间允许本应用使用云盘，备份包保存在你自己的华为云空间。 - **WebDAV**：配置网盘或服务器的 WebDAV 地址、目录与登录凭据，适合已提供 WebDAV 服务的网盘或 NAS。 - **SMB 备份**：连接 NAS、家庭存储或电脑开放的 SMB 2/3 共享，将备份保存到指定共享内的目录。通常在同一局域网使用；应用不会自动为 NAS 开通外网访问。 SMB 客户端要求服务器支持签名，目前不支持 SMB1，也不会自动发现 NAS；请手动填写设备的地址和共享信息。 三个通道共用同一套备份格式： 1. 备份范围包含知识库、对话、附件／生图、助手、服务商密钥、偏好等；需要只导出部分会话时请用 **设置 → 数据与同步 → 导出数据**。 2. 首次 **立即备份** 生成完整备份，作为后续增量的基础；文件名以 `cubeagent_backup_` 开头。 3. 完整备份及变更记录仍可用时，后续只上传变更，增量文件名以 `cubeagent_incr_` 开头；无新增变更时不上传。 4. **恢复最新** 会恢复所选来源的完整备份与连续增量；华为云盘和 SMB 先选择文件夹，WebDAV 多来源时先选择设备；消息与记忆逐条合并，保留本机独有内容；单边续聊补入原会话，双方续聊或共同消息冲突时另存为「恢复分支」。全局及助手记忆保留两端不同内容，增量备份中的删除记录不会删除本机数据。 5. 要先看清单，请在 **最近备份** 中点击指定历史条目的 **恢复**。应用先下载、检查文件并显示会话、消息、附件等统计，点击 **确认恢复** 后才写入；点击取消不会导入。此入口只恢复所选包，单个增量包只含该次变更。历史条目也可单独删除，删除可能使依赖它的增量链不再完整，操作前请确认仍有可用的完整备份。 ## 华为云盘：备份位置与恢复 - **备份位置 → 更改**：选择已有文件夹或新建文件夹。默认按设备分开存放；切换位置后，下次备份会生成完整包。升级后设备标识变化时，也会重新建立完整基线，不需要删除旧包。 - 备份位置只保存在当前设备，不随备份迁移。设备标识在系统允许的有效期内稳定，不能保证卸载重装后不变；重装后可在恢复列表中手动找到旧文件夹。以前安装产生的备份仍可能显示为“其他设备”。 - **恢复 → 文件夹 → 最新状态**：恢复该文件夹内可用的完整备份及其连续增量。**选择具体版本 → 恢复** 则先下载并展示预览，确认后才写入。应用会核对增量包依赖的完整基线；无法验证或断链时，只保留已成功恢复的部分并提示，不能把不同安装的序号直接拼成一条链。 - 旧版本直接存放的包显示在 **旧版备份** 中，不自动迁移或删除。另一台设备默认使用自己的文件夹；查找其他设备备份时，请从 **恢复** 进入文件夹列表，而不是只看当前位置的“最近备份”。 ## 华为云盘：清理与清空 “云空间内容”卡片底部有两个不同的操作，都需要二次确认： - **清理历史数据**：删除旧版备份、异常残留或其他列出的历史条目。勾选时只清理所选项；未勾选时清理确认时列出的全部历史项。所选目录包含其中全部内容，新发现的条目不会自动加入本次清理。请先检查名称与用途，不要把仍需恢复的旧版备份当成无用文件。 - **清空此备份位置**：删除当前备份文件夹中的全部内容，并清理异常残留；其他备份文件夹与旧版根目录备份不随之清空。若其他设备也使用这个位置，它们的文件同样会被删除，请先停止向该位置备份。清空后下次重新生成完整备份。 两种操作都不会清空本机聊天，但云端删除不可恢复；中途失败时可能已有部分条目被删除，应刷新核对后再决定是否重试。目录重新扫描与同步完成不等于锁住其他设备，其他设备稍后写入仍可能重新出现文件。 ## 配置 SMB 备份 在 **SMB 备份 → 服务器配置 → 编辑** 填写以下内容。假设 NAS 地址为 `192.168.1.10`、已开放共享 `backup`，希望以其中的 `CubeAgent/phone` 作为备份根目录： - **地址**：填 `192.168.1.10` 或可解析的主机名，只填主机部分，不附加共享路径或端口。 - **共享名称**：填 `backup`，必须与设备在网络邻居／SMB 中已开放的共享名称一致；不是设备名称，不要填写本地磁盘路径或多级目录。 - **备份子目录**：填 `CubeAgent/phone`，表示共享内的子目录；默认是 `CubeAgent`，留空从共享根目录开始；开启“按设备分目录”后，还会在其下追加本机目录。测试连接或备份时会创建缺少的目录，需写入权限。目录不能包含 `..`。 - **账号、密码**：填写具有目标目录读写权限的共享账号和密码。 - **更多设置**：域通常留空，只有服务器要求时才填，例如 `WORKGROUP`；端口默认 **445**，服务器使用其它 SMB 端口时再修改，范围为 1～65535；不要填写 NAS 管理网页的端口。 华为家庭存储需先在设备管理入口开启 **网络邻居／SMB 共享**，常见入口为智慧生活的家庭存储页面中的 **应用服务 → 网络邻居**，具体名称与位置随设备和版本而异。这里使用的是 **网络邻居设置的账号和密码，不是华为账号密码**；共享名和当前 IP 以设备页面实际显示为准，路由器重新分配 IP 后需更新地址。操作入口可参照[华为家庭存储官方说明](https://consumer.huawei.com/cn/support/content/zh-cn15927787/)。 例如 `smb://192.168.1.10/backup/CubeAgent/phone` 中，`backup` 是共享名称，`CubeAgent/phone` 才是备份子目录；不是两个可互换的路径。 填写后先点 **测试连接**。SMB 测试会在目标目录实际检查临时文件的写入、读取、重命名与清理权限，测试成功后点击 **保存**，返回备份页再点 **立即备份**。测试成功不等于配置已经保存，也不等于完成备份；修改字段后应重新测试。操作忙碌时无法改目标，请等待完成或按页面提示取消。 换到新的服务器、端口、共享目录或访问账号时，会使用该目标独立的备份进度，首次备份重新生成完整备份，不会延续旧目标的增量进度。各目标分别保留历史；修改并保存 SMB 连接配置后，下次备份也会重新生成完整包，以完整携带最新配置和密码。多个通道交替备份时，如果某个通道落后、所需变更记录已被清理，或远端完整备份已缺失，应用会自动重新生成完整备份；这时包变大、耗时增加属于正常行为。 SMB 连接密码在本机安全存储中保存。设备锁定、凭据缺失或不可读取时，请先解锁并重新打开配置，必要时重新输入密码保存；不会用读不到的密码冒充空密码继续操作。本机安全存储不代表备份文件已加密：完整数据备份会携带 SMB 配置及密码，所选业务配置的凭据也会按上述规则进入备份或导出包，预览仅隐藏其值。需要导出的配置或凭据无法完整读取时，整次备份／导出会停止，不生成缺少凭据的成功包。 ## SMB：多设备目录、恢复与删除 - **按设备分目录**：新配置默认开启。例如共享为 backup、备份子目录为 CubeAgent，实际备份位置为 CubeAgent/device-设备标识。主页面显示实际位置；目录标识由哈希派生，不包含原始设备标识。 - **已有配置升级**：保留原路径，不自动开启分目录，也不搬迁或删除旧文件。手动开启后，新目录首次生成完整备份；关闭后重新使用原目录。重装或系统标识重置后，本机目录可能变化，旧目录仍可从恢复入口找到。 - **查找旧版或其他设备备份**：进入 **恢复**，选择原目录中的 **旧版备份** 或其下的设备文件夹，再选择版本。浏览不会改变本机备份位置，也不会把其他设备目录设为上传目标。列表只浏览配置根目录及其直接子目录；更深的历史目录需将备份子目录设为该位置，并关闭按设备分目录后恢复。 - **恢复最新状态**：会合并所选目录内各设备的完整备份和连续增量，开始前再次确认；同一条本机记录可能被更新。只想查看或恢复某次备份时，选择具体版本，下载并核对预览后再确认。 - **删除备份**：确认框显示目标目录和文件名，只删除该文件，不递归清空目录。确认后若配置已变化，需重新确认；删除完整基线可能使依赖它的增量无法恢复。恢复列表不提供其他设备目录的删除入口。 目录隔离用于避免多设备混写，不代替服务器权限。使用同一 SMB 账号的人仍可能通过其他工具访问这些目录；备份也不是多设备实时双向同步。 ## SMB 连接与恢复遇到问题时 - **无法连接或超时**：确认 NAS 在线、共享服务已开启，手机与服务器网络可达，检查地址、端口及路由器的设备隔离设置。在外网使用需已有可达网络，仅填家庭内网 IP 不能自动远程连接。 - **认证失败**：检查共享账号、密码以及服务器是否要求域；华为家庭存储请检查网络邻居账号。 - **没有读写权限**：检查共享与目录两级权限。能浏览目录不一定能备份，测试所用的写入、读取、重命名和删除临时文件都需要授权。 - **共享、目录或文件不存在**：核对共享名与子目录后刷新列表；查找另一台设备的备份时，连接同一配置根目录，再从“恢复”选择来源目录。 - **空间不足或校验失败**：检查 NAS 和手机的可用空间、网络稳定性，解决原因后重试。出现失败提示或只显示传输进度，均不能当作备份成功。 ## 备份范围与运行 完整备份包含知识库正文、索引及库内已保存的原始文件，不包含尚未导入应用的外部文件；还会包含会话工作目录中由 AI 生成的文件，以及助手使用的自定义聊天壁纸。恢复到新设备后，这些文件和壁纸会一并还原。只导出部分会话时，可按需关闭“包含工作目录文件”以减小备份包体积。 备份与恢复支持切到后台继续（长时任务保活），实际运行仍受系统限制。备份可按页面提示取消，大量消息版本读取期间也会响应取消；恢复进入数据写入阶段后暂不可取消，避免只恢复部分数据。 消息导出采用分页读取与分块写入，完整保留超长正文；不会为缩小备份而截断消息。备份仍可能需要较长时间和可用存储空间。 若清单提示部分技能或文件名称不受支持，这些内容不会列入可选项。技能作为整体检查，不会只传一部分脚本或配置；请整理名称后重新读取清单。其他可选内容仍可正常导出。 导出与碰一碰会提前核对所选 SSH 配置的登录凭据。若凭据已失效，请到远程连接重新填写密码或选择私钥并保存；设备锁定时先解锁。读取凭据失败会终止整次导出，不生成缺失凭据的成功包。预览不展示凭据值，但导出包包含所选配置的明文凭据。 ## 华为云盘同步与上传状态 - 上传阶段会同时监听系统同步状态与文件上云结果。网络不可用、系统限制仅 WLAN、低电量、云空间已满、本机空间不足或设备温度过高时，会尽快显示可操作原因，不再长时间无反馈。 - 上传阶段显示 **正在同步至华为云空间** 的等待状态，耗时取决于备份大小和网络。系统没有提供该文件的上传字节进度，因此不显示按等待时间增长的百分比；只有确认目标文件实际上传完成才会记为成功。 - 新建文件夹与刷新备份历史会先等待云端目录同步完成。刚完成新建或清理时，系统可能短暂返回“未就绪”（22400001），应用会自动短暂退避重试，仍未恢复时才提示失败。同步失败或超时时保留上次显示的列表，并提示检查或重试；保留列表不代表它已经是云端最新状态，也不能据此判断备份已被删除。 - 上传中断后仅留在本机、尚未真正上云的包会标记为 **待上传到云端**，也不会改写“上次备份”时间或显示为安全备份。 - 仅在云端的备份会先下载到本机，再复制到导入缓存。下载启动与传输都响应取消和超时；取消或失败后会尽力停止系统下载，未确认恢复前不写入业务数据。请预留下载和解压所需空间。 若提示云目录或系统同步服务异常，可按提示关闭再重新开启系统云空间中的应用同步开关，仍无效时重启设备并提交诊断日志。遇到备份目录被同名非目录条目占用时，应用会尝试保留原内容后修复；无法安全处理时会明确失败。 ## 另一台设备看不到备份时 先确认两端使用同一华为账号、系统云空间中已允许本应用同步，并确认源设备的备份已经上传成功，再在目标设备刷新备份历史。遇到目录尚未同步完成或同步受限提示，按原因检查网络、WLAN 限制、电量和空间后重试。仅在源设备生成备份文件不代表已上云；更新应用也不会自动把旧的未上传备份变成已完成备份。 ## 注意事项 - 华为云盘、WebDAV 与 SMB **分别记录备份进度与历史**，可以按需使用多个通道；切换通道不会自动复制其它通道的备份。 - 这是 **灾备备份**,不是双设备实时协同:两台都改再互相同步可能互相覆盖,建议明确一台主设备日常备份。 - 备份包含所选配置的密钥和登录凭据，请只保存到可信位置，预览隐藏值不代表导出文件已经脱敏。 - 知识库正文会随 1.4.3 及之后版本的备份恢复;更旧的备份若只有挂载引用,需在新设备重新导入知识库。 - 导入偏好后默认模型和 Prompt 缓存会自动刷新,不必重启应用。 - 数据备份页可开启备份提醒，按三个通道中最近一次备份时间判断；提醒不会自动执行备份。服务器账号建议使用具有所需目录权限的专用账号，请妥善保管含凭据的备份文件。