Hermes Skin-Wartung

Was macht Hermes Skin-Wartung?

Verwenden Sie diese Fähigkeit, um einen vorhandenen Hermes-Skin zu prüfen, zu erweitern oder zu reparieren, während sein visueller Charakter in CLI, TUI und Desktop-App erhalten bleibt.

Zuständigkeitsbereich

• Der kanonische, plattformübergreifende Farbvertrag ist SKIN_COLOR_TOKENS in apps/shared/src/skin.ts im Hermes-Agent-Repository. Holen Sie die Rohdatei von dem vom Benutzer angeforderten Branch oder von main, wenn keine Revision angegeben ist.
• Ein Skin kann Legacy- oder Nischen-Schlüssel enthalten, aber die Token-Abdeckung darf nur anhand der kanonischen Liste gemessen werden. Löschen Sie keine kompatiblen Extras, nur weil sie in dieser Liste fehlen.
• Ermitteln Sie das aktive Hermes-Verzeichnis aus $HERMES_HOME; falls nicht gesetzt, verwenden Sie ~/.hermes. Bearbeiten Sie niemals config.yaml von Hand.

Vorgehen

1. Laden Sie die Hermes-Theming-Anleitung, falls verfügbar, und überprüfen Sie das Ziel-Skin-YAML.
2. Holen und parsen Sie SKIN_COLOR_TOKENS; leiten Sie die Liste nicht aus einer alten Vorlage ab.
3. Berechnen Sie die fehlenden Schlüssel programmatisch aus der colors-Abbildung des Skins.
4. Fügen Sie nur fehlende kanonische Schlüssel hinzu. Bewahren Sie vorhandene Werte und weisen Sie neue Farben nach semantischer Familie zu, anstatt unzusammenhängende Farbtöne zu erfinden:
   • background: eine dunkle oder helle Grundfläche, die zum etablierten Skin passt.
   • primary/text/border: Wiederverwendung der vorhandenen Überschriften-, Text- und Strukturpalette.
   • tool/thinking: Übernahme der Akzent- und Sekundärfarben des Skins, sofern keine bewusste Kontrastunterscheidung besteht.
   • diff/status/syntax: Mapping von positive→ok, warning/number→warn, negative→error; Verwenden Sie einen etwas stärkeren Farbton für Wort-Diffs und kritischen Status.
   • terminal chrome: Wiederverwendung der prompt/accent/text-Hierarchie konsistent.
5. Behalten Sie alle Werte als zitierte sechsstellige #rrggbb-Farben bei.
6. Validieren Sie das YAML und überprüfen Sie, dass alle kanonischen Tokens nun vorhanden sind.
7. Wenden Sie den bearbeiteten Skin mit hermes config set display.skin <name> an und lesen Sie hermes config get display.skin zurück, bevor Sie den Erfolg melden.

Verifikations-Checkliste

Melden Sie diese genauen Prüfungen:

• Zieldateipfad und eingebetteter Skin-name stimmen überein.
• YAML wird erfolgreich geparst.
• missing_tokens=none gegenüber der abgerufenen kanonischen SKIN_COLOR_TOKENS.
• Der aktive Skin löst nach dem Anwenden auf den Zielnamen auf.

Fallstricke

• Die vorhandene Palette des Skins kann absichtlich background auslassen; das Hinzufügen ist dennoch für eine zuverlässige Desktop-/TUI-Basisflächendarstellung erforderlich.
• status_bar_bad und status_bar_critical sind unterschiedlich. Halten Sie nicht bei der älteren, kleineren Vorlagenpalette an.
• Wenn Sie in derselben Sitzung den konfigurierten Modellanbieter wechseln, entfernen Sie eine geerbte benutzerdefinierte model.base_url, nachdem Sie einen OAuth-Anbieter ausgewählt haben; andernfalls kann ein alter lokaler Endpunkt in der Konfiguration verbleiben. Überprüfen Sie den Authentifizierungsstatus des ausgewählten Anbieters, bevor Sie die Migration als abgeschlossen erklären.
• Ändern Sie keine gebündelten oder benutzereigenen Hermes-Fähigkeiten. Erstellen oder aktualisieren Sie stattdessen eine kuratorenverwaltete Begleitfähigkeit.