Comentários e sugestões

Stand: 2026-09-10

Comentários e sugestões existem em todo cofre — com ou sem sincronização, com ou sem criptografia. Em um workspace criptografado são objetos assinados (veja Segurança e compartilhamento); em todos os outros levam o nome de Seu nome (anotações e revisões) nas configurações. Uma sugestão é um comentário com um texto de substituição: ambos passam pelo mesmo armazenamento, pela mesma coluna, pela mesma folha. Se o nome faltar, o Plainva pergunta uma vez no primeiro comentário; sem resposta, o dispositivo assina com o próprio rótulo (por exemplo “Dispositivo Windows 4f3a”). Suas próprias anotações aparecem como Você.

Comentários em uma nota

Commenter recebe um editor somente leitura com Comentários ao lado. Selecione um trecho do texto e escreva sua observação ao lado — o comentário fica preso a esse trecho e não ao documento. As respostas formam um tópico e Resolver o arquiva. Os comentários e os marcadores de resolução são, eles mesmos, objetos criptografados e assinados do workspace; a nota continua sendo Markdown puro e nenhuma resposta vai parar no seu histórico de versões. A coluna aparece e some com o botão Comentários na barra da nota — ele mostra o número de conversas abertas; o Plainva lembra sua escolha por vault e, fora isso, abre a coluna só quando a nota tem conversas abertas. O cabeçalho conta, filtra (Abertos · Todos) e silencia; cada cartão diz no topo quem escreveu e quando, e mostra suas ações ao passar o mouse ou selecioná-lo. Você pode excluir seu próprio comentário ou sugestão (lixeira no cartão, a pergunta é feita ali mesmo); proprietários e administradores podem excluir os de qualquer pessoa. Excluído significa oculto para todos — o registro selado permanece no armazenamento.

Digite um @ no campo de comentário e o Plainva sugere os membros do workspace; escolher um escreve o nome no comentário como texto comum. Um tópico que cita você sobe para o topo da coluna e recebe a marca Menciona você — um tópico resolvido não, ele não precisa mais de atenção. Menções nunca são armazenadas: elas são lidas do texto na hora de exibi-lo. Se alguém mudar de nome, comentários antigos seguem o novo; se sair do workspace, o destaque some e o texto digitado permanece exatamente como estava.

Para que um comentário reencontre seu trecho mesmo após alterações posteriores, o Plainva o envolve em comentários HTML invisíveis. Outros editores não os exibem; quem preferir não tê-los nos seus arquivos desativa Marcar os trechos comentados na nota em Conteúdo e estrutura — o Plainva passa então a localizar o trecho pelo texto citado. Se ele não for mais encontrado, o comentário diz isso em vez de apontar para qualquer lugar. No modo Ao vivo esses marcadores ficam invisíveis — mesmo na linha em que você está digitando; o cursor pula por cima deles. Só o modo Fonte os mostra.

Nem toda anotação se refere a uma frase. Um comentário pode igualmente ficar preso a uma imagem, a um diagrama, a uma célula de tabela ou a uma propriedade no painel de propriedades. Cada um tem a sua própria entrada: um pequeno balão na imagem ou no diagrama, um item no menu da célula, um ponto na linha da propriedade. Em uma imagem você pode ainda arrastar um retângulo para dizer que ponto quer indicar — um clique sem arrastar significa a imagem inteira. O cartão então nomeia aquilo a que está preso em vez de citar texto: “Na imagem”, “No ponto marcado da imagem”, “No diagrama”, “Célula · linha 2, coluna “Status””, “Sobre a propriedade ‘Status’”. Essas âncoras não escrevem nada na nota: o par de marcas acima é para trechos de texto, e uma imagem ou uma célula não precisa de nenhum. Uma célula de tabela mostra ao passar o mouse o mesmo balão que uma imagem; o menu da célula (clique direito) continua sendo o segundo caminho. Uma célula que já tem um comentário mostra, em vez disso, um pequeno triângulo no canto superior direito — um clique nele abre o cartão. Uma célula tem um comentário; quem quiser acrescentar algo responde no tópico dele. A partir de um banco de dados as duas funcionam diretamente: um clique direito em uma célula oferece Comentar propriedade (no telefone o item fica na folha que um toque na célula abre), e o pequeno balão com um número em uma célula abre a entrada exatamente naquela anotação.

