tmp1

gistfile1.txt

# ⚖️ 真相 · 逻辑 · 审计

> **“不预测行情，只测绘逻辑。”**

这是一个基于 **物理真相** 与 **对抗性演化** 构建的多智能体交易系统。它通过“三路推理 (Reasoning Triad)”架构，将极度不确定的市场博弈转化为确定性的物理地形测绘与逻辑审计。每一张单子都是物理事实与对抗性逻辑的结晶，是对市场脆弱性的精确爆破。

---

## 🗺️ 物理地形 · 演化枢纽

系统通过 **前向推理 (Forward Reasoning)** 与 **后向演化 (Backward Evolution)** 构建了一个具备自我修复能力的闭环生态：

```mermaid
graph TD
    %% 前向驱动：三路推理轴 (The Reasoning Triad)
    subgraph "前向驱动：三路推理轴 (The Reasoning Triad)"
        A["Observer: 测绘师"] -- "物理真相 (Truth Bus)" --> TB{{"真相总线 (Observation)"}}
        
        TB -- "注入背景" --> B1("Strategist: 架构师 (Phase A)")
        B1 -- "逻辑草案 (Draft)" --> C{{"Middleware: 物理公证层"}}
        TB -- "数据对齐" --> C
        C -- "数学事实 (Math Facts)" --> D["Critic: 对抗审判官"]
        TB -- "对抗审计" --> D
        D -- "审判报告 (Verdict)" --> B2("Strategist: 觉醒者 (Phase B)")
        TB -- "决策收敛" --> B2
        B2 -- "最终执行决议 (Decision)" --> F["Market Execution"]
    end

    %% 后向法医演化回路 (Recursive Loop)
    subgraph "后向演化：法医闭环 (The Forensic Loop)"
        F -->|"执行日志集 (Logs)"| G["Reviewer: 法医鉴定师"]
        G -->|"法医审计报告 (Forensic Report)"| H["Coach: 演化合伙人"]
        H -->|"逻辑补丁 (Patch)"| I[("Prompt & Config: 进化底座")]
        H -.->|"递归法典补丁意识"| G
    end

    %% 关键进化路径映射：修复逻辑断裂
    I -.->|"注入地形感知"| A
    I -.->|"注入进化逻辑"| B1
    I -.->|"注入对抗约束"| D
    I -.->|"注入硬化策略"| B2

    %% 节点样式美化 (法务级配色)
    style C fill:#f96,stroke:#333,stroke-width:2px,color:#fff
    style TB fill:#ffd700,stroke:#b8860b,stroke-width:3px,stroke-dasharray: 5 5
    style F fill:#00ff00,stroke:#333,stroke-width:2px,color:#000
    style I fill:#f9f,stroke:#333,stroke-width:4px,color:#000
    style B1 fill:#e1f5fe,stroke:#01579b
    style B2 fill:#e1f5fe,stroke:#01579b
    style G fill:#ffcdd2,stroke:#b71c1c
    style H fill:#c8e6c9,stroke:#1b5e20
```

---

## 🧬 逻辑审计 · 共识协议

基于明确的物理地形边界与逻辑主权隔离，各组件在协作交接中始终维持着不可逾越的“法医级”逻辑严谨度：

| 智能实体 | 职能模型 | 枢纽逻辑 | 演化产物 |
| :--- | :--- | :--- | :--- |
| **Observer** | **测绘师** | **物理景观聚合**：识别宏微观地形共振，构建“真相总线” | 地形全景数据 |
| **Strategist (A)** | **架构师** | **交易蓝图构建**：锚定高成交量节点 (HVN) 并预设物理执行轨迹 | 逻辑草案 |
| **Middleware** | **真理校验门** | **物理解耦公证**：通过真相总线锁定 RR 与 ATR 参数，彻底消除幻觉 | 物理事实底座 |
| **Critic** | **对抗审判官** | **生存压力测试**：基于真相总线识别流动性陷阱，进行对抗性审计 | 审计判决书 |
| **Strategist (B)** | **觉醒者** | **风险硬化收敛**：整合审计意见，执行深度入场防御 (DLE) 或强制弃权 | 最终决议 |
| **Reviewer** | **法医鉴定师** | **尸检溯源对比**：精准对齐成交事实，捕捉逻辑与现实的“真值偏离” | 法医复盘报告 |
| **Coach** | **演化合伙人** | **认知偏差修正**：诊断系统性盲区，合成多智能体进化的底层逻辑补丁 | 逻辑补丁 |

---

## 💎 参数大师课 · 全量工业级配置

