Skip to main content
Versiones

Novedades de zn-gate 1.15.0: ZCode protegido en Windows, borrados ocultos bloqueados, más solicitudes de identidad detectadas y un zn run más seguro

John Silver10 min de lectura

zn-gate 1.15.0 hace que el plugin de ZCode proteja las llamadas a herramientas en Windows, dificulta esconder un comando destructivo de la comprobación que se ejecuta antes de que tu agente lo lance, amplía la comprobación opcional de descargas canalizadas, detecta más resultados de herramientas que intentan que tu agente envíe tus datos, comprueba que el ejecutor de hooks es el que se instaló antes de ejecutarlo, cierra un hueco en zn run y corrige mensajes que eran poco claros o no aparecían. zn-gate sigue sin necesitar cuenta y por defecto no envía nada. Actualiza con npm install -g zn-gate@1.15.0 y pip install -U zn-gate.

Resumen de las novedades de zn-gate 1.15: un centro con cinco elementos, en orden. El lanzador comprueba lo que ejecuta: el lanzador de hooks de zn solo ejecuta el ejecutor de hooks si coincide con el SHA-256 registrado en la instalación. Sin alternativa por PATH. Borrados ocultos detectados: se bloquea rm -rf oculto con comillas ANSI-C o en comandos de una línea con python -c / node -e. ZCode protegido en Windows: el hook del plugin ahora se ejecuta en Windows, unas 3 veces más rápido en la primera llamada, y responde antes del tiempo límite de ZCode. Más peticiones de identidad detectadas: se marcan más resultados de herramientas que le dicen a tu agente que envíe tu correo. Más seguro por defecto: correcciones en dependencias de la pasarela en Rust (zip, wasmtime) y comprobaciones más estrictas de la carpeta temporal para zn run.

¿Está ZCode protegido ahora en Windows?

Sí, desde esta versión. En versiones anteriores, los hooks del plugin de ZCode arrancaban /bin/sh por su ruta completa, que Windows no tiene, así que el hook nunca se ejecutaba y ZCode ejecutaba todas las llamadas a herramientas sin zn. zn-gate check indicaba que el plugin no estaba protegido, pero nada detenía las llamadas. Ahora cada evento del plugin tiene también un hook para Windows:

  • Se ejecuta. El hook arranca Node.js directamente (un pequeño scripts/zn-hook.cmd lo busca en la carpeta de instalación habitual) y recurre a una versión del lanzador en PowerShell cuando Node.js está en otro sitio. Si no encuentra un Node.js utilizable, bloquea la llamada.
  • Responde a tiempo. ZCode deja pasar una llamada cuando su hook agota el tiempo. El plugin ahora da a sus hooks 5 minutos en lugar de 30 segundos, y el hook bloquea la llamada por sí mismo 2 minutos después de que ZCode lo arrancara, también cuando zn-gate se ha quedado colgado. En nuestras pruebas en una máquina Windows de 2 CPU con todas las CPU ocupadas, una comprobación normal tardó hasta 131 segundos y un zn-gate colgado se bloqueó tras 154 segundos como máximo, así que el tiempo límite de 5 minutos deja margen. En una máquina tan ocupada que el hook tarde más de 5 minutos, ZCode deja pasar la llamada. zn hooks install zcode escribe el mismo tiempo límite y el mismo plazo: vuelve a ejecutarlo para actualizar una instalación existente.
  • Es unas tres veces más rápido. En una máquina nueva con Windows Server 2022, 2 vCPU y Defender activado, la primera llamada al hook de la máquina tarda 0,7 s en lugar de 2,0 s (mediana de dos ejecuciones), y una llamada posterior 0,3 s en lugar de 0,9 s.
  • Solo ejecuta los archivos del propio plugin. Funciona desde carpetas de usuario cuyos nombres contienen espacios, &, paréntesis, ^ o %, y nunca ejecuta un archivo del mismo nombre que esté en el proyecto.

zn-gate check ejecuta allí el hook de Windows y ya no informa de un hook como «no se pudo iniciar» cuando respondió y terminó antes de leer toda su entrada. Después de actualizar, vuelve a instalar el plugin en ZCode (Settings, Plugins).

¿Qué borrados ocultos detecta ahora zn-gate?

