Schnellstart

Installieren Sie Spirit Agent, verbinden Sie einen Anbieter und landen Sie eine kleine genehmigte Änderung.

Diese Seite führt Sie von einer frischen Installation zu einer nützlichen Änderung. Spätere Seiten behandeln jeden Anbieter und Host; ohne diesen Pfad haben diese Seiten nichts, woran sie anknüpfen können.

1. Installieren Sie Desktop oder die CLI

Wählen Sie einen Host. Sie teilen sich denselben lokalen Daemon, sodass Sie den anderen später hinzufügen können.

Laden Sie den Build für Ihre Plattform von der Download-Seite herunter und öffnen Sie ihn.

macOS: .dmg (Intel oder Apple Silicon)
Windows: .exe-Installer (x64 oder ARM64)
Linux: .AppImage (x64 oder ARM64)

Details: Desktop installieren.

2. Öffnen Sie einen Workspace

Der Agent liest und bearbeitet Dateien in einem Workspace-Root. Öffnen Sie das Projekt, das Sie ändern möchten.

Verwenden Sie Workspace-Ordner öffnen in der Seitenleiste und wählen Sie einen Ordner. Zuletzt verwendete Workspaces bleiben in der Liste.

3. Verbinden Sie einen Anbieter

Sie benötigen einen API-Schlüssel von einem Anbieter, den Sie bereits verwenden. Spirit speichert diesen Schlüssel im Betriebssystem-Keyring (SpiritAgent).

Öffnen Sie Einstellungen → Modelle.
Wählen Sie einen Anbieter und folgen Sie dem Verbindungsassistenten.
Fügen Sie den Schlüssel ein. Zusätzliche Felder (Region, Standort, Plan-Endpunkt) erscheinen nur, wenn der Anbieter sie benötigt.
Wählen Sie ein Chat-Modell als aktives Modell.

4. Bitten Sie um eine kleine Änderung und genehmigen Sie sie

Bleiben Sie im Agent-Modus und bei Standard-Genehmigung für den ersten Lauf. Bitten Sie den Agenten, eine Ihnen bekannte Datei zu lesen und dann eine kleine, offensichtliche Änderung vorzunehmen.

Beispiel:

Read README.md and add a one-line project summary at the top. Do not change anything else.

Der Agent liest die Datei, schlägt eine Änderung vor und wartet. Genehmigen Sie die Dateiänderung (und jeden Shell-Befehl) in der Eingabeaufforderung. Nachdem er fertig ist, öffnen Sie die Datei und bestätigen Sie die Änderung.

Das ist der gesamte Kreislauf: installieren → Workspace → ein Anbieter → lesen → bearbeiten → genehmigen. Alles andere in diesen Dokumenten hängt von diesem Pfad ab.

Weiter

Desktop installieren und CLI installieren, falls Sie einen anderen Host oder eine festgelegte Version benötigen
Anbieter, um ein anderes Haus zu verbinden oder Site-/Plan-/Cloud-Felder zu überprüfen, wenn Modelle nicht importiert wurden