Manual de uso do Kuku (九九)

1. Fluxo básico

1. Defina seu objetivo e crie um diagrama 9×9 — o objetivo no centro, 8 elementos ao redor e 8 itens por elemento: no total, 81 células.
2. Toque em uma célula para pesquisar a fundo — o caminho percorrido (tema → elemento → item) vira os termos de busca, e a busca abre no navegador integrado.
3. Salve as páginas úteis como marcadores — fica registrado também a partir de qual célula você chegou a elas.
4. Anote nas células o que descobrir — assim o diagrama deixa de ser uma declaração de intenções escrita uma única vez e vira um painel de estratégia que não para de crescer.

▲ O fluxo completo: criar → aprofundar → buscar → salvar marcadores (em 2× a velocidade normal, cerca de 85 segundos, vídeo em inglês com legendas)

2. Criar um diagrama (4 métodos)

Toque no botão ＋ no canto superior direito da tela inicial para abrir a tela “Novo diagrama”. Depois de digitar o tema central, há 4 maneiras de preenchê-lo. Seja qual for a escolha, tudo pode ser editado livremente depois.

A IA e os modelos prontos produzem apenas “rascunhos”. A IA nunca sobrescreve uma célula que você mesmo digitou.

3. Como navegar na grade 9×9

• Visão geral e foco: no início você vê as 81 células de uma vez. Toque em um bloco 3×3 para focá-lo e vê-lo ampliado.
• Aprofundar: toque na célula de um elemento no bloco central para mergulhar no bloco externo dele com uma animação de zoom.
• Voltar: o botão de voltar no canto superior esquerdo (ou o gesto de voltar da barra de navegação) leva um nível acima; a animação de zoom mantém a relação espacial.
• Editar: toque e segure uma célula (ou toque nela com o bloco em foco) para abrir a tela de edição e digitar ou corrigir o texto.

4. Buscar a partir das células e salvar marcadores

• Ao tocar no botão de busca de uma célula, o navegador integrado abre uma busca que encadeia as palavras do caminho (por exemplo: “aprender inglês compreensão oral shadowing”). Em comparação com uma busca de uma palavra só, os resultados alinhados ao contexto do seu objetivo tendem a aparecer antes.
• Encontrou uma página boa no navegador? Salve-a com o botão de marcador. Toque nele de novo para remover.
• Todas as páginas salvas de todos os seus diagramas ficam na lista de Marcadores da tela inicial, que mostra também em qual diagrama e em qual célula (caminho) você as encontrou.
• O motor de busca pode ser trocado em Ajustes (→ 6. Ajustes).

5. Exportar em Markdown (Obsidian / Notion)

• Exportar o diagrama: pelo botão de compartilhar da tela do diagrama, exporte o tema + os 8 elementos + seus itens como Markdown (.md) em formato de tópicos.
• Exportar os marcadores: pelo botão de compartilhar da lista de marcadores, exporte um Markdown organizado por diagrama e caminho. Também dá para compartilhar um marcador individual: toque e segure sobre ele.
• Você pode colar ou importar direto no Obsidian ou no Notion; o plano gratuito de qualquer um dos dois basta.

6. Ajustes

• Motor de busca: escolha entre Google (padrão), DuckDuckGo, Bing, Baidu e NAVER. Se preferir menos rastreamento, escolha o DuckDuckGo. O NAVER é melhor para resultados locais em coreano.
• Provedor de geração: escolha o provedor de IA na nuvem (Claude / Gemini / OpenAI / Qwen). Se houver chave salva de apenas um provedor, ele é usado automaticamente.
• Chaves de API: digitadas por provedor. As chaves ficam apenas nas Chaves (Keychain) do dispositivo e nunca são enviadas aos servidores do desenvolvedor. Para apagar uma chave, deixe o campo dela em branco e salve.
• Status do Pro e Restaurar compras: dá para verificar o status e restaurar a compra na tela de Ajustes.

7. Kuku Pro (compra única)

• A versão gratuita permite criar até 5 diagramas. A divisão de objetivos, a busca, os marcadores, a exportação, a IA do dispositivo e os modelos prontos estão todos incluídos de graça.
• O Kuku Pro (compra única, não consumível) desbloqueia diagramas ilimitados, o modo de IA na nuvem e a vista de mapa mental (expandida e com zoom). Não é assinatura.
• Se trocar de aparelho ou reinstalar o app, use Ajustes → Restaurar compras com o mesmo Apple ID da compra (em alguns casos, a restauração é automática).

8. Usar a geração com IA

IA do dispositivo (Apple Intelligence): grátis

• Nos aparelhos compatíveis (iPhone 15 Pro ou mais recente e outros dispositivos com Apple Intelligence), ative o Apple Intelligence no app Ajustes → Apple Intelligence e Siri.
• Na primeira vez pode demorar um pouco enquanto o modelo de IA é baixado (aparece a mensagem “O modelo de IA do dispositivo está sendo preparado”).
• Em dispositivos não compatíveis, os modelos prontos, a digitação manual e a IA na nuvem continuam funcionando.

IA na nuvem (Claude / Gemini / OpenAI / Qwen): Kuku Pro

1. Obtenha a chave de API do provedor que quiser usar. Os passos, os planos gratuitos e os pontos de atenção estão detalhados em uma página separada → Guia de chaves de API (em inglês)
2. Copie a chave emitida (se você a obteve num Mac, dá para colar direto no iPhone pela área de transferência universal, desde que os dois usem o mesmo Apple ID).
3. No Kuku, abra Ajustes → Chaves de API, toque no botão de colar ao lado do campo daquele provedor e salve (os espaços são removidos automaticamente e um aviso aparece se a chave for de outro provedor).
4. Escolha “Gerar com IA na nuvem (Pro)” na tela de novo diagrama ou em “Preencher células vazias com IA”, e a geração usará buscas na web.

Cada geração é enviada diretamente ao provedor escolhido usando a sua chave (nunca passa pelos servidores do desenvolvedor). As tarifas de uso da API são cobradas de você por esse provedor.

9. Solução de problemas

Sintoma	Causa e solução
A opção “Gerar no dispositivo” não aparece / não funciona	O dispositivo não é compatível com o Apple Intelligence, ou o Apple Intelligence está desativado. Verifique no app Ajustes → Apple Intelligence e Siri. Se aparecer “O modelo de IA do dispositivo está sendo preparado”, aguarde o download do modelo terminar.
“A proteção de segurança da IA no dispositivo recusou este conteúdo”	É uma recusa permanente do sistema de segurança da IA no dispositivo; esperar não muda nada. Pode acontecer, por exemplo, com nomes de pessoas reais. Mude a redação ou experimente a IA na nuvem (o mesmo conteúdo pode ser gerado sem problema).
A geração na nuvem falha com “Chave de API inválida”	Quase sempre é erro ao colar (espaços no início ou no fim, ou uma chave de outro provedor). Verifique a chave ou gere uma nova seguindo o guia (em inglês).
“Limite de uso da IA atingido”	É o limite de requisições do provedor. Aguarde um pouco, ou verifique o uso e a configuração de cobrança no console do provedor (os planos gratuitos têm limites baixos).
Comprei o Pro mas ele não ativou	Use Ajustes → Restaurar compras. É preciso estar conectado com o mesmo Apple ID usado na compra.
Os resultados de busca não abrem (China continental)	Da China continental não há conexão com Google / DuckDuckGo. Em Ajustes, troque o motor de busca para Baidu (se você não escolheu nenhum, ele vira o padrão automaticamente) ou Bing.

Se nada disso resolver, fique à vontade para escrever para support@kiribako.app.