Aktualisieren und deinstallieren

Anyy kann sich selbst aktualisieren, wenn es mit dem nativen residenten Installer installiert wurde. Der Updater prüft Release-Prüfsummen, aktiviert die neue Programmdatei atomar und bewahrt die zuvor aktive Version bei ausreichendem Speicher als Rückkehrziel auf.

Versions- und Datengrenzen

Diese Anweisungen gelten für die veröffentlichte native residente Verzeichnisstruktur. v0.1.107 ist eine stabile Version; alte Entwicklervorschauordner und deren Starter sind kein Installationsweg. Sichern Sie alle zu erhaltenden Daten, bevor Sie eine Entwicklungsstruktur ändern. Kopieren Sie kein leeres Home über vorhandene Daten und nehmen Sie nicht an, dass die Rückkehr zu einer Programmdatei eine Datenbankmigration rückgängig macht.

Auf Aktualisierungen prüfen

Führen Sie zuerst die schreibgeschützte Prüfung aus:

anyy update --check

Sie meldet:

• aktuelle und neueste Version;
• erkannte Installationsquelle;
• ob Selbstaktualisierung unterstützt wird; und
• eine schreibgeschützte Vorabprüfung von Speicherplatz und Release-Struktur für residente Installationen.

Vor Änderungen an einem dauerhaft laufenden Assistenten prüfen

Verwenden Sie --check vor einem geplanten Wartungsfenster. Es stoppt weder Gateway noch ändert es Dateien.

Die Aktualisierung anwenden

Für eine normale residente Installation:

anyy update

Läuft der residente Gateway-Dienst, stoppt Anyy ihn, aktualisiert Version und Dienstdefinition, startet ihn wieder und wartet auf die Bereitschaft der aktualisierten Version. Ein manuell gestartetes Gateway wird gemeldet, aber nicht automatisch in einen Dienst umgewandelt.

Was während einer Aktualisierung passiert

1. Anyy ermittelt das ausgewählte Profil-Home und setzt eine Aktualisierungssperre.
2. Es erkennt Installationsquelle und verfügbare Version.
3. Es prüft temporären Speicher und Platz im Home-Verzeichnis.
4. Es lädt Plattformarchiv und Prüfsummendatei herunter.
5. Es prüft SHA-256 und validiert das Archiv vor dem Entpacken.
6. Es installiert den Kandidaten in einem versionierten Release-Verzeichnis.
7. Es führt die Zustandsprüfung anyy --version des Kandidaten aus.
8. Es schaltet die aktive Version atomar um und merkt das vorherige Ziel vor.
9. Es versetzt den Gateway-Dienst wieder in seinen vorherigen laufenden oder gestoppten Zustand.

Eine abgeschlossene Aktualisierung gibt alte und aktive Version, Rückkehrmöglichkeit, Befehlsstatus und Gateway-Ergebnis aus.

Eine Version auswählen

Installieren Sie eine bestimmte veröffentlichte Version:

anyy update --version v0.1.107

Ersetzen Sie das Beispiel durch eine verfügbare Version. Ohne --version folgt Anyy der neuesten Version, die die konfigurierte Release-Quelle meldet.

Kompakte Aktualisierungen

Bei knappem Speicherplatz:

anyy update --compact

Der Kompaktmodus entfernt zuerst inaktive Versionen und behält die aktive. Das vorherige Rückkehrziel darf er nur entfernen, wenn dies zum Bestehen der Speicherprüfung erforderlich ist.

Der Kompaktmodus kann den Rückkehrverlauf entfernen

Geben Sie nach Möglichkeit manuell Speicher frei. --compact bewahrt Benutzerdaten, kann aber dazu führen, dass keine vorherige Programmdatei zur Rückkehr bleibt.

Was eine Aktualisierung erhält

Der Release-Updater ändert Programmversionen sowie Befehls-/Diensteinstiege. Er entfernt keine Profildaten, einschließlich:

• config.yaml und Zugangsdaten-Dateien;
• state.db, Sitzungen und Erinnerungen;
• Skills und MCP-Konfiguration;
• Workspace-Dateien; und
• Sicherungen, Protokollen und Caches.

Erstellen Sie vor einer riskanten Infrastrukturänderung eine Sicherung, wenn Sie eine unabhängige Wiederherstellungskopie benötigen:

anyy backup create --output /safe/path/anyy-backup.tar.gz

