Sitzungen

Eine Sitzung bewahrt Nachrichten, Werkzeugaktivitäten, Rückfragen, Rolle, Modell und Zweigzustand eines Gesprächs. Sie gehört zum ausgewählten Profil. Das Schließen von Dashboard oder TUI löscht ihren Verlauf nicht.

Sitzungsverlauf liegt in state.db und referenzierten Objekten. Sitzungsübergreifende persönliche Erinnerungen sind getrennt: memory/USER.md und memory/MEMORY.md. Eine Kontextzusammenfassung ist kein neuer Erinnerungseintrag.

Starten und fortsetzen

Wählen Sie im Dashboard Neue Sitzung oder einen vorhandenen Chat. Chats enthält gewöhnliche Gespräche; Hintergrund enthält geplante, delegierte und residente Hintergrundarbeit. Ältere Sitzungen und Nachrichten werden seitenweise geladen.

Führen Sie in der TUI anyy aus und verwenden Sie dann /new oder /sessions. Ein bekanntes Gespräch direkt öffnen:

anyy --resume SESSION_ID

Eine Rolle für ein neues Gespräch wählen:

anyy --role scribe
anyy chat --role scribe "Help me plan this article"

Eine fortgesetzte Sitzung behält ihre Rolle. --role kann nicht mit --resume oder chat --session kombiniert werden. Sitzungs-IDs werden nur innerhalb des ausgewählten Profils aufgelöst.

Einen CLI-Gesprächsschritt senden

anyy chat "Summarize my priorities"
anyy chat --session SESSION_ID --json "Add the new constraint"

anyy chat erfordert ein laufendes Gateway. Es wartet auf die ursprünglich angenommene Eingabe und ihren tatsächlichen Lauf, auch wenn spätere Gesprächsschritte dieselbe Sitzung verwenden. --json enthält Sitzungs-, Übermittlungs-, Ausführungs- und Lauf-IDs, Ergebnis und gespeicherte Antwort. Ein späterer Erfolg kann keinen früheren Fehler ersetzen.

Unterbrechung für Rückfragen, Fehler, Abbruch, entfernte Eingabe und Wartezeitüberschreitung liefern einen Status ungleich null. Ein Zeitlimit oder Abbruch durch den Aufrufer stoppt das Warten, nicht die angenommene Arbeit. Prüfen Sie die Sitzung, bevor Sie den Prompt erneut senden. Siehe CLI-Ergebnisse.

Ausstehende Nachrichten

Jede Sitzung hat zwei unabhängige Eingabewarteschlangen:

• Steuerung wird am nächsten Steuerungspunkt des Agenten gelesen. Sie bricht kein laufendes Werkzeug ab.
• Folgenachrichten warten, bis die aktuelle Antwort endet.

Dashboard hat eine einzige Schaltfläche Senden. Während es beschäftigt ist, fügt Senden eine Folgenachricht oberhalb der Eingabe hinzu. Jeder wartende Eintrag bietet Steuern, Bearbeiten und Löschen. Steuern verschiebt ihn für den nächsten Kontrollpunkt in das ausstehende Gespräch. Bearbeiten ändert nur diesen wartenden Eintrag und behält Anhänge, sofern nicht entfernt; Abbrechen des Editors lässt ihn unverändert. Löschen entfernt diesen wartenden Eintrag. Eine bereits ausgewählte Eingabe kann nicht als Warteschlangeneintrag bearbeitet oder gelöscht werden. Konfligierende Änderungen aktualisieren die Warteschlange und erhalten den ungesendeten Entwurf. Siehe Dashboard-Chat.

In der beschäftigten TUI fügt Enter eine Steuerungseingabe und Alt+Enter eine Folgenachricht hinzu. Die Warteschlange zeigt zuerst Steuerungs-, dann Folgenachrichten. Alt+Up gibt allen wartenden Text und Anhänge an den Editor zurück, ohne Arbeit zu stoppen. Der zurückgegebene Text steht durch Leerzeilen getrennt vor Ihrem vorhandenen Entwurf. Erst eine erfolgreiche Gateway-Bestätigung entfernt die Warteschlangenzugehörigkeit; das Senden des überarbeiteten Entwurfs nimmt eine neue Eingabe auf.

Stoppen oder an den Editor zurückgeben

