参考资料
配置项全集
TradingConfig 的核心参数速查。策略参数全部走环境变量，保证回测与实盘同参。
参数集中在 config/config.py 的 TradingConfig，敏感信息走环境变量。回测与实盘读同一套配置，这是 One Codebase 在配置层的体现。
凭证与运行模式
| 参数 | 说明 |
|---|---|
APCA_API_KEY_ID / APCA_API_SECRET_KEY | Alpaca 密钥，走环境变量 |
TRADING_MODE | paper / live，决定使用模拟盘还是实盘 API base URL |
TradingMode | 代码内枚举：paper / live |
DB_PATH | 数据库路径，环境变量全局生效 |
策略参数
| 参数 | 默认 | 说明 |
|---|---|---|
TOP_N | 10 | 截面排序取前 N 只构建组合 |
REBALANCE_FREQ | 5 | 每 N 个交易日调仓一次。回测与实盘必须一致，否则摩擦成本被放大（见 周频换手） |
METHOD | icir_weighted | 因子组合方式：等权 / IC 加权 / ICIR 加权 |
INITIAL_CAPITAL | 20000 | 初始资金，环境变量默认 10,000）。盈利不参与复利，复利化在路线图 M4 |
风控参数（RiskConfig）
| 参数 | 默认 | 说明 |
|---|---|---|
max_single_weight | 0.10 | 单票最大权重 |
max_total_weight | 0.95 | 组合总敞口上限（基于真实 account.equity 计算，历史上曾因计算基数错误导致总仓超 100%） |
max_positions | 30 | 最大持仓数，超出按权重截断 |
max_drawdown_threshold / drawdown_reduce_ratio | 0.15 / 0.50 | 回撤超 15% 时全组合减仓一半。当前仅回测路径生效——执行路径未喂回撤状态（见 止损形同虚设） |
一致性提醒
任何会影响交易决策的参数，回测和实盘都必须取同一个值。最常见的实盘亏损，不是因子失效，而是某个参数（尤其是 REBALANCE_FREQ）两边没对齐。