运行模式

[exchange] mode 控制「钱是不是真的、单会不会发」。

shadow（默认）

• 连接 OKX 公共 REST（时间、ticker 等），不需要 API Key。
• 启动时注入模拟账户（initial_capital USDT，BTC=0），reconcile_result 标记 clean。
• 风险内核、状态机、事件落库、Dashboard 全链路真实代码路径。
• Agent 若接入，提案可算、可审计，但执行层不得对实盘发单。

适合：

./zig-out/bin/alphabound --config dev.toml --ticks 20

demo

• 使用 OKX 模拟盘密钥 + 请求头 x-simulated-trading: 1（环境变量 OKX_SIMULATED=1 必填）。
• 引擎现金/BTC 来自私有 REST 余额（不再用 shadow 的 initial_capital）。
• Agent 提案经 Risk 准入后：APPROVE/REDUCE → planner → 市价单；HTTP 失败 → UNKNOWN → 查询后处置。
• Admin：cancel-all 会拉取 pending 并撤单；flatten 切风险态。
• Gate 3 / AC-GO8：连续稳定 ≥7 天 + 至少一次断线恢复与版本回滚演练。清单：GATE3_CHECKLIST.md。

export OKX_API_KEY=...
export OKX_API_SECRET=...
export OKX_API_PASSPHRASE=...
export OKX_SIMULATED=1
# config: mode = "demo"
./zig-out/bin/alphabound --config config/local.toml --agent-once --ticks 8
# 日志: admit=APPROVE|REDUCE exec=filled|acked|...

切换前检查清单：

1. mode = "demo" 且 OKX_SIMULATED=1（缺一则 boot FATAL）
2. Demo 密钥权限最小化；出口 IP 在 OKX 白名单
3. --self-check 私有余额通过
4. ready 探针在对账后变绿
5. live 仍被代码拒绝，勿改 mode 碰运气

live

• 真金白银。设计默认实验资金 100 USDT。
• 当前二进制直接拒绝 mode=live（Gate 4 前）。
• 进入条件：路线图 Gate 3 + 验收矩阵 P0–P3 相关条目全绿；任何无法解释的状态不一致都阻止实盘。
• max_drawdown、费率、滑点等已按发版流程冻结。
• 建议：先 shadow 长跑 → demo 7 日 → live，禁止从开发配置直接改 live。

模式与风险状态机正交

无论哪种 mode，进程内风险模式仍是：

NORMAL → EXIT_ONLY → FLATTENING → HALTED

• 数据陈旧 / 未对账 → fail-closed，常从 EXIT_ONLY 起步
• 回撤边界触发 → FLATTENING → 完成后可 HALTED
• HALTED 不自动恢复交易，需人工与发版流程介入

shadow 下也会演练状态机（例如人工压测陈旧数据），只是不会碰到真实资金。

切换操作建议

# 1. 改配置（新文件或发版产物），不要热改内存
mode = "demo"   # 或 live

# 2. 自检
alphabound --config /etc/alphabound/alphabound.toml --self-check

# 3. 原子发布 / restart（见运维章）
sudo systemctl restart alphabound
curl -sS --retry 30 --retry-delay 1 --fail \
  http://127.0.0.1:8080/health/ready

切换到 live 时在变更单中记录：config_hash、软件版本、操作人、回滚版本路径。