제 39 장: 위키 — 노트를 하나의 지식 베이스로 정리하다

노트가 300개 있습니다. Acme Corp에 대해 아는 모든 것이 그 안 어딘가에 있습니다 — 3월의 가격 논의, 6월의 에스컬레이션, 실제로 계약서에 서명하는 사람의 이름. 전부 적혀 있는데, 한 곳에 모여 있는 것은 하나도 없습니다.

위키는 그에 대한 SeaMeet의 답입니다. 워크스페이스의 모든 노트를 읽고, 반복해서 등장하는 사람·조직·주제를 찾아내어, 주제마다 한 페이지씩 씁니다. 전체 노트가 Acme Corp에 대해 아는 모든 것이 Acme Corp 페이지에 있고, 그것이 나온 각 노트로 돌아가는 링크가 붙습니다. 정리할 필요도, 태그를 달 필요도 없습니다. 지금까지 하던 대로 노트를 계속 쓰면, 위키가 알아서 따라옵니다.

이 장에서는 위키가 무엇인지, 어떻게 만드는지, 페이지를 어떻게 읽는지, 어떻게 스스로를 유지하는지, 그리고 — 위키에 의존하기 시작하면 가장 중요해지는 부분 — 틀렸을 때 어떻게 알려주는지를 다룹니다.

위키의 실체

Finder나 탐색기에서 워크스페이스 폴더를 열면 _wiki/라는 디렉터리가 있습니다. 위키는 그게 전부입니다. 안에는 이렇게 들어 있습니다:

<내 워크스페이스>/
├── Meeting · Jun 4.md          ← 노트는 최상위에 놓인다
├── Q2 Reviews/
│   └── Acme Q2.md
└── _wiki/                       ← 생성된 지식 베이스
    ├── index.md                 ← 모든 페이지의 마스터 색인
    ├── log.md                   ← 무엇이 언제 바뀌었는지
    ├── entities/                ← 조직, 프로젝트, 고객
    │   └── acme-corp.md
    ├── people/                  ← 만나는 사람들
    │   └── alice-cheng.md
    ├── topics/                  ← 여러 회의에 걸친 주제
    │   └── pricing.md
    ├── meetings/                ← 녹음한 회의마다 한 페이지
    └── .state/                  ← 내부 상태 (아래 참고)

모든 페이지는 YAML 프런트매터가 붙은 순수 Markdown 파일입니다. 데이터베이스에 갇힌 것은 아무것도 없습니다. 내일 SeaMeet을 지워도 위키는 여전히 Markdown 폴더입니다 — 어떤 에디터로도 열리고, 어떤 정적 사이트 생성기로도 게시할 수 있으며, 터미널에서 grep할 수 있습니다.

폴더 이름이 밑줄로 시작하는 이유. _wiki/는 노트 트리에서 의도적으로 숨겨집니다 — .git이나 .obsidian과 같습니다. 생성된 산출물이므로, 노트 트리에 섞으면 검색 결과에서 모든 항목이 두 번씩 나옵니다. 대신 Wiki 탭에서 살펴봅니다.

디스크의 이름과 화면의 이름이 다른 이유. 디스크에서 버킷 이름은 entities, people, topics입니다. 앱에서는 Organizations, People, Topics로 표시됩니다. SeaMeet은 실제 노트 전체를 보고 이 라벨들을 도출해 _wiki/.state/sections.json에 씁니다 — 의사의 워크스페이스에서는 Patients가, 영업 담당자의 워크스페이스에서는 Accounts가 나옵니다. 저장 이름은 절대 바뀌지 않으므로, 한 컴퓨터에서 만든 위키는 다른 컴퓨터에서도 그대로 읽힙니다.

위키 열기

상단 내비게이션에서 Wiki를 클릭합니다. Notes 옆, 지식 그룹에 있습니다. 화면 구조는 Notes와 같습니다: 왼쪽에 트리, 가운데에 페이지.

