このページは英語版ドキュメントの翻訳です。コマンド、識別子、例はそのままです。ランタイム 7.24.4 · SDK 2.6.7。 英語版

ブラウザで Wiki の証拠を見る

状態: 有効

範囲: 現行状態

最終確認: 2026-10-02

担当: ax-code ランタイム

すでに AX Wiki があるプロジェクトから、このコマンドを実行します。

ax-code wiki viz

コマンドはローカルのブラウザリンクを表示し、フォアグラウンドに留まります。リンクをクリックして、Wiki ページとソースファイルの間に記録された関係を調べてください。システムブラウザを自動で開くには --open を使います。Ctrl+C でローカルビューアを停止します。

見えるもの

線は記録された引用であり、関数呼び出しではありません。この 3 つの図は AX Code 自身の wiki です。同じスナップショットには切り替え可能なレイアウトが 4 つあります。円弧とツリーマップが残りの 2 つで、ここには示していません。

放射状。 各ページの周囲には何があるか。Architecture Overview、Development Workflows、Ax Code Intel モジュールが、引用ファイルの輪の中にあります。相互リンクは中心を通って束ねられます。輪は各ファイルの最初の引用ページから導かれます。距離や枝の長さは符号化しません。

力指向。 誰が何を引用するか。ページ、ファイル、シンボルは接続によって配置されるため、引用されたファイルは、それらを記録するページの隣に集まります。

1 ページを開いた状態。 Ax Code Intel（modules/ax-code-intel.md）を選ぶと、そのページが引用するファイルが点灯します。CLI、サーバー、ハンドラーのソースが含まれます。詳細パネルは鮮度を不明と報告します。スナップショットは現在のソースを読み直さないためです。記録された参照 80 件のうち 39 件を示します。描画されるのは最大 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 は、AX Code、サーバー、外部アセットなしでオフラインに開く、自己完結の HTML ファイルを作ります。既存ファイルの上書きは拒否します。親ディレクトリは存在しなければなりません。--open と --export は組み合わせられません。

ビューアは検索、ページとソースのフィルター、1 ホップ選択、証拠の詳細、ズームとパンの操作に対応します。隣接リストはキーボードで使えます。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 プロジェクトは、パッケージ内で開始されたセッションを含め、正規の worktree ルートを使います。Git 以外のディレクトリは明示的なグラフ要求に対応しますが、起動時には生成しません。既存のローカルのみのランタイム接続ポリシーが適用されます。TUI とランタイムの両方がこれらのエンドポイントに対応している必要があります。TUI を閉じると、そのブラウザブリッジも閉じます。サイドバーは Wiki 保守の状態とページ進捗を表示します。

バックグラウンド保守だけを無効にするには、AX Code の設定で "wiki": { "auto": false } を使います。明示的なグラフ要求は、それでも Wiki を生成できます。生成と Wiki プロンプト注入を無効にするには、enabled を false に設定します。既存のスナップショットは閲覧可能なままです。失敗したジョブはバックオフ付きで自動試行を最大 3 回まで再試行し、そのあとソースや設定の変更、または明示的なグラフ要求を待ちます。

別のプロジェクトに埋め込む

ワークスペースパッケージは、独立した消費者向けにビルドしてパックできます。@ax-code/ax-wiki/graph はブラウザ安全な契約とマニフェスト投影を提供します。@ax-code/ax-wiki-viewer はブラウザ UI を提供します。ビューアをインポートしても、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 ホストは renderWikiGraphHtml を @ax-code/ax-wiki-viewer/node からインポートできます。その結果には html と、一致する csp が含まれます。