stock-ai-agent/backend/app/crypto_agent/executor/NOTIFICATION_FEATURE.md

执行器飞书通知功能

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

通知格式

使用飞书卡片消息（Interactive Card），格式如下:

标题: [状态图标] [平台] 操作类型 - 交易对
内容:
**平台**: XXX
**交易对**: XXX
**其他字段**: XXX

使用的服务

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

通知时机

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

下一步

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