<<<<<<< HEAD

自動化交易機械人 (v2.4.6-stable 基準)

項目概覽

此為一個自動化交易系統，設計用作與 IG Market API (Demo) 互動。

文件結構與路徑

• 項目根目錄: /home/hmtf000001/trading_bot/
• 虛擬環境 (venv): /home/hmtf000001/trading_bot/venv/
• 配置文件: /home/hmtf000001/trading_bot/configs/ (包含 .json 文件，例如 epic_list.json, risk_config.json)
• 憑證文件: /home/hmtf000001/trading_bot/.env (包含 API Keys, 密碼等 - 使用 SIM_ 前綴)
• 日誌 (手動/腳本): /home/hmtf000001/trading_bot/logs/ (例如 main_log.txt, strategy_success.json)
• 日誌 (Cron 執行): /home/hmtf000001/trading_bot/logs/auto_trading_cron.log
• 策略: /home/hmtf000001/trading_bot/strategies/
• 工具函數: /home/hmtf000001/trading_bot/utils/
• 依賴列表: /home/hmtf000001/trading_bot/requirements.txt

環境設置與執行

1. 進入項目根目錄:

   cd /home/hmtf000001/trading_bot/

2. 激活虛擬環境:

   source venv/bin/activate

3. 安裝/更新依賴 (如果需要):

   pip install -r requirements.txt

4. 手動運行主腳本:

   # 確保 venv 已激活
   python auto_trading_unified_sim.py

Crontab 配置示例

確保 Crontab (crontab -e) 中包含以下或類似的指令 (請用 crontab -l 檢查)：

# 每日 7:00 AM HKT 運行主腳本
0 7 * * * cd /home/hmtf000001/trading_bot/ && /home/hmtf000001/trading_bot/venv/bin/python auto_trading_unified_sim.py >> /home/hmtf000001/trading_bot/logs/auto_trading_cron.log 2>&1

# 記錄 Cron 觸發時間
0 7 * * * echo "🟢 Cron job triggered for main script at $(date)" >> /home/hmtf000001/trading_bot/logs/cron_trigger.log 2>&1

# 其他 Cron 任務 (例如備份、清理) 如果操作項目文件，亦應使用 /home/hmtf000001/trading_bot/ 下的路徑。
=======
# Genesis 2.0 - 全自動化量化交易作戰平台

**版本**: 1.0 (IOC - 初始作戰能力穩定版)
**艦長 / 總設計師**: lucifinel
**AI 系統架構師**: Genesis

---

## 1. 項目概述 (Project Overview)

本項目是一個基於 Python 的、專業級的、全天候自動化量化交易平台。經過密集的研發、測試與多輪迭代，平台目前已達到「初始作戰能力」(IOC) 狀態，具備以下核心特性：

* **多市場作戰能力**: 可同時監控並執行多個外匯與大宗商品市場的交易。
* **智能決策核心**: 內置「AI 指揮官」(`MetaStrategyEngine`)，能根據市場狀態（趨勢/盤整）動態選擇並部署最適應的交易策略。
* **模塊化策略庫**: 擁有一個可擴展的策略庫，允許快速研發、回測和部署新舊策略。
* **獨立風險管理**: 具備獨立的「風險管理器」(`RiskManager`)，實現了基於波動率的動態頭寸規模控制。
* **科學回測引擎**: 內置了基於 `backtesting.py` 的強大回測與優化工具，支持樣本外驗證等專業測試流程。
* **全自動化運維**: 通過 `systemd` 和 `cron` 實現了 7x24 的服務守護和週末自動作息管理，達成「零人工干預」的運行目標。
* **實時監控與警報**: 與 Telegram 全面集成，可推送實時的系統心跳和交易信號。
* **安全的監控模式**: 通過創建唯讀的「觀察者」用戶，實現了交易執行與日常監控的會話與權限分離。

## 2. 最終部署狀態 (Final Deployed State)

* **主力作戰策略**: `CONFLUENCE_STRATEGY` (V1.2)
    * 一個結合了「H4 宏觀趨勢」、「市場結構突破」、「ADX 狀態過濾」、「RSI 確認指標」四位一體的複雜共振策略。
* **現役作戰單位**: 4 個
    * `EUR/USD`, `USD/JPY`, `GBP/JPY`, `Spot Gold`
* **核心風險管理**:
    * 動態頭寸規模 (基於 ATR)
    * 部分止盈與移動保本 (已編碼，待實戰驗證)
* **運行週期**: 15 分鐘 (900 秒)

## 3. 未來發展藍圖 (Future Roadmap)

* **「金剛石計畫」(Project Adamantium)**: 當前最高優先級。
    * **任務一**: 驗證已編碼的「部分止盈」與「移動保本」邏輯。
    * **任務二**: 開發並回測「時間止損」功能。
    * **目標**: 將策略的風險控制能力提升到新的高度，將最大回撤控制在可接受的範圍內。

* **「軍團計畫」(Project Legion)**:
    * **任務**: 對後備交易品種（`AUD/USD`, `NZD/USD` 等）逐一進行回測，篩選出適合 `ConfluenceStrategy` 的新戰場，穩步擴大作戰軍團的規模。

* **「創世紀 3.0」(Genesis 3.0)**:
    * **任務**: 研發「自適應策略」和「情緒分析引擎」，讓系統學會根據市場的反饋，動態地微調自身參數，並引入非價格數據作為決策依據。

>>>>>>> develop