编码规范 · Vibe-Trading Wiki

所有风险损失度量统一采用“损失为正”的符号约定，并通过模块级文档与函数 docstring 显式声明，return 字段名区分 signed return 与 loss magnitude。
公共函数入口先调用私有校验器（如 _validate_confidence、_validate_horizon、_clean_returns、_align）对输入维度、范围与有限性进行检查，再进入核心计算。
返回值一律封装为 frozen dataclass，包含原始输入快照与中间量（如 transitions、flow_weights、breach_dates），便于审计与单元测试断言。
通过模块级常量集中管理业务阈值（TRADING_DAYS_PER_YEAR、DEFAULT_EXTERNAL_KINDS、BASEL_SCALING_FACTORS、GPD_SHAPE_SIGNIFICANCE_SIGMAS），禁止在函数体内硬编码魔法数字。
对外部流的分类采用显式白名单策略：未知 kind 直接抛 ValueError，而不是静默忽略或默认归类，防止错误地吞掉边界外资金流。
统计检验函数返回包含 statistic、p_value、rejected 三要素的结构化结果，并由上层组合函数（如 christoffersen_conditional_coverage、var_backtest）复用组件而非重复实现。