更新与恢复

这里的“应用版本”指 Rna 本身的代码，和项目自己进化出的基因版本分开管理。

更新复制本节链接

设置 → 应用更新 显示当前的应用版本和 Rna SDK 版本，可以“检查更新”并看发布记录，不提供手动切换或回退版本的入口。更新、回退和恢复在命令行完成：先对本机的 .app 或完整运行目录执行 maintenance prepare 检查，再 maintenance apply。检查会完整复制 Node、SDK、守护进程、界面、npm、CLI，校验摘要、架构和状态格式。检查通过只说明本地内容完整，不代表开发者签名可信，也不代表模型能力提高。

更新的顺序：

1. 暂停接纳新任务，已接纳的工作收尾；
2. 确认旧服务干净退出；
3. 创建并验证恢复点；
4. 切换运行目录；
5. 核对新服务的身份和就绪状态；
6. 恢复接纳。

等待期间草稿保留。长期任务没结束时，维护会继续等待；超出最长等待时间则保留原有工作，报告本次维护未完成，不会为了更新强行结束任务。

./rna maintenance status
./rna maintenance prepare '/Applications/Rna Agent.app'
./rna maintenance apply CANDIDATE_ID
./rna maintenance backup
./rna maintenance rollback CANDIDATE_ID
./rna maintenance cancel OPERATION_ID
./rna maintenance prune --dry-run            # 按保留策略清理旧恢复点与运行包
./rna maintenance compact-journals --dry-run # 服务停止时合并旧会话日志里的逐字流事件

CLI 等待超时只说明操作还在后台处理，用 maintenance status 核对最终结果。

恢复点包含什么复制本节链接

包含：主状态、凭据与订阅记录、SDK 会话日志、项目能力包、初始化与进化记录、已安装能力记录、归档和收件箱。文件权限为 0600 / 0700。恢复点可能包含凭据，请按私有数据保管。

不包含： 你的项目目录、远端 OpenViking 数据、全局的第三方登录信息。用“本地记忆（内置）”时，记忆数据库在状态目录里，包含在恢复点中。

还原之后复制本节链接

./rna maintenance restore RESTORE_POINT_ID --confirm
./rna recovery status
./rna recovery reconcile OPERATION_ID --confirm

还原会替换本机的会话、配置和 SDK 记录，但不会回滚项目目录和远端记忆。所以还原后 Rna 保持暂停（包括记忆的自动写入），旧的待办需要逐项核查，不能保证旧的外部操作“只执行一次”。

还原过程中崩溃时，普通启动会被阻止，使用原事务接续，不会在半恢复的状态上运行 Agent。