Document detailed open/close logic and LIVE failure handling.

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

docs/OKX实盘策略说明.md

@@ -77,11 +77,12 @@ ATM **期权买方** + **反向永续**；净利达标兑现，未达标拖到
 | 路径 | OKX 动作 |
 |------|----------|
 | **A 双腿全平** | 先市价卖期权（cash）→ 再市价平永续（reduceOnly + 反向 posSide） |
-| **B 远虚** | 只平永续；期权留账户到期，按 **内在价值** 结算；残留不挡新开 |
-| **到期** | 期权一般由交易所结算内在价值，软件记账；若永续仍在则市价平掉 |
-| **紧急** | 尽量双腿市价；可放宽流动性等待；**成交价仍按买一**（不用标记） |
+| **B 远虚** | 只平永续；期权归档残留；不挡新开 |
+| **残留回收** | 权利金回升 ≥ 设置%（默认 20%）→ **买一 IOC 限价卖**；部分成交入账；优先对账防重复卖 |
+| **到期** | 优先交易所卖残留/平活跃腿；不能交易时内在价值记账 |
+| **紧急** | 尽量双腿市价；可放宽流动性；残留优先交易所卖 |
 
-流动性闸门（仅 A）：买一深度、买一/标记偏差 ≤30%——实盘以能否成交为准，闸门主要用于避免垃圾价硬扫。
+流动性闸门（A + 残留回收）：买一深度、买一/标记偏差 ≤30%。开平异常状态见 [策略说明 §5](./策略说明.md)。
 
 ---
 

docs/币安实盘策略说明.md

