📖 위키 모드 가이드

🔬 위키 모드란?

위키 모드는 소설·만화·세계관 같은 큰 작품을 통째로 캐릭터에 담을 수 있는 제작 방식입니다. 본문 전체를 저장해두면 채팅할 때 AI 가 필요한 부분만 골라서 참고 합니다. 큰 작품도 일관성 있는 대화가 가능해요.

일반 모드와의 차이

📚 청크 · 인덱싱이란?

위키 모드를 쓰다 보면 자주 나오는 두 단어예요. 정확히 알아두면 비용·동작이 한눈에 이해됩니다.

📦 청크 (chunk)

위키 본문을 의미 단위로 잘라놓은 한 조각 입니다. 책에 비유하자면 장(章)·절(節) 같은 거예요.

• 본문에 쓴 헤더 (# 제목 / ## 소제목) 마다 새 청크가 시작돼요.
• 한 청크가 너무 크면 (약 2,200자 초과) 단락 단위로 한 번 더 쪼개집니다.
• 채팅할 때 AI 는 본문 전체가 아니라 관련 청크 몇 개만 골라서 참고합니다.

🔍 인덱싱 (indexing)

잘라놓은 청크를 AI 가 빠르게 찾을 수 있게 분석·저장하는 작업 이에요. 도서관으로 비유하면 책을 책장에 분류해 꽂아두는 작업입니다.

• 각 청크의 주제·인물·키워드 를 AI 가 미리 뽑아둡니다.
• 채팅할 때 사용자 메시지와 가장 관련 있는 청크를 즉시 검색해서 가져옵니다.
• 인덱싱은 저장할 때 1회 만 수행하면, 이후 모든 대화에서 재사용됩니다.
• 본문을 수정하면 바뀐 청크만 다시 인덱싱 (이 매뉴얼의 [변경분만 재인덱싱] 섹션 참조).

🔁 전체 흐름

본문 작성
   ↓
헤더 단위로 자동 분할 (청크 생성)
   ↓
인덱싱 (AI 가 각 청크 키워드 추출 → 저장)
   ↓
채팅 시 AI 가 메시지와 관련된 청크만 골라 참고
   ↓
응답 생성

📝 편집 모드 선택

위키 본문을 작성할 때 두 가지 편집 방식 중 골라 쓸 수 있어요. 결과(저장된 본문)는 동일합니다.

단일 에디터 (single)

• 긴 본문을 하나의 화면 에서 위에서 아래로 작성
• 마크다운 / 나무위키 양식 그대로 사용
• 외부에서 통째로 복사해온 자료에 적합

그룹 에디터 (groups)

• 섹션별로 카드 형태 로 나눠서 관리
• 각 카드의 제목·본문을 따로 편집 / 순서 변경 / 삭제
• 여러 인물·여러 사건이 있는 큰 세계관에 적합

✍ 본문 작성 양식

익숙한 양식 그대로 쓸 수 있어요. 둘 중 어느 것을 써도 자동으로 처리됩니다.

마크다운

# 제목
## 소제목
### 더 작은 제목

- 항목 1
- 항목 2

**굵게** *기울임*

나무위키 양식

== 제목 ==
=== 소제목 ===
==== 더 작은 제목 ====

* 항목 1
* 항목 2

'''굵게''' ''기울임''

등장인물·지명 강조 — [[이름]]

등장인물·지명·고유 명사를 [[ ]] 로 감싸면 AI 가 더 잘 찾아냅니다. 예:

[[미카]]는 [[학원]] 도서위원으로, [[사야]]와는 어릴 때부터 친구다.

⚠ 양식 없이 통째로 적을 경우

마크다운 (#) 이나 나무위키 (== ==) 양식 없이 일반 문서처럼 줄글로만 적으면, 본문이 한 덩어리 청크로 묶이다가 2,200자를 넘는 순간 단락 단위로 강제 분할 됩니다. 이때 잘리는 위치가 의미와 무관한 단락 경계라서:

• 관련 정보가 여러 청크에 흩어져 검색 정확도가 떨어짐
• 한 인물의 정보가 두 청크 중간에서 끊겨 AI 가 일부만 가져옴
• 채팅에서 "본문에는 있는데 AI 가 모르는 척" 하는 현상 빈발

🛠 편집 도구 + 📑 목차

편집 도구

자주 쓰는 양식을 버튼 한 번에 입력할 수 있어요.

• 제목·소제목·리스트·표 삽입
• 미리 만들어진 캐릭터 카드 / 사건 카드 양식 삽입
• 우측 [분할 미리보기] 로 결과 실시간 확인

목차

본문에 추가한 제목들이 자동으로 좌측 목차에 표시돼요. 클릭하면 해당 위치로 바로 이동합니다.

👋 시작 대사

유저가 처음 채팅에 들어왔을 때 보는 메시지예요. 일반 모드와 동일하게:

• 지문/행동: *별표* 로 감싸기
• 대사: "쌍따옴표" 로 감싸기

*햇살이 비스듬히 들어오는 도서실 한구석, 그녀가 책을 덮으며 고개를 든다.*

"어, 너구나? 이 학교는 처음이야?"

⚡ 저장 정확도 선택 (Flash vs Pro)

위키 본문 저장 직전, AI 가 본문을 얼마나 꼼꼼히 분석할지 선택할 수 있어요.

🧠 변경분만 다시 저장

본문을 수정한 뒤 [재인덱싱] 또는 [변경분만 다시 저장] 버튼을 누르면 바뀐 헤더 섹션만 다시 분석돼요.

• 한 섹션 본문을 일부 수정 → 그 섹션 청크만 재분석
• 새 섹션(`# 새 제목`) 추가 → 그 섹션만 새 청크로 추가
• 변경 없는 다른 섹션은 건드리지 않음

📊 사용량 대시보드

마이페이지 > 📚 위키 인덱싱 탭에서 확인할 수 있어요.

• 오늘 사용한 무료 청크 / 잔여 청크
• 이번 달 누적 인덱싱 비용
• 캐릭터별 청크 수 + 마지막 인덱싱 시각

❓ 자주 묻는 질문

Q. 작품 본문이 너무 길면 어떻게 해야 하나요?

현재 한 캐릭터당 최대 20만 자 까지 저장 가능합니다 (이론상 제한이 없으며, 운영 안정화에 맞춰 점진적으로 한도가 확대될 예정입니다). 인덱싱 비용은 청크 수에 비례하므로 (Flash 기준 청크 1개당 1P, 일일 300개 무료) 헤더(# / ##) 를 적절히 잡아 청크를 정리하고, 변경분만 점진적으로 추가하는 걸 권장합니다.

Q. 인덱싱이 실패했어요

마이페이지 > 📚 위키 인덱싱 탭에서 상태를 확인하세요. 캐릭터 편집 페이지에서 [재인덱싱] 버튼으로 다시 시도할 수 있습니다.

Q. 위키 페이지를 다른 사람과 공유하고 싶어요

캐릭터 편집 > Step 3 > 📖 위키 페이지 공개 체크박스로 위키 자료 페이지를 다른 사용자에게 공개할 수 있습니다. 캐릭터 자체가 비공개라면 위키 페이지도 자동 비공개됩니다.