常见问题

我需要账户或 API 密钥吗?

不需要。在你本机上运行的所有功能都无需账户即可使用,也没有使用限制。API 密钥仅用于可选的云端二次判断,且仅在同时设置 ZN_CLOUD=1 时才会使用。

有内容会离开我的机器吗?

默认不会。工具输出、工具参数和 MCP 工具描述在任何配置下都不会被发送。只有同时设置 ZN_CLOUD=1 和 ZN_API_KEY 时才会发送提示词,并且密钥会先在本地脱敏。参见哪些内容会离开你的机器。

支持哪些智能体?

任何 MCP 客户端都支持。快速开始提供了 Claude Code、Codex CLI、Cursor 和 OpenCode 的命令,zn-gate init 可以重写 Claude Desktop、Claude Code、Cursor、Codex CLI 和 OpenCode 的配置。对于你自行构建的智能体,可以使用 Python 和 Node.js SDK。

zn-gate 会拖慢我的智能体吗?

通常远低于一毫秒。测试于 2026-10-11 进行(2 vCPU Intel Xeon、Node 24、zn-gate 1.4.1):对于 4 KB 的工具输出,check_tool_result(包括密钥脱敏)的 p50 为 0.30 ms,p99 为 0.81 ms;对于 64 KB,p50 为 3.8 ms。可在代码仓库中使用 bench/bench_by_size.js 复现。

它会拦截正常内容吗?

有时会。对于整个源代码文件,本地规则目前会对普通代码注释产生误报。在评估期间,可使用影子模式(init --shadow 或 shield --shadow)记录检测结果而不进行拦截;对于网页和第三方内容使用 check_tool_result,而不是用于你自己的代码仓库文件。

它能看到我智能体的内置工具吗?

可以,需要 zn-gate 1.5 及更高版本:在 Claude Code 中使用 zn-gate 插件(参见快速开始),在其他智能体中使用 zn hooks install codex、cursor 或 opencode(npm)。在 Claude Code 和 OpenCode 中,它会在模型看到输出之前对智能体内置工具的输出进行脱敏;Codex 会用脱敏后的副本替换结果;Cursor 只能阻止读取密钥文件,不允许钩子改写 shell 或文件输出。参见脱敏器。如果不使用钩子,原生的文件读取或 shell 命令不会经过 zn-gate,除非你将其输出发送给 check_tool_result。

有检测率数据吗?

zn-gate 目前还没有。自检(51 个测试向量)只是冒烟测试,不代表检测率或误报率。我们会在引用任何数字之前,在保留测试集上公布结果,并附上方法和数据。云端模型 Galvanize 2 的保留测试集结果及方法已在其发布文章中给出。Galvanize 文档页面提供了这些结果;对于上一代模型 Galvanize-60M,页面还提供了带日期的第一方基准测试及其公开数据集。

你收费的是什么?

仅收取无法在你本机运行的部分:可选云端检查中使用的开放模型 Galvanize 2,以及面向团队的集中化控制功能。zn-gate 本身采用 MIT 许可。参见定价。

如何卸载?

运行 npx -y zn-gate init --revert 可从备份中恢复你的配置。对于独立服务器,请从智能体配置中删除 zn-gate 条目。

如何报告漏洞?

请发送邮件至 security@usezn.com。政策、范围和安全港条款:安全。