@@ -1,127 +1,128 @@
-# 币安实盘策略说明
-
-> 产品：**比特骆驼自动化对冲系统** · 专用于 **币安** LIVE。通用对冲逻辑见 [策略说明](./策略说明.md)；OKX 见 [OKX实盘策略说明](./OKX实盘策略说明.md)。  
-> **标准仓**：永续 **1 ETH** + 期权 **2 ETH** 名义（倍数 `k` 可缩放）。  
-> 更新：2026-07-26
-
----
-
-## 1. 一句话
-
-ATM **期权买方** + **反向永续**；净利达标兑现，未达标拖到期。币安侧永续与欧洲期权均可 **USDT** 计价，**无需像 OKX 那样先把 USDT 换成 USDC**，账户准备更简单。
-
----
-
-## 2. 合约与资金
-
-| 腿 | 合约（默认） | 计价 / 保证金 | 说明 |
-|----|--------------|---------------|------|
-| 永续 | `ETHUSDT`（USDT-M） | **USDT** | 下单数量直接为 **ETH**（软件按名义 ETH 填 `quantity`） |
-| 期权 | `ETH-YYMMDD-行权价-C/P`（欧洲期权 eapi） | **USDT** | 张数：名义 ETH ÷ 合约单位（默认约 **1**） |
-
-### 2.1 资金（相对 OKX 更简单）
-
-- 主要准备 **USDT** 即可：永续保证金 + 期权权利金 + 缓冲。
-- **不需要**日常 USDT→USDC 换汇（这是 OKX `ETH-USD_UM` 的常见摩擦）。
-- 仍须留足：保证金挤压、多日磨损、手续费。
-
-### 2.2 账户模式建议
-
-| 项 | 建议 |
-|----|------|
-| 永续 | USDT-M；**双向持仓（Hedge）** 时软件带 `positionSide=LONG/SHORT`；单向模式则用 `reduceOnly` |
-| 期权 | 欧洲期权账户开通；买方；尽量独立保证金，便于残留不挡新开 |
-| API | Key + Secret（**无 Passphrase**）；分别开通 **期货 + 期权** 交易权限；IP 白名单 |
-
-### 2.3 与 OKX 对照
-
-| 项 | 币安 | OKX |
-|----|------|-----|
-| 保证金币 | 多为统一 **USDT** | 永续 USDT + 期权常 **USDC** |
-| 换汇 | 一般不需要 | 常需 USDT↔USDC |
-| API | Key + Secret | Key + Secret + Passphrase |
-| 永续数量 | ETH 名义 | 张（÷ ctVal） |
-| 期权接口 | `eapi.binance.com` | OKX V5 `OPTION` |
-| ATM 档 | 行权价网格常更粗 | 相对更细（视产品） |
-
----
-
-## 3. 标准仓与缩放
-
-`永续 = 1×k ETH`，`期权 = 2×k ETH`，净利目标 ≈ `15×k` USDT。  
-试跑建议 **k=0.1**。
-
-注意：币安期权单位常为 1 ETH/张，同样 2 ETH 名义 ≈ **2 张**；OKX 默认 0.01 乘数时张数会大很多——**不要照搬张数，只锁 ETH 名义比 1:2**。
-
----
-
-## 4. 开仓机制（币安）
-
-```
-选 ATM → 先 eapi 市价买期权 → 再 fapi 市价开永续
-永续失败 → eapi 市价卖期权回滚
-```
-
-| 步骤 | 币安行为 |
-|------|----------|
-| 1 期权 | `POST /eapi/v1/order`，`type=MARKET`，`side=BUY`，`quantity`=张 |
-| 2 永续 | `POST /fapi/v1/order`，`type=MARKET`；多=`BUY`+`LONG`，空=`SELL`+`SHORT` |
-| 失败回滚 | 期权 `SELL` + `reduceOnly` |
-
-**与 OKX 差异**：
-
-- 双 API 域：期权 eapi、永续 fapi，限流与权限分开。
-- 永续数量用 **ETH**，期权用 **张**（单位≈1）。
-- 无 Passphrase；需确认账户是对冲模式还是单向（软件会探测 `positionSide/dual`）。
-- ATM 行权价档更粗时，更常触发「行权价相对现价偏上/偏下」选向规则。
-
-选向表与通用策略说明相同。
-
----
-
-## 5. 平仓机制（币安）
-
-| 路径 | 币安动作 |
-|------|----------|
-| **A 双腿全平** | eapi 市价卖期权 → fapi 市价平永续（`reduceOnly` / 反向 `positionSide`） |
-| **B 远虚** | 只平永续；期权留到到期按 **内在价值** 结算；不挡下一组 |
-| **到期** | 期权交易所结算；软件按内在价值记账；永续若在则平掉 |
-| **紧急** | 尽量双腿市价 |
-
-期权远虚时 eapi 买一可能枯竭——优先走 B，勿死磕 A。
-
----
-
-## 6. 监控与模式
-
-有活跃仓钉持仓行权价；空仓/仅残留跟新 ATM。
-
-设置页：交易所选 **币安**，运行模式 **LIVE**，填 Key/Secret → `.env`。切 LIVE 输入 `LIVE` 确认。
-
----
-
-## 7. 风险（币安特有加重）
-
-| 风险 | 说明 |
-|------|------|
-| **期权权限 / 地区** | 未开通欧洲期权则无法下单 |
-| **eapi 限流** | 比 fapi 更敏感；独立 IP、退避 |
-| **ATM 粗档** | 方向偏差更大，更依赖选向规则 |
-| **对冲模式不一致** | 单向账户却强制 `positionSide` 会拒单（软件已探测） |
-
----
-
-## 8. 上线检查（币安）
-
-1. SIM 在币安行情下跑通。  
-2. 期货 + 期权交易权限、USDT 余额到位。  
-3. API Key/Secret + LIVE 确认。  
-4. k=0.1 试开平 / 到期或残留。  
-
----
-
-## 9. 修订记录
-
-| 日期 | 说明 |
-|------|------|
-| 2026-07-26 | 初稿：币安 LIVE 接入；强调 USDT 统一、eapi/fapi 开平差异 vs OKX |
+# 币安实盘策略说明
+
+> 产品：**比特骆驼自动化对冲系统** · 专用于 **币安** LIVE。通用对冲逻辑见 [策略说明](./策略说明.md)；OKX 见 [OKX实盘策略说明](./OKX实盘策略说明.md)。  
+> **标准仓**：永续 **1 ETH** + 期权 **2 ETH** 名义（倍数 `k` 可缩放）。  
+> 更新：2026-07-26
+
+---
+
+## 1. 一句话
+
+ATM **期权买方** + **反向永续**；净利达标兑现，未达标拖到期。币安侧永续与欧洲期权均可 **USDT** 计价，**无需像 OKX 那样先把 USDT 换成 USDC**，账户准备更简单。
+
+---
+
+## 2. 合约与资金
+
+| 腿 | 合约（默认） | 计价 / 保证金 | 说明 |
+|----|--------------|---------------|------|
+| 永续 | `ETHUSDT`（USDT-M） | **USDT** | 下单数量直接为 **ETH**（软件按名义 ETH 填 `quantity`） |
+| 期权 | `ETH-YYMMDD-行权价-C/P`（欧洲期权 eapi） | **USDT** | 张数：名义 ETH ÷ 合约单位（默认约 **1**） |
+
+### 2.1 资金（相对 OKX 更简单）
+
+- 主要准备 **USDT** 即可：永续保证金 + 期权权利金 + 缓冲。
+- **不需要**日常 USDT→USDC 换汇（这是 OKX `ETH-USD_UM` 的常见摩擦）。
+- 仍须留足：保证金挤压、多日磨损、手续费。
+
+### 2.2 账户模式建议
+
+| 项 | 建议 |
+|----|------|
+| 永续 | USDT-M；**双向持仓（Hedge）** 时软件带 `positionSide=LONG/SHORT`；单向模式则用 `reduceOnly` |
+| 期权 | 欧洲期权账户开通；买方；尽量独立保证金，便于残留不挡新开 |
+| API | Key + Secret（**无 Passphrase**）；分别开通 **期货 + 期权** 交易权限；IP 白名单 |
+
+### 2.3 与 OKX 对照
+
+| 项 | 币安 | OKX |
+|----|------|-----|
+| 保证金币 | 多为统一 **USDT** | 永续 USDT + 期权常 **USDC** |
+| 换汇 | 一般不需要 | 常需 USDT↔USDC |
+| API | Key + Secret | Key + Secret + Passphrase |
+| 永续数量 | ETH 名义 | 张（÷ ctVal） |
+| 期权接口 | `eapi.binance.com` | OKX V5 `OPTION` |
+| ATM 档 | 行权价网格常更粗 | 相对更细（视产品） |
+
+---
+
+## 3. 标准仓与缩放
+
+`永续 = 1×k ETH`，`期权 = 2×k ETH`，净利目标 ≈ `15×k` USDT。  
+试跑建议 **k=0.1**。
+
+注意：币安期权单位常为 1 ETH/张，同样 2 ETH 名义 ≈ **2 张**；OKX 默认 0.01 乘数时张数会大很多——**不要照搬张数，只锁 ETH 名义比 1:2**。
+
+---
+
+## 4. 开仓机制（币安）
+
+```
+选 ATM → 先 eapi 市价买期权 → 再 fapi 市价开永续
+永续失败 → eapi 市价卖期权回滚
+```
+
+| 步骤 | 币安行为 |
+|------|----------|
+| 1 期权 | `POST /eapi/v1/order`，`type=MARKET`，`side=BUY`，`quantity`=张 |
+| 2 永续 | `POST /fapi/v1/order`，`type=MARKET`；多=`BUY`+`LONG`，空=`SELL`+`SHORT` |
+| 失败回滚 | 期权 `SELL` + `reduceOnly` |
+
+**与 OKX 差异**：
+
+- 双 API 域：期权 eapi、永续 fapi，限流与权限分开。
+- 永续数量用 **ETH**，期权用 **张**（单位≈1）。
+- 无 Passphrase；需确认账户是对冲模式还是单向（软件会探测 `positionSide/dual`）。
+- ATM 行权价档更粗时，更常触发「行权价相对现价偏上/偏下」选向规则。
+
+选向表与通用策略说明相同。
+
+---
+
+## 5. 平仓机制（币安）
+
+| 路径 | 币安动作 |
+|------|----------|
+| **A 双腿全平** | eapi 市价卖期权 → fapi 市价平永续（`reduceOnly` / 反向 `positionSide`） |
+| **B 远虚** | 只平永续；期权归档残留；不挡下一组 |
+| **残留回收** | 权利金 ≥ 设置% → eapi **买一 IOC 限价卖**；部分成交入账；对账防重复卖 |
+| **到期** | 优先交易所卖；否则内在价值记账；永续若在则平掉 |
+| **紧急** | 尽量双腿市价；残留优先交易所卖 |
+
+期权远虚时 eapi 买一可能枯竭——优先走 B，勿死磕 A。开平异常见 [策略说明 §5](./策略说明.md)。
+
+---
+
+## 6. 监控与模式
+
+有活跃仓钉持仓行权价；空仓/仅残留跟新 ATM。
+
+设置页：交易所选 **币安**，运行模式 **LIVE**，填 Key/Secret → `.env`。切 LIVE 输入 `LIVE` 确认。
+
+---
+
+## 7. 风险（币安特有加重）
+
+| 风险 | 说明 |
+|------|------|
+| **期权权限 / 地区** | 未开通欧洲期权则无法下单 |
+| **eapi 限流** | 比 fapi 更敏感；独立 IP、退避 |
+| **ATM 粗档** | 方向偏差更大，更依赖选向规则 |
+| **对冲模式不一致** | 单向账户却强制 `positionSide` 会拒单（软件已探测） |
+
+---
+
+## 8. 上线检查（币安）
+
+1. SIM 在币安行情下跑通。  
+2. 期货 + 期权交易权限、USDT 余额到位。  
+3. API Key/Secret + LIVE 确认。  
+4. k=0.1 试开平 / 到期或残留。  
+
+---
+
+## 9. 修订记录
+
+| 日期 | 说明 |
+|------|------|
+| 2026-07-26 | 初稿：币安 LIVE 接入；强调 USDT 统一、eapi/fapi 开平差异 vs OKX |

