Kuku (九九) 사용 설명서

1. 기본 흐름

1. 목표를 정하고 9×9 차트를 만듭니다 — 중심에 목표, 주위에 8개의 요소, 각 요소마다 8개의 항목. 총 81칸으로 분해합니다.
2. 칸을 탭해 깊이 검색합니다 — 지나온 경로(주제 → 요소 → 항목)가 그대로 검색어가 되어 앱 내 브라우저에서 열립니다.
3. 좋은 페이지는 북마크합니다 — 어느 칸에서 찾았는지도 함께 기록됩니다.
4. 알게 된 내용을 칸에 다시 적습니다 — 차트가 “한 번 쓰고 마는 결심 선언”이 아니라, 계속 자라나는 작전 지도가 됩니다.

▲ 만들기 → 파고들기 → 검색 → 북마크까지의 전체 흐름(2배속, 약 85초, 영어 영상·자막 포함)

2. 차트 만들기(4가지 방법)

홈 화면 오른쪽 위의 ＋를 탭하면 “새 차트” 화면이 열립니다. 중심 주제를 입력하면 채우는 방법은 네 가지입니다. 어느 방법으로 시작하든 나중에 자유롭게 편집할 수 있습니다.

AI와 템플릿이 만들어 주는 것은 어디까지나 “초안”입니다. 직접 입력한 칸을 AI가 마음대로 덮어쓰는 일은 없습니다.

3. 9×9 둘러보기

• 전체 보기와 확대 보기: 처음에는 81칸 전체를 한눈에 보는 화면입니다. 3×3 블록을 탭하면 그 블록에 초점을 맞춰 크게 표시됩니다.
• 파고들기: 중앙 블록의 요소 칸을 탭하면 그 요소의 바깥쪽 블록으로 확대되면서 이동합니다.
• 뒤로: 화면 왼쪽 위의 뒤로 버튼(또는 내비게이션)으로 한 단계 위로 돌아갑니다. 확대·축소 애니메이션이 위치 관계를 유지해 주므로 길을 잃지 않습니다.
• 편집: 칸을 길게 누르면(또는 확대 보기 상태에서 탭하면) 편집 시트가 열려 텍스트를 입력하거나 고칠 수 있습니다.

4. 칸에서 검색하고 북마크하기

• 칸의 검색 버튼을 탭하면 지나온 경로의 단어를 이어 붙인 검색(예: “영어 학습 리스닝 섀도잉”)이 앱 내 브라우저에서 열립니다. 단어 하나만으로 검색할 때보다 목표의 맥락에 맞는 결과가 상위에 표시되는 경우가 많습니다.
• 브라우저에서 좋은 페이지를 만나면 북마크 버튼으로 저장합니다. 한 번 더 탭하면 해제됩니다.
• 저장한 페이지는 홈의 북마크 목록에서 여러 차트에 걸쳐 한곳에서 볼 수 있습니다. 어느 차트의 어느 칸(경로)에서 찾았는지도 함께 표시됩니다.
• 검색에 사용할 엔진은 설정에서 바꿀 수 있습니다(→ 6. 설정).

5. Markdown 내보내기(Obsidian / Notion)

• 차트 내보내기: 차트 화면의 공유 버튼을 탭하면 주제 + 8개 요소 + 각 항목을 아웃라인 형식의 Markdown(.md)으로 내보낼 수 있습니다.
• 북마크 내보내기: 북마크 목록의 공유 버튼을 탭하면 차트·경로별로 정리된 Markdown으로 내보낼 수 있습니다. 개별 북마크는 길게 눌러 한 건만 공유할 수도 있습니다.
• Obsidian이나 Notion에 그대로 붙여넣거나 가져올 수 있습니다. 둘 다 무료 요금제로 사용할 수 있습니다.

6. 설정

• 검색 엔진: Google(기본값) / DuckDuckGo / Bing / Baidu / NAVER 중에서 고를 수 있습니다. 추적을 줄이고 싶다면 DuckDuckGo를 선택하세요. 한국어 지역 정보는 NAVER에서 더 잘 찾을 수 있습니다.
• 생성에 사용할 제공자: 클라우드 AI의 제공자(Claude / Gemini / OpenAI / Qwen)를 고릅니다. 키가 설정된 제공자는 자동으로 사용됩니다.
• API 키: 제공자별로 입력합니다. 키는 기기의 키체인에만 저장되며 개발자의 서버로 전송되지 않습니다. 입력란을 비운 채 저장하면 삭제할 수 있습니다.
• Pro 상태와 구입 항목 복원: 설정 화면에서 확인하고 복원할 수 있습니다.

7. Kuku Pro(한 번 구입)

