Diese Seite ist eine Übersetzung der englischen Dokumentation. Befehle, Bezeichner und Beispiele bleiben unverändert. Runtime 7.24.4 · SDK 2.6.7. Englische Fassung

Wiki-Nachweise im Browser ansehen

Status: Aktiv

Umfang: aktueller Stand

Zuletzt geprüft: 2026-10-02

Verantwortlich: AX-Code-Laufzeit

Führen Sie diesen Befehl aus einem Projekt aus, das bereits ein AX Wiki hat:

ax-code wiki viz

Der Befehl gibt einen lokalen Browserlink aus und bleibt im Vordergrund. Klicken Sie auf den Link, um die aufgezeichneten Beziehungen zwischen Wiki-Seiten und ihren Quelldateien zu erkunden. Verwenden Sie --open, um den Systembrowser automatisch zu starten. Drücken Sie Ctrl+C, um die lokale Ansicht zu beenden.

Was Sie sehen

Die Linien sind aufgezeichnete Zitate, keine Funktionsaufrufe. Diese drei Bilder sind das eigene Wiki von AX Code. Derselbe Schnappschuss hat vier umschaltbare Layouts. Bogen und Treemap sind die beiden anderen und werden hier nicht gezeigt.

Radiale Ansicht. Drei Wiki-Seiten liegen in einem Ring der Dateien, die sie zitieren.

Radial. Was umgibt jede Seite? Architecture Overview, Development Workflows und das Modul Ax Code Intel liegen in einem Ring zitierter Dateien. Querverweise bündeln sich durch die Mitte. Der Ring wird von der ersten zitierenden Seite jeder Datei abgeleitet. Er kodiert weder Abstand noch Zweiglänge.

Kräfte-Layout. Dateien sammeln sich neben der Seite, die sie zitiert.

Kraft. Wer zitiert was? Seiten, Dateien und Symbole werden nach ihren Verbindungen platziert, daher sammeln sich zitierte Dateien neben der Seite, die sie aufzeichnet.

Ax Code Intel ausgewählt. Zitierte Dateien leuchten, und 39 von 80 Verweisen werden gezeigt.

Eine Seite, geöffnet. Die Auswahl von Ax Code Intel (modules/ax-code-intel.md) hebt die Dateien hervor, die diese Seite zitiert, einschließlich der Quellen von CLI, Server und Handler. Das Detailpanel meldet die Aktualität als unbekannt, weil der Schnappschuss den aktuellen Quelltext nicht erneut liest, und zeigt 39 von 80 aufgezeichneten Verweisen. Höchstens 200 Knoten und 500 Beziehungen werden gezeichnet. Weggelassene Zählungen bleiben sichtbar.

ax-code wiki viz --open
ax-code wiki viz --directory /path/to/project --dir .ax-wiki
ax-code wiki viz --export ./wiki-evidence.html

--export erzeugt eine eigenständige HTML-Datei, die offline geöffnet wird, ohne AX Code, ohne Server und ohne externe Assets. Eine vorhandene Datei wird nicht überschrieben. Das übergeordnete Verzeichnis muss existieren. --open und --export lassen sich nicht kombinieren.

Die Ansicht unterstützt Suche, Filter für Seite und Quelle, Auswahl über einen Hop, Nachweisdetails und Steuerungen für Zoom und Verschieben. Die benachbarte Liste funktioniert mit der Tastatur: Mit Tab zu einem Eintrag und Enter drücken. Escape gibt den Fokus an die Suche zurück. Zurücksetzen stellt die Übersicht wieder her. Höchstens 200 Knoten und 500 Beziehungen sind enthalten, mit angezeigten weggelassenen Zählungen. Die Suche deckt den enthaltenen Schnappschuss ab, nicht weggelassene Einträge.

Der CLI-Graph ist ein fester Schnappschuss von .manifest.json. Er erzeugt kein Wiki, führt kein Modell aus, indiziert Code nicht neu und aktualisiert nicht automatisch. Er zeigt aufgezeichnete Zugehörigkeit von Seite zu Quelle, nicht Funktionsaufrufe oder einen vollständigen Abhängigkeitsgraphen. Aktueller Quellinhalt wird nicht gelesen, daher ist die Aktualität ausdrücklich unbekannt. Pfade benennen aufgezeichnete Orte und öffnen oder lesen Quelldateien nicht.

Der lokale Link gewährt Zugriff auf diesen Schnappschuss, bis der Prozess endet. Der Server bindet nur an 127.0.0.1 und liefert nur den Schnappschuss aus. Exportierte Dateien enthalten Seitentitel, relative Quellpfade und aufgezeichnete Inhaltshashes. Prüfen Sie diese, bevor Sie sie teilen. Es werden keine Quellausschnitte, kein absolutes Projektwurzelverzeichnis und keine Modelleinstellungen exportiert.