위키를 한 번도 만든 적이 없다면 가운데 창에 온보딩 카드가 나타납니다. Take a Note와 Start Recording 두 개의 버튼이 있는데, 출처가 없는 위키는 할 말이 없기 때문입니다. 페이지가 생기고 나면 가운데 창은 Wiki Home이 됩니다: 검색창, 통계 줄, Top of mind(뒤에 출처가 가장 많은 주제들), 그리고 Updated this week.

사이드바는 « 꺾쇠로 접히며, Notes와 마찬가지로 선택은 세션이 바뀌어도 기억됩니다.

노트 폴더에서 만들기

노트 폴더에서 위키를 만드는 중: 진행 표시줄이 전체 노트를 읽어 나가는 동안 아래 트리에 페이지가 하나씩 나타난다

위키 트리 위쪽의 ✨ 버튼이 Build wiki from all notes입니다. 한 번 누르면 SeaMeet이 워크스페이스 전체를 돌며 모든 노트를 읽고, 찾아낸 모든 주제에 대해 한 페이지씩 씁니다. 같은 버튼이 Notes 트리 툴바에도 있어서, 빌드를 시작하려고 화면을 바꿀 필요가 없습니다.

재빌드가 아니라 증분

이건 몸에 익혀둘 만합니다: 빌드는 바뀐 만큼만 비용을 냅니다. SeaMeet은 노트를 AI에 보내기 전에 본문을 해시해서 지난 빌드의 해시와 비교합니다. 똑같다면 건너뜁니다 — AI 호출도, 비용도 없습니다. 몇 글자만 바뀌었어도 건너뜁니다. 다시 읽을 가치가 없는 변경량의 기준선이 있기 때문입니다.

그래서 ✨ 버튼의 정직한 심상 모형은 "위키를 다시 만든다"가 아니라 **"밀린 것을 따라잡는다"**입니다. 노트가 300개인 워크스페이스에서 어제 이후 4개만 고쳤다면, 눌렀을 때 읽히는 것은 4개이고 다시 쓰이는 것은 그 4개가 건드리는 페이지들뿐입니다. 나머지는 여러분이 직접 쓴 것을 포함해 전부 그대로 남습니다.

배너가 알려주는 것

빌드가 도는 동안 툴바 아래에 진행 배너가 나타납니다. 두 단계를 지납니다:

단계	표시되는 내용	실제로 일어나는 일
읽기	Read 34 of 210 notes · 118 reused from cache	각 노트를 읽고 무엇과 누구를 언급하는지 목록화하는 중. "reused from cache" 숫자는 해시 단축이 제 몫을 하고 있다는 뜻.
빌드	Built 12 of 47 pages · 1 failed	그 주제를 언급하는 모든 노트로부터 한 페이지가 쓰이는 중. 아래 트리에 페이지가 나타나는 것이 이 단계.

카운터 아래에 지금 처리 중인 파일 이름(Now reading: Acme Q2.md)이 나오고, 방금 끝낸 항목들의 짧은 목록이 ✓ 또는 ⚠와 함께 흘러갑니다. AI 제공자의 속도 제한 때문에 기다려야 할 때는 배너가 그냥 멈춘 것처럼 보이는 대신 작은 rate limit: 41s 칩이 나타납니다.

일시정지, 취소, 이어하기

실행 중에는 배너에 버튼이 두 개 있습니다:

Pause — 현재 항목을 끝낸 뒤 멈춥니다. Continue로 바뀌며, 멈춘 바로 그 지점부터 이어갑니다. 20분쯤 대역폭이나 노트북 팬을 되찾고 싶을 때 쓰세요.
Cancel — 진행 중인 항목을 마저 끝내고(반쯤 쓰인 것이 남지 않도록) 멈춥니다. 마무리하는 동안 배너에는 *Cancelling — finishing the current note…*가 표시됩니다.

