Skip to content

README_CHT.md

Latest commit

 

History

History
320 lines (237 loc) · 12.6 KB

README_CHT.md

File metadata and controls

320 lines (237 loc) · 12.6 KB

股票智能分析系統

GitHub stars CI License: MIT Python 3.10+ GitHub Actions Docker

基於 AI 大模型的 A股/港股/美股 智能分析系統

自動分析自選股 → 生成決策儀表盤 → 多渠道推送（Telegram/Discord/郵件/企業微信/飛書）

零成本部署 · GitHub Actions 免費運行 · 無需伺服器

功能特性 · 快速開始 · 推送效果 · 完整指南 · 常見問題 · 更新日誌

繁體中文[English] | (../README_EN.md) | 简体中文

💖 贊助商 (Sponsors)


✨ 功能特性

模組 功能 說明
AI 決策儀表盤 一句話核心結論 + 精確買賣點位 + 操作檢查清單
分析 多維度分析 技術面 + 籌碼分布 + 輿情情報 + 實時行情
市場 全球市場 支援 A股、港股、美股
復盤 大盤復盤 每日市場概覽、板塊漲跌、北向資金
回測 AI 回測驗證 自動評估歷史分析準確率，方向勝率、止盈止損命中率
推送 多渠道通知 Telegram、Discord、郵件、企業微信、飛書等
自動化 定時運行 GitHub Actions 定時執行，無需伺服器

技術棧與數據來源

類型 支援
AI 模型 Gemini（免費）、OpenAI 兼容、DeepSeek、通義千問、Claude、Ollama
行情數據 AkShare、Tushare、Pytdx、Baostock、YFinance
新聞搜索 Tavily、SerpAPI、Bocha、Brave

內建交易紀律

規則 說明
嚴禁追高 乖離率 > 5% 自動提示風險
趨勢交易 MA5 > MA10 > MA20 多頭排列
精確點位 買入價、止損價、目標價
檢查清單 每項條件以「符合 / 注意 / 不符合」標記

🚀 快速開始

方式一：GitHub Actions（推薦）

無需服務器，每天自動運行！

1. Fork 本倉庫

點擊右上角 Fork 按鈕（順便點個 Star 支持一下）

2. 配置 Secrets

進入你 Fork 的倉庫 → Settings → Secrets and variables → Actions → New repository secret

AI 模型配置（二選一）

Secret 名稱 說明 必填
GEMINI_API_KEY Google AI Studio 獲取免費 Key ✅*
OPENAI_API_KEY OpenAI 兼容 API Key（支持 DeepSeek、通義千問等） 可選
OPENAI_BASE_URL OpenAI 兼容 API 地址（如 https://api.deepseek.com/v1） 可選
OPENAI_MODEL 模型名稱（如 deepseek-chat） 可選

*注：GEMINI_API_KEY 和 OPENAI_API_KEY 至少配置一個

通知渠道配置（點擊展開，至少配置一個）
Secret 名稱 說明 必填
TELEGRAM_BOT_TOKEN Telegram Bot Token（@BotFather 獲取） 可選
TELEGRAM_CHAT_ID Telegram Chat ID 可選
TELEGRAM_MESSAGE_THREAD_ID Telegram Topic ID (用於發送到子話題) 可選
DISCORD_WEBHOOK_URL Discord Webhook URL 可選
DISCORD_BOT_TOKEN Discord Bot Token（與 Webhook 二選一） 可選
DISCORD_CHANNEL_ID Discord Channel ID（使用 Bot 時需要） 可選
EMAIL_SENDER 發件人郵箱（如 xxx@qq.com） 可選
EMAIL_PASSWORD 郵箱授權碼（非登錄密碼） 可選
EMAIL_RECEIVERS 收件人郵箱（多個用逗號分隔，留空則發給自己） 可選
WECHAT_WEBHOOK_URL 企業微信 Webhook URL 可選
FEISHU_WEBHOOK_URL 飛書 Webhook URL 可選
PUSHPLUS_TOKEN PushPlus Token（獲取地址，國內推送服務） 可選
SERVERCHAN3_SENDKEY Server酱³ Sendkey（獲取地址，手機軟體推播服務） 可选
CUSTOM_WEBHOOK_URLS 自定義 Webhook（支持釘釘等，多個用逗號分隔） 可選
CUSTOM_WEBHOOK_BEARER_TOKEN 自定義 Webhook 的 Bearer Token（用於需要認證的 Webhook） 可選
SINGLE_STOCK_NOTIFY 單股推送模式：設為 true 則每分析完一隻股票立即推送 可選
REPORT_TYPE 報告類型：simple(精簡) 或 full(完整)，Docker環境推薦設為 full 可選
ANALYSIS_DELAY 個股分析和大盤分析之間的延遲（秒），避免API限流，如 10 可選

至少配置一個渠道，配置多個則同時推送。更多配置請參考 完整指南

其他配置

Secret 名稱 說明 必填
STOCK_LIST 自選股代碼，如 600519,hk00700,AAPL,TSLA ✅
TAVILY_API_KEYS Tavily 搜索 API（新聞搜索） 推薦
BOCHA_API_KEYS 博查搜索 Web Search API（中文搜索優化，支持AI摘要，多個key用逗號分隔） 可選
BRAVE_API_KEYS Brave Search API（隱私優先，美股優化，多個key用逗號分隔） 可選
SERPAPI_API_KEYS SerpAPI 備用搜索 可選
TUSHARE_TOKEN Tushare Pro Token 可選

