커리큘럼

아카데미모듈 2 · 지식그래프 키우기

그래프 뷰: 3D 지식그래프 읽기

6개 레슨 중 4번째12분

이 레슨에서 배우는 것

  • 지식그래프를 열고 노드, 엣지, 라벨이 각각 무엇을 뜻하는지 구분할 수 있습니다
  • 회전, 이동, 줌, 리셋으로 길을 잃지 않고 카메라를 다룰 수 있습니다
  • 엔티티를 고립시키고 이웃으로 건너뛰며, 연결 뒤의 출처 문장을 확인할 수 있습니다
  • 테마 색과 타입 색을 구분하고, 그래프 전체를 테마별로 물들이는 주제 지도를 만들 수 있습니다

노트를 몇 주째 모아 왔습니다. 파일 트리는 목록만 보여줄 뿐, 공급사 미팅 노트와 지난봄 장애 노트가 같은 엔지니어를 언급한다는 사실은 알려주지 못합니다.

지식그래프는 바로 그걸 보여줍니다. 모든 노트, 노트에서 뽑아낸 모든 엔티티(사람, 조직, 장소, 아이디어), 그리고 그 사이의 모든 관계까지 한 화면에 담습니다. 빛나는 구체와 색색의 선이 천천히 회전합니다.

이 강의는 그 그림을 읽는 법을 다룹니다. 색이 무엇을 뜻하는지, 카메라를 어떻게 움직이는지, 엔티티를 클릭해 그 연결을 만든 문장까지 어떻게 짚어내는지 배웁니다. 필터, 보기 설정, 내보내기 같은 플로팅 컨트롤은 다음 강의에서 따로 다룹니다.

열고 카메라 다루기

타이틀바 오른쪽 위의 경유지(waypoints) 아이콘을 클릭합니다. 툴팁에 "지식그래프" 라고 뜹니다. 아니면 ⌘⇧G(Mod+Shift+G, 재지정 가능)를 눌러도 됩니다.

그래프는 탭 스트립에 단 하나의 탭으로 열리고, 단축키를 한 번 더 누르면 마지막에 보던 문서로 돌아갑니다. 바로 옆에는 "엔티티 테이블" 버튼이 있는데, 같은 엔티티와 관계를 정렬 가능한 표로 보여주는 화면입니다.

  • 3D 장면은 하나를 공유합니다. 빈 새 채팅의 배경으로도 같은 장면이 쓰입니다.
  • 엔티티 페이지의 "그래프에서 열기"나 앱 곳곳의 이웃 칩을 누르면, 해당 엔티티가 이미 고립된 상태로 이 화면에 도착합니다.
  • 그래프 뷰에서는 설정 스타일의 왼쪽 레일로 "그래프"(3D 캔버스)와 튜닝 섹션들을 오갈 수 있습니다. 튜닝 섹션은 그래프 컨트롤을 다루는 강의의 몫입니다.
카메라 조작
왼쪽 드래그        회전 (자유 트랙볼, 극점 고정 없음)
오른쪽 드래그      이동(팬)
Shift + 드래그     이동(팬)
스크롤             줌
⌘⇧G               그래프 탭 열기 / 나가기
⌘F                그래프 탭에서 "그래프에서 찾기"

그래프는 멈춰 있는 법이 없습니다. 가만히 두면 약 21초에 한 바퀴씩 천천히 자전하고, 마우스를 올리면 그 3분의 1 속도로 느려집니다. 드래그나 줌, 클릭을 한 번 하면 3초간 멈춥니다.

구석의 힌트 오버레이가 그 세 가지 조작을 그대로 알려 줍니다. 조작하는 동안이나 카드가 열려 있는 동안에는 플로팅 UI 전체가 사라집니다.

화면에 떠 있는 원형 화살표 모양의 리셋 버튼(툴팁 "홈 뷰로 리셋")은 그래프 전체를 다시 잡아 줍니다. 다만 고립된 엔티티나 파고든 테마처럼 어떤 초점 안에 들어와 있다면, 홈으로 곧장 가는 대신 한 번에 한 겹씩 벗겨냅니다.

구체 세 종류, 선 일곱 종류