취소된 실행은 책갈피를 남깁니다. 다음에 Wiki 화면을 열면 배너가 *A previous wiki build was interrupted at 88/210. Resume?*라고 묻고 Resume, Restart, Dismiss를 제시합니다. 실행 도중 AI 제공자의 일일 할당량이 떨어져도 마찬가지입니다: SeaMeet이 위치를 저장하고, 무엇이 멈추게 했는지 알려주며, 할당량이 초기화된 뒤 쓸 Resume을 내놓습니다.

정상적으로 끝나면 배너는 한 줄 요약 — Wiki built — 210 notes, 47 pages — 이 되고 Dismiss와 Restart가 붙습니다.

넛지

빌드를 기억할 필요는 없습니다. 노트를 한 번에 10개 이상 워크스페이스에 넣으면 — 가져오기, 동기화 내려받기, 끌어다 놓은 폴더 — SeaMeet이 토스트를 띄웁니다: 14 new notes since last build, 그리고 Build wiki 버튼. 토스트를 닫으면 Wiki 화면 안의 조용한 배너로 바뀌어 여러분이 움직일 때까지 기다립니다.

페이지 읽기

SeaMeet이 어떤 회사에 대해 쓴 위키 페이지. 아래 “출처” 줄에 이 페이지를 만든 모든 노트가 나열된다

위키 페이지에는 헤더, 두 개의 본문 영역, 푸터가 있습니다.

헤더에는 뒤로·앞으로 화살표가 있고 — 위키는 자체 탐색 기록을 가지므로 링크를 따라갔다 돌아오는 동작이 브라우저와 똑같습니다 — 페이지 제목, 그리고 보라색 AI Generated 알약이 있습니다. 알약에 마우스를 올리면 Refresh from sources로 바뀝니다: 이 페이지의 출처만 다시 읽고 이 페이지만 다시 쓰는, 페이지 단위 재빌드입니다.

AI 섹션은 위쪽 영역이고 왼쪽 테두리가 보라색입니다. SeaMeet이 쓴 부분입니다. 앱에서는 읽기 전용이며, 출처가 넉넉한 주제라면 Overview, Facts, Recent activity, References 같은 하위 절로 정리되어 원자적인 사실의 글머리 기호와, 서사가 필요한 곳의 산문으로 구성됩니다.

그 안에서 두 가지를 클릭할 수 있습니다:

[[wikilinks]] — 다른 위키 페이지로의 상호 참조로 [[entities/acme-corp]]나 [[people/alice-cheng]] 형태로 쓰입니다. 클릭하면 Wiki 화면을 떠나지 않고 이동합니다. SeaMeet은 대상 페이지가 실제로 존재할 때만 링크를 만듭니다. 아직 페이지가 없는 이름은 죽은 링크가 되는 대신 일반 텍스트로 남습니다.
인라인 출처 표기 — 사실 뒤에 붙는 [source: acme-q2.md]. 클릭하면 그 사실을 만들어낸 노트가 열립니다. 여러 노트가 한 문장을 뒷받침하면 하나의 대괄호 안에 묶입니다.

가끔 어떤 사실 앞에 ⚠️ Conflicting: 이 붙고 두 가지 설명이 나란히 제시됩니다. 노트 두 개가 서로 다른 말을 하고 있고 SeaMeet이 한쪽을 고르기를 거부한 경우입니다. 이는 작성 지침이지 검증 절차가 아닙니다 — SeaMeet은 노트에서 모순을 감사하고 있는 것이 아니라, 우연히 마주친 모순을 조용히 뭉개기를 거부하는 것입니다.

사용자 섹션은 아래쪽 영역이고 왼쪽 테두리가 청록색입니다. 그냥 텍스트 상자이고, 여러분의 것이며, 입력을 멈춘 뒤 약 1초 후 자동 저장됩니다. 아래에서 더 다룹니다.

