实现OKX单笔期权币本位与USDT桥复利(中控只读,不改Gate)

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

docs/OKX单笔期权-币本位与USDT桥-开发方案.md

@@ -1,9 +1,9 @@
 # OKX 单笔期权 · 币本位模式（USDT 桥 + 复利）— 开发方案
 
-> 状态:**方案待实现**(按本文落地;改需求先改本文).  
+> 状态:**已实现首版**(按本文落地;改需求先改本文).  
 > 范围:**`crypto_monitor_okx` 单笔期权开平** + **中控对 OKX 期权只读字段**(能识别币本位);对冲计划(永期/期期)**不接币本位**.  
 > **硬约束:本次不改 Gate**(不改 `crypto_monitor_gate/`、不改 Gate 专用模板/静态/测试;共享 `lib` 若动刀不得改变 Gate 启动与交易行为).  
-> 相关:[期权方案.md](./期权方案.md) · [期权用法.md](./期权用法.md) · [期权开平仓与监控说明.md](./期权开平仓与监控说明.md) · [position-sizing-mode.md](./position-sizing-mode.md)
+> 相关:[期权方案.md](./期权方案.md) · [期权用法.md](./期权用法.md) · [期权开平仓与监控说明.md](./期权开平仓与监控说明.md) · [position-sizing-mode.md](./position-sizing-mode.md) · [更新文档.md](./更新文档.md)
 
 ---
 

docs/更新文档.md

@@ -4,6 +4,36 @@
 
 ---
 
+## 2026-08-20 · OKX 单笔期权币本位 + USDT 桥 + 复利
+
+### 修改原因
+
+币本位期权流动性往往好于 USDC;操作者仍用 USDT 思考本金。需 env 切换本位、自动 USDT↔币桥、交易户 USDT×0.95 复利;对冲仍仅 USDC;中控只读识别本位;不改 Gate。
+
+### 修改的地方
+
+| 文件 | 改动摘要 |
+|------|----------|
+| `lib/options/options_margin_mode_lib.py` | 本位/合约族/USDT 预算/按币算张数 |
+| `lib/options/options_spot_bridge_lib.py` | 买币/卖回/桥状态表/回滚 |
+| `lib/options/options_coin_open_lib.py` | 买满→开满编排;平后卖回 |
+| `options_register` / `okx_options_lib` / close_exec | 链族切换、开平接入、retry-sell |
+| `options_hub_lib` + 中控 `app.js` / AI context | 只读字段识别币本位 |
+| `hedge_plan_register` | 币本位禁止开对冲 |
+| `env_*` / `.env.example` | 新 env;MARGIN_MODE 需重启;有仓拒切 |
+| `docs/OKX单笔期权-币本位与USDT桥-开发方案.md` | 方案(已有) |
+
+### 交付之后的验收
+
+1. `OKX_OPTIONS_MARGIN_MODE=usdc` 行为与现网一致.  
+2. `=coin` 时链为 `ETH-USD`(非 `_UM`);开仓走买币再开期权;失败回滚卖币.  
+3. 平仓清空后卖回本桥币量;失败可 `POST /api/options/spot-bridge/retry-sell`.  
+4. 预算默认交易户 USDT×0.95;上限开关默认关.  
+5. 中控期权卡显示本位标签;无下单.  
+6. Gate 无改动.
+
+---
+
 ## 2026-07-19 · 期权复盘详情改为对话框 + 截图显示修复
 
 ### 修改原因