术语表

zn-gate 文档中所用词语的简短解释，并附上讲解每个词的页面链接。

查看 .md

zn-gate 文档中所用词语的简短解释。如果某个页面对该词有更详细的说明，该词会链接到那里。不知从何开始？请先看安装。

你的环境

  • 编程智能体：像 Claude Code、Codex CLI、Cursor 或 OpenCode 这样的程序，它会读取你的文件并替你运行命令。参见安装。
  • 终端：你输入命令的窗口。请在你自己的终端中运行 zn-gate 的设置命令，不要通过智能体运行。
  • Node.js：运行 zn-gate 的 npm 命令的程序，npx 随它一起提供。可从 nodejs.org 获取。
  • MCP 服务器：你的智能体可以调用的工具。MCP 是智能体连接工具的标准方式。zn-gate 本身也可以作为 MCP 服务器运行。参见 MCP 客户端与工具。
  • 插件：zn-gate 的 Claude Code 附加组件，一步即可设置好 zn-gate 的钩子和 MCP 服务器。参见 Claude Code。
  • 钥匙串（keychain）：你的操作系统自带的密码存储。zn-gate 可以把可选的 API 密钥存放在那里。参见 Connect。

密钥

  • 密钥（secret）：能让你访问某项内容的值，例如 API 密钥、令牌或密码。
  • .env 文件：项目中的一个文件，保存你的应用所用的密钥和其他设置。
  • 加密保险库（vault）：你本机上的加密存储，zn-gate 在其中保存你的密钥的真实值。参见 Scrubber 与密钥保险库。
  • 标记（marker）：密钥的替身，例如 __ZN_STRIPE_KEY__。你的智能体看到的是标记，真实值留在保险库里。参见 Scrubber 与密钥保险库。
  • 遮盖（redact）：把文本中的密钥替换成标记或标签，这样读到该文本的人都看不到真实值。参见密钥遮盖。
  • Shadow（env shadow）：把 .env 文件中的密钥值移入保险库，并在原处留下标记。参见 Scrubber 与密钥保险库。
  • Scrubber：zn-gate 中负责把你的智能体读取、运行和发送的内容里的密钥替换成标记的部分。真实值留在保险库中。参见 Scrubber 与密钥保险库。

检查与防护

  • 钩子（hook）：智能体在读取文件、运行命令或收到你的提示词之前或之后运行的一项小检查。zn-gate 用钩子来拦截或遮盖。参见 zn-gate 如何工作。
  • 代理（proxy，shield）：位于你的智能体与 MCP 服务器之间的一层，检查经过的内容。参见保护 MCP 服务器。
  • Shadow 模式（--shadow）：一种部署 zn-gate 的方式，只记录决定，不拦截也不改动任何内容。它与上面的 env shadow 不是一回事。参见 zn-gate 如何工作。
  • 提示词注入：试图让智能体无视你的指令的文本，例如藏在文件或网页中。参见威胁模型。
  • 分类器：把文本分到不同类别的模型，例如安全或注入尝试。
  • Galvanize：zn 的提示词注入检查。它们在本地以规则形式运行，开放的 Galvanize 2 分类器可作为可选的第二意见。参见 Galvanize 2。
  • 云端检查：可选的第二道检查，由 usezn.com 上的 Galvanize 2 分类器检查发送给 zn-gate 的 analyze_prompt 工具的文本。在你开启之前它是关闭的。参见哪些数据会离开你的机器。

命令与记录

  • 自检（zn-gate test）：运行 zn-gate 内置的示例。
  • Reach（zn-gate reach）：只读报告，显示你的编程智能体在这台机器上能访问什么。只显示名称，绝不显示值。参见 Reach。
  • Audit（zn-gate audit）：读取仓库中的智能体配置文件，不运行任何东西，并报告会运行什么。参见 Audit。
  • Scan（zn-gate scan）：检查文件夹中的提示词、Markdown、skills 和配置文件，查找泄露的密钥和提示词注入陷阱。参见 Scan。
  • Evidence（本地审计日志）：记录你机器上每一次 shield 决定。每条记录都与前一条相链接，因此可以发现篡改。参见本地审计日志。