푸터에는 두 그룹의 칩이 있습니다:

Related pages — AI 섹션에서 발견된 [[wikilinks]].
Built from — 이 페이지가 쓰인 모든 노트로, 페이지의 updatedFrom 프런트매터에서 읽어옵니다. 칩을 클릭하면 그 노트가 Notes 화면에서 열립니다. 이 줄이 페이지를 믿을 만하게 만듭니다: "AI가 Acme이 Q4에 갱신한다고 말한다"가 아니라 "이 여섯 개의 노트가 그렇게 말하고, 여기 있다"입니다.

고치는 게 아니라 다시 만든다

주제 페이지가 재빌드될 때 SeaMeet은 옛 페이지를 읽어 편집하지 않습니다. 카탈로그의 모든 노트에서 그 주제에 관한 조각을 전부 모아 AI 섹션을 처음부터 다시 쓰고, 이전 내용을 통째로 대체합니다.

이는 의도된 것이며, 위키와 "덧붙여진 업데이트 더미"의 차이가 바로 여기 있습니다. 노트마다 덧대어 기운 페이지는 아무도 지울 생각을 못 한 낡은 문장을 계속 끌고 다니고, 가장 최근 회의만 알게 됩니다. 카탈로그 전체에서 다시 생성된 페이지는 마흔일곱 번의 회의를 한꺼번에 알고, 더는 사실이 아닌 것을 버리며, "Alice", "A. Cheng", "Alice Cheng"을 한 사람으로 정리합니다.

실무적 결론: AI 섹션을 편집하고 그 편집이 남기를 기대하지 마세요. 다음 재빌드에서 덮어써집니다. 남기고 싶은 것은 사용자 섹션에 쓰거나, 정정으로 되먹임하세요 — 둘 다 아래에서 다룹니다.

스스로 따라잡기

첫 빌드 이후에는 ✨를 누를 일이 거의 없습니다. 위키가 여러분이 일하는 동안 스스로를 유지하기 때문입니다.

노트에 입력하면, SeaMeet은 멈춘 뒤 2분을 기다린 다음 그 편집이 반응할 가치가 있는지 판단합니다. 다음 중 하나라도 참이면 가치가 있습니다:

이 노트가 마지막으로 발동한 이후 대략 150자 이상을 추가했거나,
새 **[[wikilink]]**를 추가했거나,
새 제목을 추가한 경우.

그 외에는 아무 일도 일어나지 않습니다. 오타 고치기, 군더더기 한 줄 지우기, 글머리 기호 다시 맞추기 — 어느 것도 업데이트를 발동시키지 않습니다. "키를 누를 때마다"가 아니라 "노트를 하나 추가할 때마다"라고 생각하세요: 이 실질성 검사는 바로 일상적인 손질이 AI 호출을 태우지 않게 하려고 존재합니다. 게다가 노트마다 10분의 쿨다운이 있어서, 한 노트에서 오래 작업해도 업데이트는 백 번이 아니라 몇 번에 그칩니다.

노트가 읽히면 그 노트가 언급한 주제들이 다시 써야 할 대상으로 표시됩니다. SeaMeet은 즉시 하나씩 다시 쓰지 않고 30초를 기다렸다가 그 사이에 들어온 것을 모아 한 번의 스윕으로 처리합니다. 노트 20개를 가져와도 겹치는 스윕 20번이 아니라 영향받은 주제에 대한 스윕 한 번입니다.

녹음이 끝나면 그 전사와 AI 요약이 같은 경로를 지납니다 — 회의가 노트와 동등한 하나의 출처가 되고, 거기서 논의된 사람과 주제가 각자의 페이지로 흘러 들어갑니다.

Notes 트리에서 아무 노트나 마우스 오른쪽 버튼으로 클릭해 Update wiki from this note를 고르면 그 노트에 한해 기다림을 완전히 건너뜁니다.

