# ENGINEERING_SPEC — ECR-004

**Status:** Draft  
**Date:** 2026-08-06  

## Range scoring

替换「仅取最长合格窗口」：

1. 仍在 `lookback` + `tail_reserve` 框架内扫描候选段（步长可保留）。  
2. 对每段计算分数，例如：  
   - `touch_score` = near_hi + near_lo（触边上沿/下沿次数）  
   - `width_penalty` = width / ATR（过宽扣分）  
   - `recency_bonus` = 段终点靠近 core 末  
   - 可选：段内 close 在 [low,high] 比例  
3. 取分数最高且满足既有硬门槛（near_hi/lo≥2、inside≥0.75 等）的段。  
4. 单测：`_box_df` 断言 `low∈[38,42]`、`high∈[58,62]`，且 `start` 不早于箱体起始（允许小容差）。

## Phases

- 为 A–E 设最小 bar 数（如 ≥3）；不足则与相邻段合并或跳过空标签。  
- 避免 D/E 完全同起止仍输出两条重复色带。

## API gate

```text
if include_wyckoff and not elements_only:
    result["wyckoff"] = analyze_wyckoff(...)
```

## Frontend VP

任选其一（ENG 实现时定一种并写进 IMPL）：

- **A**：只画 volume>0 的 bin，且最多 N 条（按 volume 取 Top-N），POC/VAH/VAL 仍全画  
- **B**：用少量水平线 + 透明度映射，或单 series 多段（若 Lightweight 版本支持）  
- **C**：服务端默认 `vp_bins` 上限降到 24，前端再 Top-N  

区间填充线可从 6 降到 3。

## Tests

- 扩展 `tests/test_wyckoff.py`  
- 契约：`elements_only=true&include_wyckoff=1` 无 `wyckoff`  
- 不改 golden 缠论 JSON