审计日志
完整记录每一次数据操作，让多人多 Agent 协作清晰可追溯。
什么是审计日志
当多个 Agent 和团队成员同时访问同一份数据时，你需要知道：谁在什么时候对哪个文件做了什么操作。
PuppyOne 的审计日志系统自动记录所有对 Content Node 的操作，无需手动开启，每一次创建、编辑、删除、回滚、同步都会被完整记录。
为什么需要审计日志
多 Agent 协作的可追溯性
当你的项目中有多个 Agent 同时工作——比如一个负责从 Notion 同步数据，一个负责自动更新文档，一个负责响应用户查询——你需要知道每个 Agent 做了什么。审计日志让每一步操作都有迹可循。
问题排查
数据出了问题？审计日志帮你快速定位：是谁的修改导致了错误，什么时候发生的，修改前的内容是什么。
合规要求
对于需要数据审计的场景，审计日志提供完整的操作记录，满足合规性要求。
记录了什么
每条审计日志包含以下关键信息：
| 字段 | 说明 | 示例 |
|---|---|---|
| actor | 操作者（用户或 Agent） | [email protected]、Research Agent |
| action | 操作类型 | create、update、delete |
| node_path | 操作的节点路径 | /docs/api-design.md |
| timestamp | 操作时间 | 2025-03-09T14:30:00Z |
| metadata | 操作的附加信息 | 变更详情、来源等 |
支持的操作类型
| 操作 | 说明 |
|---|---|
create | 创建新的 Content Node |
update | 修改节点内容 |
delete | 删除节点 |
rollback | 回滚到历史版本 |
sync | 从外部数据源同步 |
checkout | 检出节点进行编辑 |
commit | 提交检出的修改 |