pVisor
pVisor 在受控执行环境中运行现有的 Agent 命令。 它为每个 Run 提供独立的工作区边界, 记录实际生效的控制机制,并让你在文件变更进入项目之前先进行审查。
在 Persisting 里,pVisor 负责跑一次 Agent 并审查其改动;可与 pChronicle 分开使用。
你将完成什么
完成第一次快速开始后:Agent 已停止;改动留在 Run 独占的暂存目录;你明确选择写入项目或丢弃。
第一次 pvisor review 时,你会看到解释实际控制机制的记录。
pVisor 不替代 Agent 自己的推理循环。你可以继续使用已有的 Agent CLI、脚本和 framework。
运行、审查、决定
在项目目录中运行:
pvisor run --stage ./runs/task-001 -- codex
pvisor review last
pvisor apply last --path src
使用 --stage ./runs/task-001 时,Agent 写入项目的 staged 视图。Run 结束后,你可以接受全部变更、分多次接受
选定路径,或丢弃整个 stage:
pvisor apply last --all
# 或者
pvisor drop last
具体的文件系统和网络边界取决于平台与 executor。pVisor 会记录实际生效的控制机制,不会把一个 Run 描述得比它实际拥有的隔离程度更高。
选择下一步
第一次使用时,从运行第一个 Agent开始。这条路径会以一份已审查的 stage 结束,并介绍其余文档使用的核心术语。
如果已经知道目标,可以直接进入对应路径:
pVisor 的本地 run—review—apply 闭环可以独立工作。pChronicle 是可选项:当你希望在 Run 结束后保留并查询轨迹 Dataset 时再使用它。
推荐阅读顺序
第一次使用时按下面的顺序阅读:
- 运行第一个 Agent,完成一次完整成功闭环。
- 需要更细地控制修改时,阅读审查和应用。
- 执行 Provider 会影响边界时,阅读执行布局。
- 需要解释 Run Bundle 时,阅读Capability 与 Evidence。
- 只有需要精确选项或输出字段时,再查阅命令行参考。