Merge OKX dual APIs into one OKX_API_* account for perp and options.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/期权用法.md

@@ -2,37 +2,37 @@
 
 ## 1. 前置条件
 
-1. OKX **主账户**已开通期权(USDⓈ 本位),且 App 中可见 `ETHUSD UM` / `BTCUSD UM`.
-2. 在 `crypto_monitor_okx/.env` 配置 **期权专用 API**(与永续子账户分开):
+1. OKX 账户已开通期权(USDⓈ 本位),且 App 中可见 `ETHUSD UM` / `BTCUSD UM`.
+2. 在 `crypto_monitor_okx/.env` 配置 **唯一账户 API**(永续与期权共用):
 
 ```bash
+OKX_API_KEY=你的账户Key
+OKX_API_SECRET=...
+OKX_API_PASSPHRASE=...
 OKX_OPTIONS_ENABLED=true
-OKX_OPTIONS_API_KEY=你的主账户Key
-OKX_OPTIONS_API_SECRET=...
-OKX_OPTIONS_API_PASSPHRASE=...
 ```
 
-3. 重启实例:`pm2 restart crypto_okx`
+3. 重启实例:`pm2 restart crypto_okx --update-env`
 
-> 永续仍用原有 `OKX_API_*`(子账户);期权只用 `OKX_OPTIONS_API_*`(主账户).
+> 旧 `OKX_OPTIONS_API_*` 已废弃.若仅残留 OPTIONS 键而 `OKX_API_*` 为空,启动会自动回填.
 
 ## 2. 资金准备
 
-期权权利金使用 **USDC 或 USDG**,不能直接用 USDT 买入.
+期权权利金使用 **USDC**,不能直接用 USDT 买入.
 
 ### 推荐步骤
 
-1. 打开 **期权** 页,查看顶栏:
-   - **资金账户**:USDT 余额
-   - **交易账户**:USDC 余额(买期权从这里扣)
+1. 查看顶栏:
+   - **资金账户 / 交易账户**:USDT
+   - **期权资金账户 / 期权交易账户**:USDC
 2. **币种兑换**(资金账户内)  
    - 从 USDT 兑换为 USDC  
    - 先点 **询价**,确认预估获得量后点 **确认兑换**
-3. **账户划转**  
+3. **账户内划转**  
    - 从:资金账户 → 到:交易账户  
    - 币种:USDC  
    - 将兑换得到的 USDC 划到交易账户
-4. 确认 **交易账户 USDC** 足够支付本笔权利金
+4. 确认 **期权交易账户 USDC** 足够支付本笔权利金
 
 系统 **不会** 自动兑换或划转,避免误动资金.
 
@@ -85,82 +85,23 @@ OKX_OPTIONS_API_PASSPHRASE=...
 
 ## 6. 与永续 / 对冲计划的关系
 
-| | 永续(子账户) | 期权(主账户) |
-|--|----------------|----------------|
-| API | `OKX_API_*` | `OKX_OPTIONS_API_*` |
+| | 永续 | 期权 |
+|--|------|------|
+| API | `OKX_API_*`(同一套) | `OKX_API_*`(同一套) |
 | 页面 | 实盘下单 / 关键位 | 期权 · 对冲计划 |
-| 资金顶栏 | USDT 资金户+交易户 | 期权页单独显示 USDC 等 |
-
-两套资金 **不合并** 显示.
+| 顶栏 | USDT 资金户+交易户 | USDC 期权资金+期权交易 |
 
 **期期对冲张数**(对冲计划页,与单独开期权共用预算算法):
 
 | 模式 | 说明 |
 |------|------|
 | 同张数(默认) | 两腿同 `n`,总权利金 ≤ 预算 |
-| 做多 | Call:Put 按主腿占比(默认 7:3) |
-| 做空 | Put:Call 按主腿占比(默认 7:3) |
+| 按比例 | 主腿/次腿按 `HEDGE_PLAN_OO_BIAS_*` |
 
