跳到正文
Orrery文档
官网首页

试试「BYOK」「知识视野」或「资料摄取」。

使用指南
资料库与数据持续完善中

资料库与数据|备份与恢复

分清本地保存、模型请求、账号配置与恢复操作。

先区分“数据保存在哪里”和“在线任务发送了什么”。本地保存笔记,不代表在线 AI 请求不会包含你的问题、引用片段、图片或工具结果。

需要分别考虑的数据

  • 资料与成果:保存在实际选择的资料库或授权目录。
  • 会话与运行数据:会话记录使用资料库内的 .orrery/sessions 等目录;索引和其他运行数据另有各自文件。
  • 设置与凭据:部分保存在应用本地存储,凭据可能使用系统提供的安全存储。
  • 用户级技能:保存在本机用户级技能目录,不等同于每个资料库的正文。

因此,只复制几个 Markdown 文件不能备份整个工作环境。账号登录也不等于所有会话、记忆、资料和技能都自动云同步。

  • 目录映射只是备份前的范围核对,不是备份已经完成
    目录映射只是备份前的范围核对,不是备份已经完成。

重要修改前先做可用备份

批量改写或整理前,先确认现有备份包含原文、附件和需要保留的历史。需要完整迁移时,也要考虑隐藏目录与本机设置;凭据恢复应按服务的登录或配置流程处理,不要把密钥写进普通笔记。

备份完成后试着找到一份实际原文件,确认你知道怎样恢复。只有一个“备份成功”提示,而不知道保存在哪儿,还不足以应对误改。

Orrery 的操作备份覆盖什么

内置 write_file 覆盖、edit_file、move_file、delete_file 和 apply_patch 对已有 Vault 文件执行相应破坏性操作前,会先保存原版本到 .orrery/backups;新建文件没有旧版本可备份。知识库健康修复另有自己的处理记录和备份。

这些是特定操作的保护,不是整个磁盘的持续版本管理。外部编辑器、终端命令、其他应用或任意第三方工具的写入,不应一概假定具有相同备份。

恢复一个被改坏的文件

  1. 先停止继续改写该文件,保存当前版本副本。
  2. 确认实际路径和出问题的大致时间。
  3. 查找对应备份,比较正文与附件。
  4. 选择损坏前的版本,先恢复成新文件检查。
  5. 核对后再决定是否替换原路径,检查相关链接。

没有明确备份时,先查其他备份、版本历史或系统回收位置,不要让 AI 凭记忆重写后假称恢复了原文。

聊天回退不是文件恢复

撤销发送会把所选发送及后续聊天尾部从当前记录移除,并保留本地回退归档。它不会恢复已经改写的笔记,也不会撤销外部消息、命令或付费操作。

Fork 创建另一条对话方向,同样不复制隔离整个资料库。完整边界见分叉与撤销。

分享诊断信息前

保留错误发生时的版本、平台、操作步骤和时间。分享日志、截图或模型请求细节前,移除 API Key、Token、私人原文与无关账号信息。

在线服务会收到完成任务所需的请求内容;具体范围要按所用模型、工具和诊断设置查看。不要把“本地优先”写成“所有数据绝不出本机”。

  • 先看将分享的内容;本次未上传或改变选项
    先看将分享的内容;本次未上传或改变选项。

完整迁移要包含隐藏数据

完整备份应复制整个 Vault,包含原始资料、附件和 .orrery 隐藏目录,而不是只选几类 Markdown。应用停止写入后再复制,并保留本机设置与凭据恢复方式。仅复制会话目录会漏掉其他运行记录。

.orrery 中可能包含 sessions 会话、memories 记忆及索引、plans 计划、skills 资料库技能、ingest-runs 摄取记录、backups 文件旧版本、rollback-archive 聊天回退归档等。

具体内容随版本与实际使用产生,不把这份举例当作可以排除其他目录的白名单。用户级技能和系统安全存储仍在 Vault 之外。

请 Agent 帮忙恢复时

Agent 的文件备份规则要求先列出备份、读取候选并选择损坏前版本,不能凭模型记忆重写。备份名使用时间戳与原文件名;不同目录同名文件可能混在平铺备份目录,必须比较内容确认身份。让 Agent 说明恢复来源与实际结果,写回仍需要当前任务许可。它不是已经自动运行过的全库自愈服务。

内容来自 Orrery Desktop 的 Wiki,文档仍在持续完善。功能开放情况以当前版本为准。

本页内容