Skip to main content

从你当前的问题开始

Persisting 有两个独立入口。先选择与你当前任务相符的入口，再沿着短路径完成一个有用结果。

我想运行 Agent，并审查它产生的修改​

从 pVisor 开始。它让单个 Agent 在独立 Run 中工作，记录执行边界，并把文件修改 留在暂存区，直到你决定写入真实项目还是丢弃。

  1. 安装命令行工具。
  2. 运行第一个 Agent。
  3. 审查并选择性应用修改。
  4. 选择 host、OCI 或 VM 执行环境。

完成后，Agent 已停止，改动留在暂存区，你可以审查后写入或丢弃。

pvisor run --stage ./runs/task-001 -- codex
pvisor review last
pvisor apply last --path src

我已经有 Agent 轨迹数据​

从 pChronicle 开始。它可以检查本地或对象存储中的数据，也可以导入支持的外部格式。第一 个 walkthrough 会创建临时示例数据，因此无需先准备 Dataset 就能学习查询流程。

  1. 探索第一个 Dataset。
  2. 发现并查询自己的数据。
  3. 导入或导出支持的格式。
  4. 在本地提供 Dataset 服务。

完成后，你应该能执行只读查询，看到规范化视图，并清楚查的是哪份数据、哪个来源。

pchronicle onboard query
pchronicle query ./trajectory-data \
  --sql 'SELECT source, COUNT(*) FROM dataset.steps GROUP BY source'

我想把执行和历史连接起来​

等两个独立工作流都能运行后，再连接它们。配置 pVisor capture，把选定的 Gateway 轨迹事件和 lifecycle record 发布到 pChronicle。这个交接是显式且有限的：它不会搬运私有 Run Bundle，也 不会补造原始 Source 没有提供的 Evidence。

pVisor capture 与 pchronicle serve --gateway 是两条入口：前者随 Agent Run 启停并共享执行边界；后者独立接收或转发已有 Agent/SDK 的流量，不启动 pVisor Run。

  1. 捕获 Agent 轨迹。
  2. 理解 event 与 sidecar 契约（需要改协议或排障时再读）。
  3. 阅读从执行到历史的架构。
pVisor Run ── configured capture ──> canonical event Source ──> Dataset views
external trajectory Source ──────────────────────────────────> Dataset views

我需要先理解边界，再运行 Agent​

按这个顺序阅读核心概念：

  1. Run、Attempt 与 Effect —— 稳定对象。
  2. Capability 与 Evidence —— Run 能够声明什么。
  3. 执行环境 —— Provider 选择如何改变边界。
  4. 安全与 Evidence —— 哪些内容会持久化，哪些仍留在本地。

整套文档遵循同一条规则：命令成功退出，不代表所有请求的 capability 都已 enforcement。 Run Bundle 会记录实际生效的机制与限制。

继续阅读​