User edition: prune docs, license gate, obfuscate core lib.

Keep deploy/basic docs only; integrate sq.bz121.com license client; encrypt strategy/trade/key_monitor/options/hedge_plan for release.

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

crypto_monitor_okx/.env.example

@@ -274,3 +274,8 @@ AI_MODEL=huihui_ai/deepseek-r1-abliterated:latest
 
 APP_TIMEZONE=Asia/Shanghai
 # TRADING_DAY_RESET_HOUR 现在表示「北京时间」整点,默认 8 点起算新交易日;开仓整点限制见 TRADING_DAY_RESET_OPEN_GUARD_ENABLED
+
+# --- 软件授权（整机共用，也可写仓库根 license.env）---
+# LICENSE_API_URL=https://sq.bz121.com
+# LICENSE_CLIENT_KEY=与授权站 CLIENT_API_KEY 相同
+# LICENSE_OFFLINE_GRACE_HOURS=72

crypto_monitor_okx/README.md

@@ -1,53 +1,11 @@
-# crypto_monitor_okx
+# crypto_monitor_okx（用户版）
 
-基于 **Flask** 的加密货币 **下单监控 / 关键位监控 / 交易复盘** 小系统,行情与实盘接口统一走 **OKX(USDT 永续)**,通过 **ccxt** 访问.功能与界面已与 **`crypto_monitor_binance`** 对齐(顶栏分栏,风控参数,交易所 TP/SL 管理等),差异主要在 **`.env` 的 `OKX_*` 变量** 与 OKX API(含 Passphrase).
+OKX 永续实例。
 
-## 功能概要
-
-- **关键位监控**:`/key_monitor`,5m 门控,企业微信,部分类型自动开仓(见 `关键位自动下单说明.md`)
-- **实盘下单**:`/trade`,以损定仓,移动保本,页面内撤挂止盈止损
-- **策略交易**:`/strategy`(趋势回调 + 顺势加仓),见 [策略交易说明.md](../策略交易说明.md)
-- **AI 复盘**:见 [AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)
-- **实盘(可选)**:`LIVE_TRADING_ENABLED=true` 且配置 `OKX_API_KEY` / `OKX_API_SECRET` / `OKX_API_PASSPHRASE`
-- **止盈止损(OKX)**:市价成交后通过 ccxt 挂 **止损 / 止盈** 条件单(`attachAlgoOrds` 或 reduceOnly 市价单路径,见 `app.py`)
-
-## 环境要求
-
-- Python 3.10+
-- 依赖见仓库根 `requirements.txt`;经 **SSH SOCKS** 访问 OKX 时需 **`PySocks`**,并配置 `OKX_SOCKS_PROXY=socks5h://127.0.0.1:1080`
-
-## 配置说明
-
-| 变量 | 说明 |
-|------|------|
-| `OKX_API_KEY` / `OKX_API_SECRET` / `OKX_API_PASSPHRASE` | OKX API |
-| `OKX_TD_MODE` / `OKX_POS_MODE` | 全仓/逐仓,单向/双向 |
-| `OKX_SOCKS_PROXY` | 本机 SSH 动态转发时常用 |
-| `MAX_ACTIVE_POSITIONS` / `MANUAL_MIN_PLANNED_RR` | 与币安版一致的风控 |
-| `EXCHANGE_DISPLAY_NAME` | 页面展示名,默认 `OKX` |
-
-完整模板见 **`.env.example`**.
-
-## 运行
+- **部署**：[部署文档.md](./部署文档.md) · 仓库根 [docs/ubuntu-server.md](../docs/ubuntu-server.md)
+- **授权**：启动后打开 `/license`，见 [docs/license.md](../docs/license.md)
+- **配置**：复制 `.env.example` → `.env`
 
 ```bash
 cd /opt/crypto_monitor_user/crypto_monitor_okx
-source .venv/bin/activate
-python app.py
 ```
-
-生产使用 **PM2**;见 [docs/ubuntu-server.md](../docs/ubuntu-server.md).默认 **`APP_PORT`** 常为 `5004`.
-
-## 部署
-
-详见 **[部署文档.md](./部署文档.md)**,**[使用说明.md](./使用说明.md)**.
-
-## 自检
-
-```bash
-python scripts/verify_okx_funding.py
-```
-
-## 风险与合规
-
-实盘风险自负;请确认 API 权限,IP 白名单与 OKX 账户设置一致.

crypto_monitor_okx/app.py

