褚宏光 6d545eb231 Enhance converging triangle detection with new features and documentation updates

- 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.

2026-01-26 16:21:36 +08:00

8.4 KiB

Raw Permalink Blame History

项目清理总结

日期: 2026-01-26
操作: 清理测试文件 + 文档更新

🗑️ 已删除的文件

一次性验证测试文件

这些文件是为了验证特定问题或功能而创建的临时测试脚本，问题已修复/功能已实施，不再需要：

scripts/test_boundary_issue.py
- 用途：验证枢轴点边界问题（15天盲区）
- 状态：问题已通过"方案4"解决
- 删除原因：问题已修复，演示功能由 demo_pivot_detection.py 保留
scripts/test_slope_constraint.py
- 用途：测试"相向收敛"约束功能
- 状态：约束已实施到主代码中
- 删除原因：功能已集成，不需要独立测试
scripts/test_upper_line_coverage.py
- 用途：测试上沿线覆盖问题修复
- 状态：修复已验证并合并
- 删除原因：修复已完成，测试已通过
scripts/test_lower_line_issue.py
- 用途：测试下沿线横穿问题
- 状态：验证为正常突破，非bug
- 删除原因：验证完成
scripts/test_candidate_pivot_simple.py
- 用途：测试候选枢轴点检测
- 状态：功能已集成到实时模式
- 删除原因：功能已稳定
scripts/debug_sz001391.py
- 用途：调试特定股票问题
- 状态：问题已定位和解决
- 删除原因：临时调试文件
src/converging_triangle_v2.py
- 用途：重构版本测试
- 状态：已合并到主代码
- 删除原因：功能已集成
scripts/why_30_not_pivot.py (2026-01-26)
- 用途：分析特定低点不是枢轴点的原因
- 状态：内容已沉淀为 FAQ 文档
- 删除原因：知识已归档到 docs/FAQ_为什么某些低点不是枢轴点.md
scripts/analyze_sz300892.py (2026-01-26)
- 用途：分析 SZ300892 股票的枢轴点
- 状态：一次性分析完成
- 删除原因：针对特定股票的临时分析
scripts/analyze_sz300892_simple.py (2026-01-26)
- 用途：简化版股票分析
- 状态：一次性分析完成
- 删除原因：针对特定股票的临时分析

演示脚本归档

为保持主目录简洁，将演示脚本归档到 scripts/archive/：

scripts/demo_segmentation.py → scripts/archive/demo_segmentation.py (2026-01-26)
- 用途：演示分段选择算法
- 状态：功能完整，教学价值高
- 归档原因：日常使用频率低，不是核心工作流的一部分
- 访问方式：python scripts/archive/demo_segmentation.py
scripts/demo_pivot_detection.py → scripts/archive/demo_pivot_detection.py (2026-01-26)
- 用途：枢轴点检测可视化演示
- 状态：功能完整，教学价值高
- 归档原因：日常使用频率低，文档已经很详细
- 访问方式：python scripts/archive/demo_pivot_detection.py
scripts/demo_flexible_zone.py → scripts/archive/demo_flexible_zone.py (2026-01-26)
- 用途：FLEXIBLE_ZONE 参数效果演示
- 状态：功能完整，参数调优参考
- 归档原因：日常使用频率低
- 访问方式：python scripts/archive/demo_flexible_zone.py

✅ 保留的文件

核心功能脚本 (scripts/)

scripts/run_converging_triangle.py - 主检测脚本
scripts/plot_converging_triangles.py - 绘图脚本
scripts/report_converging_triangles.py - 报告生成
scripts/pipeline_converging_triangle.py - 完整流程
scripts/triangle_config.py - 配置文件
scripts/test_realtime_mode.py - 实时模式测试

演示脚本 (已归档到 scripts/archive/)

scripts/archive/demo_pivot_detection.py (已归档 2026-01-26)
- 用途：演示枢轴点检测原理
- 价值：教学用途，帮助理解 k 参数的含义
- 归档原因：日常使用频率低
scripts/archive/demo_flexible_zone.py (已归档 2026-01-26)
- 用途：演示 FLEXIBLE_ZONE 参数效果
- 价值：帮助理解实时模式配置
- 归档原因：日常使用频率低
scripts/archive/demo_segmentation.py (已归档 2026-01-26)
- 用途：演示分段选择算法
- 价值：理解趋势线拟合算法
- 归档原因：日常使用频率低

