"""
Lean Hello World 示例

这是一个最简单的 Lean 算法示例，展示基本结构。
功能：买入并持有 SPY

运行方式：
1. 使用 Lean CLI: lean backtest "MyProject"（项目名是位置参数）
2. 或在 QuantConnect 云端直接运行
"""

from AlgorithmImports import *

class HelloWorldAlgorithm(QCAlgorithm):
    """
    Hello World 算法

    这是最简单的 Lean 算法，展示：
    1. 如何设置回测参数
    2. 如何添加证券
    3. 如何下市价单
    4. 如何输出调试信息
    """

    def Initialize(self):
        '''初始化算法，设置回测参数和添加证券'''

        # ========== 时间设置 ==========
        self.SetStartDate(2023, 1, 1)    # 设置开始日期：2023年1月1日
        self.SetEndDate(2023, 12, 31)    # 设置结束日期：2023年12月31日

        # ========== 资金设置 ==========
        self.SetCash(100000)             # 设置初始资金：$100,000

        # ========== 添加证券 ==========
        # 添加 SPY（标普500 ETF），日线数据
        spy = self.AddEquity("SPY", Resolution.Daily)

        # 可选：设置 benchmark
        self.SetBenchmark("SPY")

        # ========== 保存 Symbol 方便后续使用 ==========
        self._spy = spy.Symbol

        # 输出初始化完成信息
        self.Debug("Hello World! Algorithm initialized.")
        self.Debug(f"Start Date: {self.StartDate}")
        self.Debug(f"End Date: {self.EndDate}")
        self.Debug(f"Initial Cash: ${self.Portfolio.Cash}")

    def OnData(self, data):
        '''
        主数据处理函数
        每个新的数据点都会触发此函数
        '''
        # 检查我们是否已经有持仓
        if not self.Portfolio.Invested:
            # 还没有持仓，使用100%资金买入SPY
            self.SetHoldings(self._spy, 1)

            # 输出调试信息
            self.Debug(f"Purchased SPY at ${data[self._spy].Price}")

            # 输出当前投资组合信息
            self.Debug(f"Total Portfolio Value: ${self.Portfolio.TotalPortfolioValue}")

    def OnOrderEvent(self, orderEvent):
        '''
        订单事件处理函数
        当订单状态发生变化时触发
        '''
        # 只处理已填充的订单
        if orderEvent.Status == OrderStatus.Filled:
            self.Debug(f"Order filled: {orderEvent}")

    def OnEndOfDay(self, symbol):
        '''
        每日收盘时触发
        可用于每日日志记录或统计
        '''
        # 只在SPY收盘时输出
        if symbol == self._spy:
            self.Debug(f"End of day for SPY. Portfolio Value: ${self.Portfolio.TotalPortfolioValue:.2f}")
