5 分钟看懂 OpenCode 数据持久化存了什么、存在哪、怎么恢复【免费下载链接】focus-visiblePolyfill for :focus-visible项目地址: https://gitcode.com/gh_mirrors/fo/focus-visibleOpenCode 数据持久化替你保存开发状态AI 对话记录、打开的文件、未提交变更、终端状态、项目配置都会写入本地磁盘。读完本文你能说清每类数据落在哪个目录、关机会话后如何找回、怎样回滚到任意快照。 查看 OpenCode 替你保存了哪些内容所有持久化数据都落在用户主目录的~/.opencode/下分为 StorageJSON 区和 snapshot快照区两处。按数据类型拆开看持久化的数据类型落盘位置AI 对话记录~/.opencode/storage/sessions/session-id/按会话分目录打开的文件与编辑器状态与对话记录同一会话目录随会话写入未提交的代码变更~/.opencode/snapshot/按 hash 组织文件树终端命令与执行状态同一会话目录随会话状态落盘项目配置与依赖信息~/.opencode/storage/projects/project-hash/判断依据会话目录按 session-id 隔离快照区按 hash 共享。想知道某个会话存了什么直接列一遍对应目录的内容即可核对。 数据流怎样走写入、存储到恢复写入文件一有改动packages/opencode/src/snapshot/index.ts中的 Snapshot 模块就把当前文件树和上一次快照做 diff把差异写盘并生成一个 hash。这一步在每轮 AI 响应前后自动执行不需要你手动触发。存储packages/opencode/src/storage/storage.ts中的 Storage 模块负责统一的 JSON 读写与版本迁移后端就是文件系统。对话、工作区状态最终都成为~/.opencode/storage/下的 JSON 文件升级导致格式变化时它先跑迁移再写入。读取与恢复打开某个会话时Session 模块从磁盘读回对话记录和工作区状态再用快照 hash 把未提交变更重放回工作区。你看到的界面就是上次离开时的现场。 OpenCode 状态恢复最常用的三个步骤自动快照const snapshotHash await Snapshot.track(); // 系统会在每次文件改动后自动调用无需人工介入什么时候会用到频繁做实验性修改或重构时依赖它兜底中途关掉终端也不会丢变更。回滚到指定状态await Snapshot.restore(a1b2c3); // 整个现场回到该快照 await Snapshot.revert([{ hash: a1b2c3, files: [src/main.ts] }]); // 只找回部分文件什么时候会用到实验改坏时整体 restore只想从早先版本取回一两个文件时用 revert。跨会话恢复OpenCode 会话保存按会话为单位运行opencode session list查看最近的会话列表再用opencode session open id恢复对应会话的对话、文件与终端状态。什么时候会用到隔天继续昨天中断的项目或在多台设备之间切换时不用重新搭环境。⚠️ OpenCode 快照恢复时容易踩的四个坑1. 恢复后部分文件内容与目标快照不一致。原因Snapshot.revert的files参数只列了部分文件其余文件保持原样。 处理需要完整现场就改用Snapshot.restore(hash)确属选择性恢复先核对一遍文件清单。2. 恢复命令报错或中途卡住。原因磁盘空间不足或快照目录读写权限不对。 处理先检查可用磁盘空间和~/.opencode/snapshot/的权限位清理旧数据后再重试。3. 两台设备同步同一项目后状态互相冲突。原因同步只处理文件级冲突两端修改了同一文件时没有自动合并策略。 处理提前配置冲突解决策略冲突出现时用冲突解决工具手动合并别让同步直接覆盖掉一侧的改动。4. 快照越用越慢目录占用持续膨胀。原因开启autoTrack后构建产物、二进制文件这类大文件也进了快照。 处理用排除规则把dist/、node_modules/等路径剔除并调短保留周期。 大型项目上如何配置快照跑得动可控项就三类快照频率、保留策略、排除规则对应cfg.snapshot的三个键。cfg.snapshot { enabled: true, autoTrack: true, interval: 5.min, // 快照频率 retentionPeriod: 7.days, // 保留策略 ignore: [dist/**, node_modules/**, *.bin] // 排除规则 };大项目按顺序调先把interval调大降低写盘频率再用ignore剔除构建目录与二进制文件最后收紧retentionPeriod。磁盘占用和快照耗时都会降下来。改动幅度大之前先手动执行一次快照出问题时用Snapshot.restore按 hash 回滚即可。【免费下载链接】focus-visiblePolyfill for :focus-visible项目地址: https://gitcode.com/gh_mirrors/fo/focus-visible创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考