# 使用说明

**仓库:** [https://git.bz121.com/dekun/crypto_okx.git](https://git.bz121.com/dekun/crypto_okx.git)

基于 Flask 的 **OKX 期权 / 对冲** Web 控制台.与中控、其它交易所实例无关.

**部署 / PM2 / SOCKS** 见 **[部署文档.md](./部署文档.md)**:

```bash
curl -fsSL https://git.bz121.com/dekun/crypto_okx/raw/branch/main/deploy/manage.sh | bash
```

默认访问: `http://<服务器IP>:5004` → 首页跳转 **期权** `/options`.

---

## 1. 能做什么

| 模块 | 路由 | 说明 |
|------|------|------|
| **期权** | `/options` | 看期权链、开平仓、持仓监控(翻倍出场等) |
| **期权复盘** | `/options/review` | 期权成交记录 → 复盘表单 → 复盘列表与统计 |
| **对冲计划** | `/hedge-plan` | 永期对冲或期期对冲:测算、启动、进行中/历史/统计 |
| **模拟资金** | 系统设置 → 模拟资金 | 本地钱包撮合,吃公开买卖一,**不下真实交易所单** |
| **env 配置** | `/env_config` | 浏览器改 `.env`(API、交易模式、预算等) |
| **系统设置** | `/settings` | 导航显示、模拟/实盘、密码、划转、导出等 |

顶栏还可按需显示:关键位监控(提醒)、数据看板、账户流水、风控说明等(在 **系统设置 → 导航显示** 开关).

**已移除:** 策略交易、关键位自动下单、永续实盘下单页、永续交易记录/复盘、AI 复盘、中控对接.

---

## 2. 登录与顶栏

1. 打开站点 → 登录(`APP_USERNAME` / `APP_PASSWORD`,见 `.env`).
2. 顶栏标题区显示交易所名;若为模拟模式会标 **模拟**.
3. 资金条含:总资金、资金/交易账户(USDT)、期权资金/交易账户(USDC)、实时盈亏等(模拟/实盘数据源不同).

---

## 3. 交易模式(必读)

在 **env 配置** 或 `.env` 中设置 **`OKX_TRADE_MODE`**(多数可热更,启用类开关改后建议重启):

| 值 | 含义 |
|----|------|
| `options` | **单独期权**:可单独开期权;隐藏对冲导航 |
| `perp_options` | **永期对冲**:不可单独开期权;对冲页显示「永期对冲」 |
| `options_options` | **期期对冲**:不可单独开期权;对冲页显示「期期对冲」 |

对冲模式下期权页仍可查看/平仓已有仓,但不能单独新开期权.

对冲与单独期权默认可互斥(`HEDGE_PLAN_OPTIONS_MUTUAL_EXCLUSIVE=true`):有对冲计划时不可单独开期权,有单独期权时不可启动对冲.

---

## 4. 期权页(`/options`)

### 4.1 前置

- `OKX_OPTIONS_ENABLED=true`(默认 true)
- 已配置 `OKX_API_KEY` / `OKX_API_SECRET` / `OKX_API_PASSPHRASE`(永续与期权共用)
- 实盘真下单需 `LIVE_TRADING_ENABLED=true`;否则多为本地流程/模拟(见第 7 节)
- 期权账户为 **USDC**;永续腿为 **USDT**,资金不互通

### 4.2 开仓流程

1. 选标的 **ETH / BTC**、到期日.
2. **列表** 或 **T 型** 看链;可筛看涨/看跌、实值/虚值;勾选「展开全部」看全部行权价.
3. 环境「链上仅显示有卖一」开启时,无真实卖一或深度不足 1 张的合约会隐藏.
4. 点某行 **买入** → 下单面板确认张数、权利金、到期平衡等.
5. 张数:「按可用余额打满」受单笔预算 `OKX_OPTIONS_TRADE_BUDGET_USDC` × 缓冲 `OKX_OPTIONS_BUDGET_BUFFER` 限制;「全仓复利」用交易户全部可用(可设全仓上限),且通常仅允许同时 1 笔持仓.
6. 可勾选 **翻倍出场**(盈利达权利金倍数后限价平).

### 4.3 持仓与平仓

- 右侧/下方持仓卡可改翻倍倍数或关闭、执行平仓.
- 平仓默认买一限价;是否允许市价平见 `OKX_OPTIONS_ALLOW_MARKET_CLOSE`.
- 页面内「开仓规则说明」与 `/options/guide` 有更细规则.

---

## 5. 期权复盘(`/options/review`)

1. **交易记录**:筛选期权成交/平仓记录.
2. **复盘表单**:选中一笔填写复盘内容并保存.
3. **复盘记录 / 统计**:查看已复盘条目与汇总.

该页只覆盖期权侧,不含已移除的永续交易日记账.

---

## 6. 对冲计划(`/hedge-plan`)

需将 `OKX_TRADE_MODE` 设为 `perp_options` 或 `options_options`.

### 6.1 页签

| Tab | 说明 |
|-----|------|
| 永期对冲 | 期权腿 + 永续腿(仅 `perp_options`) |
| 期期对冲 | 双期权腿(仅 `options_options`) |
| 进行中的计划 | 盯盘 / 开仓中 / 半腿 / 持仓中 |
| 历史记录 | 已结束计划 |
| 统计分析 | 对冲结果汇总 |

### 6.2 永期对冲要点

- **账户**:永续 → 合约账户(USDT);期权 → 期权账户(USDC).
- **以期权为主**(`HEDGE_PLAN_OPTION_PRIMARY=true`):填参后「策略启动」进入盯盘,条件达标后自动先开期权再市价永续.
- **保险模式**(`HEDGE_PLAN_OPTION_PRIMARY=false`):做多配 Put、做空配 Call;现场按开仓价与止盈止损执行,交易所 TP/SL 出场.
- 组数上限:`MAX_ACTIVE_HEDGE_PLANS`(默认 1).

### 6.3 期期对冲要点

- 按预算或张数拆分主/次腿(见 `HEDGE_PLAN_OO_BIAS_*`).
- 平仓模式(到期平 / 全平等)受 `HEDGE_PLAN_OO_CLOSE_MODE_ENABLED` 控制.

### 6.4 半腿

一侧成交、另一侧失败时,默认可挂 `partial` 在页面 **手动补开**(`HEDGE_PLAN_MANUAL_COMPLETE_ON_PARTIAL=true`),避免误自动平掉已成腿.

真下单还需 `HEDGE_PLAN_LIVE_ORDER=true` 与 `LIVE_TRADING_ENABLED=true`(以 env 为准).

---

## 7. 模拟资金 vs 实盘

**系统设置 → 模拟资金**:

| 操作 | 说明 |
|------|------|
| 切换到模拟资金 | 本地 SQLite 钱包;用 OKX **公开行情** 吃买卖一结算,**不向交易所下真实单** |
| 切换到实盘 | 走真实 API(须密钥正确且允许实盘) |
| 重置权益 | 无仓时可重置;强制重置会清仓 |
| 划转 / USDT↔USDC | 仅作用于模拟钱包 |

启动默认模式:`SIM_DEFAULT_MODE=sim` 或 `live`.顶栏出现 **模拟** 徽章即表示当前为模拟.

---

## 8. 系统设置与 env

### 系统设置(`/settings`)

- **导航显示**:开关顶栏各入口
- **模拟资金**:见上节
- **账户密码**:改登录口令
- **永续划转 / 期权划转 / 币种兑换**:实盘账户内资金操作(模拟模式有对应模拟划转)
- **数据导出**:导出相关 CSV

### env 配置(`/env_config`)

常用项:

| 类别 | 变量示例 |
|------|----------|
| 登录 | `APP_PASSWORD`,`FLASK_SECRET_KEY` |
| API | `OKX_API_*`,`OKX_TD_MODE`,`OKX_POS_MODE` |
| 代理 | `OKX_SOCKS_PROXY=socks5h://127.0.0.1:1080` |
| 实盘开关 | `LIVE_TRADING_ENABLED` |
| 模式 | `OKX_TRADE_MODE` |
| 期权预算 | `OKX_OPTIONS_TRADE_BUDGET_USDC`,`OKX_OPTIONS_COMPOUND_FULL_*` |
| 对冲 | `HEDGE_PLAN_*`,`MAX_ACTIVE_HEDGE_PLANS` |
| 企业微信 | `WECHAT_WEBHOOK` |

完整注释见根目录 **`.env.example`**.`.env` 勿提交 Git;`git pull` 不会覆盖本地 `.env`.

---

## 9. 首次上手建议

1. 部署并打开站点,登录后到 **系统设置 → 模拟资金**,确认处于 **模拟**.
2. **env 配置** 填 API(模拟下单可不真下交易所,但拉链/行情通常仍需可达 OKX;本机受限时配 SOCKS).
3. 设 `OKX_TRADE_MODE=options`,在 **期权** 页熟悉开平仓与持仓卡.
4. 需要复盘时用 **期权复盘**.
5. 再按需改成永期/期期对冲,先模拟跑通再切实盘.
6. 实盘前再开 `LIVE_TRADING_ENABLED` / `HEDGE_PLAN_LIVE_ORDER`,并确认 OKX 权限、持仓模式、IP 白名单.

---

## 10. 风险与合规

- 期权与永续杠杆风险高,实盘盈亏自负.
- 勿把 `.env`、API 密钥提交到仓库或发到公网.
- 请遵守当地法规与 OKX 用户协议;本说明仅描述产品用法,不构成投资建议.