Cette page est traduite de la documentation anglaise. Les commandes, identifiants et exemples sont inchangés. Runtime 7.24.4 · SDK 2.6.7. Source anglaise

Voir les preuves du wiki dans un navigateur

Statut : Actif

Portée : état actuel

Dernière revue : 2026-10-02

Responsable : runtime ax-code

Exécutez cette commande depuis un projet qui a déjà un AX Wiki :

ax-code wiki viz

La commande affiche un lien de navigateur local et reste au premier plan. Cliquez sur le lien pour explorer les relations enregistrées entre les pages Wiki et leurs fichiers source. Utilisez --open pour lancer automatiquement le navigateur du système. Appuyez sur Ctrl+C pour arrêter le visualiseur local.

Ce que vous voyez

Les lignes sont des citations enregistrées, pas des appels de fonction. Ces trois images sont le wiki propre d’AX Code. Le même instantané a quatre dispositions commutables ; l’arc et la carte arborescente sont les deux autres et ne sont pas montrés ici.

Vue radiale. Trois pages de wiki se trouvent dans un anneau des fichiers qu’elles citent.

Radial. Qu’est-ce qui entoure chaque page ? La vue d’ensemble de l’architecture, les flux de travail de développement et le module Ax Code Intel se trouvent dans un anneau de fichiers cités. Les liens croisés se regroupent par le centre. L’anneau est dérivé de la première page qui cite chaque fichier. Il n’encode ni la distance ni la longueur de branche.

Disposition par force. Les fichiers se regroupent à côté de la page qui les cite.

Force. Qui cite quoi ? Les pages, les fichiers et les symboles sont placés selon leurs connexions, donc les fichiers cités se rassemblent à côté de la page qui les enregistre.

Ax Code Intel sélectionné. Les fichiers cités sont allumés, et 39 des 80 références sont affichées.

Une page, ouverte. Sélectionner Ax Code Intel (modules/ax-code-intel.md) allume les fichiers que cette page cite, y compris ses sources CLI, serveur et gestionnaires. Le panneau de détail signale la fraîcheur comme inconnue, parce que l’instantané ne relit pas la source actuelle, et montre 39 des 80 références enregistrées. Au plus 200 nœuds et 500 relations sont dessinés. Les comptes omis restent 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 crée un fichier HTML autonome qui s’ouvre hors ligne, sans AX Code, sans serveur et sans ressources externes. Il refuse d’écraser un fichier existant. Son répertoire parent doit exister. --open et --export ne peuvent pas être combinés.

Le visualiseur prend en charge la recherche, les filtres de page et de source, la sélection à un saut, les détails de preuves, et les contrôles de zoom et de panoramique. La liste adjacente fonctionne au clavier : Tab vers un élément puis Enter ; Échap rend le focus à la recherche. Réinitialiser rétablit la vue d’ensemble. Au plus 200 nœuds et 500 relations sont inclus, avec les comptes omis affichés. La recherche couvre l’instantané inclus, pas les éléments omis.

Le graphe CLI est un instantané fixe de .manifest.json. Il ne génère pas de Wiki, n’exécute pas de modèle, ne réindexe pas le code et ne se rafraîchit pas automatiquement. Il montre l’appartenance enregistrée des pages aux sources, pas des appels de fonction ni un graphe de dépendances complet. Les contenus de source actuels ne sont pas lus, donc la fraîcheur est explicitement inconnue. Les chemins identifient des emplacements enregistrés et n’ouvrent ni ne lisent les fichiers source.

Le lien local accorde l’accès à cet instantané jusqu’à l’arrêt du processus. Le serveur ne se lie qu’à 127.0.0.1 et ne sert que l’instantané. Les fichiers exportés contiennent les titres de pages, les chemins source relatifs et les hachages de contenu enregistrés ; revoyez-les avant de les partager. Aucun extrait de source, aucune racine de projet absolue ni aucun réglage de modèle n’est exporté.

Ouvrir depuis le TUI

Dans une session, utilisez Graphe Wiki près du chemin de projet en bas de la barre latérale droite, ou saisissez /wiki-viz. La même action est disponible dans la palette de commandes lorsque la barre latérale est masquée. Elle ouvre le navigateur du système ; si cela échoue, une boîte de dialogue propose le lien local à copier et une action de nouvel essai.

Le navigateur s’ouvre immédiatement, y compris lorsque le projet n’a pas encore de Wiki. Il montre l’attente, la progression ou l’échec de génération, et charge le graphe pages/sources lorsqu’un instantané est disponible. Ouvrir le graphe demande une génération ou une mise à jour incrémentale ; cela saute le délai d’inactivité normal, mais attend les sessions actives, le travail en file et un brouillon TUI non vide. Un lancement de navigateur échoué propose un lien copiable.

AX Code interactif active par défaut la maintenance Wiki en arrière-plan. Après 30 secondes de calme, il génère un Wiki manquant ou met à jour les artefacts périmés. Il utilise le modèle Wiki configuré (ou le modèle par défaut d’AX Code), les budgets de source et de pages, et les permissions de lecture et d’écriture de l’agent courant. Le travail au premier plan annule la maintenance ; les constructions incomplètes ne publient pas de manifestes partiels. Les modifications manuelles et le contenu protégé sont préservés. La maintenance ne met pas à jour AGENTS.md ni CLAUDE.md. Les commandes sans interface n’activent pas cet ordonnanceur.

Les projets Git utilisent la racine canonique du worktree, y compris les sessions démarrées dans un paquet. Les répertoires hors Git prennent en charge une demande de graphe explicite, mais ne génèrent pas au démarrage. La politique de connexion de runtime local seulement existante s’applique. Le TUI et le runtime doivent tous deux prendre en charge ces points de terminaison. Fermer le TUI ferme son pont navigateur. La barre latérale affiche l’état de maintenance Wiki et la progression des pages.

Désactivez seulement la maintenance en arrière-plan avec "wiki": { "auto": false } dans la configuration AX Code ; une demande de graphe explicite peut encore générer un Wiki. Réglez enabled sur false pour désactiver la génération et l’injection du Wiki dans l’invite. Les instantanés existants restent visibles. Les tâches échouées réessaient avec une temporisation croissante, jusqu’à trois tentatives automatiques, puis attendent un changement de source ou de configuration, ou une demande de graphe explicite.

Intégrer dans un autre projet

Les paquets de l’espace de travail peuvent être construits et empaquetés pour un consommateur indépendant : @ax-code/ax-wiki/graph fournit le contrat sûr pour le navigateur et la projection du manifeste ; @ax-code/ax-wiki-viewer fournit l’interface du navigateur. Importer le visualiseur ne démarre ni AX Code ni un serveur.

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

Utilisez une identité de contenu produite par l’hôte pour snapshot. Une identité changée efface la sélection. Les mises à jour invalides lèvent une erreur et préservent la vue existante ; la destruction est idempotente. Utilisez { injectStyles: false } et la chaîne exportée viewerCss lorsque l’hôte gère les styles. Les hôtes Node peuvent importer renderWikiGraphHtml depuis @ax-code/ax-wiki-viewer/node ; son résultat contient html et le csp correspondant.