# Technical Patterns Lab

技术形态识别研究与实验仓库，聚焦收敛三角形等形态的批量检测、突破强度计算与可视化验证。

## 核心功能

- **收敛三角形检测**：基于枢轴点连线 + 几何约束 + 收敛度判定 + 相向收敛检查
- **批量滚动计算**：支持多股票 × 多交易日的历史检测
- **突破强度评分**：0~1 连续分数，使用加权求和 + tanh 归一化
- **可视化验证**：自动绘制检测窗口与完整历史走势

## 最新更新

**2026-01-26**: 图表可视化改进 - 简洁/详细模式 🎨
- 新增图表详细模式开关：`SHOW_CHART_DETAILS` 或 `--show-details`
- 简洁模式（默认）：仅显示收盘价、上沿线、下沿线
- 详细模式：额外显示所有枢轴点、拟合点、分段线等调试信息
- 详见：`docs/2026-01-26_图表详细模式功能.md`

**2026-01-26**: 改进枢轴点拟合逻辑，使用多点线性回归 📈
- 从"只用2个枢轴点"改为"分段选择3-4个代表性点"进行线性回归
- 拟合精度显著提升，抗噪声能力更强
- 检测质量提高，误检率大幅降低（19k → 6k，过滤假三角形）
- 详见：`docs/2026-01-26_枢轴点拟合改进.md` 📊

**2026-01-26**: 修复上沿线覆盖问题 🔧
- 修复 `fit_pivot_line()` 算法缺陷：确保上/下沿线覆盖所有枢轴点
- 问题：旧算法可能忽略全局最高/低点，导致拟合线横穿关键价格
- 修复：优先选择全局极值点，验证覆盖情况，自动调整选择
- 详见：`docs/2026-01-26_上沿线覆盖问题修复.md`

**2026-01-26**: 实施方案4（混合策略），支持实时模式
- 新增 `pivots_fractal_hybrid()` 函数，区分确认和候选枢轴点
- 支持标准模式（历史回测）和实时模式（实时选股）可配置切换
- 在 `triangle_config.py` 中通过 `REALTIME_MODE` 控制
- 实时模式能捕获最近5天的枢轴点，无15天滞后

**2026-01-26**: 增加"相向收敛"约束，过滤下降/上升通道误判
- ✅ 对称三角形（上沿↓ + 下沿↑）
- ✅ 上升三角形（上沿→ + 下沿↑）
- ✅ 下降三角形（上沿↓ + 下沿→）
- ❌ 下降通道（上沿↓ + 下沿↓）- 现已过滤
- ❌ 上升通道（上沿↑ + 下沿↑）- 现已过滤

详见：
- `docs/2026-01-26_图表详细模式功能.md` - 图表可视化改进 🎨
- `docs/方案4-混合策略详解.md` - 实时模式完整说明 ⭐
- `docs/实时模式使用指南.md` - 快速上手指南
- `docs/2026-01-26_相向收敛约束改进.md` - 过滤通道形态
- `docs/2026-01-26_上沿线覆盖问题修复.md` - 拟合线覆盖修复 🔧
- `docs/2026-01-26_枢轴点拟合改进.md` - 多点回归改进 📊

## 目录结构

```
technical-patterns-lab/
├── src/                    # 核心算法
│   ├── converging_triangle.py   # 收敛三角形检测
│   └── archive/                 # 归档代码
├── scripts/                # 运行脚本
│   ├── pipeline_converging_triangle.py  # 一键流水线
│   ├── run_converging_triangle.py       # 批量检测
│   ├── report_converging_triangles.py   # 生成报告
│   ├── plot_converging_triangles.py     # 绘制图表
│   ├── triangle_config.py               # 统一参数配置
│   └── archive/                         # 归档脚本
├── data/                   # 数据文件
│   ├── open.pkl, high.pkl, low.pkl, close.pkl, volume.pkl
├── outputs/                # 输出结果（已被 gitignore 忽略）
│   └── converging_triangles/   # 收敛三角形结果
└── docs/                   # 文档
```

## 快速开始

```powershell
# 1. 激活环境
.\.venv\Scripts\Activate.ps1

# 2. 安装依赖（首次）
pip install numpy pandas matplotlib

# 3. 一键运行流水线（检测 + 报告 + 图表）
python scripts/pipeline_converging_triangle.py
```

## 输出示例

```
检测结果: N 个有效三角形
- 向上突破: N 次
- 向下突破: N 次
- 当日报告: outputs/converging_triangles/report.md
```

## 相关文档

- `docs/收敛三角形检测系统-使用指南.md` - 使用流程与参数说明
- `docs/突破强度计算方法.md` - 突破强度的计算逻辑
- `docs/converging_triangles_outputs.md` - 输出字段说明
- `docs/枢轴点分段选择算法详解.md` - 分段算法完整说明 ⭐
- `docs/2026-01-26_图表详细模式功能.md` - 图表可视化改进 🎨
- `docs/方案4-混合策略详解.md` - 实时模式完整说明 ⭐
- `docs/实时模式使用指南.md` - 快速上手指南
- `docs/2026-01-26_相向收敛约束改进.md` - 过滤通道形态的改进
- `docs/枢轴点检测原理.md` - 枢轴点算法详解
- `docs/枢轴点边界问题分析.md` - 边界盲区问题与解决方案