A visão de leitura mostra as mesmas marcações do editor: trechos realçados, células comentadas com seu triângulo no canto e imagens com sua região marcada; um clique abre o cartão. Quando várias células de uma tabela têm comentários, cada uma delas traz seu triângulo.

As coisas se deslocam, e o cartão diz isso em vez de apontar para o lugar errado. Uma célula é reencontrada pelo que diz: uma linha inserida acima a desloca e o cartão nomeia a nova linha; uma célula que agora diz outra coisa diz exatamente isso. Uma propriedade que não existe mais nomeia o valor que carregava quando o comentário foi escrito — caso contrário a anotação continuaria legível, mas já não compreensível. Uma propriedade apenas renomeada o comentário reencontra pelo .base em que ela é mantida, e segue assim o novo nome. E uma propriedade comentada mostra o seu ponto também no banco de dados, não apenas na nota — caso contrário uma pergunta em uma coluna de status seria invisível para todo mundo que olhasse o quadro.

Sugerir alterações

Sugerir, ao lado de Ler, Ao vivo e Código-fonte, é o caminho para propor alterações: você digita em uma cópia da nota — o texto excluído fica riscado, o novo fica marcado — enquanto o arquivo em si não muda. Uma faixa acima da nota conta as alterações, aceita uma frase opcional para a rodada e oferece Descartar e Enviar sugestões. Enviar transforma cada bloco alterado em uma sugestão; uma inserção pura vira um ponto de inserção que fica entre duas palavras. Qualquer pessoa com direito de comentar pode sugerir, com ou sem direito de escrita. As sugestões de um envio chegam como uma rodada na aba Sugestões da coluna de comentários: a frase, o número de blocos e — enquanto mais de um estiver aberto — Aplicar tudo e Recusar tudo. Cada bloco ainda pode ser tratado sozinho com Aceitar ou Recusar; aceitar reescreve exatamente aquele trecho como uma edição comum, coberta pelo histórico de versões como tudo o mais. Se o texto mudou nesse meio-tempo, nada é escrito; você é avisado de que o trecho não corresponde mais. O próprio texto mostra uma sugestão aberta como o Word faz: o trecho riscado, a nova redação logo atrás, com Aceitar e Recusar ao passar o mouse; se preferir não ver isso, desligue Mostrar alterações no texto no cabeçalho da coluna. Sair da nota mantém sua cópia não enviada; abri-la de novo devolve você ao modo. Um clique em um trecho riscado ou na pílula de inserção no texto seleciona o cartão da proposta — a coluna muda para Sugestões e rola até ele; um clique no cartão salta para o trecho. Exatamente como nos comentários. Se você sair da nota, do vault ou do app antes de enviar, a cópia fica guardada neste dispositivo: na próxima abertura, Sugestões não enviadas encontradas oferece continuar ou descartar — se a nota mudou nesse meio-tempo, os blocos são reencontrados em seus lugares, e o que não tem mais lugar é anexado como observação.

Criar tarefa transforma um tópico em trabalho: o Plainva cria a tarefa no Banco de tarefas padrão — com o modelo dele, a pasta de destino dele e a coluna de concluído dele, exatamente como nasce ali qualquer outra tarefa. A primeira linha do comentário vira o título, o trecho citado fica como citação na tarefa e um link leva de volta à nota. O comentário em si permanece onde está e recebe uma resposta que nomeia a nova tarefa — e continua contando como aberto: o trabalho mudou de lugar, a conversa não. Sem um banco de tarefas padrão definido, o Plainva diz isso em vez de criar uma nota em algum lugar. A resposta aparece na hora, o link dela para a tarefa é clicável e o aviso oferece Abrir; o envio para uma lista do provedor acontece em segundo plano.

No celular

No telefone os mesmos tópicos ficam em uma folha em vez de uma coluna, e tocar no trecho citado salta até ele na nota. Ler, responder, resolver e decidir sobre sugestões também funciona ali, e as âncoras além do texto corrido também podem ser criadas lá — imagem incluindo o recorte (arrastado com o dedo), diagrama, célula de tabela e propriedade. Uma linha de propriedade é aberta ali com um toque longo em vez de um botão: a linha já é um botão em si, e um botão dentro dela a tornaria inutilizável. Um comentário em um trecho começa pela seleção no modo de leitura: selecione o texto e escolha Comentar ou Sugerir na barra acima. Propor alterações também funciona pelo menu — Sugerir no menu da nota abre o mesmo modo com a mesma faixa, e a folha mostra as rodadas em Sugestões com Aplicar tudo e Recusar tudo. Criar tarefa também está lá. A folha traz o mesmo cabeçalho, os mesmos cartões, a chave da exibição no texto e a exclusão; aplicar e recusar ficam ali na folha, não no texto. Um toque em um trecho destacado ou em uma proposta no texto abre a folha no cartão correspondente.