La comprobación de comandos destructivos bloquea un borrado recursivo de tu carpeta personal, de la raíz del sistema de archivos o de una carpeta del sistema antes de que el agente lo ejecute. La 1.15.0 lee dos formas más de escribir uno:

  • Comillas ANSI-C: se bloquean $'\x72m' -rf ~, rm -rf $'\x7e' y $'\162m' -rf /. Un $'...' literal que solo se imprime, como en echo $'\x72m -rf ~', sigue permitido.
  • One-liners de intérpretes: se lee el código que se pasa a python -c, node -e, perl -e y ruby -e (también detrás de sudo o env). Un one-liner que borra de forma recursiva esas carpetas (shutil.rmtree, fs.rmSync con recursive, remove_tree, FileUtils.rm_rf, unlink glob) se bloquea como rm_root_home.

Consulta Comandos destructivos para ver la lista completa.

¿Qué descargas canalizadas se bloquean?

La regla pipe_to_shell está desactivada por defecto. Actívala con hooks.blockDestructiveCommands en ~/.zn/config.json (por ejemplo ["rm_root_home", "disk_overwrite", "pipe_to_shell"], o true para las seis reglas) o con ZN_BLOCK_DESTRUCTIVE=1. Con ella activada, la 1.15.0 bloquea además:

  • Una descarga canalizada a python, node, perl o ruby que lee el programa desde la tubería, como curl ... | python3 o | sudo python3 -, se bloquea como pipe_to_shell. | python3 -m json.tool y | python3 script.py siguen permitidos.
  • En PowerShell 7, una línea que empieza por una tubería continúa el comando de la línea anterior, así que una descarga como iwr https://example.com/i.ps1 seguida de una línea | iex se bloquea. Una línea siguiente que canaliza a algo inofensivo, como | ConvertFrom-Json, sigue permitida.

Más solicitudes de identidad detectadas

El texto de un resultado de herramienta puede decir a tu agente que ponga tus datos en una petición. Las reglas de solicitud de identidad (pi:identity_request y pi:identity_request_multi) ahora detectan más casos: «the user email» sin apóstrofo, «their email» en una cabecera X- personalizada o en la petición siguiente, una instrucción que continúa en una segunda línea y una instrucción de ejecutar whoami o git config user.email y poner el resultado en una cabecera, un parámetro de URL, una cookie, un campo de formulario o una petición. La documentación de API que pide una dirección de correo «en cada petición», en una cabecera User-Agent o From, un enlace mailto, un cuerpo de petición o un formulario no se marca, y tampoco las frases que dicen que no envíes los datos. Como antes, estas reglas son avisos por defecto y bloquean en modo estricto.

El lanzador de hooks comprueba lo que ejecuta

En macOS y Linux, y para Claude Code en Windows (que ejecuta el mismo lanzador a través de Git Bash), el lanzador de hooks de zn ahora solo ejecuta el ejecutor de hooks de zn-gate mientras ese archivo conserve el SHA-256 registrado en la instalación, y ya no recurre a un zn encontrado en el PATH. Un ejecutor que se editó o se cambió por un sustituto se bloquea con un mensaje que indica volver a ejecutar zn hooks install <agent>, y zn-gate check lo señala. La comprobación cubre el archivo del ejecutor, no los demás archivos del paquete. Los hooks de PowerShell en línea de Codex CLI, Cursor, Gemini CLI y Antigravity en Windows no cambian.

