Pins, comentários e cores
Use pins numerados como referências estáveis entre screenshot, texto e contexto estruturado.
4 minNeste guia
Uma captura compartilhada
Cada badge numerado no screenshot corresponde a um comentário e a um registro de pin. A paleta rotativa separa marcadores próximos sem alterar sua identidade.
Preserve a correlação
Não reescreva captureId nem pinId ao enviar o pacote para outra ferramenta. Esses campos permitem que workspace, visualizador, resultado do agente e histórico de revisão apontem para a mesma captura.
Como números e identidades são atribuídos
Um pin só é salvo depois que o comentário é aparado e não fica vazio. Pins novos recebem um UUID, um número a partir de 1 na ordem da captura e uma cor da paleta de onze tons nesse número. Badges próximos diferem visualmente sem mudar a identidade que cada um guarda.
O contexto estruturado mantém pinId a partir do pinId ou id existente. Quando esses campos faltam, o analisador sintetiza captureId:pN a partir da identidade da captura e do número do pin. Ferramentas seguintes podem então apontar para o mesmo screenshot, comentário e linha de revisão.
- Um campo de comentário vazio não pode ser copiado; o foco permanece no campo até existir um comentário.
- Ao passar o cursor no marcador, a página mostra número, comentário e a confiança atual do localizador.
- Editar um pin existente atualiza só o comentário; o id armazenado permanece o mesmo.
Estrutura e evidência técnica
Cada pin de elemento também guarda um snapshot do que ele aponta: a árvore HTML do elemento, os estilos computados que diferem dos padrões do navegador, as fontes e os ícones que ele usa, e seu pai e irmãos. A Prévia renderiza os localizadores e as evidências armazenadas com o pin, enquanto o instantâneo completo permanece na captura armazenada e no payload completo do modo completo. Elementos grandes são aparados para caber no limite da captura, e o Markdown da sessão diz isso com uma contagem de nós truncada.
“Evidência técnica” lista fatos que a extensão observou na página enquanto você pinava: erros de console, requisições com falha e o ambiente (navegador, viewport, idioma). Cada item é classificado como “Após interação” quando aconteceu depois do seu último clique ou tecla, ou “Mesma página” quando só compartilha a página. Nada é inferido e nenhum crédito de IA é gasto; remova um item antes de compartilhar se ele não tiver relação.
- Pins de área não têm estrutura; use um pin de elemento quando o agente precisar de contexto DOM e localizadores resilientes.
- O prompt compacto padrão mantém os localizadores, o comentário e as evidências compactas; o instantâneo do elemento viaja com o bloco pinar-visual-context do payload completo e com o Markdown da sessão, acessível pelo link de contexto completo.
Editar notas e comentários no viewer
A discussão do pin no viewer oferece a nota original e os comentários da thread armazenados para edição. As regras diferem entre o workspace local e o Pinar Cloud.
O workspace local não tem login, então qualquer nota e comentário armazenado podem ser editados no viewer. No Pinar Cloud, o dono da sessão edita a nota, e um comentário humano é editável apenas por quem o escreveu. Comentários de agente nunca são editáveis no viewer.
- Uma edição salva por cima do texto armazenado e preserva a identidade, a autoria e o carimbo de tempo da mensagem.