모든 구체는 세 가지 노드 종류 중 하나이고, 종류마다 클릭 반응이 다릅니다.

노드 종류정체알아보는 법
노트(문서)내 마크다운 파일클릭하면 파일이 열립니다(아래 클릭 규칙 참고)
엔티티노트에서 추출된 대상으로, 뒤에 파일이 없습니다라벨이 시안색입니다
코드 파일코드 인텔리전스가 인덱싱한 소스 파일초록 색조, "코드 표시"가 켜져 있을 때만 보입니다

선에도 타입과 색이 있습니다. 방향이 있는 엣지는 그라데이션으로 그려지고, relation 엣지는 "works at", "founded by" 같은 술어를 선 위에 작은 흐린 글씨로 직접 써 줍니다.

엣지 종류
relation시안 그라데이션, 방향 있음"founded by" 같은 타입 있는 사실. 술어가 선 위에 적힙니다
sameAs보라, 무방향엔티티 해소가 합친 동일 개체(동의어) 병합
broader호박색, 방향 있음위계: 좁은 개념 → 넓은 개념
related청록, 무방향연관 링크
code초록, 방향 있음파일 간 호출 / import / 상속 링크
code-mention금색, 방향 있음노트 → 코드를 잇는 다리 링크
mentions색 없음문서 → 엔티티: 이 엔티티가 어떤 노트에 등장하는지
미니 지식그래프입니다. 노드를 끌어 보고 라벨 위에 마우스를 올려 보세요. 실제 캔버스처럼 관련 엔티티끼리 뭉칩니다.

호버, 클릭, 고립

엔티티에 마우스를 올리면 커서를 따라다니는 작은 카드가 제목과 함께 "연결 3개 · 노트 2개" 같은 요약을 보여줍니다. 마우스를 올린 노드와 바로 옆 이웃만 밝게 남고 나머지는 어두워집니다. 그래서 빽빽한 구역도 한결 읽기 쉬워집니다.

  • 엔티티 노드 클릭: 그 노드와 바로 옆 이웃만 남기고 나머지가 쪼그라들면서(고립) 선택 카드가 열립니다. 고립된 엔티티를 다시 클릭하면 고립이 풀립니다.
  • 노트 노드 클릭: 고립되는 동시에 파일이 에디터에 흐릿한 미리보기로 열립니다. 한 번 더 클릭하면 완전히 에디터 뷰로 넘어갑니다.
  • 빈 공간 클릭: 열린 카드를 닫거나 현재 고립 레이어에서 한 겹 빠져나옵니다.
  • 테마 슈퍼 노드 클릭(맵 모드): 테마 인스펙터 카드가 열립니다.

⌘F는 그래프 자체를 검색합니다. 이름을 입력하고 Enter를 누르면 카메라가 일치 항목으로 날아갑니다. 검색창과 단축키는 그래프 컨트롤을 다루는 강의의 몫입니다.

이해도 체크

빛나는 구체를 클릭했더니 마크다운 파일이 에디터에 열렸습니다. 무슨 일이 일어난 걸까요?

엔티티 프로필 카드

엔티티를 클릭하면 왼쪽 위의 유리 카드가 그 엔티티의 정보로 채워집니다. 전체 프로필이 도착하기 전에 정리 전의 엣지 목록이 먼저 나타나고, "연결 정리 중…" 로딩이 끝나면 순위가 매겨진 뷰로 바뀝니다.

  • 메타 줄 "노트 {count}곳에 등장" 과 색이 있는 타입 배지가 있습니다. 배지는 11가지 엔티티 타입과 "타입 지정 해제"가 담긴, 편집 가능한 알약 UI입니다. 타입이 없으면 점선의 "타입 지정…"이 대신 보입니다.
  • "관련 항목"(Connections): 술어별로 묶어 관련도 순으로 정렬한 이웃들입니다. 방향 화살표(→ / ←)도 붙습니다. 칩을 클릭하면 그 엔티티로 건너뛰고, 긴 그룹은 "더 있음…"으로 끝납니다.
  • "당신의 표현으로": 이 엔티티에 대한 내 원문 그대로의 문장들입니다. 결정, 주장, 인용처럼 종류별로 묶이고, 나중 노트가 뒤집은 항목에는 "대체됨"이나 "철회됨" 배지가 붙습니다.
  • "다른 이름": 병합된 동의어 칩입니다. 분리 버튼을 누르면 잘못된 병합을 갈라놓고 엔티티 해소를 다시 계산합니다.
  • "여기에 나와요": 출처 노트 목록입니다. 클릭하면 에디터에서 열립니다.
  • "관련 코드": 이 엔티티와 의미가 가까운 코드 심볼입니다. 코드 인텔리전스가 켜져 있을 때만 보입니다.

