Nexus 웹 사용 가이드

설치 없이 Nexus 웹을 사용하는 가이드입니다. 먼저 띄워야 한다면 빠른 시작을 보세요.

브라우저에서 http://localhost:8000/ 을 엽니다. Nexus는 인덱싱된 문서 안에서만 답하고, 모든 답에는 출처가 함께 붙습니다 — 추측하지 않습니다.

질문하기 (채팅)

채팅 탭이 기본 화면입니다. 자연어로 질문을 입력하고 전송하세요.

@이름(예: @payment-service)으로 특정 서비스·엔티티에 검색을 집중시킬 수 있습니다.
빈 화면에 예시 질문이 있으니 눌러서 바로 시도해 보세요.

답변 읽기

모든 답은 근거 기반입니다 — 각 주장에 [출처: 문서 제목, 섹션] 형태의 인용이 붙습니다. 문서 제목은 파일 경로가 아니라 사람이 읽는 이름입니다.

근거가 없으면 답을 지어내지 않고 “제공된 문서에서 해당 정보를 찾을 수 없습니다” 라고 답합니다. 이 거절은 결함이 아니라 기능입니다 — Nexus는 환각하지 않습니다.

근거 패널

오른쪽 패널에 답의 근거가 나열됩니다. 각 항목은:

문서 제목,
신뢰 배지(아래 참고),
관련도 막대(얼마나 강하게 매칭됐는지 %), 그리고
매칭된 본문 조각을 보여줍니다.

하단의 출처 목록은 각 근거 문서를 제목으로 링크합니다(원본 경로는 마우스를 올리면 표시).

신뢰 배지 — 출처를 얼마나 믿을지

각 출처에는 거버넌스 등급이 달려 있어, 그 근거에 얼마나 무게를 둘지 알 수 있습니다:

배지	의미
거버넌스(초록)	승인 게이트를 거친 정본 결정(예: ADR·설계 문서·RFC). 신뢰 최상.
추적(금색)	리뷰되나 승인 게이트는 없음 — drift/staleness 주의(예: PRD·런북·포스트모템).
메모(회색)	비거버넌스 참고 메모 — 정본 아님(예: 가져온 노트).

미지·미분류 문서는 보수적으로 메모로 기본 처리됩니다.

문서

문서 탭은 Nexus가 인덱싱한 모든 문서를 doc-type 신뢰 배지와 함께 보여줍니다 — 코퍼스가 얼마나 거버넌스되는지 한눈에 보입니다.

제목으로 검색하고, 상태(검색에 노출 중 / 숨김 / Notion에서 삭제됨 / 대체됨)로 거를 수 있습니다. 출처 열은 각 문서가 Notion·업로드·파일 중 어디서 왔는지 보여주고, Notion 문서는 원본 페이지로 바로 갑니다.

숨기기는 문서를 검색에서 내립니다. 지우지 않습니다 — 문서와 청크는 그대로 있고 언제든 되돌리기로 돌아옵니다. 누르기 전에 확인 패널이 무슨 일이 일어나는지 말해 줍니다. 다른 문서로 대체된(superseded) 문서는 무엇이 자기를 대체했는지 제목으로 보여주고, 되돌리려면 사유를 요구합니다.

문서 넣기 (업로드)

업로드 탭에서 문서를 한 건씩 인덱스에 추가할 수 있습니다.

Notion 연결하기 (소스)

소스 탭에서 Notion 페이지 URL을 붙여넣으면 그 하위 트리 전체가 검색에 들어옵니다. 터미널을 열 필요가 없습니다.

맨 위 패널이 연결 상태를 말합니다: 토큰이 유효한지, 어느 integration·워크스페이스인지. 토큰이 폐기되었으면 그렇게 말합니다.
등록한 root 옆에 도달 가능 여부가 붙습니다. Notion에서 그 페이지에 integration을 초대하지 않았다면, 동기화를 돌리기 전에 알려 줍니다.
지금 동기화가 트리를 걷습니다. 첫 실행에는 이것을 씁니다.
Notion에서 지운 페이지를 검색에서도 내리려면 삭제 반영 미리보기를 먼저 누르세요. 무엇이 내려갈지 제목으로 나열해 주고, 그 목록을 보고 확인해야 실제로 적용됩니다.

관계 살펴보기 (그래프)

그래프 탭은 엔티티 관계를 보여줍니다 — 문서 기반 설계 관계와 텔레메트리 기반 관측 관계 — 그래프 데이터가 있을 때.

결과가 비어 보일 때

토큰 없이 접속하면 Nexus는 익명 모드로 동작하며 PUBLIC 문서만 표시합니다 — 그때의 빈/부분 결과는 버그가 아니라 보안 경계입니다. INTERNAL 내용을 보려면 토큰으로 인증하세요.