Der Screenshot ist da, aber Hermes sagt, die Datei fehle: Im Namen steckt ein unsichtbares Leerzeichen


Du ziehst einen frischen Screenshot in den Chat und bittest Hermes, sich den Fehler auf dem Bildschirm anzusehen. Die Datei wird sauber gespeichert, der Path lässt sich sauber ausgeben, und dann scheitert der Schritt, der das Bild öffnet: media file not found. Du schaust im Finder nach. Die Datei liegt genau da, mit genau diesem Namen.

Der Haken steckt in „genau diesem Namen“. Wenn macOS einen Screenshot benennt, ist das Leerzeichen vor AM/PM kein normales Leerzeichen. Es ist U+202F, ein schmales geschütztes Leerzeichen. Auf dem Bildschirm sieht es identisch aus wie ein normales Leerzeichen — ein Haar schmaler, auf den ersten Blick unsichtbar. Wenn ein Modell den Namen neu tippt, erzeugt es U+0020, und zwei verschiedene Bytes heißen: Der Path zeigt auf eine Datei, die es nicht gibt.

PR #154046, gemergt am 12. November, lässt Vision-Analyse, Video-Analyse und Bild-/Video-Generierung die Schreibweise auf der Platte selbst finden.

Ein Zeichen, eine ganze kaputte Kette

Der Fehlschlag läuft so:

  1. Der Path landet im Kontext: Screenshot 2026-11-12 at 9.51.42 AM.png — Zeichen 26 ist U+202F.
  2. Das Modell bekommt einen String, der normal aussieht, aber wenn es Text generiert, sind alle Leerzeichen, die es produziert, U+0020.
  3. Der Image-Viewer ruft open() auf diesem Path auf, das OS vergleicht Bytes und findet nichts.
  4. Der Fehler sagt media file not found. Er sagt nicht „ein Argument unterscheidet sich um ein Byte“.

Das Schlimmste ist, wie es sich liest: Es sieht aus wie ein Rechte- oder Path-Problem, also prüfst du Paths, Berechtigungen und Sandboxes, während die echte Ursache ein Zeichen ist, das du nicht siehst.

Ein kleines Detail, das es inkonsistent wirken ließ: read_file kam mit diesem Fall schon zurecht. Dieselbe Datei war also mit read_file lesbar und mit vision_analyze nicht.

Der Fix: auf das matchen, was das Auge sieht — aber nur, wenn eine Datei passt

Er arbeitet in zwei Schichten.

Ein Match-Key. tools/file_operations_common.py bekam filename_match_key, das einen Namen auf „was ein Mensch als dasselbe liest“ normalisiert: NFC- und NFD-Unicode-Kompositionen, schmale und spezielle Leerzeichen, typografische Apostrophe.

Ein Lookup auf der Platte. _on_disk_spelling in tools/image_source.py läuft nach einem Path-Miss und sucht im selben Verzeichnis nach der einen Datei, deren Name sich nur unsichtbar unterscheidet:

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

Zwei Details solltest du im Kopf behalten:

  • Nur ein Kandidat. Liegen in einem Verzeichnis sowohl a AM.png als auch a<U+202F>AM.png, rät es nicht — das falsche Bild zu lesen ist schlimmer als zu scheitern.
  • Sicherheit gilt weiter. Der aufgelöste Path geht durch dieselbe Media-Directory-Confinement und denselben Credential-Read-Guard, die Korrektur umgeht also keine Grenze. Er läuft außerdem nur auf einem lokalen Backend (TERMINAL_ENV=local); unter einer Sandbox muss ein Miss weiterhin den Read im Container erreichen, sonst bräche die Sandbox-Grenze.

Welche Tools jetzt profitieren

Ein Resolver für „die Schreibweise auf der Platte“ wird von diesen Call-Sites geteilt:

Tool Vorher Nachher
vision_analyze (ein Bild ansehen) media file not found findet die Datei, analysiert normal
Video-Analyse derselbe Miss findet sie auch (_materialize_video liefert den U+202F-Path)
Bild-/Video-Generierung mit lokaler Referenzdatei scheiterte direkt _confine_source_images schreibt image_url und Referenzen auf die Schreibweise auf der Platte um und lässt URLs und wirklich fehlende Dateien in Ruhe
read_file kam schon damit zurecht unverändert

Die klarste Zeile im Verifikationsprotokoll: Bei demselben Screenshot liest sich die Tool-Zeile des alten Branches als "success": false … media file not found, die des neuen Branches als "success": true, und das Modell antwortet danach korrekt mit der Farbe im Bild. Eine neue Testdatei, tests/tools/test_image_source_unicode_space.py, scheitert auf dem alten Branch mit SourceNotFound.

Was du selbst tun kannst

Der Fix heißt: Hermes kommt allein zurecht. Du kannst es aber auch umgehen:

  • Datei umbenennen. shot-1.png, und kein unsichtbares Zeichen kann je in den Namen geraten. In jedem Batch-Skript eine gute Idee.
  • Um zu sehen, ob versteckte Zeichen drin sind: ls -b escapt unsichtbare Zeichen, oder gib in Python repr(path) aus — U+202F fällt sofort auf.
  • Drag and Drop bevorzugen. Das Tool den Path selbst nehmen zu lassen (Drag, Anhang-Upload) schlägt es, ein Modell einen langen Dateinamen neu tippen zu lassen.

Das ging nie nur um ein Zeichen. NFD-Dateinamen (auf macOS üblich bei Namen mit Akzenten) und typografische Apostrophe verursachten dieselbe Klasse von Miss, und derselbe Match-Key deckt sie jetzt ab.

Wenn Bildfehler wiederkommen, zwei verwandte Reads: das Vision-Kontextbudget dafür, was passiert, nachdem ein großes Bild herunterskaliert wurde, und HEIC-Fotos vom iPhone. Zwei andere Wege, die „das Modell tippt einen Path neu“ komplett vermeiden: Bilder im Terminal einfügen und der Clipboard-Image-Befehl.

Release-Status

PR #154046 ist am 12. November 2026 in main gemergt. Er fixt Issue #76334 und cherry-pickt den früheren #62126 mit erhaltener Autorschaft. v0.23.1 erschien am 10. November und enthält ihn nicht. Zwei verwandte Issues, #76376 und #124742, deckten überlappende (nicht identische) Fälle ab — Prompt-seitige Hinweise, NFD und typografische Anführungszeichen — und dieser Match-Key absorbiert sie alle.

Update (17.11.2026): Diese Änderungen sind mit v0.23.2 (16. November) erschienen – ein hermes update bringt sie. Die Formulierung „nicht in v0.23.1“ oben ist eine Momentaufnahme vom Veröffentlichungstag.