@@ -301,6 +301,12 @@ app.secret_key = os.getenv("FLASK_SECRET_KEY", "crypto_monitor_2026_secret_key")
 from lib.instance.instance_embed_lib import attach_embed_templates, redirect_to_embed_shell_if_enabled
 
 attach_embed_templates(app, _REPO_ROOT)
+try:
+    from lib.license.flask_gate import install_license_gate
+
+    install_license_gate(app)
+except Exception as _lic_err:
+    print(f"[license] okx: {_lic_err}")
 
 # ====================== 登录配置 ======================
 USERNAME = os.getenv("APP_USERNAME", "dekun")

crypto_monitor_okx/使用说明.md

@@ -1,138 +0,0 @@
-# 使用说明
-
-**本文件对应仓库:`crypto_monitor_okx`(OKX USDT 本位永续).**  
-功能,界面与 **Gate.io USDT 永续版**(目录 `crypto_monitor_gate`)基本一致,差异主要在 **`.env` 里交易所密钥与部分参数名**(`OKX_*` / `GATE_*`),文末有对照.
-
-**部署,代理,PM2 等**请参考本仓库说明或 **`crypto_monitor_gate`** 下的 **`部署文档.md`**(该文以 Gate + SSH SOCKS 为例;OKX 侧将 API 与密钥改为 `OKX_*` 即可类比).  
-**关键位自动开仓的规则,RR,结案原因**见本目录 **`关键位自动下单说明.md`**.
-
----
-
-## 1. 它能做什么
-
-面向个人盘面的 **Web 控制台**,主要能力包括:
-
-| 模块 | 说明 |
-|------|------|
-| **关键位监控** | 录入上/下沿与类型,按 **5m 收线** 做硬条件过滤;符合条件后 **企业微信** 提醒,部分类型可 **自动市价开仓**(见第 4 节与专门文档). |
-| **实盘下单监控** | 手工填止损/止盈,**以损定仓** 市价开单,挂上条件止盈止损,并在页面跟踪浮盈亏,保本逻辑等. |
-| **交易记录 / 复盘** | 平仓结果,盈亏,错过的单等归档与导出;可选 **AI 复盘**(见仓库根 [AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)). |
-| **策略交易** | 顶栏 `/strategy`:**趋势回调**(左)与 **顺势加仓**(右)左右并列;细则见 [策略交易说明.md](../策略交易说明.md). |
-
-后台按 **`MONITOR_POLL_SECONDS`**(默认几秒)轮询行情与监控逻辑.**切勿**在未理解规则时同时运行两套程序共用一个实盘账户.
-
----
-
-## 2. 运行前必须配置(`.env`)
-
-首次在本目录执行 **`cp .env.example .env`**,再编辑 `.env`(`.env` 勿提交 Git;`git pull` 不会改你的 `.env`,升级前建议 `cp .env .env.backup.$(date +%Y%m%d)`).
-
-至少检查以下项(具体键名以 **`.env.example`** 为准):
-
-| 类别 | 说明 |
-|------|------|
-| **登录网页** | `APP_PASSWORD`:打开站点后的登录口令.`FLASK_SECRET_KEY`:Session 密钥,请勿使用默认值. |
-| **企业微信** | `WECHAT_WEBHOOK`:告警与关键位推送机器人的 Webhook. |
-| **是否真下单** | `LIVE_TRADING_ENABLED=false`:**不会**向交易所发送开仓指令(适合测试流程).改为 `true` 且密钥正确才会实盘. |
-| **交易所 API** | **本仓库:** `OKX_API_KEY`,`OKX_API_SECRET`;永续相关见 `OKX_TD_MODE`,`OKX_POS_MODE`,`OKX_TRIGGER_WORKING_TYPE` 等.**勿**把 `.env` 提交到 Git. |
-| **关键位 RR / 止损外扩** | `KEY_AUTO_MIN_PLANNED_RR`,`KEY_STOP_OUTSIDE_BREAKOUT_PCT`(详见 `关键位自动下单说明.md`). |
-| **AI 复盘** | 默认 `AI_PROVIDER=openai`,`OPENAI_API_BASE=https://op.bz121.com/v1`,`OPENAI_API_KEY`,`OPENAI_MODEL=gemma4:e4b`;或 `AI_PROVIDER=ollama` + `OLLAMA_API` / `AI_MODEL`.详见 [AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md). |
-
-网络需要代理时可配置 **`OKX_SOCKS_PROXY` / `OKX_HTTP_PROXY`**(与 Gate 版 `GATE_*_PROXY` 用法类似).
-
----
-
-## 3. 如何启动与登录
-
-1. 准备 Python 虚拟环境并安装依赖(如 `flask`,`requests`,`ccxt`,按需 `Pillow`,`PySocks` 等),配置好 `.env`.  
-2. 启动 Flask 应用(可用 **`ecosystem.config.cjs`** 交给 PM2,或本地 `python app.py` / `flask run`,以你当前脚本为准).  
-3. 浏览器访问站点,打开 **`/login`**,使用 **`.env` 里的 `APP_PASSWORD`** 登录.
-
-登录后顶栏:**关键位监控** | **实盘下单**(默认首页)| **策略交易**(`/strategy`,趋势回调 + 顺势加仓双栏)| **策略交易记录**(`/strategy/records`)| **交易记录与复盘** | **统计分析**.
-
----
-
-## 4. 关键位监控(顶栏「关键位监控」→ `/key_monitor`)
-
-### 4.1 添加一条关键位
-
-1. **币种**:如 `BTC` 或 `BTC/USDT`(会规范成内部符号).  
-2. **类型**(必选其一):  
-
-   | 类型 | 行为摘要 |
-   |------|----------|
-   | **箱体突破** | 通过门控且计划 RR 达标 → **自动市价开仓**(需 `LIVE_TRADING_ENABLED=true` 且无其他持仓占位).结案后本条从列表消失并记入历史. |
-   | **收敛突破** | 同上(自动开仓类). |
-   | **关键阻力位** | **不自动开仓**;触发后 **发 1 次微信**,然后本条 **结案进历史**. |
-   | **关键支撑位** | 同上(仅提醒). |
-   | **回调触价开仓** | **不挂交易所限价**;标记价回调触达 E 后 **下一轮询市价开仓**(RR 门槛同 `KEY_AUTO_MIN_PLANNED_RR`);有效期 **24h** |
-   | **突破触价开仓** | **不挂交易所限价**;标记价 **穿越 E 立即市价开仓**;先触 SL/TP 侧失效;有效期 **24h** |
-
-3. **方向**:做多 / 做空(触价开仓 / 箱体 / 收敛 / 斐波必选;阻力/支撑不选).  
-4. **价位**:箱体/收敛/阻力/支撑填 **上沿 / 下沿**;触价开仓填 **入场 E / 止损 SL / 止盈 TP**.
-
-**限制:**  
-活跃持仓数达到 **`MAX_ACTIVE_POSITIONS`**(默认 1)时,**不允许**再添加「**箱体突破** / **收敛突破**」;仍可添加「**关键阻力位 / 支撑位**」.  
-若 **4h EMA55** 与你的方向逆势,页面会 **额外 Flash 提示**,**不阻挡**提交.
-
-### 4.2 触发后会发生什么(简版)
-
-- **箱体 / 收敛**:门控通过后算计划 SL/TP 与 RR;不达标 → 微信说明 + **`rr_insufficient`** 结案;达标 → **市价开仓**,成功 **`auto_opened`** / 失败 **`exchange_failed`**,均不重试同一关键位.  
-- **阻力 / 支撑**:仅 **单次推送** → **`key_level_alert_only`** 结案.
-
-详细公式与字段见 **`关键位自动下单说明.md`**.
-
-### 4.3 列表与历史
-
-当前条目与历史记录的用法与 Gate 版相同;结案后可在历史区查阅 **`close_reason`**.
-
----
-
-## 5. 实盘下单(顶栏「实盘下单」→ `/trade`)
-
-- 持仓上限由 **`MAX_ACTIVE_POSITIONS`** 控制(默认 1).  
-- **人工开仓**计划盈亏比不得低于 **`MANUAL_MIN_PLANNED_RR`**(默认 1.4:1).  
-- 填写币种,方向,杠杆(可选),止损/止盈(价格或百分比按表单).  
-- 移动保本等选项按页面与 `.env` 默认.
-
-开仓成功后卡片 **「来源」**:手工一般为 **下单监控**;关键位自动为 **关键位监控**.
-
----
-
-## 6. 企业微信
-
-推送逻辑与 Gate 版一致;未配置 **`WECHAT_WEBHOOK`** 时可能没有消息,请以 **交易所端** 核对持仓与挂单.
-
----
-
-## 7. 强烈建议的风险与运维习惯
-
-1. **先用 `LIVE_TRADING_ENABLED=false`** 熟悉流程再实盘.  
-2. **API 权限**最小化,密钥勿泄露.  
-3. **同一账户避免多程序重复开仓**.  
-4. **自动备份**:服务器上执行 `bash scripts/install_backup_cron.sh`(每天北京时间 0:00 → `/root/backups`,保留 30 天);升级前也可 `bash scripts/backup_data.sh` 手动跑一次.  
-5. 升级代码后留意 **首轮启动**有无数据库迁移报错.
-
----
-
-## 8. 常见问题(简要)
-
-| 现象 | 可自查 |
-|------|--------|
-| 关键位永远不触发 | 门控五项,日成交量排名,`KLINE_TIMEFRAME`. |
-| 有信号但不自动开仓 | `LIVE_TRADING_ENABLED`,RR 阈值,是否已有持仓,API/保证金错误信息. |
-| 加不了箱体/收敛 | 是否已有持仓. |
-| 推送收不到 | Webhook,网络. |
-
----
-
-## 9. 与币安版(`crypto_monitor_binance`)差异速查
-
-| 项目 | OKX 本仓库 | 币安版 |
-|------|------------|--------|
-| API 变量 | `OKX_API_KEY`,`OKX_API_SECRET`,`OKX_API_PASSPHRASE` | `BINANCE_API_KEY`,`BINANCE_API_SECRET` |
-| 代理 | `OKX_SOCKS_PROXY` | `BINANCE_SOCKS_PROXY` |
-| 默认端口 | 常为 `5004` | 常为 `5001` |
-| TP/SL 实现 | `_okx_place_tp_sl_orders`,页面 `/api/order/.../cancel_tpsl` | `_binance_place_tp_sl_orders` |
-
-业务流程,顶栏分栏,策略交易,风控参数名已与币安版对齐;仅需更换目录与 `.env`.

