# ECR-003

**Title:** 主站威科夫分析与图表展示  
**Status:** Done (Reviewed)  
**Date:** 2026-08-06  
**Change Level:** L2  

## Change

在主站 `/` 增加威科夫交易区间、阶段（A–E）、关键事件（Spring/SOS/LPS/UTAD 等）、区间内简易 VP（POC/VAH/VAL）与量能确认；按需接入 `/api/analyze`。

## Motivation

用户需要在缠论图上叠加威科夫结构解读；与现有结构区语义分离。

## Scope

### Allowed

- 新建 `chanlun/analysis/wyckoff/`
- `/api/analyze` 增加可选 `include_wyckoff` 与响应字段 `wyckoff`（可增不可删既有字段）
- 主站 UI 开关与 Lightweight 绘图
- 单测 + ESS 文档

### Forbidden

- 修改笔/段/中枢/买卖点算法语义
- 改 `config/` / `strategies/`
- `/chan_tv` Study
- Vite/React、主站 WebSocket 实时（另 ECR）

## Risk

| Risk | Mitigation |
|------|------------|
| 启发式误标 | 规格写明启发式；UI 可关；单测合成形态 |
| 负载 | 默认关闭，勾选才计算 |
| 与结构区混淆 | 独立开关与字段名 |

## Acceptance Criteria

- [x] `include_wyckoff=1` 返回约定 `wyckoff` 键；默认不强制计算
- [x] 合成 fixture：能检出 TR + 至少一类事件；VP POC 可测
- [x] 主站可开关绘制区间/阶段/事件/VP
- [x] golden 缠论基线不变
- [x] TEST/IMPL/CHANGELOG/TRACEABILITY + CODE_REVIEW

## Rollback

`git revert`；关闭 UI 开关即可无图面影响。

## Risk Review

- `docs/RISK_REVIEW/ECR-003.md` — N/A（展示分析，非 Live 策略）

## Linked

- IDEA: `docs/IDEA/IDEA-004-wyckoff-main.md`
- PRODUCT_SPEC / ENGINEERING_SPEC: 同目录 ECR-003-*
- EXPERIMENT: N/A
- TRACEABILITY: Yes
- CODE_REVIEW: `docs/CODE_REVIEW/ECR-003.md` — Approve