Gold Monitor Skill

台灣銀行黃金存摺價格自動監控系統，支援買/賣雙價格顯示、價格變動通知、特定價格點位監控與每日收盤報告。

📊 功能說明

| 功能 | 說明 | |------|------| | 買/賣雙價格 | 同時顯示台銀賣出與買進價格 | | 價格變動監控 | 每 10 分鐘檢查，變動超過閾值時通知 | | 特定價格點位 | 設定買入/賣出目標價，觸達時通知 | | 每日收盤報告 | 每日 22:00（真正收盤後）發送收盤價 + 走勢圖 |

📦 環境需求

| 依賴 | 安裝方式 | |------|----------| | Python | 3.9+ | | ffmpeg | brew install ffmpeg | | node | 系統內建 | | playwright | npm install playwright | | matplotlib | pip3 install --user matplotlib |

🛠️ 快速開始

1. 配置

在 ~/.gold_monitor_config.json 中設定：

{
  "threshold": 50,
  "telegram_bot_token": "YOUR_BOT_TOKEN",
  "telegram_chat_id": "YOUR_CHAT_ID",
  "price_targets": [
    {"price": 4500, "type": "buy", "label": "進場點"},
    {"price": 5000, "type": "sell", "label": "出場點"}
  ]
}

2. 指令用法

# 查看配置與比較基準
python3 $SCRIPT_PATH/gold_monitor.py --config

# 調整閾值
python3 $SCRIPT_PATH/gold_monitor.py --set-threshold 30

# 新增價格點位
python3 $SCRIPT_PATH/gold_monitor.py --add-target 4500:buy:進場點

# 列出價格點位
python3 $SCRIPT_PATH/gold_monitor.py --list-targets

# 移除價格點位
python3 $SCRIPT_PATH/gold_monitor.py --remove-target 4500

# 重置觸發狀態
python3 $SCRIPT_PATH/gold_monitor.py --reset-targets

# 手動檢查（即時價格 vs 昨天收盤）
python3 $SCRIPT_PATH/gold_monitor.py --check

# 手動發送日報（22:00 模式）
python3 $SCRIPT_PATH/gold_monitor.py --daily

⏰ 定時任務（OpenClaw Cron）

| 任務 | 時間 | 說明 | |------|------|------| | 價格監控 | 每 10 分鐘 (09:00-21:00) | 變動超閾值 + 點位觸發 | | 每日報告 | 22:00 | 真正收盤後的收盤價 + 走勢圖 |

為什麼是 22:00？ 台銀網站晚上持續更新最終掛牌價（約 20:00-21:00 確定），22:00 執行能抓到真正的收盤價，而非 15:30 的快照。

📈 比較基準邏輯

| 當日 | 比較基準 | |------|----------| | 週一 | 上週五收盤 → 週一走勢 | | 週二 ~ 週五 | 前一交易日收盤 → 當日走勢 |

基準來源：~/.gold_price_history.json 中的 history["daily"]（每日收盤記錄），state 檔已廢除。

📁 相關檔案

| 檔案 | 說明 | |------|------| | $SCRIPT_PATH/gold_monitor.py | 主程式 | | ~/.gold_monitor_config.json | 配置檔 | | ~/.gold_price_history.json | 歷史記錄（daily + intraday） |

注意：gold_monitor_state.json 已在 v2 廢除，請手動刪除：
rm ~/.gold_monitor_state.json

🔄 v1 → v2 升級重點

✅ 廢除 state 檔，history["daily"] 成為唯一比較基準
✅ 買/賣雙價格同時顯示
✅ 每日報告改為 22:00 執行（真正收盤後）
✅ 價格監控擴展到 21:00
✅ 走勢圖顯示雙線（藍=賣出，綠=買進）