褚宏光
0f8b9d836b
- Introduced a new "tilt" parameter to the strength scoring system, allowing for the assessment of triangle slope directionality. - Renamed existing parameters: "拟合贴合度" to "形态规则度" and "边界利用率" to "价格活跃度" for improved clarity. - Updated normalization methods for all strength components to ensure they remain within the [0, 1] range, facilitating LLM tuning. - Enhanced documentation to reflect changes in parameter names and scoring logic, including detailed explanations of the new tilt parameter. - Modified multiple source files and scripts to accommodate the new scoring structure and ensure backward compatibility. Files modified: - `src/converging_triangle.py`, `src/converging_triangle_optimized.py`, `src/triangle_detector_api.py`: Updated parameter names and scoring logic. - `scripts/plot_converging_triangles.py`, `scripts/generate_stock_viewer.py`: Adjusted for new scoring parameters in output. - New documentation files created to explain the renaming and new scoring system in detail.
5.6 KiB
5.6 KiB
命名优化完成总结
✅ 全部修改完成
截止 2026-01-29，所有文件中的"拟合贴合度/边界利用率"已全部重命名为"形态规则度/价格活跃度"。
📊 修改统计
文件总数：11 个
核心源文件（3个）
- ✅
src/converging_triangle.py - ✅
src/converging_triangle_optimized.py - ✅
src/triangle_detector_api.py
脚本文件（6个）
- ✅
scripts/plot_converging_triangles.py - ✅
scripts/test_full_pipeline.py - ✅
scripts/test_optimization_comparison.py - ✅
scripts/generate_stock_viewer.py - ✅
scripts/README_performance_tests.md - ✅
tests/test_renaming.py
文档文件（3个）
- ✅
docs/强度分组成梳理.md - ✅
docs/命名优化_拟合贴合度_边界利用率_重命名.md
讨论文件（1个）
- ✅
discuss/20260129-讨论.md
🔄 命名映射完整表
| 类别 | 旧名称 | 新名称 | 位置 |
|---|---|---|---|
| Python变量 | fitting_score |
geometry_score |
所有Python文件 |
| Python变量 | fitting_adherence |
geometry_score |
所有Python文件 |
| Python变量 | boundary_utilization |
activity_score |
所有Python文件 |
| Python变量 | utilization_score |
activity_score |
所有Python文件 |
| Python函数 | calc_fitting_adherence() |
calc_geometry_score() |
所有Python文件 |
| Python函数 | calc_boundary_utilization() |
calc_activity_score() |
所有Python文件 |
| Python常量 | W_FITTING |
W_GEOMETRY |
权重配置 |
| Python常量 | W_UTILIZATION |
W_ACTIVITY |
权重配置 |
| Python常量 | UTILIZATION_FLOOR |
ACTIVITY_FLOOR |
惩罚阈值 |
| JavaScript字段 | boundaryUtilization |
activityScore |
HTML/JS文件 |
| 中文术语 | "拟合贴合度" | "形态规则度" | 所有文档和UI |
| 中文术语 | "边界利用率" | "价格活跃度" | 所有文档和UI |
| 注释/文档 | "拟合贴合度分" | "形态规则度" | 注释和文档 |
| 注释/文档 | "边界利用率分" | "价格活跃度" | 注释和文档 |
| 图表标题 | "利用率惩罚" | "活跃度惩罚" | 图表生成代码 |
📝 强度分组成（最终版）
总强度 = 价格分×50% + 收敛分×15% + 成交量分×10% + 形态规则度×10% + 价格活跃度×15%
| 序号 | 中文名称 | 权重 | 英文字段 | 说明 |
|---|---|---|---|---|
| 1 | 突破幅度分 | 50% | price_score |
价格突破边界的力度 |
| 2 | 收敛度分 | 15% | convergence_score |
三角形收敛的紧密程度 |
| 3 | 成交量分 | 10% | volume_score |
突破时的放量程度 |
| 4 | 形态规则度 | 10% | geometry_score |
形态的几何标准性 |
| 5 | 价格活跃度 | 15% | activity_score |
价格振荡的充分性 |
空白惩罚：当价格活跃度 < 20% 时，总强度 × 惩罚系数
🎯 重命名原因
问题诊断
- "拟合贴合度" - 过于技术化，不够直观
- "边界利用率" - 容易让人误以为两者是同一维度
解决方案
-
"形态规则度" (Geometry Score)
- 直观：一看就知道是衡量形态标准性
- 准确：测量枢轴点的几何规则性
-
"价格活跃度" (Activity Score)
- 直观：一看就知道是衡量价格活跃程度
- 准确：测量价格振荡的充分性
核心差异
| 维度 | 形态规则度 | 价格活跃度 |
|---|---|---|
| 测量对象 | 4-8个关键枢轴点 | 240天全部价格 |
| 测量内容 | 几何规则性 | 振荡充分性 |
| 物理意义 | 形态的结构完整性 | 形态的有效性/真实性 |
| 失效场景 | 形态不标准，可能是噪音 | 形态虽标准，但缺乏真实博弈 |
✅ 验证清单
代码验证
- 所有Python文件语法检查通过
- 函数导入测试成功
- 数据类字段验证通过
- Numba优化版本正常加载
- 所有脚本可以正常导入
UI验证
- 图表标题使用新名称
- HTML查看器使用新字段名
- JavaScript代码使用新字段名
文档验证
- 所有Markdown文档已更新
- 代码注释已更新
- API文档已更新
📌 后续工作
需要重新生成的内容
-
outputs/converging_triangles/stock_viewer.html
- 需要运行
generate_stock_viewer.py重新生成 - 会使用新的字段名
activityScore
- 需要运行
-
所有PNG图表
- 需要运行
pipeline_converging_triangle.py重新生成 - 标题会显示"形态规则度"和"价格活跃度"
- 需要运行
运行命令
# 重新运行完整流程
python scripts/pipeline_converging_triangle.py --clean --all-stocks
# 或分步运行
python scripts/detect_all_stocks.py
python scripts/generate_stock_viewer.py
💾 向后兼容性
⚠️ 破坏性变更
此次重命名是破坏性变更，旧代码需要更新：
Python代码
# ❌ 旧代码（不再工作）
result.fitting_score
result.boundary_utilization
components.utilization_score
# ✅ 新代码
result.geometry_score
result.activity_score
components.activity_score
JavaScript代码
// ❌ 旧代码（不再工作）
stock.boundaryUtilization
// ✅ 新代码
stock.activityScore
📚 相关文档
- 详细设计文档:
docs/命名优化_拟合贴合度_边界利用率_重命名.md - 强度分说明:
docs/强度分组成梳理.md - 讨论记录:
discuss/20260129-讨论.md
更新时间: 2026-01-29
更新人员: AI Assistant
变更类型: 破坏性命名优化
影响范围: 全项目