Эта страница переведена с английской документации. Команды, идентификаторы и примеры не изменены. Среда выполнения 7.24.4 · SDK 2.6.7. Английский оригинал

Просмотр свидетельств Wiki в браузере

Статус: действует

Область: текущее состояние

Последняя проверка: 2026-10-02

Владелец: среда выполнения ax-code

Запустите эту команду из проекта, где уже есть AX Wiki:

ax-code wiki viz

Команда печатает локальную ссылку для браузера и остаётся на переднем плане. Щёлкните ссылку, чтобы изучить записанные связи между страницами Wiki и их исходными файлами. Используйте --open, чтобы автоматически открыть системный браузер. Нажмите Ctrl+C, чтобы остановить локальный просмотрщик.

Что вы видите

Линии — это записанные цитаты, а не вызовы функций. Эти три рисунка — собственная вики AX Code. У того же снимка четыре переключаемых раскладки. Дуга и treemap — две другие, здесь они не показаны.

Радиальный вид. Три страницы вики стоят внутри кольца файлов, которые они цитируют.

Радиальный. Что окружает каждую страницу? Architecture Overview, Development Workflows и модуль Ax Code Intel стоят внутри кольца цитируемых файлов. Перекрёстные ссылки сходятся через центр. Кольцо выводится из первой цитирующей страницы каждого файла. Оно не кодирует расстояние и длину ветви.

Силовая раскладка. Файлы собираются рядом со страницей, которая их цитирует.

Силовой. Кто что цитирует? Страницы, файлы и символы размещаются по своим связям, поэтому цитируемые файлы собираются рядом со страницей, которая их записывает.

Выбран Ax Code Intel. Цитируемые файлы подсвечены, показано 39 из 80 ссылок.

Одна страница, открытая. Выбор Ax Code Intel (modules/ax-code-intel.md) подсвечивает файлы, которые цитирует эта страница, включая исходники её CLI, сервера и обработчиков. Панель подробностей сообщает свежесть как неизвестную, потому что снимок не перечитывает текущий исходный код, и показывает 39 из 80 записанных ссылок. Рисуется не больше 200 узлов и 500 связей. Счётчики пропущенного остаются видимыми.

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 создаёт самодостаточный файл HTML, который открывается без сети, без AX Code, сервера и внешних ресурсов. Он отказывается перезаписывать существующий файл. Родительский каталог должен существовать. --open и --export нельзя сочетать.

Просмотрщик поддерживает поиск, фильтры страниц и исходников, выбор на один переход, подробности свидетельств и управление масштабом и сдвигом. Соседний список работает с клавиатуры: Tab к пункту и Enter. Escape возвращает фокус к поиску. Сброс восстанавливает обзор. Включается не больше 200 узлов и 500 связей, а пропущенные счётчики показываются. Поиск охватывает включённый снимок, а не пропущенные пункты.

Граф CLI — фиксированный снимок .manifest.json. Он не порождает Wiki, не запускает модель, не переиндексирует код и не обновляется сам. Он показывает записанное членство страницы и исходника, а не вызовы функций и не полный граф зависимостей. Текущее содержимое исходников не читается, поэтому свежесть явно неизвестна. Пути обозначают записанные места и не открывают и не читают исходные файлы.

Локальная ссылка даёт доступ к этому снимку, пока процесс не остановится. Сервер привязывается только к 127.0.0.1 и отдаёт только снимок. Экспортированные файлы содержат заголовки страниц, относительные пути исходников и записанные хеши содержимого. Просмотрите их, прежде чем делиться. Фрагменты исходного кода, абсолютный корень проекта и настройки модели не экспортируются.

Открытие из TUI

В сеансе используйте Граф Wiki рядом с путём проекта внизу правой боковой панели или введите /wiki-viz. То же действие доступно в палитре команд, когда боковая панель скрыта. Оно открывает системный браузер. Если это не удалось, диалог предлагает локальную ссылку для копирования и повтор.

Браузер открывается сразу, в том числе когда Wiki у проекта ещё нет. Он показывает ожидание, ход или сбой генерации и загружает граф страниц и исходников, когда снимок доступен. Открытие графа запрашивает генерацию или пошаговое обновление. Обычная задержка простоя пропускается, но действие ждёт активные сеансы, работу в очереди и непустой черновик TUI. Неудачный запуск браузера предлагает ссылку, которую можно скопировать.

Интерактивный AX Code по умолчанию включает фоновое обслуживание Wiki. После 30 секунд тишины он порождает отсутствующую Wiki или обновляет устаревшие артефакты. Используются настроенная модель Wiki (или модель AX Code по умолчанию), бюджеты исходников и страниц и текущие права агента на чтение и запись. Работа на переднем плане отменяет обслуживание. Незавершённые сборки не публикуют частичные манифесты. Ручные правки и защищённое содержимое сохраняются. Обслуживание не обновляет AGENTS.md и CLAUDE.md. Неинтерактивные команды этот планировщик не включают.

Проекты Git используют канонический корень рабочего дерева, включая сеансы, начатые внутри пакета. Каталоги не-Git поддерживают явный запрос графа, но не порождают его при запуске. Действует существующая политика подключения среды выполнения только локально. И TUI, и среда выполнения должны поддерживать эти конечные точки. Закрытие TUI закрывает его мост браузера. Боковая панель показывает состояние обслуживания Wiki и ход по страницам.

Отключить только фоновое обслуживание можно через "wiki": { "auto": false } в конфигурации AX Code. Явный запрос графа всё ещё может породить Wiki. Задайте enabled равным false, чтобы отключить генерацию и внедрение промпта Wiki. Существующие снимки остаются доступными для просмотра. Неуспешные задания повторяются с нарастающей паузой до трёх автоматических попыток, затем ждут смены исходников или конфигурации либо явного запроса графа.

Встраивание в другой проект

Пакеты рабочей области можно собрать и упаковать для независимого потребителя: @ax-code/ax-wiki/graph даёт контракт, безопасный для браузера, и проекцию манифеста. @ax-code/ax-wiki-viewer даёт интерфейс браузера. Импорт просмотрщика не запускает AX Code и не поднимает сервер.

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

Для snapshot используйте личность содержимого, которую произвёл узел. Смена личности очищает выбор. Недействительные обновления бросают ошибку и сохраняют текущий вид. Освобождение идемпотентно. Используйте { injectStyles: false } и экспортированную строку viewerCss, когда стилями управляет узел. Узлы Node.js могут импортировать renderWikiGraphHtml из @ax-code/ax-wiki-viewer/node. Результат содержит html и соответствующий csp.