# 执行器飞书通知功能

FIXED: 2026-03-28

## 功能概述

为所有交易执行器（Bitget、Hyperliquid、PaperTrading) 添加了飞书通知功能，每次执行交易操作时都会自动发送飞书通知。

## 实现位置

- **基类**: `backend/app/crypto_agent/executor/base_executor.py`
  - 添加了飞书服务初始化
  - 添加了统一的通知发送方法 `send_execution_notification()`
  - 添加了针对不同操作的通知方法:
    - `_send_open_notification()` - 开仓通知
    - `_send_close_notification()` - 平仓通知
    - `_send_cancel_notification()` - 撤单通知
    - `_send_tp_sl_notification()` - 止盈止损设置通知
    - `_send_position_management_notification()` - 持仓管理通知
    - `_send_generic_notification()` - 通用通知

- **Bitget 执行器**: `backend/app/crypto_agent/executor/bitget_executor.py`
  - 在 `execute_open()` 中添加成功/失败通知
  - 在 `execute_close()` 中添加成功/失败通知
  - 在 `execute_cancel()` 中添加成功/失败通知

- **Hyperliquid 执行器**: `backend/app/crypto_agent/executor/hyperliquid_executor.py`
  - 在 `execute_open()` 中添加成功/失败通知
  - 在 `execute_close()` 中添加成功/失败通知
  - 在 `execute_cancel()` 中添加成功/失败通知

- **PaperTrading 执行器**: `backend/app/crypto_agent/executor/paper_trading_executor.py`
  - 已经集成了飞书通知功能

## 通知类型

### 1. 开仓通知 (OPEN)
- **成功**: 绿色卡片，包含平台、交易对、订单ID、数量、价格、保证金、杠杆、止损、止盈、订单类型
- **失败**: 红色卡片,包含平台、交易对、错误信息、失败原因

### 2. 平仓通知 (CLOSE)
- **成功**: 绿色卡片，包含平台、交易对、盈亏金额、收益率、平仓原因
- **失败**: 红色卡片，包含平台、交易对、错误信息

### 3. 撤单通知 (CANCEL)
- **成功**: 绿色卡片，包含平台、交易对、订单ID、撤单原因
- **失败**: 红色卡片，包含平台、交易对、订单ID、错误信息

### 4. 止盈止损通知 (TP_SL)
- **成功**: 绿色卡片，包含平台、交易对、止损价、止盈价
- **失败**: 橙色卡片，包含平台、交易对、错误信息

### 5. 持仓管理通知 (POSITION_MANAGEMENT)
- **颜色**: 根据操作类型（TAKE_PROFIT=绿色, TIME_EXIT=橙色, MOVE_SL=蓝色)
- **内容**: 平台、交易对、操作类型、原因、盈亏百分比、持仓时长

**特别说明**: 移动止损 (MOVE_SL) 会在持仓盈利达到 2% 时自动触发，详见 [MOVE_STOP_LOSS_FEATURE.md](./MOVE_STOP_LOSS_FEATURE.md)

## 通知格式
使用飞书卡片消息（Interactive Card），格式如下:
```
标题: [状态图标] [平台] 操作类型 - 交易对
内容:
**平台**: XXX
**交易对**: XXX
**其他字段**: XXX
```

## 使用的服务
- **飞书服务**: `get_feishu_paper_trading_service()`
  - 使用 `paper_trading` 类型的飞书 webhook
  - 确保交易通知发送到正确的飞书群组

## 通知时机
- **立即发送**: 每次执行操作后立即发送通知
- **成功/失败都发送**: 无论操作成功还是失败都会发送通知
- **包含详情**: 尽可能包含更多执行详情，方便追踪和调试

## 下一步
- 测试各个平台的通知是否正常发送
- 磮认飞书 webhook 配置正确
- 根据需要调整通知格式和内容