워크스페이스 하나에 위키 하나

전환 메뉴에 있는 두 개의 워크스페이스. 각각 자기 폴더와 자기 위키를 가지며, 업무와 개인 작업이 색인을 공유하지 않는다

SeaMeet의 워크스페이스는 디스크의 폴더입니다(제 13 장). 위키는 그 폴더 안, <워크스페이스>/_wiki/에 있습니다. 이 한 가지 사실이 둘의 관계에 관한 모든 물음을 정리합니다.

트리 위쪽 전환기에서 워크스페이스를 바꾸면 노트 트리, 위키 트리, 검색 색인, 위키가 한꺼번에 새 폴더로 재연결됩니다. 업무 위키와 사이드 프로젝트 위키는 색인을 공유하지 않고, 서로 링크하지 않으며, 주말 프로젝트 페이지에 고객 이름이 새어 나갈 수도 없습니다. 이를 위한 설정은 없고 구성할 것도 없습니다 — 폴더 위치에서 그대로 따라 나오는 결과입니다.

전환은 직렬화되어 있습니다: 이미 하나가 진행 중이면 다음 것은 그것이 끝나기를 기다리므로, 빠르게 더블클릭해도 노트는 이 폴더를, 위키는 저 폴더를 가리키는 일이 생길 수 없습니다.

알아둘 만한 예외 하나. 녹음에서 생성된 페이지는 기본 워크스페이스에 고정됩니다. 그래서 사이드 프로젝트 워크스페이스를 보는 중에 녹음한 회의라도, 회의를 담당하는 위키에 제대로 안착합니다.

바로잡기

AI가 틀리게 쓴 문장 고치기: 문장을 선택하고 무엇이 맞는지 알려주면, 그 수정이 사실로 남는다

언젠가는 어떤 페이지가 틀린 말을 합니다. 누군가의 직함이 옛것이거나, 이름이 비슷한 두 회사가 합쳐졌거나, 잠정이던 결정이 확정으로 기록되거나.

Edit 버튼은 없습니다. AI 섹션에 대한 편집은 다음 재빌드를 넘기지 못하기 때문입니다. 대신: 틀린 문장을 선택하세요. AI 섹션 위에서 마우스를 놓는 순간 팝오버가 나타나 여러분이 강조한 문장과 **What's right?**라고 묻는 입력란을 보여줍니다. 바로잡을 내용을 입력하고 Ctrl+Enter(또는 Cmd+Enter)를 누르세요. 다른 목적으로 선택한 것이라면 Esc로 닫으면 됩니다.

그다음 두 가지 일이 일어납니다.

정정은 사실로 저장됩니다. 로그인 상태라면 계정에 저장되어 모든 기기로 따라옵니다. 오프라인이거나 자신의 API 키를 쓰는 경우에는 위키 옆의 _wiki/.state/corrections.json에 저장됩니다. 어느 쪽이든 그것은 현재 페이지에 적용된 패치가 아닙니다 — 그 페이지의 앞으로 모든 재작성에 함께 실리는 상시 지침입니다. 1년 뒤 완전히 다른 노트 묶음으로 이 페이지를 다시 만들어도, 여러분의 정정은 여전히 거기 있고 여전히 권위를 가집니다.

그 페이지는 줄을 앞질러 갑니다. 정정된 주제는 다음 재작성 스윕에서 맨 앞으로 정렬되어, 일반 편집을 기다리는 모든 것보다 먼저 처리됩니다. AI 섹션 아래에 Corrected by you — rewrite pending이라는 줄이 나타납니다. 정정이 접수되었고 재작성이 오고 있다는 영수증입니다.

두 영역, 그리고 AI가 절대 건드리지 않는 것

위키 페이지의 두 영역: 수정 후 “다시 쓰기 대기 중”으로 표시된 AI 영역과, 그 아래 AI가 절대 건드리지 않는 “내 노트”