docs/策略说明.md

@@ -3,10 +3,12 @@
 > 产品：**比特骆驼自动化对冲系统**（工程 `eth_hedge_sim`）  
 > 依据当前代码逻辑整理（SIM 默认真值参数）。  
 > 关联：[开发方案](./开发方案.md)、[商业化与授权方案](./商业化与授权方案.md)、[实盘索引](./实盘策略说明.md)、[OKX实盘](./OKX实盘策略说明.md)、[币安实盘](./币安实盘策略说明.md)  
-> 更新：2026-07-26
+> 更新：2026-08-02（开平仓细则 + 实盘异常处理；残留权利金回收）
 
 **运行模式**：设置页「运行模式」可切 **SIM / LIVE**；交易所 API 录入后写入服务器 `.env`（不回传明文）。LIVE 须二次确认输入 `LIVE`；**OKX / 币安均可真下单**（须选对应当前交易所并配齐密钥）。有持仓时不可切模式。
 
+分所动作细节另见：[OKX实盘](./OKX实盘策略说明.md)、[币安实盘](./币安实盘策略说明.md)。**策略口径以本文为准。**
+
 ---
 
 ## 1. 策略一句话
@@ -93,179 +95,260 @@ k = floor(budget / (2A + I×fee_rate×3) × 10) / 10
 
 ---
 
-## 3. 开仓机制
+## 3. 开仓机制（详细）
 
-### 3.1 流程概览
+### 3.1 何时允许尝试开仓
+
+须**同时**满足：
+
+| # | 条件 | 说明 |
+|---|------|------|
+| 1 | 策略 `running=1` | 暂停时**不新开**（仍可平仓/到期） |
+| 2 | 本地无 blocking 仓 | `flat` 才开；`open` / `half_open` / `option_closed_perp_pending` / `opening` 均禁止新开 |
+| 3 | 不在组间休息 | 上一组全平成功后 `rest_seconds`（默认 300s）内不开 |
+| 4 | 周末门禁 | `skip_weekends=true` 时上海时区六日跳过新开 |
+| 5 | 资金门 | 以损定仓模式下预算推不出 `k≥0.1` → 拒绝开仓 |
+| 6 | LIVE 对账 | 开仓前核交易所无「多余」永续/期权残留（防双开） |
+
+### 3.2 选约与选向（逐步）
 
 ```
-策略运行中
-  → 无持仓且不在休息期
-  → 非周末跳过（若开启）
-  → 选到期：剩余时长 ≥ min_option_hours（默认 12h）
-  → 若固定方向关：该到期 ATM；若开：按 Put/Call 选实值或平值档
-  → 若未开固定方向且开启 atm_open_offset_enabled：|ATM − 标的| ≤ max_atm_open_offset（默认 3）否则跳过
-  → 选向：固定方向按设置；否则 ATM 偏下→Call+空；偏上→Put+多；贴平→卖一比价
-  → 期权杠杆 = 标的价 ÷ 卖一权利金 ≥ min_option_leverage（默认 100）
-  → 先开期权（吃卖一）→ 再市价开永续（一组）
-  → 锁定 initial_premium = 期权成交价 × 期权名义（不含费）
+1) 列可交易到期日：剩余时长 ≥ min_option_hours（默认 12h）
+2) 跳过「当日已用过」的到期（one_expiry_per_day，默认开）
+3) 跳过仍有 pending 残留期权的到期日（避免同到期叠残留）
+4) 固定方向关：取该到期 ATM 对（Call/Put）
+   固定方向开：同到期取实值或平值、最贴近标的的 Put/Call
+5) 未开固定方向且 atm_open_offset_enabled：|K−标的| ≤ max_atm_open_offset，否则换下一到期/等待
+6) 选向（见 §2.1）
+7) 杠杆门：标的价 ÷ 卖一权利金 ≥ min_option_leverage（默认 100）
+8) 以损定仓：按预算算出 k，写入本组 perp/option 名义与出场目标
 ```
 
-### 3.2 选约约束
+无合格合约：状态等待，记「无合格期权…」，**不硬开**。
 
-| 参数 | 默认 | 作用 |
-|------|------|------|
-| `min_option_hours` | 12 | 过滤过近到期，减少刚开仓就到期 |
-| `min_option_leverage` | 100 | 权利金相对标的不能太贵（现价/卖一） |
-| `fixed_direction_enabled` | false | 固定方向开关（默认关） |
-| `fixed_perp_side` | long | 开启后：long=多+Put / short=空+Call |
-| `atm_open_offset_enabled` | false | 开仓 ATM 偏差限制开关（默认关；固定方向开启时忽略） |
-| `max_atm_open_offset` | 3 | 开关开启后：\|ATM − 标的\| 超过则不开 |
-| ATM / 实值平值 | — | 默认 ATM；固定方向时同到期实值或平值、最贴近标的 |
+### 3.3 成交顺序（SIM / LIVE 相同意图）
 
