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

从 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。
This commit is contained in:
2026-10-03 13:54:56 +08:00
commit fce725e13c
127 changed files with 28001 additions and 0 deletions
+35
View File
@@ -0,0 +1,35 @@
-- 扩展财务指标(G4;带 announce_date 以支持 PIT)
-- 由 src/hdiv/data/schema.py 生成,请勿手工修改
CREATE TABLE IF NOT EXISTS `hd_fina_indicator` (
`id` BIGINT NOT NULL AUTO_INCREMENT,
`symbol` VARCHAR(12) NOT NULL,
`end_date` DATE NOT NULL COMMENT '报告期',
`ann_date` DATE NOT NULL COMMENT '公告日 —— PIT 关键字段',
`eps` DECIMAL(16,6) NULL,
`roe` DECIMAL(16,6) NULL COMMENT '净资产收益率 %',
`roe_waa` DECIMAL(16,6) NULL COMMENT '加权平均 ROE %',
`roe_dt` DECIMAL(16,6) NULL COMMENT '扣非 ROE %',
`roa` DECIMAL(16,6) NULL,
`roic` DECIMAL(16,6) NULL COMMENT '投入资本回报率 %',
`grossprofit_margin` DECIMAL(16,6) NULL COMMENT '毛利率 %',
`netprofit_margin` DECIMAL(16,6) NULL COMMENT '净利率 %',
`debt_to_assets` DECIMAL(16,6) NULL COMMENT '资产负债率 %',
`current_ratio` DECIMAL(16,6) NULL,
`quick_ratio` DECIMAL(16,6) NULL,
`ocf_to_or` DECIMAL(16,6) NULL COMMENT '经营现金流/营收 %',
`ocf_to_opincome` DECIMAL(16,6) NULL COMMENT '经营现金流/经营利润 %',
`ocf_to_profit` DECIMAL(16,6) NULL COMMENT '经营现金流/净利润(盈利质量)',
`netdebt` DECIMAL(24,4) NULL,
`interestdebt` DECIMAL(24,4) NULL,
`ebit` DECIMAL(24,4) NULL,
`ebitda` DECIMAL(24,4) NULL,
`interest_cover` DECIMAL(16,6) NULL COMMENT '利息保障倍数',
`fcff` DECIMAL(24,4) NULL COMMENT '企业自由现金流',
`fcfe` DECIMAL(24,4) NULL COMMENT '股权自由现金流',
`source` VARCHAR(16) NOT NULL DEFAULT 'tushare',
`created_at` DATETIME NOT NULL,
PRIMARY KEY (`id`),
UNIQUE KEY `uq_hd_fina` (`symbol`,`end_date`,`ann_date`),
KEY `ix_hd_fina_pit` (`symbol`,`ann_date`),
KEY `ix_hd_fina_end` (`end_date`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='扩展财务指标(PIT)';