3. 啟用 Actions

進入 Actions 標籤 → 點擊 I understand my workflows, go ahead and enable them

4. 手動測試

Actions → 每日股票分析 → Run workflow → 選擇模式 → Run workflow

5. 完成！

默認每個工作日 18:00（北京時間） 自動執行

方式二：本地運行 / Docker 部署

📖 本地運行、Docker 部署詳細步驟請參考 完整配置指南

📱 推送效果

決策儀表盤

📊 2026-01-10 決策儀表盤
3隻股票 | 🟢買入:1 🟡觀望:2 🔴賣出:0

🟢 買入 | 貴州茅台(600519)
📌 縮量回踩MA5支撐，乖離率1.2%處於最佳買點
💰 狙擊: 買入1800 | 止損1750 | 目標1900
✅多頭排列 ✅乖離安全 ✅量能配合

🟡 觀望 | 寧德時代(300750)
📌 乖離率7.8%超過5%警戒線，嚴禁追高
⚠️ 等待回調至MA5附近再考慮

---
生成時間: 18:00

大盤復盤

🎯 2026-01-10 大盤復盤

📊 主要指數
- 上證指數: 3250.12 (🟢+0.85%)
- 深證成指: 10521.36 (🟢+1.02%)
- 創業板指: 2156.78 (🟢+1.35%)

📈 市場概況
上漲: 3920 | 下跌: 1349 | 漲停: 155 | 跌停: 3

🔥 板塊表現
領漲: 互聯網服務、文化傳媒、小金屬
領跌: 保險、航空機場、光伏設備

配置說明

📖 完整環境變量、定時任務配置請參考 完整配置指南

🧩 FastAPI Web 服務（可選）

本地運行時，可啟用 FastAPI 服務來管理配置和觸發分析。

啟動方式

命令 說明
python main.py --serve 啟動 API 服務 + 執行一次完整分析
python main.py --serve-only 僅啟動 API 服務，手動觸發分析
  • 訪問地址：http://127.0.0.1:8000
  • API 文檔：http://127.0.0.1:8000/docs

功能特性

  • 📝 配置管理 - 查看/修改自選股列表
  • 🚀 快速分析 - 通過 API 接口觸發分析
  • 📊 實時進度 - 分析任務狀態實時更新，支持多任務並行
  • 📈 回測驗證 - 評估歷史分析準確率，查詢方向勝率與模擬收益

API 接口

接口 方法 說明
/api/v1/analysis/analyze POST 觸發股票分析
/api/v1/analysis/tasks GET 查詢任務列表
/api/v1/analysis/status/{task_id} GET 查詢任務狀態
/api/v1/history GET 查詢分析歷史記錄
/api/v1/backtest/run POST 觸發回測
/api/v1/backtest/results GET 查詢回測結果（分頁）
/api/v1/backtest/performance GET 獲取整體回測表現
/api/v1/backtest/performance/{code} GET 獲取單股回測表現
/api/health GET 健康檢查

項目結構

daily_stock_analysis/
├── main.py              # 主程序入口
├── server.py            # FastAPI 服務入口
├── src/                 # 核心業務代碼
│   ├── analyzer.py      # AI 分析器（Gemini）
│   ├── config.py        # 配置管理
│   ├── notification.py  # 消息推送
│   ├── storage.py       # 數據存儲
│   └── ...
├── api/                 # FastAPI API 模塊
├── bot/                 # 機器人模塊
├── data_provider/       # 數據源適配器
├── docker/              # Docker 配置
│   ├── Dockerfile
│   └── docker-compose.yml
├── docs/                # 項目文檔
│   ├── full-guide.md    # 完整配置指南
│   └── ...
└── .github/workflows/   # GitHub Actions

🗺️ Roadmap

📢 以下功能將視後續情況逐步完成，如果你有好的想法或建議，歡迎 提交 Issue 討論！

🔔 通知渠道擴展

  • 企業微信機器人
  • 飛書機器人
  • Telegram Bot
  • 郵件通知（SMTP）
  • 自定義 Webhook（支持釘釘、Discord、Slack、Bark 等）
  • iOS/Android 推送（Pushover）
  • 釘釘機器人 （已支持命令交互 >> 相關配置）

🤖 AI 模型支持

  • Google Gemini（主力，免費額度）
  • OpenAI 兼容 API（支持 GPT-4/DeepSeek/通義千問/Claude/文心一言 等）
  • 本地模型（Ollama）

📊 數據源擴展

  • AkShare（免費）
  • Tushare Pro
  • Baostock
  • YFinance

🎯 功能增強

  • 決策儀表盤
  • 大盤復盤
  • 定時推送
  • GitHub Actions
  • 港股支持
  • Web 管理界面 (簡易版)
  • 美股支持
  • 歷史分析回測

☕ 支持項目

支付寶 (Alipay) 微信支付 (WeChat) Ko-fi
Alipay WeChat Pay Ko-fi

貢獻

歡迎提交 Issue 和 Pull Request！

詳見 貢獻指南

License

MIT License © 2026 ZhuLinsen

如果你在項目中使用或基於本项目进行二次开发， 非常歡迎在 README 或文檔中註明來源並附上本倉庫鏈接。 這將有助於項目的持續維護和社區發展。

聯繫與合作

Star History

如果覺得有用，請給個 ⭐ Star 支持一下！

Star History Chart

免責聲明

本項目僅供學習和研究使用，不構成任何投資建議。股市有風險，投資需謹慎。作者不對使用本項目產生的任何損失負責。