# 框架功能完善性分析报告

## 一、现有轮动策略核心功能清单

### 1.1 数据获取层（HybridDataSource）

| 功能 | 实现位置 | 说明 |
|------|----------|------|
| **混合数据源** | `core/datasource/hybrid_source.py` | Tushare(A股) + YFinance(港美股) |
| **SSH隧道** | `hybrid_source.py` | SOCKS5代理访问境外数据 |
| **双轨数据架构** | `engine.py:48` | index_data(因子) + etf_data(收益) |
| **ETF净值数据** | `engine.py:58` | 溢价率计算 |
| **缓存机制** | `datasource/cache.py` | 本地缓存管理 |
| **交易日历对齐** | `compute_factors()` | 对齐到A股交易日历 |

### 1.2 因子计算层（compute_factors）

| 功能 | 实现位置 | 说明 |
|------|----------|------|
| **加权动量因子** | `calculate_weighted_momentum_score()` | 年化收益率 × R² |
| **崩盘过滤** | `apply_crash_filter()` | 3天跌>5%清零 |
| **动态ATR周期** | `auto_day`参数 | 根据波动率调整窗口 |
| **多因子类型** | `factor_type` | momentum/slope_r2/weighted_momentum |

### 1.3 选股逻辑层（generate_signals）

| 功能 | 实现位置 | 说明 |
|------|----------|------|
| **Top N选股** | `engine.py:108-114` | 按得分排序 |
| **分散化选股** | `engine.py:117-135` | 每大类Top1→全局Top3 |
| **调仓周期控制** | `rebalance_days` | 持仓至少N天 |
| **调仓阈值检查** | `_check_rebalance()` | 得分改善阈值 |
| **负分过滤** | `scores > 0` | 过滤负分标的 |

### 1.4 溢价控制层（premium_control）

| 功能 | 配置位置 | 说明 |
|------|----------|------|
| **溢价阈值** | `rotation.yaml:97-114` | 10%阈值 |
| **按市场配置** | `market_overrides` | 港股/美股启用 |
| **控制模式** | `mode: filter/penalize` | 完全排除或降权 |

### 1.5 回测执行层（run_backtest）

| 功能 | 实现位置 | 说明 |
|------|----------|------|
| **日收益率计算** | `engine.py:246-267` | 多品种等权 |
| **交易成本扣除** | `engine.py:270-287` | 换手率比例扣除 |
| **净值计算** | `engine.py:289-292` | 起点归一化 |
| **基准对比** | `engine.py:305-323` | 沪深300基准 |
| **持仓跟踪** | `portfolio.py` | 交易记录生成 |

### 1.6 报告生成层（generate_performance_report）

| 功能 | 实现位置 | 说明 |
|------|----------|------|
| **KPI指标** | `report.py` | CAGR/Sharpe/MaxDD |
| **可视化图表** | `report.py` | 净值曲线/月度收益 |
| **HTML报告** | `visualization/` | Bootstrap样式 |

---

## 二、新框架功能对比

### 2.1 已实现功能 ✓

| 功能 | 新框架实现 | 对应现有功能 |
|------|------------|--------------|
| **因子抽象** | `FactorBase` + `FactorRegistry` | `compute_factors()` ✓ |
| **动量因子** | `MomentumFactor` | `calculate_weighted_momentum_score()` ✓ |
| **崩盘过滤** | `MomentumFactor.crash_filter` | `apply_crash_filter()` ✓ |
| **ATR计算** | `VolatilityFactor(method='atr')` | `calculate_atr()` ✓ |
| **Top N选股** | `TopNSelector` | `top_n_codes()` ✓ |
| **分散化选股** | `TopNSelector(group_by)` | `top_n_diversified()` ✓ |
| **溢价控制** | `PremiumControl` | `premium_control`配置 ✓ |
| **回调钩子** | `CallbackHook` | 新增功能 ✓ |

### 2.2 未实现功能 ❌

