编码规范 · Vibe-Trading Wiki

每个 zoo 因子文件以 __alpha_meta__ 字典字面量声明 id/theme/formula_latex/columns_required/universe/frequency 等元数据，由 Registry 通过 AST 解析而不 import。
所有因子 compute 函数接收 panel: dict[str, pd.DataFrame] 并返回同形状的 DataFrame，NaN 传播、禁止 +/- inf，warmup 期返回 NaN。
横截面标准化统一使用 base.rank（百分位排名）或自定义 zscore，零方差行返回 NaN 而非静默置零。
时间序列窗口函数（ts_mean/ts_std/ts_corr 等）对 window 参数执行下限校验（如 n>=1 或 n>=2），并通过 pandas rolling(min_periods=n) 保证 warmup 行为一致。
CLI handler 采用 add_subparser + _DISPATCH 映射表模式，统一捕获异常并以一行 stderr 输出，仅在 --verbose 时打印 traceback。
hypotheses 的状态变更通过 HypothesisRegistry.update 进行，新 ID 由 title+created_at 的 sha256 前缀生成，冲突时追加序号后缀。