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í:
- El path llega al contexto:
Screenshot 2026-11-12 at 9.51.42 AM.png; el carácter 26 es U+202F. - El modelo recibe una cadena que parece normal, pero cuando genera texto los espacios que produce son todos U+0020.
- El visor de imágenes llama a
open()sobre ese path, el sistema operativo compara bytes y no encuentra nada. - 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.pngya<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.pngy 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 -bescapa los caracteres invisibles, o imprimerepr(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 updatelos trae. Lo de «no está en la v0.23.1» es una foto del momento de la publicación.