Notas
Notas são documentos Markdown duráveis e independentes de chats ou tarefas Work. Use-as para resumos, registros de pesquisa, listas, rascunhos ou qualquer material que deseja preservar enquanto conversas e modelos mudam.
A página abre notas existentes em uma prévia somente leitura. Escolha Editar quando quiser alterar; as edições são salvas automaticamente após um breve intervalo. A lista pode ser pesquisada, notas fixadas permanecem em destaque e Cmd/Ctrl-K pesquisa o conteúdo próprio e compartilhado sem manter um índice em texto simples no disco.
Prévia Markdown e exportação
A prévia renderiza Markdown padrão, inclusive tabelas. Também aceita HTML e SVG básicos após sanitização: scripts, manipuladores de eventos e URLs inseguras são removidos antes de chegar à página.
Exportar baixa o conteúdo atual como .md. O arquivo é texto simples e não inclui anexos nem histórico de revisões; proteja-o como qualquer outra cópia.
Revisões e restauração
Cada mudança de título ou conteúdo cria um snapshot dos valores anteriores antes do commit. A guia Revisões mostra as versões retidas e uma diferença linha por linha em relação ao estado atual. Restaurar uma revisão antiga primeiro salva o estado atual, de modo que a própria restauração pode ser desfeita.
O Libre mantém as 50 revisões mais recentes por nota. Alterar apenas o estado fixado não cria revisão.
Anexos
A guia Anexos envia, lista, baixa e exclui arquivos associados. Uma nota comporta até 10 anexos de no máximo 10 MiB cada. Os bytes usam o armazenamento de blobs da plataforma sob a identidade do proprietário, portanto cota, criptografia, backup e exclusão seguem o perfil solo ou team selecionado.
Downloads reautorizam o acesso, usam private, no-store, são servidos como anexos com nosniff e não renderizam conteúdo arbitrário em linha. Atualmente o Libre não verifica malware nos bytes. Trate arquivos de outras pessoas como não confiáveis após o download.
Compartilhamento
O proprietário pode conceder a outro usuário autenticado:
- Leitura — abrir a nota, ver revisões e baixar anexos.
- Escrita — também editar, restaurar, gerenciar anexos e usar edição assistida por IA.
A autorização é verificada em cada solicitação, então revogar vale na próxima leitura ou gravação. Somente o proprietário pode fixar, compartilhar, revogar ou excluir. O papel global de administrador não dá acesso ao conteúdo privado.
Notas não são links públicos, e o editor não é colaborativo em tempo real: não há presença, cursor compartilhado nem protocolo de mesclagem para duas pessoas editando ao mesmo tempo.
Edições assistidas por IA
A guia Assistir envia uma instrução, o título e o Markdown atual ao modelo e provedor selecionados. O modelo retorna uma substituição completa, mostrada como diferença. Descartar não altera nada; Aplicar usa a atualização normal e preserva o estado anterior como revisão.
Gerar uma proposta não a persiste; aplicar, sim. Um provedor remoto recebe conteúdo e instrução sob seus termos de retenção, privacidade e cobrança. Escolha um modelo local quando a nota precisar permanecer na infraestrutura Ollama configurada. A instrução é limitada a 4.000 caracteres e a proposta deve caber no limite normal.
Notas como ferramentas de chat
Quando Ferramentas de chat estão ativas, modelos compatíveis podem usar:
list_noteseread_notepara notas próprias ou compartilhadas autorizadas;create_note, que exige aprovação por efeito colateral; eupdate_note, que também exige aprovação e salva o conteúdo anterior como revisão.
As ferramentas agem sob a identidade do usuário. Leem Markdown, não os bytes dos anexos. Chats anônimos não oferecem ferramentas.
Armazenamento, criptografia e portabilidade
Títulos, conteúdo e revisões retidas são criptografados em repouso pelo serviço da aplicação. Anexos usam o armazenamento de blobs criptografado. Essa é proteção no nível da aplicação, não criptografia de disco inteiro nem de ponta a ponta; proteja banco, blobs, backups e chaves como uma única fronteira.
O arquivo versionado por usuário inclui as notas atuais e o estado fixado, mas exclui deliberadamente histórico e anexos. Uma recuperação completa exige banco de dados, material criptográfico e armazenamento de blobs, não apenas o arquivo do usuário. Consulte Portabilidade de dados e Preparação para recuperação.
Limites
| Item | Limite |
|---|---|
| Notas próprias por usuário | 100 |
| Título | 200 caracteres |
| Conteúdo Markdown | 200.000 caracteres |
| Revisões retidas por nota | 50 |
| Anexos por nota | 10 |
| Tamanho do anexo | 10 MiB cada |
| Instrução de edição por IA | 4.000 caracteres |
API
Todas as rotas exigem sessão autenticada ou token de API com escopo notes. O acesso compartilhado segue as mesmas regras de leitura/escrita da interface.
| Método | Caminho | Finalidade |
|---|---|---|
GET | /api/notes | Listar notas próprias e compartilhadas |
POST | /api/notes | Criar nota |
GET | /api/notes/:noteId | Ler uma nota |
PUT | /api/notes/:noteId | Atualizar conteúdo, título ou estado fixado |
DELETE | /api/notes/:noteId | Excluir nota própria |
GET | /api/notes/:noteId/revisions | Listar revisões |
POST | /api/notes/:noteId/revisions/:revisionId/restore | Restaurar revisão |
GET | /api/notes/:noteId/attachments | Listar anexos |
POST | /api/notes/:noteId/attachments | Enviar anexo |
GET | /api/notes/:noteId/attachments/:attachmentId | Baixar anexo |
DELETE | /api/notes/:noteId/attachments/:attachmentId | Excluir anexo |
POST | /api/notes/:noteId/assist | Gerar proposta não persistida |