perplexityai/numbat

这是什么？

核心功能

• 01通过 hook、插件和 OTLP/HTTP 日志导出实时监控 Agent 行为。
• 02内置 CEL 规则、多步骤序列规则和自定义 YAML 规则，在端点本地完成检测。
• 03在支持的操作前 hook 上提供可选拦截，默认关闭。
• 04从受支持的磁盘会话文件中进行事后取证还原，无需事先埋点。
• 05输出带版本号的 NDJSON 记录，并提供 JSON Schema 定义格式。
• 06只读扫描产物文件并对敏感信息脱敏。
• 07生成带 SHA-256 清单的可移植案例包。

适用场景

• 监控开发者工作站上编程 Agent 的读写与命令执行行为。
• 在会话结束后，依据磁盘上的产物文件复盘 Agent 的操作过程。
• 在制定明确策略后，拦截少数高风险操作，例如写入 SSH authorized_keys。
• 将事件证据打包为可校验的案例包进行共享。

快速上手

1. 1

   使用 Go 1.26.9 或更新版本安装 numbat

   go install github.com/perplexityai/numbat/cmd/numbat@latest
2. 2

   列出已发现的代理并扫描其产物（只读）

   numbat agents
3. 3

   为 Codex 安装实时监控钩子（默认仅监控）

   numbat hook install --agent codex --emit all

使用前须知

• !实时监控的覆盖范围因代理和场景而异，依赖前请先查看覆盖矩阵。
• !阻断功能默认关闭，所有内置规则仅监控；启用拦截需要自行编写并维护规则。
• !安装和升级后需要在宿主中审核并信任钩子，增加了运维步骤。

收录于专题

标签

常见问题

numbat 是什么？

面向端点的 AI Agent 行为可见性工具，支持本地检测、可选的操作前拦截和事后取证还原。 numbat 通过本地 hook 和插件、OTLP/HTTP 日志导出以及磁盘上的会话文件，观测受支持的桌面端、CLI、IDE 和网关类 Agent。实时与落盘的活动会被统一为同一套事件模型，并由同一个 CEL 规则引擎评估，检测在本地完成。记录可输出到标准输出或本地文件，也可选择通过 HTTP 投递。

numbat 可以免费使用吗？用的什么许可证？

numbat 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

numbat 还在维护吗？

活跃维护中。numbat 最近一次提交是在 2026年11月4日。

numbat 适合用来做什么？

监控开发者工作站上编程 Agent 的读写与命令执行行为。 在会话结束后，依据磁盘上的产物文件复盘 Agent 的操作过程。 在制定明确策略后，拦截少数高风险操作，例如写入 SSH authorized_keys。 将事件证据打包为可校验的案例包进行共享。

numbat 怎么安装和运行？

使用 Go 1.26.9 或更新版本安装 numbat: go install github.com/perplexityai/numbat/cmd/numbat@latest 列出已发现的代理并扫描其产物（只读）: numbat agents 为 Codex 安装实时监控钩子（默认仅监控）: numbat hook install --agent codex --emit all

在哪里获取 numbat？

源代码和安装说明在 GitHub 上：https://github.com/perplexityai/numbat