Add OKX options review module with hedge plan entries.

Import closed OKX option history and closed hedge plans into one list for journaling, images, and stats without mixing contract reviews.

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

docs/期权用法.md

@@ -98,7 +98,34 @@ OKX_OPTIONS_API_PASSPHRASE=...
 | `OKX_OPTIONS_ITM_MAX_DIST_USD` | 30 | 轻度实值:价内不超过多少 USD |
 | `OKX_OPTIONS_PROFIT_ALERT_RATIO` | 1.0 | 浮盈/权利金 ≥ 此值推送 |
 
-## 8. 常见问题
+## 8. 期权复盘(含对冲)
+
+仅 **OKX** 实例提供独立页 **期权复盘**(`/options/review`),与合约「交易记录与复盘」完全隔离.
+
+### 数据来源
+
+| 类型 | source_type | 来源 | 粒度 |
+|------|-------------|------|------|
+| 纯期权 | `option_spot` | OKX `positions-history` 已全平仓位 | 一仓一条 |
+| 永期对冲 | `perp_options` | 本地 `hedge_plans` 且 `status=closed` | **一计划一条** |
+| 期期对冲 | `options_options` | 同上 | **一计划一条** |
+
+- 同步按钮:`POST /api/options/review/sync`(只读导入,不下单/不平仓).
+- 对冲盈亏主口径:`realized_pnl_total`;详情另显永续/期权分项.
+- 若某纯期权 `inst_id` 已出现在对冲腿中,默认标记排除,避免总盈亏双计(可勾选「含已归属对冲的期权腿」查看).
+- 人工复盘字段(策略/备注/图片)存在 `options_review_entries`,再次同步**不会覆盖**.
+
+### 图片
+
+- 目录:`static/images/options_journal/`
+- 文件名:`options_journal_{draftId}_{chart|entry|exit|other}.ext`
+- 备份时与 `crypto.db` 一并打包即可;勿与合约 `journal_*` 截图混用.
+
+### 统计
+
+同页 KPI + 分组:类型、标的、策略标签、对冲结束原因、持有周期、Call/Put.策略维度仅统计已填策略标签的记录.
+
+## 9. 常见问题
 
 **Q:为什么买不了?**  
 - 交易账户 USDC 不足 → 先兑换再划转  
@@ -111,7 +138,7 @@ OKX_OPTIONS_API_PASSPHRASE=...
 **Q:子账户能开期权吗?**  
 - 本系统期权走主账户 API;子账户永续不受影响.
 
-## 9. 风险说明
+## 10. 风险说明
 
 - 买方最大亏损为 **权利金**;近期实值仍会时间衰减  
 - 限价单可能因无流动性未成交