CLI / TUI / Web

源码版本v2026.7.20

Verantwortung

Die UI-Schicht ist ein weiterer Satz Eingänge, über die Nutzer den Agenten erreichen (neben den Gateway-Nachrichtenplattformen): CLI (hermes_cli/, Befehlszeilen-Subcommand-System), TUI (ui-tui/, TypeScript-Terminal-UI + tui_gateway/-Python-Brücke), Web (web/, Browser-Oberfläche). Alle drei leiten die Nutzereingaben letztlich in run_conversation des Agenten und rendern die Ausgabe zurück. Sie stehen parallel zur Gateway-Schicht – das Gateway bindet externe Plattformen an, die UI-Schicht bindet lokale Nutzer an.

Schlüsseldateien

CLI

• hermes_cli/__init__.py — Package-Einstieg
• _parser.py — Kommandozeilen-Argument-Parsing
• auth.py / auth_commands.py — Authentifizierung (Nous Portal u. a.)
• active_sessions.py — aktive Sitzungen verwalten
• backup.py / checkpoints.py — Backup und Checkpoints
• blueprint_cmd.py — Blaupausen-Command
• browser_connect.py / bundles.py / callbacks.py
• banner.py / build_info.py — Banner und Build-Info

TUI

• ui-tui/README — Terminal-UI (TypeScript, inkl. packages/src)
• ui-tui/package.json — Abhängigkeiten und Skripte
• tui_gateway/entry.py — TUI-Gateway-Einstieg
• server.py — TUI-Server
• transport.py / ws.py — Transport und WebSocket
• event_publisher.py — Event-Publishing
• host_supervisor.py / compute_host.py — Host-Aufsicht
• slash_worker.py / synthetic_turn.py / render.py / project_tree.py
• _stdin_recovery.py — Stdin-Wiederherstellung

Web

• web/README — Browser-Oberfläche
• web/index.html / vite.config.ts — Vite-Einstieg
• web/src/ — Frontend-Quellen

Datenfluss

1. CLI: hermes <subcommand> → hermes_cli/_parser.py parsed → das Subcommand-Modul (auth/backup/blueprint/…) führt aus; dialogorientierte Commands rufen letztlich AIAgent.run_conversation:6350 auf.
2. TUI: ui-tui/ (TS-Frontend) verbindet sich per WebSocket mit tui_gateway/ws.py; tui_gateway übersetzt Terminal-Events an den Agenten (tui_gateway/server.py hält den Agenten), Output wird über tui_gateway/event_publisher.py ans Frontend gepusht.
3. Web: web/ (Vite-Frontend) bindet sich ebenfalls über ein Backend an den Agenten und rendert Dialog und Werkzeugergebnisse.
4. Die Agent-Instanz aller drei wird über init_agent:276 zusammengebaut und teilt sich die Fähigkeitsschicht.

Zusammenfassung

UI-Schicht = drei Hüllen (CLI/TUI/Web) + eine tui_gateway-Brücke. Sie tragen keine Geschäftslogik, sondern nur Ein-/Ausgabeform. Parallel zum Gateway: das Gateway bindet externe Nachrichtenplattformen an, die UI-Schicht bindet lokales Terminal/Browser an. ACP (siehe hier) bindet die IDE an und komplettiert die «Erreichungsfläche».