-无合格合约时：状态停留等待，记录「无合格期权…」，不硬开。
+```
+claim 开仓槽 status=opening
+  → 先买期权（吃卖一 / LIVE 市价买）
+  → 成功后市价开永续（对冲方向）
+  → 两边都成功 → status=open，锁定 initial_premium = 成交价×期权名义（不含费）
+  → 永续失败 → 立刻卖回期权回滚；回滚失败 → half_open（见 §5）
+```
 
-### 3.3 时间与节奏
+要点：
+
+- **薄腿优先**：期权先于永续，避免只剩裸永续。
+- **单组纪律**：同时最多 1 组活跃仓。
+- **SIM**：本地撮合 + 可配 `fee_rate` + 约 1×费率滑点。
+- **LIVE**：交易所真实均价与手续费；**不计模拟滑点**。
+
+### 3.4 时间与节奏
 
 | 规则 | 说明 |
 |------|------|
 | 开仓时间窗 | **已取消**，全天可尝试（仍受选约约束） |
-| 周六/周日 | 默认 **跳过新开仓**（上海时区，`skip_weekends`）；持仓仍可平 |
-| 每日轮次上限 | **不限制**；波动大可能多轮，波动小可能一轮都难 |
-| 组间休息 | 全平后默认休息 **300 秒**（`rest_seconds`）再开下一组；**自动达标/到期、手动全平、紧急全平**成功后均进入休息 |
-| 暂停时 | **不新开仓**；仍执行 **目标平仓 + 到期平仓**（防重启/暂停漏平） |
-| 同时持仓 | 最多 1 组 |
+| 周六/周日 | 默认跳过新开（`skip_weekends`）；持仓仍可平 |
+| 每日轮次 | **不限制** |
+| 组间休息 | 达标/到期/手动/紧急全平**成功后**休息 `rest_seconds` |
+| 同到期一日一次 | `one_expiry_per_day`：当日已开过某到期并平仓后，不再开同到期 |
+| 暂停时 | 不新开；仍目标平 + 到期 + 残留巡检 |
 
-### 3.4 费用（SIM）
+### 3.5 选约参数
 
-- 永续、期权均按可配 `fee_rate`（默认 0.0005）计费。
-- **SIM**：滑点按约 1 倍费率计入成交价，手续费另扣；统计拆分「永续手续费 / 期权手续费 / 滑点」。
-- **LIVE**：用交易所真实成交价与真实手续费，**不计、不展示**模拟滑点。
-- 开仓现金：支付期权权利金 + 开仓手续费；永续开仓主要扣费。
+| 参数 | 默认 | 作用 |
+|------|------|------|
+| `min_option_hours` | 12 | 过滤过近到期 |
+| `min_option_leverage` | 100 | 权利金不能太贵 |
+| `one_expiry_per_day` | true | 同到期日一天只开一次 |
+| `fixed_direction_enabled` | false | 固定方向 |
+| `fixed_perp_side` | long | long→Put / short→Call |
+| `atm_open_offset_enabled` | false | ATM 偏差开关 |
+| `max_atm_open_offset` | 3 | \|ATM−标的\| 上限 |
 
 ---
 
-## 4. 平仓机制
+## 4. 平仓机制（详细）
 
-平仓分两大类：**① 目标平仓**（净盈利达标）；**② 到期平仓**（目标未达标，拖到到期）。  
-目标平仓又分两种落地方式（双腿全平 / 只平永续+期权归档到期）。
+平仓入口：**目标平仓**、**到期平仓**、**残留中途回收**、**紧急/手动全平**。
 
-### 4.1 目标平仓（第一优先级）
-
-**净盈利**口径（盯盘用，主要看买一，不看标记价）：
+### 4.1 盯盘净盈利口径
 
 ```
 净盈利 ≈ 永续浮盈 + 期权浮盈 − 预估平仓手续费
 期权浮盈 = 当前买一 × 数量 − 初始权利金
 ```
 
-| 出场模式 | 默认 | 触发条件 |
-|----------|------|----------|
-| `fixed_usdt` | 目标 **15 USDT** | 净盈利 ≥ `net_profit_target` |
-| `premium_multiple` | 倍数 **1.0** | 净盈利 ≥ `initial_premium × premium_exit_multiple` |
+（盯盘用**买一**，不用标记价顶替持仓合约。）
 
-说明：权利金倍数模式下，**1× = 赚回一倍权利金金额的净利**（例如权利金 20.41，目标约 20.41，不是 40.82）。
+| 出场模式 | 默认 | 触发 |
+|----------|------|------|
+| `fixed_usdt` | 15 USDT | 净盈利 ≥ `net_profit_target` |
+| `premium_multiple` | 1.0 | 净盈利 ≥ `initial_premium ×` 倍数 |
 
-达标后按期权状态走下面 **A / B** 两套（不是互相替换，按能否平掉期权分支）：
+权利金倍数：**1× = 赚回一倍权利金金额的净利**（权利金 20.41 → 目标约 20.41）。
 
-#### 4.1.A 双腿全平（期权仍有可平价值 / 非远虚）
+### 4.2 目标平仓分支 A / B
 
-- 条件：净利达标，且期权 **不是远虚**（仍可能有买一可平）。
-- 动作：校验买一深度 + 买一/标记偏差（默认 ≤30%）→ **先平期权、再平永续**。
-- 通不过流动性 → `liquidity_wait`，继续等待（不改开仓组）。
+达标后按期权是否**远虚**分支（远虚：内在价值 ≈ 0，默认阈值约 0.01 USDT/ETH）：
 
