Skip to main content
版本发布

zn-gate 1.15.0 新功能:ZCode 在 Windows 上受到保护、隐藏的删除命令被拦截、更多身份信息请求被发现、更安全的 zn run

John Silver9 分钟阅读

zn-gate 1.15.0 让 ZCode 插件在 Windows 上保护工具调用,让破坏性命令更难躲过智能体执行前运行的检查,扩展了默认关闭的管道下载检查,发现更多试图让你的智能体发送你个人信息的工具结果,在运行钩子运行器之前先检查它是否就是当初安装的那个,补上了 zn run 的一个缺口,并修复了含糊或无声的消息。zn-gate 仍然无需账户,默认不发送任何内容。请用 npm install -g zn-gate@1.15.0 和 pip install -U zn-gate 更新。

zn-gate 1.15 新功能概览:一个中心节点连接五个条目,按顺序为:启动器会检查它所运行的内容:zn 的钩子启动器只有在钩子运行器与安装时记录的 SHA-256 一致时才会运行它,不再回退到 PATH。隐藏的删除操作被拦截:藏在 ANSI-C 引用或 python -c / node -e 单行命令中的 rm -rf 会被阻止。ZCode 在 Windows 上受到保护:插件的钩子现已能在 Windows 上运行,首次调用快约 3 倍,并在 ZCode 超时之前作出响应。更多身份信息请求被拦截:更多要求你的智能体发送你的邮箱的工具结果会被标记。默认更安全:修复 Rust 网关的依赖问题(zip、wasmtime),并收紧 zn run 的临时文件夹检查。

ZCode 现在在 Windows 上受到保护了吗?

是的,从这个版本开始。在早期版本中,ZCode 插件的钩子通过完整路径启动 /bin/sh,而 Windows 没有它,所以钩子从未运行,ZCode 不经 zn 就运行每一次工具调用。zn-gate check 会报告该插件未受保护,但没有任何东西拦住这些调用。现在,插件的每个事件也都有了 Windows 钩子:

  • 它能运行。 钩子直接启动 Node.js(一个小的 scripts/zn-hook.cmd 会在常用的安装文件夹中查找),当 Node.js 在别处时,会回退到启动器的 PowerShell 版本。如果找不到可用的 Node.js,它会拦截该调用。
  • 它会及时回应。 ZCode 在钩子超时时会让调用运行。插件现在给它的钩子 5 分钟,而不是 30 秒,并且钩子会在 ZCode 启动它 2 分钟后自行拦截该调用,即使 zn-gate 卡住也是如此。在我们对一台 2 个 CPU、所有 CPU 都满载的 Windows 机器的测试中,一次普通检查最长用了 131 秒,卡住的 zn-gate 最多在 154 秒后被拦截,因此 5 分钟的超时留有余量。在忙到钩子需要超过 5 分钟的机器上,ZCode 会让调用运行。zn hooks install zcode 写入同样的超时和截止时间:请再运行一次以更新现有安装。
  • 它快了约三倍。 在一台开启 Defender、有 2 个 vCPU 的全新 Windows Server 2022 机器上,该机器的第一次钩子调用耗时 0.7 秒,而不是 2.0 秒(两次运行的中位数),之后的一次调用为 0.3 秒,而不是 0.9 秒。
  • 它只运行插件自己的文件。 它可以在名称含有空格、&、括号、^ 或 % 的用户文件夹中工作,并且绝不会运行项目中同名的文件。

zn-gate check 会在那里运行 Windows 钩子,并且当钩子已作出回应、在读完全部输入之前就退出时,不再把它报告为“无法启动”。更新后,请在 ZCode 中重新安装该插件(设置,插件)。

zn-gate 现在能发现哪些隐藏的删除命令?

破坏性命令检查会在智能体运行之前,拦截对你的主文件夹、文件系统根目录或系统文件夹的递归删除。1.15.0 又能读懂两种写法:

  • ANSI-C 引号: $'\x72m' -rf ~、rm -rf $'\x7e' 和 $'\162m' -rf / 会被拦截。仅仅被打印出来的字面 $'...',如 echo $'\x72m -rf ~',仍然被允许。
  • 解释器单行命令: 交给 python -c、node -e、perl -e 和 ruby -e 的代码(也包括 sudo 或 env 之后的)会被读取。以递归方式删除这些文件夹的单行命令(shutil.rmtree、带 recursive 的 fs.rmSync、remove_tree、FileUtils.rm_rf、unlink glob)会以 rm_root_home 被拦截。

完整列表见破坏性命令。

哪些管道下载会被拦截?

pipe_to_shell 规则默认关闭。可通过 ~/.zn/config.json 中的 hooks.blockDestructiveCommands 开启(例如 ["rm_root_home", "disk_overwrite", "pipe_to_shell"],或用 true 开启全部六条规则),也可通过 ZN_BLOCK_DESTRUCTIVE=1 开启。开启后,1.15.0 还会拦截:

  • 把下载内容通过管道交给 python、node、perl 或 ruby、并由它们从管道中读取程序的情况,例如 curl ... | python3 或 | sudo python3 -,会以 pipe_to_shell 被拦截。| python3 -m json.tool 和 | python3 script.py 仍然被允许。
  • 在 PowerShell 7 中,以管道符开头的行会延续它上面的命令,因此像 iwr https://example.com/i.ps1 这样的下载,后面跟一行 | iex,会被拦截。下一行如果通过管道交给无害的东西,例如 | ConvertFrom-Json,仍然被允许。

更多身份信息请求被发现