Notificações e visão geral

O Plainva pode avisar quando alguém escreveu algo — Configurações → Conteúdo e estrutura → Notificações de anotações. Fica desligado até você ligar, e o momento de ligar é a linha zero: nada anterior é anunciado depois, e de todo modo está na visão geral. Você escolhe sobre o que ser avisado: Somente menções, O que me diz respeito (o padrão — menções, respostas em tópicos em que você escreveu, anotações nas suas notas e decisões sobre as suas sugestões) ou Tudo. Duas coisas passam em qualquer ajuste, porque de outro modo se perderiam: quando um convidado de uma publicação respondeu e quando uma sugestão aguarda a sua decisão. O que você mesmo escreveu nunca lhe é anunciado. Uma mensagem por ciclo, não uma por anotação; só quando há exatamente uma nova é que a nota e a pessoa são nomeadas. Você silencia uma nota específica pelo sino na coluna de comentários, e um tópico resolvido nunca mais se manifesta.

Uma notificação aparece na tela de bloqueio, por isso o botão Mostrar a nota e o texto na notificação fica logo ao lado. Desligado, a mensagem diz apenas que algo chegou — sem nome, sem título da nota, sem texto. Se o vault estiver bloqueado, não há prévia de qualquer forma: a anotação chegou criptografada e nada pode abri-la antes. Isso não é um defeito, é a criptografia fazendo o seu trabalho. Um clique na mensagem abre a nota e destaca o cartão a que ela se refere; se forem várias, leva à visão geral. No telefone a mensagem chega mais tarde que no desktop, e isso não pode ser contornado: o Plainva não tem servidor que possa cutucar um aparelho — isso significaria um servidor alheio saber quando quem comentou qual nota. Por isso uma anotação é percebida onde um aparelho olha de qualquer maneira: num ciclo de sincronização. No desktop ele roda continuamente; o telefone percebe ao ser aberto ou ao voltar ao primeiro plano.

Comentários abertos reúne em um só lugar todos os tópicos não resolvidos do cofre — caso contrário você teria de abrir cada nota, uma a uma, para ver onde algo espera por você. No desktop você abre a visão geral pela barra de ações ou pela Paleta de comandos; no celular ela é uma seção própria, acessível por Seções e que você pode levar para a barra. Para mim mostra apenas os tópicos que citam você com @ — a mesma regra da marca Menciona você —, Todos mostra cada tópico aberto. Um clique em uma entrada abre a nota no trecho comentado. Tópicos resolvidos saem da lista: ela é uma lista de tarefas, não um arquivo.

Quando uma notificação agrupada relata várias anotações novas, seu clique abre a visão geral na aba Novos — exatamente os tópicos a que se referia; Todos e Para mim ficam ao lado.

Onde ficam as anotações

Sem workspace, as anotações ficam no cofre em .plainva/sync/, um arquivo por dispositivo, comments.<dispositivo>.json — selado como .enc quando existe uma frase-senha de sincronização. Nunca são gravadas na nota e nenhuma resposta vai para o histórico de versões dela. Cada dispositivo grava só o próprio arquivo e lê todos, por isso nada colide quando a pasta é compartilhada por Dropbox, iCloud, Syncthing, um compartilhamento de rede ou Git: os arquivos viajam como qualquer outro e, em um cofre Git, pertencem ao histórico. Uma conexão de sincronização do Plainva também os transporta. Todos os dispositivos devem ter a mesma versão do Plainva: uma mais antiga lê apenas o antigo arquivo compartilhado comments.json, que ainda é lido, mas não é mais gravado.

Quando o arquivo de outro dispositivo chega por uma sincronização externa, o desktop o mostra assim que a pasta avisa; o celular na próxima abertura ou ao voltar ao primeiro plano.

Se o cofre tem uma frase-senha de sincronização que não foi digitada neste dispositivo, as anotações estão bloqueadas: coluna, folha e visão geral dizem isso e oferecem Desbloquear. Até lá nada é lido ou gravado — um dispositivo bloqueado nunca coloca um arquivo em texto simples ao lado do selado.

