数据备份

先确认资料是否已备份#

连接 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 后需更新地址。操作入口可参照华为家庭存储官方说明。

例如 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 缓存会自动刷新,不必重启应用。
• 数据备份页可开启备份提醒，按三个通道中最近一次备份时间判断；提醒不会自动执行备份。服务器账号建议使用具有所需目录权限的专用账号，请妥善保管含凭据的备份文件。