La captura está justo ahí, pero Hermes dice que falta el archivo: hay un espacio invisible en el nombre


Arrastras una captura recién hecha al chat y pides a Hermes que mire el error que hay en pantalla. El archivo se guarda bien, el path se imprime bien y luego el paso que abre la imagen falla: media file not found. Lo compruebas en Finder. El archivo está ahí mismo, con exactamente ese nombre.

La trampa está en «exactamente ese nombre». Cuando macOS nombra una captura, el espacio que va antes de AM/PM no es un espacio normal. Es U+202F, un espacio fino de no separación. En pantalla parece idéntico a un espacio normal, un pelo más estrecho, invisible a simple vista. Cuando un modelo reescribe el nombre, emite U+0020, y dos bytes distintos significan que el path apunta a un archivo que no existe.

El PR #154046, fusionado el 12 de noviembre, hace que el análisis de visión, el análisis de vídeo y la generación de imagen/vídeo encuentren por su cuenta la grafía que hay en disco.

Un carácter, toda una cadena rota

El fallo va así:

  1. El path llega al contexto: Screenshot 2026-11-12 at 9.51.42 AM.png; el carácter 26 es U+202F.
  2. El modelo recibe una cadena que parece normal, pero cuando genera texto los espacios que produce son todos U+0020.
  3. El visor de imágenes llama a open() sobre ese path, el sistema operativo compara bytes y no encuentra nada.
  4. El error dice media file not found. No dice «un argumento difiere en un byte».

Lo peor es cómo suena: parece un problema de permisos o de path, así que te pones a auditar paths, permisos y sandboxes mientras la causa real es un carácter que no puedes ver.

Un detalle pequeño que lo hacía parecer incoherente: read_file ya manejaba este caso. Así que el mismo archivo era legible para read_file e ilegible para vision_analyze.

El arreglo: comparar por lo que ve el ojo, pero solo si encaja un archivo

Funciona en dos capas.

Una clave de coincidencia. tools/file_operations_common.py incorpora filename_match_key, que normaliza un nombre a «lo que un humano lee como lo mismo»: composiciones Unicode NFC y NFD, espacios finos y especiales, apóstrofos curvos.

Una búsqueda en disco. _on_disk_spelling, en tools/image_source.py, se ejecuta tras un fallo de path y busca en el mismo directorio el único archivo cuyo nombre difiere solo de forma invisible:

target (normalised):  screenshot 2026-11-12 at 9.51.42 am.png
actually on disk:     Screenshot 2026-11-12 at 9.51.42<U+202F>AM.png   <- match

Dos detalles conviene tenerlos presentes:

  • Un solo candidato. Si un directorio contiene a AM.png y a<U+202F>AM.png, no adivina: leer la imagen equivocada es peor que fallar.
  • La seguridad sigue aplicando. El path resuelto pasa por el mismo confinamiento al directorio de medios y la misma protección contra lectura de credenciales, así que la corrección no salta ninguna frontera. Además solo se ejecuta en un backend local (TERMINAL_ENV=local); bajo un sandbox un fallo debe llegar igualmente a la lectura dentro del contenedor, o la frontera del sandbox se rompería.

Qué herramientas se benefician ahora

Un solo resolvedor de «la grafía en disco» lo comparten estos puntos de llamada:

Herramienta Antes Después
vision_analyze (mirar una imagen) media file not found encuentra el archivo, analiza con normalidad
Análisis de vídeo el mismo fallo también lo encuentra (_materialize_video devuelve el path con U+202F)
Generación de imagen / vídeo con un archivo de referencia local fallaba directamente _confine_source_images reescribe image_url y las referencias a la grafía que hay en disco, y deja intactas las URL y los archivos realmente ausentes
read_file ya lo manejaba sin cambios

La línea más clara del registro de verificación: para la misma captura, la fila de herramienta de la rama antigua dice "success": false … media file not found, la de la rama nueva dice "success": true, y el modelo responde después correctamente el color de la imagen. Un archivo de test nuevo, tests/tools/test_image_source_unicode_space.py, falla en la rama antigua con SourceNotFound.

Qué puedes hacer tú

El arreglo significa que Hermes se apaña solo, pero también puedes esquivar el problema:

  • Renombra el archivo. shot-1.png y ningún carácter invisible podrá entrar en el nombre. Merece la pena hacerlo en cualquier script por lotes.
  • Para ver si hay caracteres ocultos: ls -b escapa los caracteres invisibles, o imprime repr(path) en Python; U+202F aparece de inmediato.
  • Mejor arrastrar y soltar. Dejar que la herramienta tome el path ella misma (arrastrar, subir un adjunto) es mejor que hacer que un modelo reescriba un nombre de archivo largo.

Esto nunca fue solo cuestión de un carácter. Los nombres de archivo en NFD (habituales en macOS con acentos) y los apóstrofos curvos causaban la misma clase de fallo, y la misma clave de coincidencia los cubre ahora.

Si los errores de imagen siguen apareciendo, dos lecturas relacionadas: el presupuesto de contexto de visión para lo que pasa después de reducir una imagen grande, y fotos HEIC de un iPhone. Otras dos rutas que evitan del todo «el modelo reescribe un path»: pegar imágenes en la terminal y el comando de imagen del portapapeles.

Estado del release

El PR #154046 se fusionó en main el 12 de noviembre de 2026. Arregla el issue #76334 y hace cherry-pick del anterior #62126 manteniendo la autoría. La v0.23.1 salió el 10 de noviembre y no lo incluye. Dos issues relacionados, #76376 y #124742, cubrían casos solapados (no idénticos) —guía del lado del prompt, NFD y comillas curvas— y esta clave de coincidencia los absorbe todos.

Actualización (17/11/2026): estos cambios salieron en la v0.23.2 (16 de noviembre): hermes update los trae. Lo de «no está en la v0.23.1» es una foto del momento de la publicación.