# 项目文档索引

本文档提供项目所有文档的分类索引，方便快速查找相关资料。

**最后更新**: 2026-01-26

---

## 📚 快速导航

- [新手入门](#新手入门) - 从这里开始
- [核心算法](#核心算法) - 深入理解算法原理
- [使用指南](#使用指南) - 配置和使用
- [改进记录](#改进记录) - 功能改进历程
- [问题分析](#问题分析) - 问题诊断和解决方案

---

## 🎯 新手入门

从这里开始了解项目：

1. **[README.md](../README.md)** ⭐
   - 项目概述
   - 核心功能
   - 快速开始
   - 最新更新

2. **[USAGE.md](../USAGE.md)** ⭐
   - 环境配置
   - 运行脚本
   - 参数调整
   - 常见问题

3. **[收敛三角形检测系统-使用指南.md](./收敛三角形检测系统-使用指南.md)**
   - 详细使用流程
   - 参数说明
   - 输出解读

---

## 🧮 核心算法

深入理解算法原理：

### 枢轴点检测

1. **[枢轴点检测原理.md](./枢轴点检测原理.md)** ⭐
   - 什么是枢轴点
   - k参数的含义
   - 检测算法详解

2. **[枢轴点边界问题分析.md](./枢轴点边界问题分析.md)**
   - 15天盲区问题
   - 四种解决方案
   - 方案对比分析

3. **[枢轴点分段选择算法详解.md](./枢轴点分段选择算法详解.md)** ⭐⭐⭐
   - 为什么需要分段
   - 分段算法完整说明
   - 独立分段机制
   - 实际案例分析
   - **推荐阅读**：理解拟合算法的关键

### 三角形检测

4. **[方案4-混合策略详解.md](./方案4-混合策略详解.md)** ⭐
   - 实时模式完整说明
   - 确认枢轴 vs 候选枢轴
   - 混合检测策略

5. **[突破强度计算方法.md](./突破强度计算方法.md)**
   - 突破强度的定义
   - 计算公式
   - 评分系统

6. **[突破方向计算逻辑详解.md](./突破方向计算逻辑详解.md)** ⭐
   - up / down / none 判定
   - break_tol 容忍度
   - 计算流程详解
   - 常见问题解答

---

## 🛠️ 使用指南

配置和使用相关：

1. **[实时模式使用指南.md](./实时模式使用指南.md)** ⭐
   - 实时模式 vs 标准模式
   - 配置方法
   - 使用建议

2. **[图表详细模式功能.md](./2026-01-26_图表详细模式功能.md)** 🎨
   - 简洁模式 vs 详细模式
   - 如何启用
   - 图表元素说明
   - 可视化解读

3. **[converging_triangles_outputs.md](./converging_triangles_outputs.md)**
   - CSV输出字段说明
   - 数据含义
   - 筛选方法

---

## 📈 改进记录

功能改进历程：

### 2026-01-26 改进系列

1. **[2026-01-26_图表详细模式功能.md](./2026-01-26_图表详细模式功能.md)** 🎨
   - 新增简洁/详细模式切换
   - 图表可视化改进
   - 使用场景说明

2. **[2026-01-26_枢轴点拟合改进.md](./2026-01-26_枢轴点拟合改进.md)** 📊
   - 从2点拟合改进到多点拟合
   - 分段选择策略
   - 效果对比（19k → 6k）

3. **[2026-01-26_上沿线覆盖问题修复.md](./2026-01-26_上沿线覆盖问题修复.md)** 🔧
   - 上沿线横穿高点问题
   - 覆盖性验证机制
   - 修复过程记录

4. **[2026-01-26_相向收敛约束改进.md](./2026-01-26_相向收敛约束改进.md)**
   - 过滤通道形态
   - 相向收敛检查
   - 三角形类型识别

5. **[2026-01-26_完整改进总结.md](./2026-01-26_完整改进总结.md)**
   - 当日所有改进汇总
   - 改进时间线
   - 整体效果评估

6. **[2026-01-26_项目清理总结.md](./2026-01-26_项目清理总结.md)**
   - 删除测试文件记录
   - 文档更新说明
   - 项目结构整理

### 实时模式实施

7. **[方案4实施完成报告.md](./方案4实施完成报告.md)**
   - 实施计划
   - 实现细节
   - 测试验证
   - 使用建议

---

## 🔍 问题分析

问题诊断和解决方案：

1. **[枢轴点边界问题分析.md](./枢轴点边界问题分析.md)**
   - **问题**：15天边界盲区
   - **原因**：k参数窗口限制
   - **方案**：四种解决方案对比
   - **结论**：方案4混合策略

2. **[2026-01-26_上沿线覆盖问题修复.md](./2026-01-26_上沿线覆盖问题修复.md)**
   - **问题**：上沿线横穿最高点
   - **原因**：旧算法选点策略缺陷
   - **修复**：覆盖性验证 + 全局极值保护
   - **结果**：问题完全解决

3. **[2026-01-26_相向收敛约束改进.md](./2026-01-26_相向收敛约束改进.md)**
   - **问题**：通道被误判为三角形
   - **原因**：缺少相向收敛检查
   - **修复**：增加斜率方向约束
   - **结果**：有效过滤通道形态

4. **[FAQ_为什么某些低点不是枢轴点.md](./FAQ_为什么某些低点不是枢轴点.md)** ⭐
   - **问题**：视觉明显的低点未被识别
   - **原因**：枢轴点的严格数学定义
   - **解答**：四种常见情况分析
   - **验证**：如何查看和确认

---

## 📊 文档类型分类

### 概述类（Overview）
- README.md
- USAGE.md

### 教程类（Tutorial）
- 收敛三角形检测系统-使用指南.md
- 实时模式使用指南.md

### 原理类（Concept）
- 枢轴点检测原理.md
- 枢轴点分段选择算法详解.md ⭐⭐⭐
- 方案4-混合策略详解.md
- 突破强度计算方法.md
- 突破方向计算逻辑详解.md ⭐

### 参考类（Reference）
- converging_triangles_outputs.md
- 图表详细模式功能.md

### 分析类（Analysis）
- 枢轴点边界问题分析.md
- FAQ_为什么某些低点不是枢轴点.md ⭐

### 改进类（Improvement）
- 2026-01-26_图表详细模式功能.md
- 2026-01-26_枢轴点拟合改进.md
- 2026-01-26_上沿线覆盖问题修复.md
- 2026-01-26_相向收敛约束改进.md

### 总结类（Summary）
- 2026-01-26_完整改进总结.md
- 2026-01-26_项目清理总结.md
- 方案4实施完成报告.md

---

## 🎓 推荐阅读路径

### 路径1: 快速上手（新用户）

```
1. README.md                        （5分钟）
   ↓
2. USAGE.md                         （10分钟）
   ↓
3. 收敛三角形检测系统-使用指南.md      （15分钟）
   ↓
4. 运行脚本，查看结果                 （实践）
```

### 路径2: 理解算法（研究者）

```
1. 枢轴点检测原理.md                 （10分钟）
   ↓
2. 枢轴点分段选择算法详解.md ⭐       （30分钟）
   ↓
3. 方案4-混合策略详解.md              （20分钟）
   ↓
4. 突破强度计算方法.md                （10分钟）
```

### 路径3: 可视化理解（视觉学习者）

```
1. 运行脚本生成图表                   （实践）
   ↓
2. plot_converging_triangles.py --show-details （详细模式）
   ↓
3. 图表详细模式功能.md                （15分钟）
   ↓
4. 枢轴点分段选择算法详解.md          （配合图表理解）
```

### 路径4: 深入调试（开发者）

```
1. 枢轴点边界问题分析.md              （问题背景）
   ↓
2. 方案4实施完成报告.md               （解决方案）
   ↓
3. 2026-01-26_上沿线覆盖问题修复.md   （具体案例）
   ↓
4. 阅读源码 src/converging_triangle.py
```

---

## 🔑 关键概念索引

### A-Z

- **Breakout Strength (突破强度)** → 突破强度计算方法.md
- **Candidate Pivot (候选枢轴)** → 方案4-混合策略详解.md
- **Converging Triangle (收敛三角形)** → README.md
- **Coverage Validation (覆盖性验证)** → 2026-01-26_上沿线覆盖问题修复.md
- **Flexible Zone (灵活区域)** → 方案4-混合策略详解.md
- **Fractal Pivot (分形枢轴点)** → 枢轴点检测原理.md
- **Hybrid Strategy (混合策略)** → 方案4-混合策略详解.md
- **k Parameter (k参数)** → 枢轴点检测原理.md
- **Line Fitting (线性拟合)** → 枢轴点分段选择算法详解.md
- **Pivot Point (枢轴点)** → 枢轴点检测原理.md
- **Real-time Mode (实时模式)** → 实时模式使用指南.md
- **Segmentation (分段)** → 枢轴点分段选择算法详解.md
- **Slope Constraint (斜率约束)** → 2026-01-26_相向收敛约束改进.md
- **Standard Mode (标准模式)** → 实时模式使用指南.md

### 中文关键词

- **边界盲区** → 枢轴点边界问题分析.md
- **分段选择** → 枢轴点分段选择算法详解.md ⭐⭐⭐
- **候选枢轴点** → 方案4-混合策略详解.md
- **混合策略** → 方案4-混合策略详解.md
- **确认枢轴点** → 方案4-混合策略详解.md
- **实时模式** → 实时模式使用指南.md
- **枢轴点** → 枢轴点检测原理.md
- **突破强度** → 突破强度计算方法.md
- **相向收敛** → 2026-01-26_相向收敛约束改进.md
- **线性回归** → 枢轴点分段选择算法详解.md

---

## 📝 文档编写规范

### 文档命名

- **日期标记**：`YYYY-MM-DD_描述.md`（改进/修复类）
- **功能描述**：`功能名称.md`（原理/指南类）
- **特殊文档**：`README.md`, `USAGE.md`

### 文档结构

```markdown
# 标题

**日期**: YYYY-MM-DD  
**类型**: [改进/原理/指南/分析]

---

## 目录（可选）

## 概述

## 详细内容

## 总结

## 相关文档（推荐添加）
```

### emoji 使用规范

- ⭐ - 重要文档/推荐阅读
- 🎨 - 可视化相关
- 🔧 - 修复类
- 📊 - 数据/统计相关
- 🎯 - 目标/要点
- ✅ - 完成/正确
- ❌ - 错误/不推荐

---

## 🔄 文档更新记录

### 2026-01-26

- ✅ 新增：枢轴点分段选择算法详解.md
- ✅ 新增：2026-01-26_图表详细模式功能.md
- ✅ 更新：README.md（添加最新改进）
- ✅ 更新：USAGE.md（添加详细模式说明）
- ✅ 更新：多个文档（添加交叉引用）
- ✅ 新增：本文档（文档索引）

### 更早记录

参见各文档的修改历史。

---

## 💡 建议

1. **新用户**：从 README.md 开始，按推荐路径1学习
2. **遇到问题**：查看"问题分析"部分的相关文档
3. **深入学习**：重点阅读标记 ⭐ 的文档
4. **实践为主**：边运行脚本边查阅文档，效果最好

---

**维护**: 请在添加新文档时更新本索引  
**位置**: `docs/文档索引.md`