trade/AGENTS/05-python-engine.md

Python 引擎

• workdir 必须是 engine/：导入包使用 from common import ...（如 from common import Kline, BaseStrategy）。
• 未完成模块：策略管理器、信号总线、回测引擎、参数优化器仅存在于 ENGINE.md 设计文档中，尚未实现。当前仅 common/base.py（策略基类）和 common/models.py（数据模型）、common/logger.py（日志）可用。
• 引擎入口 engine/__init__.py 导出 Kline, KlineInterval, OrderBook, Ticker, Trade。
• 引擎配置在 engine/env.yaml（与根 env.yaml 不同，是引擎专属配置）。
• Pydantic v2 的 field_validator 处理 TS 侧字符串 → Python float/int 转换。