이 페이지는 영어 문서의 번역입니다. 명령, 식별자, 예제는 그대로입니다. 런타임 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 자신의 위키입니다. 같은 스냅샷에는 전환할 수 있는 레이아웃이 네 개 있습니다. 호와 트리맵이 나머지 둘이며 여기에는 보이지 않습니다.

방사형. 각 페이지 주위에는 무엇이 있는가? Architecture Overview, Development Workflows, Ax Code Intel 모듈이 인용된 파일의 고리 안에 있습니다. 교차 링크는 중심을 통과해 묶입니다. 고리는 각 파일을 처음 인용한 페이지에서 나옵니다. 거리나 가지 길이를 인코딩하지 않습니다.

힘. 누가 무엇을 인용하는가? 페이지, 파일, 기호는 연결에 따라 놓이므로, 인용된 파일은 그것을 기록한 페이지 옆에 모입니다.

페이지 하나를 연 상태. 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는 함께 쓸 수 없습니다.

뷰어는 검색, 페이지/소스 필터, 한 단계 선택, 증거 세부 정보, 확대/이동 조작을 지원합니다. 옆 목록은 키보드로 동작합니다. 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를 생성할 수 있습니다. 생성과 Wiki 프롬프트 주입을 끄려면 enabled를 false으로 설정합니다. 기존 스냅샷은 계속 볼 수 있습니다. 실패한 작업은 자동 시도를 최대 세 번까지 백오프로 다시 시도한 뒤, 소스/구성 변경이나 명시적인 그래프 요청을 기다립니다.

다른 프로젝트에 넣기

작업 공간 패키지는 독립 소비자를 위해 빌드하고 묶을 수 있습니다. @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가 들어 있습니다.