Agent 行为事件：记录面，逐字段说清

这一页只描述采集器在你本机写下的东西——不多也不少。它是博客篇《Agent 动作的审计轨迹，逐行为一行》的参考手册形姊妹页，并守同一条诚实规则：当前构建是 Phase 0 观察态——观察、评估、记录；would_block 判定写进记录，不做拦截。

一条事件的五个锚点

每个被观察到的动作成为本地 JSONL 文件里的一行，带五个锚点：

• Agent 家族——动作来自哪个 agent 运行时（Claude Code、Codex、OpenClaw、接入 MCP 的工具）
• 进程谱系——派生进程链，子进程的动作仍能指认它的父进程
• 命令形状——被尝试之事的规范化形态，以及针对的资源类别（记形状，不记私有载荷）
• 时间戳——观察发生那一刻的墙钟时间
• 策略判定——动作当时生效的评估结果：would_block 或 allow，绝不静默丢弃

包在文件外层的保证

• 写前严格校验——畸形事件被拒绝、零字节落盘；文件可信是因为有这道门，而不是因为写入者许过愿
• 落盘前脱敏——凭证、键值密钥、密钥文件路径从操作系统递来的每个字符串里剥掉
• 磁盘上只追加、属主仅本人可读、按大小与按天轮转——历史不能被「谁能编辑文件」的人悄悄改写
• 采集器零外呼——它看到的东西不出这台机器；依赖闭包在 CI 里机器校验
• 确定性重放——重放引擎用既有语料对候选规则文件逐事件出判定，两次跑字节恒等，对活系统零副作用

怎么读这份记录

• agent-collector status——运行时此刻看到什么
• agent-collector audit-tail——按写下的原样输出最近的行
• agent-collector timeline——在终端里把日志渲染成时间线
• 三条都是只读控制面命令，没有一个会往外部打电话

这一页不声称什么

没有内容级监视、没有云同步、没有防篡改哈希链——当前构建线里这些都没有上线。拦截与恢复是路线图阶段，在<a href="/zh-cn/roadmap/">路线图</a>和<a href="/zh-cn/security/">安全模型</a>页里就是这么标的。各平台、各 agent 的观察深度见<a href="/zh-cn/docs/supported-os-matrix/">OS 能力矩阵</a>（本批新页）与<a href="/zh-cn/supported-agents/">支持的 agents</a>。

想在自己机器上看这份记录：<a href="/zh-cn/docs/install/">安装指南</a>带你走首跑、安静运行与干净移除；带逐文件 SHA-256 的构建在<a href="/zh-cn/download/">下载页</a>；构建实时状态在<a href="/zh-cn/status/">状态页</a>。