AI 섹션 아래는 여러분의 섹션입니다. 청록색 테두리에, 그냥 입력할 수 있는 상자. SeaMeet이 알 수 없는 것들이 여기로 갑니다: 거래가 실제로 멈춘 이유, 그 사람이 가운데 이름으로 불리길 좋아한다는 사실, 공유 드라이브 링크, 상황에 대한 여러분 자신의 판단.

SeaMeet은 AI 표시자 사이에만 쓰고 사용자 표시자 사이만 읽습니다. 재빌드는 AI 섹션 전체를 바꾸고 그 아래 글자 하나도 건드리지 않습니다. 이 경계는 파일 자체에 새겨져 있습니다 — 각 영역이 HTML 주석으로 구분됩니다 — 그래서 다른 에디터에서 편집하든, GitHub으로 동기화하든, 백업에서 복원하든 유지됩니다.

여기서 나오는 역할 분담:

	AI 섹션	여러분의 섹션
누가 쓰는가	SeaMeet이, 여러분의 노트로부터	여러분
재빌드 후에도 남는가	아니요 — 통째로 대체	예 — 절대 건드리지 않음
어떻게 바꾸는가	정정을 제출	그냥 입력
무엇을 담는가	노트 전체가 말하는 것	여러분만 아는 것

찾기

