Esta página é uma tradução da documentação em inglês. Comandos, identificadores e exemplos permanecem iguais. Runtime 7.24.4 · SDK 2.6.7. Original em inglês

Ver evidências da Wiki no navegador

Status: Ativo

Escopo: estado atual

Última revisão: 2026-10-02

Responsável: runtime do ax-code

Execute este comando a partir de um projeto que já tenha uma AX Wiki:

ax-code wiki viz

O comando imprime um link local de navegador e permanece em primeiro plano. Clique no link para explorar as relações registradas entre as páginas da Wiki e os arquivos-fonte delas. Use --open para abrir o navegador do sistema automaticamente. Pressione Ctrl+C para parar o visualizador local.

O que você vê

As linhas são citações registradas, não chamadas de função. Estas três imagens são a wiki do próprio AX Code. O mesmo instantâneo tem quatro layouts alternáveis; arco e treemap são os outros dois e não aparecem aqui.

Visão radial. Três páginas da wiki ficam dentro de um anel dos arquivos que elas citam.

Radial. O que cerca cada página? Visão geral da arquitetura, Fluxos de desenvolvimento e o módulo Ax Code Intel ficam dentro de um anel de arquivos citados. Os vínculos cruzados se agrupam pelo centro. O anel deriva da primeira página que cita cada arquivo. Ele não representa distância nem comprimento de ramo.

Layout de força. Os arquivos se agrupam ao lado da página que os cita.

Força. Quem cita o quê? Páginas, arquivos e símbolos são posicionados pelas conexões, então os arquivos citados se reúnem ao lado da página que os registra.

Ax Code Intel selecionado. Os arquivos citados estão iluminados, e 39 de 80 referências aparecem.

Uma página, aberta. Selecionar Ax Code Intel (modules/ax-code-intel.md) ilumina os arquivos que essa página cita, inclusive as fontes da CLI, do servidor e dos tratadores. O painel de detalhes informa a atualidade como desconhecida, porque o instantâneo não relê o código-fonte atual, e mostra 39 de 80 referências registradas. No máximo 200 nós e 500 relacionamentos são desenhados. As contagens omitidas continuam visíveis.

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 cria um arquivo HTML autônomo que abre offline, sem o AX Code, sem servidor e sem ativos externos. Ele recusa sobrescrever um arquivo existente. O diretório pai precisa existir. --open e --export não podem ser combinados.

O visualizador oferece busca, filtros de página e de fonte, seleção de um salto, detalhes de evidência e controles de zoom e de deslocamento. A lista ao lado funciona pelo teclado: use Tab até um item e pressione Enter; Escape devolve o foco à busca. Redefinir restaura a visão geral. No máximo 200 nós e 500 relacionamentos são incluídos, com as contagens omitidas exibidas. A busca cobre o instantâneo incluído, não os itens omitidos.

O grafo da CLI é um instantâneo fixo de .manifest.json. Ele não gera uma Wiki, não executa um modelo, não reindexa o código e não se atualiza sozinho. Mostra a associação registrada de página para fonte, não chamadas de função nem um grafo completo de dependências. O conteúdo atual do código-fonte não é lido, então a atualidade é explicitamente desconhecida. Os caminhos identificam locais registrados e não abrem nem leem arquivos-fonte.

O link local concede acesso a esse instantâneo até o processo parar. O servidor escuta apenas em 127.0.0.1 e serve apenas o instantâneo. Os arquivos exportados contêm títulos de página, caminhos relativos de fonte e hashes de conteúdo registrados; revise isso antes de compartilhar. Não são exportados trechos de código-fonte, a raiz absoluta do projeto nem configurações de modelo.

Abrir pela TUI

Em uma sessão, use Grafo da Wiki perto do caminho do projeto, na base da barra lateral direita, ou digite /wiki-viz. A mesma ação está na paleta de comandos quando a barra lateral está oculta. Ela abre o navegador do sistema; se isso falhar, um diálogo oferece o link local para copiar e uma ação para tentar de novo.

O navegador abre na hora, inclusive quando o projeto ainda não tem Wiki. Ele mostra espera, o progresso ou a falha da geração e carrega o grafo de páginas e fontes quando há um instantâneo. Abrir o grafo pede geração ou atualização incremental; ele pula o atraso normal de ociosidade, mas espera sessões ativas, trabalho enfileirado e um rascunho não vazio da TUI. Se o navegador não abrir, um link que pode ser copiado é oferecido.

O AX Code interativo ativa, por padrão, a manutenção da Wiki em segundo plano. Depois de 30 segundos de silêncio, ele gera uma Wiki ausente ou atualiza artefatos desatualizados. Usa o modelo configurado da Wiki (ou o modelo padrão do AX Code), os orçamentos de fonte e de página e as permissões atuais de leitura e de escrita do agente. Trabalho em primeiro plano cancela a manutenção; compilações incompletas não publicam manifestos parciais. Edições manuais e conteúdo protegido são preservados. A manutenção não atualiza AGENTS.md nem CLAUDE.md. Comandos sem interface não ativam este agendador.

Projetos Git usam a raiz canônica da worktree, inclusive sessões iniciadas dentro de um pacote. Diretórios que não são Git aceitam um pedido explícito de grafo, mas não geram na inicialização. Vale a política já existente de conexão do runtime apenas local. Tanto a TUI quanto o runtime precisam suportar estes endpoints. Fechar a TUI fecha a ponte de navegador dela. A barra lateral mostra o estado da manutenção da Wiki e o progresso das páginas.

Desative apenas a manutenção em segundo plano com "wiki": { "auto": false } na configuração do AX Code; um pedido explícito de grafo ainda pode gerar uma Wiki. Defina enabled como false para desativar a geração e a injeção de prompt da Wiki. Instantâneos existentes continuam visíveis. Trabalhos com falha tentam de novo, com espera crescente, até três tentativas automáticas e, em seguida, aguardam uma mudança de código-fonte ou de configuração, ou um pedido explícito de grafo.

Incorporar em outro projeto

Os pacotes do workspace podem ser compilados e empacotados para um consumidor independente: @ax-code/ax-wiki/graph fornece o contrato seguro para o navegador e a projeção do manifesto; @ax-code/ax-wiki-viewer fornece a interface do navegador. Importar o visualizador não inicia o AX Code nem um servidor.

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()

Use uma identidade de conteúdo produzida pelo host em snapshot. Uma identidade alterada limpa a seleção. Atualizações inválidas lançam erro e preservam a visão existente; descartar é idempotente. Use { injectStyles: false } e o texto exportado viewerCss quando o host administra os estilos. Hosts Node.js podem importar renderWikiGraphHtml de @ax-code/ax-wiki-viewer/node; o resultado contém html e o csp correspondente.