TgWitness / Documentação

O que foi testado →

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.

TgWitness / Documentação

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.