四层状态：UI、Runtime、Persistent、External CLI

harness.db 位于 Electron userData，开启 WAL。kv 目前主要保存窗口 bounds；command_history 保存用户提交的 prompt。代码注释明确把 agents、message_queue、cost_ledger 标记为未来迁移，不应按 SPEC.md 的理想模型描述为已完成。

WATCH

文档差异：SPEC.md 写“SQLite: Agents, layouts, command history, goals”，但当前 `db.ts` 明确说明 agents/message_queue 尚未实现。以源码为准。

固定源码证据

src/main/db.tsL1-L17

Phase A scope

文件头直接声明 SQLite 当前范围与未来计划。

已核验

src/main/db.tsL49-L100

MIGRATIONSkvcommand_history

唯一 migration 创建两表和一个索引。

已核验

SPEC.mdL188-L212

PersistenceData model

设计文档保留目标模型，不能覆盖真实实现。

仅设计文档

持久化矩阵

同一业务域使用多种持久化机制

config.json 保存设置；localStorage 保存 UI/roster 并镜像到 harnessHome/roster.json；Hive registry/tasks/mailboxes/memory 是文件，且 Hive 自身是由单一 committer 管理的 Git repo；外部 CLI 会话保存在各自目录。

01内存：PtyManager sessions、timers、liveWorkers、breaker state、Zustand transient fields。
02userData：config.json、harness.db、analytics install/version stamps、knowledge store。
03harnessHome：roster.json、hive/registry.json、tasks.json、board.md、agents/*、cost-ledger.jsonl。
04External CLI：Claude transcripts、per-agent CODEX_HOME、provider sessions 与凭据。

固定源码证据

src/main/config.tsL586-L690

readConfigwriteConfigpersistConfig

配置从 userData/config.json 读取、合并默认值并写回。

已核验

src/main/roster.tsL1-L162

RosterStorereadwrite

roster.json 解决 dev http origin 与 packaged file origin 的 localStorage 隔离。

已核验

src/renderer/src/store/store.tsL363-L660

persistAgentspersistQueuesrosterMirror

localStorage 与 roster mirror 是 additive dual-write。

已核验

src/main/hive.tsL2482-L2578

atomicWriteJsoncommit

Hive JSON 原子落盘，并由单一 committer 重试 Git 提交。

已核验

Memory Graph 实况

Memory Graph 已有 UI；语义 memory 与 Knowledge Graph 仍是可选模块

旧 MEMORY_GRAPH_SPEC.md 自称“未写组件”，但当前源码已有 MemoryGraphPanel 与 client-side topic extraction。语义检索依赖可选 mempalace CLI；企业 Knowledge Graph 是另一套可选本地 store，不要混成 SQLite 内的一张统一图表。

固定源码证据

src/renderer/src/components/MemoryGraphPanel.tsxL23-L190

MemoryGraphPanel

当前 renderer 已有可视化组件。

已核验

src/renderer/src/components/memoryGraph/extractTopics.ts

extractTopics

主题提取在客户端进行，并关注跨 agent 共享知识。

已核验

src/main/memory.tsL1-L12

MemoryManagermempalace

Semantic memory 缺少 CLI 时静默降级，markdown memory 仍工作。