-#### 4.1.B 只平永续 + 期权归档到期（远虚）
-
-筛选约 **100× 杠杆** 期权时，标的波动约 **1%** 量级后，买方腿常变为**远虚**（内在价值≈0），买一往往枯死、整组硬平会卡死。
-
-- 条件：净利达标，且期权已是 **虚值且远虚**（内在价值 ≈ 0）。
-- 动作：
-  1. **只市价平掉永续**，兑现净利里永续那一截；
-  2. 本张期权归档为「残留」：不占用活跃持仓、**不挡住下一组开仓**；下一组只扫当前活跃组期权；
-  3. **中途回收（可配置）**：默认每 **5 分钟**巡检 pending 残留；当 **买一权利金 ≥ 初始权利金 × 比例**（默认 **20%**，系统设置「残留期权回收」可改）且通过买一流动性闸门时，按**最新买一 IOC 限价**卖掉该残留并结清（不扫市价簿）；
-  4. 未达比例或闸门不过 → 继续等到下次巡检，或到期按 **内在价值** 结算（多半接近 0）；
-  5. 页面：**活跃持仓区变空**；归档腿出现在「残留期权(待到期)」；下方期权盘口 **切回新 ATM**（见 4.6）。
-
-残留到期结算口径：
+#### 4.2.A 双腿全平（非远虚）
 
 ```
-结算价 = 内在价值（Put: max(K−S,0) / Call: max(S−K,0)）
-期权盈亏 ≈ (结算价 − 开仓均价) × 数量 − 结算手续费
-整组净利 = 已实现永续盈亏 + 期权结算盈亏 − 全部手续费
+校验买一深度覆盖名义
+  + 买一/标记偏差 ≤ close_bid_mark_max_pct（默认 30%）
+  → 先平期权（SIM 吃买一；LIVE 市价卖）
+  → 再平永续
+  → 任一步流动性不过 → liquidity_wait，组不变，下 tick 再试
 ```
 
-> 直觉：能双腿平就走 A；期权已经远虚平不掉就走 B，别把永续利润和下一单机会一起卡死。
+LIVE 特殊态：`option_closed_perp_pending`（期权已在交易所卖掉、永续未平完）→ 只续平永续，**禁止再卖一次期权**。
 
-### 4.2 到期平仓（目标未达标）
+#### 4.2.B 只平永续 + 期权归档（远虚）
+
+```
+只市价平永续
+  → 期权写入 residual_options（pending）
+  → 活跃仓变 flat，可开下一组
+  → 残留不挡新开；同到期仍计入「跳过到期」直到残留结清
+```
+
+### 4.3 残留期权中途回收（权利金比例）
+
+对 `residual_options.status=pending`：
+
+| 项 | 规则 |
+|----|------|
+| 巡检间隔 | 默认 **300s**（`residual_close_check_sec`） |
+| 门槛 | `买一×数量 ≥ 初始权利金 × residual_min_premium_pct%`（默认 **20%**，设置页可改） |
+| 闸门 | 同 4.2.A：深度 + 买一/标记偏差 |
+| 下单 | 再刷最新买一并**重算门槛**；LIVE 用买一 **IOC 限价卖**（不扫市价簿） |
+| 部分成交 | 已成交部分入账并扣减残留数量；剩余继续 pending |
+| 交易所已空 | 对账后本地直接结清，避免重复卖 |
+| 未达标/未成交 | 等到下次巡检或到期 |
+
+到期/紧急结算残留：LIVE **优先交易所卖掉**，失败再回落内在价值记账。
+
+### 4.4 到期平仓
 
 - 净利一直未达标 → **不主动砍仓**，持有到期权到期。
-- 到达期权到期时刻（OKX：UTC 08:00 = **上海 16:00**）→ 原因 `expiry`。
-- **活跃组**：期权按标的结算价的 **内在价值** 入账；若永续仍在则市价平掉。
-- **残留组**（曾走 4.1.B）：永续早已平掉，**只结算归档期权**，不碰当前活跃仓、不改下方 ATM。
-- 策略 **暂停时仍执行目标平仓与到期结算**，不新开仓；避免重启/暂停后漏平。
-- 波动小、拖到到期：权利金亏损视为 **预算内成本**，可接受。
+- 到期时刻：OKX 惯例 UTC 08:00 = **上海 16:00**（币安按该所交割时刻）。
+- **活跃组**：优先交易所平期权+永续；到期无法交易时用内在价值入账。
+- **残留组**：只处理归档期权；不改当前活跃仓与下方 ATM。
+- 暂停时仍执行到期与目标平仓。
 
-### 4.3 平仓流动性闸门（仅 4.1.A）
+### 4.5 紧急全平 / 手动全平
 
-双腿全平时：
+| 动作 | 行为 |
+|------|------|
+| 紧急全平 | 尽量双腿市价；可绕过流动性等待；期权成交价仍按买一逻辑（不用标记抬价）；残留优先交易所卖，再内在价值兜底；成功后进休息 |
+| 手动全平 | 与策略全平同类入口；运行中手动开仓默认关闭 |
 
-- 期权买一深度需覆盖平仓名义；
-- 买一相对标记偏差默认 ≤ **30%**（`close_bid_mark_max_pct`）；
-- 不满足 → `liquidity_wait`，继续等待。
+### 4.6 流动性闸门何时生效
 
-**4.1.B 归档当下 / 到期 / 紧急全平**：归档与到期不强制吃买一（到期/强制按内在价值；紧急可绕过）。**残留中途回收**仍走买一深度 + 偏差闸门（同 4.1.A）。
+| 场景 | 是否强制买一闸门 |
+|------|------------------|
+| 4.2.A 双腿全平 | **是** |
+| 残留中途回收 | **是**（再加权利金比例） |
+| 4.2.B 归档当下 | 否（只平永续） |
+| 到期 / 紧急 | 可绕过深度/偏差；紧急可市价扫期权 |
 
-**紧急全平**：活跃组尽量双腿平掉；残留期权一并按内在价值结算；成功后进入组间休息（与手动全平相同）。
-
-### 4.4 其它平仓入口 / 原因码
+### 4.7 原因码
 
 | 原因码 | 含义 |
 |--------|------|
-| `fixed_usdt` / `premium_multiple` | 目标平仓 · 双腿全平（4.1.A） |
-| `target_perp_only` | 目标平仓 · 只平永续，期权归档到期（4.1.B） |
-| `residual_premium_close` | 残留期权 · 权利金回升达标后中途平 |
-| `expiry` | 到期结算（活跃组或残留期权） |
-| `emergency` | 界面紧急全平 |
-| `manual` | 手动平仓 |
+| `fixed_usdt` / `premium_multiple` | 目标 · 双腿全平（A） |
+| `target_perp_only` | 目标 · 只平永续（B） |
+| `residual_premium_close` | 残留 · 权利金回收中途平 |
+| `expiry` | 到期结算 |
+| `emergency` / `emergency_perp` | 紧急全平 / 紧急只平永续 |
+| `liquidity_retry` | 等待流动性后继续全平 |
+| `perp_pending_retry` | 期权已平，续平永续 |
+| `manual` | 手动全平 |
+| `half_open_repair` | 半仓修复（卖掉孤儿期权） |
 