crypto_monitor_okx/关键位自动下单说明.md

@@ -1,192 +0,0 @@
-# 关键位监控说明(自动开仓 + 人工盯盘)
-
-**适用:Gate / Binance / OKX 三所实例(共用 `lib/key_monitor/key_auto_order_lib.py`)**
-
-## 环境开关 `KEY_AUTO_ORDER_ENABLED`(默认 `false`)
-
-| 计仓模式 | 开关 | 关键位程序自动单 |
-|----------|------|------------------|
-| `risk`(以损定仓) | `false` | **全部关闭**(含触价);支撑/阻力微信提醒仍可用 |
-| `risk` | `true` | 箱体/收敛/斐波/假突破/触价均可自动(旧行为) |
-| `full_margin`(全仓) | `false` | 全部关闭(含触价) |
-| `full_margin` | `true` | **仅触价**自动;箱体/斐波等仍禁止 |
-
-**不受本开关影响:** 人工实盘下单,关键支撑/阻力提醒,**顺势加仓**(`risk` 下),趋势回调(`risk` 下).全仓模式下策略自动仍禁止.
-
-修改 `.env` 后须 **重启 PM2**.复盘「开仓类型」与统计分段会随开关联动隐藏关键位选项.
-
----
-
-**适用:`crypto_monitor_gate`(Gate U 本位永续)**  
-Binance / OKX 见各自目录下同名文档;共享逻辑在 `lib/key_monitor/`.
-
-本文档与 `.env`,`check_key_monitors`,`add_key`,`_key_hard_checks`,`_process_key_rs_level_alert` 一致.
-
----
-
-## 一,监控类型总览
-
-| 录入类型 | 录入时选方向 | 自动市价开仓 | 触发与结案 |
-|----------|--------------|--------------|------------|
-| **箱体突破** | **必选** 多/空 | **是**(门控 + RR) | 条件满足 → 开仓或 `rr_insufficient` / `exchange_failed` → **一次性删除** |
-| **收敛突破** | **必选** 多/空 | **是**(同上) | 同上 |
-| **关键阻力位** | **不选**(`direction=watch`) | **否** | 5m 收盘突破上/下沿 → 微信 **3 次** → `key_level_alert_done` |
-| **关键支撑位** | **不选** | **否** | 同上(与阻力位**相同规则**:填上沿+下沿,程序双向监控) |
-| 斐波回调 0.618 / 0.786 | 必选 | 限价挂单逻辑 | 见斐波说明(**不在下文展开**) |
-| **回调触价开仓** | **必选** 多/空 | **程序盯价 → 回调触 E 后市价** | 见下文 **§四** |
-| **突破触价开仓** | **必选** 多/空 | **程序盯价 → 穿越 E 立即市价** | 见下文 **§四** |
-
-**添加时(箱体/收敛/斐波/触价):** 品种须 **日成交量排名前 `KEY_DAILY_VOLUME_RANK_MAX`(默认 30)**;上沿 **>** 下沿(触价开仓填 E/SL/TP,上下沿仅作展示占位).
-
----
-
-## 二,关键阻力位 / 关键支撑位(人工盯盘)
-
-### 2.1 录入
-
-- 填写 **上沿 `upper`** 与 **下沿 `lower`**(程序同时监控两侧,**无法预先判定**做多还是做空).
-- 页面 **不显示,不要求** 方向;库中 `direction` 初始为 `watch`,**首次突破后** 写入 `long`(向上突破上沿)或 `short`(向下突破下沿).
-
-### 2.2 触发(极简)
-
-- 周期:**`KLINE_TIMEFRAME`(默认 5m)最近一根已闭合 K** 的 **收盘价**(非影线).
-- **向上突破上沿:** `收盘 > upper` → 推断方向 **多 / 向上**,本次监控任务开始按节奏提醒.
-- **向下突破下沿:** `收盘 < lower` → 推断方向 **空 / 向下**,本次任务同样开始提醒.
-- **任一侧突破即结束本条监控周期**(不会在突破后再等待另一侧;上沿,下沿谁先满足用谁,同根 K 仅可能满足一侧).
-
-**不参与:** 量能,二确 K,越过幅度下限,日成交排名(运行时),计划 RR,自动开仓.
-
-### 2.3 微信提醒次数
-
-| 配置 | 默认 | 含义 |
-|------|------|------|
-| `KEY_ALERT_MAX_TIMES` | `3` | 突破后最多推送 3 次 |
-| `KEY_ALERT_INTERVAL_MINUTES` | `5` | 相邻两次推送至少间隔 5 分钟 |
-
-- 第 1 次:首次检测到突破的当次轮询(若已闭合 5m 满足条件).
-- 第 2,3 次:仅按间隔推送(**不要求**价格仍在箱外).
-- 第 3 次推送后:写入 `key_monitor_history`,`close_reason=**key_level_alert_done**`,从 `key_monitors` **删除**.
-
-### 2.4 与箱体/收敛的区别
-
-| 项目 | 阻力/支撑 | 箱体/收敛 |
-|------|-----------|-----------|
-| 方向 | 程序推断 | 人工选择 |
-| K 线根数 | 1 根闭合 5m | 2 根(突破 K + 确认 K) |
-| 提醒次数 | 3 次后结案 | 自动单:触发后 1 次业务推送并结案 |
-
----
-
-## 三,箱体突破 / 收敛突破(自动开仓)
-
-### 3.1 K 线结构(默认索引)
-
-| 角色 | 环境变量 | 默认 | 含义 |
-|------|----------|------|------|
-| 突破 K | `KEY_CONFIRM_BREAKOUT_BAR` | `-2` | 倒数第 2 根闭合 K |
-| 确认 K | `KEY_CONFIRM_BAR` | `-1` | 倒数第 1 根闭合 K |
-
-### 3.2 硬门控(须全部通过)
-
-1. **有效突破(收盘越界)**  
-   - 多:`突破 K 收盘 > upper`  
-   - 空:`突破 K 收盘 < lower`
-
-2. **突破越过幅度(仅下限)**  
-   - 多:`(突破 K 收盘 − upper) / upper × 100 > KEY_BREAKOUT_AMP_MIN_PCT`(默认 **0.03%**)  
-   - 空:`(lower − 突破 K 收盘) / lower × 100 >` 同上  
-   - **无上限**;突破过猛由 **计划 RR** 过滤.  
-   - **不再**使用 K 线实体占开盘价比例;`KEY_BREAKOUT_AMP_MAX_PCT` **已不参与门控**.
-
-3. **确认 K 不进箱体**  
-   - 多:确认 K 收盘 **`> upper`**(不得在 `[lower, upper]` 内)  
-   - 空:确认 K 收盘 **`< lower`**
-
-4. **量能:** 突破 K 成交量 > 前 `KEY_VOLUME_MA_BARS`(默认 20)根均量 × `KEY_VOLUME_RATIO_MIN`(默认 1.3)
-
-5. **日成交量排名:** 运行时仍须前 `KEY_DAILY_VOLUME_RANK_MAX`(默认 30)
-
-6. **计划 RR(最后经济门控):** 按确认 K 收盘 **E** 计算 SL/TP 后,`RR` **严格大于** `KEY_AUTO_MIN_PLANNED_RR`(默认 1.5)才市价开仓
-
-### 3.3 止损 / 止盈(确认 K 收盘为 E)
-
-箱体高 **H = |upper − lower|**.止损锚在 **突破 K 极值** 外侧:
-
-| 方向 | 止损(标准/趋势方案) |
-|------|------------------------|
-| 多 | 突破 K **最低价** × (1 − `KEY_STOP_OUTSIDE_BREAKOUT_PCT`%) |
-| 空 | 突破 K **最高价** × (1 + `KEY_STOP_OUTSIDE_BREAKOUT_PCT`%) |
-
-止盈方案见下表(与改版前一致):
-
-| 方案 | `sl_tp_mode` | 多:SL / TP | 空:SL / TP |
-|------|--------------|-------------|-------------|
-| 标准突破 | `standard` | 突破 K 低外侧% / **E+H** | 突破 K 高外侧% / **E−H** |
-| 箱体 1R·止盈 1.5H | `box_1p5` | **E−H** / **E+1.5×H** | **E+H** / **E−1.5×H** |
-| 趋势单·自填止盈 | `trend_manual` | 突破 K 低 × (1−`KEY_TREND_STOP_OUTSIDE_PCT`%) / **录入止盈** | 突破 K 高外侧% / **录入止盈** |
-
-### 3.4 一次性结案(`close_reason`)
-
-| `close_reason` | 含义 |
-|----------------|------|
-| `box_opposite_break` | 标记价先突破反向边界(多:≤下沿;空:≥上沿) |
-| `rr_insufficient` | 门控通过但 RR 不达标或 SL/TP 几何无效 |
-| `exchange_failed` | RR 达标但实盘/交易所等原因未开仓 |
-| `auto_opened` | RR 达标且市价开仓成功 |
-| `key_level_alert_done` | 阻力/支撑 **3 次提醒** 完成 |
-
----
-
-## 四,回调 / 突破触价开仓(程序触价,无交易所挂单)
-
-### 4.1 录入
-
-- **回调触价开仓**:方向必选多/空;填写 **计划入场价 E**,**止损 SL**,**止盈 TP**(做多须 `SL < E < TP`).
-- **突破触价开仓**:同上;添加时当前价须在突破方向一侧(做多:价低于 E;做空:价高于 E).
-- 计划 RR 以 **E** 为基准,须 **严格大于** `KEY_AUTO_MIN_PLANNED_RR`(默认 1.5).
-- 可选移动保本,时间平仓;**全仓杠杆模式**下可用.
-
-### 4.2 触发与结案
-
-| 类型 | 触发条件(标记价) |
-|------|-------------------|
-| **回调触价** | 做多 `≤ E`;做空 `≥ E` → 下一轮询市价开仓 |
-| **突破触价** | 做多**向上穿越** E;做空**向下穿越** E → **立即**市价开仓 |
-
-- 未成交前标记价先触 **TP 侧** → `trigger_tp_invalidate`.
-- **突破触价**另:未穿越 E 先触 **SL 侧** → `trigger_sl_invalidate`.
-- **24h** 未触发 → `trigger_entry_expired`.
-- 成功 → `trigger_entry_filled`;触发后开仓失败 → `trigger_exchange_failed`.
-
-### 4.3 计仓与占位
-
-- **以损定仓**:按 E,SL 反推保证金,触发时重算;**全仓杠杆**:可用×缓冲比例,BTC/ETH 10x,其它 5x.
-- **占当日开仓意图**(已开 + 待触发),未成交不占持仓;同币仅 1 条触价监控(含回调/突破).
-
-共享逻辑:`trigger_entry_key_monitor_lib.py`;轮询:`check_trigger_entry_key_monitors`.
-
----
-
-## 五,环境与参数(`.env` 摘要)
-
-| 变量 | 箱体/收敛 | 阻力/支撑 |
-|------|-----------|-----------|
-| `KEY_BREAKOUT_AMP_MIN_PCT` | 突破越过下限(默认 0.03) | 不用 |
-| `KEY_BREAKOUT_AMP_MAX_PCT` | **已废弃门控** | 不用 |
-| `KEY_VOLUME_*` / `KEY_CONFIRM_*` | 用 | 不用 |
-| `KEY_AUTO_MIN_PLANNED_RR` | 用 | 不用 |
-| `KEY_ALERT_MAX_TIMES` / `KEY_ALERT_INTERVAL_MINUTES` | 不用 | 用(默认 3 次 / 5 分钟) |
-| `KEY_DAILY_VOLUME_RANK_MAX` | 添加时 + 运行时 | **仅添加时** |
-
----
-
-## 六,相关代码
-
-| 说明 | 位置 |
-|------|------|
-| 共享判定 | `key_monitor_lib.py` |
-| 主循环 | `check_key_monitors` |
-| 自动门控 | `_key_hard_checks` |
-| 阻力/支撑提醒 | `_process_key_rs_level_alert` |
-| 录入 | `add_key` |
-| 开仓 | `_market_open_for_key_monitor` |

