- Added support for a detailed chart mode in plot_converging_triangles.py, allowing users to visualize all pivot points and fitting lines. - Improved pivot fitting logic to utilize multiple representative points, enhancing detection accuracy and reducing false positives. - Introduced a new real-time detection mode with flexible zone parameters for better responsiveness in stock analysis. - Updated README.md and USAGE.md to reflect new features and usage instructions. - Added multiple documentation files detailing recent improvements, including pivot point fitting and visualization enhancements. - Cleaned up and archived outdated scripts to streamline the project structure.
9.9 KiB
9.9 KiB
项目文档索引
本文档提供项目所有文档的分类索引,方便快速查找相关资料。
最后更新: 2026-01-26
📚 快速导航
🎯 新手入门
从这里开始了解项目:
-
- 项目概述
- 核心功能
- 快速开始
- 最新更新
-
USAGE.md ⭐
- 环境配置
- 运行脚本
- 参数调整
- 常见问题
-
- 详细使用流程
- 参数说明
- 输出解读
🧮 核心算法
深入理解算法原理:
枢轴点检测
-
- 什么是枢轴点
- k参数的含义
- 检测算法详解
-
- 15天盲区问题
- 四种解决方案
- 方案对比分析
-
枢轴点分段选择算法详解.md ⭐⭐⭐
- 为什么需要分段
- 分段算法完整说明
- 独立分段机制
- 实际案例分析
- 推荐阅读:理解拟合算法的关键
三角形检测
-
- 实时模式完整说明
- 确认枢轴 vs 候选枢轴
- 混合检测策略
-
- 突破强度的定义
- 计算公式
- 评分系统
-
- up / down / none 判定
- break_tol 容忍度
- 计算流程详解
- 常见问题解答
🛠️ 使用指南
配置和使用相关:
-
- 实时模式 vs 标准模式
- 配置方法
- 使用建议
-
- 简洁模式 vs 详细模式
- 如何启用
- 图表元素说明
- 可视化解读
-
converging_triangles_outputs.md
- CSV输出字段说明
- 数据含义
- 筛选方法
📈 改进记录
功能改进历程:
2026-01-26 改进系列
-
- 新增简洁/详细模式切换
- 图表可视化改进
- 使用场景说明
-
- 从2点拟合改进到多点拟合
- 分段选择策略
- 效果对比(19k → 6k)
-
- 上沿线横穿高点问题
- 覆盖性验证机制
- 修复过程记录
-
- 过滤通道形态
- 相向收敛检查
- 三角形类型识别
-
- 当日所有改进汇总
- 改进时间线
- 整体效果评估
-
- 删除测试文件记录
- 文档更新说明
- 项目结构整理
实时模式实施
- 方案4实施完成报告.md
- 实施计划
- 实现细节
- 测试验证
- 使用建议
🔍 问题分析
问题诊断和解决方案:
-
- 问题:15天边界盲区
- 原因:k参数窗口限制
- 方案:四种解决方案对比
- 结论:方案4混合策略
-
- 问题:上沿线横穿最高点
- 原因:旧算法选点策略缺陷
- 修复:覆盖性验证 + 全局极值保护
- 结果:问题完全解决
-
- 问题:通道被误判为三角形
- 原因:缺少相向收敛检查
- 修复:增加斜率方向约束
- 结果:有效过滤通道形态
-
- 问题:视觉明显的低点未被识别
- 原因:枢轴点的严格数学定义
- 解答:四种常见情况分析
- 验证:如何查看和确认
📊 文档类型分类
概述类(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
文档结构
# 标题
**日期**: YYYY-MM-DD
**类型**: [改进/原理/指南/分析]
---
## 目录(可选)
## 概述
## 详细内容
## 总结
## 相关文档(推荐添加)
emoji 使用规范
- ⭐ - 重要文档/推荐阅读
- 🎨 - 可视化相关
- 🔧 - 修复类
- 📊 - 数据/统计相关
- 🎯 - 目标/要点
- ✅ - 完成/正确
- ❌ - 错误/不推荐
🔄 文档更新记录
2026-01-26
- ✅ 新增:枢轴点分段选择算法详解.md
- ✅ 新增:2026-01-26_图表详细模式功能.md
- ✅ 更新:README.md(添加最新改进)
- ✅ 更新:USAGE.md(添加详细模式说明)
- ✅ 更新:多个文档(添加交叉引用)
- ✅ 新增:本文档(文档索引)
更早记录
参见各文档的修改历史。
💡 建议
- 新用户:从 README.md 开始,按推荐路径1学习
- 遇到问题:查看"问题分析"部分的相关文档
- 深入学习:重点阅读标记 ⭐ 的文档
- 实践为主:边运行脚本边查阅文档,效果最好
维护: 请在添加新文档时更新本索引
位置: docs/文档索引.md