> ⚙️ **时域缩放 (Temporal Scaling) 是参数演化的核心动力源。**

### 1. 核心意图与系统总纲 (System Directives)
| 变量名 | 大白话解释 | 逻辑核心 |
| :--- | :--- | :--- |
| `strategy_intent` | **系统主权宣言**。定义交易的核心灵魂与风险边界。 | 决定了 Agent 在模糊地带的决策倾向性（如保护本金 vs 激进获利）。 |

### 2. 基础时域与全局采样 (Observer Core)
| 变量名 | 大白话解释 | 时域联动影响 |
| :--- | :--- | :--- |
| `macro_analysis_context / time_interval` | **宏观采样颗粒度**。1h 看结构，4h 看趋势。 | 修改后，所有基于周期 (period) 的绝对时间都会改变。 |
| `macro_analysis_context / historical_lookback_candles` | **宏观记忆深度**。往回看多少根线来计算成交量分布 (VP)。 | 决定了历史支撑位（VAH/VAL/POC）的稳固程度。 |
| `micro_analysis_context / time_interval` | **微观细节颗粒度**。抓取进场点位的精度。 | 影响信号的敏捷度。建议 macro 的 1/4 左右。 |
| `micro_analysis_context / historical_lookback_candles` | **微观记忆深度**。 | 影响短期成交量节点和形态的识别。 |
| `order_flow_lookback_hours` | **流量窗口**。回看 CVD 和影线偏见的绝对时长。 | **关键**：日内设 1h 保证敏捷。决定了 Sentiment 的时效性。 |
| `average_true_range_period` | **波动标尺**。ATR 计算周期。 | 整个系统（止损、止盈、DLE）的通用度量衡。 |
| `trend_intensity_duration_hours` | **趋势惯性窗口**。 | 判定趋势是否具备“高效持续性”的时间基准。 |
| `volatility_intensity_lookback` | **波动烈度回溯**。 | 采样宏观波动率基准的时间长度。 |
| `funding_rate_lookback_hours` | **费率成本窗**。 | 识别市场多空情绪成本的周期。 |
| `volume_moving_average_period` | **成交量平滑期**。 | 用于判定当前是否处于异常放量状态。 |

### 3. 地形分辨率与结构识别 (Volume Topography)
| 变量名 | 大白话解释 | 时域联动影响 |
| :--- | :--- | :--- |
| `volume_profile_price_bucket_count` | **地形分辨率**。价格轴切分的格子数。 | **强联动**：波动越大需调越高 (500+)，否则定位会偏移。 |
| `volume_profile_value_area_width` | **价值区宽度**。POC 周围覆盖多少成交量算 Value Area。 | 默认 75%。越窄则价值定义越严苛，越容易触发突破信号。 |
| `min_price_gap_between_nodes` | **节点隔离距离**。节点太近就合并。 | Macro 周期越大，间距应成倍放大，防止目标定位过碎。 |
| `high_volume_node_detection_threshold` | **主力节点判别线**。成交量占比超过此值认定为 HVN。 | 过滤细碎噪音，锁定真正的主力阵地。 |
| `low_volume_node_detection_threshold` | **真空带判别线**。成交量占比低于此值认定为 LVN。 | 识别“价格滑梯”的关键逻辑门。 |
| `top_structural_node_count` | **核心结构数**。地图上显现点关键价位数量。 | 决定了策略引用的“锚点”丰富度。 |
| `max_high_volume_node_count` / `max_low_volume_node_count` | **节点容量限制**。 | 限制 AI 分析的复杂度，聚焦最核心的博弈区。 |

### 4. 技术波动因子 (TA Channels)
| 变量名 | 大白话解释 | 时域联动影响 |
| :--- | :--- | :--- |
| `wick_skewness_period` | **插针采样期**。最近几根线影线的物理偏差。 | 越短越能捕捉高频反转，越长越平滑。影线单核心。 |
| `wick_skew_fallback` | **影线缺失代偿**。当数据不足时的默认偏移。 | 保证系统在冷启动或极端行情下的逻辑稳定性。 |
| `bollinger_bands_std_dev` | **离群门槛**。判定极端波动的统计学标准。 | 指导系统在超买/超卖真空区的逻辑收敛。 |
| `keltner_channels_multiplier` | **物理边界倍率**。基于 ATR 的波动通道。 | 与布林带配合判断“挤压 (Squeeze)”状态。 |
| `bollinger_bands_period` / `keltner_channels_period` | **通道计算周期**。 | 锚定波动包络线的时间基准。 |

