什么是 application.yaml？
application.yaml 是主要的配置文件，控制 MagicTradeBot 如何启动、连接到交易所、识别自身以及在系统级别运行。
把它看作是 MagicTradeBot 的启动配置——在任何策略、市场观察或决策引擎逻辑运行之前，机器人会读取此文件以了解：
- 要连接到哪个交易所
- 如何安全地进行身份验证
- 它应该在演示模式还是实盘模式下运行
- 使用哪个许可证
- 基本运行时行为（调试、命名、环境）
如果没有有效的 application.yaml，MagicTradeBot 无法初始化或正确运行。
application.yaml 控制什么？
application.yaml 文件负责全局的、非策略的设置，包括：
- 交易所选择和兼容性规则
- API 身份验证（或环境变量映射）
- 许可证验证
- 机器人身份和运行时标志
- 安全和部署行为
它不定义：
- 交易策略
- 止损/止盈规则
- 市场观察逻辑
- DCA 或 Brain 决策规则
这些在单独的、特定于功能的配置文件中处理，从而保持职责清晰和模块化。
关键部分说明
1. 交易所配置
此部分告诉 MagicTradeBot 连接到哪个交易所以及如何连接。
主要职责：
- 选择交易所（binance, bybit, okx, bitget, hyperliquid）
- 强制执行特定于交易所的持仓模式兼容性
- 安全加载 API 凭据
MagicTradeBot 在此处执行严格验证以防止：
- 错误的持仓模式（例如，对冲模式 vs 单向模式）
- 订单执行失败
- 错误的 PnL 计算
- 风险管理不匹配
如果配置了不受支持的交易所，机器人将拒绝运行。
2. API 凭据和安全
application.yaml 支持两种安全的凭据方法：
选项 A：直接 YAML（仅推荐用于演示/测试）
APIKEY: ""
APISECRET: ""
Passphrase: ""选项 B：环境变量（推荐用于生产）
环境变量会自动覆盖 YAML 值。
这种设计：
- 防止意外暴露密钥
- 与 Docker、VPS 和云部署无缝协作
- 符合企业安全最佳实践
MagicTradeBot 从不要求提现权限，并明确警告不要授予提现权限。
3. 持仓模式兼容性（至关重要）
不同的交易所支持不同的持仓模式，MagicTradeBot 在启动时会强制执行此规则。
示例：
- Bybit → 仅单向模式
- Binance / OKX / Bitget → 需要对冲模式
如果您的交易所账户配置错误：
- 订单可能会被拒绝
- 止盈/止损可能失败
- 仓位可能错误地关闭
此验证旨在保护资金并确保确定性行为。
4. 许可证配置
许可证部分激活您的 MagicTradeBot 安装。
License:
Key: ""许可证：
- 根据您的计划解锁功能
- 控制实例授权
- 在启动时进行验证
如果没有有效的许可证密钥，机器人将不会进入运行模式。
5. 常规应用程序设置
此部分控制机器人在运行时的行为——而不是它如何交易。
关键选项：
- BotName – 帮助在日志、仪表板和警报中识别此实例
- DemoMode – 启用无真实资金的模拟交易
- DebugMode – 启用详细日志记录以进行诊断
这些设置在以下情况下特别有用：
- 运行多个机器人实例
- 预发布环境与生产环境
- 调试或支持调查
演示模式 vs 实盘模式
application.yaml 中最重要的标志之一是：
DemoMode: true- DemoMode = true → 不发出真实订单
- DemoMode = false → 启用实盘交易
这允许用户：
- 安全地测试配置
- 在冒资金风险之前验证策略
- 在真实市场数据上以模拟方式运行机器人
为什么 MagicTradeBot 使用 application.yaml
MagicTradeBot 使用 application.yaml 是因为它提供：
- 人类可读的结构
- 强关注点分离
- 为首次用户提供安全的默认值
- 通过环境变量轻松实现自动化
- 与 Docker、云和本地部署的兼容性
最重要的是，它确保了可预测的启动行为，这对于自动化交易系统至关重要。
最佳实践
- ✔ 在生产环境中使用环境变量来存储 API 密钥
- ✔ 在测试期间保持 DemoMode 启用
- ✔ 在上线前仔细检查交易所的持仓模式
- ✔ 切勿在 API 密钥上启用提现权限
- ✔ 将 application.yaml 视为基础设施配置，而非策略配置
总结
application.yaml 是 MagicTradeBot 运行时环境的基础。
它定义：
- 机器人连接到哪里
- 它如何验证身份
- 它是实盘交易还是在演示模式下交易
- 哪个许可证处于活动状态
- 它运行的安全性如何
所有高级智能——如智能止盈/止损、市场观察、DCA 和 MagicTradeBot 大脑——都构建在此文件之上，使其成为整个系统中最重要的组件之一。