NotariumDocumentação
Versão da documentação: latest
PT

Glossário

Definições curtas dos principais termos do Notarium. Cada termo leva à página onde ele é explicado por completo.

Armazenamento e identidade

file-first — o princípio de que a fonte da verdade são os próprios arquivos Markdown, no disco. O índice de busca, o grafo de links e tudo o que é derivado podem ser reconstruídos a partir dos arquivos; você pode pegar a pasta e ir embora a qualquer momento. Mais em File-first.

espaço (space) — uma base de conhecimento isolada, com seu próprio índice, grafo, busca, árvore, registro de revisões e lista de membros. Todo usuário tem um espaço pessoal que não pode ser excluído (nas páginas voltadas a agentes ele é chamado de domínio pessoal). Mais em Espaços e projetos.

projeto — uma entidade leve e opcional: uma pasta marcada com identidade estável dentro de um espaço (a marca é um dot-file na raiz da pasta). Um agente o endereça pelo handle space/slug. Mais em Espaços e projetos.

notarium-id — um identificador de nota estável, de 12 caracteres, no frontmatter. Ele sobrevive a mover e renomear o arquivo, então links e histórico nunca se quebram. Mais em Histórico de versões.

classe de nota — um conjunto de políticas de visibilidade e indexação derivado de onde a nota está armazenada (não é um campo de texto livre): user-doc (nota do usuário, visível em toda parte), agent-memory (memória do agente, indexada e acessível via recall, mas oculta das superfícies voltadas ao usuário), além dos internos attachment, derived e profile. Mais em Tipos de nota.

Acesso e agentes

principal — um sujeito de acesso generalizado: uma pessoa ou um agente de IA. Um único mecanismo de concessão para todos eles. Mais em Modelo de acesso.

papéis — participação em um espaço: reader (lê tudo), writer (edita notas), owner (gerencia a participação). Mais em Modelo de acesso.

PAT (Personal Access Token) — um token de acesso pessoal para agentes, enviado no cabeçalho Authorization: Bearer …. Ele carrega um escopo (read/write), restrição opcional por espaço e uma validade. O segredo é exibido exatamente uma vez. Mais em Conectar um agente.

gateway MCP — o endpoint POST /mcp embutido, pelo qual um agente de IA lê e escreve na base de conhecimento usando ferramentas orientadas a intenção (em vez de operações CRUD genéricas). As edições de um agente são versionadas, limitadas pelo acesso e assinadas com proveniência. Mais em Agentes e MCP.

ferramenta de intenção — uma ferramenta do gateway MCP que expressa uma intenção ("encontrar", "criar uma nota") em vez de uma operação CRUD de baixo nível no armazenamento. Mais em Ferramentas de intenção.

Busca

busca híbrida — uma fusão de três canais: léxico (texto completo FTS/BM25, sempre ativo), semântico (vetores, habilitado por uma flag) e um graph boost opcional. Os resultados são combinados pelo algoritmo RRF. Mais em Busca.

RRF (Reciprocal Rank Fusion) — um algoritmo que pondera e funde listas ranqueadas (léxico + semântico + grafo) em um único conjunto de resultados, sem uma escala de pontuação compartilhada. Mais em Busca.

degradação — uma funcionalidade recuando para uma variante mais simples quando suas dependências não estão presentes: se a stack vetorial está desligada ou indisponível, a busca continua funcionando sobre o texto completo (FTS) — sem erro e com o mesmo resultado. Mais em Configuração da busca.

Versões e proveniência

registro de revisões — o histórico de versões das notas no banco de metadados (não no git). Uma revisão é um snapshot completo do estado; estados idênticos são deduplicados por conteúdo. O registro é indexado por notarium-id, então o histórico sobrevive a mover/renomear. Mais em Histórico de versões.

proveniência — a atribuição de cada revisão: quem fez a edição e como — uma pessoa específica, um agente de IA específico ou um editor de arquivos externo. Mais em Histórico de versões.

Implantação

self-host — o modelo de implantação do Notarium: um único contêiner autossuficiente (Node/Fastify, motor no mesmo processo, sem serviços externos). A privacidade vem de você ser dono do servidor e dos arquivos, não de criptografia de ponta a ponta. Mais em Self-host.

Veja também