-拆分口径与比例见 env:`HEDGE_PLAN_OO_BIAS_SPLIT_BY`(`budget` 默认 / `sheets`=先算同张数总张数 `2n` 再拆)、`HEDGE_PLAN_OO_BIAS_RATIO`(默认 `0.7`)。细则见 [对冲计划开发方案.md](./对冲计划开发方案.md) §4.1、[系统说明.md](./系统说明.md)。
+## 7. 常见问题
 
-## 7. 配置说明
+**Q:以前的期权专用密钥还要配吗?**  
+- 不需要.统一写到 `OKX_API_*`.
 
-| 变量 | 默认 | 含义 |
-|------|------|------|
-| `OKX_OPTIONS_TRADE_BUDGET_USDC` | 10 | 单笔权利金上限 |
-| `OKX_OPTIONS_BUDGET_BUFFER` | 0.95 | 算张数时预留 5% 缓冲 |
-| `OKX_OPTIONS_MAX_DTE_DAYS` | 2 | 最多选几天内到期 |
-| `OKX_OPTIONS_ITM_MAX_DIST_USD` | 30 | 轻度实值:价内不超过多少 USD |
-| `OKX_OPTIONS_PROFIT_ALERT_RATIO` | 1.0 | 浮盈/权利金 ≥ 此值推送 |
-| `HEDGE_PLAN_OO_BIAS_SPLIT_BY` | budget | 期期做多/做空:按预算或按张数拆 |
-| `HEDGE_PLAN_OO_BIAS_RATIO` | 0.7 | 期期做多/做空主腿占比 |
-
-## 8. 期权复盘(含对冲)
-
-仅 **OKX** 实例提供独立页 **期权复盘**(`/options/review`),与合约「交易记录与复盘」完全隔离.
-
-### 数据来源
-
-| 类型 | source_type | 来源 | 粒度 |
-|------|-------------|------|------|
-| 纯期权 | `option_spot` | 本地 `options_trades` 已平仓 | 一仓一条 |
-| 永期对冲 | `perp_options` | 本地 `hedge_plans` 且 `status=closed` | **一计划一条** |
-| 期期对冲 | `options_options` | 同上 | **一计划一条** |
-
-- 打开复盘页即自动读取本地记录,**不访问交易所**.
-- 对冲盈亏主口径:`realized_pnl_total`;详情另显永续/期权分项.
-- 若某纯期权 `inst_id` 已出现在对冲腿中,默认标记排除,避免总盈亏双计.
-- 人工复盘字段存在 `options_review_entries`,刷新本地源**不会覆盖**.
-
-### 图片
-
-- 目录:`static/images/options_journal/`
-- 文件名:`options_journal_{draftId}_{5m|15m|1h|4h}.ext`(与合约复盘同周期槽位)
-- 备份时与 `crypto.db` 一并打包即可;勿与合约 `journal_*` 截图混用.
-
-### 页面
-
-顶部三个 Tab:**期权交易记录** / **期期对冲记录** / **永期对冲记录**.点击列表行后在下方打开「复盘记录上传」,支持四周期即时截图与情绪标签.
-
-### 统计
-
-同页 KPI + 分组:类型、标的、策略标签、对冲结束原因、持有周期、Call/Put.策略维度仅统计已填策略标签的记录.
-
-## 9. 常见问题
-
-**Q:为什么买不了?**  
-- 交易账户 USDC 不足 → 先兑换再划转  
-- 卖一价过高,10U 预算买不到 1 张 → 选更便宜合约或提高 `OKX_OPTIONS_TRADE_BUDGET_USDC`  
-- 期权 API 未配置或 `OKX_OPTIONS_ENABLED=false`
-
-**Q:报价 15 是每张 15U 吗?**  
-- 不是.15 是 **每 1 ETH** 的报价;每张(0.01 ETH)约 0.15 USDC.
-
-**Q:子账户能开期权吗?**  
-- 本系统期权走主账户 API;子账户永续不受影响.
-
-## 10. 风险说明
-
-- 买方最大亏损为 **权利金**;近期实值仍会时间衰减  
-- 限价单可能因无流动性未成交  
-- 请先在小额下验证兑换,划转,开平仓全流程
+**Q:还能主↔子划转吗?**  
+- 已移除.只保留同账户内划转与币种兑换.