-### 4.5 流程总览
+### 4.8 流程总览
 
 ```
 有活跃持仓
   ├─ 净利达标？
-  │    ├─ 是 · 期权远虚（内在价值≈0）→ 平永续，期权归档到期，可开下一组
-  │    └─ 是 · 非远虚 → 试双腿全平（流动性闸门）→ 失败则等待
-  └─ 否 → 持有直到到期 → 内在价值结算（+ 若有永续则平永续）
+  │    ├─ 远虚 → B：平永续 + 期权归档残留
+  │    └─ 非远虚 → A：流动性闸门 → 先期权后永续；失败则 liquidity_wait
+  └─ 未达标 → 持有到到期 → 交易所平 / 内在价值
 
-残留期权（已归档）
-  ├─ 周期性：买一权利金 / 初始 ≥ 设置% 且流动性过 → 最新买一 IOC 卖出结清
-  └─ 否则到期内在价值结算；不挡下一组开仓
+残留 pending
+  ├─ 每 5 分钟：权利金≥设置% + 闸门 → 买一 IOC 卖（可部分成交）
+  └─ 否则到期或紧急：优先交易所卖，否则内在价值
 ```
 
-### 4.6 行情监控与页面展示
+### 4.9 行情监控与页面展示
 
-计划页下方期权盘口 **不是永远跟现价 ATM**，也 **不是永远跟开仓那张**，按仓位状态切换：
+| 状态 | 持仓区 | 残留列表 | 下方期权盘口 |
+|------|--------|----------|--------------|
+| 有活跃组 | 当前组 | 历史残留 | **钉持仓行权价**（禁止借 ATM） |
+| 空仓 | 空 | 无/历史 | 跟新 ATM（\|ATM−标的\|≥**5** 点切换） |
+| 仅残留 | 空（flat） | 显示归档合约 | 跟新 ATM，不钉残留那张 |
 
-| 状态 | 持仓区 | 「残留期权(待到期)」 | 下方期权盘口 |
-|------|--------|---------------------|--------------|
-| **有活跃组**（永续+期权都在） | 显示当前组 | 无（或仅历史残留） | **钉在持仓行权价**（标题「持仓期权 @ K」）；浮盈亏/平仓价 **只用持仓合约盘口**，禁止借用新 ATM |
-| **空仓**（无活跃组） | 空 | 无 | **跟现价 ATM**：\|ATM − 标的\| ≥ **5** 点时自动切到新行权价，供下一组选约 |
-| **仅残留**（4.1.B：永续已平，期权归档等到期） | 空（活跃已 flat） | **显示归档合约**（到期/行权价） | **显示新 ATM**（为下一组开仓）；**不**继续钉归档那张 |
-
-要点：
-
-1. **活跃持仓期间**：现价怎么走，下方监控都盯开仓那张；重启服务也不会漂到新 ATM。
-2. **平掉活跃组或走 4.1.B 后**：下方立刻回到「下一单 ATM」；归档腿只出现在残留列表，到期按内在价值结算。
-3. **浮盈亏口径**：持仓合约买一；不得用其他行权价的买一顶替（避免 1880 持仓显示成 1890 盘口）。
-
-```
-有活跃仓 → 下方 = 持仓期权 @ 开仓行权价
-无活跃仓 → 下方 = 期权 ATM @ 当前现价档（可随价漂移 ≥5 点切换）
-残留腿   → 只在「残留期权」行；到期结算；不占用下方 ATM
-```
+浮盈亏只用**持仓合约买一**。
 
 ---
 
-## 5. 策略侧重点
+## 5. 实盘常见问题与处理
+
+> 下列状态机为 LIVE 防卡设计；SIM 多数路径不会落到交易所对账，但本地状态名相同。
+
+### 5.1 本地仓位状态
+
+| status | 含义 | 能否新开 | 自动处理 |
+|--------|------|----------|----------|
+| `flat` | 空仓 | 能 | 选约开仓 |
+| `opening` | 已占槽、开仓未完成 | 否 | `recover_opening`：对账后落 open/half_open/清槽 |
+| `open` | 双腿齐全 | 否 | 盯目标 / 到期 |
+| `half_open` | 仅期权成交、永续未开成且回滚失败 | 否 | `repair_half_open`：卖掉孤儿期权 |
+| `option_closed_perp_pending` | 期权已平、永续待平 | 否 | 只续平永续，不重卖期权 |
+
+### 5.2 开仓阶段问题
+
+| 现象 | 原因 | 系统处理 | 人工注意 |
+|------|------|----------|----------|
+| 期权成交、永续拒单 | 保证金不足、限流、持仓模式不对 | 立刻卖期权回滚；失败→`half_open` 自动修 | OKX 备足 USDT+USDC；确认双向持仓/保证金模式 |
+| 进程崩溃在 `opening` | 断电/重启 | 启动后对账恢复或清槽 | 看企微「opening 恢复」；核对交易所是否真有仓 |
+| 开仓前对账失败 | 交易所仍有旧仓 | **拒绝开仓** | 先平掉账户里多余仓或紧急全平 |
+| 限流 429 | 下单过密 | 退避重试（秒～数十秒） | 独立 IP；勿多实例打同一 Key |
+| 币安/OKX 张数换算错感 | ctVal/合约乘数 | 软件内部换算 | 勿在交易所手改张数打乱对账 |
+
+### 5.3 平仓阶段问题
+
+| 现象 | 原因 | 系统处理 | 人工注意 |
+|------|------|----------|----------|
+| `liquidity_wait` 长时间 | 买一薄或偏离标记 | 持续等待；远虚可走 B | 勿强行市价扫垃圾盘；可调大偏差%或等流动性 |
+| 期权已平永续失败 | 保证金/限流 | `option_closed_perp_pending` 续平 | 保证永续账户有余量；勿手工再卖期权 |
+| 远虚买一为 0 | 深度枯竭 | 走 B 归档残留 | 正常策略路径，不是故障 |
+| 残留 IOC 部分成交 | 买一深度不够吃完 | 部分入账，剩余继续巡检 | 看残留数量是否递减 |
+| 残留「交易所已空、本地仍 pending」 | 上次成交未入账/对账 | 对账后本地结清 | 若反复出现查日志查单 |
+| 到期无法下单 | 已停止交易 | 内在价值记账 | 与交易所交割核对一口价 |
+| 紧急全平仍有残留 | 期权卖不出 | 内在价值强制结 + 尽量交易所卖 | 登录交易所确认期权仓是否清零 |
+
+### 5.4 残留回收专项
+
+| 规则 | 说明 |
+|------|------|
+| 为何用 IOC 买一而非市价 | 避免扫穿更差价位；吃不到则取消，下轮再试 |
+| 门槛跌破 | 二次刷买一后若 \< 设置%，**本轮不卖** |
+| 部分成交后门槛 | 按剩余数量比例缩减 `initial_premium` 基准，避免永远达不到 20% |
+| 与新开仓 | 残留不挡新开；但**同到期**在残留结清前不会再开 |
+
+### 5.5 运维检查清单（实盘）
+
+1. 设置页：交易所、LIVE、密钥、保证金模式与账户一致。  
+2. 小 k（如 0.1）跑通：开仓 → A 或 B → 残留回收或到期 各至少一次。  
+3. 关注状态：`opening` / `half_open` / `option_closed_perp_pending` / `liquidity_wait`。  
+4. 企微：开平仓与故障推送；残留完全结清才推「权利金回收」类通知。  
+5. 中控/策略机版本尽量一致，避免 Fleet 字段漂移。
+
+---
+
+## 6. 策略侧重点
 
 | 侧重点 | 说明 |
 |--------|------|
