# BitPilot 使用手册

> 从零开始到全自动运行，只需 10 分钟。

---

## 目录

1. [快速开始](#一快速开始)
2. [准备工作](#二准备工作)
3. [策略使用指南](#三策略使用指南)
4. [任务管理](#四任务管理)
5. [Dashboard 面板](#五dashboard-面板)
6. [通知设置](#六通知设置)
7. [风控档位选择](#七风控档位选择)
8. [在 AI Agent 中使用](#八在-ai-agent-中使用)
9. [常见问题](#九常见问题)
10. [附录：完整参数参考](#十附录完整参数参考)

---

## 一、快速开始

### 方式 A：AI Agent 用户（推荐，最简单）

如果你使用 Claude Code、Cursor 等 AI Agent，**只需一步**：

**1. 导入 Skill**

在 Claude Code 中添加 Skill 源：
```
github:duolaAmengweb3/bitget-task-skills
```

**2. 直接说话**

```
"帮我用 3000U 做一个 BTC 的费率套利，保守风险"
```

AI Agent 会自动完成安装、配置、环境检测、策略启动的全过程。首次使用时它会引导你配置 API Key。

---

### 方式 B：命令行用户

**1. 安装**

```bash
npm install -g @hunterweb303/bgtask
```

**2. 配置 API Key**

```bash
export BITGET_API_KEY="你的 API Key"
export BITGET_SECRET_KEY="你的 Secret Key"
export BITGET_PASSPHRASE="你的 Passphrase"
```

> 建议加到 `~/.zshrc` 或 `~/.bashrc` 中持久化。

**3. 验证环境**

```bash
bgtask check
```

看到 `Provider: CoreProvider (ready)` 或类似输出即为成功。

**4. 启动守护进程**

```bash
bgtask daemon start
```

**5. 运行你的第一个策略**

```bash
# 先用 dry-run 看看效果（不会真正交易）
bgtask run sleep-yield --symbols BTCUSDT --budget 1000 --dry-run

# 确认没问题后，真正运行
bgtask run sleep-yield --symbols BTCUSDT --budget 1000 --daemon
```

---

## 二、准备工作

### 2.1 获取 Bitget API Key

1. 登录 [Bitget](https://www.bitget.com)
2. 进入 **用户中心 → API 管理**（或直接访问 https://www.bitget.com/account/newapi）
3. 创建新 API Key：
   - **备注名**：BitPilot（或任意名称）
   - **权限**：勾选「交易」和「只读」
   - **不要勾选**「提现」（BitPilot 永远不需要提现权限）
   - **IP 限制**：建议绑定你的服务器 IP（可选）
4. 记录三个值：`API Key`、`Secret Key`、`Passphrase`

> **安全提示：** API Key 只需要交易和只读权限。BitPilot 在代码层面硬拦截了所有提现和子账户操作，即使 API Key 有提现权限也无法执行。

### 2.2 安装 Provider

BitPilot 支持三种方式连接 Bitget，**任选一个**：

```bash
# 方式 1（推荐）：原生 Node.js 绑定，速度最快
npm install -g bitget-core

# 方式 2：CLI 工具
npm install -g bitget-client

# 方式 3：不装任何东西，直接用 REST API
# 只需要上面的环境变量即可，不用额外安装
```

### 2.3 代理设置（中国大陆用户）

如果需要代理才能访问 Bitget API：

```bash
export HTTPS_PROXY="http://127.0.0.1:7890"
# 或
export HTTP_PROXY="http://127.0.0.1:7890"
```

---

## 三、策略使用指南

### 3.1 SleepYield — 睡后引擎

**适合谁：** 想要低风险稳定收益，不想频繁操作的用户。

**一句话原理：** 买入现货同时做空合约，两边对冲不赌方向，只赚资金费率。

**快速启动：**

```bash
# 最简单的用法：1000U 做 BTC 费率套利
bgtask run sleep-yield --symbols BTCUSDT --budget 1000 --daemon

# 多币种同时做
bgtask run sleep-yield --symbols BTCUSDT,ETHUSDT --budget 5000 --daemon

# 保守配置：更严格的入场条件
bgtask run sleep-yield \
  --symbols BTCUSDT \
  --budget 3000 \
  --min-funding-rate 0.0001 \
  --min-consecutive 3 \
  --take-profit 2 \
  --risk-profile conservative \
  --daemon
```

**你需要知道的：**
- 预算会分成两半：一半买现货，一半做合约保证金
- 杠杆固定 1x，不可修改（这是策略安全性要求）
- 费率转负时系统会自动平仓，不需要你操心
- 牛市时费率更高，收益更好（年化 20-30%）
- 震荡市也能赚（年化 10-11%），只是少一些

**参数说明：**

| 参数 | 含义 | 默认值 | 建议 |
|------|------|-------|------|
| `--symbols` | 交易对 | BTCUSDT | BTC 最稳，ETH 波动稍大 |
| `--budget` | 总预算 USDT | 1000 | 建议 ≥ 500U |
| `--min-funding-rate` | 最低费率/8h | 0.01% | 越高越保守 |
| `--min-consecutive` | 连续正费率期数 | 3 | 3 = 保守，1 = 激进 |
| `--take-profit` | 累计收益止盈% | 2% | — |
| `--max-hold-days` | 最大持仓天数 | 30 | — |
| `--idle-to-earn` | 闲置转 Earn | true | 建议开启 |

---

### 3.2 AlphaRotator — 强势雷达

**适合谁：** 想在主流币中抓住上涨趋势，愿意承受一定波动的用户。

**一句话原理：** 每月给所有币打分，买最强的卖最弱的，恐慌时全部避险。

**快速启动：**

```bash
# 默认 6 币池，选 Top 3，3000U
bgtask run alpha-rotator --budget 3000 --daemon

# 自定义币池和参数
bgtask run alpha-rotator \
  --symbols BTCUSDT,ETHUSDT,SOLUSDT,BNBUSDT,XRPUSDT,AVAXUSDT,LINKUSDT,ADAUSDT \
  --top-n 3 \
  --budget 5000 \
  --rebalance-days 30 \
  --single-stop-loss 15 \
  --fear-threshold 20 \
  --risk-profile balanced \
  --daemon
```

**你需要知道的：**
- 月度轮动，不是每天频繁交易
- 恐惧指数 < 20 时会自动卖出所有持仓转入 Earn
- 单个币止损 -15% 后，该币 60 天内不会再被选入
- 推荐币池 6-10 个，太少选择太窄，太多分析噪音大

**参数说明：**

| 参数 | 含义 | 默认值 | 建议 |
|------|------|-------|------|
| `--symbols` | 币池 | BTC,ETH,SOL,BNB,XRP,AVAX | 6-10 个主流币 |
| `--top-n` | 持有 Top N | 3 | 3-5 |
| `--budget` | 总预算 | 3000 | 建议 ≥ 1000U |
| `--rebalance-days` | 轮动周期 | 30 天 | 30 最稳 |
| `--single-stop-loss` | 单币止损% | 15% | — |
| `--fear-threshold` | 恐惧避险阈值 | 20 | 越高越保守 |
| `--cooldown-days` | 止损冷却天数 | 60 | — |

---

### 3.3 YieldPilot — 收益导航

**适合谁：** 有闲钱，不想管，只想让钱自动去收益最高的地方。

**一句话原理：** 每 8 小时比较理财和套利的收益率，自动把钱搬到更高的那边。

**快速启动：**

```bash
# 1 万 U，全自动路由
bgtask run yield-pilot --budget 10000 --daemon

# 自定义参数
bgtask run yield-pilot \
  --budget 10000 \
  --switch-threshold 5 \
  --min-hold-hours 72 \
  --check-interval 8 \
  --symbol BTCUSDT \
  --risk-profile conservative \
  --daemon
```

**你需要知道的：**
- 只在收益差 > 5% 时才切换，避免频繁操作
- 每次切换至少持仓 72 小时
- 主要成本是开平仓手续费约 0.128%/次
- 最坏情况就是稳定赚 Earn 的 5-7% 年化

**参数说明：**

| 参数 | 含义 | 默认值 |
|------|------|-------|
| `--budget` | 总预算 | 10000 |
| `--switch-threshold` | 切换收益差% | 5% |
| `--min-hold-hours` | 最小持仓时间 | 72h |
| `--check-interval` | 检查间隔 | 8h |
| `--symbol` | 套利标的 | BTCUSDT |

---

### 3.4 BitPilot Pro — 全自动驾舱

**适合谁：** 不想选单个策略，希望一键启动全套资产管理的用户。

**一句话原理：** 60% 稳健套利 + 30% 强势轮动 + 10% 灵活储备，三个引擎联动运行。

**快速启动：**

```bash
# 最简单：2 万 U 全自动
bgtask run bitpilot-pro --budget 20000 --daemon

# 自定义分配比例
bgtask run bitpilot-pro \
  --budget 20000 \
  --alloc-sleep-yield 60 \
  --alloc-alpha-rotator 30 \
  --alloc-reserve 10 \
  --fear-threshold 15 \
  --max-drawdown 8 \
  --risk-profile balanced \
  --daemon
```

**资金分配示例（20000U）：**

```
总预算: 20,000 USDT
├── 稳健引擎 (SleepYield):    12,000 USDT (60%)
│   └── BTC 费率套利, 预期年化 10-20%
├── 增长引擎 (AlphaRotator):   6,000 USDT (30%)
│   └── 动量轮动 Top 3, 预期年化 10-25%
└── 储备仓 (Reserve/Earn):     2,000 USDT (10%)
    └── 活期理财, 年化 5-11%

组合预期年化: 11-22%
组合最大回撤: 8-12%
```

**你需要知道的：**
- 三个比例加起来必须 = 100%
- 储备仓最低 10%（安全底线，不可低于）
- 全局避险触发条件比子策略更严格（恐惧 < 15，而非 < 20）
- 避险时三个引擎同时暂停，资金全部转 Earn
- 日报通过 Telegram 推送（如果配了的话）

**参数说明：**

| 参数 | 含义 | 默认值 |
|------|------|-------|
| `--budget` | 总预算 | 10000 |
| `--alloc-sleep-yield` | 稳健仓% | 60 |
| `--alloc-alpha-rotator` | 增长仓% | 30 |
| `--alloc-reserve` | 储备仓% | 10 |
| `--fear-threshold` | 全局避险阈值 | 15 |
| `--fear-recovery` | 恢复阈值 | 25 |
| `--max-drawdown` | 最大回撤% | 8 |

---

### 3.5 Sleep-Mode — 睡觉模式

**适合谁：** 晚上睡觉前挂一个条件单，满足条件自动买/卖。

**快速启动：**

```bash
# BTC 跌 3% 就买 200U
bgtask run sleep-mode \
  --symbol BTCUSDT \
  --trigger-type price_drop \
  --trigger-value 3 \
  --action buy \
  --amount 200 \
  --duration 28800 \
  --daemon

# ETH 涨 5% 就卖，最多触发 2 次
bgtask run sleep-mode \
  --symbol ETHUSDT \
  --trigger-type price_rise \
  --trigger-value 5 \
  --action sell \
  --amount 500 \
  --max-triggers 2 \
  --daemon
```

**参数说明：**

| 参数 | 含义 | 默认值 |
|------|------|-------|
| `--symbol` | 交易对 | BTCUSDT |
| `--trigger-type` | price_drop / price_rise | price_drop |
| `--trigger-value` | 触发百分比 | 2.5% |
| `--action` | buy / sell / alert_only | buy |
| `--amount` | 金额 USDT | 100 |
| `--max-triggers` | 最大触发次数 | 1 |
| `--cooldown` | 冷却时间（秒） | 3600 |
| `--volatility-guard` | 波动率守护% | 5% |
| `--duration` | 运行时长（秒） | 28800 (8h) |

---

### 3.6 Event-Mode — 事件模式

**适合谁：** 担心突发行情，想提前设好自动减仓/平仓规则。

**快速启动：**

```bash
# BTC 5 分钟内暴跌 5%，自动减仓 50%
bgtask run event-mode \
  --symbol BTCUSDT \
  --event-type price_spike \
  --threshold 5 \
  --window 300 \
  --action reduce \
  --reduce-percent 50 \
  --daemon

# 成交量突增 3 倍，发出警报
bgtask run event-mode \
  --symbol BTCUSDT \
  --event-type volume_surge \
  --threshold 300 \
  --action alert_only \
  --daemon
```

**支持的事件类型：**

| 类型 | 说明 |
|------|------|
| `price_spike` | 价格在窗口期内剧烈波动（涨或跌） |
| `volume_surge` | 成交量突增到平均值的 N 倍 |
| `funding_anomaly` | 资金费率异常（绝对值 ≥ 阈值） |
| `ext:liquidation` | 大规模爆仓（实验性） |
| `ext:announcement` | 交易所公告（实验性） |
| `ext:macro` | 宏观事件（实验性） |

> `ext:` 前缀的事件默认只能 `alert_only`，要自动执行需加 `--allow-ext-execution`。

---

### 3.7 Copy-Mode — 跟单模式

**适合谁：** 想跟着高手交易，但不知道跟谁。

**快速启动：**

```bash
# 先看推荐结果（dry-run）
bgtask run copy-mode \
  --sort-by roi_drawdown_ratio \
  --period 30d \
  --min-winrate 60 \
  --max-drawdown 20 \
  --budget 2000 \
  --dry-run

# 确认后真正执行
bgtask run copy-mode \
  --sort-by roi_drawdown_ratio \
  --period 30d \
  --min-winrate 60 \
  --max-drawdown 20 \
  --budget 2000 \
  --auto-execute
```

**筛选逻辑：**
1. 从 Bitget 排行榜获取交易员数据
2. 量化评分：ROI × 胜率 / 最大回撤
3. 过滤：胜率 ≥ 60%，最大回撤 ≤ 20%
4. 按评分排序，分配预算
5. 内置停跟规则：连续亏损 3 次或回撤 > 15% 自动停止

---

## 四、任务管理

### 4.1 守护进程

守护进程是所有后台任务的基础，**必须先启动**：

```bash
# 启动
bgtask daemon start

# 查看状态
bgtask daemon status

# 重启（自动恢复之前运行中的任务）
bgtask daemon restart

# 停止（会停止所有运行中的任务）
bgtask daemon stop
```

### 4.2 查看任务

```bash
# 列出所有任务
bgtask list

# 输出 JSON 格式（方便程序处理）
bgtask list --json

# 查看单个任务详情
bgtask status <taskId>
bgtask status <taskId> --json
```

### 4.3 查看日志

```bash
# 查看最近 50 行日志
bgtask logs <taskId>

# 查看最近 100 行
bgtask logs <taskId> -n 100

# 实时追踪日志（像 tail -f）
bgtask logs <taskId> -f
```

### 4.4 停止任务

```bash
# 停止单个任务
bgtask stop <taskId>

# 停止所有任务（通过停止守护进程）
bgtask daemon stop
```

---

## 五、Dashboard 面板

```bash
# 实时刷新面板（每 5 秒更新）
bgtask dashboard

# 输出一次（用于截图或记录）
bgtask dashboard --once
```

面板展示内容：
- 系统状态和运行时间
- 总资产、今日收益、最大回撤
- 恐惧贪婪指数
- 各引擎运行状态和收益
- 最近事件记录

按 `Ctrl+C` 退出面板。

---

## 六、通知设置

### 6.1 Telegram 通知

**第一步：创建 Telegram Bot**

1. 在 Telegram 搜索 `@BotFather`
2. 发送 `/newbot`
3. 按提示输入 Bot 名称
4. 获得 Bot Token（格式：`123456:ABCdefGHIjkl...`）

**第二步：获取 Chat ID**

1. 在 Telegram 搜索 `@userinfobot`
2. 发送任意消息
3. 获得你的 Chat ID（一串数字）

**第三步：配置 BitPilot**

```bash
bgtask notify set telegram.botToken "123456:ABCdefGHIjkl..."
bgtask notify set telegram.chatId "999999999"
```

**第四步：测试**

```bash
bgtask notify test
```

收到消息就说明配置成功。

### 6.2 Webhook 通知

```bash
bgtask notify set webhook "https://your-server.com/webhook"
bgtask notify test
```

Webhook 会收到 JSON 格式的事件数据，方便接入自己的告警系统。

---

## 七、风控档位选择

### 怎么选？

| 如果你是... | 推荐档位 |
|-------------|---------|
| 第一次用，不确定 | `conservative` |
| 有一定经验，资金可以承受小波动 | `balanced` |
| 老手，明确知道自己在做什么 | `aggressive` |

### 三档对比

| | Conservative | Balanced | Aggressive |
|--|-------------|----------|-----------|
| **单笔上限** | 总资产 5% | 10% | 20% |
| **日交易限额** | 3 笔 | 10 笔 | 50 笔 |
| **大额确认** | > 200U | > 500U | > 1000U |
| **止损** | 2% | 5% | 10% |
| **止盈** | 5% | 10% | 20% |
| **冲突检测** | 开启 | 开启 | 关闭 |
| **适合策略** | SleepYield, YieldPilot | BitPilot Pro, AlphaRotator | 高频、大资金 |

### 使用方法

```bash
# 在任何策略命令中加上 --risk-profile
bgtask run sleep-yield --budget 5000 --risk-profile conservative --daemon
bgtask run alpha-rotator --budget 3000 --risk-profile balanced --daemon
```

---

## 八、在 AI Agent 中使用

### 8.1 Claude Code

**安装 Skill：**

将 Skill 仓库添加到你的 Claude Code 项目中：

```
github:duolaAmengweb3/bitget-task-skills
```

**然后直接对话：**

| 你说 | AI 做 |
|------|-------|
| "帮我用 3000U 做 BTC 费率套利" | → 启动 SleepYield |
| "从主流币里选出最强的 3 个，5000U 轮动" | → 启动 AlphaRotator |
| "1 万 U 闲钱，帮我自动找最高收益" | → 启动 YieldPilot |
| "2 万 U 全自动驾驶" | → 启动 BitPilot Pro |
| "BTC 5 分钟暴跌 5% 就减仓一半" | → 启动 Event-Mode |
| "现在策略跑得怎么样？" | → 调用 dashboard |
| "停掉所有任务" | → daemon stop |

### 8.2 Cursor

同样支持通过 Skill 集成，配置方式类似。

### 8.3 其他 AI Agent

BitPilot 的 Skill 遵循 Open Agent Skills 标准，兼容 40+ AI Agent。

---

## 九、常见问题

### Q: 最低需要多少资金？

**SleepYield：** 建议 ≥ 500U（因为预算要分两半，太少手续费占比过高）
**AlphaRotator：** 建议 ≥ 1000U（至少要买 3 个币）
**YieldPilot：** 建议 ≥ 2000U
**BitPilot Pro：** 建议 ≥ 5000U（三个引擎都要分配到足够的量）

### Q: 会不会亏钱？

任何交易策略都有风险。BitPilot 的设计目标是**最小化风险**：

- SleepYield（费率套利）：Delta 中性，方向风险为零，最大风险来自基差偏移（< 3%）
- AlphaRotator（动量轮动）：有方向风险，单币止损 -15%，恐慌时全仓避险
- BitPilot Pro（组合）：60% 低风险 + 30% 中风险 + 10% 零风险，组合后最大回撤 8-12%

### Q: 需要一直开着电脑吗？

不需要。使用 `--daemon` 参数后，策略在后台运行，关掉终端也不影响。建议部署到服务器上实现真正的 7×24。

### Q: bgtask check 报错怎么办？

```bash
# 情况 1：没有 Provider
# 解决：安装 bitget-core
npm install -g bitget-core

# 情况 2：API Key 未设置
# 解决：设置环境变量
export BITGET_API_KEY="你的key"
export BITGET_SECRET_KEY="你的secret"
export BITGET_PASSPHRASE="你的passphrase"

# 情况 3：网络问题（中国大陆）
# 解决：设置代理
export HTTPS_PROXY="http://127.0.0.1:7890"
```

### Q: 如何更新 BitPilot？

```bash
npm update -g @hunterweb303/bgtask
```

### Q: 策略运行中途崩溃了怎么办？

守护进程会自动重试 3 次（指数退避：2s → 4s → 8s）。如果 daemon 本身重启：

```bash
bgtask daemon restart
# 会自动恢复之前运行中的任务
```

### Q: 可以同时运行多个策略吗？

可以。每个策略是独立的 Worker 进程：

```bash
bgtask run sleep-yield --symbols BTCUSDT --budget 3000 --daemon
bgtask run alpha-rotator --budget 2000 --daemon
# 两个策略同时运行，互不影响
```

或者直接用 BitPilot Pro，它会帮你编排多个策略。

### Q: dry-run 和真实运行有什么区别？

`--dry-run` 模式下，所有逻辑正常运行（价格监控、评分计算、安全检查），但到了真正下单那一步会只记录日志而不执行。**强烈建议首次使用先 dry-run。**

### Q: 如何查看历史收益？

```bash
# 查看某个任务的详细状态
bgtask status <taskId> --json

# 查看实时面板
bgtask dashboard --once

# 查看日志中的交易记录
bgtask logs <taskId> -n 200
```

### Q: API Key 安全吗？

- API Key 只存在你的本地环境变量中，不会上传到任何地方
- BitPilot 是开源的（MIT），你可以审计所有代码
- 在代码层面硬拦截了所有提现操作（DANGER 权限）
- 建议只给 API Key「交易 + 只读」权限，不给「提现」权限

---

## 十、附录：完整参数参考

### 通用参数

| 参数 | 适用范围 | 说明 | 默认值 |
|------|---------|------|-------|
| `--daemon` | 所有策略 | 后台运行 | false |
| `--dry-run` | 所有策略 | 只记录不执行 | false |
| `--confirm` | 所有策略 | 跳过大额确认 | false |
| `--risk-profile` | 所有策略 | conservative/balanced/aggressive | 见各策略 |

### sleep-yield 参数

| 参数 | 说明 | 默认值 |
|------|------|-------|
| `--symbols` | 交易对（逗号分隔） | BTCUSDT |
| `--budget` | 总预算 USDT | 1000 |
| `--min-funding-rate` | 最低费率/8h | 0.001 |
| `--min-consecutive` | 连续正费率期数 | 3 |
| `--max-spread` | 最大盘口价差% | 0.05 |
| `--take-profit` | 累计止盈% | 2 |
| `--max-hold-days` | 最大持仓天数 | 30 |
| `--negative-rate-exit` | 连续负费率退出期数 | 2 |
| `--basis-divergence` | 基差偏移上限% | 3 |
| `--idle-to-earn` | 闲置转 Earn | true |

### alpha-rotator 参数

| 参数 | 说明 | 默认值 |
|------|------|-------|
| `--symbols` | 币池 | BTC,ETH,SOL,BNB,XRP,AVAX |
| `--top-n` | 持有 Top N | 3 |
| `--budget` | 总预算 USDT | 3000 |
| `--rebalance-days` | 轮动周期天数 | 30 |
| `--single-stop-loss` | 单币止损% | 15 |
| `--fear-threshold` | 恐惧避险阈值 | 20 |
| `--fear-recovery` | 恢复阈值 | 30 |
| `--cooldown-days` | 止损冷却天数 | 60 |
| `--idle-to-earn` | 避险转 Earn | true |

### yield-pilot 参数

| 参数 | 说明 | 默认值 |
|------|------|-------|
| `--budget` | 总预算 USDT | 10000 |
| `--switch-threshold` | 切换收益差% | 5 |
| `--min-hold-hours` | 最小持仓小时 | 72 |
| `--check-interval` | 检查间隔小时 | 8 |
| `--symbol` | 套利标的 | BTCUSDT |
| `--idle-to-earn` | 闲置转 Earn | true |

### bitpilot-pro 参数

| 参数 | 说明 | 默认值 |
|------|------|-------|
| `--budget` | 总预算 USDT | 10000 |
| `--alloc-sleep-yield` | 稳健仓占比% | 60 |
| `--alloc-alpha-rotator` | 增长仓占比% | 30 |
| `--alloc-reserve` | 储备仓占比% | 10 |
| `--fear-threshold` | 全局避险阈值 | 15 |
| `--fear-recovery` | 恢复阈值 | 25 |
| `--max-drawdown` | 最大回撤% | 8 |
| `--rebalance-check` | 一致性检查间隔h | 4 |
| `--sleep-yield-symbol` | 稳健引擎标的 | BTCUSDT |
| `--rotator-symbols` | 增长引擎币池 | BTC,ETH,SOL,BNB,XRP,AVAX |
| `--rotator-top-n` | 增长引擎 Top N | 3 |

### sleep-mode 参数

| 参数 | 说明 | 默认值 |
|------|------|-------|
| `--symbol` | 交易对 | BTCUSDT |
| `--trigger-type` | price_drop / price_rise | price_drop |
| `--trigger-value` | 触发百分比 | 2.5 |
| `--action` | buy / sell / alert_only | buy |
| `--amount` | 金额 USDT | 100 |
| `--order-type` | market / limit | market |
| `--max-triggers` | 最大触发次数 | 1 |
| `--cooldown` | 冷却秒数 | 3600 |
| `--check-position` | 检查仓位冲突 | true |
| `--volatility-guard` | 波动率守护% | 5 |
| `--duration` | 运行时长秒数 | 28800 |

### event-mode 参数

| 参数 | 说明 | 默认值 |
|------|------|-------|
| `--symbol` | 交易对 | BTCUSDT |
| `--event-type` | 事件类型 | price_spike |
| `--threshold` | 触发阈值% | 3 |
| `--window` | 检测窗口秒数 | 300 |
| `--action` | reduce/close_position/alert_only | alert_only |
| `--reduce-percent` | 减仓比例% | 20 |
| `--position-filter` | all / active | all |
| `--allowed-actions` | 允许动作列表 | reduce,alert |
| `--block-actions` | 禁止动作列表 | open |
| `--event-cooldown` | 事件冷却秒数 | 7200 |
| `--allow-ext-execution` | 允许扩展事件执行 | false |

### copy-mode 参数

| 参数 | 说明 | 默认值 |
|------|------|-------|
| `--sort-by` | 排序方式 | roi_drawdown_ratio |
| `--period` | 筛选周期 | 30d |
| `--min-winrate` | 最低胜率% | 60 |
| `--max-drawdown` | 最大回撤% | 20 |
| `--budget` | 总预算 USDT | 500 |
| `--max-per-trader` | 单人上限 USDT | 200 |
| `--allocation` | balanced/proportional | balanced |
| `--stop-loss-trigger` | 连续亏损停跟次数 | 3 |
| `--max-drawdown-stop` | 回撤停跟% | 15 |
| `--auto-execute` | 自动执行 | false |