테마, 커뮤니티, 그리고 색

처음에는 노드가 주제별로 색칠되어 있지 않습니다. 왼쪽 레일의 "주제 지도"에서 "주제 지도 생성" 을 한 번 실행하면, Consilience가 서로 관련된 엔티티 군집, 곧 테마를 찾아내 이름과 요약을 붙입니다. 지도가 만들어지면 노드가 테마 색을 입고, 보기 설정에 "맵 모드" 가 나타납니다.

  • "맵 모드": 테마당 슈퍼 노드 하나로 그래프를 접어, 도시 대신 대륙을 보는 시점입니다. 테마를 클릭하면 인스펙터 카드가 열립니다.
  • "집중": 그 테마의 하위 그래프로 파고듭니다. "← {테마} · 맵으로" 알약을 누르면 되돌아옵니다.
  • "MOC": 테마의 노트와 개념을 모은 요약 노트를 만듭니다.
  • "고립됨" 배지: 워크스페이스의 나머지와 거의 닿지 않는 테마에 붙습니다.

테마 색은 "타입별 색" 과는 별개입니다. 타입별 색은 엔티티를 종류(사람, 조직, 장소 등)별로 칠하는 보기 설정 토글로, 충분한 엔티티가 타입을 갖게 되면 켜집니다. 오래된 워크스페이스라면 먼저 "빠진 종류 채우기"를 실행하면 토글이 나타납니다.

고립(Isolation)
한 노드와 바로 옆 이웃만 남기고 나머지를 줄이는 것. 리셋 버튼은 초점 레이어를 한 번에 한 겹씩 벗깁니다.
선택 카드
클릭하면 열리는 엔티티별 프로필: 타입, 연결, 문장, 별칭, 출처 노트.
출처 문장
이웃 칩에 마우스를 올리면 보여 주는, 그 연결을 진술한 출처 노트의 문장.
테마(커뮤니티)
주제 지도가 워크스페이스 전체에서 찾아내는, 이름과 요약이 붙은 관련 엔티티 군집.
맵 모드
테마당 슈퍼 노드 하나로 그래프를 접어 보여주는 뷰.
자전(ambient rotation)
그래프의 상시 저속 회전. 호버하면 느려지고 조작 후 3초간 멈춥니다.

규모가 커져도 잘 읽히는 성능

그래프는 GPU로 그려지고, 다른 화면에 다녀와도 카메라와 레이아웃이 그대로 남아 있습니다. 안정화된 노드 위치는 뷰(워크스페이스, 맵, 테마)별로 캐시되어, 돌아왔을 때 다시 흩어지지 않습니다.

노드가 수천 개로 불어나도 매끄럽게 읽힙니다. 그래프가 커질수록 구체 디테일이 알아서 낮아지고, 라벨은 화면 칸마다 예산이 배정됩니다. 그래서 빽빽한 구역도 뭉개지는 대신 읽을 수 있는 몇 개의 이름만 남고, "정보량" 슬라이더를 올리면 더 많이 그려집니다.

이해도 체크

맵 모드에서 테마로 파고든 뒤, 그 안에서 엔티티 하나를 고립시켰습니다. 리셋 버튼을 한 번 누르면 무슨 일이 일어날까요?

이제 그림을 읽을 수 있습니다. 다음 강의에서는 필터, 보기 설정, 내보내기까지 이 화면의 플로팅 메뉴를 하나씩 열어 봅니다.

그래프 뷰: 3D 지식그래프 읽기 · Consilience Academy