@@ -275,7 +358,7 @@ k = floor(budget / (2A + I×fee_rate×3) × 10) / 10
 | **费用后净利** | 出场看扣完预估平仓费后的净盈利，避免「账面赚、平完亏」 |
 | **单组纪律** | 活跃持仓最多 1 组；远虚归档的残留期权不挡下一组（逐仓） |
 | **权利金是成本预算** | 小波动拖到期亏权利金，属于策略设计内损耗，不是异常 bug |
-| **目标平仓两分支** | 能平期权则双腿全平；远虚则只平永续、期权到期归档 |
+| **目标平仓两分支** | 能平期权则双腿全平；远虚则只平永续、期权归档并可权利金回收 |
 | **监控分工** | 有仓钉持仓行权价；空仓/仅残留时下方跟新 ATM；残留腿单独列表 |
 
 适合对外表述：
@@ -284,40 +367,40 @@ k = floor(budget / (2A + I×fee_rate×3) × 10) / 10
 
 ---
 
-## 6. 风险点评估
+## 7. 风险点评估
 
-### 6.1 主要风险
+### 7.1 主要风险
 
 | 风险 | 等级 | 说明 | 缓解（已有/建议） |
 |------|------|------|------------------|
 | **横盘 / 低波动** | 高 | Theta 消耗权利金；永续几乎不贡献利润 | 周末跳过；到期认亏全平；接受磨损日 |
-| **方向选错** | 中高 | 卖一比价并非预测圣杯；错向时期权可能失利，永续端也可能承压 | 净盈利达标才兑现；到期强平止损时间 |
-| **开平滑点与手续费** | 中 | 双边 taker + 滑点侵蚀小目标利润 | 目标默认 15U 需覆盖费用；勿把目标设过低 |
-| **期权流动性** | 中 | 远虚时买一枯死 | 4.1.B 只平永续+归档；到期内在价值结算 |
-| **杠杆与保证金** | 中 | 永续 3×，标的急跌/急涨挤压保证金 | 控制名义、保留资金缓冲；实盘注意强平线 |
-| **同到期 ATM 拥挤** | 低–中 | 临近到期价差与盘口恶化 | `min_option_hours`；到期强平 |
-| **SIM≠实盘** | 高（若直接外推） | 本地撮合、深度与成交假设简化 | 小资金实盘验证后再放大 |
-| **交易所限流 / 断连** | 中 | 行情中断导致延误开平 | 健康检查；部署侧监控 |
+| **方向选错** | 中高 | 卖一比价并非预测圣杯 | 净利达标才兑现；到期强平止损时间 |
+| **开平滑点与手续费** | 中 | 双边 taker 侵蚀小目标 | 目标覆盖费用；勿设过低 |
+| **期权流动性** | 中 | 远虚买一枯死 | B 归档 + 权利金回收 IOC + 到期结算 |
+| **半仓 / pending 卡死** | 中 | 开平中途失败 | §5 状态机自动修复；企微告警 |
+| **杠杆与保证金** | 中 | 永续挤压 | 控制名义；LIVE 留缓冲 |
+| **SIM≠实盘** | 高（外推时） | 撮合简化 | 小 k 实盘验证 |
+| **限流 / 断连** | 中 | 延误开平 | 退避；健康检查 |
 
-### 6.2 明确不做什么（边界）
+### 7.2 明确不做什么（边界）
 
-- 不做卖方期权（不收权利金那套）。
+- 不做卖方期权。
 - 不做横盘「智能识别」开仓过滤。
 - 不做多组并行。
-- 当前主路径为 **SIM**；实盘需另行授权与二次确认（见商业化方案）。
+- LIVE 须授权与二次确认（见商业化方案）。
 
-### 6.3 损益直觉
+### 7.3 损益直觉
 
-- **有利波动**：期权端弹性（2 ETH 名义）常快于永续（1 ETH）的对冲损耗 → 易达净利目标。  
-- **不利 / 无波动**：权利金贬值 + 费用 → 拖到到期全平，单组亏损量级约在 **权利金量级 + 双边费用**（再叠加永续期间浮亏/浮盈）。
+- **有利波动**：期权端弹性常快于永续对冲损耗 → 易达净利目标。  
+- **不利 / 无波动**：权利金贬值 + 费用 → 拖到到期，单组亏损约在权利金量级 + 双边费用。
 
 ---
 
-## 7. 最小资金推荐
+## 8. 最小资金推荐
 
 以下按 **默认仓位**（永续 1 ETH、期权 2 ETH 名义、杠杆 3×）估算，标的价按 **ETH ≈ 1,800–2,200 USDT** 量级。
 
-### 7.1 单组占用粗算
+### 8.1 单组占用粗算
 
 | 项目 | 约略金额（USDT） |
 |------|------------------|
