telegram chat summarizer

Telegram 聊天摘要應用程式

您是否厭倦了每天瀏覽大量 Telegram 訊息來尋找有價值的資訊？救贖就在這裡！

此儲存庫託管 Telegram 應用程式的實現，用於監視和匯總群聊。它最初是為個人用途而創建的，適用於需要從一個或多個即時大規模 Telegram 群聊中收集資訊的人，這些群組聊天會產生太多訊息而需要手動查看。

根據給定的配置：

1. 使用 Telegram API 監控一組給定的 Telegram 群聊。
2. 匯總定義的回溯期內受監控的聊天（即，如果您將回溯期設定為 12 小時，您將每天兩次收到過去 12 小時的摘要）。目前僅分析簡訊。
3. 使用 Bot API 將摘要傳送給一組給定的 Telegram 使用者。
4. 對於每個發送的摘要，應用程式都會保留摘要上下文，直到下一個摘要，以便使用者可以針對摘要提出澄清問題。

安裝

1. 使用本指南取得 Telegram API 的api_id和api_hash值。
2. 使用本指南建立 Telegram 機器人並取得其令牌。
3. 從此處取得 OpenAI API 金鑰。目前，該應用程式具有 OpenAI 後端硬編碼（ gpt-4-turbo-preview模型），但很容易將其替換為您選擇的後端，因為它是透過 LangChain 庫調用使用的。
4. 編寫聊天摘要提示。使用examples/夾中的資料夾作為參考。
5. 定義配置並將其儲存到config.json檔案中：

{
  "telegram_api_id" : <api_id>,
  "telegram_api_hash" : " <api_hash> " ,
  "openai_api_key" : " <key> " ,
  "telegram_bot_auth_token" : " <token> " ,
  "chats_to_summarize" : [
    {
      "id" : " <group chat ID or name> " ,
      "lookback_period_seconds" : 86400 ,
      "summarization_prompt_path" : " prompts/example_summarization_prompt.txt "
    }
  ],
  "telegram_summary_receivers" : [
    " <Telegram username> "
  ]
}

5. 安裝在requirements.txt檔案中定義的Python需求或建置Docker映像：

python3 -m pip install -r requirements.txt

或者

docker build -t tcsa:latest .

6. 運行應用程式：

python3 app.py config.json

或者

docker run -it tcsa:latest

第一次運行時，應用程式會要求您登入使用的 Telegram 帳戶，如下所示：

user@pc: ~ /telegram-chat-summarizer $ python3 app.py config.json
2024-03-27 23:03:11,618 - INFO - Started !
Please enter your phone (or bot token): < phone number >
Please enter the code you received: < OTP >
Please enter your password:

然後會話將儲存在磁碟上，後續運行將不需要身份驗證。

用法

應用程式啟動並運行後，每個摘要訂閱者都需要向機器人發送/verify訊息，以便它可以註冊用戶。

機器人可以透過提供命令/<summarized chat name>來切換對話上下文（聊天名稱可以是配置中定義的任何名稱）。如果您有多個聊天被總結，請使用此機制：透過給予相應的命令，您可以將 LLM 上下文切換到不同的聊天並討論該聊天的摘要。

實施細節和限制

實作非常簡單，肯定還有改進的空間。一些即時的好東西（歡迎 PR！）：

1. 用於使用者驗證和聊天上下文的磁碟儲存持久性。
2. 擺脫摘要訂閱機制，轉而採用較不不便的機制。
3. 透過機器人進行基本應用程式管理（摘要聊天、摘要訂閱者等），作為設定檔的替代方案。
4. 支援文字以外的訊息：語音訊息、圖片、影片。

在此實作之後編寫了一份關於 Habr (RU) 的逐步指南。