Referência / Coletar
Telegram · Chats secretos: configuração e gravação
Instale o complemento do protocolo de chats secretos, ative-o por conta e grave os chats que o TgWitness cria ou aceita.
O aplicativo publicado inclui o backend do Secret Chat, a integração com o coletor, rotas de API e a interface do Pseudo-secret. A biblioteca de protocolo é um módulo separado: abra o Pseudo-secret, clique em Instalar e ative-o. A aceitação automática de mensagens recebidas permanece desativada até que você a ative.
Módulo de protocolo#
| Módulo | kiaro-telethon-secret-chat 0.2.0 |
| Autor | KiaroSama |
| Licença | GPL-3.0 ou posterior; sua LICENSE e NOTICE permanecer dentro do arquivo salvo |
| Fonte | KiaroSama/Telethon-Secret-Chat no commit d87bf037b90060383c7b704d8a06ebb98c621c6f |
| Verificar | SHA-256 c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c sobre a lista de arquivos de pacotes e seus respectivos valores SHA-256 |
A opção Instalar e ativar está disponível para o administrador principal. O TgWitness baixa o
arquivo-fonte desse commit do GitHub por meio da rota do espaço de trabalho para solicitações
externas ao Telegram, compara cada arquivo do pacote com o valor definido na
versão do TgWitness, salva o arquivo como modules/telethon-secret-chat-<commit>.zip no
diretório de dados e carrega o código da memória. Não é necessário reiniciar. A verificação é executada
novamente a cada inicialização; um arquivo que apresente diferenças não é carregado e a página informa isso.
Um arquivo do pacote alterado, ausente ou adicionado faz com que a verificação seja reprovada.
O módulo é um trabalho independente, sujeito à sua própria licença. O TgWitness não o fornece: cada instalação o baixa do repositório do autor. Os detalhes na página mostram o módulo carregado, seu autor, licença, commit e SHA-256.
Um usuário sem acesso ao GitHub pode instalar o mesmo commit no ambiente Python em vez disso; o painel passa a utilizar essa cópia:
python -m pip install ".[secret-chats]"
O TgWitness torna-se um endpoint para os chats que cria ou aceita. Ele registra mensagens, anexos disponíveis, alterações no temporizador e avisos de exclusão no diário assinado. O conteúdo salvo anteriormente permanece disponível após um aviso de exclusão posterior.
Disponibilidade do pacote#
Em 8
de novembro de 2026
, o pacote instalador publicado foi verificado na fonte
b35f8e18f3d1
,
versão de lançamento b35f8e18f3d1-1ff85ec98bb2
, versão 0.9.1
preview.
O wheel imutável
e seu bloqueio de dependências passaram na verificação de assinatura de lançamento SHA-256
e RSA.
O backend e a interface empacotados corresponderam àquela revisão da fonte byte a byte.
O pacote também contém o registro da API e os hooks do coletor.
Esse pacote não continha a biblioteca de protocolo e ela não consta no
lock de dependências. O secret-chats "extra" no pyproject.toml fixa o mesmo
commit que o botão do painel.
Esta inspeção de pacote determina quais arquivos e declarações de dependência são fornecidos. O registro de validação identifica as verificações de tempo de execução separadas. O guia anterior, de 6 de novembro, descrevia um snapshot de desenvolvimento; ele não descreve mais o pacote acima.
Use a interface#
Abra o Pseudo-secret, instale o módulo caso a página o ofereça, ative-o para a conta e conecte-o. As solicitações recebidas aguardam aceitação, a menos que a aceitação automática esteja ativada. O início, a aceitação, o envio e o encerramento utilizam as permissões de interação da conta e a proteção somente leitura.
| Ação | Resultado preservado |
|---|---|
| Inicie um bate-papo pelo nome de usuário ou ID do usuário | Solicitação de saída; o par a aceita em seu dispositivo. |
| Aceitar uma solicitação | O TgWitness passa a ser o ponto de extremidade receptor. |
| Enviar ou receber uma mensagem | secret_chat.message, com sua direção, conteúdo e temporizador fornecido. |
| Receber um arquivo | Bytes descriptografados armazenados pelo SHA-256 e um recibo secret_chat.file; incluídos na exportação de evidências. |
| Receber um aviso de temporizador ou de exclusão | Um registro de ação separado, juntamente com mensagens e arquivos retidos. |
| Revise o chat | Conversas, recibos de arquivos, notificações e visualização de chaves. |
Bate-papos secretos existentes em outro dispositivo mantêm suas chaves específicas do dispositivo. Uma sessão na nuvem importada não transfere essas chaves. O material de chave do bate-papo secreto e os contadores utilizam o cofre do espaço de trabalho; mensagens preservadas e arquivos descriptografados utilizam as proteções normais de armazenamento do espaço de trabalho.
Encontrar mensagens salvas#
Use a função Pesquisar mensagens dentro de um chat aberto para encontrar uma frase exata, sem levar em conta as maiúsculas e minúsculas. As teclas Anterior e Próximo, ou “Enter” e “Shift+Enter” no campo de pesquisa, permitem navegar entre as mensagens correspondentes. O contador mostra o número de mensagens; a primeira frase correspondente em cada mensagem fica destacada. A tecla “Esc” limpa a pesquisa.
A função de pesquisa mantém visíveis a conversa ao redor, os arquivos salvos e os avisos de exclusão. Ela pesquisa os registros já carregados no painel. Quando ainda houver registros anteriores, o painel informa isso; a opção Carregar registros mais antigos amplia o histórico e atualiza os resultados da pesquisa, mantendo a mensagem atual no lugar.
Cada chat mantém sua pesquisa enquanto você alterna dentro do mesmo espaço de trabalho. Bloquear o painel ou mudar de espaço de trabalho limpa essas pesquisas. Os termos de pesquisa permanecem na memória da página e não são armazenados no armazenamento do navegador nem enviados como consultas de API. A pesquisa não envia mensagens do Telegram nem notificações de digitação ou leitura. As configurações de visibilidade existentes continuam regendo a abertura de um chat e outras ações.
O relatório de compilação mantém o escopo do relatório do chat selecionado; uma pesquisa na exibição não restringe automaticamente os registros exportados. Visualize a seleção do relatório antes de baixá-lo.
Controles de persistência e interação#
A implementação integrada utiliza a consulta de diário durável para detecção de duplicatas, mantém tarefas de anexo pendentes após um download malsucedido e encaminha o fechamento por meio do mesmo guard de interação que outras ações remotas. Isso substitui os três caminhos relatados na auditoria histórica do snapshot de desenvolvimento de 6 de novembro.
As mensagens descriptografadas cuja gravação no diário falha são mantidas no cofre para uma nova tentativa. As verificações de tamanho dos anexos e de espaço livre em disco adiam os downloads, mantendo, porém, as respectivas tarefas. O módulo reutiliza a conexão existente da conta. Avisos de leitura e digitação são enviados apenas conforme selecionado em O que o outro lado vê; notificações com captura de tela nunca são enviadas. Consulte secret_chats.py, rotas da API e política de acesso.
A auditoria histórica mantém suas conclusões originais do instantâneo. A disponibilidade e a implementação atuais devem ser consultadas na revisão do pacote acima e nos recursos atuais.
Demonstração da interface#
O cenário do site utiliza solicitações, mensagens e arquivos fictícios para demonstrar o fluxo de trabalho do painel. Trata-se de um exemplo de interface; as verificações de protocolo e aquisição possuem seus próprios resultados datados no registro de validação.