Questa pagina è tradotta dalla documentazione inglese. Comandi, identificatori ed esempi restano invariati. Runtime 7.24.4 · SDK 2.6.7. Testo inglese

Visualizza le prove Wiki in un browser

Stato: attivo

Ambito: stato attuale

Ultima revisione: 2026-10-02

Responsabile: runtime di ax-code

Esegui questo comando da un progetto che ha già un AX Wiki:

ax-code wiki viz

Il comando stampa un collegamento browser locale e resta in primo piano. Fai clic sul collegamento per esplorare le relazioni registrate tra le pagine Wiki e i loro file sorgente. Usa --open per avviare automaticamente il browser di sistema. Premi Ctrl+C per arrestare il visualizzatore locale.

Che cosa vedi

Le linee sono citazioni registrate, non chiamate di funzione. Queste tre immagini sono la wiki di AX Code stesso. La stessa istantanea ha quattro layout commutabili; arco e treemap sono gli altri due e non sono mostrati qui.

Vista radiale. Tre pagine wiki stanno dentro un anello dei file che citano.

Radiale. Che cosa circonda ogni pagina? Architecture Overview, Development Workflows e il modulo Ax Code Intel stanno dentro un anello di file citati. I collegamenti incrociati si raggruppano attraverso il centro. L’anello deriva dalla prima pagina che cita ciascun file. Non codifica distanza né lunghezza di ramo.

Layout a forza. I file si raggruppano accanto alla pagina che li cita.

Forza. Chi cita che cosa? Pagine, file e simboli sono disposti secondo le loro connessioni, così i file citati si raccolgono accanto alla pagina che li registra.

Ax Code Intel selezionato. I file citati sono illuminati e sono mostrati 39 riferimenti su 80.

Una pagina, aperta. Selezionare Ax Code Intel (modules/ax-code-intel.md) illumina i file che quella pagina cita, inclusi i sorgenti di CLI, server e handler. Il pannello di dettaglio riporta la freschezza come sconosciuta, perché l’istantanea non rilegge il sorgente corrente, e mostra 39 riferimenti registrati su 80. Vengono disegnati al massimo 200 nodi e 500 relazioni. I conteggi omessi restano visibili.

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 crea un file HTML autonomo che si apre offline, senza AX Code, un server o asset esterni. Rifiuta di sovrascrivere un file esistente. La directory genitore deve esistere. --open e --export non possono essere combinati.

Il visualizzatore supporta ricerca, filtri pagina/sorgente, selezione a un salto, dettagli delle prove e controlli di zoom e panoramica. L’elenco adiacente funziona con la tastiera: Tab su un elemento e premi Invio; Esc riporta il focus alla ricerca. Ripristina torna alla panoramica. Sono inclusi al massimo 200 nodi e 500 relazioni, con i conteggi omessi visualizzati. La ricerca copre l’istantanea inclusa, non gli elementi omessi.

Il grafo della CLI è un’istantanea fissa di .manifest.json. Non genera una Wiki, non esegue un modello, non reindicizza il codice e non si aggiorna automaticamente. Mostra l’appartenenza registrata da pagina a sorgente, non chiamate di funzione né un grafo completo delle dipendenze. I contenuti del sorgente corrente non vengono letti, quindi la freschezza è esplicitamente sconosciuta. I percorsi identificano posizioni registrate e non aprono né leggono file sorgente.

Il collegamento locale concede l’accesso a quell’istantanea finché il processo non si arresta. Il server si lega solo a 127.0.0.1 e serve solo l’istantanea. I file esportati contengono titoli di pagina, percorsi sorgente relativi e hash di contenuto registrati; rivedili prima di condividerli. Non vengono esportati frammenti di sorgente, la radice assoluta del progetto né le impostazioni del modello.

Apri dalla TUI

In una sessione, usa Grafo Wiki vicino al percorso del progetto in fondo alla barra laterale destra, oppure inserisci /wiki-viz. La stessa azione è disponibile nella tavolozza dei comandi quando la barra laterale è nascosta. Apre il browser di sistema; se fallisce, una finestra offre il collegamento locale da copiare e un’azione di nuovo tentativo.

Il browser si apre subito, anche quando il progetto non ha ancora una Wiki. Mostra attesa, progresso o fallimento della generazione e carica il grafo pagina/sorgente quando un’istantanea è disponibile. Aprire il grafo richiede la generazione o un aggiornamento incrementale; salta il ritardo di inattività normale ma attende le sessioni attive, il lavoro in coda e una bozza TUI non vuota. Un avvio del browser fallito offre un collegamento copiabile.

AX Code interattivo abilita per impostazione predefinita la manutenzione Wiki in background. Dopo 30 secondi di quiete, genera una Wiki mancante o aggiorna gli artefatti non aggiornati. Usa il modello Wiki configurato (o il modello predefinito di AX Code), i budget di sorgente e pagina e i permessi correnti di lettura e scrittura dell’agente. Il lavoro in primo piano annulla la manutenzione; le build incomplete non pubblicano manifesti parziali. Le modifiche manuali e il contenuto protetto vengono conservati. La manutenzione non aggiorna AGENTS.md né CLAUDE.md. I comandi headless non abilitano questo pianificatore.

I progetti Git usano la radice canonica del worktree, incluse le sessioni avviate dentro un pacchetto. Le directory non Git supportano una richiesta esplicita di grafo ma non generano all’avvio. Si applica la policy esistente di connessione del runtime solo locale. Sia la TUI sia il runtime devono supportare questi endpoint. Chiudere la TUI chiude il suo ponte browser. La barra laterale mostra lo stato di manutenzione Wiki e il progresso delle pagine.

Disabilita solo la manutenzione in background con "wiki": { "auto": false } nella configurazione di AX Code; una richiesta esplicita di grafo può ancora generare una Wiki. Imposta enabled su false per disabilitare la generazione e l’iniezione del prompt Wiki. Le istantanee esistenti restano visualizzabili. I job falliti ritentano con backoff fino a tre tentativi automatici, poi attendono un cambiamento di sorgente o configurazione oppure una richiesta esplicita di grafo.

Incorpora in un altro progetto

I pacchetti dello workspace possono essere compilati e impacchettati per un consumatore indipendente: @ax-code/ax-wiki/graph fornisce il contratto sicuro per il browser e la proiezione del manifesto; @ax-code/ax-wiki-viewer fornisce l’interfaccia del browser. Importare il visualizzatore non avvia AX Code né un 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()

Usa un’identità di contenuto prodotta dall’host per snapshot. Un’identità cambiata cancella la selezione. Gli aggiornamenti non validi sollevano un’eccezione e conservano la vista esistente; il dispose è idempotente. Usa { injectStyles: false } e la stringa esportata viewerCss quando l’host gestisce gli stili. Gli host Node.js possono importare renderWikiGraphHtml da @ax-code/ax-wiki-viewer/node; il suo risultato contiene html e il csp corrispondente.