### 5. 流动性与爆仓热图 (Liquidity & Clusters)
| 变量名 | 大白话解释 | 时域联动影响 |
| :--- | :--- | :--- |
| `liquidation_cluster_atr_multiplier` | **爆仓磁吸半径**。寻找清算密集区的范围。 | **联动**：采样时间跨度越大，洗盘深度越深，该倍率需放大。 |
| `max_liquidation_events_to_fetch` | **爆仓采样规模**。从 API 获取的样本总数。 | 决定了流动性地图的细腻程度。 |
| `max_liquidation_events_for_context` | **爆仓焦点数**。喂给 AI 深度分析的头部爆仓点。 | |
| `max_liquidation_clusters` | **爆仓簇上限**。地图上最多显示的爆仓集结地。 | |
| `liquidation_cluster_fallback_percentage` | **爆仓兜底阈值**。无量行情时的最小探测幅度。 | |

### 6. 市场态势判定阈值 (Regime Detection)
| 变量名 | 大白话解释 | 逻辑暗示 |
| :--- | :--- | :--- |
| `regime_trend_intensity_threshold` | **趋势启动门槛** | 判定行情由“震荡”转为“趋势”的最低动能。 |
| `regime_trend_intensity_strong` | **强趋势判别线** | 触发系统进入“强趋势防御”模式，对 SL/TP 的要求更苛刻。 |
| `regime_volatility_baseline_ratio` | **常规波动基准** | 判定市场是否处于平稳的统计学基准。 |
| `regime_volatility_expansion_ratio` | **波动爆发倍率** | 判断行情是否“失控”。超过此值触发 **突破死锁豁免 (Breakout Participation)**，允许直接追单。 |
| `regime_volatility_extreme_ratio` | **极端黑天鹅阈值** | 判定行情进入 519 级别崩溃/暴拉模式。 |
| `regime_volume_baseline_ratio` | **常规成交量基准** | 用于与当前成交量对比。 |
| `regime_volume_breakout_threshold` | **放量确认线** | 入场不仅看价格，必须配合该倍数的成交量确认。 |
| `regime_long_short_imbalance_ratio` | **多空失衡线** | 散户多空比超过此值触发 **定向审计 (Directional Audit)**。 |
| `regime_poc_gravity_atr_distance` | **POC 引力半径 / 突破禁区线** | 强趋势下作为 SL 的最大硬顶 (**3.0 ATR**)。在突破行情中，若偏离过远则触发 **Gravity Filter** 禁涨令。 |
| `regime_vacuum_risk_score` | **真空暴露分** | 止损位若落在高分真空区，Critic 会强制 Veto。 |
| `regime_wick_skewness_exhaustion` | **影线衰竭值** | 判定当前推力是否已到达“油尽灯枯”的阈值。 |
| `regime_wick_skewness_momentum_bullish/bearish` | **吸收陷阱/动力反转阈值** | 捕捉 V 型反转时的物理分界点。**Anti-Hardcode Patch (v1.2.2)**。 |
| `regime_min_rr_ranging / trending` | **动态生存 RR** | 震荡市允许 1.2+，趋势市严求 1.8+。 |
| `regime_cvd_slope_threshold` | **买卖意愿斜率** | 衡量 Taker 攻击的垂直烈度。 |
| `regime_gravity_volume_override_ratio` | **引力突破量能限制** | 脱离 POC 引力范围后强行追涨所需的最小成交量倍率。 |
| `regime_participation_volume_threshold` | **激进成交量能阈值** | **(v1.2.14)** 超过此放量倍率后，系统将优先确保成交（缩小挂单深度）。 |
| `regime_boundary_clipping_atr` | **物理边界安全缓冲** | 在触发边界剪裁式入场时，为了确保 Limit 属性而预留的微小 ATR 间距。 |
| `regime_poc_magnet_atr_threshold` | **POC 利润锁定阈值** | 均值回归中，偏离度超过此值时 TP 强制锁定在 POC。 |
| `regime_squeeze_threshold / audit_threshold` | **挤压临界/审计阈值** | 判定能量蓄积是否到达爆发临界，触发 Critic 的生存压力测试。 |
| `regime_breakout_buffer_atr` | **突破入场缓冲距离** | 防止在假突破边缘反复摩擦。 |
| `regime_breakout_frontrun_atr` | **突破前置入场距离** | 在确认为“空心扩张”或高盈亏比动能时，允许在物理边界前置一定的 ATR 进行入场。**Anti-Hardcode Patch (v1.2.3)**。 |
| `regime_structural_proximity_threshold` | **结构接近判定阈值** | 判定价格是否已到达有效“地形锚点”的感知范围。 |

