参考资料
环境与上手
环境搭建、依赖安装、环境变量配置与每日流水线运行指南。
前提
代码仓库 alpha-online 为私有。本页命令供已获授权者内部对照，路径与密钥按实际替换。需要一个 Alpaca 账户（先用 Paper Trading）。
环境要求
- Python 3.13+（通过
uv管理） - SQLite（系统自带）
- Alpaca API 密钥（申请地址）
安装
git clone git@github.com:kuhung/alpha-online.git
cd alpha-online
source .venv/bin/activate
uv pip install -r requirements.txt环境变量
敏感信息一律走环境变量，不进代码、不进 git。最少需要：
# .env
ALPACA_API_KEY=...
ALPACA_SECRET_KEY=...
ALPACA_BASE_URL=https://paper-api.alpaca.markets # 模拟盘
DB_PATH=data/finance_data.db切实盘只改一处：ALPACA_BASE_URL 换成 https://api.alpaca.markets，并填实盘密钥。完整参数见 配置项全集。
跑通每日流水线
./run_daily_pipeline.sh它串起 5 步：数据接入 → 预处理 → 数据质量审计（门禁）→ 因子计算 → 信号生成 & 模拟交易。挂上 Cron 即可每日无人值守运行：
# 北京 04:30 = 美东 16:30（收盘后）
30 4 * * 2-6 cd /path/to/alpha-online && ./run_daily_pipeline.sh >> logs/pipeline.log 2>&1单独跑回测
python -m src.backtest.run_backtest参数（TOP_N / REBALANCE_FREQ / METHOD / INITIAL_CAPITAL）全部走环境变量，保证回测与实盘同参。
切实盘前的硬门槛
模拟盘须在无人值守、零报错的情况下连跑 ≥ 4 周，再考虑切实盘。原因见 周频换手把摩擦放大数倍与 续跑失忆症。