cyb50-quant/research/dragon/v2/dragon_html_report_usage_cn.md

Dragon HTML 报告使用说明

1. 这套报告是什么

这是一套给 dragon/v2 策略研究使用的 HTML 可视化报告。

当前包含三条策略：

• workbook_preserving
• alpha_first_selective_veto
• alpha_first_glued_refined_hot_cap

主要用途：

• 看三策略最新状态
• 看日常监控是否异常
• 看 refined 和 control 是否出现结构性分歧
• 看总览页上的收益、回撤和年度表现图

2. 主要文件

根目录主页面：

• dragon_reports_index.html
• dragon_daily_signal_report.html
• dragon_forward_weekly_review.html
• dragon_historical_trade_details.html

归档页面目录：

• html_reports/

一键更新脚本：

• update_dragon_reports.ps1

HTML 生成代码：

• dragon_html_reports.py

3. 如何打开

推荐直接在资源管理器里双击以下文件：

1. dragon_reports_index.html
2. dragon_daily_signal_report.html
3. dragon_forward_weekly_review.html

建议先打开：

• dragon_reports_index.html

因为它是总入口页，里面已经放了日报、周报和归档链接。

4. 如何更新报告

方法一：一键更新，推荐

在当前目录打开 PowerShell，执行：

powershell -ExecutionPolicy Bypass -File .\update_dragon_reports.ps1

这条命令会自动完成：

• 重新跑前向观察管线
• 刷新最新日报
• 刷新最新周报
• 刷新首页
• 更新 html_reports/ 下的归档页面

方法二：手动更新

如果你只想手动执行，也可以运行：

py .\dragon_forward_observation_pipeline.py

这条命令内部会联动生成：

• CSV 快照
• markdown 报告
• HTML 报告

5. 页面分别看什么

dragon_reports_index.html

总览页，适合先看全局。

主要内容：

• RC1 摘要卡片
• 三策略对照卡片
• 累计净值曲线
• 年度收益对比图
• 回撤摘要表
• 各页面入口

dragon_daily_signal_report.html

日报页，适合每天看最新状态。

主要内容：

• 三策略最新状态
• 最新真实事件
• 是否持仓
• 最新 A1 / B1 / C1
• 监控快照
• 最近信号变化
• refined vs control 分歧记录

dragon_forward_weekly_review.html

周报页，适合看前向观察阶段的滚动情况。

主要内容：

• 周度汇总
• 最近观察记录
• 分歧历史
• warning / hard breach 统计

dragon_historical_trade_details.html

历史全量明细页，适合逐笔核对历史交易。

里面有：

• 买入日期
• 买入价格
• 买入触发条件
• 卖出日期
• 卖出价格
• 卖出触发条件
• 持有天数
• 单笔收益
• 交易前资金
• 单笔盈亏
• 交易后资金
• 策略筛选
• 年份筛选
• 关键词搜索

6. 归档文件说明

html_reports/ 目录下保存按日期归档的 HTML 页面，例如：

• dragon_reports_index_2026-04-03.html
• dragon_daily_signal_report_2026-04-03.html
• dragon_forward_weekly_review_2026-04-03.html

这些文件用于保留当时的快照，避免后续更新覆盖历史页面。

7. 常见问题

7.1 页面中文乱码怎么办

先确认是在浏览器里打开，而不是直接用 PowerShell 看文件内容。

说明：

• HTML 文件本身是 UTF-8 编码
• 之前出现的乱码主要是 PowerShell 终端显示问题
• 浏览器正常打开通常不会有这个问题

7.2 页面链接点击报错怎么办

当前版本已经修复：

• 根目录页面
• html_reports/ 归档页面

这两类页面现在分别使用不同的相对路径，正常点击应当不会再跳错。

如果你更新后仍有问题，先重新执行：

powershell -ExecutionPolicy Bypass -File .\update_dragon_reports.ps1

8. 当前建议使用方式

日常使用建议：

1. 先运行一键更新脚本
2. 打开 dragon_reports_index.html
3. 需要看细节时，再点进日报或周报

如果你只关心最新交易状态，直接看：

• dragon_daily_signal_report.html

如果你要逐笔核对历史流水，直接看：

• dragon_historical_trade_details.html

如果你要看一段时间内是否稳定，直接看：

• dragon_forward_weekly_review.html