¿Qué cambió en zn run y en el gateway de Rust?

  • zn run y las carpetas temporales: zn run rechaza un comando permitido que se resuelve a un archivo en una carpeta temporal. Se le escapaban dos casos. Primero, la carpeta temporal se tomaba de TMPDIR, TEMP y TMP, que el agente puede fijar para el comando, así que apuntarlas a otro sitio permitía que un archivo colocado en la carpeta temporal del sistema se ejecutara con el secreto. Las carpetas temporales del sistema (/tmp, /var/tmp, /dev/shm, las carpetas temporales por usuario de macOS y, en Windows, la carpeta temporal del perfil de usuario y la del sistema) ahora se comprueban siempre. Segundo, en Windows, una carpeta temporal nombrada de una forma y una entrada del PATH de otra (el nombre largo, el nombre corto 8.3, una unidad subst o una ruta \\?\) no coincidían; ahora sí, y la comprobación de archivos dentro del proyecto compara las mismas formas.
  • Publicación en PyPI: el paquete de Python ahora se publica con pypa/gh-action-pypi-publish 1.14.3, que ya no confía en el certificado raíz de emSign que GHSA-5xjx-3w67-w9x9 declara comprometido. Los archivos de PyPI de la 1.14.1 y de la 1.15.0-rc.1 coinciden con el SHA256SUMS firmado en sus versiones de GitHub.
  • Dependencias del gateway de Rust: el gateway se compila con zip 9.3.0 y wasmtime 48.0.8, que corrigen RUSTSEC-2026-0429 (zip 8.6.0 podía abortar el proceso con una entrada de archivo que es un enlace simbólico con un tamaño declarado grande; el gateway nunca extrae archivos) y RUSTSEC-2026-0422, RUSTSEC-2026-0423 y RUSTSEC-2026-0424 (comprobaciones entre componentes de WebAssembly).

Correcciones

  • Init guiado sin internet: zn-gate init ahora dice «no internet connection: npm could not reach the registry» y qué hacer a continuación, en lugar de culpar a los permisos de la carpeta global de npm. El paso de instalación de npm se rinde a los 30 segundos más o menos y nunca espera más de 3 minutos. En Windows, cuando ese paso agota el tiempo, ahora se detiene el propio npm.
  • OpenCode: cuando el hook de zn no puede arrancar (por ejemplo, porque ya no existe el Node.js con el que se instaló), la llamada bloqueada lo dice con claridad y da el paso para repararlo (zn-gate check y después zn hooks install opencode), en lugar de un error sin procesar.
  • El mismo paso siguiente en todas partes: cuando una comprobación agota el tiempo o falla, todos los agentes ahora dicen que lo intentes de nuevo y, si sigue ocurriendo, que ejecutes zn-gate check.
  • ZCode: cuando la comprobación de la salida de una herramienta agota el tiempo, o la salida es demasiado grande para comprobarla (más de 32 MiB), ZCode ahora recibe un aviso de que la salida no se retuvo, en lugar de un bloqueo o un mensaje de que se retuvo, ya que la herramienta ya se había ejecutado.
  • zn-gate check: lee los hooks del plugin de ZCode del sistema en el que se ejecuta, y no juzga el hook del otro sistema ni toma una ruta de Windows como C:/Windows/... por un programa buscado por nombre.
  • Disco lleno: los hooks ya no dejan un archivo de bloqueo vacío junto al registro de evidencias, que hacía que cada llamada posterior al hook esperara medio segundo.
  • zn-gate stats: solo se informa como enviados los días cuyos recuentos compartidos se enviaron de verdad; un día cuyo envío falló se reintenta en la siguiente ejecución.
  • Paquete de Python: un resultado de herramienta que contiene el mismo objeto muchas veces ya no se bloquea con la regla size:items. ZN_STRICT y ZN_BLOCK_TRUNCATED avisan cuando se fijan a un valor distinto de 1, que los deja desactivados. Con on_block="ignore", las integraciones de LangChain y LlamaIndex ahora registran una advertencia, con la regla y el lugar donde ocurrió, cuando dejan pasar algo. La advertencia de una llamada fallida a la nube dice qué falló y que se usaron las reglas locales.

La lista completa está en el registro de cambios.

¿Cómo actualizo?

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

La actualización renueva los lanzadores de hooks que escribió, también en Windows. Si tu gestor de paquetes omite los scripts de instalación (npm install --ignore-scripts, pnpm o bun), vuelve a ejecutar zn hooks install <agent> para cada agente que uses; hasta entonces los hooks bloquean las llamadas a herramientas y te dicen que lo hagas (con pnpm siguen ejecutando el ejecutor de hooks de la versión instalada antes, sin mensaje). check te dice qué agentes lo necesitan. Si usas el plugin de Claude Code, ejecuta claude plugin update zn-gate@usezn e inicia una sesión nueva. Si usas el plugin de ZCode en Windows, vuelve a instalarlo en ZCode (Settings, Plugins).

Compartir