Esta página es una traducción de la documentación en inglés. Los comandos, identificadores y ejemplos no cambian. Runtime 7.24.4 · SDK 2.6.7. Original en inglés

Ver la evidencia de la wiki en un navegador

Estado: Activo

Alcance: estado actual

Última revisión: 2026-10-02

Responsable: entorno de ejecución de ax-code

Ejecuta este comando desde un proyecto que ya tenga una AX Wiki:

ax-code wiki viz

El comando imprime un enlace local de navegador y permanece en primer plano. Haz clic en el enlace para explorar las relaciones registradas entre las páginas de la wiki y sus archivos fuente. Usa --open para abrir el navegador del sistema de forma automática. Pulsa Ctrl+C para detener el visor local.

Qué ves

Las líneas son citas registradas, no llamadas a funciones. Estas tres imágenes son la propia wiki de AX Code. La misma instantánea tiene cuatro diseños intercambiables; el arco y el mapa de árbol son los otros dos y no se muestran aquí.

Radial. ¿Qué rodea a cada página? Architecture Overview, Development Workflows y el módulo Ax Code Intel están dentro de un anillo de archivos citados. Los enlaces cruzados se agrupan por el centro. El anillo se deriva de la primera página que cita cada archivo. No codifica distancia ni longitud de rama.

Fuerza. ¿Quién cita qué? Las páginas, los archivos y los símbolos se colocan según sus conexiones, así que los archivos citados se reúnen junto a la página que los registra.

Una página, abierta. Al seleccionar Ax Code Intel (modules/ax-code-intel.md) se iluminan los archivos que cita esa página, incluidos sus fuentes de CLI, servidor y manejador. El panel de detalle informa la frescura como desconocida, porque la instantánea no vuelve a leer el código fuente actual, y muestra 39 de 80 referencias registradas. Como máximo se dibujan 200 nodos y 500 relaciones. Los recuentos omitidos siguen visibles.

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 archivo HTML autónomo que se abre sin conexión, sin AX Code, sin servidor y sin activos externos. Se niega a sobrescribir un archivo existente. Su directorio padre debe existir. --open y --export no se pueden combinar.

El visor admite búsqueda, filtros de página y fuente, selección de un salto, detalles de evidencia y controles de zoom y desplazamiento. La lista adyacente funciona con el teclado: Tab hasta un elemento y pulsa Intro; Escape devuelve el foco a la búsqueda. Restablecer recupera la vista general. Se incluyen como máximo 200 nodos y 500 relaciones, con los recuentos omitidos visibles. La búsqueda cubre la instantánea incluida, no los elementos omitidos.

El grafo de la CLI es una instantánea fija de .manifest.json. No genera una wiki, no ejecuta un modelo, no reindexa el código ni se actualiza de forma automática. Muestra la pertenencia registrada de página a fuente, no llamadas a funciones ni un grafo de dependencias completo. No se lee el contenido actual del código fuente, así que la frescura es explícitamente desconocida. Las rutas identifican ubicaciones registradas y no abren ni leen archivos fuente.

El enlace local concede acceso a esa instantánea hasta que el proceso se detiene. El servidor se vincula solo a 127.0.0.1 y sirve solo la instantánea. Los archivos exportados contienen títulos de página, rutas de origen relativas y hashes de contenido registrados; revísalos antes de compartirlos. No se exportan fragmentos de código fuente, la raíz absoluta del proyecto ni ajustes del modelo.

Abrir desde la TUI

En una sesión, usa Grafo de la wiki junto a la ruta del proyecto, en la parte inferior de la barra lateral derecha, o introduce /wiki-viz. La misma acción está disponible en la paleta de comandos cuando la barra lateral está oculta. Abre el navegador del sistema; si eso falla, un diálogo ofrece el enlace local para copiarlo y una acción de reintento.

El navegador se abre de inmediato, incluso cuando el proyecto aún no tiene wiki. Muestra la espera, el progreso o el fallo de la generación, y carga el grafo de páginas y fuentes cuando hay una instantánea disponible. Abrir el grafo solicita la generación o una actualización incremental; omite el retraso normal de inactividad, pero espera a las sesiones activas, al trabajo en cola y a un borrador no vacío de la TUI. Un lanzamiento fallido del navegador ofrece un enlace copiable.

AX Code interactivo activa de forma predeterminada el mantenimiento de la wiki en segundo plano. Tras 30 segundos de quietud, genera una wiki ausente o actualiza artefactos obsoletos. Usa el modelo de wiki configurado (o el modelo predeterminado de AX Code), los presupuestos de fuente y de página, y los permisos actuales de lectura y escritura del agente. El trabajo en primer plano cancela el mantenimiento; las compilaciones incompletas no publican manifiestos parciales. Se conservan las ediciones manuales y el contenido protegido. El mantenimiento no actualiza AGENTS.md ni CLAUDE.md. Los comandos headless no activan este planificador.

Los proyectos Git usan la raíz canónica del worktree, incluidas las sesiones iniciadas dentro de un paquete. Los directorios que no son Git admiten una solicitud explícita de grafo, pero no generan al arrancar. Se aplica la política existente de conexión del entorno de ejecución solo local. Tanto la TUI como el entorno de ejecución deben admitir estos endpoints. Cerrar la TUI cierra su puente de navegador. La barra lateral muestra el estado de mantenimiento de la wiki y el progreso de las páginas.

Desactiva solo el mantenimiento en segundo plano con "wiki": { "auto": false } en la configuración de AX Code; una solicitud explícita de grafo aún puede generar una wiki. Establece enabled en false para desactivar la generación y la inyección de prompts de la wiki. Las instantáneas existentes siguen siendo visibles. Los trabajos fallidos se reintentan con espera creciente hasta tres intentos automáticos y luego esperan un cambio de código fuente o de configuración, o una solicitud explícita de grafo.

Incrustar en otro proyecto

Los paquetes del espacio de trabajo se pueden compilar y empaquetar para un consumidor independiente: @ax-code/ax-wiki/graph aporta el contrato seguro para el navegador y la proyección del manifiesto; @ax-code/ax-wiki-viewer aporta la interfaz del navegador. Importar el visor no inicia AX Code ni un 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()

Usa una identidad de contenido producida por el host para snapshot. Una identidad cambiada borra la selección. Las actualizaciones no válidas lanzan un error y conservan la vista existente; desechar es idempotente. Usa { injectStyles: false } y la cadena exportada viewerCss cuando el host gestiona los estilos. Los hosts de Node pueden importar renderWikiGraphHtml desde @ax-code/ax-wiki-viewer/node; su resultado contiene html y el csp correspondiente.