Use bid1-only option closes with hard-disabled market exits.

Manual close checks liquidity only; target auto still requires 2x recycle hold once, then reuses the shared bid1 executor. Add /options/guide doc and update hedge-plan refs.

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

docs/env配置说明.md

@@ -176,7 +176,7 @@ AI 相关环境变量(`AI_PROVIDER`,`OPENAI_*`,`OLLAMA_*`,`AI_MODEL`,`AI_TIMEOUT
 | 默认标的 | 如 ETH |
 | 最大到期天数 | 等常用策略参数 |
 
-高级参数与完整说明见 [期权方案.md](./期权方案.md),[期权用法.md](./期权用法.md).
+高级参数与完整说明见 [期权方案.md](./期权方案.md),[期权用法.md](./期权用法.md),[期权开平仓与监控说明.md](./期权开平仓与监控说明.md)(线上 `/options/guide`).
 
 ---
 

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

@@ -152,6 +152,20 @@
 
 盈利方判定规则仍按前文(触达 S\* 时按浮盈较大一侧平仓;皆亏则等到期).
 
+### 5.2.1 期权腿实盘平仓执行(与期权页共用)
+
+对冲计划凡**必须物理平掉期权腿**时(如永期止损联动、期期平盈利腿),执行口径与独立期权模块一致:
+
+| 规则 | 说明 |
+|------|------|
+| 禁市价 | 代码硬关闭,无市价兜底 |
+| 只锁买一 | 本轮 `min(仓位, 买一深度)` × 买一限价;`reduceOnly` |
+| 分批 | 买一不够则剩余下一轮再平再锁新买一 |
+| 有效流动性 | 残档买一禁止按买盘平 |
+| 2× 门控 | 目标位/自动类路径首次需可回收≥2×权利金并持续 hold;手动买一平只验流动性 |
+
+完整说明(可单独打开):**[期权开平仓与监控说明.md](./期权开平仓与监控说明.md)** · 线上 `/options/guide`.
+
 ---
 
 ### 5.3 企业微信推送(起止必发)
@@ -630,6 +644,7 @@ API 草图:
 | [期权对冲方案分析.md](./期权对冲方案分析.md) | 策略观念;本模块是其「计划化 + 自动执行」实现 |
 | [对冲计划策略与P0校验.md](./对冲计划策略与P0校验.md) | P0 交付与口径校验 |
 | [期权方案.md](./期权方案.md) / [期权用法.md](./期权用法.md) | 期权 API、仅买方、限价规则必须遵守 |
+| [期权开平仓与监控说明.md](./期权开平仓与监控说明.md) | 买一平仓、门控、监控与风险;线上 `/options/guide` |
 | [position-sizing-mode.md](./position-sizing-mode.md) | 全仓公式与缓冲 0.98 |
 
 本模块上线后,可在《期权对冲方案分析》末尾增加「系统对冲计划」链接指向本文.
@@ -649,6 +664,7 @@ API 草图:
 - [x] 永期张数:**ETH/BTC 10x 全仓 × 0.98**,先算盈亏再选期权
 - [x] 行情自动;永期期权 **列表式**;期期 **T 型**
 - [x] 对冲开关在前端 **env 配置 →「对冲计划」** 维护(仅 OKX);计仓/杠杆/期权 API 复用已有分组
+- [x] 期权腿实盘平仓:**禁市价、只锁买一、分批;流动性/2×门控见开平仓说明**
 
 ---
 

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

@@ -0,0 +1,87 @@
+# OKX 期权 — 开平仓与监控说明
+
+> 独立页查看(登录后):`/options/guide`  
+> 对冲计划侧同步见 [对冲计划开发方案.md](./对冲计划开发方案.md) §期权腿开平仓.
+
+---
+
+## 1. 开仓方式
+
+| 项 | 规则 |
+|----|------|
+| 方向 | **仅买方**(Call / Put 限价买入) |
+| 价格 | **卖一 ask** 限价;无卖一时可用标记估算展示,实下单仍以可挂限价为准 |
+| 张数 | 1 张 = 0.01 ETH/BTC;可按预算打满或指定数量 |
+| 资金 | 交易账户 **USDC**(或 USDG);不自动兑划 |
+| 入口 | OKX 实例 **期权** 页列表 / T 型;对冲计划可带期权腿开仓 |
+
+开仓后写入 `options_trades`(open),并在持仓卡展示权利金、买盘深度、按买一可回收等.
+
+---
+
+## 2. 平仓方式
+
+### 2.1 统一规则(手动 / 目标自动共用执行核)
+
+1. **禁止市价平仓**(代码硬关闭,忽略 `OKX_OPTIONS_ALLOW_MARKET_CLOSE`).
+2. **只锁买一**:本轮张数 = `min(持仓, 买一深度)`,限价 = 校验通过当刻的买一价.
+3. **不吃买二及以下**;买一不够则只平本轮能吃掉的部分,**剩余仓位保留**,下次再平再锁新的买一.
+4. 全程 `reduceOnly` 限价卖.
+
+示例:持仓 300、买一深度 200 → 本轮只平 200;剩 100 等下次「买一平仓」或目标位再次触发.
+
+### 2.2 手动「买一平仓」
+
+- 入口:持仓卡按钮.
+- **只校验有效流动性**(买一非残档、有深度).
+- **不卡**「回收 ≥ 2×权利金」门控(用户主动平仓).
+
+### 2.3 目标位自动平仓
+
+- 设置目标指数后由监控轮询;Call 指数 ≥ 目标 / Put 指数 ≤ 目标触发.
+- 触发后走同一买一执行核.
+- **额外门控**:买一可回收 ≥ **权利金 × 2**,且该状态连续保持默认 **120 秒**(env:`OKX_OPTIONS_CLOSE_RECYCLE_MULT` / `OKX_OPTIONS_CLOSE_HOLD_SECONDS`).
+- 首次通过后,同仓**续批**只再验流动性,不再重跑 2 分钟计时.
+- 无有效买一或门控未就绪 → 本轮不挂单,等下一轮;已有未成交卖平单则等成交,不撤了重挂.
+
+---
+
+## 3. 监控逻辑
+
+| 监控 | 行为 |
+|------|------|
+| 持仓 / 买盘预览 | 轮询刷新;净盈亏按**本轮买一可回收 − 权利金** |
+| 残档买一 | 买一 ≪ 标记/内在价值(默认 < 30%) → 禁止按买盘平,UI 显示无效 |
+| 目标位 | 独立监控表;触发后买一平;推送企业微信(防重复) |
+| 翻倍提醒 | 未实现口径达权利金 × `OKX_OPTIONS_PROFIT_ALERT_RATIO` 时推送一次 |
+| 到期 | 无系统止损;到期交割/保险腿自灭(对冲计划另有退出规则) |
+
+---
+
+## 4. 平仓校验(门控)
+
+| 门控 | 手动买一平 | 目标自动平 | 说明 |
+|------|------------|------------|------|
+| 有效流动性 | ✅ 必验 | ✅ 必验 | 残档买一 / 无买一 → 拒平 |
+| 回收 ≥ 2× 权利金 + 持续 hold | ❌ | ✅ 首次 | 通过后同仓续批只验流动性 |
+| 锁定买一价 | ✅ | ✅ | 下单价 = 通过校验时的买一 |
+| 市价兜底 | ❌ | ❌ | 永不市价 |
+
+---
+
+## 5. 风险点
+
+1. **流动性不足**:只平买一深度,大仓位可能多次才能平完;若买一突然撤单,限价可能挂而不成交.
+2. **残档假买一**:若未拦住残档会严重贱卖 — 系统用标记/内在价值比例拦截,但不等于保证最优成交价.
+3. **权利金沉没**:手动可在未达 2× 时平仓,可能主动止损或提前锁利不及预期.
+4. **无市价强平**:盘口真空时系统**不会**市价砸盘,仓位可能留到到期.
+5. **目标位只看指数**:触达后仍受买一/2×门控约束,可能「到价却平不掉」.
+6. **对冲计划腿**:期权腿退出规则见对冲方案;独立期权页平仓勿与计划状态脱节.
+
+---
+
+## 6. 相关文档
+
+- [期权用法.md](./期权用法.md) — 资金兑划与页面操作
+- [期权方案.md](./期权方案.md) — env 与架构
+- [对冲计划开发方案.md](./对冲计划开发方案.md) — 永期/期期与期权腿

docs/期权方案.md

@@ -92,9 +92,14 @@ OKX_OPTIONS_ITM_MAX_DIST_USD=30
 OKX_OPTIONS_PROFIT_ALERT_RATIO=1.0
 OKX_OPTIONS_POLL_SECONDS=15
 OKX_OPTIONS_TD_MODE=cross
-OKX_OPTIONS_ALLOW_MARKET_CLOSE=false
+# 市价平仓已在代码中硬关闭,此变量无效,可删
+# OKX_OPTIONS_ALLOW_MARKET_CLOSE=false
+OKX_OPTIONS_CLOSE_RECYCLE_MULT=2
+OKX_OPTIONS_CLOSE_HOLD_SECONDS=120
 ```
 
+平仓执行:**只锁买一限价**,说明见 [期权开平仓与监控说明.md](./期权开平仓与监控说明.md);线上 `/options/guide`.
+
 修改 `.env` 后须 `pm2 restart crypto_okx`.
 
 ## 6. 数据库
@@ -112,6 +117,7 @@ OKX_OPTIONS_ALLOW_MARKET_CLOSE=false
 | 方法 | 路径 |
 |------|------|
 | GET | `/options` |
+| GET | `/options/guide` | 开平仓与监控说明(独立页) |
 | GET | `/api/options/balances` |
 | GET | `/api/options/chain` |
 | GET | `/api/options/quote` |

docs/期权用法.md

@@ -58,15 +58,19 @@ OKX_OPTIONS_API_PASSPHRASE=...
 
 ## 4. 持仓与平仓
 
-持仓表字段对齐 OKX:合约,张数,开仓均价,标记价,浮盈,收益率,到期等.
+持仓表字段对齐 OKX:合约,张数,开仓均价,标记价,净盈亏,收益率,到期等.
 
-**平仓(锁利/止损):**
+**买一平仓:**
 
-1. 在持仓行点击 **平仓**
-2. 查看 **买一价** 与预估收回
-3. 确认 **限价卖出**(价格 = 买一)
+1. 在持仓卡点击 **买一平仓**
+2. 系统重读盘口并校验有效买一(非残档)
+3. 本轮只按买一深度限价卖出;买一不够则剩余下次再平
+4. **市价平仓已禁用**(代码硬关闭)
 
-> 默认不使用市价平仓.若 `.env` 开启 `OKX_OPTIONS_ALLOW_MARKET_CLOSE=true`,市价按钮会出现并带风险提示.
+目标位自动平另需「可回收 ≥ 2×权利金并持续约 2 分钟」;细则见独立说明:
+
+- 仓库文档:[期权开平仓与监控说明.md](./期权开平仓与监控说明.md)
+- 线上(登录后):`/options/guide`
 
 ## 5. 微信提醒