本页译自英文文档。命令、标识符和示例保持原样。运行时 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 页面位于它们所引用文件组成的环内。

径向。 每个页面周围是什么？架构概览、开发工作流和 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 图谱，或输入 /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。