A wiki - As suas notas, reduzidas a uma base de conhecimento
Capítulo 39: A wiki — As suas notas, reduzidas a uma base de conhecimento
Tem trezentas notas. Algures nelas está tudo o que sabe sobre a Acme Corp — a conversa sobre preços em março, a escalada em junho, o nome da pessoa que assina mesmo o contrato. Está tudo escrito, e nada está num só sítio.
A wiki é a resposta do SeaMeet a isso. Lê todas as notas da sua área de trabalho, percebe que pessoas, organizações e temas se repetem e escreve uma página por assunto: tudo o que o conjunto de notas sabe sobre a Acme Corp, na página da Acme Corp, com uma ligação de volta a cada nota de onde veio. Não arquiva nada. Não etiqueta nada. Continua a tirar notas como já faz, e a wiki acompanha.
Este capítulo cobre o que é a wiki, como construí-la, como ler uma página, como se mantém sozinha e — o que mais importa quando passa a depender dela — como dizer-lhe que se enganou.
O que é a wiki na realidade
Abra a pasta da sua área de trabalho no Finder ou no Explorador e encontrará um directório chamado _wiki/. É tudo. Lá dentro:
<a sua área de trabalho>/
├── Meeting · Jun 4.md ← as suas notas ficam no nível de topo
├── Q2 Reviews/
│ └── Acme Q2.md
└── _wiki/ ← a base de conhecimento gerada
├── index.md ← índice mestre de todas as páginas
├── log.md ← o que mudou, e quando
├── entities/ ← organizações, projectos, clientes
│ └── acme-corp.md
├── people/ ← as pessoas com quem se reúne
│ └── alice-cheng.md
├── topics/ ← temas que atravessam várias reuniões
│ └── pricing.md
├── meetings/ ← uma página por reunião gravada
└── .state/ ← a maquinaria (ver abaixo)
Cada página é um ficheiro Markdown simples com frontmatter YAML. Nada fica fechado numa base de dados. Se apagar o SeaMeet amanhã, a wiki continua a ser uma pasta de Markdown que pode abrir em qualquer editor, publicar com qualquer gerador de sites estáticos ou percorrer com grep a partir de um terminal.
Porque é que a pasta começa por um traço inferior. _wiki/ está escondida da árvore de notas de propósito — tal como .git e .obsidian. É saída gerada, e misturá-la na árvore de notas duplicaria cada entidade nos resultados de pesquisa. Percorre-a a partir do separador Wiki.
Porque é que as pastas têm um nome e aparecem com outro. No disco, os contentores chamam-se entities, people e topics. Na aplicação surgem como Organizations, People e Topics. O SeaMeet deduz estas etiquetas olhando para o seu conjunto real de notas e escreve-as em _wiki/.state/sections.json — a área de trabalho de um médico acaba com Patients onde a de um comercial tem Accounts. Os nomes de armazenamento nunca mudam, por isso uma wiki construída numa máquina continua a ler-se bem noutra.
Abrir a wiki
Clique em Wiki na navegação de topo, no grupo de conhecimento ao lado de Notes. A vista tem a mesma forma que Notes: uma árvore à esquerda, uma página ao centro.
Se nunca construiu uma wiki, o painel central mostra um cartão de introdução com dois botões — Take a Note e Start Recording — porque uma wiki sem fontes não tem nada a dizer. Assim que existirem páginas, o painel central passa a Wiki Home: uma caixa de pesquisa, uma linha de estatísticas, Top of mind (os assuntos com mais fontes por trás) e Updated this week.
A barra lateral recolhe com o chevron « e recorda a sua escolha entre sessões, tal como em Notes.
Construí-la a partir de uma pasta de notas
O botão ✨ no topo da árvore da wiki é Build wiki from all notes. Um clique e o SeaMeet percorre toda a sua área de trabalho, lê cada nota e escreve uma página para cada assunto que encontra. O mesmo botão está também na barra da árvore de Notes, por isso nunca precisa de mudar de vista para lançar uma construção.
É incremental, não uma reconstrução
Vale a pena interiorizar isto: a construção só paga o que mudou. Antes de enviar uma nota para a IA, o SeaMeet calcula um hash do corpo e compara-o com o hash da construção anterior. Idêntico? Salta — sem chamada à IA, sem custo. Mudou apenas uns quantos caracteres? Salta também, porque existe um limiar de diferença abaixo do qual reler não compensa.
Assim, o modelo mental honesto do botão ✨ não é «reconstruir a wiki». É «pôr em dia». Carregar nele numa área de trabalho de 300 notas em que editou quatro desde ontem lê quatro notas e reescreve as páginas que essas quatro tocam. Todo o resto fica exactamente como estava, incluindo o que escreveu de próprio punho.
O que o aviso lhe está a dizer
Enquanto a construção decorre, um aviso de progresso fica sob a barra de ferramentas. Passa por duas fases:
| Fase | O que mostra | O que está a acontecer |
|---|---|---|
| Leitura | Read 34 of 210 notes · 118 reused from cache | Cada nota está a ser lida e catalogada — quem e o que menciona. A contagem «reused from cache» é o atalho por hash a fazer o seu trabalho. |
| Construção | Built 12 of 47 pages · 1 failed | Cada assunto está a ser escrito numa página a partir de todas as notas que o mencionam. É aqui que as páginas aparecem na árvore por baixo. |
Sob o contador, o aviso nomeia o ficheiro em que está neste momento (Now reading: Acme Q2.md) e mantém uma lista curta e rolante do que acabou de terminar, cada item com ✓ ou ⚠. Se o fornecedor de IA obrigar o SeaMeet a esperar por um limite de débito, aparece uma pequena etiqueta rate limit: 41s em vez de o aviso parecer bloqueado.
Pausar, cancelar, retomar
Enquanto corre, dois botões vivem no aviso:
- Pause — pára depois do item actual. Passa a Continue, que retoma exactamente onde parou. Use-o quando quiser a sua largura de banda ou a ventoinha do portátil de volta durante vinte minutos.
- Cancel — termina o item em curso (para não deixar nada escrito a meio) e pára. O aviso mostra Cancelling — finishing the current note… enquanto encerra.
Uma execução cancelada deixa um marcador. Da próxima vez que abrir a vista Wiki, o aviso dirá A previous wiki build was interrupted at 88/210. Resume? com Resume, Restart e Dismiss. O mesmo acontece se a quota diária do seu fornecedor de IA se esgotar a meio: o SeaMeet guarda a sua posição, diz-lhe o que a travou e oferece Resume para depois de a quota reiniciar.
Quando uma execução termina em condições, o aviso passa a um resumo de uma linha — Wiki built — 210 notes, 47 pages — com Dismiss e Restart.
O empurrão
Não precisa de se lembrar de construir. Largue dez ou mais notas de uma vez na sua área de trabalho — uma importação, uma sincronização, uma pasta arrastada — e o SeaMeet levanta um aviso: 14 new notes since last build, com um botão Build wiki. Dispense o aviso e passa a ser uma faixa discreta dentro da vista Wiki, que espera até que actue.
Ler uma página
Uma página da wiki tem cabeçalho, duas regiões de corpo e rodapé.
O cabeçalho traz setas de recuar e avançar — a wiki mantém o seu próprio histórico de navegação, por isso seguir ligações e voltar funciona como num navegador —, o título da página e uma pastilha roxa AI Generated. Passe o cursor sobre a pastilha e transforma-se em Refresh from sources: uma reconstrução por página que relê apenas as fontes desta página e reescreve apenas esta página.
A secção de IA é a região de cima, marcada por um contorno esquerdo roxo. É o que o SeaMeet escreveu. É de leitura apenas na aplicação e, para um assunto bem documentado, vem organizada em subsecções — Overview, Facts, Recent activity, References — com factos atómicos em tópicos e prosa onde a narrativa se justifica.
Duas coisas lá dentro são clicáveis:
[[wikilinks]]— referências cruzadas a outras páginas da wiki, escritas como[[entities/acme-corp]]ou[[people/alice-cheng]]. Clique e salta para lá sem sair da vista Wiki. O SeaMeet só emite uma ligação quando a página de destino existe mesmo; um nome sem página ainda fica como texto simples em vez de se tornar uma ligação morta.- Citações de fonte em linha —
[source: acme-q2.md]depois de um facto. Clique e abre-se a nota que produziu o facto. Quando várias notas sustentam a mesma afirmação, ficam agrupadas num único parêntesis recto.
De vez em quando um facto virá prefixado com ⚠️ Conflicting: e as duas versões apresentadas. Isso acontece quando duas das suas notas dizem coisas diferentes e o SeaMeet se recusa a escolher um vencedor. É uma instrução de escrita, não uma passagem de verificação — o SeaMeet não anda a auditar as suas notas à procura de contradições, recusa-se apenas a achatar em silêncio uma com que tropeçou.
A secção do utilizador é a região de baixo, com contorno esquerdo turquesa. É uma caixa de texto simples, é sua, e grava sozinha cerca de um segundo depois de parar de escrever. Mais sobre ela adiante.
O rodapé tem dois grupos de etiquetas:
- Related pages — os
[[wikilinks]]encontrados na secção de IA. - Built from — todas as notas a partir das quais esta página foi escrita, lidas do frontmatter
updatedFromda página. Clique numa etiqueta e essa nota abre na vista Notes. É esta linha que torna a página de confiança: não «a IA diz que a Acme renova no Q4», mas «estas seis notas dizem-no, e aqui estão».
Regenera; não revê
Quando a página de um assunto é reconstruída, o SeaMeet não lê a página antiga para a editar. Reúne cada excerto sobre esse assunto de cada nota do catálogo e escreve a secção de IA de novo, do zero, substituindo a anterior por inteiro.
É deliberado, e é a diferença entre uma wiki e uma pilha de actualizações acrescentadas. Uma página remendada nota a nota arrastaria todas as frases obsoletas que ninguém se lembrou de retirar e só conheceria a reunião mais recente. Uma página regenerada a partir de todo o catálogo conhece as quarenta e sete reuniões de uma vez, deita fora o que já não é verdade e resolve «Alice», «A. Cheng» e «Alice Cheng» numa só pessoa.
A consequência prática: não edite a secção de IA à espera de que a sua edição sobreviva. Será sobrescrita na próxima reconstrução. O que quiser guardar vai para a secção do utilizador, ou volta como correcção — ambas explicadas abaixo.
Mantém-se sozinha
Raramente carregará em ✨ depois da primeira construção, porque a wiki mantém-se enquanto trabalha.
Quando escreve numa nota, o SeaMeet espera dois minutos depois de parar e decide então se a edição merecia reacção. Merecia se alguma destas for verdade:
- acrescentou cerca de 150 caracteres ou mais desde a última vez que esta nota disparou,
- acrescentou um novo
[[wikilink]], ou - acrescentou um novo título.
Caso contrário, não acontece nada. Corrigir uma gralha, apagar uma linha a mais, reformatar um marcador — nada disso dispara uma actualização. Pense «cada nota que acrescenta», não «cada tecla»: o teste de materialidade existe precisamente para que os retoques do dia-a-dia não queimem chamadas à IA. Há ainda um período de arrefecimento de dez minutos por nota, por isso uma sessão longa de escrita numa nota produz um punhado de actualizações, não cem.
Quando uma nota é lida, os assuntos que menciona ficam marcados como a precisar de reescrita. Em vez de reescrever cada um de imediato, o SeaMeet espera trinta segundos e junta tudo o que chegar nessa janela numa única varredura. Importe vinte notas e obtém uma varredura sobre os assuntos afectados, não vinte sobrepostas.
Quando uma gravação termina, a sua transcrição e o seu resumo de IA seguem o mesmo caminho — a reunião passa a ser uma fonte como qualquer nota, e as pessoas e temas discutidos fluem para as respectivas páginas.
A partir da árvore de Notes, clique com o botão direito em qualquer nota e escolha Update wiki from this note para saltar a espera por completo nessa nota.
Uma área de trabalho, uma wiki
Uma área de trabalho no SeaMeet é uma pasta no disco (Capítulo 13). A wiki vive dentro dessa pasta, em <área de trabalho>/_wiki/. Esse único facto resolve todas as perguntas sobre como as duas interagem.
Mude de área de trabalho no selector no topo da árvore e a árvore de notas, a árvore da wiki, o índice de pesquisa e a wiki são reenraizados em conjunto na nova pasta. A sua wiki de trabalho e a do seu projecto pessoal não partilham índice, não se ligam entre si e não conseguem deixar escapar o nome de um cliente para uma página sobre o seu projecto de fim-de-semana. Não há definição para isto nem nada a configurar — decorre de onde a pasta está.
A mudança é serializada: se já houver uma em curso, a seguinte espera que termine, por isso um duplo clique rápido nunca deixa as notas a apontar para uma pasta e a wiki para outra.
Uma excepção que vale a pena conhecer. As páginas geradas a partir de gravações ficam fixas na sua área de trabalho predefinida, por isso uma reunião gravada enquanto percorria uma área de trabalho secundária acaba mesmo assim na wiki que trata das suas reuniões.
Corrigi-la
Mais cedo ou mais tarde uma página dirá algo errado. O cargo de alguém está desactualizado, duas empresas de nomes parecidos foram fundidas, uma decisão provisória ficou registada como definitiva.
Não há botão Edit, porque uma edição na secção de IA não sobreviveria à próxima reconstrução. Em vez disso: seleccione o texto errado. Aparece uma janela flutuante no momento em que larga o rato sobre a secção de IA, a mostrar a frase que destacou e uma caixa a perguntar What's right? Escreva a correcção e prima Ctrl+Enter (ou Cmd+Enter). Esc fecha-a se seleccionou o texto por outro motivo.
Seguem-se duas coisas.
A correcção é guardada como verdade de referência. Com sessão iniciada, vai para a sua conta e acompanha-o em todos os dispositivos. Offline ou com a sua própria chave de API, vai para _wiki/.state/corrections.json, ao lado da wiki. Em qualquer dos casos não é um remendo aplicado à página actual — é uma instrução permanente que viaja com todas as reescritas futuras dessa página. Reconstrua a página daqui a um ano a partir de um conjunto de notas completamente diferente e a sua correcção continuará lá, e continuará a valer.
A página fura a fila. Os assuntos corrigidos passam para o início da próxima varredura de reescrita, à frente de tudo o que espera por edições normais. Sob a secção de IA aparece uma linha — Corrected by you — rewrite pending — o seu recibo de que a correcção chegou e a reescrita vem a caminho.
As duas regiões, e o que a IA nunca toca
Sob a secção de IA está a sua secção, de contorno turquesa, uma caixa simples onde pode escrever. É aqui que vão as coisas que o SeaMeet não pode saber: a razão real por que um negócio encravou, o facto de alguém preferir ser tratado pelo nome do meio, uma ligação para a unidade partilhada, a sua própria leitura de uma situação.
O SeaMeet escreve apenas entre os marcadores de IA e lê apenas entre os marcadores de utilizador. Uma reconstrução substitui toda a secção de IA e não toca num único carácter abaixo dela. Essa fronteira está imposta no próprio ficheiro — cada região é delimitada por comentários HTML —, por isso mantém-se mesmo que edite o ficheiro noutro editor, o sincronize pelo GitHub ou o restaure de uma cópia de segurança.
A divisão de trabalho que daí resulta:
| Secção de IA | A sua secção | |
|---|---|---|
| Quem a escreve | O SeaMeet, a partir das suas notas | Você |
| Sobrevive a uma reconstrução | Não — substituída por inteiro | Sim — nunca tocada |
| Como a muda | Submetendo uma correcção | Basta escrever |
| O que lá pertence | O que o conjunto de notas diz | O que só você sabe |
Encontrar coisas
- Filtrar a árvore — o ícone de funil na barra de ferramentas filtra nomes de página à medida que escreve.
- Quick Open —
Ctrl+P/Cmd+Pabre uma paleta que abrange notas e páginas da wiki, agrupadas por tipo, com um ícone de livro aberto a marcar os resultados da wiki. - Global Search —
Ctrl+K/Cmd+Kpesquisa em texto integral em notas, páginas da wiki, transcrições, resumos e OCR de capturas. Os resultados da wiki abrem na vista Wiki. - Wikilinks a partir de uma nota — escreva
[[em qualquer nota e o selector oferece páginas da wiki ao lado das notas, com o sufixo· wiki. - Localizar numa página —
Ctrl+F/Cmd+Fpesquisa nas duas regiões da página aberta e diz-lhe onde estão as ocorrências: 3 in note + 2 in AI section. Substituir só é oferecido na sua secção, já que substituir texto na secção de IA seria desfeito na próxima reconstrução.
Exportar
O ícone de transferência na barra de ferramentas exporta toda a wiki como um site HTML autónomo, um PDF ou ambos, com a opção de incluir as notas de origem. Útil para entregar um retrato a um cliente, arquivar um projecto ao fechá-lo ou ler tudo num avião.
O que exige subscrição
O trabalho de IA da wiki — ler notas e escrever páginas — corre sobre uma quota de IA paga, seja uma subscrição SeaMeet, seja a sua própria chave de API (Capítulo 35 e Capítulo 36). Concretamente:
- Ler e percorrer páginas de wiki existentes está sempre disponível. As páginas já no disco continuam legíveis, pesquisáveis e ligáveis, tenha ou não subscrição. A sua secção também — pode continuar a escrever nela.
- Construir e actualizar exigem quota. Sem ela, o botão ✨ mostra uma etiqueta de cadeado, as actualizações automáticas não disparam e a varredura em segundo plano não corre. Nada é apagado e nada se degrada; a wiki simplesmente deixa de aprender até haver quota outra vez.
Disposição da vista Wiki
┌──────────────────────────────────────────────────────────────────────┐
│ [Record] [Screenshot] [Memory] │ [Notes] [Wiki ●] │ [Files] [Cloud] │ ← Nav de topo
├────────────────────────┬─────────────────────────────────────────────┤
│ « Work ▼ ⚙ │ ‹ › Acme Corp [✨ AI Generated]│
├────────────────────────┤ │
│ Wiki ✨ ⤓ 📁 ⇅ ⌄ ⏷ ⚡│ ┃ Overview │
├────────────────────────┤ ┃ A Acme Corp é cliente de logística desde │
│ ┌────────────────────┐ │ ┃ 2024, agora em ciclo de renovação no Q4. │
│ │ Read 34 of 210 │ │ ┃ │
│ │ notes · 118 reused │ │ ┃ Facts │
│ │ ▰▰▰▰▱▱▱▱▱▱ 16% │ │ ┃ • Renovação a cargo de │
│ │ Now reading: │ │ ┃ [[people/alice-cheng]] │
│ │ Acme Q2.md │ │ ┃ [source: acme-q2.md] │
│ │ ✓ Beta Q2.md │ │ ┃ • ⚠️ Conflicting: 40 e 55 lugares em │
│ │ [Pause] [Cancel] │ │ ┃ reuniões diferentes │
│ └────────────────────┘ │ ┗━ contorno roxo = escrito pelo SeaMeet │
│ ▼ Organizations 12 │ │
│ 📄 Acme Corp ←──│ ┃ Your notes │
│ 📄 Beta Logistics │ ┃ A Alice está ausente até dia 20; o │
│ ▼ People 31 │ ┃ urgente segue pelo Dan. │
│ 📄 Alice Cheng │ ┗━ contorno turquesa = seu, nunca reescrito│
│ ▼ Topics 4 │ │
│ 📄 Pricing │ ───────────────────────────────────────── │
│ ▶ Meetings 88 │ 🔗 Related pages [alice-cheng] [pricing] │
├────────────────────────┤ 📝 Built from [Acme Q2.md] [Jun 4.md] │
│ ☁ Sincronizado há 30s │ ↑ cada nota de onde a página veio │
└────────────────────────┴─────────────────────────────────────────────┘
Resolução de problemas
«Cliquei em ✨ e quase nada aconteceu»
Normalmente é o comportamento correcto. A construção é incremental — se nada mudou desde a execução anterior, não há nada para ler nem para reescrever, e o aviso termina quase de imediato com uma contagem alta de «reused from cache». Para forçar a reescrita de uma página em concreto, abra-a e passe o cursor sobre a pastilha AI Generated para obter Refresh from sources.
Se o botão mostrou um cadeado em vez de um indicador de actividade, o problema é a quota de IA, não as notas — ver o Capítulo 35: Subscrição e facturação.
«Uma página diz algo errado e ando sempre a corrigir»
Provavelmente está a editar a secção de IA, que é substituída em cada reconstrução. Seleccione antes a frase errada e use a janela de correcção: isso persiste através das reconstruções e é tratado como autoritativo. O que for conhecimento seu, e não um conserto na leitura do SeaMeet, vai na secção turquesa por baixo, que nunca é sobrescrita.
«A página não actualizou desde que editei a nota»
Entre escrever e reescrever há três temporizadores, todos deliberados: dois minutos de sossego depois de parar, uma verificação de materialidade (cerca de 150 caracteres novos, ou um novo wikilink, ou um novo título) e um arrefecimento de dez minutos por nota. Uma edição pequena não disparar nada é legítimo. Para forçar: clique com o botão direito na nota → Update wiki from this note, ou abra a página da wiki e use Refresh from sources.
«A construção parou a meio com um erro»
Quase sempre a quota diária do seu fornecedor de IA. O aviso di-lo-á e terá guardado a sua posição — volte depois de a quota reiniciar e prima Resume. Retoma onde parou em vez de começar do princípio.
«Mudei de área de trabalho e a minha wiki está vazia»
É por desenho: cada área de trabalho tem a sua própria pasta _wiki/. As páginas que procura continuam na outra área — volte com o selector no topo da árvore. Uma área nova começa com uma wiki vazia até construir uma.
«Uma página que esperava não existe»
Um assunto só ganha página quando as suas notas dizem de facto algo sobre ele. Um nome mencionado uma vez de passagem fica como texto simples em vez de se tornar uma ligação para uma página vazia. Escreva uma nota que diga algo substancial sobre ele e deixe a actualização disparar, ou force-a pelo menu de contexto. Também pode clicar com o botão direito numa pastilha de wikilink não resolvida dentro de uma nota e escolher Sync wiki to generate this page.
Referência rápida
| Acção | Como |
|---|---|
| Abrir a wiki | Clicar em Wiki na navegação de topo |
| Construir de todas as notas | Clicar em ✨ na barra da árvore da wiki (ou de notas) |
| Pausar / retomar uma construção | Pause / Continue no aviso de progresso |
| Parar uma construção | Cancel — retomar depois pelo aviso |
| Reconstruir uma página | Passar o cursor na pastilha AI Generated → Refresh from sources |
| Actualizar a partir de uma nota | Botão direito na nota → Update wiki from this note |
| Corrigir uma frase errada | Seleccioná-la na secção de IA → escrever a correcção → Ctrl+Enter |
| Acrescentar conhecimento próprio | Escrever na secção turquesa Your notes — grava sozinha |
| Ver de onde a página veio | As etiquetas Built from no rodapé |
| Ir para uma página ligada | Clicar num [[wikilink]] da secção de IA |
| Recuar / avançar | As setas ‹ e › no cabeçalho |
| Abrir rapidamente uma página | Ctrl+P / Cmd+P |
| Pesquisar em tudo | Ctrl+K / Cmd+K |
| Localizar nesta página | Ctrl+F / Cmd+F |
| Filtrar a árvore | O ícone de funil na barra de ferramentas |
| Exportar a wiki | O ícone de transferência → HTML / PDF / ambos |
| Mudar para outra wiki | Mudar de área de trabalho no topo da árvore |
| Encontrar os ficheiros no disco | <a sua área de trabalho>/_wiki/ |
Em resumo: as suas notas continuam a ser a fonte da verdade, a wiki é uma vista delas que é regenerada em vez de remendada, e as duas alavancas que tem são as correcções (que mudam o que o SeaMeet escreve) e a sua própria secção (que o SeaMeet nunca escreve). Continue a tirar notas; o índice trata de si próprio.
Last updated: 2026-09-02
← Capítulo 38: Configuração do GitHub Sync | (fim do manual — voltar ao Índice)
Last updated: