SuperAPI AI 工具集

gate.cat

gate.cat 是一个针对 AI 编码智能体的确定性、故障关闭(fail-closed)动作否决工具。它在不可逆的 shell 命令(如 rm -rf、DROP TABLE、terraform destroy)以及密钥外泄行为执行之前将其拦截,且否决路径中不引入 LLM。它可以作为 Claude Code 的 Hook 使用,也可以作为任何 CLI 智能体的受控 shell,或作为一种本地 OpenAI API 代理。该工具为免费本地网关,宣称有 71 条默认策略(51 条阻止、20 条警告),在真实流量中干预率约 0.6%。

访问官网

工具介绍

gate.cat 是一款面向 AI 编码智能体的动作否决工具,其核心目标是在智能体执行不可逆操作之前进行确定性拦截。它被设计为故障关闭(fail-closed),即当引擎缺失或出错时选择阻止而非放行,并且否决路径中不依赖任何 LLM,因此与模型无关。

用途

该工具用于保护那些一旦出错便不可逆转的环境,例如含有真实数据的开发笔记本电脑、部署流水线、生产环境、付费基础设施。在会被丢弃的一次性 CI/沙箱容器中,由于没有不可逆操作,gate.cat 会自动解除武装并记录空操作日志,而不是误报。它通过自动检测 CI 标记实现这一行为,也可通过 GATECAT_VETO_EPHEMERAL=0 强制保持武装。作者声称在 14.7k 条真实 Claude Code 命令与一个公开的 8.6k 条 SWE-agent 命令语料上测量,干预率约为 0.6%。

主要能力

  • 阻止不可逆的 shell 命令模式,例如 rm -rf、DROP TABLE、terraform destroy、gh repo delete 等。默认包含 71 条策略(51 条阻止、20 条警告),针对不可逆动作类别。
  • 拦截 README 中的安装单行命令(例如 curl … | sh 模式),但对于混淆/base64 编码的安装技巧仍可能被绕过。
  • gate.cat why "<command>" 可打印真实裁决,命名规则如 RM_RF、DISK_DESTROY、ENCODED_EXEC、DB_DESTRUCTIVE;不在拒绝列表中的命令会被标记为 unchecked(未检查),而非安全。
  • 自身定位为字符串门禁而非沙箱:它读取命令,但不隔离进程。
  • 提供停滞检测(StateStagnationDetector),用于发现智能体在安全命令循环中却毫无进展的情况,例如重复操作、状态无变化、重复错误、无进展的成本消耗。该检测为建议性。
  • 提供 Truth Pipeline(koryto → gate → veto)验证引擎,结合确定性检查(exec/calc/lookup)与样本分布不确定性信号,给出 confirmed / refuted / uncertain / unchecked 裁决,veto.py 据此在工具调用执行前阻止、暂停或询问人类。
  • 附带语义缓存与 Cache-Augmented Synthesis(CAS)作为支撑引擎,可作为 OpenAI/Anthropic SDK 的直接替换包装,提供逐字缓存、合成、上游三层响应。

使用方式

安装方式包括用户级安装器,或手动 venv 路径:python3 -m venv .venv && .venv/bin/python -m pip install gate.cat。发行分发名为 gate.cat(PyPI 也接受规范化拼写 gate-cat),导入模块为 gatecat。0.2.x 使用 import cacheback,详见 MIGRATION.md。

主要模式:

  1. Hook(最强模式):将 gatecat-hook 注册为 Claude Code 的 PreToolUse hook,在 .claude/settings.json 中添加配置,无需编辑绝对路径。工具调用在 gate 返回前无法执行。
  2. 受控 shell:gatecat-shell 位于 sh -c "<command>" 的执行点,将智能体的 shell 指向它,所有命令在执行前由同一确定性引擎审查。真实 shell 为 /bin/sh,可通过 GATECAT_SHELL_REAL=/bin/bash 更改。命令逐字节传递。作为智能体 shell 二进制(-c 模式)属于模型控制之外的强制执行;--install-bash DEBUG trap 较弱,会话内命令可通过 trap - DEBUG 解除。
  3. 框架适配器:提供 crewAI / LangGraph 适配器,以及框架无关的 guard_callable 可包装任意普通可调用对象(AutoGen 等走此路线)。这些均为进程内约定,提示注入可绕过;只有 hook 是智能体无法跳过的强制执行。
  4. 代理模式:可作为本地 OpenAI API 代理,覆盖 Ollama / NIM / OpenRouter / vLLM / LM Studio。

适用场景

适用于任何使用工具的智能体,包括 Claude Code、Codex、Cursor、crewAI/LangGraph 应用,以及在 Ollama/vLLM 上运行的本地 7-30B 模型。Truth Pipeline 的不确定性信号在小型/廉价模型上表现最强(AUC 0.77–0.90,N=4800),在前沿模型上信号减弱(AUC 0.68–0.71);但动作否决本身与模型规模无关。

限制与边界

gate 只对其阻止的内容有确定性;未匹配的动作是未检查,而非安全。它不保证正确性,只提供不确定性信号用于暂停/升级。提示注入可绕过进程内适配器。混淆的安装技巧仍可绕过。在一次性 CI/沙箱中会自动解除武装。

收费

本地 gate 永久免费,无速率限制。付费层 gate.cat Cloud 为可选且默认关闭:Solo €19/月、Team €149/月固定(最多 10 台机器)、Business €399/月、一次性 €29 策略包(Fintech、PaaS、HTTP-API Breadth)。阻止功能不依赖付费。团队计划提供共享的机外否决历史、舰队警报和签名策略同步。合作计划提供 30% 循环佣金。

暂未提供

关于官方文本中未明确说明的平台兼容性细节、具体的策略列表完整内容、以及 Cloud 层的全部功能边界,本文暂未提供更多信息。