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 更新。
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-publish1.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 中重新安装(设置,插件)。