褚宏光
6d545eb231
- 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.
255 lines
8.4 KiB
Markdown
255 lines
8.4 KiB
Markdown
# 项目清理总结
|
||
|
||
**日期**: 2026-01-26
|
||
**操作**: 清理测试文件 + 文档更新
|
||
|
||
---
|
||
|
||
## 🗑️ 已删除的文件
|
||
|
||
### 一次性验证测试文件
|
||
|
||
这些文件是为了验证特定问题或功能而创建的临时测试脚本，问题已修复/功能已实施，不再需要：
|
||
|
||
1. **scripts/test_boundary_issue.py**
|
||
- 用途：验证枢轴点边界问题（15天盲区）
|
||
- 状态：问题已通过"方案4"解决
|
||
- 删除原因：问题已修复，演示功能由 `demo_pivot_detection.py` 保留
|
||
|
||
2. **scripts/test_slope_constraint.py**
|
||
- 用途：测试"相向收敛"约束功能
|
||
- 状态：约束已实施到主代码中
|
||
- 删除原因：功能已集成，不需要独立测试
|
||
|
||
3. **scripts/test_upper_line_coverage.py**
|
||
- 用途：测试上沿线覆盖问题修复
|
||
- 状态：修复已验证并合并
|
||
- 删除原因：修复已完成，测试已通过
|
||
|
||
4. **scripts/test_lower_line_issue.py**
|
||
- 用途：测试下沿线横穿问题
|
||
- 状态：验证为正常突破，非bug
|
||
- 删除原因：验证完成
|
||
|
||
5. **scripts/test_candidate_pivot_simple.py**
|
||
- 用途：测试候选枢轴点检测
|
||
- 状态：功能已集成到实时模式
|
||
- 删除原因：功能已稳定
|
||
|
||
6. **scripts/debug_sz001391.py**
|
||
- 用途：调试特定股票问题
|
||
- 状态：问题已定位和解决
|
||
- 删除原因：临时调试文件
|
||
|
||
7. **src/converging_triangle_v2.py**
|
||
- 用途：重构版本测试
|
||
- 状态：已合并到主代码
|
||
- 删除原因：功能已集成
|
||
|
||
8. **scripts/why_30_not_pivot.py** (2026-01-26)
|
||
- 用途：分析特定低点不是枢轴点的原因
|
||
- 状态：内容已沉淀为 FAQ 文档
|
||
- 删除原因：知识已归档到 `docs/FAQ_为什么某些低点不是枢轴点.md`
|
||
|
||
9. **scripts/analyze_sz300892.py** (2026-01-26)
|
||
- 用途：分析 SZ300892 股票的枢轴点
|
||
- 状态：一次性分析完成
|
||
- 删除原因：针对特定股票的临时分析
|
||
|
||
10. **scripts/analyze_sz300892_simple.py** (2026-01-26)
|
||
- 用途：简化版股票分析
|
||
- 状态：一次性分析完成
|
||
- 删除原因：针对特定股票的临时分析
|
||
|
||
### 演示脚本归档
|
||
|
||
为保持主目录简洁，将演示脚本归档到 `scripts/archive/`：
|
||
|
||
11. **scripts/demo_segmentation.py** → **scripts/archive/demo_segmentation.py** (2026-01-26)
|
||
- 用途：演示分段选择算法
|
||
- 状态：功能完整，教学价值高
|
||
- 归档原因：日常使用频率低，不是核心工作流的一部分
|
||
- 访问方式：`python scripts/archive/demo_segmentation.py`
|
||
|
||
12. **scripts/demo_pivot_detection.py** → **scripts/archive/demo_pivot_detection.py** (2026-01-26)
|
||
- 用途：枢轴点检测可视化演示
|
||
- 状态：功能完整，教学价值高
|
||
- 归档原因：日常使用频率低，文档已经很详细
|
||
- 访问方式：`python scripts/archive/demo_pivot_detection.py`
|
||
|
||
13. **scripts/demo_flexible_zone.py** → **scripts/archive/demo_flexible_zone.py** (2026-01-26)
|
||
- 用途：FLEXIBLE_ZONE 参数效果演示
|
||
- 状态：功能完整，参数调优参考
|
||
- 归档原因：日常使用频率低
|
||
- 访问方式：`python scripts/archive/demo_flexible_zone.py`
|
||
|
||
---
|
||
|
||
## ✅ 保留的文件
|
||
|
||
### 核心功能脚本 (scripts/)
|
||
|
||
1. **scripts/run_converging_triangle.py** - 主检测脚本
|
||
2. **scripts/plot_converging_triangles.py** - 绘图脚本
|
||
3. **scripts/report_converging_triangles.py** - 报告生成
|
||
4. **scripts/pipeline_converging_triangle.py** - 完整流程
|
||
5. **scripts/triangle_config.py** - 配置文件
|
||
6. **scripts/test_realtime_mode.py** - 实时模式测试
|
||
|
||
### 演示脚本 (已归档到 scripts/archive/)
|
||
|
||
7. **scripts/archive/demo_pivot_detection.py** (已归档 2026-01-26)
|
||
- 用途：演示枢轴点检测原理
|
||
- 价值：教学用途，帮助理解 k 参数的含义
|
||
- 归档原因：日常使用频率低
|
||
|
||
8. **scripts/archive/demo_flexible_zone.py** (已归档 2026-01-26)
|
||
- 用途：演示 FLEXIBLE_ZONE 参数效果
|
||
- 价值：帮助理解实时模式配置
|
||
- 归档原因：日常使用频率低
|
||
|
||
9. **scripts/archive/demo_segmentation.py** (已归档 2026-01-26)
|
||
- 用途：演示分段选择算法
|
||
- 价值：理解趋势线拟合算法
|
||
- 归档原因：日常使用频率低
|
||
|
||
### 旧版本脚本 (scripts/archive/)
|
||
|
||
10. **scripts/archive/run_sym_triangle_json.py** - 旧版本（JSON格式）
|
||
11. **scripts/archive/run_sym_triangle_pkl.py** - 旧版本（PKL格式）
|
||
12. **scripts/archive/README.md** - 归档说明文档 (新增 2026-01-26)
|
||
10. **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 个一次性测试）
|
||
|
||
---
|
||
|
||
## 📝 文档更新
|
||
|
||
### 新增文档
|
||
|
||
1. **docs/2026-01-26_上沿线覆盖问题修复.md**
|
||
- 详细记录问题、原因、修复、验证
|
||
- 包含修复前后对比
|
||
- 用户反馈记录
|
||
|
||
2. **docs/枢轴点分段选择算法详解.md** (2026-01-26)
|
||
- 600+ 行完整算法说明
|
||
- 包含代码实现、案例分析、可视化说明
|
||
- 核心技术文档
|
||
|
||
3. **docs/2026-01-26_图表详细模式功能.md** (2026-01-26)
|
||
- 简洁/详细模式使用指南
|
||
- 图表元素说明
|
||
- 使用场景分析
|
||
|
||
4. **docs/文档索引.md** (2026-01-26)
|
||
- 全部文档分类索引
|
||
- 推荐阅读路径
|
||
- 关键概念索引
|
||
|
||
5. **docs/FAQ_为什么某些低点不是枢轴点.md** (2026-01-26)
|
||
- 常见问题解答
|
||
- 四种情况分析
|
||
- 实际案例说明
|
||
- 从临时分析脚本沉淀而来
|
||
|
||
### 更新文档
|
||
|
||
6. **README.md**
|
||
- 添加"上沿线覆盖问题修复"到最新更新
|
||
- 添加新文档链接
|
||
- 更新文档索引
|
||
|
||
7. **USAGE.md** (2026-01-26)
|
||
- 添加图表详细模式说明
|
||
- 添加文件名格式说明
|
||
- 更新使用示例
|
||
|
||
---
|
||
|
||
## 🎯 清理原则
|
||
|
||
### ✅ 保留条件
|
||
|
||
- 有**持续使用价值**（核心功能脚本）
|
||
- 有**教学价值**（演示脚本）
|
||
- 有**验证价值**（核心功能测试）
|
||
- 有**历史价值**（归档文件）
|
||
|
||
### 🗑️ 删除条件
|
||
|
||
- **一次性验证**：问题已修复，测试已通过
|
||
- **临时调试**：仅用于临时问题排查
|
||
- **功能重复**：与其他文件功能重复
|
||
|
||
---
|
||
|
||
## 📊 统计
|
||
|
||
| 类型 | 修复前 | 修复后 | 变化 |
|
||
|------|--------|--------|------|
|
||
| **核心脚本** | 5 | 5 | - |
|
||
| **演示脚本** | 3 | 3 | - |
|
||
| **测试脚本** | 4 | 1 | -3 ✓ |
|
||
| **归档文件** | 2 | 2 | - |
|
||
| **总计** | 12 | 9 | -3 |
|
||
|
||
---
|
||
|
||
## ✨ 清理效果
|
||
|
||
- ✅ 移除了临时验证文件，保持项目整洁
|
||
- ✅ 保留了有价值的演示和测试脚本
|
||
- ✅ 文档完善，问题修复有据可查
|
||
- ✅ 目录结构清晰，易于维护
|
||
|
||
---
|
||
|
||
## 🔗 相关文档
|
||
|
||
- [上沿线覆盖问题修复](./2026-01-26_上沿线覆盖问题修复.md) - 最新修复 🔧
|
||
- [枢轴点拟合改进](./2026-01-26_枢轴点拟合改进.md) - 多点回归改进 📊
|
||
- [枢轴点分段选择算法详解](./枢轴点分段选择算法详解.md) - 分段算法完整说明 ⭐
|
||
- [图表详细模式功能](./2026-01-26_图表详细模式功能.md) - 图表可视化改进 🎨
|
||
- [方案4实施完成报告](./方案4实施完成报告.md) - 实时模式
|
||
- [实时模式使用指南](./实时模式使用指南.md) - 快速上手
|
||
- [相向收敛约束改进](./2026-01-26_相向收敛约束改进.md) - 通道过滤
|
||
- [枢轴点检测原理](./枢轴点检测原理.md) - 基础概念
|
||
- [枢轴点边界问题分析](./枢轴点边界问题分析.md) - 问题分析
|
||
|
||
---
|
||
|
||
## 🎉 总结
|
||
|
||
项目清理完成！现在项目结构更加清晰：
|
||
|
||
1. **核心功能** - 完整保留
|
||
2. **教学演示** - 精选保留
|
||
3. **临时测试** - 清理完毕
|
||
4. **文档记录** - 完善更新
|
||
|
||
所有修复和改进都有完整的文档记录，便于后续维护和理解。
|
||
|