Initial commit: cc-cursor 全链路量化研究平台

7 Sprints 全部完成:
  Sprint 0: 基础设施 (DataManager + MariaDB)
  Sprint 1: 因子引擎 (34因子/12分类)
  Sprint 2: VectorBT 回测 (5策略+截面)
  Sprint 3: Optuna 优化 (+Walk-Forward)
  Sprint 4: ML 模型 (LightGBM+CatBoost)
  Sprint 5: Qwen 情绪因子 (三源新闻+日期对齐)
  Sprint 6: Agent 系统 (4Agent+日报.md/.html)

生产加固 (15项): Tushare双源fallback, SSH自动恢复, pool_pre_ping,
  save_daily先删后插, load_dotenv绝对路径, 日报5d/20d修复,
  RiskAgent改上证指数, 昨日对比+数据截止, mac_report utf8mb4,
  CLAUDE-*.md 9条已知Bug, demo全参数化, djapi数据源归一化,
  indexDatas API修正

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

finance/factors/technical/volume.py

@@ -0,0 +1,40 @@
+"""
+量价因子：量比 / 成交量变化率。
+"""
+
+import pandas as pd
+
+from factors.base import BaseFactor
+
+
+class VolumeFactor(BaseFactor):
+    """N 日均量比 = vol / mean(vol, N)"""
+
+    category = "technical"
+
+    def __init__(self, period: int = 5):
+        self.period = period
+        self.name = f"vol_ratio_{period}"
+
+    def calculate(self, df: pd.DataFrame) -> pd.Series:
+        avg_vol = df["vol"].rolling(window=self.period, min_periods=self.period).mean()
+        return df["vol"] / avg_vol.replace(0, float("nan"))
+
+    def get_required_columns(self) -> list[str]:
+        return ["vol"]
+
+
+class VolumeChangeFactor(BaseFactor):
+    """成交量 N 日变化率"""
+
+    category = "technical"
+
+    def __init__(self, period: int = 5):
+        self.period = period
+        self.name = f"vol_chg_{period}"
+
+    def calculate(self, df: pd.DataFrame) -> pd.Series:
+        return df["vol"].pct_change(periods=self.period) * 100
+
+    def get_required_columns(self) -> list[str]:
+        return ["vol"]