Replace 期期 equal-split with long/short bias sizing and env ratio controls.

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

docs/对冲计划开发方案.md

@@ -96,8 +96,11 @@
 - 预算:`B = min(交易户 USDC × OKX_OPTIONS_BUDGET_BUFFER, OKX_OPTIONS_TRADE_BUDGET_USDC)`(默认 buffer=0.95).
 - 自动张数(选齐两腿后写入,可手改):
   - **同张数**(默认):最大 `n` 使 `n×(cost_A+cost_B) ≤ B`,两腿均填 `n`
-  - **均分预算**:各用 `B/2` 反推张数(两腿可不同)
+  - **做多 / 做空**:须一 Call 一 Put;主:次默认 **7:3**(`HEDGE_PLAN_OO_BIAS_RATIO`,可改)
+    - 做多:主腿=Call;做空:主腿=Put
+    - 拆分口径 `HEDGE_PLAN_OO_BIAS_SPLIT_BY`:`budget`(默认,按权利金预算拆) / `sheets`(先算同张数 `n` 再按比例拆张数)
   - 另受各自卖一深度上限约束
+  - 已移除页面「均分」;后端仍兼容旧 `split_budget` 入参(预算对半)
 
 ### 4.2 目标价
 

docs/更新文档.md

@@ -4,6 +4,37 @@
 
 ---
 
+## 2026-07-19 · 期期张数：做多/做空替代均分 + env 拆分口径
+
+### 修改原因
+
+期期「均分」与方向偏好无关；需要按 Call/Put 7:3（可配）做偏多/偏空自动张数，并可用 env 在「预算金额 / 张数」两种拆法间切换。
+
+### 修改的地方
+
+| 文件 | 改动摘要 |
+|------|----------|
+| `lib/hedge_plan/hedge_plan_calc_lib.py` | `long_bias`/`short_bias`；`budget`/`sheets` + `bias_ratio` |
+| `lib/hedge_plan/hedge_plan_register.py` | gates 下发 `oo_bias_split_by` / `oo_bias_ratio` |
+| `lib/hedge_plan/templates/hedge_plan_panel.html` | 张数段：同张数 / 做多 / 做空 |
+| `lib/common/static/hedge_plan.js` | 前端建议张数与 env 同步 |
+| `crypto_monitor_okx/.env.example` + env UI/schema | `HEDGE_PLAN_OO_BIAS_SPLIT_BY`、`HEDGE_PLAN_OO_BIAS_RATIO` |
+| `docs/系统说明.md` 等 | 同步操作与配置说明 |
+
+### 达成的目标
+
+1. 默认仍为同张数。  
+2. 做多=Call 主占比、做空=Put 主占比；默认比例 0.7，口径默认预算金额。  
+3. `sheets` 口径：先算同张数 `n` 再拆。  
+
+### 交付之后的验收
+
+1. 期期页可见「同张数 / 做多 / 做空」，无「均分」。  
+2. env 配置可改口径与比例；生产 OKX `.env` 已补齐键。  
+3. 选一 Call 一 Put 后自动张数符合比例；非 C+P 时提示。
+
+---
+
 ## 2026-07-17 · 修复 pip>=26 部署依赖安装失败
 
 ### 修改原因

docs/期权开平仓与监控说明.md

@@ -83,6 +83,7 @@
 5. **无市价强平**:盘口真空时系统**不会**市价砸盘,仓位可能留到到期.
 6. **目标位只看指数**:触达后仍受买一/2×门控约束,可能「到价却平不掉」.
 7. **对冲计划腿**:期权腿退出规则见对冲方案;独立期权页平仓勿与计划状态脱节.
+8. **期期自动张数**:对冲计划页为「同张数 / 做多 / 做空」(已无均分);做多/做空按 Call·Put 比例拆,口径与比例见 env `HEDGE_PLAN_OO_BIAS_SPLIT_BY`、`HEDGE_PLAN_OO_BIAS_RATIO`.
 
 ---
 