旧版本脚本 (scripts/archive/)

scripts/archive/run_sym_triangle_json.py - 旧版本（JSON格式）
scripts/archive/run_sym_triangle_pkl.py - 旧版本（PKL格式）
scripts/archive/README.md - 归档说明文档 (新增 2026-01-26)
scripts/archive/run_sym_triangle_pkl.py - 旧版本（PKL格式）
- 保留原因：历史参考

📂 当前文件结构

scripts/
├── __pycache__/
├── archive/                        # 归档目录
│   ├── run_sym_triangle_json.py   # 旧版本
│   └── run_sym_triangle_pkl.py    # 旧版本
├── demo_flexible_zone.py          # 演示：FLEXIBLE_ZONE 参数
├── demo_pivot_detection.py        # 演示：枢轴点检测原理
├── pipeline_converging_triangle.py # 完整检测流程
├── plot_converging_triangles.py   # 绘图脚本
├── report_converging_triangles.py # 报告生成
├── run_converging_triangle.py     # 主检测脚本 ⭐
├── test_realtime_mode.py          # 测试：实时模式
└── triangle_config.py             # 配置文件 ⭐

精简度: 从 12 个文件 → 9 个文件（删除 3 个一次性测试）

📝 文档更新

新增文档

docs/2026-01-26_上沿线覆盖问题修复.md
- 详细记录问题、原因、修复、验证
- 包含修复前后对比
- 用户反馈记录
docs/枢轴点分段选择算法详解.md (2026-01-26)
- 600+ 行完整算法说明
- 包含代码实现、案例分析、可视化说明
- 核心技术文档
docs/2026-01-26_图表详细模式功能.md (2026-01-26)
- 简洁/详细模式使用指南
- 图表元素说明
- 使用场景分析
docs/文档索引.md (2026-01-26)
- 全部文档分类索引
- 推荐阅读路径
- 关键概念索引
docs/FAQ_为什么某些低点不是枢轴点.md (2026-01-26)
- 常见问题解答
- 四种情况分析
- 实际案例说明
- 从临时分析脚本沉淀而来

更新文档

README.md
- 添加"上沿线覆盖问题修复"到最新更新
- 添加新文档链接
- 更新文档索引
USAGE.md (2026-01-26)
- 添加图表详细模式说明
- 添加文件名格式说明
- 更新使用示例

🎯 清理原则

✅ 保留条件

有持续使用价值（核心功能脚本）
有教学价值（演示脚本）
有验证价值（核心功能测试）
有历史价值（归档文件）

🗑️ 删除条件

一次性验证：问题已修复，测试已通过
临时调试：仅用于临时问题排查
功能重复：与其他文件功能重复

📊 统计

类型	修复前	修复后	变化
核心脚本	5	5	-
演示脚本	3	3	-
测试脚本	4	1	-3 ✓
归档文件	2	2	-
总计	12	9	-3

✨ 清理效果

✅ 移除了临时验证文件，保持项目整洁
✅ 保留了有价值的演示和测试脚本
✅ 文档完善，问题修复有据可查
✅ 目录结构清晰，易于维护

🔗 相关文档

上沿线覆盖问题修复 - 最新修复 🔧
枢轴点拟合改进 - 多点回归改进 📊
枢轴点分段选择算法详解 - 分段算法完整说明 ⭐
图表详细模式功能 - 图表可视化改进 🎨
方案4实施完成报告 - 实时模式
实时模式使用指南 - 快速上手
相向收敛约束改进 - 通道过滤
枢轴点检测原理 - 基础概念
枢轴点边界问题分析 - 问题分析

🎉 总结

项目清理完成！现在项目结构更加清晰：

核心功能 - 完整保留
教学演示 - 精选保留
临时测试 - 清理完毕
文档记录 - 完善更新

所有修复和改进都有完整的文档记录，便于后续维护和理解。

8.4 KiB Raw Permalink Blame History Unescape Escape