System Design

Persisting 提供 Agent 执行与轨迹历史的持久化基础设施。本节聚焦 当前公开产品路径：

• pVisor 虚拟化并治理单个 Agent Run；
• pChronicle 把持久轨迹 Source 组织为可查询 Dataset。

Gateway、OverlayFS 与 OverlayNet 是 pVisor 运行时机制。存在稳定 Run identity 时，它会连接 这些产品域，但各域也有独立入口。

跨产品契约

Configured pVisor capture
  Gateway trajectory events ─┐
  pVisor lifecycle records ──┴─> canonical event Source ─┐
Pinned external Sources                                  │
  ATIF / ACTF / OpenAI Messages / Storyline ─────────────┴─> Snapshot
                                                               └─> normalized Dataset views

Attempt finalization 会写入私有、带版本的 Run Bundle，并保留 staged Effect，供之后执行 review/apply/drop；这一过程不需要 pChronicle。配置后的 capture 会发送 Gateway 轨迹 event 与 pVisor lifecycle record，包括这些 record 携带的 Evidence。完整 Bundle 及其中的 Artifact、 lineage、Effect 与更完整的 Evidence 清单仍留在本地，除非另行搬运。

外部文件与 Storyline Source 会被直接固定版本并规范化，无需经过 pVisor，也不会先变成 canonical event。每条路径保留与 Source 对应的保证；ingestion 不会补充 Source 未提供的 Evidence。

职责边界可以概括为两点：

• pVisor 负责执行。 它定义单个 Run 的边界，以及模型、网络和文件系统 runtime driver。 即使没有捕获历史，私有 Run Bundle 也独立有效。
• pChronicle 负责历史。 它记录 canonical event 和终态事实，并提供 Dataset 查询、交换与 revision lineage。

这个拆分直接服务于使用者：可以先独立使用执行或历史，只有当问题同时跨越两个域时才配置 capture 交接。

按问题继续阅读

• 完整架构与目标模型
• 从本地到集群的连续性
• 安全与 Evidence 模型
• pVisor 实现边界
• pChronicle 实现边界

交付状态以产品 Design 页面与项目工程笔记为准。目标架构不能 作为功能已经实现的证据。