# 标准化HTML查看器 - 快速使用指南

## 一键运行

```bash
python scripts/pipeline_converging_triangle.py --clean --all-stocks
```

这将生成 `outputs/converging_triangles/stock_viewer.html`，用浏览器打开即可。

## 界面功能

### 1. 预设模式（顶部）

点击切换4种分析模式：

- **等权模式**: 各维度权重1/6，适合探索性分析
- **激进模式**: 重视突破(35%)和成交量(25%)，适合趋势行情
- **保守模式**: 重视收敛度(30%)和活跃度(25%)，适合震荡市
- **放量模式**: 重视成交量(35%)，捕获主力异动

### 2. 搜索和排序

- **搜索框**: 输入股票代码或名称快速定位
- **排序选择**: 10种排序方式
  - 5种强度分（原始/等权/激进/保守/放量）
  - 3种形态指标（宽度比/触碰次数）
  - 3种标准化维度（收敛度/成交量/形态规则度）

### 3. 基础筛选

- **突破方向**: 全部/向上/向下/无
- **放量确认**: 全部/已确认/未确认
- **强度阈值**: 拖动滑块设置最低强度分

### 4. 高级维度筛选（可展开）

点击"高级维度筛选"展开，设置6个标准化维度的最低阈值：
- 突破幅度 ≥
- 收敛度 ≥
- 成交量 ≥
- 形态规则度 ≥
- 活跃度 ≥
- 倾斜度 ≥

**使用场景示例**:
```
场景1：寻找高质量形态
  - 收敛度 ≥ 0.70
  - 形态规则度 ≥ 0.60
  
场景2：寻找放量突破
  - 突破幅度 ≥ 0.70
  - 成交量 ≥ 0.70
  
场景3：寻找对称三角形
  - 倾斜度 ≥ 0.80 (接近0.5表示对称)
  - 收敛度 ≥ 0.60
```

### 5. 股票卡片

每张卡片显示：
- **头部**: 股票名称、代码、当前模式强度分
- **指标网格**: 突破方向、宽度比、触碰次数、放量确认、活跃度、倾斜度
- **标准化维度面板**: 6个维度的进度条 + 迷你雷达图
- **图表**: 收敛三角形可视化（点击放大）

### 6. 迷你雷达图

右上角的小雷达图直观展示6个维度：
- 12点方向: 突破幅度
- 2点方向: 收敛度
- 4点方向: 成交量
- 6点方向: 形态规则
- 8点方向: 活跃度
- 10点方向: 倾斜度

**雷达图越满 = 形态质量越高**

## 典型使用流程

### 流程1: 快速筛选高分股票

1. 选择**等权模式**
2. 拖动**强度阈值**到0.70
3. 查看Top 10股票
4. 点击图表查看详情

### 流程2: 寻找激进突破信号

1. 选择**激进模式**
2. 设置**突破方向** = 向上
3. 设置**放量确认** = 已确认
4. 展开高级筛选：
   - 突破幅度 ≥ 0.70
   - 成交量 ≥ 0.70
5. 按激进强度分排序

### 流程3: 对比不同模式

1. 记录等权模式Top 10股票
2. 切换到激进模式，观察排序变化
3. 切换到保守模式，观察哪些股票持续高分
4. **持续高分的股票 = 全方位优质形态**

### 流程4: 研究特定股票

1. 在搜索框输入股票代码/名称
2. 查看雷达图，识别优势/劣势维度
3. 查看标准化维度进度条，了解具体分值
4. 切换不同模式，观察不同视角下的评分

## 数据解读

### 标准化维度含义

所有维度都标准化到0-1范围，中位数=0.5：

| 维度 | 含义 | 0.5以下 | 0.5-0.7 | 0.7以上 |
|------|------|---------|---------|---------|
| 突破幅度 | 突破线的强度 | 弱/未突破 | 适中 | 强突破 |
| 收敛度 | 三角形收敛程度 | 松散 | 一般 | 收敛良好 |
| 成交量 | 放量程度 | 缩量/无放量 | 适中 | 明显放量 |
| 形态规则 | 三角形规整度 | 不规则 | 一般 | 标准形态 |
| 活跃度 | 价格波动活跃度 | 平淡 | 适中 | 活跃 |
| 倾斜度 | 0.5=对称 | 下倾 | 对称 | 上倾 |

### 强度分含义

| 分值范围 | 含义 |
|----------|------|
| 0.0-0.3 | 形态质量差，不建议关注 |
| 0.3-0.5 | 形态一般，需结合其他指标 |
| 0.5-0.7 | 形态良好，可以关注 |
| 0.7-0.85 | 形态优秀，重点关注 |
| 0.85+ | 形态极优，高度重点关注 |

## 快捷键

- `Esc`: 关闭图表放大视图

## 性能提示

- 首次加载可能需要1-2秒（绘制所有雷达图）
- 筛选和排序是实时的
- 建议先用基础筛选缩小范围，再用高级筛选精确定位

## 故障排除

**问题**: 强度分都是原始值，没有等权/激进等模式

**原因**: scoring模块未正确导入

**解决**: 确保运行pipeline时没有错误信息

---

**问题**: 雷达图不显示

**原因**: 浏览器不支持Canvas或JavaScript被禁用

**解决**: 使用现代浏览器（Chrome/Edge/Firefox）

---

**问题**: 维度进度条都是0

**原因**: 数据未标准化

**解决**: 重新运行pipeline生成HTML

## 更多帮助

查看完整文档: `docs/Pipeline与HTML集成标准化_实施完成报告.md`