# 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
powershell -ExecutionPolicy Bypass -File .\update_dragon_reports.ps1
```

这条命令会自动完成：

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

### 方法二：手动更新

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

```powershell
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
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`