Stock Analyzer

name: 台股每日技術分析

on:
  # 每個交易日上午 9:30 (台灣時間) = UTC 1:30
  schedule:
    - cron: '30 1 * * 1-5'  # 週一至週五 UTC 1:30

  # 允許手動觸發
  workflow_dispatch:

# 設定權限以便推送到 repo
permissions:
  contents: write

jobs:
  analyze-and-deploy:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout 程式碼
        uses: actions/checkout@v4

      - name: 設定 Python 環境
        uses: actions/setup-python@v5
        with:
          python-version: '3.12'
          cache: 'pip'

      - name: 安裝相依套件
        run: |
          pip install --upgrade pip
          pip install -r requirements.txt

      - name: 執行股票分析並生成報告
        run: |
          python generate_report.py
        env:
          TZ: Asia/Taipei

      - name: 檢查是否有變更
        id: check_changes
        run: |
          git diff --quiet docs/index.html || echo "changed=true" >> $GITHUB_OUTPUT

      - name: 提交並推送報告
        if: steps.check_changes.outputs.changed == 'true'
        run: |
          git config user.name "GitHub Actions Bot"
          git config user.email "actions@github.com"
          git add docs/index.html
          git commit -m "📊 更新每日台股技術分析報告 $(TZ=Asia/Taipei date +%Y-%m-%d)"
          git push
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: 顯示完成訊息
        run: |
          echo "✅ 台股技術分析報告已更新"
          echo "📅 執行時間: $(TZ=Asia/Taipei date '+%Y-%m-%d %H:%M:%S %Z')"
          echo "📊 報告位置: docs/index.html"


# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class

# C extensions
*.so

# Distribution / packaging
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
pip-wheel-metadata/
share/python-wheels/
*.egg-info/
.installed.cfg
*.egg
PIPFILE.lock

# PyInstaller
*.manifest
*.spec

# Installer logs
pip-log.txt
pip-delete-this-directory.txt

# Unit test / coverage reports
htmlcov/
.tox/
.nox/
.coverage
.coverage.*
.cache
nosetests.xml
coverage.xml
*.cover
*.py,cover
.hypothesis/
.pytest_cache/

# Translations
*.mo
*.pot

# Django stuff:
*.log
local_settings.py
db.sqlite3
db.sqlite3-journal

# Flask stuff:
instance/
.webassets-cache

# Scrapy stuff:
.scrapy

# Sphinx documentation
docs/_build/

# PyBuilder
target/

# Jupyter Notebook
.ipynb_checkpoints

# IPython
profile_default/
ipython_config.py

# pyenv
.python-version

# pipenv
Pipfile.lock

# PEP 582
__pypackages__/

# Celery stuff
celerybeat-schedule
celerybeat.pid

# SageMath parsed files
*.sage.py

# Environments
.env
.venv
env/
venv/
ENV/
env.bak/
venv.bak/

# Spyder project settings
.spyderproject
.spyproject

# Rope project settings
.ropeproject

# mkdocs documentation
/site

# mypy
.mypy_cache/
.dmypy.json
dmypy.json

# Pyre type checker
.pyre/

# IDEs
.vscode/
.idea/
*.swp
*.swo
*~

# OS
.DS_Store
Thumbs.db

# Claude plugin files
.claude-plugin/
.claude/

# Project specific
*.csv
*.xlsx
*.xls
output/
logs/

# Keep data/stocks.json but ignore CSV data files
data/*.csv
data/*.xlsx
data/*.xls
!data/stocks.json


# 台股技術分析工具 - Taiwan Stock Technical Analyzer

自動化台股技術分析工具，使用 RSI、MACD、布林通道等指標進行股票分析與排名。

## 專案概述

本專案提供：
- **技術指標分析**: RSI、MACD、布林通道、移動平均線
- **股票比較排名**: 根據動能指標對多支股票進行排名
- **買賣訊號生成**: 基於技術指標提供交易建議
- **自動化報告**: 計劃整合 GitHub Actions 每日自動分析

**目前狀態**:
- ✅ 50 支台股清單（已驗證可用）
- ✅ 核心分析引擎完成
- ✅ 專案結構整理完畢
- 🚧 開發中: GitHub Actions 自動化工作流程

---

## 快速開始

### 1. 安裝依賴

```bash
pip install -r requirements.txt
```

### 2. 執行股票分析測試

```bash
# 完整 50 支股票比較測試
python tests/test_full_comparison.py
```

### 3. 使用分析器

```python
import sys
sys.path.append('scripts')
from main import StockAnalyzer
from stock_list import GIFT_STOCKS, STOCK_NAMES

# 建立分析器
analyzer = StockAnalyzer()

# 分析單支股票
result = analyzer.analyze("2330.TW", indicators=["RSI", "MACD"])
print(f"{STOCK_NAMES['2330.TW']}: {result['signal']['action']}")

# 比較多支股票並排名
comparison = analyzer.compare(
    GIFT_STOCKS[:10],  # 前 10 支股票
    rank_by="momentum",
    indicators=["RSI", "MACD"]
)

# 顯示排名結果
for stock in comparison['ranked_stocks']:
    ticker = stock['ticker']
    name = ST