From a17c1434b9a927fd4d2e2df9b3321e0f99bbb98e Mon Sep 17 00:00:00 2001 From: root Date: Tue, 3 Mar 2026 09:22:59 +0000 Subject: [PATCH] docs: add v5.3 development guardrails to gemini analysis --- docs/arbitrage-engine/v51_gemini_analysis.md | 26 ++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/arbitrage-engine/v51_gemini_analysis.md b/docs/arbitrage-engine/v51_gemini_analysis.md index ed9e72a..c63a81f 100644 --- a/docs/arbitrage-engine/v51_gemini_analysis.md +++ b/docs/arbitrage-engine/v51_gemini_analysis.md @@ -145,5 +145,31 @@ BTC 轨**抛弃了线性加分**，采用**“布尔逻辑门控 (Boolean Logic --- +## 四、开发注意事项（补充） + +1. **缺失数据默认策略（必须写死）** + - BTC 四个门控特征（`atr_percent_1h`, `tiered_cvd_whale`, `obi_depth_10`, `spot_perp_divergence`）任一缺失时，默认 `BLOCK_SIGNAL`。 + - 必须记录 `block_reason=missing_feature:`，避免静默放行。 + +2. **阈值治理（避免拍脑袋改参）** + - `min_vol_threshold`、`obi_veto_threshold`、`whale_flow_threshold` 必须配置化（不可硬编码散落在代码中）。 + - 文档标注为“初始值”，并明确回测校准窗口与更新频率。 + +3. **标签口径统一（防止回填偏差）** + - `Y_binary_60m` 使用 `Mark Price` 判定触发顺序。 + - ATR 必须使用信号触发时快照 `atr_value`，禁止回填时二次重算 ATR。 + +4. **TP 兜底状态机补全部分成交分支** + - 触发兜底前先查询订单成交量。 + - 若部分成交，只对剩余仓位执行 `Cancel -> Taker Market Close`，避免超平或漏平。 + +5. **并发与幂等保护** + - `Cancel -> Market` 流程增加订单状态锁（或行级锁）和幂等键。 + - 防止重复撤单、重复平仓、双写成交记录。 + +6. **发布闸门指标字段统一** + - 统一报表输出字段：`maker_ratio`, `avg_friction_cost_r`, `flip_loss_r`。 + - 发布闸门自动判断基于同一口径，避免人工解释偏差。 + **给开发者的最终建议：** 你现在可以拿着这份拆解，直接去写 `v53_alt_config.json` 和 BTC 轨的条件判断代码了。建议你先从 **ALT 轨的 `v53_alt_config.json` 重写**开始，因为这个改动最小，见效最快。是否需要我帮你直接生成这个 JSON 文件的模板？ \ No newline at end of file