config.yaml 参考

config.yaml 是永续合约 Agent 的主配置文件。从示例文件复制开始：

cp config.yaml.example config.yaml

LLM 配置

llm:
  client_type: langchain_nvidia   # openai | cloudflare | google | litellm | nvidia
  model: deepseek-ai/deepseek-v3.2
  temperature: 0.2                 # 交易决策建议使用低温度

client_type 支持的值

值	提供商	说明
openai	OpenAI	需要 OPENAI_API_KEY
langchain_nvidia	NVIDIA NIM	需要 NVIDIA_API_KEY
google	Google Gemini	需要 GOOGLE_API_KEY
cloudflare	Cloudflare Workers AI	需要 CLOUDFLARE_* 变量
litellm	LiteLLM 代理	灵活的多提供商路由

温度设置

交易决策建议将 temperature 保持在 0.1–0.3。较高的温度会产生更有创意但可靠性较低的 JSON 输出。

交易参数

trading:
  symbols: [BTC, ETH]       # 使用简单符号，不是交易对格式（不要用 BTC/USDT）
  max_trade_amount: 100     # 单笔交易最大 USD 金额
  max_leverage: 10          # 最大杠杆倍数
  limit_order_enabled: false  # 是否使用限价单入场（vs. 市价单）

符号格式

请使用 BTC、ETH——不是 BTC/USDT 或 BTC-PERP。Hyperliquid 内部使用简单资产符号。

杠杆说明

• 不同资产在 Hyperliquid 上有不同的最大杠杆限制
• 如果 max_leverage 超过资产限制，订单会被拒绝
• 建议从保守的 max_leverage: 3 或 5 开始，确认策略有效后再调整

调度器

scheduler:
  interval_minutes: 3    # 两次决策之间的兜底轮询间隔

调度器是兜底决策循环。当启用市场监控时，价格异动会立即触发决策，无需等待定时间隔。

Prompt 策略

prompt:
  set: nof1-improved    # 参见下表

值	说明
default	标准 FinCoT 推理链
conservative	趋势有分歧即持有，要求 R:R ≥ 2.0
aggressive	3个条件即可入场，接受 R:R ≥ 1.2
nof1	完整 FinCoT 集成的增强策略
nof1-improved	推荐 — 完整 FinCoT + 增强数据集成
realtime	优先考虑价格行为而非滞后指标
realtime-eng	realtime 的英文版

增强分析

enhanced_analysis:
  enabled: true    # 启用 CEX 资金费率、链上数据采集

这是 CEX 信号 和 Regime 自适应 的基础开关。依赖关系：

enhanced_analysis.enabled: true
  ├── debate.enabled: true         # 独立开关
  └── regime_adaptive.enabled: true  # 依赖 enhanced_analysis

辩论 Agent

debate:
  enabled: false    # 每次决策额外增加 2 次 LLM 调用

详见多空辩论。

Regime 自适应

regime_adaptive:
  enabled: false
  # 可选参数覆盖：
  # trending:
  #   signal_threshold: 0.5
  #   min_confidence: 0.35
  #   max_leverage: 10
  # ranging:
  #   signal_threshold: 0.75
  #   max_leverage: 5
  # volatile:
  #   signal_threshold: 0.85
  #   max_leverage: 3

详见市场 Regime 自适应。

账户保护

account_protection:
  enabled: true
  max_drawdown_pct: 0.10       # 账户从峰值回撤 10% 时暂停交易
  max_daily_loss_pct: 0.05     # 单日亏损超过 5% 时暂停交易
  max_position_hours: 48       # 强制平仓持有超过 48 小时的仓位

请始终保持开启

account_protection 是关键安全机制。只有在充分理解风险的情况下才能禁用。

市场监控

market_monitor:
  enabled: false
  check_interval_seconds: 30   # 价格检查频率
  alert_threshold_pct: 3.0     # HIGH 告警阈值
  elevated_threshold_pct: 1.5  # ELEVATED 阈值（仅记录日志）
  extreme_threshold_pct: 5.0   # EXTREME 阈值
  cooldown_minutes: 5          # 触发后冷却时间
  reference_window_minutes: 10 # 价格基准窗口

详见市场主动监控。

复盘 Agent

review_agent:
  # 6a: 双粒度反思
  instant_reflection_enabled: false    # 每次平仓后即时反思
  weekly_reflection_enabled: false     # 每周 LLM 策略复盘
  weekly_reflection_day: 0             # 0=周一
  weekly_reflection_hour: 8

  # 6b: Regime 感知记忆
  regime_aware_enabled: false
  regime_mismatch_factor: 0.4          # Regime 不匹配时的降权因子

  # 6c: 确认偏差防护
  bias_protection_enabled: false
  max_positive_ratio: 0.7              # 记忆库中正面经验的最大比例
  negative_confidence_boost: 1.15      # 负面经验置信度加成

  # 6d: 事实-主观分离
  fact_subjective_split_enabled: false
  trending_subjective_boost: 1.3
  ranging_factual_boost: 1.3

  # 6e: Prompt 元反思
  prompt_meta_reflection_enabled: false
  prompt_optimization_dir: "logs/prompt_optimization"

详见复盘与反思系统。

数据配置

data:
  timeframe: 1h    # 主要决策使用的 OHLCV K 线周期

完整示例

llm:
  client_type: langchain_nvidia
  model: deepseek-ai/deepseek-v3.2
  temperature: 0.2

trading:
  symbols: [BTC, ETH]
  max_trade_amount: 100
  max_leverage: 10
  limit_order_enabled: false

scheduler:
  interval_minutes: 3

data:
  timeframe: 1h

prompt:
  set: nof1-improved

enhanced_analysis:
  enabled: true

debate:
  enabled: true

regime_adaptive:
  enabled: true

account_protection:
  enabled: true
  max_drawdown_pct: 0.10
  max_daily_loss_pct: 0.05
  max_position_hours: 48

market_monitor:
  enabled: true
  check_interval_seconds: 30
  alert_threshold_pct: 3.0
  cooldown_minutes: 5

review_agent:
  instant_reflection_enabled: true
  weekly_reflection_enabled: true
  regime_aware_enabled: true
  bias_protection_enabled: true
  fact_subjective_split_enabled: true
  prompt_meta_reflection_enabled: false