Skip to main content

pVisor

pVisor logo

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 时再使用它。

推荐阅读顺序

第一次使用时按下面的顺序阅读:

  1. 运行第一个 Agent,完成一次完整成功闭环。
  2. 需要更细地控制修改时,阅读审查和应用
  3. 执行 Provider 会影响边界时,阅读执行布局
  4. 需要解释 Run Bundle 时,阅读Capability 与 Evidence
  5. 只有需要精确选项或输出字段时,再查阅命令行参考

继续阅读