Skip to main content

捕获 Agent 轨迹

Gateway capture 是 pVisor 的 Run 驱动，由 Run 启停；系统不再提供独立 Gateway 命令或 守护进程。Capability 与 Evidence 模型解释 Capture 能证明什么，以及它不负责 enforce 什么。

先按安装指南安装 pvisor；本页直接使用已安装的命令。真实 Agent 可直接通过 pvisor run 配置：

export DEEPSEEK_API_KEY=sk-...
pvisor run \
  --name deepseek \
  --gateway-mode capture \
  --gateway-route 'name="deepseek", upstream="https://api.deepseek.com/v1", api_key_env="DEEPSEEK_API_KEY"' \
  --gateway-route 'name="*", forward="deepseek"' \
  --gateway-stream-markdown \
  -- claude

pVisor 启动内嵌 Gateway、向子进程注入代理或 base URL、等待执行、排空捕获并停止 Gateway。--gateway-stream-markdown 生成实时人读投影；使用 --record-format json --record-destination ./capture 写本地 JSONL，或使用 --record-format lance --record-destination WAREHOUSE 启动完整 pChronicle sidecar。 Dataset 目录、查询、分析、导入导出和只读 Web UI 由 pchronicle 提供。

事件时间戳​

每条新落盘的 EventRecord 都包含两种对应的墙上时钟字段：

  • timestamp：RFC3339 UTC 时间；
  • timestamp_unix_ms：同一观测时刻的 Unix 毫秒值。

Gateway 在接受请求和捕获响应时分别记录时间；最终 Gateway capture sink 还会为旧 producer 生成的记录兜底补齐这两个字段，pVisor runtime 事件则在生成时同时写入这对值。 两种表示必须在 1 毫秒内一致。事件排序使用 source + seq；时间戳用于墙上时钟关联和 展示，不作为排序依据。

客户端只有使用注入的代理或 base URL 才能被观察；直接 socket 是否受限取决于 executor， 实际隔离边界以 Run Bundle 为准。

下一步：查询捕获的历史，或者阅读 Gateway 内部实现。