--- fragment_peers: avaliacao-de-atrito-e-limite-desta-etapa: friction-assessment-and-scope-boundary bancada-tecnica-local: local-technical-pilot certificado-e-acesso-individual: certificate-and-individual-access comparar-a-coordenacao-nao-o-tamanho-da-rede: compare-coordination-not-network-size conferir-a-atribuicao-antes-da-troca: check-attribution-before-exchanging-files escopo-da-bancada-tecnica: technical-bench-scope mcp-e-diagnostico-na-rede: mcp-and-network-diagnosis observar-o-trabalho-das-duas-pessoas: observe-both-peoples-work preparar-o-ambiente: prepare-the-environment primeiro-teste-site-ia-e-arquivos: first-test-site-ai-and-files rascunho-e-preparacao-formal-pelo-mesmo-caminho: drafts-and-formal-preparation-through-one-path usar-gemini-com-a-bancada-ja-configurada: use-gemini-with-the-configured-bench verificar-a-leitura-a-frio-inclusive-em-um-modelo-menos-capaz: check-cold-reading-including-with-a-less-capable-model lang: pt peer: en/pilot/ shared_fragments: false title: Bancada técnica local --- # Bancada técnica local O primeiro teste acompanha uma troca em que alguém formula uma contribuição, outro participante a lê e acrescenta algo, e o primeiro consegue recuperar a resposta. As orientações abaixo permitem experimentar esse percurso no Gemini com arquivos selecionados. A bancada técnica oferece um percurso opcional para examinar armazenamento por participante, preparação formal e acesso por MCP, usando uma máquina como servidor para os demais aparelhos na rede local. O certificado e as credenciais pertencem a essa instalação, enquanto o site público continua estático. A bancada não empacota coleções nem faz leitura contextual automatizada. ## Primeiro teste: site, IA e arquivos Para experimentar a adoção com Gemini no Android, comece por [seu primeiro rascunho](first-draft.md), com o guia geral de primeiro uso. Se já quer [participar de um espaço](get-started.md), escolha o anexo de participação. Use apenas um deles na conversa. Guarde os rascunhos onde já trabalha e selecione os arquivos que deseja compartilhar. O outro participante usa suas próprias orientações e contexto, prepara uma contribuição relacionada e escolhe o que devolver. Você recupera e considera a resposta. Basta o chat e a troca dos arquivos selecionados. Anote onde precisou de ajuda que o site não ofereceu; isso mostra o que as instruções ainda precisam resolver. [Veja o percurso](get-started.md). Este circuito por anexo não depende de uma conexão MCP nativa do Gemini. Na [documentação do Gemini consultada em outubro de 2026](https://support.google.com/gemini/answer/17209137?co=GENIE.Platform%3DAndroid&hl=en), apps MCP personalizados exigem conta pessoal, idade mínima de 18 anos, uso nos EUA, inglês e Keep Activity ativo. Portanto, a bancada MCP abaixo é um ensaio separado, não uma integração Gemini MCP pronta para este piloto no Brasil. ### Conferir a atribuição antes da troca Os [arquivos de exemplo](participation.md#exemplo-de-troca-uma-melhoria-de-software) permitem testar a diferença entre formulações independentes e uma solução que declara ter utilizado ambas. Peça à IA que explique o que cada autor assumiu e compare a resposta com os quatro arquivos. Verifique se o modelo conserva as origens e reconhece que semelhança não demonstra dependência. Em seguida, apresente uma decisão hipotética de aprovar a implementação. Verifique se a IA a distingue de um reconhecimento posterior por quem recebeu uma consequência. Não é necessário gerar um Nod para completar o exercício. Este é um caso fictício de avaliação das instruções; só o teste executado permite relatar como o modelo respondeu. ### Observar o trabalho das duas pessoas Escolham uma questão real e observem o que cada pessoa consegue acrescentar: uma condição desconhecida, uma correção de critério, uma hipótese ou um teste. Registrem o esforço para explicar o contexto, encontrar antecedentes, esclarecer dúvidas e retomar a resposta. As IAs podem ajudar em qualquer dessas atividades; o interesse é avaliar a colaboração que os recursos tornam possível. Se compararem com seu fluxo habitual, mantenham o mesmo acesso a pessoas, informações, modelos, canais e testes automatizados. Nos dois percursos deve ser possível tomar iniciativa sem tarefa atribuída. Observem o que a preservação e as relações explícitas acrescentam, incluindo seu custo, e se cada pessoa encontra razões para continuar contribuindo. Um teste técnico bem-sucedido não responde sozinho a essas perguntas. ### Verificar a leitura a frio, inclusive em um modelo menos capaz Depois de guardar um rascunho real selecionado pelo autor, abra uma conversa nova, sem o histórico original, e anexe somente o guia de primeiro uso e esse rascunho. Peça ao Gemini que identifique a formulação, quem a assumiu, o que permanece incerto e quais relações estão **declaradas**; repita com outro modelo ou configuração disponível, sem acrescentar explicações. Inclua no conjunto um trabalho parcial ou uma hipótese corrigida. Anote omissões, autorias trocadas, relações inventadas e o esforço de revisão. A leitura correta de um exemplo não certifica o modelo nem o protocolo; uma falha orienta melhoria do rascunho ou das instruções, sem autorizar inventar dados faltantes. ## Escopo da bancada técnica Os passos seguintes verificam armazenamento, preparação e limites de acesso dos componentes de referência. A facilidade de começar pelo site, a fidelidade das descrições produzidas pelo Gemini e o benefício da colaboração precisam ser observados nos testes de uso. ## Preparar o ambiente Uma máquina hospeda os arquivos e executa o servidor durante o teste. Os demais aparelhos acessam pelo navegador. No Android, não é necessário instalar Rust. Use as pastas locais [protocol](https://github.com/LegibleProtocol/protocolDev) e [website](https://github.com/LegibleProtocol/websiteDev), com as fontes da mesma edição. A primeira contém os componentes da bancada; a segunda, as páginas e o gerador do site. As obras usadas na geração vêm do repositório [publications](https://github.com/LegibleProtocol/publicationsDev). Obtenha as fontes nos repositórios indicados ou use cópias locais correspondentes à mesma edição. Use Python 3.11+, Rust 1.88+ e OpenSSL que aceite a opção req -addext. Reutilize as dependências já instaladas. A preparação local já inclui as dependências do protocolo e das obras; ao começar com três pastas separadas, execute `python3 tools/attach_protocol.py --source ../protocol` e `python3 tools/attach_publications.py --source ../publications` a partir de website. Na pasta website: ~~~sh cargo build --manifest-path protocol/reference/legible-core/Cargo.toml python3 -m venv .venv .venv/bin/python -m pip install -r site/requirements.lock .venv/bin/python site/legible_build.py --mode preview export PYTHONPATH="$PWD/protocol/reference/legible-mcp" export LEGIBLE_BIN="$PWD/protocol/reference/legible-core/target/debug/legible" .venv/bin/python -m legible_mcp.pilot init --runtime "$PWD/.local/pilot" --lan-host IP_DO_WIFI --participant seu-id --participant outro-id .venv/bin/python -m legible_mcp.pilot doctor --runtime "$PWD/.local/pilot" .venv/bin/python -m legible_mcp.pilot serve --runtime "$PWD/.local/pilot" --bind 0.0.0.0 ~~~ Troque seu-id e outro-id pelos identificadores dos dois participantes: letras minúsculas sem acento, números e hífens simples. Esses identificadores nomeiam os espaços privados e a autoria declarada dos rascunhos; não são DIDs nem prova de identidade civil. Em um ensaio fictício, use participante-a e participante-b; escolha os identificadores reais apenas no seu ambiente privado. Ambientes já criados não são renomeados nem sobrescritos. Troque IP_DO_WIFI pelo endereço da máquina na rede. No Mac, consulte ipconfig getifaddr en0 ou as configurações de Wi-Fi. Inicialize apenas uma vez; o comando se recusa a sobrescrever um ambiente existente. O site fica em https://IP_DO_WIFI:8443/pt/ e o fluxo privado em https://IP_DO_WIFI:8443/pilot/. Para inglês, use /en/ no site e /pilot/?lang=en na página do piloto. O endereço MCP é https://IP_DO_WIFI:8443/mcp. Não abra a pasta de trabalho por um servidor genérico. Os aparelhos precisam estar na mesma rede, com comunicação entre dispositivos permitida. Mantenha a máquina acordada e autorize este processo Python no firewall apenas para a rede local de confiança. Não encaminhe portas ao exterior. ## Certificado e acesso individual O servidor cria um certificado HTTPS local de 30 dias. Ele não é uma chave de assinatura de registros. Transfira somente tls-cert.pem do diretório privado para os aparelhos de teste, por um caminho de confiança. Compare a impressão: ~~~sh openssl x509 -in .local/pilot/tls-cert.pem -noout -fingerprint -sha256 ~~~ Reconheça esse certificado nas configurações do navegador/sistema. No Android, procure instalação de certificado e credenciais: a confiança é para HTTPS, não para autenticação Wi-Fi. Os menus variam; aparelhos gerenciados podem impedir isso. Confirme a confiança no aparelho real antes de usar dados sensíveis. Não desative a verificação TLS do cliente MCP. Remova a confiança do piloto quando o teste acabar. O servidor não altera essas configurações automaticamente. Se o IP mudar, pare e configure outro ambiente, preservando os arquivos anteriores. Cada pessoa recebe somente o arquivo .local/pilot/SEU_ID-access.json que lhe corresponde, por um canal de confiança. Na página, cada pessoa cola seu browser_token. A credencial mcp_token é diferente e serve apenas ao MCP. Não cole credenciais no Gemini nem as inclua em URLs ou capturas de tela. Recarregar ou sair da página limpa a credencial daquela sessão no navegador, mas não revoga uma cópia do token; para revogar, pare o servidor e substitua o segredo correspondente na configuração privada. Os espaços privados não se misturam. Compartilhar copia a versão escolhida para o espaço do destinatário, preservando origem, autoria declarada e bytes. Quem administra a máquina hospedeira continua podendo ler seus arquivos; o isolamento testado é entre pedidos dos participantes pela aplicação. Não há criptografia em repouso ou proteção contra administrador/malware. ## Usar Gemini com a bancada já configurada 1. Entre na página local com sua credencial. 2. Anexe o arquivo único de primeiro uso e copie a instrução do site para o Gemini. Se não conseguir anexar, cole o conteúdo. Não peça ao Gemini para abrir um endereço privado da sua rede. A instrução da bancada é um auxílio para o trabalho, não substitui o material de referência. 3. Trabalhe no seu software, relatório, estratégia ou outro resultado habitual. Peça uma proposta pequena sobre uma direção, critério, correção de rota ou julgamento que realmente fez. O conhecimento tácito pode exigir perguntas. 4. Cole o Markdown proposto na página local. Revise autoria, formulação, referências e contexto. Guarde privadamente ou descarte; nada foi enviado ao outro participante. 5. Escolha uma versão e o destinatário. Leia o diálogo antes de compartilhar. 6. A outra pessoa atualiza a lista, lê e prepara sua contribuição relacionada. Ela compartilha a resposta escolhida; a primeira recupera e considera. O Gemini é o provedor escolhido pelos participantes. Só envie contexto que possa ser processado por ele. O servidor não chama modelos, sincroniza Drive ou envia automaticamente arquivos ao Google. Anexos e integrações dependem da conta. Drive exige condições de atividade, conexão Workspace e, em contas de trabalho, administração. Apps MCP personalizados têm restrições atuais de região, conta e idioma; o piloto não depende dessa conexão. Consulte [anexos no Android](https://support.google.com/gemini/answer/14903178?co=GENIE.Platform%3DAndroid&hl=en) e [apps personalizados](https://support.google.com/gemini/answer/17209137?hl=en). ## Rascunho e preparação formal pelo mesmo caminho Os rascunhos usam Legible Draft, com os campos técnicos Genealogy 0.1. O mesmo armazenamento e o mesmo core Rust atendem à página e ao MCP. Não há conversão do rascunho em declaração assinada. Para preparar uma declaração formal, selecione seu rascunho, informe seu DID público Ed25519 e revise o conteúdo proposto. A associação do DID ao login é declarada; não prova controle da chave. Para Appoint, há uma proposta editável. Trace e Nod exigem preenchimento explícito, para que a ferramenta não presuma peso, dependência ou consequência. O resultado é um arquivo novo, não assinado, com referência ao hash dos bytes do rascunho. Confira o arquivo exato e baixe-o para seu ambiente confiável. A assinatura segue o caminho de terminal já documentado no pacote, fora do servidor. É válido guardar o registro assinado privadamente. Assinatura móvel nativa, importação e compartilhamento de registros assinados pela página não fazem parte desta entrega. ## MCP e diagnóstico na rede Um segundo desktop pode testar o endpoint com o cliente de diagnóstico das fontes, seu próprio arquivo de acesso e o certificado público: ~~~sh export PYTHONPATH="$PWD/reference/legible-mcp" python3 -m legible_mcp.probe --url https://IP_DO_WIFI:8443/mcp --access /CAMINHO/PRIVADO/SEU_ID-mcp-access.json --ca /CAMINHO/tls-cert.pem ~~~ Execute a partir da raiz do protocolo. O resultado informa TLS, edição negociada, ferramentas e quantidade de rascunhos acessíveis, sem mostrar segredos ou conteúdo. O cliente de IA deve aceitar Streamable HTTP, cabeçalho Bearer individual e confiança no certificado local. O formato de configuração varia por cliente; o diagnóstico não certifica um host externo. O perfil local de credenciais não implementa OAuth MCP. A conexão nativa Gemini–MCP local continua não verificada. O transporte HTTP oferece respostas JSON e negocia 2025-03-26, 2025-06-18 e 2025-11-25. Não há SSE. Consulte o [guia técnico no repositório do protocolo](https://github.com/LegibleProtocol/protocolDev/blob/main/docs/local-pilot.md) para o contrato de sessões, ferramentas, assinatura e limites do ambiente. Se o cliente desktop já usa stdio, configure a ponte local legible_mcp.lan_stdio para o endpoint HTTPS. Ela usa o mesmo armazenamento e perímetro, sem abrir diretamente os diretórios privados. O template completo está em `docs/local-pilot.md` no repositório do protocolo. Entregue ao cliente somente SEU_ID-mcp-access.json, nunca o arquivo de acesso do navegador. Não rode dois processos escrevendo diretamente no mesmo espaço. ## Avaliação de atrito e limite desta etapa Use um trecho curto de trabalho real. Marque tempo, trocas de aplicativo, correções da proposta e dúvidas de permissão. Verifique: - reenvio idêntico sem duplicação; - resposta da pessoa B com autoria própria, recuperável pela pessoa A; - reformulação substancial como novo Appoint e Trace separado; - sessão compartilhada com autoria ambígua explicitada, não adivinhada; - referência à evidência privada sem acesso liberado ao outro participante; - preparação formal guardada privadamente, sem assinatura ou envio automáticos. Para evidência restrita, comece com um texto fictício pequeno: guarde na área privada da página e cite o hash. Arquivos reais podem permanecer no armazenamento que já usam; a página não os busca. Busca nesta etapa é literal, não inferência. ## Comparar a coordenação, não o tamanho da rede As pessoas A e B podem comparar dois percursos curtos: boas notas convencionais com IA; e contribuições preservadas e relacionadas com Legible. Mantenham as mesmas pessoas, modelos, informações, permissões, canais de contato e orçamento de tempo. Ambos podem contribuir sem tarefa atribuída. Não comparem uma rede com alguém isolado, nem forneçam só a um percurso acesso a fontes úteis. Usem situações de dificuldade semelhante e alternem a ordem dos percursos, anotando diferenças e aprendizado entre tentativas. No piloto com duas pessoas, essa comparação é exploratória, não uma estimativa causal ou prova de superioridade. Avaliem separadamente o efeito da preservação, das relações explícitas e da possibilidade de iniciativa sem alocação; não atribuam todo resultado ao formato. | Resultado observado | O que anotar | |---|---| | Correção técnica | Formato, origem, relações, reenvio, isolamento e esforço de correção | | Facilidade de participação | Tempo para ler e trocar, aplicativos, pedidos de ajuda e limites de acesso | | Coordenação aberta | Ocasião de contribuir encontrada sem convite, mudança do problema, alternativa inesperada ou reconsideração após recusa | | Sustentação da participação | Benefício relatado por cada pessoa, esforço total e disposição de continuar contribuindo | Deixem a pessoa B decidir se quer acrescentar algo à formulação recebida, inclusive por um caminho diferente do escolhido por A. Atribuir-lhe uma tarefa apenas para obter o resultado esperado retiraria do teste a iniciativa que se pretende observar. Separem sugestões da IA, declarações dos participantes e evidências. Anotem também a ausência de resultado útil, sem fabricar Nods ou deduzir desinteresse da falta de registros. A participação de uma terceira pessoa fica como extensão do piloto. A busca local procura termos literais; a pertinência contextual pode ser examinada no chat com os arquivos selecionados. Registrem o atrito encontrado para orientar ajustes nas ferramentas e nas instruções. Se a busca encontrar uma entrada ilegível, a página mostra um aviso persistente e lista as íntegras. Confira o arquivo e o hash indicados; a falha não apaga a contribuição. Diferenças apenas de quebra de linha recebem explicação própria, sem substituição automática do original. Origem e autoria de rascunhos seguem declaradas, não autenticadas. [Configuração geral](configurations.md) · [Formato e estados](drafts.md)