• 무료 버전에서는 차트를 5개까지 만들 수 있습니다. 분해·검색·북마크·내보내기·기기 AI·템플릿은 무료 버전에서도 모두 사용할 수 있습니다.
• Kuku Pro(한 번 구입·비소모성)를 구입하면 차트 무제한, 클라우드 AI 모드, 마인드맵 보기(전체 펼침·확대/축소)를 사용할 수 있게 됩니다. 구독이 아닙니다.
• 기기를 바꾸거나 다시 설치해도 같은 Apple ID라면 설정 → 구입 항목 복원으로 Pro를 다시 사용할 수 있습니다(자동으로 복원되는 경우도 있습니다).

8. AI 생성 사용하기

기기 AI(Apple Intelligence) — 무료

• 지원 기종(iPhone 15 Pro 이후 등 Apple Intelligence 지원 기기)에서 설정 앱 → Apple Intelligence 및 Siri에서 Apple Intelligence를 켜면 사용할 수 있습니다.
• 처음 사용할 때는 모델을 내려받는 데 시간이 걸릴 수 있습니다(“기기 AI 모델을 준비하는 중입니다”라고 표시됩니다).
• 지원하지 않는 기종에서도 템플릿, 직접 입력, 클라우드 AI는 모두 사용할 수 있습니다.

클라우드 AI(Claude / Gemini / OpenAI / Qwen) — Kuku Pro

1. 사용할 제공자의 API 키를 발급받습니다. 절차, 무료 할당량, 주의 사항은 별도 페이지에 자세히 정리했습니다 → API 키 발급 가이드(영문)
2. 발급받은 키를 복사합니다(Mac에서 발급받았더라도 같은 Apple ID라면 iPhone에서 그대로 붙여넣을 수 있습니다 — 공통 클립보드).
3. Kuku의 설정 → API 키에서 해당 제공자 입력란 옆의 붙여넣기 버튼을 탭해 붙여넣고 저장합니다(공백과 줄바꿈은 자동으로 제거되며, 다른 제공자의 키를 붙여넣으면 경고가 표시됩니다).
4. 새 차트 화면이나 “AI로 빈 칸 채우기”에서 “클라우드 AI로 생성 (Pro)”를 선택하면 웹 검색을 반영한 고품질 초안을 생성할 수 있습니다.

생성할 때마다 요청이 사용자가 선택한 제공자에게 본인의 키로 직접 전송됩니다(개발자의 서버를 거치지 않습니다). API 이용 요금은 각 제공자가 사용자에게 청구합니다.

9. 문제 해결

증상	원인과 해결 방법
“기기 AI로 자동 생성”이 보이지 않거나 사용할 수 없습니다	Apple Intelligence를 지원하지 않는 기종이거나, 설정에서 꺼져 있습니다. 설정 앱 → Apple Intelligence 및 Siri를 확인해 주세요. “기기 AI 모델을 준비하는 중입니다”라고 표시된다면 모델 내려받기가 끝날 때까지 기다려 주세요.
“내용이 기기 내 AI의 안전 가드에 걸려 생성할 수 없었습니다”	기기 내 AI의 안전 기능이 영구적으로 거부한 것이므로 시간이 지나도 결과가 달라지지 않습니다. 실존 인물의 이름 등을 입력했을 때 발생할 수 있습니다. 표현을 바꾸거나 클라우드 AI를 사용해 보세요(같은 내용이라도 생성되는 경우가 있습니다).
클라우드 AI 생성이 “API 키가 올바르지 않습니다” 오류로 실패합니다	대부분 키를 붙여넣을 때의 실수(앞뒤 공백, 다른 제공자의 키)입니다. 가이드(영문)의 절차대로 키를 다시 확인하거나 재발급해 주세요.
“AI 사용 한도에 도달했습니다”	제공자 쪽의 요청 빈도 제한(rate limit)입니다. 잠시 기다리거나, 각 제공자의 콘솔에서 사용량과 요금제 설정을 확인해 주세요(무료 등급은 한도가 낮은 편입니다).
구입했는데 Pro가 활성화되지 않습니다	설정 → 구입 항목 복원을 실행해 주세요. 구입할 때와 같은 Apple ID로 로그인되어 있어야 합니다.
검색 결과가 열리지 않습니다(중국 본토)	중국 본토에서는 Google / DuckDuckGo에 연결할 수 없습니다. 설정에서 검색 엔진을 Baidu(직접 고르지 않았다면 자동으로 기본값이 됩니다) 또는 Bing으로 바꿔 주세요.

그래도 해결되지 않으면 support@kiribako.app으로 편하게 연락해 주세요.