TgWitness / Documentação

Referência / Arquivo e integrações

Análise de arquivos

Pesquise mensagens salvas, analise contribuições de IA e mantenha relatórios analíticos com suas referências de fonte.

Versão principal atual: utilize uma cópia do código-fonte; a versão prévia portátil 0.7.0 é anterior a esse recurso.

Guia de fluxo de trabalho · Wiki

Use o Diário para pesquisa local sem IA. Para usar Consulte o arquivo, primeiro habilite e configure um provedor em Integrações. O seletor de área de trabalho escolhe a conta; o formulário seleciona os chats e o período de observação. A recuperação é executada localmente. Uma frase exata ou um domínio restringe a recuperação; um ID de mensagem solicita versões salvas. Analise os trechos e abra seus registros no diário ou o contexto. Não há banco de dados vetorial nem ação automática no Telegram.

A IA vem desativada em todos os espaços de trabalho. Somente o administrador principal pode configurar o modelo, o endpoint, a chave de API criptografada, os limites de contexto/saída, o tempo limite e o limite diário de solicitações. A chave nunca é devolvida ao navegador. Deixe o campo da chave em branco para manter a chave atual ou remova-a explicitamente.

O Ollama utiliza seu endpoint /api/chat documentado com saída JSON sem streaming. Seu endereço padrão é http://127.0.0.1:11434 no servidor do TgWitness. O operador pode alterá-lo usando TGWITNESS_AI_LOCAL_ENDPOINT; este não é um endereço controlado pelo modelo. Instale você mesmo o modelo selecionado. O TgWitness não o baixa automaticamente.

O provedor compatível espera uma URL base terminada em /v1 e o protocolo Chat Completions: messages, modo de resposta JSON, max_completion_tokens e choices[0].message.content. Serviços que não possuam esses campos não são suportados. O teste de conexão envia texto sintético e conta para o limite de solicitações.

Cada solicitação utiliza a rota externa configurada no espaço de trabalho. Uma rota bloqueada ou um MTProxy exclusivo para o Telegram resulta em erro; não há repetição direta da tentativa. Um endereço Ollama local deliberadamente configurado permite um destino privado, mantendo o uso da rota escolhida. Para outros serviços privados, aplica-se a opção de adesão ao destino privado no nível do servidor já existente. O painel exibe o endpoint efetivamente configurado.

Antes da geração, os dados enviados ao modelo mostram a solicitação: pergunta, trechos marcados, tipos de eventos, horários de observação e marcadores de cobertura. Sessões do Telegram, campos brutos, chaves de provedores, bytes de anexos e o diário completo não fazem parte desse contexto. Desmarque as fontes indesejadas e, em seguida, aprove explicitamente o processamento. Provedores externos podem reter o conteúdo enviado de acordo com suas próprias políticas. Execução local significa que o endpoint é local; isso não é uma garantia quanto ao comportamento de um serviço configurado de forma independente.

Há, no máximo, duas solicitações simultâneas ao provedor globalmente e uma por espaço de trabalho. Uma pré-visualização expira após dez minutos e pode gerar uma resposta. São exibidas as contagens de tokens informadas pelo provedor; uma estimativa de custo aparece somente quando as tarifas de entrada e saída tiverem sido configuradas. Tentativas malsucedidas também consomem o orçamento diário de solicitações. Nenhuma nova tentativa automática gasta orçamento adicional.

Fontes e limitações#

A recuperação examina o texto das mensagens salvas por meio de uma busca lexical delimitada. Ela retorna até 24 fontes e sinaliza trechos truncados ou conjuntos de resultados incompletos. O período refere-se ao tempo de observação, não a uma afirmação de que o histórico do Telegram seja completo. Eventos com cobertura em todo o espaço de trabalho são excluídos do acesso restrito ao chat. Dados ausentes são descritos como “não encontrados” no arquivo disponível.

O modelo não recebe ferramentas. Seus IDs de origem são verificados em relação aos registros selecionados, os hashes são verificados novamente e as sequências citadas devem constar nesses registros. IDs desconhecidos, citações alteradas e alegações sem referência invalidam a resposta. O aplicativo cria links; URLs gerados pelo modelo não são usados como citações. Essas verificações comprovam a existência da fonte e a precisão da citação, não a veracidade de uma inferência. Analise as inferências em relação aos registros antes de confiar nelas.

Relatórios#

Salve uma resposta revisada como um relatório analítico separado. Ele inclui o resumo do modelo, a cronologia observada, links e identificadores extraídos, registros de edição/exclusão, limites de cobertura e hashes dos eventos de origem. O provedor, o modelo, o endpoint, a hora e a versão do modelo de prompt acompanham o relatório. Nenhuma identidade é combinada automaticamente.

As revisões e anotações dos analistas são armazenadas separadamente do resumo do modelo. Os relatórios ficam em arquivos derivados criptografados, com um índice fora do fluxo de eventos assinado; os eventos e mídias originais não são alterados. Somente o proprietário ou administrador pode abrir um relatório, e o acesso à fonte é verificado novamente. O download também requer permissão de exportação. A versão 1 não assina relatórios nem sugere que as conclusões do modelo sejam evidências verificadas. Limites: 100 relatórios por espaço de trabalho e 100 revisões de analistas por relatório.

Para OCR manual e transcrições, consulte o processamento de mídia. Para acesso de clientes, consulte o MCP.