Se você renomeia ou move uma nota (ou uma pasta inteira) no Plainva, as anotações a acompanham. O Plainva registra a movimentação mesmo antes do primeiro comentário ou enquanto o histórico anterior está bloqueado. Após reabrir ou desbloquear, comentários recebidos com atraso podem seguir as mudanças de caminho salvas. Se você reutiliza o nome antigo para uma nova nota, as anotações mais recentes dessa nota permanecem nela.

Esses registros locais contêm apenas mudanças de caminho e suas datas originais. Eles são preservados se um arquivo de comentários estiver danificado ou não puder ser atualizado; a sincronização transporta os marcadores no pacote habitual de comentários, criptografado quando uma frase secreta está ativa. Se o próprio registro local não puder ser salvo, a renomeação permanece e o Plainva avisa. Verifique o armazenamento e o acesso aos arquivos; as anotações podem permanecer sob o nome antigo em Comentários abertos.

Um arquivo de anotações que não pode ser lido nunca é sobrescrito: o próprio arquivo deste dispositivo é posto de lado intacto (comments.<dispositivo>.broken-<hora>.json), o de outro dispositivo fica onde está. O Plainva informa o motivo uma vez e oferece Exportar diagnóstico — caminhos e motivos, nunca o texto dos comentários.

Respostas simultâneas, marcadores de movimentação e a sincronização em andamento são mesclados ao gravar. Um arquivo ausente, vazio ou mais antigo na nuvem não remove observações já recebidas. Ao conectar um novo destino de sincronização, registros locais antigos e observações recebidas de outros dispositivos também são transferidos com os identificadores originais; cópias duplicadas aparecem como a mesma observação.

Antes de separar o arquivo danificado deste dispositivo, o Plainva lê o backup completo e o compara com o original. Se isso falhar, o original é preservado e novas observações não são salvas; o Plainva informa a falha no backup. Verifique o espaço livre e o acesso ao arquivo e envie novamente. Fontes sem criptografia só são removidas quando todo o conteúdo está em uma cópia criptografada legível neste dispositivo e no destino de sincronização. Uma fonte alterada nesse intervalo permanece até a próxima sincronização bem-sucedida.

Operações incompletas e decisões conflitantes

O Plainva registra neste dispositivo o progresso de cada operação de comentários. Se o texto está salvo, mas falta atualizar o comentário, um aviso oferece Tentar novamente. A nova tentativa continua as etapas pendentes sem desfazer o texto salvo nem a digitação posterior. Uma rodada de sugestões parcialmente enviada continua com as mesmas propostas; alterações posteriores na sua cópia de trabalho permanecem sem envio.

Se a nota mudou antes da confirmação do texto, abra Comparar texto. Compare a alteração planejada com o texto atual e edite a nota se necessário. A nova tentativa verifica novamente; um texto diferente nunca é substituído pela versão antiga.

Se dispositivos informarem decisões diferentes, o cartão mostra Decisões conflitantes. Use Revisar decisão para comparar a proposta com a nota atual. Confirmar como aplicado ou Confirmar como rejeitado confirma esse texto e substitui apenas as decisões já conhecidas aqui. A proposta não é inserida novamente. Uma decisão contrária antes desconhecida que chegar depois pode exibir um novo conflito.

Comentários anteriores em um espaço de trabalho

Desktop e dispositivos móveis usam o mesmo armazenamento de comentários assinados em um espaço de trabalho criptografado. Comentários escritos offline permanecem na caixa de saída. Após uma falha de envio, você pode tentar enviar o mesmo comentário novamente sem duplicar os já salvos.

Os comentários nos arquivos anteriores são preservados e importados com permissões de gerenciamento e de comentários. Do histórico anterior mantém o nome e a data originais. Essas informações não comprovam retroativamente a participação no espaço de trabalho; a nova assinatura confirma a importação. Se faltarem permissões, a nota de destino sincronizada ou um salvamento bem-sucedido, o comentário anterior continua visível. As ações de resposta, exclusão e sugestões ficam indisponíveis até que o destino seja atribuído de forma durável. A importação não reenvia as notificações do histórico anterior.

Se apenas o histórico anterior estiver bloqueado, a ação de desbloqueio abre o fluxo da frase secreta de sincronização; novos comentários continuam disponíveis. Se o próprio espaço de trabalho estiver bloqueado, a ação abre as configurações de segurança. Operações de sugestões iniciadas antes da atualização mantêm o progresso salvo e podem continuar com as permissões atuais. A importação não remove os arquivos originais de comentários.