归档导出:一份 ZIP 带走全部数据
.agora 是什么
「数据控制」分区里的导出功能产出一个 .agora 文件——本质是版本化的 ZIP 归档(当前格式版本 4)。它是 Agora 的通用数据容器:备份、换机、迁移到新手机、甚至给别人演示配置,都靠这一个文件。
归档里能装什么
按类别勾选,包含:
- 对话、任务运行、消息与相关的图结构数据;
- 附件、工具媒体与草稿媒体;
- 活跃记忆、保存的记忆与技能;
- 系统提示词;
- 应用设置与导入的自定义字体;
- API 密钥与其他敏感值——仅在明确勾选时才包含。
含密钥导出的红线
官方文档用加粗警告标出的唯一一条:归档内的密钥是明文存放的。实用结论:
- 只备份对话 → 不勾密钥,风险为零;
- 确实要连密钥一起迁移 → 妥善保管文件,传输用可信通道,用完即删;
- 网络代理密码同理:只在勾选了密钥类别时才进包。
导入是全然对称的
新设备上选择导入 .agora 文件,应用先加载预览,列出包里有哪些类别,然后按类别逐项选择处理方式——这套预览与合并逻辑单独开了一页:合并、替换与跳过。版本不兼容的归档会明确报错并禁用导入按钮,不会出现「导进一半」的状态。
手动导出的最佳时机
- 换机/重装前;
- 大版本更新前(见关于页与检查更新);
- 做了大规模整理(批量删分支、改记忆)之后。
嫌手动麻烦的,下一页有自动化方案:自动备份。