工具结果中的文字可以告诉你的智能体把你的个人信息放进请求。身份信息请求规则(pi:identity_request 和 pi:identity_request_multi)现在能发现更多这类内容:不带撇号的“the user email”、自定义 X- 头或下一个请求中的“their email”、折到第二行的指令,以及运行 whoami 或 git config user.email 并把结果放进头部、URL 参数、cookie、表单字段或请求的指令。要求在“每个请求”、User-Agent 或 From 头、mailto 链接、请求体或表单中提供电子邮件地址的 API 文档不会被报告,告诉你不要发送这些信息的句子也不会。与以前一样,这些规则默认是提示性的,在严格模式下才会拦截。

钩子启动器会检查它运行的内容

在 macOS 和 Linux 上,以及 Windows 上的 Claude Code(它通过 Git Bash 运行同一个启动器),zn 的钩子启动器现在只有在 zn-gate 的钩子运行器文件仍具有安装时记录的 SHA-256 时才运行它,并且不再回退到 PATH 上找到的 zn。被编辑过或被替换为存根的运行器会被拦截,并提示你再次运行 zn hooks install <agent>,zn-gate check 也会报告它。该检查覆盖运行器文件,而不是包中的其他文件。Windows 上 Codex CLI、Cursor、Gemini CLI 和 Antigravity 的内联 PowerShell 钩子保持不变。

zn run 和 Rust 网关有什么变化?

  • zn run 与临时文件夹: zn run 会拒绝一个解析到临时文件夹中文件的、被允许的命令。此前它漏掉了两种情况。第一,临时文件夹取自 TMPDIR、TEMP 和 TMP,而智能体可以为命令设置这些变量,所以把它们指向别处,就能让放在系统临时文件夹中的文件带着机密运行。现在系统临时文件夹(/tmp、/var/tmp、/dev/shm、macOS 的每用户临时文件夹,以及在 Windows 上用户配置文件和系统的临时文件夹)总是会被检查。第二,在 Windows 上,以一种形式给出的临时文件夹与以另一种形式给出的 PATH 条目(长名称、8.3 短名称、subst 驱动器或 \\?\ 路径)不会匹配;现在它们会匹配,对项目内文件的检查也比较相同的几种形式。
  • PyPI 发布: Python 包现在使用 pypa/gh-action-pypi-publish 1.14.3 发布,它不再信任 GHSA-5xjx-3w67-w9x9 报告为已被攻破的 emSign 根证书。PyPI 上 1.14.1 和 1.15.0-rc.1 的文件与其 GitHub 发布中已签名的 SHA256SUMS 一致。
  • Rust 网关依赖: 网关使用 zip 9.3.0 和 wasmtime 48.0.8 构建,它们修复了 RUSTSEC-2026-0429(zip 8.6.0 遇到声明大小很大的符号链接压缩包条目时可能中止进程;网关从不解压压缩包)以及 RUSTSEC-2026-0422、RUSTSEC-2026-0423 和 RUSTSEC-2026-0424(WebAssembly 组件之间的检查)。

修复

  • 无网络时的引导式 init: zn-gate init 现在会说“无网络连接:npm 无法访问注册表”以及下一步该怎么做,而不是归咎于 npm 全局文件夹的权限。npm 安装步骤约 30 秒后放弃,最多等待 3 分钟。在 Windows 上,当该步骤超时时,现在会停止 npm 本身。
  • OpenCode: 当 zn 钩子无法启动时(例如安装它所用的 Node.js 已不在),被拦截的调用会用平实的话说明这一点,并给出修复步骤(zn-gate check,然后 zn hooks install opencode),而不是一条原始错误。
  • 各处相同的下一步: 当检查超时或失败时,每个智能体现在都会提示再试一次,如果问题持续出现,就运行 zn-gate check。
  • ZCode: 当对某个工具输出的检查超时,或输出太大无法检查(超过 32 MiB)时,ZCode 现在会收到一条输出未被扣留的通知,而不是拦截或一条表示已扣留的消息,因为工具当时已经运行了。
  • zn-gate check: 它会针对其所运行的系统读取 ZCode 插件的钩子,不会评判另一个系统的钩子,也不会把 C:/Windows/... 这样的 Windows 路径当作按名称查找的程序。
  • 磁盘已满: 钩子不再在证据日志旁留下空的锁文件,那会让之后的每次钩子调用都等待半秒。
  • zn-gate stats: 只有其共享计数确实已发送的日子才会被报告为已发送;上传失败的那一天会在下次运行时重试。
  • Python 包: 多次包含同一个对象的工具结果不再因规则 size:items 被拦截。当 ZN_STRICT 和 ZN_BLOCK_TRUNCATED 被设置为 1 以外的值(这会使它们保持关闭)时,会发出警告。设置 on_block="ignore" 时,LangChain 和 LlamaIndex 集成现在会在放行某些内容时记录一条警告,包含规则和发生位置。云端调用失败的警告会说明出了什么问题,以及已使用本地规则。

完整列表见更新日志。

如何更新?

npm install -g zn-gate@1.15.0
pip install -U zn-gate
npx -y zn-gate@1.15.0 check

更新会刷新它写入的钩子启动器,Windows 上也一样。如果你的包管理器跳过安装脚本(npm install --ignore-scripts、pnpm 或 bun),请对你使用的每个智能体重新运行 zn hooks install <agent>;在此之前,钩子会阻止工具调用并提示你这样做(使用 pnpm 时,它们会继续运行此前所装版本的钩子运行器,且不显示任何消息)。check 会告诉你哪些智能体需要这样做。如果你使用 Claude Code 插件,请运行 claude plugin update zn-gate@usezn 并开启新会话。如果你在 Windows 上使用 ZCode 插件,请在 ZCode 中重新安装(设置,插件)。

分享