### 6. 执行与风险硬化 (Execution Law)
| 变量名 | 大白话解释 | 执行逻辑 |
| :--- | :--- | :--- |
| `min_trade_velocity` | **成交预期斜率** | 决定了系统对“磨洋工”单子的容忍门槛。 |
| `holding_time_modifier` | **时间冗余系数** | **(v1.2.13)** 给策略生成的时长增加 50%+ 额外生命，防止“黎明前”的中途撤单。 |
| `stop_loss_buffer_min / max` | **物理冗余厚度**。基于 `volatility_ratio` 的动态缩放因子。 | 公式：`({min} to {max} * volatility_ratio) * ATR`。**硬顶封死在 4.0 ATR (Regime Gravity)。** |
| `regime_balanced_atr_multiplier` | **平衡态探测半径** | 决定了系统界定“震荡区间”物理边界的范围。 |
| `score_confidence_base` | **信心基准线**。策略生成的起始分数。 | 设定为 75。强制 AI 承认 25% 的不可知熵，建立“减法思维模型”。 |
| `score_confidence_decay_min` | **最小逻辑损耗**。处理市场噪音的处罚。 | 针对微小瑕疵（影线斜率、量能波动）的黄牌警告。 |
| `score_confidence_decay_max` | **最大逻辑损耗**。结构性风险的处罚。 | 针对核心矛盾（CVD 背离、HVN 击穿）的逻辑红牌。 |

### 7. 大脑思维配置 (Agent Models)
| 变量名 | 大白话解释 | 调参指南 |
| :--- | :--- | :--- |
| `model_temperature_draft` | **直觉发射温度**。 | 建议 0.7。给系统捕捉不完美机会的灵感。 |
| `model_temperature_synthesis` | **执行冷峻度**。 | 建议 0.3。确保最终决策逻辑是向紧缩靠拢。 |
| `model` | **各职能位的大脑选型**。 | 根据任务复杂度分配（如 Critic 用 pro 模型，Draft 用 flash）。 |

### 8. 对抗性审计红线 (Critic Skepticism)
| 变量名 | 大白话解释 | 调参指南 |
| :--- | :--- | :--- |
| `threshold_skepticism_clear` | **完全通过线**。低于此分不质疑。 | 保持在 40 左右，给予 Strategist 基本的独立主权。 |
| `threshold_skepticism_weak` | **弱反思线**。触发微调。 | |
| `threshold_skepticism_constructive` | **强制重构线**。 | 高过此分 Critic 会逼 Strategist 改方案。 |

### 9. 法医评分法典 (Reviewer Scoring)
| 变量名 | 大白话解释 | 法医逻辑 |
| :--- | :--- | :--- |
| `execution_timeframe_interval` | **法医分辨率** | 复盘必须用 1m，无论你大方向看多长，都要看微观瞬间。 |
| `score_mae_pinpoint_limit / standard_limit` | **精准入场/风险红线** | 判定你进场那一刻是不是被行情反复打脸 (MAE)。**Survival Audit (v1.2.1)**：动态使用 `max(T0, T1)` 波动率。 |
| `score_frontrun_leniency_pct` | **前瞻赦免比例** | 对于为了捕捉单边行情而执行的前瞻性止损，给予的分值减免比例。**Anti-Hardcode Patch (v1.2.5)**。 |
| `score_mae_logic_failure_limit` | **逻辑崩溃线** | 超过此值认为策略方向与地形完全解构，直接判定为 Logic Failure。 |
| `score_mfe_optimal_upper / lower` | **盈利补全比例** | 判断止盈是否发生在行情最高点附近。 |
| `point_bonus_optimal_capture` | **极优退出奖励** | **(v1.2.15)** 当止盈精准捕捉到 MFE 最佳区间时的额外加分。 |
| `score_opportunity_cost_limit` | **踏空惩罚开始线** | 衡量行情飞了而系统空仓时的逻辑失分起点。 |
| `score_opportunity_cost_catastrophe_limit` | **踏空灾难限额** | **(v1.2.16)** 踏空位移达到此 ATR 时，惩罚达到最大底线。 |
| `score_opportunity_cost_catastrophe_floor` | **踏空评分底线** | **(v1.2.16)** 发生灾难级踏空时的固定最高扣分。 |
| `score_missed_opportunity_base` | **踏空判定基准** | **(v1.2.15)** 物理位移超过此 ATR 倍率即启动踏空审计。 |
| `score_time_efficiency_limit` | **时间价值窗** | 判断单子在场内占压资金但无产出的效率。 |
| `penalty_compliance_breach` | **协议死刑** | 违反写死的硬性法律（如 RR）直接归零 (-100)。 |
| `point_penalty_logic_failure / temporal_failure` | **思维偏差处罚** | |
| `point_bonus_structural_insight` | **地形天赋奖励** | AI 成功捕捉到 DLE 或清算共振时的加分。 |
| `score_mae_extra_buffer` | **MAE 归一化冗余** | 允许在精准度判定中存在的微小物理误差。 |
| `POC Magnet Exemption` | **纪律免罚协议** | **核心豁免**：若止盈动作是根据 `regime_poc_magnet_atr_threshold` 锁定在 POC 而导致的后期 MFE (盈利回吐) 飙升，系统不再判定为“由于懦弱而早退”，保护了 Agent 遵守纪律的积极性。 |