Aus der TUI öffnen

Verwenden Sie in einer Sitzung Wiki-Graph nahe dem Projektpfad unten in der rechten Seitenleiste oder geben Sie /wiki-viz ein. Dieselbe Aktion ist in der Befehlspalette verfügbar, wenn die Seitenleiste verborgen ist. Die Aktion öffnet den Systembrowser. Wenn das fehlschlägt, bietet ein Dialog den lokalen Link zum Kopieren und eine Wiederholung an.

Der Browser öffnet sofort, auch wenn das Projekt noch kein Wiki hat. Er zeigt Warten, Fortschritt oder Fehlschlag der Erzeugung und lädt den Graphen von Seiten und Quellen, sobald ein Schnappschuss verfügbar ist. Das Öffnen des Graphen fordert eine Erzeugung oder eine inkrementelle Aktualisierung an. Es überspringt die normale Untätigkeitsverzögerung, wartet aber auf aktive Sitzungen, eingereihte Arbeit und einen nicht leeren TUI-Entwurf. Ein fehlgeschlagener Browserstart bietet einen kopierbaren Link.

Interaktives AX Code aktiviert die Hintergrundpflege des Wiki standardmäßig. Nach 30 Sekunden Ruhe erzeugt es ein fehlendes Wiki oder aktualisiert veraltete Artefakte. Es verwendet das konfigurierte Wiki-Modell (oder das Standardmodell von AX Code), Budgets für Quelle und Seiten sowie die aktuellen Lese- und Schreibberechtigungen des Agenten. Vordergrundarbeit bricht die Pflege ab. Unvollständige Builds veröffentlichen keine Teilmanifeste. Manuelle Bearbeitungen und geschützter Inhalt bleiben erhalten. Die Pflege aktualisiert AGENTS.md oder CLAUDE.md nicht. Headless-Befehle aktivieren diesen Planer nicht.

Git-Projekte verwenden das kanonische Worktree-Wurzelverzeichnis, auch bei Sitzungen, die in einem Paket gestartet wurden. Verzeichnisse ohne Git unterstützen eine ausdrückliche Graphanfrage, erzeugen beim Start aber nichts. Die vorhandene Richtlinie für nur lokale Laufzeitverbindungen gilt. Sowohl die TUI als auch die Laufzeit müssen diese Endpunkte unterstützen. Das Schließen der TUI schließt ihre Browserbrücke. Die Seitenleiste zeigt den Pflegezustand des Wiki und den Seitenfortschritt.

Deaktivieren Sie nur die Hintergrundpflege mit "wiki": { "auto": false } in der AX-Code-Konfiguration. Eine ausdrückliche Graphanfrage kann weiterhin ein Wiki erzeugen. Setzen Sie enabled auf false, um Erzeugung und Wiki-Prompt-Einspeisung zu deaktivieren. Vorhandene Schnappschüsse bleiben ansehbar. Fehlgeschlagene Aufträge werden mit Verzögerung bis zu drei automatischen Versuchen wiederholt und warten danach auf eine Änderung von Quelle oder Konfiguration oder auf eine ausdrückliche Graphanfrage.

In ein anderes Projekt einbetten

Die Workspace-Pakete lassen sich für einen unabhängigen Verbraucher bauen und packen: @ax-code/ax-wiki/graph liefert den browsersicheren Vertrag und die Manifestprojektion. @ax-code/ax-wiki-viewer liefert die Browseroberfläche. Das Importieren der Ansicht startet weder AX Code noch einen Server.

import { projectWikiManifest } from "@ax-code/ax-wiki/graph"
import { mount } from "@ax-code/ax-wiki-viewer"

const graph = projectWikiManifest(manifest, { snapshot: contentIdentity })
const viewer = mount(document.getElementById("map")!, graph)
viewer.update(nextGraph)
viewer.dispose()

Verwenden Sie eine vom Host erzeugte Inhaltsidentität für snapshot. Eine geänderte Identität löscht die Auswahl. Ungültige Aktualisierungen werfen und bewahren die vorhandene Ansicht. Das Freigeben ist idempotent. Verwenden Sie { injectStyles: false } und die exportierte Zeichenkette viewerCss, wenn der Host Stile verwaltet. Node-Hosts können renderWikiGraphHtml aus @ax-code/ax-wiki-viewer/node importieren. Sein Ergebnis enthält html und das passende csp.