Die verwalteten Verzeichnisse secrets/ und unterstützten mcp/oauth/ sind ausgeschlossen, sofern Sie nicht --include-secrets ergänzen. Konfigurations- und Workspace-Dateien werden weiterhin wie gespeichert erfasst: Direkt darin abgelegte Zugangsdaten können in ein normales Archiv gelangen. Schützen Sie jede Sicherung als private Daten; das Flag garantiert kein geheimnisfreies Archiv.

Andere Installationsquellen

anyy update aktualisiert nur native residente Installationen selbst. Meldet anyy update --check eine andere Quelle, verwenden Sie deren üblichen Aktualisierungsablauf:

Quelle	Aktualisierung mit
Homebrew	brew upgrade ... für die installierte Formel
npm	Paketmanager und Paketname der Installation
Docker	Neues Image abrufen und Container neu erstellen
Quellcode-Checkout	Checkout aktualisieren und nach Projektanweisungen neu bauen

Folgen Sie genau den von anyy update --check ausgegebenen Hinweisen; vermischen Sie keine Paketmanager-Dateien mit der nativen Release-Struktur.

Eigene Release-Spiegel

Betreiber eines kompatiblen vertrauenswürdigen Spiegels können die Release-Basis überschreiben:

anyy update --base-url https://releases.example.com/anyy

Der Spiegel kontrolliert Artefakt und Prüfsumme

--base-url ändert, woher Anyy Version und Prüfsummendatei bezieht. Dies ist keine unabhängige Integritätsinstanz. Verwenden Sie nur eine Quelle, die Sie kontrollieren oder der Sie vertrauen.

Nach der Aktualisierung prüfen

Führen Sie Folgendes aus:

anyy --version
anyy status
anyy doctor

Öffnen Sie dann Dashboard erneut und senden Sie eine kurze Testnachricht:

anyy dashboard

Konnte ein laufender Dienst nicht wiederhergestellt werden, meldet der Updater ein Ergebnis ungleich null. Prüfen Sie es mit anyy gateway status, beheben Sie das gemeldete Problem und starten Sie den Dienst ausdrücklich beziehungsweise neu.

Anyy deinstallieren

Die interaktive Deinstallation fragt nach dem gewünschten Umfang und verlangt eine Bestätigung:

anyy uninstall

Die beiden Modi sind:

Modus	Entfernt	Behält
--keep-data	Programmversionen, Befehlseinstiege und Dienst	Profilkonfiguration und -daten
--full	Programmversionen, Befehlseinstiege, Dienst und alle Anyy-Daten im gewählten Bereich	Nichts in den ausgewählten Anyy-Homes

Wählen Sie für eine nicht interaktive Deinstallation den Umfang ausdrücklich:

anyy uninstall --keep-data --yes
anyy uninstall --full --yes

--yes ohne --keep-data oder --full wird abgelehnt.

Vollständige Deinstallation löscht persönliche Daten

anyy uninstall --full entfernt Anyy-Konfiguration, Zugangsdaten, Sitzungen, Erinnerungen, Skills, Workspace-Dateien und weitere Profildaten im gewählten Bereich. Erstellen und prüfen Sie vorher eine Sicherung, wenn Sie etwas davon benötigen.

Deinstallation wird für die native residente Struktur unterstützt. Paketmanager-, Container- oder Quellcodeinstallationen müssen mit dem System entfernt werden, das sie installiert hat.

Fehlerbehebung

Problem	Lösung
Selbstaktualisierung ist nicht verfügbar	Folgen Sie den Installationsquellenhinweisen von anyy update --check
Eine weitere Installation oder Aktualisierung läuft	Warten Sie, bis der Vorgang mit der Sperre des ausgewählten Homes abgeschlossen ist
Die Vorabprüfung meldet zu wenig Speicher	Geben Sie temporären/Home-Speicher frei; verwenden Sie --compact nur, wenn ein verkürzter Rückkehrverlauf akzeptabel ist
Die Prüfsummenprüfung schlägt fehl	Versuchen Sie es von der vertrauenswürdigen Release-Quelle erneut; umgehen Sie die Prüfung nie
Gateway kommt nicht zurück	Führen Sie anyy gateway status und nach Behebung des gemeldeten Dienstfehlers anyy gateway start oder restart aus
Die Deinstallation lehnt die Installation ab	Prüfen Sie, ob dies eine native residente Installation ist und --home auf ihr tatsächliches Home zeigt