| 功能 | 现有实现 | 新框架缺失 | 影响 |
|------|----------|------------|------|
| **数据源抽象** | `HybridDataSource` | ❌ 无DataSource接口 | 🔴 高：无法获取数据 |
| **SSH隧道管理** | `hybrid_source.py` | ❌ 无 | 🔴 高：无法访问境外数据 |
| **双轨数据架构** | index_data + etf_data | ❌ 无 | 🔴 高：因子/收益数据分离 |
| **交易日历对齐** | `compute_factors()` | ❌ 无 | 🟡 中：跨市场对齐 |
| **完整回测逻辑** | `run_backtest()` | ❌ BacktestExecutor简化 | 🔴 高：无法执行完整回测 |
| **交易成本扣除** | 换手率比例扣除 | ❌ 无 | 🟡 中：回测准确性 |
| **净值计算** | 起点归一化 | ❌ 无 | 🔴 高：净值曲线 |
| **基准对比** | benchmark_data | ❌ 无 | 🟡 中：策略评估 |
| **持仓跟踪** | `portfolio.py` | ❌ 无完整实现 | 🟡 中：交易记录 |
| **报告生成** | `report.py` | ❌ 无 | 🟡 中：结果可视化 |

---

## 三、功能完善性评估

### 3.1 完善度评分

| 模块 | 完善度 | 说明 |
|------|--------|------|
| **因子层** | **90%** ✓ | 核心功能完善，动态周期待实现 |
| **信号层** | **85%** ✓ | TopN和分散化已实现，调仓阈值缺失 |
| **风控层** | **80%** ✓ | 溢价控制和回调钩子完善 |
| **数据层** | **0%** ❌ | 完全缺失，需完整迁移 |
| **执行层** | **20%** ❌ | 仅框架骨架，无完整逻辑 |
| **报告层** | **0%** ❌ | 完全缺失 |

**总体完善度**：**约45%**

### 3.2 关键缺失分析

**数据层缺失（影响最大）**：
```
现有策略流程：
HybridDataSource.fetch_all() → index_data, etf_data, etf_nav_data

新框架现状：
无数据获取接口 → 无法运行策略
```

**执行层缺失（影响大）**：
```
现有策略流程：
generate_signals() → run_backtest() → 净值曲线 + 交易记录

新框架现状：
BacktestExecutor.execute() → 仅返回空Portfolio → 无法产出结果
```

---

## 四、迁移路径建议

### 4.1 立即需要补充（P0）

| 功能 | 预估工作量 | 说明 |
|------|------------|------|
| **DataSource抽象接口** | 1天 | 定义数据获取标准接口 |
| **混合数据源集成** | 2天 | 迁移HybridDataSource到新框架 |
| **完整回测执行器** | 2天 | 迁移run_backtest()逻辑 |

### 4.2 短期补充（P1）

| 功能 | 预估工作量 | 说明 |
|------|------------|------|
| **交易日历对齐** | 0.5天 | 迁移compute_factors对齐逻辑 |
| **持仓跟踪完善** | 1天 | 迁移portfolio.py逻辑 |
| **基准对比** | 0.5天 | 添加基准数据支持 |

### 4.3 中期补充（P2）

| 功能 | 预估工作量 | 说明 |
|------|------------|------|
| **报告生成集成** | 1天 | 迁移report.py到新框架 |
| **调仓阈值检查** | 0.5天 | 添加_check_rebalance逻辑 |

---

## 五、结论与建议

### 5.1 总体结论

**框架核心抽象设计完善（因子层、信号层、风控层）**，但：

- **数据层缺失**：无法获取数据，策略无法运行
- **执行层不完整**：无法产出回测结果
- **报告层缺失**：无法可视化结果

**当前状态**：框架骨架搭建完成，但无法直接替代现有轮动策略运行。

### 5.2 两种路径选择

**路径A：快速验证路径**
- 在现有`engine.py`中使用新框架的因子层和信号层
- 保持现有数据获取和回测逻辑不变
- 目标：验证因子抽象和选股逻辑正确性
- 时间：1天

**路径B：完整迁移路径**
- 补充数据层抽象
- 补充完整回测执行器
- 补充报告生成
- 目标：完整替代现有策略
- 时间：5-6天

### 5.3 建议

**优先级建议**：
1. **先走路径A**：快速验证因子层和信号层正确性
2. **逐步补充**：按P0→P1→P2顺序补充缺失功能
3. **保持兼容**：新框架与现有策略并行运行一段时间

**下一步行动**：
- 是否先走路径A（快速验证）？
- 还是直接走路径B（完整迁移）？

---

*文档版本：V1.0*
*分析时间：2026-05-08*
*目标：评估框架功能完善性*