Leitfaden für die Memory Console

Ziel des Benutzers und Konsolenübersicht

Die Memory Console bietet eine visuelle Weboberfläche unter /me (mit dem Alias /memory-console) zum Überprüfen, Durchsuchen und Verwalten von Speicheraufzeichnungen, Agentenverbindungen, Projekten und Sicherheitseinstellungen. Anstatt ausschließlich über CLI-Befehle oder MCP-Tools zu interagieren, nutzen Entwickler und Teammitglieder die Konsole, um zu prüfen, was Agenten aufgezeichnet haben, ungenaue Erinnerungen zu korrigieren, die Agentenzuordnung einzusehen, API-Tokens zu verwalten und den Datenexport sowie die Löschung zu steuern.

Verfügbarkeit und Voraussetzungen

Die Memory Console ist in jedem modernen Browser für authentifizierte Benutzer verfügbar. Das Konsolenlayout gliedert Funktionen in verschiedene Arbeitsbereichs- und Zugriffsbereiche, die über die Navigation in der Seitenleiste und direkte URL-Hash-Anker erreichbar sind:

• Authentifizierungsanforderung: Eine aktive Benutzersitzung ist erforderlich. Nicht authentifizierte Besuche werden auf /login (die Anmeldeseite) umgeleitet.
• Übersicht (#overview): Kurze Zusammenfassung des persönlichen Speicherarbeitsbereichs, der letzten Aktivitäten, verbundener Agenten und Speichersignale.
• Erinnerungen (#memory): Suchen, Filtern, Überprüfen und Bearbeiten von Speicheraufzeichnungen mit Volltextsuche, Typfiltern und Quellfiltern.
• Knowledge (#knowledge): Anzeigen und Verwalten von Wissensdokumenten, die autorisierte Agenten konsultieren können.
• Projekte (#projects): Durchsuchen von Projektarbeitsbereichen, kontextbezogenen Notizen und projektbezogenen Erinnerungen.
• Cloud Skill (#skills): Erstellen, Importieren und Verwalten von prozeduralen Cloud Skills. Gekennzeichnet mit einem Preview-Badge und verfügbar, sofern für Ihr Konto freigeschaltet.
• Dream (#dream): Wiederkehrende Muster und Synthesevorschläge prüfen, bevor sie zu dauerhaften Erinnerungen werden. Gekennzeichnet mit einem Preview-Badge und verfügbar, sofern für Ihr Konto freigeschaltet.
• Agenten (#agents): Anzeigen von Agenten, die mit diesem Arbeitsbereich verbunden sind, Überprüfen von Zeitstempeln der letzten Aktivität und Einsehen von Berechtigungen.
• Teams (#teams): Erstellen und Verwalten von Teams, Einladen von Mitgliedern und Konfigurieren von Team-Arbeitsbereichsrollen. Gekennzeichnet mit einem Preview-Badge und verfügbar, sofern für Ihr Konto freigeschaltet.
• Profil (#profile): Kontoidentität, E-Mail-Bestätigungsstatus und persönliche Präferenzen.
• Sitzungen (#sessions): Überprüfen aktiver Anmeldesitzungen und verbundener Geräte.
• API-Schlüssel (#api-keys): Ausstellen, Rotieren und Widerrufen berechtigter Zugriffstokens für CLI, Agenten und Automatisierungen.
• Einstellungen (#memory-settings): Datenschutzstatus, Sicherheitsmodi, Datenexportanfragen und Steuerelemente zur Speicherlöschung.

Eine vollständige Aufgabe: Synthetische Erinnerung überprüfen und korrigieren

In diesem Durchgang lokalisieren Sie die synthetische Konventionserinnerung, die während des Quickstart-Leitfadens gespeichert wurde, überprüfen deren Agentenzuordnung, korrigieren ihren Text in der Konsole, verifizieren die Aktualisierung und bestätigen die Grenzen des persönlichen Arbeitsbereichs.

1. Synthetische Erinnerung im Bereich Erinnerungen lokalisieren

Navigieren Sie zu /me und öffnen Sie den Bereich Erinnerungen, indem Sie in der Seitenleiste auf Memories klicken oder zu #memory navigieren. Geben Sie "demo project timestamp format" in die Suchleiste ein oder filtern Sie nach der Kategorie Facts. Die Liste zeigt passende Speicherkarten mit zusammenfassendem Inhalt, Erstellungszeitpunkt und Sichtbarkeits-Badges.

# Access personal workspace
https://xmemo.dev/me#memory

# Access team workspace with explicit team context
https://xmemo.dev/me?space=<team_id>#memory

2. Agentenzuordnung und Metadaten überprüfen

Klicken Sie auf die Speicherkarte, um das Explain-Bedienfeld zu öffnen. Die Konsole zeigt Herkunfts- und Zuordnungsdetails an, die beim Schreibvorgang erfasst wurden:

• Art des Verfassers und Agentenidentität: Zeigt an, ob die Erinnerung von einem Agenten, einem menschlichen Benutzer oder einem importierten Skript verfasst wurde, zusammen mit Agentenname und ID.
• Agenteninstanzanzeige: Zeigt die eindeutige Agenteninstanzkennung (agent_instance_display) an, um zwischen separaten Ausführungen desselben Agenten zu unterscheiden.
• Gerät und Übertragung: Zeigt die Gerätebezeichnung (device_label) und den Übertragungskanal an, über den der Schreibvorgang übermittelt wurde.
• Sichtbarkeit und Bereich: Gibt an, ob der Datensatz persönlich oder im Team geteilt ist (team_id), zusammen mit Projekt- und Bucket-Zuweisungen.
• Versionsverlauf: Zeigt die aktuelle Revisionsnummer an und verlinkt auf die Schublade für die Versionslinie.

3. Speicherinhalt direkt bearbeiten

Klicken Sie auf der Speicherkarte auf die Schaltfläche Edit, um den Inline-Editor zu öffnen. Aktualisieren Sie den Inhalt, um die präzisierte Projektkonvention widerzuspiegeln, und klicken Sie dann auf Save:

• Aktualisierter Inhalt: Ändern Sie "demo project timestamp format" in "Demo project timestamps use UTC with ISO 8601 formatting.".
• Speicheraktion: Die Konsole sendet eine authentifizierte Aktualisierungsanfrage mit CSRF-Schutz und erhöht den Revisionszähler.
• Konfliktschutz: Falls ein Agent die Erinnerung gleichzeitig aktualisiert hat, erkennt die Konsole die Revisionsabweichung (HTTP 409) und fordert mit "CAS version conflict: Data has been updated elsewhere. Please refresh and try again." dazu auf, den neuesten Inhalt vor dem Überschreiben zu prüfen.

4. Aktualisierung in der Konsole und beim Agentenabruf verifizieren

Nach dem Speichern zeigt die Konsole eine Erfolgsmeldung an und aktualisiert die Speicherkarte. Die Versionslinien-Schublade zeigt die vorherige Revision als durch die neue Revision abgelöst. Um zu überprüfen, dass verbundene Agenten die Korrektur sofort wahrnehmen, führen Sie recall in Ihrem Terminal aus:

node scripts/xmemo-skill.mjs recall --query "demo project timestamp format" --limit 1

Beobachtbares Ergebnis

Eine erfolgreiche Konsolenkorrektur führt zu beobachtbaren Änderungen auf der Weboberfläche und in den Agentenschnittstellen:

• Webkonsolen-Toast: Ein Bestätigungstoast ("Memory updated") erscheint am unteren Bildschirmrand.
• Kartendarstellung: Die Karte zeigt sofort den aktualisierten Text, den aktualisierten Zeitstempel und den erhöhten Revisionsindex an.
• Linien-Schublade: Die Versionslinien-Schublade zeigt Diffs auf Wortebene, die die vorherige Revision mit dem aktualisierten Text vergleichen.
• Agent-Recall-Ausgabe: Eine Abfrage nach "demo project timestamp format" liefert den aktualisierten Text mit der neuesten Revisionsreferenz zurück.

Worauf Agenten zugreifen können

Agenten und Konsolenbenutzer agieren unter unterschiedlichen Authentifizierungs- und Berechtigungsgrenzen:

• Konsolenberechtigungen: Konsolenbenutzer greifen über Browser-Cookies mit CSRF-Validierung auf Daten zu. Aktionen in der Konsole spiegeln das angemeldete Benutzerprofil wider.
• Agentenberechtigungen: Agenten authentifizieren sich mit berechtigten API-Schlüsseln, die im Bereich API-Schlüssel (#api-keys) ausgestellt wurden, oder über OAuth-Tokens. Zu den zulässigen Token-Bereichen gehören memory:read, memory:write, knowledge:read, ledger:read, ledger:write und read:audit.
• Sichtbarkeitsgrenze für Agenten: Agenten können keine Kontopasswörter, aktiven Browsersitzungen oder Abrechnungsdetails einsehen. Ein Agent mit einem persönlichen Token kann nur persönliche Erinnerungen und öffentliches Wissen abfragen; er kann Team-Arbeitsbereiche nicht einsehen, sofern er nicht ausdrücklich an dieses Team gebunden ist.

Freigabe- und Speichergrenzen

Die Memory Console erzwingt eine strikte Trennung zwischen persönlichen Daten und Team-Arbeitsbereichen:

• Bereichsauswahl: Die Bereichsauswahl wechselt über den Abfrageparameter ?space=<team_id> (verwaltet durch useSpaceContext) zwischen persönlichem Speicher und Team-Arbeitsbereichen. Das Weglassen des Parameters oder das Setzen von ?space=personal beschränkt die Ansichten auf den persönlichen Speicher.
• Isolation von Einstellungen: Das Einstellungs-Bedienfeld (#memory-settings) wird beim Durchsuchen eines Team-Bereichs automatisch ausgeblendet, um mandantenübergreifende Konfigurationsabweichungen zu verhindern. Der Versuch, die Einstellungen in einem Team-Bereich zu öffnen, setzt den aktiven Bereich auf Personal zurück.
• Grenzen des Datenexports: Unter Einstellungen (#memory-settings) können Benutzer ein geheimnissicheres Exportarchiv anfordern (/api/v1/me/export-requests). Der persönliche Export umfasst persönliche Speicheraufzeichnungen, Versionslinien, persönliche Ledger-Transaktionen und persönliche Dokumente. Teamspeicher ist in persönlichen Exporten strikt ausgeschlossen.
• Autorisierung des Export-Downloads: Generierte Exportarchive erfordern eine Sudo-Abfrage, um ein temporäres Download-Autorisierungstoken zu erhalten, bevor xmemo-personal-export.zip heruntergeladen werden kann. Exportartefakte können jederzeit widerrufen und gelöscht werden.
• Steuerelemente zur Speicherlöschung: Benutzer können einzelne Erinnerungen mit Bestätigung löschen, alle Erinnerungen leeren oder Erinnerungen zurücksetzen, indem sie ihre Konto-E-Mail bestätigen und den Bestätigungssatz "RESET MY XMEMO MEMORY" eingeben. Die Selbstbedienungs-Kontoschließung erfordert die Übertragung aller eigenen Teams vor der Löschung (HTTP 409).
• TODO-Einstiegspunkte: Die Konsole stellt TODOs als aggregierte Zähler auf den Projektkarten unter Projekte (#projects) dar und zeigt die Anzahl der offenen Aufgaben für jeden Arbeitsbereich an.
• Ledger-Einstiegspunkte: Ledger-Datensätze erscheinen als filterbare Typkategorie unter Erinnerungen (#memory), können auf API-Tokens (ledger:read, ledger:write) unter API-Schlüssel (#api-keys) beschränkt werden und sind in persönlichen Datenexportarchiven enthalten.

Fehlerbehebung

Beheben Sie häufige Konsolenfehler und Zugriffsprobleme anhand der folgenden Schritte:

• Erinnerung in der Suche nicht gefunden: Prüfen Sie, ob die Bereichsauswahl auf den richtigen Bereich eingestellt ist (Personal vs Team ?space=<team_id>). Setzen Sie aktive Dropdown-Filter in der Symbolleiste (wie Typ oder Sichtbarkeit) zurück, um die Suchergebnisse zu erweitern.
• Fehler bei gleichzeitiger Bearbeitung (HTTP 409): Falls ein Agent oder ein anderer Tab die Erinnerung aktualisiert hat, während Ihre Bearbeitung geöffnet war, zeigt die Konsole an: "CAS version conflict: Data has been updated elsewhere. Please refresh and try again.". Aktualisieren Sie die Liste, prüfen Sie die neue Revision und wenden Sie Ihre Änderungen erneut an.
• Einstellungsoption in der Seitenleiste nicht sichtbar: Die Einstellungen sind beim Betrachten eines Team-Bereichs ausgeblendet. Öffnen Sie das Bereichs-Dropdown in der Seitenleiste und wechseln Sie zurück zum persönlichen Arbeitsbereich, um den Zugriff auf die Einstellungen (#memory-settings) wiederherzustellen.
• Download-Autorisierung für Export abgelaufen: Sudo-Download-Autorisierungstokens sind kurzlebig. Geben Sie Ihre Kontodaten im Download-Dialog erneut ein, um eine frische Download-Autorisierung zu generieren.

Verwandte Referenzen

Konsultieren Sie verwandte Konzept- und Werkzeugdokumentationen für grundlegende Mechanismen und API-Verträge:

• Schnellstart: /docs/quickstart für die Ersteinrichtung und die Erstellung synthetischer Erinnerungen.
• Speicherkorrektur: /docs/concepts/memory-correction für Versionsverlauf und Ersetzungssemantik.
• Speicherlöschung: /docs/concepts/memory-deletion für Soft-Delete und den Lebenszyklus von Grabsteinen.
• Herkunft und Zuordnung: /docs/concepts/provenance-attribution für Agenteninstanz- und Verfasserart-Spezifikationen.
• Projekte: /docs/concepts/projects für Projektarbeitsbereichsgrenzen und Kontextbereiche.
• Teams: /docs/capabilities/teams für die Erstellung von Team-Arbeitsbereichen, Rollen und Zusammenarbeit.
• Wissensbasen: /docs/concepts/knowledge-bases für Dokumentbasen und Veröffentlichungsregeln.
• Cloud Skills: /docs/concepts/cloud-skills für das Verfassen prozeduraler Cloud Skills.
• Dream-Reflexion: /docs/concepts/dream-reflection für Musteranalysekonzepte.
• Governance und Aufbewahrung: /docs/concepts/governance-retention für Aufbewahrungsrichtlinien und DSAR-Kontrollen.
• Datengrenze: /docs/security/data-boundary für Verschlüsselung, Mandantenfähigkeit und Isolation.
• TODO-Werkzeug: /docs/tools/todos für Parameter des Agenten-Aufgabenverfolgungswerkzeugs.
• Ledger-Werkzeug: /docs/tools/ledger für Parameter des Finanztransaktionswerkzeugs.