@@ -326,62 +409,60 @@ k = floor(budget / (2A + I×fee_rate×3) × 10) / 10
 | 开平手续费 / 滑点缓冲 | **20–50** |
 | 逆向波动缓冲（避免过紧） | **300–800**（经验缓冲，非精确 VaR） |
 
-### 7.2 建议档位
+### 8.2 建议档位
 
 | 档位 | 建议权益（USDT） | 适用 |
 |------|------------------|------|
-| **绝对下限（不推荐）** | ≥ **1,500** | 仅能勉强覆盖保证金 + 小权利金，缓冲极薄，易心态与风控双紧 |
-| **最小可用** | ≥ **3,000** | 默认参数下可跑 SIM / 极小实盘验证，仍偏紧 |
-| **推荐起步** | ≥ **5,000** | 留出磨损日与波动缓冲，更符合「概率样本」玩法 |
-| **较舒适** | ≥ **10,000** | 参数微调、连续多日磨损时更从容 |
+| **绝对下限（不推荐）** | ≥ **1,500** | 缓冲极薄 |
+| **最小可用** | ≥ **3,000** | SIM / 极小实盘验证 |
+| **推荐起步** | ≥ **5,000** | 留出磨损日缓冲 |
+| **较舒适** | ≥ **10,000** | 连续磨损更从容 |
 
-> 缩放规则：若把永续改为 `0.5 ETH`、期权 `1 ETH`，资金需求大约可按比例减半，但费用占比会上升，小目标更难赚。
+> 缩放：永续 `0.5`、期权 `1` 约减半资金需求，但费用占比上升。
 
-### 7.3 与出场目标的关系
+### 8.3 与出场目标的关系
 
-- 默认净利目标 **15 USDT**：在费用后属于「小而频」目标，依赖波动日多次兑现。  
-- 单日/单组最坏常见情形更接近 **亏掉当期权利金 + 费用**（外加永续路径损益），资金规划应按 **多次磨损日** 而非「每组必赚 15」来留余量。
+- 默认净利 **15 USDT**：小而频，依赖波动日。  
+- 资金按**多次磨损日**留余量，而非「每组必赚 15」。
 
-### 7.4 SIM 默认
+### 8.4 SIM 默认
 
-系统默认虚拟权益 `initial_equity = 10,000` USDT（策略设置可改；保存且数值变更时在无持仓下重置账本），**不代表**实盘建议入金。
-
-实盘试跑建议仓位：**永续 0.1 ETH / 期权 0.2 ETH 名义**（k=0.1），并同比下调净利目标。分所口径见 [OKX实盘策略说明](./OKX实盘策略说明.md)、[币安实盘策略说明](./币安实盘策略说明.md)。
+`initial_equity = 10,000` USDT（可改）**不代表**实盘建议入金。试跑建议 **k=0.1**。分所见 [OKX](./OKX实盘策略说明.md)、[币安](./币安实盘策略说明.md)。
 
 ---
 
-## 8. 关键可配参数速查
+## 9. 关键可配参数速查
 
 | 参数 | 默认 | 类别 |
 |------|------|------|
 | `perp_qty_eth` | 1 | 仓位 |
 | `option_qty_eth` | 2 | 仓位 |
 | `leverage` | 3 | 永续 |
-| `perp_margin_mode` | cross | 永续全仓/逐仓（期权不受影响） |
-| `fee_rate` | 0.0005 | 成本 |
+| `perp_margin_mode` | cross | 永续全仓/逐仓 |
+| `fee_rate` | 0.0005 | 成本（SIM） |
 | `exit_mode` | fixed_usdt | 出场 |
 | `net_profit_target` | 15 | 出场 |
 | `premium_exit_multiple` | 1.0 | 出场 |
 | `rest_seconds` | 300 | 节奏 |
 | `skip_weekends` | true | 时间 |
+| `one_expiry_per_day` | true | 选约 |
 | `min_option_hours` | 12 | 选约 |
 | `min_option_leverage` | 100 | 选约 |
-| `fixed_direction_enabled` | false | 固定方向开关 |
+| `fixed_direction_enabled` | false | 固定方向 |
 | `fixed_perp_side` | long | 固定永续方向 |
-| `atm_open_offset_enabled` | false | 开仓 ATM 偏差开关 |
-| `max_atm_open_offset` | 3 | 开仓 ATM 偏差上限 |
-| `close_bid_mark_max_pct` | 30 | 平仓流动性 |
+| `atm_open_offset_enabled` | false | ATM 偏差开关 |
+| `max_atm_open_offset` | 3 | ATM 偏差上限 |
+| `close_bid_mark_max_pct` | 30 | 平仓/残留流动性 |
+| `residual_min_premium_pct` | 20 | 残留权利金回收门槛% |
+| `residual_close_check_sec` | 300 | 残留巡检间隔秒 |
 
 ---
 
-## 9. 修订记录
+## 10. 修订记录
 
 | 日期 | 说明 |
 |------|------|
-| 2026-07-24 | 选约增加固定方向开关：永续多→Put / 空→Call，期权仅实值或平值；关则沿用 ATM/比价 |
-| 2026-07-25 | 初稿：对齐当前开平仓、周末跳过、到期全平、净盈利口径与资金建议 |
-| 2026-07-25 | 平仓顺序改为先期权后永续（与开仓同理：薄腿优先） |
-| 2026-07-26 | 到期按内在价值结算（对齐实盘）；紧急平仓仍用 max(买一,标记,内在价值) |
-| 2026-07-26 | 明确两套目标平仓：双腿全平 / 远虚只平永续+期权归档到期；到期为未达标路径 |
-| 2026-07-26 | 补充 §4.6：有仓钉持仓监控、空仓/仅残留跟新 ATM、残留列表与到期内在价值结算展示分工 |
-| 2026-07-26 | 设置页 SIM/LIVE 切换；API 密钥落 `.env`；OKX LIVE 开平仓；币安密钥可存 |
+| 2026-08-02 | §3/§4 展开开平仓逐步逻辑；新增 §5 实盘状态机与异常处理；残留买一 IOC 回收 |
+| 2026-07-24 | 固定方向：永续多→Put / 空→Call，仅实值或平值 |
+| 2026-07-25 | 初稿；平仓顺序先期权后永续 |
+| 2026-07-26 | 到期内在价值；目标平仓 A/B；有仓钉持仓监控；SIM/LIVE 切换 |