Aktion	Aktive Arbeit	Ausstehende Eingaben
Dashboard Escape	Stoppt die beim Tastendruck angezeigte Antwort	Beibehalten
TUI Ctrl+C bei Beschäftigung	Stoppt aktuelle Sitzungsarbeit	Beibehalten
TUI Esc während Streaming	Gibt Eingaben zurück und stoppt dann den erfassten Gesprächsschritt	An Editor zurückgegeben
TUI Alt+Up	Läuft weiter	An Editor zurückgegeben
TUI Esc während Wiederholungs-Backoff	Bricht diese Wiederholungswartezeit ab	Unverändert

Lokale Auswahlfenster und Overlays verarbeiten Escape zuerst. Verzögerte Bestätigungen für Dashboard-Stopp oder TUI-Editorrückgabe können keinen späteren Gesprächsschritt unterbrechen. Abbruch wartet, bis die erfasste Arbeit beendet ist, und bewahrt festgeschriebenen Verlauf. Er startet nicht automatisch einen weiteren Aufruf; ein späterer Prompt oder eine explizite Sitzungsfortsetzung setzt Arbeit fort.

API-Warteschlangensteuerung

Verbundene Clients können ausstehende Eingaben mit session.queue.peek/session.queue.list prüfen, entfernte Eingaben mit session.queue.clear zurückgeben und wartende Einträge mit session.queue.steer, .update und .cancel ändern. Das Entfernen der Warteschlangenzugehörigkeit bewahrt den gespeicherten Eingabeinhalt; es löscht kein Transkript.

session.queue.modes liest oder setzt steering und follow_up unabhängig auf all oder one-at-a-time. Dies legt fest, ob ein Kontrollpunkt alle geeigneten Nachrichten oder jeweils eine nimmt; Steuerung wird dadurch nicht zur Folgenachricht. Dies sind RPC-Einstellungen, keine /queue-Befehle oder Dashboard-Warteschlangenmodi.

Modell- und Werkzeugeinstellungen

Die Dashboard-Modellauswahl und TUI /provider, /model und /effort steuern die aktuelle Sitzung. Profilmodellvorgaben initialisieren neue Sitzungen. Fortsetzen oder Navigieren eines Zweigs stellt die zutreffende Sitzungsauswahl wieder her; ist ein zuvor ausgewähltes virtuelles Modell nicht mehr registriert, kann Anyy auf das Modell der letzten physischen Antwort zurückfallen.

Rollen definieren Identität und Soul-Anweisungen. Sie wählen keine Werkzeugnamen oder den Codemode-Modus. Verwenden Sie CLI-Werkzeugflags oder session.tools.configure für die Werkzeugauswahl einer Sitzung. Eine explizite Aktualisierung erfordert eine untätige Sitzung ohne wartende/aufzunehmende Arbeit oder Zusammenfassungsoperation. Die Werkzeug-/Codemode-Einstellungen gehören zum Profil.

Ressourcen neu laden

Der RPC session.reload aktualisiert eine untätige Sitzung anhand aktueller Profileinstellungen und Ressourcen, wobei Verlauf, ausgewählter Speicher, geladene Werkzeuge und ausstehende Eingaben erhalten bleiben. Er stoppt keine aktive Arbeit und startet keinen neuen Gesprächsschritt. Ressourcen werden geordnet geladen; ein Fehler bedeutet nicht, dass jede frühere Ressourcenänderung rückgängig gemacht wurde. Es gibt keine entsprechende Dashboard-Schaltfläche, keinen TUI-Befehl und keinen Shell-Unterbefehl.

Zielmetadaten-API

session.goal speichert optionalen Zieltext und den Zustand active oder paused in den Sitzungsmetadaten. Clients können set, status, pause, resume und clear verwenden. Es startet oder stoppt keinen Lauf, erstellt keinen geplanten Auftrag und setzt Arbeit nicht selbstständig bis zum Abschluss fort. Es ist von persönlichen Aufgabeneinträgen getrennt. Dashboard und TUI bieten kein /goal, und die Shell-CLI hat keinen Ziel-Unterbefehl.

Wiederholungen und Kontextgröße

Vorübergehende Modellfehler werden standardmäßig automatisch wiederholt, höchstens dreimal nach der ersten Anfrage. Die Wartezeit beginnt bei zwei Sekunden und wächst exponentiell bis maximal eine Minute. Diese Sitzungseinstellungen werden im Profil gemeinsam genutzt; Wiederholungen des Anbietertransports sind eine separate Ebene. Während einer Wiederholungswartezeit bricht TUI Esc nur das Warten ab. Ctrl+C oder Dashboard Escape stoppt die Arbeit.

