Crypto Flash

免費 x 持續運行中

這個專案會持續監控 Jin10 的 WebSocket 快訊，當新聞命中你的關鍵字時，會交給 Gemini 進行分級與摘要，並自動推播到 Telegram。你也可以直接在 Telegram 提問，系統會把近期已監控的快訊背景一併納入回答。

English | 繁體中文

分級推播 Gemini 會依新聞重要性分級

AI 即時回覆 帶入近期快訊背景補充判斷

---

專案概述

這是一個以 GitHub Actions 為核心的自動化快訊監控系統，目標是把大量、低價值的 Jin10 訊息濾掉，只留下值得你關注的內容。

它做了什麼

• 直接連接 Jin10 的 WebSocket 訊號流
• 解析快訊內容並以關鍵字過濾雜訊
• 將符合條件的新聞交給 Gemini 做分級、摘要與風險判斷
• 把重要內容即時推到 Telegram
• 另外支援 Telegram 問答模式，帶入近期快訊背景回答
• 監控 YouTube 頻道 RSS，新影片交給 Gemini 整理 5 個重點後推播到 Telegram

---

主要功能

• WebSocket 連線與自動重連：src/jin10_monitor.py
• 關鍵字過濾：支援內建關鍵字清單，也可用 KEYWORDS_FILE 自訂
• Gemini 分級與摘要：src/gemini.py
• Telegram 推播：src/tg.py
• Telegram 對話問答：src/telegram_assistant.py
• YouTube 新影片監控與摘要：src/yt_monitor.py
• 共享近期新聞上下文：data/recent_news.json
• GitHub Actions 自動執行：Jin10 每 6 小時一次，YouTube 每 30 分鐘一次，皆支援手動觸發

---

工作流程

Jin10 WebSocket
   ↓
解析二進位封包
   ↓
關鍵字比對
   ↓
Gemini 分級 + 摘要
   ↓
Telegram 推播
   ↓
寫入 data/recent_news.json
   ↓
telegram_assistant.py 依背景資料回答 Telegram 問題

jin10_monitor.py 和 telegram_assistant.py 是兩個獨立流程，共同使用 recent_news.json 作為近期快訊上下文。

YouTube 影片監控

yt_monitor.py 會讀取 config/yt_channels.json 中的頻道，透過 YouTube RSS 找出新影片，再依序執行以下流程：

YouTube RSS
   ↓
依 channel_id 解析影片
   ↓
比對 data/yt_seen_ids.json 去重
   ↓
Gemini 觀看影片並整理 5 個重點
   ↓
Telegram 推播摘要與來源連結

首次執行某個頻道時，程式只會把 RSS 中現有影片寫入 data/yt_seen_ids.json 作為預熱，不會推播既有影片。之後每次執行最多處理該頻道 max_new_per_run 部新影片；超過上限的較舊影片會標記為已讀但不推播。即使 Gemini 摘要失敗，仍會推送影片連結。

頻道設定範例：

[
  {
    "name": "加密龐克",
    "channel_id": "UCeeeGbipVKpz23A8_c3I3uA",
    "system_prompt": "以 JARVIS 的口吻說明",
    "max_new_per_run": 3
  }
]

name 必須唯一，channel_id 是 YouTube 頻道 ID；system_prompt 可選，用來補充該頻道的摘要風格。若要在 GitHub Actions 中持續去重，必須讓 data/yt_seen_ids.json 在不同執行之間持久化。

---

快速開始

1. 下載 / Fork 專案

git clone https://github.com/<your-user>/<your-repo>.git
cd jin10_news_scraper

2. 設定環境變數

複製 .env.example 成為 .env，並填入你的設定：

TELEGRAM_BOT_TOKEN_01=""
TELEGRAM_BOT_TOKEN_02=""
TELEGRAM_CHAT_ID=""
GEMINI_API_KEY=""
GEMINI_MODEL="gemini-3.5-flash-lite"

3. 安裝依賴

pip install -r requirements.txt