트리 필터 — 툴바의 깔때기 아이콘으로 입력하면서 페이지 이름을 걸러냅니다.
Quick Open — Ctrl+P / Cmd+P로 노트와 위키 페이지를 아우르는 팔레트가 열립니다. 종류별로 묶이고, 위키 항목에는 펼친 책 아이콘이 붙습니다.
Global Search — Ctrl+K / Cmd+K로 노트, 위키 페이지, 전사, 요약, 스크린샷 OCR을 전문 검색합니다. 위키 결과는 Wiki 화면에서 열립니다.
노트에서 wikilink — 아무 노트에서나 [[를 입력하면 선택기가 노트와 함께 위키 페이지도 제시하며, 위키에는 · wiki 접미사가 붙습니다.
페이지 내 찾기 — Ctrl+F / Cmd+F는 열린 페이지의 두 영역을 모두 검색하고 어디에 있는지 알려줍니다: 3 in note + 2 in AI section. 바꾸기는 여러분의 섹션에서만 제공됩니다. AI 섹션에서 텍스트를 바꿔봐야 다음 재빌드에서 되돌려지기 때문입니다.

내보내기

툴바의 다운로드 아이콘으로 위키 전체를 자체 완결형 HTML 사이트, PDF, 또는 둘 다로 내보낼 수 있고, 출처 노트를 포함하는 옵션도 있습니다. 고객에게 스냅숏을 건네거나, 프로젝트 종료 시 보관하거나, 비행기에서 전체를 읽을 때 유용합니다.

구독이 필요한 부분

위키의 AI 작업 — 노트를 읽고 페이지를 쓰는 일 — 은 유료 AI 허용량으로 돌아갑니다. SeaMeet 구독이거나 여러분 자신의 API 키입니다(제 35 장, 제 36 장). 구체적으로:

기존 위키 페이지를 읽고 둘러보는 것은 항상 가능합니다. 이미 디스크에 있는 페이지는 구독 여부와 상관없이 읽고, 검색하고, 링크할 수 있습니다. 여러분의 섹션도 마찬가지입니다 — 계속 쓸 수 있습니다.
빌드와 새로고침에는 허용량이 필요합니다. 허용량이 없으면 ✨ 버튼에 잠금 칩이 표시되고, 자동 업데이트는 발동하지 않으며, 백그라운드 스윕도 돌지 않습니다. 삭제되는 것도, 품질이 떨어지는 것도 없습니다. 위키는 허용량이 다시 생길 때까지 배우기를 멈출 뿐입니다.

Wiki 화면 레이아웃

┌──────────────────────────────────────────────────────────────────────┐
│  [Record] [Screenshot] [Memory] │ [Notes] [Wiki ●] │ [Files] [Cloud]  │ ← 상단 내비
├────────────────────────┬─────────────────────────────────────────────┤
│ «  Work ▼           ⚙ │  ‹  ›   Acme Corp            [✨ AI Generated]│
├────────────────────────┤                                             │
│ Wiki   ✨ ⤓ 📁 ⇅ ⌄ ⏷ ⚡│  ┃ Overview                                  │
├────────────────────────┤  ┃ Acme Corp는 2024년부터의 물류 고객이며,  │
│ ┌────────────────────┐ │  ┃ 현재 Q4 갱신 주기 중.                    │
│ │ Read 34 of 210     │ │  ┃                                          │
│ │ notes · 118 reused │ │  ┃ Facts                                    │
│ │ ▰▰▰▰▱▱▱▱▱▱  16%    │ │  ┃ • 갱신 담당자는 [[people/alice-cheng]]   │
│ │ Now reading:       │ │  ┃   [source: acme-q2.md]                   │
│ │ Acme Q2.md         │ │  ┃ • ⚠️ Conflicting: 좌석 수가 회의마다     │
│ │ ✓ Beta Q2.md       │ │  ┃   40과 55로 다르게 기록됨                │
│ │ [Pause]  [Cancel]  │ │  ┗━ 보라색 테두리 = SeaMeet이 쓴 부분       │
│ └────────────────────┘ │                                             │
│ ▼ Organizations     12 │  ┃ Your notes                               │
│    📄 Acme Corp     ←──│  ┃ Alice는 20일까지 휴가. 급한 건 Dan에게.  │
│    📄 Beta Logistics   │  ┃                                          │
│ ▼ People            31 │  ┗━ 청록 테두리 = 여러분 것, 덮어쓰지 않음  │
│    📄 Alice Cheng      │                                             │
│ ▼ Topics             4 │  ─────────────────────────────────────────  │
│    📄 Pricing          │  🔗 Related pages   [alice-cheng] [pricing] │
│ ▶ Meetings          88 │  📝 Built from      [Acme Q2.md] [Jun 4.md] │
├────────────────────────┤                          ↑                  │
│ ☁ 30초 전 동기화됨     │           이 페이지가 나온 모든 노트        │
└────────────────────────┴─────────────────────────────────────────────┘

문제 해결

"✨를 눌렀는데 거의 아무 일도 없었어요"

대개 올바른 동작입니다. 빌드는 증분이므로 지난 실행 이후 바뀐 것이 없으면 읽을 것도 다시 쓸 것도 없고, 배너는 "reused from cache" 숫자가 높은 채로 거의 즉시 끝납니다. 그래도 특정 한 페이지를 강제로 다시 쓰고 싶다면 그 페이지를 열고 AI Generated 알약에 마우스를 올려 Refresh from sources를 쓰세요.

버튼에 스피너 대신 자물쇠가 보였다면 문제는 노트가 아니라 AI 허용량입니다 — 제 35 장: 구독 및 결제를 보세요.

"페이지에 틀린 내용이 있는데 계속 고치게 돼요"

아마 AI 섹션을 편집하고 있을 겁니다. 그곳은 재빌드마다 대체됩니다. 대신 틀린 문장을 선택하고 정정 팝오버를 쓰세요. 그것은 재빌드를 넘어 남고 권위로 다뤄집니다. SeaMeet의 독해를 고치는 것이 아니라 여러분 자신의 지식이라면, 절대 덮어쓰이지 않는 아래 청록색 섹션에 넣으세요.

"노트를 고쳤는데 페이지가 갱신되지 않아요"

입력과 재작성 사이에는 모두 의도된 세 개의 타이머가 있습니다: 멈춘 뒤 2분의 정적, 실질성 검사(대략 150자 추가, 또는 새 wikilink, 또는 새 제목), 그리고 노트당 10분의 쿨다운. 작은 편집이 아무것도 발동시키지 않는 것은 정상입니다. 강제하려면: 노트를 마우스 오른쪽 버튼으로 클릭 → Update wiki from this note, 또는 위키 페이지를 열고 Refresh from sources.

"빌드가 도중에 오류로 멈췄어요"

거의 언제나 AI 제공자의 일일 할당량입니다. 배너가 그렇게 말하고 위치도 저장해 둡니다 — 할당량이 초기화된 뒤 돌아와 Resume을 누르세요. 처음부터가 아니라 멈춘 곳부터 이어갑니다.

"워크스페이스를 바꿨더니 위키가 비어 있어요"

설계상 그렇습니다: 각 워크스페이스는 자기 _wiki/ 폴더를 가집니다. 찾는 페이지는 다른 워크스페이스에 그대로 있습니다 — 트리 위쪽 워크스페이스 전환기로 돌아가세요. 새 워크스페이스는 빌드하기 전까지 위키가 비어 있습니다.

"있을 줄 알았던 페이지가 없어요"

주제는 여러분의 노트가 그것에 대해 실제로 무언가를 말한 뒤에야 페이지를 얻습니다. 한 번 스쳐 지나간 이름은 빈 페이지로 가는 링크가 되는 대신 일반 텍스트로 남습니다. 그것에 대해 실질적인 내용을 담은 노트를 쓰고 업데이트가 발동하게 두거나, 컨텍스트 메뉴에서 강제하세요. 노트 안의 해결되지 않은 wikilink 알약을 마우스 오른쪽 버튼으로 클릭해 Sync wiki to generate this page를 고를 수도 있습니다.

빠른 참조

작업	방법
Wiki 열기	상단 내비의 Wiki 클릭
모든 노트로 빌드	위키(또는 노트) 트리 툴바의 ✨ 클릭
빌드 일시정지 / 재개	진행 배너의 Pause / Continue
빌드 중단	Cancel — 나중에 배너에서 이어하기
한 페이지만 재빌드	AI Generated 알약에 마우스 올리기 → Refresh from sources
노트 하나에서 갱신	노트 우클릭 → Update wiki from this note
틀린 문장 바로잡기	AI 섹션에서 선택 → 바른 내용 입력 → `Ctrl+Enter`
내 지식 추가	청록색 Your notes 섹션에 입력 — 자동 저장
페이지의 출처 보기	푸터의 Built from 칩
링크된 페이지로 이동	AI 섹션의 `[[wikilink]]` 클릭
뒤로 / 앞으로	페이지 헤더의 ‹, › 화살표
페이지 빠르게 열기	`Ctrl+P` / `Cmd+P`
전체 검색	`Ctrl+K` / `Cmd+K`
이 페이지에서 찾기	`Ctrl+F` / `Cmd+F`
트리 필터	툴바의 깔때기 아이콘
위키 내보내기	툴바의 다운로드 아이콘 → HTML / PDF / 둘 다
다른 위키로 전환	트리 위쪽에서 워크스페이스 전환
디스크의 파일 찾기	`<내 워크스페이스>/_wiki/`

짧게 말하면: 노트가 진실의 원천으로 남고, 위키는 그것을 덧대는 대신 다시 생성해 얻은 하나의 뷰이며, 여러분이 쥔 지렛대는 둘입니다 — 정정(SeaMeet이 쓰는 내용을 바꿉니다)과 여러분 자신의 섹션(SeaMeet이 결코 쓰지 않는 곳). 계속 노트를 쓰세요. 색인은 알아서 굴러갑니다.

Last updated: 2026-09-02

← 제 38 장: GitHub Sync 설정 | (설명서 끝 — 색인으로 돌아가기)

위키 - 노트를 하나의 지식 베이스로 정리하다