通用持久化抽象与数据存储
通用持久化抽象与数据存储 stage-21（横切基础设施）
这一阶段是系统的“后勤仓库”，不直接聊天干活，却让很多东西能长期保存、下次还能接上。rollout、消息历史和 thread-store 保存对话档案；SQLite 状态库存会话、任务、日志和“谁带起谁”的关系；各种缓存把云配置、插件目录、模型列表先放本地，少等网络；插件、密钥、记忆文件负责安全落盘；外部导入则登记、读取并转换别家的聊天记录，避免重复搬运。
子阶段
21.1Rollout 文件和 thread-store 持久化19 个文件21.2SQLite 运行时状态和 agent graph 存储18 个文件21.3缓存和本地持久化查找数据6 个文件21.4插件、密钥和记忆文件存储9 个文件21.5外部会话导入持久化2 个文件
本阶段涉及的状态26
reg-effective-config系统最终采用的那份配置，把文件、云端规则、项目设置、命令行参数和临时覆盖合在一起，后面各模块都按它办事。reg-feature-flags当前打开或关闭的实验功能和能力开关，决定界面、模型、工具、插件等功能能不能用。reg-auth-account用户当前是谁、有没有登录、用的是哪种账号或套餐、令牌是否还能用的身份状态。reg-secret-store本机保存的 API Key、ChatGPT 令牌、个人访问令牌、Bedrock Key 等秘密凭据。reg-account-quota-limits账号的额度、限流、消费控制和剩余可用量信息，用来决定请求能不能继续发。reg-local-state-runtime本地 SQLite 和 StateRuntime 打开的那套持久化句柄，负责让线程、日志、目标、记忆等数据能长期保存。reg-thread-session-store当前有哪些线程和会话、哪个正在用、哪些能恢复或关闭的共享会话账本。reg-conversation-history每条线程里的用户消息、模型回复、工具调用、文件改动和审批记录等对话历史。reg-agent-graph多智能体和 fork 线程之间谁带起谁、父子关系是否还活着的关系图。reg-model-catalog系统当前知道有哪些模型、各模型有什么能力、来自哪个提供方以及能不能选用的模型清单。reg-backend-remote-config-cache从云端拉下来的配置、目录和规则的本地缓存，启动和后台刷新都会读写它。reg-plugin-registry已安装、可用、来自市场或本地的插件清单，以及每个插件的能力和加载结果。reg-mcp-registryMCP 服务器、连接、工具和资源的登记表，模型和前端都靠它知道能调用哪些外部能力。reg-skills-catalog当前能用的技能目录，包括技能来自哪里、说明文件在哪里、是否允许自动调用。reg-memory-store系统保存和检索长期记忆的地方，包含记忆文件、目录、搜索结果和后台整理状态。reg-permissions-approvals用户已经允许、拒绝或需要确认的命令、文件、联网、MCP 调用等权限和审批状态。reg-observability-telemetry日志、指标、分析事件、请求耗时、工具结果和错误报告等观测数据的收集与发送状态。reg-cloud-task-state云端任务、任务列表、默认环境、尝试次数、状态和结果在本地界面与后端之间同步的那份状态。reg-rollout-trace-logrollout 记录下来的可回放流水账和会话状态，用来恢复、排错、重连和事后分析。reg-goal-store系统当前保存和检索的目标、任务意图和目标相关上下文，用于在线程运行、提示词组装和结果更新时持续引用。reg-feedback-report-buffer用户反馈、附带日志线索、脱敏后的诊断包以及上传重试/完成状态的暂存缓冲。reg-external-import-state外部聊天记录或会话导入时的来源登记、去重映射、转换进度和已导入标记。reg-worktree-diff-state当前工作树快照、Git 状态、文件改动摘要和待展示或持久化的 diff 状态。reg-session-usage-accounting每个线程或回合累计的模型 token、请求次数、工具用量和成本/用量统计状态，用于展示、持久化和遥测。reg-onboarding-preferences-state新手引导、提示是否已看过、界面偏好和类似本地用户体验标记的持久状态。reg-batch-dispatch-stateCSV 等批量派工流程中的输入批次、逐项代理分配、执行进度、失败项和汇总结果状态。