初始提交：高股息策略研究与回测系统

从 Point-in-Time 股票筛选到统一 Web 前端的完整链路：
筛选 → 画像 → 策略 → 回测 → Walk-forward → 绩效分析 → 报告/前端。

架构
- 数据层与策略层分离；策略代码不写 SQL，只经 data/repo.py 取数
- 所有业务阈值集中在 config/*.yml，代码零硬编码（字段写错直接报错）
- 报告只做「run_id → SQL → 渲染」，不做任何计算，数字可追溯
- 前后端分离：output/ 静态站点 + hdiv web 提供的 REST API

数据安全
- 只增不删：SQL 钩子拦截 DELETE/DROP/TRUNCATE，并有源码扫描测试守护
- qlib 原有表只读，本项目数据写入 hd_ 前缀表
- 回补使用 INSERT IGNORE，保证既有行零改动
- .env 存密钥且已 gitignore；output/、logs/、.venv/ 不入库

交付物
- 30 张 hd_* 表、7 个 YAML 配置、283 项自动化测试
- 统一 Web 前端（hash 路由 SPA）+ nginx 部署配置与 launchd 托管脚本

如实声明的限制
- 策略缺少稳定的样本外超额收益（Walk-forward 7 窗口均值 -0.95%，
  基准 +2.29%）；其价值体现在回撤控制，而非超额收益
- 涨跌停/停牌约束仅覆盖 2019 年起；index_weight 尚未填充
- AI Agent 层（plan.md 第四版 P8）未实现

详见 docs/user-guide.md 与 docs/implementation-status.md。

sql/hd_profile_stat.sql

@@ -0,0 +1,29 @@
+-- 逐股逐指标历史分布统计（plan.md §9 明确要求 P10/P25/P50/P75/P90）
+-- 由 src/hdiv/data/schema.py 生成，请勿手工修改
+CREATE TABLE IF NOT EXISTS `hd_profile_stat` (
+  `id`              BIGINT       NOT NULL AUTO_INCREMENT,
+  `run_id`          VARCHAR(32)  NOT NULL,
+  `symbol`          VARCHAR(12)  NOT NULL,
+  `metric_code`     VARCHAR(48)  NOT NULL,
+  `window_years`    INT          NOT NULL DEFAULT 0 COMMENT '0=全历史；NULL 会绕过唯一约束故禁用',
+  `n_obs`           INT          NOT NULL DEFAULT 0,
+  `min_value`       DECIMAL(24,8) NULL,
+  `max_value`       DECIMAL(24,8) NULL,
+  `mean_value`      DECIMAL(24,8) NULL,
+  `median_value`    DECIMAL(24,8) NULL,
+  `std_value`       DECIMAL(24,8) NULL,
+  `p10`             DECIMAL(24,8) NULL,
+  `p25`             DECIMAL(24,8) NULL,
+  `p50`             DECIMAL(24,8) NULL,
+  `p75`             DECIMAL(24,8) NULL,
+  `p90`             DECIMAL(24,8) NULL,
+  `extra_percentiles_json` TEXT  NULL COMMENT '配置中超出默认 5 档的分位',
+  `current_value`   DECIMAL(24,8) NULL COMMENT 'asof 当日取值',
+  `current_percentile` DECIMAL(12,6) NULL COMMENT '当前值在历史分布中的分位 %',
+  `status`          VARCHAR(16)  NOT NULL DEFAULT 'OK' COMMENT 'OK/INSUFFICIENT',
+  `created_at`      DATETIME     NOT NULL,
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uq_hd_prof_stat` (`run_id`,`symbol`,`metric_code`,`window_years`),
+  KEY `ix_hd_prof_stat_sym` (`symbol`,`metric_code`),
+  KEY `ix_hd_prof_stat_q` (`run_id`,`metric_code`,`current_percentile`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='个股历史分布统计';