Komprimierung und Zweigzusammenfassungen teilen die Wiederholungsrichtlinie des Profils. Eine Operation behält ihr Wiederholungsbudget; spätere Modellaufrufe lesen weiterhin aktuelle Transportvorgaben. Das Deaktivieren automatischer Wiederholungen deaktiviert keine HTTP-Zeitlimits. Eine fehlgeschlagene, abgebrochene oder abgeschnittene Zusammenfassung wird nicht angewendet. Automatische Kontextwiederherstellung und die verfügbare manuelle API sind unter Kontextkomprimierung beschrieben.

Vorhandenen Verlauf durchsuchen

TUI /tree öffnet im Leerlauf den aktuellen Gesprächsbaum. Verwenden Sie Up/Down, Enter zum Auswählen, s zum Umschalten einer Zusammenfassung des verlassenen Zweigs und Esc zum Abbrechen. Die Auswahl einer Benutzernachricht springt an die Stelle davor und gibt ihren Text zur Überarbeitung an eine leere Nachrichteneingabe zurück. Sichern Sie vor der Navigation einen Entwurf, wenn Sie den zurückgegebenen Text möchten. Die Navigation bleibt in derselben Sitzung und startet keine Modellantwort. Frühere und benachbarte Zweige bleiben im Baum.

APIs für Abzweigung und Löschung

session.fork erstellt ab einem gewählten Punkt ein separates Gespräch und bewahrt Verlauf und Beschriftungen dieses Pfads. Eine Abzweigung vor einer Benutzernachricht kann deren Text zur Überarbeitung zurückgeben, ohne ihn erneut zu senden. Laufende Arbeit, ausstehende Warteschlangen oder Kanal-Sendeberechtigungen werden nicht kopiert.

Eine Abzweigung beeinflusst auch das ursprüngliche Gespräch: Sie erfasst dessen aktuelle Arbeit, bevor sie die Abzweigung vorbereitet. Sobald das neue Gespräch dauerhaft gespeichert ist, unterbricht Anyy die erfasste Arbeit und wartet auf deren Ende. Ein verzögerter Stopp unterbricht keinen nachfolgenden Gesprächsschritt. Schlägt das Beenden fehl, bleibt das neue Gespräch gespeichert; ein Fehler bedeutet nicht, dass die Abzweigung zurückgerollt wurde.

session.delete entfernt ein Gespräch und bewahrt Verlauf, der noch von einer anderen Abzweigung referenziert wird. Hat die Sitzung nicht abgeschlossene Arbeit, liefert das Löschen einen Konflikt; es stoppt diese Arbeit nicht automatisch, um danach die Sitzung zu löschen.

Abzweigung und einzelne Sitzungslöschung sind öffentliche RPC-Fähigkeiten. Die aktuellen Dashboard-, TUI- und Shell-CLI-Oberflächen bieten keine Abzweigungs-/Löschaktion. TUI /tree navigiert innerhalb eines Gesprächs und ist kein Abzweigungsbefehl.

Fehlerbehebung

Problem	Prüfung
Ein Gespräch fehlt	Ausgewähltes Profil und Registerkarte Chats/Hintergrund
/sessions oder /tree lässt sich nicht öffnen	Gesprächsschritt abwarten oder zuerst stoppen
Eine Korrektur soll laufende Arbeit beeinflussen	Dashboard: senden, dann Steuern; TUI: Enter bei Beschäftigung
Eine wartende Nachricht lässt sich nicht bearbeiten	Sie wurde möglicherweise bereits ausgewählt; aktualisierten Verlauf prüfen
CLI-Chat kann keine Verbindung herstellen	anyy gateway start für dieses Profil ausführen
Nach dem Fortsetzen erscheint ein alter Rollen- oder Modellzustand	Die Sitzung besitzt diesen Zustand; Modell auswählen oder für neue Vorgaben eine neue Sitzung beginnen

Die Profil-Sicherung enthält dauerhafte Sitzungsdaten. Verwenden Sie pro längerfristigem Thema eine Sitzung und beginnen Sie eine neue, wenn früherer Kontext nicht mehr nützlich ist.