- 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.
Scripts Archive
本目录存放已归档的脚本文件。
📦 归档内容
演示脚本(Demo Scripts)
这些脚本用于演示和教学,但日常使用频率较低:
1. demo_pivot_detection.py
- 用途: 枢轴点检测原理可视化演示
- 功能: 对比不同 k 值(3, 8, 15)的检测效果
- 输出: 生成图表到
docs/images/pivot_detection_demo.png - 运行:
python scripts/archive/demo_pivot_detection.py - 适用: 学习枢轴点检测原理、教学培训
2. demo_segmentation.py
- 用途: 分段选择算法演示
- 功能: 展示如何从多个枢轴点中选择代表点
- 演示案例:
- 6个高点 → 分3段 → 选3个最高点
- 4个低点 → 不分段 → 使用所有点
- 8个高点 → 分3段 → 选3个最高点
- 运行:
python scripts/archive/demo_segmentation.py - 适用: 理解趋势线拟合算法、调试拟合问题
3. demo_flexible_zone.py
- 用途: FLEXIBLE_ZONE 参数效果演示
- 功能: 对比不同 flex 值(1, 3, 5, 7, 10, 15)的影响
- 演示场景:
- 基础演示:不同 flex 值捕获的枢轴点数量
- 实际场景:股票突破三角形的实时检测
- 运行:
python scripts/archive/demo_flexible_zone.py - 适用: 选择合适的 FLEXIBLE_ZONE 值、理解实时模式
旧版本脚本(Legacy Scripts)
4. run_sym_triangle_json.py
- 用途: 旧版对称三角形检测(JSON输入)
- 状态: 已被新版
run_converging_triangle.py替代 - 保留原因: 历史参考
5. run_sym_triangle_pkl.py
- 用途: 旧版对称三角形检测(PKL输入)
- 状态: 已被新版
run_converging_triangle.py替代 - 保留原因: 历史参考
🔍 为什么归档?
演示脚本归档原因
- 使用频率低: 主要用于学习和教学,不是日常工作流的一部分
- 功能完整: 文档已经很详细,代码作为补充材料
- 保持简洁: 主目录只保留核心运行脚本
旧版本脚本归档原因
- 功能已替代: 新版本更强大、更完善
- 历史参考: 保留供对比和回溯
- 避免混淆: 防止误用旧版本
📚 相关文档
演示脚本对应的文档(这些文档更详细、更容易理解):
- 枢轴点检测:
docs/枢轴点检测原理.md - 分段选择:
docs/枢轴点分段选择算法详解.md - 实时模式:
docs/实时模式使用指南.md - FAQ:
docs/FAQ_为什么某些低点不是枢轴点.md
🎯 当前主要脚本
主目录 scripts/ 中保留的核心脚本:
运行脚本
- ✅
run_converging_triangle.py- 批量检测三角形 - ✅
plot_converging_triangles.py- 生成图表 - ✅
pipeline_converging_triangle.py- 完整流水线 - ✅
report_converging_triangles.py- 生成报告
测试脚本
- ✅
test_realtime_mode.py- 实时模式测试
配置文件
- ✅
triangle_config.py- 统一配置
📝 使用建议
日常使用
直接使用主目录的核心脚本即可,无需关注归档脚本。
学习和研究
如果想深入理解算法原理,可以运行归档目录中的演示脚本:
# 学习枢轴点检测
python scripts/archive/demo_pivot_detection.py
# 理解分段选择
python scripts/archive/demo_segmentation.py
# 研究实时模式
python scripts/archive/demo_flexible_zone.py
教学和培训
演示脚本非常适合用于教学:
- 生成可视化图表
- 逐步展示算法过程
- 对比不同参数的效果
🗂️ 归档历史
| 日期 | 文件 | 原因 |
|---|---|---|
| 2026-01-26 | demo_*.py (3个) | 演示脚本,日常使用频率低 |
| 之前 | run_sym_triangle_*.py (2个) | 旧版本,已被新版替代 |
注意: 归档脚本仍然可以正常运行,只是不再是主要工作流的一部分。