### 10. 系统演化感知 (Evolution / Coach)
| 变量名 | 大白话解释 | 联动影响 |
| :--- | :--- | :--- |
| `coach.model` | **教练的“核心大脑”**。 | 决定了逻辑补丁的生成质量和系统的进化上限。 |
| `coach.model_parameters` | **教练的“洞见水平”**。 | 控制进化过程中的随机性与稳定性。 |

---

## 🚀 运行手册

### 0. 环境准备 (VENV)
在执行任何命令前，请确保处于项目的虚拟环境中：
*   **激活环境**: `source venv/bin/activate`
*   **直接运行 (推荐)**: 也可以直接使用 `./venv/bin/python` 代替 `python` 命令。


### Phase 1: 策略执行与回测验证 (The Strategist Axis)
*   **实时生产执行**: 捕获当前时刻的物理视角并生成决策。
    `python strategist.py prod`
*   **分层回测 (Regime-based Sampling)**: 在指定时间内按市场环境权重采样（过去24天到今天）。
    `python backtest.py backtest --start T-24d --end now --sampling 12 --mode regime`
    `python backtest.py backtest --start T-25d --end T-20d --sampling 5 --mode regime`
*   **等距回测 (Timeline Spaced)**: 在指定时间内按等距时间点均匀分布采样（过去24天到7天前）。
    `python backtest.py backtest --start T-24d --end T-7d --sampling 12 --mode spaced`

*   **Sample**:
```python
python backtest.py backtest --start T-14d --end T-7d --sampling 7 --mode regime
python reviewer.py backtest
python coach.py backtest
# tips: move dashboard from html/ to archived/ and renames archived/ to archived{n}
```

### Phase 2: 法医调查与看板分析 (The Forensic Axis)
*   **全量尸检**: 对所有已结束的单子进行法医级对齐与评分。
    `python reviewer.py prod`
*   **定向法医复盘**: 针对特定失败/成功案例进行深度因果链回溯。
    `python reviewer.py prod --file [STRATEGY_JSON_PATH]`
*   **策略逆向提取与还原**: 从法医复盘报告（Reviewer Report）中反向提取原始策略会话，并自动还原至对应的 `strategies` 目录。
    `python export_strategy.py prod --file [REVIEW_JSON_PATH]`
    > **💡 核心用例**: 
    > 1. **数据恢复**: 当本地原始策略 JSON 文件丢失，但存有对应的法医复盘报告时，还原交易会话证据。
    > 2. **回测隔离**: 将法医报告中的某一特定策略片段剥离出来，生成标准的策略 JSON 文件，以便进行逻辑重放。
*   **可视化法医看板**: 可视化查看所有执行结果、MAE/MFE 回撤以及 **累计收益曲线 (v1.2.10)**。
    `python forensic_dashboard.py prod`
    > **💡 贴士**: 使用 **`-r / --recursive`** 开启全量扫描模式，自动合并所有 `archived` 文件夹中的历史数据，生成完整的资产增长曲线。


### Phase 3: 自动化演化循环 (The Evolutionary Axis)
*   **全自动化编排**: 开启循环扫描模式，自动执行从 Observer 到 Strategist 的全链路。
    `python pipeline_orchestrator.py live --pulse 60 --mode scan`
*   **市场诊断服务 (静默监视)**: 仅在后台持续刷新真相总线，不消耗 Agent API 成本。
    `python market_scanner_service.py live --pulse 30`
*   **诊断与进化合成**: 开启系统“自我反思”模式，由 Coach 自动合成逻辑补丁。
    `python coach.py live`
*   **应用逻辑补丁**: 将 Coach 生成的 `.patch` 物理硬化到 Prompt 或 Config 中。
    `python apply_patch.py --file [PATCH_PATH]`