维护、资源与数据
管理环境存储、CPU 和内存，分别更新应用与环境工具，保留可恢复的个人数据。
本页内容
数据保存在哪里
默认配置根位于当前用户主目录下的 .claude-cage。账户、设置、收藏与密码库属于配置数据；浏览器历史、网站登录、工具与环境内文件还依赖持久虚拟磁盘。本机共享项目保存在原项目目录。指定 CLAUDE_CAGE_CONFIG 时，后续启动和维护应继续使用同一个绝对路径。
云端的数据在服务器上，包含配置、项目及容器引擎的持久文件系统。本机只保留连接和明确下载的副本。不要仅备份一份账户文件，或把重建账户当作恢复。
迁移环境到另一块磁盘
入口：“设置 → 环境与恢复 → 本机环境存储”。此功能针对本机 VM，云端容器按服务器部署方案维护。
- 保存编辑器和终端中的工作，选择本地磁盘上的专用空目录。不要选盘根目录、网络盘、程序目录、配置目录或项目目录。
- 确认迁移。Cage 会停止环境和终端，复制并校验数据，成功后切换存储路径。
- 手动启动环境，核对文件、浏览器登录和工具。
- 确认正常后，再通过面板清理本次迁移显示的旧备份。旧缓存可能供其他 Lima 实例使用，会留在原位置。
目标盘须有足够空间并支持权限和稀疏文件。外接盘以后每次启动前都要接回；找不到磁盘时先连接原盘，不要新建环境覆盖状态。
设置 CPU 与内存
入口：“设置 → 环境与恢复 → 计算资源”。默认自动分配本机资源上限，实际范围由主机与平台决定。需要手动控制时关闭“自动分配资源上限”，在页面允许范围内填写内存 GiB 和逻辑 CPU 核心数。
点“保存资源配置”后下次启动生效。运行中可“重启并应用已保存配置”，先保存工作，重启会结束正在执行的命令。内存可以在上限内按需增长与回收，设置上限不会使所有内存一直占满。
云端资源由服务器部署限制，工作台显示核验信息，不能按本机 VM 的方式承诺编辑或实时统计。任务退出 137 时结合 OOM 计数和诊断判断，避免只凭退出码认定内存不足。
区分三种更新
| 更新对象 | 在哪里操作 | 影响 |
|---|---|---|
| 桌面 Cage 应用 | 应用更新入口，或下载完整安装包手动替换 | 安装会结束相关环境与终端；保留持久数据。云端服务单独维护。 |
| 环境组件 | 设置 → 环境与恢复 → 版本与组件 → 更新环境组件 | 可能重启浏览器和编辑器；工作台独立终端保留，编辑器内终端可能结束。 |
| 环境工具 | 同页“更新环境工具” | 按当前应用指定版本更新工具，需要环境就绪；先更新不兼容的组件。 |
操作前保存工作。替换 App 不代表持久环境中的所有组件已经更新，看到版本不匹配时按页面同步。维护下载经过所选代理，手动暂停业务外网不会被维护操作解除。
macOS 自动安装要求相同发布者的 Developer ID 签名与 Apple 验证；Windows 需可信 Authenticode 签名和相同发布者公钥。未签名 Windows 预览版与 Linux 使用完整安装包手动更新。自动更新下载失败可在原入口重试。
恢复配置与导出诊断
“恢复上一份配置”会先停止环境，再恢复上一次保存的配置。它不能恢复已结束的命令，也不能还原项目文件修改。运行前阅读页面提示并保存内容。
同页的日志诊断可导出 ZIP。应用界面无法使用时，也可按故障排查从命令行导出。默认日志保留 14 天，总预算 50 MiB，不以此替代自己的数据备份。
备份、重装与卸载
先保存文件，停止环境和相关后台，再备份完整配置根、选择的环境存储、共享项目与服务器引擎数据。完整备份需要保持同一时点的一致性；运行中的进程和临时终端输出不能靠磁盘备份恢复。
安装、重装、更新和卸载只管理应用文件，个人数据继续保留。再次安装应使用原配置与数据路径。需要换机器、回滚或手动迁移时，先核对账户、收藏、密码库和持久磁盘能一起恢复。
不要对用户数据执行初始化、批量删除容器或 docker system prune 来解决更新失败。恢复前保留原件与备份，遇到原账户消失先查数据目录。