本頁譯自英文文件。指令、識別名稱與範例保持原樣。執行環境 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 自己的 wiki。同一份快照有四種可切換的版面；另外兩種是弧線與矩形樹狀圖，這裡沒有顯示。

放射狀檢視。三個 wiki 頁面位於它們所引用之檔案圍成的環內。

放射狀。 每個頁面周圍是什麼？Architecture Overview、Development Workflows，以及 Ax Code Intel 模組，位於被引用檔案所圍成的環內。交叉連結在中心匯集。這個環來自每個檔案第一個引用它的頁面。它不表示距離，也不表示分支長度。

力導向版面。檔案聚集在引用它們的頁面旁邊。

力導向。 誰引用了什麼？頁面、檔案與符號依連線放置，因此被引用的檔案會聚集在記錄它們的頁面旁邊。

已選取 Ax Code Intel。被引用的檔案會亮起，並顯示 80 筆參照中的 39 筆。

開啟單一頁面。 選取 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 會建立自包含的 HTML 檔，可離線開啟，不需要 AX Code、伺服器或外部資產。它拒絕覆寫既有檔案。上層目錄必須存在。--open 與 --export 不能同時使用。

檢視器支援搜尋、頁面與原始碼篩選、一跳選取、證據細節，以及縮放與平移控制。旁邊的清單可以用鍵盤操作：用 Tab 移到項目再按 Enter；Escape 會把焦點回到搜尋。重設會恢復總覽。最多包含 200 個節點與 500 個關係，並顯示被省略的數量。搜尋涵蓋已包含的快照，不包含被省略的項目。

CLI 圖是 .manifest.json 的固定快照。它不會產生 Wiki、不會執行模型、不會重新索引程式碼，也不會自動重新整理。它顯示的是已記錄的頁面與原始碼從屬關係，不是函式呼叫，也不是完整的相依圖。目前的原始碼內容不會被讀取，因此新鮮度明確標為未知。路徑用來識別已記錄的位置，不會開啟或讀取原始碼檔案。

本機連結在處理程序停止之前，授予該快照的存取。伺服器只繫結到 127.0.0.1，而且只提供這份快照。匯出的檔案包含頁面標題、相對的原始碼路徑，以及已記錄的內容雜湊；分享之前請先審閱。不會匯出原始碼片段、絕對的專案根目錄或模型設定。

從 TUI 開啟

在工作階段中，使用右側邊欄底部、專案路徑附近的 Wiki graph，或輸入 /wiki-viz。側邊欄隱藏時，命令選擇盤也有相同動作。它會開啟系統瀏覽器；若失敗，對話框會提供可複製的本機連結，以及重試動作。

瀏覽器會立刻開啟，即使專案還沒有 Wiki 也一樣。它會顯示等待、產生進度或失敗；有快照時就載入頁面與原始碼圖。開啟圖會要求產生或增量更新；它會略過一般的閒置延遲，但仍會等待作用中的工作階段、已排入佇列的工作，以及非空白的 TUI 草稿。瀏覽器啟動失敗時，會提供可複製的連結。

互動式的 AX Code 預設啟用背景 Wiki 維護。安靜 30 秒之後，它會產生缺少的 Wiki，或更新過期的成品。它使用已設定的 Wiki 模型（或 AX Code 的預設模型）、原始碼與頁面預算，以及目前代理程式的讀寫權限。前景工作會取消維護；未完成的建置不會發布部分資訊清單。手動編輯與受保護的內容會被保留。維護不會更新 AGENTS.md 或 CLAUDE.md。無介面指令不會啟用這個排程器。

Git 專案使用標準工作樹根目錄，包含在套件內啟動的工作階段。非 Git 目錄支援明確的圖請求，但不會在啟動時產生。既有的僅限本機之執行環境連線原則仍然適用。TUI 與執行環境都必須支援這些端點。關閉 TUI 會關閉它的瀏覽器橋接。側邊欄會顯示 Wiki 維護狀態與頁面進度。

若只要停用背景維護，請在 AX Code 設定中使用 "wiki": { "auto": false }；明確的圖請求仍然可以產生 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 主機可以匯入 renderWikiGraphHtml，來源是 @ax-code/ax-wiki-viewer/node；其結果包含 html 與對應的 csp。