受治理执行
pVisor
为 Agent 提供 staged workspace 与明确的执行 Provider。在 Effect 进入项目之前先查看 Evidence。
最终得到可审查的 Run Bundle，并控制哪些修改进入项目。
开始一次 Run →持久历史
pChronicle
固定、规范化、查询和交换 Agent 轨迹 Source，无论它是否来自 pVisor。
最终得到可查询 Dataset，并保留清晰的 Source lineage。
探索 Dataset →一条边界，两条持久化路径
执行与历史各自独立可用，只有在工作流需要持久交接时才把它们连接起来。
一条持久化 Agent 工作流所需的一切
受治理执行
在了解 Provider 边界、可审查的 workspace 中运行 Agent。
可审查修改
在文件进入真实项目之前，先检查完整 stage。
Capability Evidence
查看实际生效的文件系统、网络和进程控制。
轨迹 Dataset
把捕获或导入的历史转换为规范化、可查询的视图。
开放格式
交换支持的轨迹格式，同时保留 Source lineage。
本地优先
从本地路径开始，准备好后再迁移到对象存储。
从安装到得到结果
先完成最小闭环，保留输出，再按下一个问题选择深入指南。
安装
pip install persisting
运行或探索
pvisor run --stage ./runs/task-001 -- codex
# 或：pchronicle onboard
审查或查询
pvisor review last
# 或：pchronicle onboard query