crypto_monitor_okx/更新文档.md

@@ -1,98 +0,0 @@
-# 界面与风控更新说明(OKX 实例)
-
-与 Gate / Binance 主站对齐的列表窗,统计分品类,交易记录展示,复盘与移动保本交易所同步;OKX 仍为 **三页导航**(交易执行 / 记录复盘 / 统计),关键位监控合并在 **交易执行** 页,**无** Gate 独立「关键位监控」页与斐波限价监控.
-
-## 顶栏导航(3 项)
-
-| 顺序 | 名称 | 路由 | 说明 |
-|------|------|------|------|
-| 1 | 交易执行 | `/trade` | 关键位监控 + 实盘下单(**默认首页** `/` → `/trade`) |
-| 2 | 交易记录与复盘 | `/records` | 交易记录,复盘表单,AI 历史(受顶栏 UTC 时间窗筛选) |
-| 3 | 统计分析 | `/stats` | 按北京时间交易日切日 + 分品类统计块 |
-
-## 列表时间窗(UTC,全站顶栏)
-
-共用模块:仓库根目录 `history_window_lib.py`(与 Gate / Binance 一致).
-
-| 项 | 说明 |
-|----|------|
-| 默认 | **UTC 当日**(`win_preset=utc_today`) |
-| 可选 | 近 24 小时,近 7 天,自定义起止(UTC) |
-| 作用范围 | 关键位历史,交易记录列表,复盘 API,AI 历史 API,导出「交易记录」「关键位历史」 |
-| 与统计 | **仅影响列表/导出**;统计页仍按北京时间 `TRADING_DAY_RESET_HOUR`(默认 8:00)切日 |
-| 切换 | 顶栏「列表筛选(UTC)」→ 应用(保留当前路由 query) |
-
-## 交易记录与复盘
-
-- 列表 **止损(开仓)**:展示 `initial_stop_loss` 快照(`display_open_stop_loss`).
-- 类型列显示 `monitor_type` 与 `key_signal_type`(若有).
-- 平仓入库:`stop_loss` / `initial_stop_loss` 为开仓止损快照;机器单 `entry_reason` 可按 `key_signal_type` 自动映射(箱体突破 / 收敛突破 → 四条固定关键位开仓类型文案).
-- 复盘:开仓类型下拉含四条关键位固定文案 +「其他」;离场触发含 **「止盈」**;从交易记录填入时按结果与信号预填.
-- 复盘 K 线图:以 **平仓时间** 为锚点向前约 `ORDER_CHART_LIMIT`(默认 100)根(`_fetch_ohlcv_ending_at`).
-- `/api/journals`,`/api/reviews` 与顶栏 UTC 窗一致.
-
-### 导出(交易记录 v3)
-
-- 文件名:`trade_records_v3_YYYYMMDD.csv`
-- 含 `key_signal_type`,`initial_stop_loss`,计划/实际 RR,`risk_amount` 等;末列「开仓类型」为有效展示文案.
-- 受 UTC 列表窗限制;关键位历史导出同理.
-
-## 实盘下单(交易执行页)
-
-- **移动保本**:表单可勾选「启用移动保本」;触发阶梯上移后 **先撤后挂** 交易所 TP/SL(`replace_active_monitor_tpsl_on_exchange`),仅成功后才写库;企业微信提示含「交易所:已先撤后挂止盈止损」.未配置实盘 API 时仅更新本地止损.
-- 开仓 TP/SL 仍通过 OKX `attachAlgoOrds`(与原有逻辑一致);重挂使用 ccxt `stopLoss` / `takeProfit` 参数,触发价经 `_okx_algo_trigger_price_str` 格式化.
-
-## 统计分析页(`/stats`)
-
-| 项 | 说明 |
-|----|------|
-| 切日 | 北京时间;边界 = `TRADING_DAY_RESET_HOUR:00`(默认 8) |
-| 品类下拉 | 全部交易,下单监控,关键位箱体突破,关键位收敛结构,关键位斐波0.618,关键位斐波0.786 |
-| URL | `stats_segment=`(`all` / `manual` / `key_box` / `key_conv` / `key_fib618` / `key_fib786`) |
-| 与 UTC 窗 | 统计 **不** 随顶栏列表窗变化 |
-
-## 斐波关键位监控(与 Gate / Binance 对齐)
-
-| 项 | 说明 |
-|----|------|
-| 类型 | **斐波回调0.618**,**斐波回调0.786**(交易执行页关键位表单) |
-| 同币互斥 | 每币仅一条斐波监控 |
-| 挂单价 E | 做多 `E = H − ratio×(H−L)`;做空 `E = L + ratio×(H−L)`;SL/TP 为 L/H |
-| 添加后 | 立即在 OKX 挂限价单;卡片显示 **挂E**,限价单 ID |
-| 失效 | 标记价触达止盈侧且限价未成交 → 仅撤本条限价单(`cancel_fib_limit_order`) |
-| 成交后 | 挂交易所 TP/SL → 写入 `order_monitors`(`monitor_type=关键位监控`,`key_signal_type=斐波回调…`)→ 从关键位表移除 |
-| 轮询 | `check_fib_key_monitors()`(与箱体/收敛 `check_key_monitors()` 分离) |
-| 盈亏比 | 计划 RR 须 > `KEY_AUTO_MIN_PLANNED_RR`(默认 1.5) |
-| 日成交量 | 排名前 `KEY_DAILY_VOLUME_RANK_MAX`(默认 30) |
-
-计算逻辑见仓库根目录 `fib_key_monitor_lib.py`.
-
-## 与 Gate 的差异(其余)
-
-- 无独立「关键位监控」导航页(斐波在 **交易执行** 页添加).
-- 箱体/收敛与 Gate/Binance 相同:**门控 + RR 达标后自动市价开仓**(须 `LIVE_TRADING_ENABLED=true`).
-
-## 交易所已实现盈亏(与 Gate 一致)
-
-- 打开 **交易执行 / 交易记录** 等主页面时,若已配置 `OKX_API_KEY` / `OKX_API_SECRET` / `OKX_API_PASSPHRASE`(只读即可),同进程约 **25 秒**内最多调用一次 OKX **历史仓位**(`fetch_positions_history`),为未写入 `exchange_sync_key` 的记录匹配并回填 `exchange_realized_pnl`.
-- 复盘列表盈亏优先展示交易所 U(旁标 **所**);本地公式估算标 **估**;人工复核优先.
-- 手动强制同步:`GET /api/sync_exchange_pnl`(需登录).
-- 可选 `.env`:`EXCHANGE_POSITION_SYNC_FROM_BJ`(北京时间起点),`EXCHANGE_POSITION_HISTORY_LIMIT`(默认 200).
-
-## 企业微信推送(与 Gate 对齐)
-
-- 平仓:`📉 … 平仓完成` 模板(盈亏 ±X.XX U,价位两位/按币价精度,账户资金 2 位小数).
-- 开仓成功:与 Gate 相同的 emoji 分段(条件委托状态文案,RR/张数/名义 2 位小数).
-- 移动保本:仅首次触发推送;交易所同步失败同一监控单只告警一次.
-- 斐波/关键位/划转等推送数值格式与 Gate 一致(`format_wechat_scalar_2dp`).
-
-## 配置与部署
-
-- 详见 `.env.example` 中 OKX(`OKX_*`)与通用风控项.
-- 代码更新后请 **重启 OKX 监控进程**;旧库行不做批量回填,展示字段有则用之,无则回退.
-
----
-
-## 共享更新记录
-
-自 2026-07-16 起，期权/对冲等共享逻辑的变更统一记在仓库根目录 **[docs/更新文档.md](../docs/更新文档.md)**（含原因、改动文件、目标、验收）。最新一条：期权/对冲开仓仅认真实卖一深度。