开发或调试 MetaTrader 5 的 MQL5…

适用于在 MetaTrader 5 中创建、调试或优化 MQL5 自定义指标，尤其是涉及显示刻度、指标缓冲区、OnCalculate 预热、实时更新和绘图对齐时。

适用场景

解决思路

1. 对于小数值（<1.0）指标，显式设置显示刻度：`IndicatorSetDouble(INDICATOR_MINIMUM, 0.0);` 和 `IndicatorSetDouble(INDICATOR_MAXIMUM, 0.1);`。
2. 设置可见缓冲区：`SetIndexBuffer(0, BufVisible, INDICATOR_DATA);`。
3. 设置隐藏计算缓冲区：`SetIndexBuffer(1, BufHidden, INDICATOR_CALCULATIONS);`。
4. 检测新 K 线以防止漂移：声明 `static int last_processed_bar = -1;`，用 `bool is_new_bar = (i > last_processed_bar);` 判断。
5. 计算预热起点：`int StartCalcPosition = underlying_warmup + own_warmup;`，并设置 `PlotIndexSetInteger(0, PLOT_DRAW_BEGIN, StartCalcPosition);`。
6. 如果指标窗口空白，检查是否为小数值未设置刻度，显式设置 `INDICATOR_MINIMUM`/`INDICATOR_MAXIMUM`。
7. 如果数值随时间漂移，使用新 K 线检测配合隐藏缓冲区重置滚动窗口状态。
8. 如果绘图起点错位，计算 `underlying_warmup + own_warmup` 作为正确的 `PLOT_DRAW_BEGIN`。
9. 如果数组索引反向，调用 `ArraySetAsSeries(buffer, false)`。
10. 生产环境 MQL5 指标中，对小数值（<1.0 范围）使用显式刻度。
11. 生产环境 MQL5 指标中，使用隐藏缓冲区进行重算跟踪。
12. 生产环境 MQL5 指标中，使用新 K 线检测防止滚动窗口漂移。
13. 生产环境 MQL5 指标中，使用静态变量高效维护状态。
14. 生产环境 MQL5 指标中，正确计算预热，防止绘图错位。
15. 生产环境 MQL5 指标中，使用前向索引提高代码清晰度，即 `ArraySetAsSeries(buffer, false)`。
16. 排查空白指标窗口：原因是小数值未设置刻度；明确设置 `INDICATOR_MINIMUM`/`INDICATOR_MAXIMUM`。
17. 排查数值随时间漂移：原因是滚动窗口未重置；使用新 K 线检测和隐藏缓冲区。
18. 排查绘图起点错位：原因是 `PLOT_DRAW_BEGIN` 错误；按 `underlying_warmup + own_warmup` 计算。
19. 排查数组索引反向：原因是启用了 series 模式；调用 `ArraySetAsSeries(buffer, false)`。
20. 排查缓冲区数值错误：原因是 `INDICATOR_DATA` 类型不对；隐藏缓冲区使用 `INDICATOR_CALCULATIONS`。
21. 排查缓冲区编译错误：原因是缓冲区数量不匹配；让 `#property indicator_buffers` 与 `SetIndexBuffer` 数量一致。
22. 排查指标不更新：原因是 `OnCalculate` 返回值错误；返回 `rates_total` 表示计算成功。
23. 排查性能问题：原因是重算了所有 bars；只从 `prev_calculated` 之后开始重算。
24. 需要细节时查阅 `./references/display-scale.md`，用于修复小数值导致的空白指标窗口。
25. 需要细节时查阅 `./references/buffer-patterns.md`，了解可见和隐藏缓冲区架构。
26. 需要细节时查阅 `./references/recalculation.md`，了解 K 线检测和滚动窗口状态管理。
27. 需要细节时查阅 `./references/complete-template.md`，获取包含所有模式的完整可运行示例。
28. 需要细节时查阅 `./references/debugging.md`，获取显示问题排查清单。
29. 技能完成后检查命令是否成功；如果失败，修复导致失败的指令或错误表。
30. 技能完成后检查参数或输出是否变化；如果底层工具接口漂移，更新 Usage examples 和 Parameters 表以匹配。
31. 技能完成后检查是否使用了 workaround；如果使用了不同 flags 或额外步骤，更新 SKILL.md，使下次调用不需要相同 workaround。
32. 仅在问题真实且可复现时更新技能，不要做推测性更新。

适用边界 · 注意事项

• 不适用于非 MetaTrader 5 / MQL5 平台，如 TradingView、Python 或其他交易软件。
• 不适用于不涉及指标缓冲区、OnCalculate、绘图显示或实时 K 线更新的普通 MQL5 EA/脚本开发。
• 如果没有 MetaTrader 5 环境或无法编译/运行 MQL5 自定义指标，则不应使用。