Vibe-Trading OHLC数据完整性守卫：在加载器边界拦截脏K线的完整指南

Vibe-Trading OHLC数据完整性守卫：在加载器边界拦截脏K线的完整指南

【免费下载链接】Vibe-Trading"Vibe-Trading: Your Personal Trading Agent"项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading

Vibe-Trading 是一款面向个人交易者的智能 Agent，支持多市场数据加载与回测。为了保证回测结果的可信度，它在数据加载器边界内置了一套OHLC 数据完整性守卫：任何一条违反 K 线结构规则的"脏数据"，都会在进入回测引擎之前被统一拦截，从源头杜绝 NaN/inf 指标污染你的策略评估。

什么是"脏K线"？为什么它会悄悄毁掉回测？

一条合法的日 K 线必须同时满足几个常识性条件。但在真实数据源里，这些问题并不罕见：

关键在于：各数据加载器原本只负责删除空值行（dropna），结构上自相矛盾的脏 K 线会一路穿透进回测引擎，最终以 NaN/inf 指标的形式爆发——甚至直接打断严格的 JSON 序列化器（allow_nan=False），让整份回测报告无法输出。

这正是 Vibe-Trading 设计"加载器边界守卫"的动机：与其在引擎里收拾烂摊子，不如在数据进门的瞬间就查一遍身份证。

OHLC 守卫的核心：validate_ohlc 函数

守卫的核心实现集中在数据加载器基座 base.py 中的validate_ohlc函数。它对每个 OHLCV 数据帧执行两道检查：

• 结构不变量（始终强制）：high < low、high未包住 open/close、low未包住 open/close，任一违反即判脏；
• 正价不变量（可配置）：默认拒绝任何<= 0的价格；零价在仓位与保证金计算中是真正未定义的。

函数提供三种处理策略，默认是drop：

1. drop（默认）：直接删除脏 K 线，并记录一条 warning 日志，告诉你删了几条；
2. warn：只记日志、保留数据，适合你想先"看见问题"再决策的场景；
3. raise：一旦发现任何违规立即抛出异常，适合严格的数据质检流水线。

特殊市场友好：允许负价格的开关

守卫没有一刀切。欧洲日前电力市场可以合法出现负电价，这时硬删负价 K 线反而破坏数据。因此validate_ohlc提供allow_nonpositive_prices参数：开启后负价放行、仅拦截恰好为 0 的价格。回测引擎侧同样通过 base.py 中的allow_nonpositive_prices配置项保持一致——加载层放行负价，引擎层用绝对值方式处理仓位，两层逻辑首尾呼应。

中央拦截方案：_sanitize_data_map 兜底所有数据源

如果只靠每个加载器自觉调用守卫，几十个数据源就得挨个排查、逐个加固，新加载器稍不留神就会漏网。Vibe-Trading 的巧妙之处在于双保险架构：

• 第一道防线（局部）：关键加载器在各自返回前主动调用守卫，例如 local_loader.py、yfinance_loader.py、mt5_loader.py、qveris_loader.py；
• 第二道防线（中央）：回测运行器 runner.py 中的_sanitize_data_map是所有取数结果唯一汇合的咽喉要道。无论你的数据来源是 auto 自动路由、单一指定源还是运行时降级 fallback，最终返回前都会被逐帧过一遍validate_ohlc。

这意味着：即使某个加载器从未自己调用过守卫（这是大多数加载器的情况），脏 K 线也不可能泄漏进回测。新增数据源时无需记住"要加校验"这件事，守卫自动生效——这就是"在加载器边界拦截"的中央方案。

测试如何验证守卫确实生效？

完整的验收用例见 test_ohlc_validation.py，覆盖了守卫的全部行为边界：

• high < low、非正价格、close 越出 high 的 K 线被准确剔除，合法 K 线（含零成交量的十字线）原样保留；
• raise/warn策略分别按预期抛错、记日志；
• 本地 CSV 文件中埋入脏 K 线，加载后已不见踪影；
• 中央兜底_sanitize_data_map对"从未调用守卫的加载器"同样能拦截脏数据，且不影响同批次中干净的标的。

相关文件速查

总结：一句话理解这套守卫

空值靠 dropna 清理，结构靠 validate_ohlc 把关，漏网靠 _sanitize_data_map 兜底。

对新手来说，你不需要做任何额外配置——只要通过 Vibe-Trading 运行回测，所有数据源（A 股、美股、加密货币、外汇等）拿到的 K 线都已经是过检的干净数据，指标与报告自然可信。而当你接入负电价这类特殊市场时，再打开allow_nonpositive_prices开关即可。数据完整性从"事后排查"变成了"进门安检"，这就是 OHLC 数据完整性守卫的价值所在。

【免费下载链接】Vibe-Trading"Vibe-Trading: Your Personal Trading Agent"项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading