CoolFace
Apppublic

marklay0916/taiwan-stock-ai-room

sourceHugging Faceupdated 2mo agoView on Hugging Face
0likes
App README

📊 台股 AI 戰情室 Pro Max

整合技術面、籌碼面、AI 智能分析的專業台股看盤系統

🎯 系統特色

📈 技術分析功能

  • —K 線圖表：紅漲綠跌的專業 K 線呈現
  • —多週期均線系統：MA5/10/20/60 完整均線
  • —MACD 指標：DIF、MACD、柱狀圖三合一
  • —KD 隨機指標：含超買超賣警示線
  • —RSI 相對強弱：14 日 RSI 指標
  • —布林通道：上軌、下軌、通道寬度

💼 籌碼分析功能

  • —外資買賣超：追蹤外資動向
  • —投信操作：掌握法人作帳
  • —自營商部位：了解券商策略
  • —主力合計：外資+投信總和
  • —融資餘額：散戶情緒指標
  • —融券餘額：軋空風險評估

🤖 AI 智能分析

  • —技術面診斷：趨勢、指標、支撐壓力
  • —籌碼面解密：法人動向、散戶籌碼
  • —綜合研判：操作建議、風險提示
  • —Powered by: Google Gemini 2.0 Flash

📋 系統需求

  • —作業系統：Windows 10/11、macOS、Linux
  • —Python 版本：3.8 以上
  • —網路連線：需連接網際網路抓取即時數據
  • —API Key：Google Gemini API（免費）

🚀 快速開始

步驟 1：安裝 Python

  1. 1.前往 Python 官網 下載
  2. 2.安裝時勾選「Add Python to PATH」
  3. 3.完成安裝

步驟 2：解壓縮系統檔案

將整個資料夾解壓縮到任意位置

步驟 3：啟動系統

Windows 使用者： 雙擊 啟動系統.bat

Mac/Linux 使用者：

bash
./啟動系統.sh

首次啟動會自動安裝所需套件（需要幾分鐘）

步驟 4：使用系統

  1. 1.瀏覽器會自動開啟 http://localhost:8501
  2. 2.在左側輸入股票代碼（例如：2330）
  3. 3.點擊「開始分析」

🔑 取得 Gemini API Key（選填）

雖然系統可在沒有 API Key 的情況下顯示圖表，但若要使用 AI 分析功能，請依照以下步驟：

  1. 1.前往 Google AI Studio
  2. 2.使用 Google 帳號登入
  3. 3.點擊「Get API Key」或「Create API Key」
  4. 4.複製產生的金鑰
  5. 5.在系統側邊欄「AI 設定」處貼上

免費額度：每天有充足的免費使用額度

📁 檔案結構

stock_ai_system/
├── main.py                    # 主程式
├── data_loader.py             # 數據載入模組
├── chart_plotter.py           # 圖表繪製模組
├── ai_engine.py               # AI 分析引擎
├── requirements.txt           # 套件相依清單
├── 啟動系統.bat               # Windows 啟動腳本
├── 啟動系統.sh                # Mac/Linux 啟動腳本
├── installed.flag             # 安裝標記（自動產生）
└── README.md                  # 本說明文件

🎮 使用範例

基本查詢

  1. 1.股票代碼：2330（台積電）
  2. 2.分析天數：120
  3. 3.點擊「開始分析」

進階使用

  • —長期趨勢：設定 180-250 天
  • —短線操作：設定 60-90 天
  • —多檔比較：依序查詢不同股票

📊 資料來源

  • —股價數據：Yahoo Finance
  • —法人籌碼：FinMind Open Data API
  • —技術指標：系統自行計算
  • —AI 分析：Google Gemini 2.0 Flash

⚠️ 重要聲明

  1. 1.本系統僅供教學與研究使用
  2. 2.所有分析不構成投資建議
  3. 3.投資有風險，請謹慎評估
  4. 4.使用者需自行承擔投資決策責任
  5. 5.過去績效不代表未來表現

🐛 常見問題

Q1：執行時出現「找不到模組」錯誤

A：刪除 installed.flag 檔案，重新啟動系統讓它重裝套件

Q2：圖表無法顯示

A：

  1. 1.檢查網路連線
  2. 2.確認股票代碼正確（台股代碼，例如 2330）
  3. 3.嘗試其他股票代碼

Q3：AI 分析顯示錯誤

A：

  1. 1.確認 API Key 正確
  2. 2.檢查 API 使用額度是否用盡
  3. 3.稍後再試（可能是 API 暫時繁忙）

Q4：某些欄位顯示為 0

A：

  • —法人或融資數據可能當日無交易
  • —週末假日無新數據
  • —FinMind API 可能暫時無法取得

Q5：系統速度很慢

A：

  1. 1.減少分析天數（60-90 天較快）
  2. 2.關閉其他耗資源程式
  3. 3.資料會快取 1 小時，重複查詢會較快

🔧 技術支援

手動安裝套件

如果自動安裝失敗，可手動執行：

bash
pip install streamlit yfinance pandas plotly google-generativeai FinMind

更新系統

bash
pip install --upgrade -r requirements.txt

清除快取

刪除以下資料夾：

  • —Windows: C:\Users\您的使用者名稱\.streamlit
  • —Mac/Linux: ~/.streamlit

📝 更新日誌

v2.0 (Pro Max 版)

  • —✅ 新增完整技術指標 (MACD, KD, RSI, 布林通道)
  • —✅ 新增三大法人個別追蹤
  • —✅ 新增主力合計統計
  • —✅ 新增融資融券分析
  • —✅ 優化 AI 提示詞，分析更精準
  • —✅ 改善介面配置與視覺呈現
  • —✅ 修正模組匯入路徑問題
  • —✅ 新增快速市況摘要

v1.0 (原始版)

  • —基礎 K 線與均線
  • —外資買賣超
  • —簡易 AI 分析

👨‍💻 開發資訊

開發語言：Python 3.8+ 主要框架：Streamlit 資料來源：Yahoo Finance + FinMind AI 引擎：Google Gemini 2.0

📧 意見回饋

如有任何問題或建議，歡迎回饋！

最後更新：2026-02-03 版本：v2.0 Pro Max