# Delta 对冲检查清单

## 快速诊断步骤

### 1. 运行诊断工具
```bash
npm run diagnose:delta
```

这会输出：
- ✅ Delta 检测配置状态
- ✅ 当前净敞口（BTC + USDC）
- ✅ 配置建议

---

### 2. 检查日志关键输出

#### 期望看到的日志：

**每个交易周期都应该有：**
```
📊 Delta Assessment {
  symbol: 'BTC',
  totalPositionBTC: '0.00150',        # 当前净敞口
  positionValueUSDC: '150.00',
  weightedDelta: '0.0075%',           # 加权 Delta
  currentTolerance: '0.5000%',        # 当前容忍度
  exceedsTolerance: '✅ NO',          # 是否超限
  recommendation: 'hold'              # 建议操作
}
```

**当 Delta 超限时应该看到：**
```
⚖️ Delta exceeds tolerance, generating rebalance signal {
  totalPositionBTC: 0.00150,
  deltaAssessment: 'adjust',
  balanceAmount: 0.00075,
  balanceSide: 'ask'
}
```

**对冲执行：**
```
Executing signal {
  type: 'balance',
  accountId: 'account1',
  symbol: 'BTC',
  side: 'ask',
  amount: 0.00075
}

Signal executed successfully {
  orderId: '12345',
  clientOrderId: 'uuid-...'
}
```

---

### 3. 实时监控命令

**窗口1 - 运行策略：**
```bash
npm run trade
```

**窗口2 - 监控 Delta：**
```bash
tail -f logs/strategy.log | grep "Delta Assessment"
```

**窗口3 - 监控对冲：**
```bash
tail -f logs/strategy.log | grep -E "exceeds tolerance|Hedging signal|Executing signal"
```

**窗口4 - 监控错误：**
```bash
tail -f logs/strategy.log | grep -E "error|failed|ERROR"
```

---

### 4. 配置检查

#### trading-strategy.json
```json
{
  "deltaRebalancing": {
    "enabled": true,                    # ← 必须启用
    "checkInterval": 60,
    "rebalanceThreshold": 0.05,         # ← 当前 5%，建议降到 0.01
    "maxDeltaDeviation": 0.001
  }
}
```

#### delta-strategy-config.json
```json
{
  "deltaControl": {
    "baseDeltaTolerance": 0.005,        # ← 当前 0.5%，建议降到 0.001
    "stableDeltaTolerance": 0.005,
    "volatileDeltaTolerance": 0.02
  }
}
```

---

### 5. 常见问题快速修复

#### 问题：敞口持续存在 (>0.001 BTC)

**修复1：降低阈值（使用绝对值）**

编辑 `src/strategies/SimpleStrategyEngine.ts:326-362`：

```typescript
// 当前逻辑（基于百分比）
if (deltaAssessment.exceedsTolerance) {
  // ...
}

// 改为绝对值阈值（推荐）
const ABSOLUTE_THRESHOLD_BTC = 0.0001;  // 0.0001 BTC ≈ $10
if (Math.abs(totalPositionBTC) > ABSOLUTE_THRESHOLD_BTC) {
  const balanceAmount = Math.abs(totalPositionBTC);  // 全部对冲
  // ... 生成对冲信号
}
```

**修复2：更新配置**
```bash
# 编辑 config/trading-strategy.json
{
  "deltaRebalancing": {
    "rebalanceThreshold": 0.01,      # 从 5% 改为 1%
    "maxDeltaDeviation": 0.0005      # 从 0.1% 改为 0.05%
  }
}
```

#### 问题：对冲信号未生成

**检查步骤：**
1. 确认 `exceedsTolerance: YES` 出现在日志中
2. 如果没有，降低 `rebalanceThreshold`
3. 如果有但无对冲信号，检查策略引擎代码

#### 问题：对冲订单失败 (420 错误)

**这是正常的！** 表示账户无持仓可减。

SignalExecutor 已自动处理，跳过重试：
```
⚠️ Reduce-only order failed: position not found (skip retry)
```

#### 问题：频繁误触发对冲

**修复：提高波动容忍度**
```json
{
  "deltaControl": {
    "volatileDeltaTolerance": 0.03,    # 从 2% 提高到 3%
    "volatilityThreshold": 0.015        # 从 1% 提高到 1.5%
  }
}
```

---

### 6. 验证对冲生效

**运行策略并观察：**

1. **初始状态：**
   ```
   totalPositionBTC: 0.00150    # 有敞口
   exceedsTolerance: ⚠️  YES
   ```

2. **触发对冲：**
   ```
   ⚖️ Delta exceeds tolerance, generating rebalance signal
   Executing signal { type: 'balance', side: 'ask', amount: 0.00075 }
   Signal executed successfully { orderId: '12345' }
   ```

3. **对冲后：**
   ```
   totalPositionBTC: 0.00075    # 敞口减少
   exceedsTolerance: ✅ NO
   ```

4. **最终：**
   ```
   totalPositionBTC: <0.0001    # 接近零
   ```

---

## 推荐配置（零敞口目标）

### Step 1: 修改策略引擎使用绝对阈值

编辑 `src/strategies/SimpleStrategyEngine.ts:326`：

```typescript
// 在 checkDeltaRebalance 方法中

// 替换原有的百分比检查
const ABSOLUTE_THRESHOLD_BTC = 0.0001;  // 约 $10 USDC
if (Math.abs(totalPositionBTC) > ABSOLUTE_THRESHOLD_BTC) {
  const balanceAmount = Math.abs(totalPositionBTC);
  // ... 生成 100% 对冲信号
}
```

### Step 2: 更新配置文件

**config/trading-strategy.json:**
```json
{
  "deltaRebalancing": {
    "enabled": true,
    "checkInterval": 30,
    "rebalanceThreshold": 0.01,      # 1%（作为后备）
    "maxDeltaDeviation": 0.0005      # 0.05%
  },
  "intervals": {
    "volumeTrading": 3,
    "deltaMonitoring": 30
  }
}
```

**config/delta-strategy-config.json:**
```json
{
  "deltaControl": {
    "baseDeltaTolerance": 0.001,      # 0.1%（严格）
    "stableDeltaTolerance": 0.001,
    "volatileDeltaTolerance": 0.02,
    "predictiveDelta": true
  }
}
```

### Step 3: 重新编译并运行

```bash
npm run build
npm run trade
```

---

## 总结

✅ **已完成的优化：**
1. ✅ 增强了 Delta 评估日志（实时输出净敞口）
2. ✅ 创建了诊断工具 `npm run diagnose:delta`
3. ✅ 优化了 SignalExecutor 错误处理（420 不重试）
4. ✅ 完善了对冲对原子性检测
5. ✅ 提供了详细的配置优化指南

📋 **下一步行动：**
1. 运行 `npm run diagnose:delta` 检查当前状态
2. 根据诊断结果调整配置阈值
3. 实时监控日志确认 Delta 检测生效
4. 如问题持续，使用绝对阈值替代百分比
5. 收集日志片段进行进一步分析

🔍 **关键指标：**
- `totalPositionBTC` 应该 < 0.0001 BTC
- `exceedsTolerance` 超限时应生成对冲信号
- 对冲执行成功率 > 90%
- 每个周期都有 Delta Assessment 日志