@@ -91,3 +92,4 @@
 - [期权用法.md](./期权用法.md) — 资金兑划与页面操作
 - [期权方案.md](./期权方案.md) — env 与架构
 - [对冲计划开发方案.md](./对冲计划开发方案.md) — 永期/期期与期权腿
+- [系统说明.md](./系统说明.md) — 实例操作与门禁总手册

docs/期权用法.md

@@ -78,16 +78,26 @@ OKX_OPTIONS_API_PASSPHRASE=...
 
 需已配置 `WECHAT_WEBHOOK`.
 
-## 6. 与永续的关系
+## 6. 与永续 / 对冲计划的关系
 
 | | 永续(子账户) | 期权(主账户) |
 |--|----------------|----------------|
 | API | `OKX_API_*` | `OKX_OPTIONS_API_*` |
-| 页面 | 实盘下单 / 关键位 | 期权 |
+| 页面 | 实盘下单 / 关键位 | 期权 · 对冲计划 |
 | 资金顶栏 | USDT 资金户+交易户 | 期权页单独显示 USDC 等 |
 
 两套资金 **不合并** 显示.
 
+**期期对冲张数**(对冲计划页,与单独开期权共用预算算法):
+
+| 模式 | 说明 |
+|------|------|
+| 同张数(默认) | 两腿同 `n`,总权利金 ≤ 预算 |
+| 做多 | Call:Put 按主腿占比(默认 7:3) |
+| 做空 | Put:Call 按主腿占比(默认 7:3) |
+
+拆分口径与比例见 env:`HEDGE_PLAN_OO_BIAS_SPLIT_BY`(`budget` 默认 / `sheets`)、`HEDGE_PLAN_OO_BIAS_RATIO`(默认 `0.7`)。细则见 [对冲计划开发方案.md](./对冲计划开发方案.md) §4.1、[系统说明.md](./系统说明.md)。
+
 ## 7. 配置说明
 
 | 变量 | 默认 | 含义 |
@@ -97,6 +107,8 @@ OKX_OPTIONS_API_PASSPHRASE=...
 | `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. 期权复盘(含对冲)
 

docs/系统说明.md

@@ -122,12 +122,14 @@
 ### 3.3 操作：期期
 
 1. 填上破 / 下破目标；指数价作参考。  
-2. 张数模式：**同张数**（默认）或 **均分预算**；平仓模式：**全平**（默认）或 **到期平**（若 env 打开方案 C）。  
-3. T 型报价选用两腿；可先划转 USDC。  
+2. 张数模式：**同张数**（默认）、**做多**、**做空**；平仓模式：**全平**（默认）或 **到期平**（若 env 打开方案 C）。  
+3. T 型报价选用两腿（做多/做空须一 Call 一 Put）；可先划转 USDC。  
 4. **计算** → 情景测算 → **启动计划**。
 
 逻辑摘要：
 
+- **同张数**：最大 `n` 使两腿各 `n` 张且总权利金 ≤ 预算。  
+- **做多 / 做空**：主腿与次腿按 env 比例（默认 7:3）分配；做多主腿=Call，做空主腿=Put。拆分口径由 `HEDGE_PLAN_OO_BIAS_SPLIT_BY` 决定：`budget`（默认，按权利金预算拆）或 `sheets`（先算同张数 `n` 再拆张数）。  
 - 达目标价：通常只平盈利腿。  
 - **全平**：盈利腿平掉后立刻尝试清另一腿（无 2× 权利金门控，失败会重试）。  
 - **到期平**：残腿持有至到期再结。  
@@ -320,6 +322,8 @@ A：可能是仅提醒类型、门控未过、RR 不足、满仓/日上限，或
 | 半腿失败改手动补开 | 见 3.4 |
 | 半腿失败时自动平期权 | 手动补开开启时强制无效 |
 | 期期平仓模式（方案 C） | 页面是否出现「全平 / 到期平」 |
+| 期期做多做空拆分口径 | `budget` 预算金额（默认）/ `sheets` 张数 |
+| 期期做多做空主腿占比 | 默认 `0.7`（即 7:3） |
 
 含「需重启」标记的项保存后要用「保存并重启」；对冲多数开关可热更，以页面标注为准。