Dokumentationsstand · CLI 7.30.1 · SDK 2.6.53. Desktop verwendet die mit seiner eigenen Version gelieferte Runtime. Befehle und Beispiele bleiben wie im englischen Original. Englische Fassung

Das erste AX Wiki erstellen und nutzen

Vor dem Start

AX Wiki erstellt aus ausgewählten Repository-Quellen Architektur- und Ablaufseiten. Dieses Repository-Wissen ist von der AX-Code-Webdokumentation getrennt. Verbinden Sie einen Anbieter und wählen Sie ein nutzbares Modell. Die Erzeugung sendet ausgewählte Belege an diesen Anbieter und kann Kosten verursachen.

Führen Sie die Befehle im Projektordner aus. Git-Projekte verwenden die nächste Worktree-Wurzel, auch beim Start in einem Unterordner. Prüfen Sie den Checkout und entscheiden Sie, ob erzeugte Dateien versioniert werden sollen.

Vorschau und Erzeugung

Der Plan zeigt ausgewählte Dateien und Seiten ohne Modellaufruf. Prüfen Sie ihn vor der Erzeugung:

ax-code wiki plan

Erzeugen Sie anschließend mit dem konfigurierten Modell, prüfen Sie das Ergebnis und öffnen Sie den lokalen Leser:

ax-code wiki generate
ax-code wiki doctor
ax-code wiki viz --open

Standardausgabe ist .ax-wiki/, Einstiegspunkt ist .ax-wiki/quickstart.md; .ax-wiki/.manifest.json enthält Quellen und Hashes. Die Erzeugung kann den Wiki-Verweisblock in AGENTS.md aktualisieren; mit --skip-agents überspringen Sie diesen Schritt. Prüfen Sie den entstandenen Diff.

Lesen und sinnvoll fragen

Beginnen Sie mit der Schnellstartseite, folgen Sie den zitierten Dateien und fragen Sie nach der Implementierung eines Ablaufs. Der Betrachter zeigt Seiten, Zitate und gespeicherte Beziehungen. Den CLI-Betrachter im Vordergrund stoppen Sie mit Ctrl+C.

Nutzen Sie das Wiki zur Orientierung und prüfen Sie dann aktuellen Code und Tests. Für genaue Symbole, Aufrufer und Referenzen nutzen Sie Code-Intelligenz oder LSP. Eine aktuelle Seite beweist weder Vollständigkeit noch Korrektheit oder Laufzeitleistung.

Aktuell halten

Aktualisieren Sie nach Quelländerungen die betroffenen Seiten und prüfen Sie den Zustand:

ax-code wiki update
ax-code wiki status
ax-code wiki doctor

Der Statusbefehl kann auch bei fehlendem Wiki erfolgreich enden; prüfen Sie gemeldete Existenz und Gesundheit. Veraltete oder fehlerhafte Ausgaben erfordern Untersuchung. Der CLI-Betrachter zeigt einen festen Stand: Öffnen Sie ihn nach Updates neu.

In aktuellen TUI-Versionen öffnet /wiki-viz den Betrachter und fordert Wartung an. Interaktive Wartung bei Leerlauf ist standardmäßig aktiv; Vordergrundarbeit hat Vorrang. Headless-Aufrufe aktivieren diesen Zeitplaner nicht.

Erzeugung steuern

Ergänzen Sie diese optionalen Einstellungen in der Projektdatei ax-code.json. Ersetzen Sie die Modell-ID durch eine verfügbare Verbindungsauswahl. Dieses Beispiel deaktiviert Hintergrundwartung, behält aber explizite Befehle:

{
  "wiki": {
    "enabled": true,
    "auto": false,
    "model": "provider/model"
  }
}

Ein explizites --model provider/model überschreibt das Wiki-Modell für diesen Aufruf. Bei Denkmodellen verlangt die Wiki-Erzeugung erkannte Einstellungen für wenig oder kein Denken; wählen Sie ein anderes unterstütztes Modell, wenn diese Regel die Anfrage ablehnt.

Wartungsnotizen gehören in geschützte Blöcke, damit sie Updates überstehen:

<!-- AX-WIKI:PROTECTED:START project-note -->

Deployment requires maintainer review.

<!-- AX-WIKI:PROTECTED:END -->

Probleme beheben

Kein Modell oder Anmeldefehler: Prüfen Sie Anbieterzugriff und konfiguriertes Wiki-Modell. Ein funktionierendes Chatmodell garantiert nicht, dass ein separates Wiki-Modell nutzbar ist.
Zeitüberschreitung oder abgebrochener Build: Prüfen Sie ax-code wiki doctor und .ax-wiki/.build-report.json und wiederholen Sie nach Behebung der Ursache. Validierte zwischengespeicherte Seiten können wiederverwendet werden; ein Fehler bedeutet nicht, dass alle Seiten veröffentlicht wurden.
Konflikt durch manuelle Änderungen: Bewahren Sie Notizen in geschützten Blöcken und prüfen Sie Änderungen vor dem Wiederholen. --force erlaubt das Ersetzen von Bearbeitungen außerhalb dieser Blöcke; verwenden Sie es bewusst.

Nächste Schritte

Wiki-Konfiguration, CI und Fehlerbehebung · Betrachter und Offline-Export · Modellauswahl · Dokumentationsübersicht