持久化与状态管理对比分析

1. Claude Code (claude-code-rev)

状态管理主要通过 src/state/ 中的 AppStateStore 实现，持久化则依赖 src/history.ts。

核心特性：

• AppStateStore：采用类似 Zustand 的运行时状态树，管理当前终端的 UI 状态、任务进度和全局配置。
• Transcript 持久化：将每一轮对话实时写入 ~/.claude/ 下的 .jsonl 文件。即使进程奔溃，系统也能通过加载 Transcript 快速恢复上下文。
• 文件基并发锁：由于 Claude Code 可能有多个实例（如终端、VS Code 扩展）同时访问配置，它在 saveConfigWithLock 和 cronTasksLock.ts 中实现了基于文件的乐观锁和互斥锁。

2. Opencode (opencode)

状态管理主要在 packages/opencode/src/storage/ 和 packages/opencode/src/session/。

核心特性：

• InstanceState：利用 Effect 的 Layer 机制，将工具注册表、配置和会话状态作为全局实例注入，确保单一事实来源。
• Message V2：在 message-v2.ts 中实现了高度结构化的消息版本管理，支持对历史消息的引用、版本回退和元数据标记。
• 存储驱动解耦：将存储逻辑抽象为 Storage 接口，支持本地文件系统、数据库或内存存储。

3. 对比总结

维度	Claude Code	Opencode
运行时状态	集中式状态树 (Zustand-like)	基于 Effect Layer 的依赖注入
持久化格式	实时 JSONL (Transcript)	结构化 Session 存储
多实例同步	显式文件锁 (File-based locks)	抽象存储驱动支持
历史恢复	Transcript 重播	Session 反序列化

Claude Code 的状态管理非常贴合 CLI 的“重交互”特性，强调实时性和崩溃恢复；Opencode 则更像一个“服务化”的 Agent 框架，强调数据的结构化和多场景适配（如 Web 端和 IDE 端的统一存储）。