4. 啟動監控腳本

python src/jin10_monitor.py

5. 啟動 Telegram 問答腳本（可選）

python src/telegram_assistant.py

在群組中可直接 @ 機器人或使用 /ask；私人聊天則可直接輸入問題。

6. 啟動 YouTube 監控（可選）

python src/yt_monitor.py

執行前請先在 config/yt_channels.json 填入要監控的頻道。這個腳本跑完目前設定的所有頻道後就會結束，適合搭配排程工具或 GitHub Actions 使用。

---

GitHub Actions 部署

本專案已包含兩個 workflow：

Workflow	作用
flash_monitor.yml	執行 src/jin10_monitor.py，監控快訊並推播
telegram_assistant.yml	執行 src/telegram_assistant.py，接收 Telegram 問題並回答
yt_monitor.yml	執行 src/yt_monitor.py，監控 YouTube 新影片並推播摘要

在 GitHub 的 Settings → Secrets and variables → Actions 中新增：

Secret / Variable	說明
GEMINI_API_KEY	Google AI Studio 的 Gemini API 金鑰
TELEGRAM_BOT_TOKEN_01	Telegram Bot Token
TELEGRAM_BOT_TOKEN_02	YouTube 監控使用的 Telegram Bot Token
TELEGRAM_CHAT_ID	推播目標聊天室或群組 ID
GEMINI_MODEL	可選，預設為 gemini-3.5-flash-lite

flash_monitor.yml 會在每 6 小時排程一次；yt_monitor.yml 會在每小時的第 0 分與第 30 分執行一次。兩者都支援手動觸發 workflow_dispatch。

---

可調整環境變數

共用設定

變數	預設值	用途
TELEGRAM_BOT_TOKEN_01	空	Telegram Bot Token
TELEGRAM_CHAT_ID	空	推播目標 / 問答來源限制
GEMINI_API_KEY	空	Gemini API 金鑰
GEMINI_MODEL	gemini-3.5-flash-lite	生成模型
NEWS_CONTEXT_FILE	data/recent_news.json	近期快訊的共用上下文檔
CONTEXT_MAX_AGE_SEC	21600	近期訊息保留秒數

監控腳本設定

變數	預設值	用途
MAX_TIER_TO_SEND	MEDIUM	推播門檻，達到或高於此等級才送出
KEYWORDS_FILE	空	自訂關鍵字檔案路徑
WS_URLS	wss://wss-flash-2.jin10.com/	Jin10 WebSocket 端點
WS_IDLE_TIMEOUT	180	若長時間無訊息就重連
WS_RECONNECT_DELAY	5	重連前等待秒數
CONTEXT_MAX_ITEMS	80	近期訊息最多保留數量

問答腳本設定

變數	預設值	用途
CONTEXT_SNIPPET_LIMIT	40	回答問題時帶入的背景訊息數量

YouTube 監控設定

變數	預設值	用途
TELEGRAM_BOT_TOKEN_02	空	YouTube 摘要推播使用的 Telegram Bot Token
YT_CHANNELS_CONFIG	config/yt_channels.json	YouTube 頻道設定檔路徑
YT_MAX_NEW_PER_RUN	3	頻道未指定上限時，單次最多處理的新影片數
YT_SEEN_STATE_FILE	data/yt_seen_ids.json	已處理影片 ID 的狀態檔路徑
YT_MAX_SEEN_IDS	300	每個頻道最多保留的已處理影片 ID 數量

---

重要說明

• 本專案僅供技術研究、個人資訊追蹤與學習使用。
• 抓取內容仍屬 Jin10 原資料來源所有。
• Gemini 生成的回答僅為輔助分析，不構成投資建議。
• 即時行情與訊息可能變動，請以官方資訊與實際市場為準。

免責聲明

AI 生成的摘要與分析僅供參考，不構成任何投資建議。市場有風險，投資前請自行評估與查證。

如果這個專案有幫你節省看新聞的時間，歡迎給個星號支持。