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_gate/.env.example

@@ -231,3 +231,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_gate/README.md

@@ -1,90 +1,11 @@
-# crypto_monitor_gate
+# crypto_monitor_gate（用户版）
 
-基于 **Flask** 的加密货币 **下单监控 / 关键位监控 / 交易复盘** 小系统,行情与实盘接口统一走 **Gate.io USDT 永续**,通过 **ccxt** 访问.
+Gate USDT 永续实例。
 
-## 文档导航
-
-| 文档 | 说明 |
-|------|------|
-| **[使用说明.md](./使用说明.md)** | 日常怎么用:登录,关键位四类,手工开仓,单仓与微信等 |
-| **[关键位自动下单说明.md](./关键位自动下单说明.md)** | 关键位自动开仓的 RR,止盈止损,结案原因与 `.env` |
-| **[部署文档.md](./部署文档.md)** | Ubuntu,PM2,**SSH SOCKS** 访问 Gate API 等 |
-
-另:**Binance U 本位** 对等实现见同级的 **`crypto_monitor_binance`** 仓库.
-
----
-
-## 功能概要
-
-- **关键位监控**:5m 收线硬条件,企业微信推送;**箱体 / 收敛** 在 RR 达标时可 **自动市价开仓**(见专门文档);**阻力 / 支撑** 仅单次提醒结案
-- **下单监控**:本地风控(含移动保本),止盈/止损触达后轮询尝试平仓并记账
-- **实盘(可选)**:`LIVE_TRADING_ENABLED=true` 且配置 **`GATE_API_KEY` / `GATE_API_SECRET`** 时,支持开仓,挂单 TP/SL,余额与划转(权限依账户而定)
-- **止盈止损(Gate)**:市价成交后经 **`_gate_place_tp_sl_orders`** 挂单;优先 **仓位类 `price_orders`**(受 `GATE_TPSL_USE_POSITION_ORDER`,`GATE_TPSL_PRICE_TYPE`,`GATE_POS_MODE` 等影响)
-
----
-
-## 环境要求
-
-- Python 3.10+(建议)
-- 依赖:`flask`,`requests`,`ccxt`,`werkzeug`,`PySocks`(经 SOCKS 代理时);`Pillow`(K 线导出等可选用)
-
-安装示例:
+- **部署**：[部署文档.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_gate
-source .venv/bin/activate
-pip install -r ../requirements.txt
 ```
-
-## 配置(`.env.example` → `.env`)
-
-- **`.env.example`**:模板(可提交 Git);首次:`cp .env.example .env` 后编辑.
-- **`.env`**:本机真实配置(勿提交);`git pull` 不覆盖;升级前建议备份(见《部署文档》§5.2).
-
-项目启动时加载**仓库根目录**下的 `.env`.常用项:
-
-| 变量 | 说明 |
-|------|------|
-| `GATE_API_KEY` / `GATE_API_SECRET` | Gate API(需合约与对应权限) |
-| `LIVE_TRADING_ENABLED` | `true` 允许真实下单;`false` 仅本地与推送逻辑 |
-| `GATE_MARGIN_MODE` / `GATE_POS_MODE` | 保证金与持仓模式 |
-| `GATE_TPSL_USE_POSITION_ORDER` / `GATE_TPSL_PRICE_TYPE` 等 | 条件止盈止损行为 |
-| `GATE_SOCKS_PROXY` | 可选;直连不稳时 SSH 动态转发(详见部署文档) |
-| `APP_PASSWORD` / `FLASK_SECRET_KEY` | Web 登录与 Session |
-| `WECHAT_WEBHOOK` | 企业微信机器人 |
-| `EXCHANGE_DISPLAY_NAME` / `GATE_ACCOUNT_LABEL` | 页面与推送展示的账户文案 |
-
-其余见 **`.env.example` 内注释** 或 **`app.py` 顶部默认值**.
-
-## 运行
-
-生产使用 **PM2**(`ecosystem.config.cjs`).调试:
-
-```bash
-source .venv/bin/activate && python app.py
-```
-
-见 [docs/ubuntu-server.md](../docs/ubuntu-server.md).
-
-端口由 **`APP_PORT`** 控制(未设置默认 **5000**).浏览器登录 **`/login`**,口令为 **`APP_PASSWORD`**.
-
-## 部署(Linux / PM2 / SSH SOCKS)
-
-见 **[部署文档.md](./部署文档.md)**.
-
-## 自检脚本
-
-```bash
-python scripts/verify_gate_funding.py
-```
-
-用于核对密钥前缀(不落 Secret),资金/合约可读性等(需网络与权限).
-
-## 数据与脚本
-
-- 默认 SQLite:由 **`DB_PATH`** 指定(常见为项目下 `crypto.db`)
-- `scripts/fix_breakeven_labels.py`:修正「止损」但盈亏为正的记录标签(参见部署文档说明)
-
-## 风险与合规
-
-实盘有亏损风险.请确认 API 权限,IP 白名单,杠杆与保证金模式与 **Gate.io** 后台一致,并遵守当地法律法规与交易所用户协议.

crypto_monitor_gate/app.py

@@ -305,6 +305,12 @@ app.secret_key = os.getenv("FLASK_SECRET_KEY", "crypto_monitor_2026_secret_key")
 from lib.instance.instance_embed_lib import attach_embed_templates
 
 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] gate: {_lic_err}")
 
 # ====================== 登录配置 ======================
 USERNAME = os.getenv("APP_USERNAME", "dekun")

crypto_monitor_gate/使用说明.md

@@ -1,147 +0,0 @@
-# 使用说明
-
-**本文件对应仓库:`crypto_monitor_gate`(Gate.io USDT 永续).**  
-功能,界面与 **Binance U 本位版**(目录 `crypto_monitor_binance`)基本一致,差异主要在 **`.env` 里交易所密钥与部分参数名**(`GATE_*` / `BINANCE_*`),文末有对照.
-
-**更细的部署(SSH 代理,PM2,依赖安装)** 见同目录 **`部署文档.md`**.  
-**关键位自动开仓的规则,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** | **本仓库:** `GATE_API_KEY`,`GATE_API_SECRET`;合约相关见 `GATE_MARGIN_MODE`,`GATE_POS_MODE`,`GATE_TPSL_*` 等.**勿**把 `.env` 提交到 Git. |
-| **关键位 RR / 止损外扩** | `KEY_AUTO_MIN_PLANNED_RR`,`KEY_STOP_OUTSIDE_BREAKOUT_PCT`(详见 `关键位自动下单说明.md`). |
-| **AI 复盘** | `AI_PROVIDER=openai`(默认)或 `ollama`;变量见 `.env.example` 与 [AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md). |
-
-网络不稳定时可为 Gate 配置 **`GATE_SOCKS_PROXY`** 等(见 **`部署文档.md`**).
-
----
-
-## 3. 如何启动与登录
-
-1. 按 **`部署文档.md`** 建好虚拟环境,安装依赖(如 `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 列表与历史
-
-- 当前条目可 **删除**(会按规则记入历史的情形见页面说明).  
-- **关键位历史**:已结案记录;可配合导出链接(若有)做备份.
-
----
-
-## 5. 实盘下单(顶栏「实盘下单」→ `/trade`)
-
-用于 **自己点按钮** 开单:
-
-- 持仓上限由 **`MAX_ACTIVE_POSITIONS`** 控制(默认 1,与关键位自动单共用).  
-- **人工开仓**时计划盈亏比不得低于 **`MANUAL_MIN_PLANNED_RR`**(默认 1.4:1),否则页面弹窗且后端拒绝.  
-- 填写币种,方向,杠杆(可选),止损/止盈(价格或百分比按表单说明).  
-- 勾选是否启用 **移动保本** 等行为以 `.env`/页面默认值为准.
-
-平仓通过页面 **平仓**(或等价入口),会从交易所市价处理并更新记录.**删除/误操作可能造成真实盈亏**,请先确认环境与方向.
-
-开仓成功后持仓卡片上会显示 **「来源」**:手工单一般为 **下单监控**;来自关键位自动单的为 **关键位监控**.
-
----
-
-## 6. 企业微信会看到什么
-
-- 关键位:按类型与结案结果推送(RR 不足,下单失败,自动开仓成功,仅阻力支撑提醒等),**每条关键位结案路径原则上一条主推送**(详见 `关键位自动下单说明.md`).  
-- 手工开仓,平仓,部分异常也会在规则满足时推送(以代码与配置为准).
-
-若未配置 **`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. **升级代码后**:启动时会跑 **数据库迁移**(如新列 `order_monitors.monitor_type`);首次启动关注一下日志或无报错页面.
-
----
-
-## 8. 常见问题(简要)
-
-| 现象 | 可自查 |
-|------|--------|
-| 关键位永远不触发 | 5m 门控是否全通过(页面门控摘要),币种日成交量是否在规则内,`KLINE_TIMEFRAME`. |
-| 有信号但不自动开仓 | `LIVE_TRADING_ENABLED`,`KEY_AUTO_MIN_PLANNED_RR`,计划 RR,是否已有持仓,API/余额报错(微信或日志). |
-| 加不了箱体/收敛 | 是否已有活跃持仓;先平仓或改用「阻力/支撑位」仅提醒. |
-| 推送收不到 | `WECHAT_WEBHOOK`,企业微信机器人配额与网络. |
-
----
-
-## 9. Binance 版(`crypto_monitor_binance`)差异速查
-
-| 项目 | Gate 本仓库 | Binance 版 |
-|------|-------------|------------|
-| API 变量 | `GATE_API_KEY`,`GATE_API_SECRET`,`GATE_*` | `BINANCE_API_KEY`,`BINANCE_API_SECRET`,`BINANCE_*` |
-| 实盘开关 | `LIVE_TRADING_ENABLED`(通用) | 同上 |
-| 止盈止损挂载路径 | `_gate_place_tp_sl_orders` 与 `GATE_TPSL_*` | `_binance_place_tp_sl_orders`(U 本位条件单) |
-| 资金显示舍入 | 以本仓库为准 | 与 **`FUNDS_DECIMALS`** 等一致 |
-| 专门文档 | **`关键位自动下单说明.md`**(各仓库有一份,开头标明交易所) | 同左 |
-
-操作流程(登录,关键位四类,手工单,单仓)**两份程序一致**:换目录,换 `.env` 即可对照使用.

crypto_monitor_gate/关键位自动下单说明.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_gate/更新文档.md

@@ -1,148 +0,0 @@
-# 界面与风控更新说明(Gate 实例)
-
-## 顶栏导航(4 项)
-
-| 顺序 | 名称 | 路由 | 说明 |
-|------|------|------|------|
-| 1 | 关键位监控 | `/key_monitor` | 关键位添加,实时门控,历史 |
-| 2 | 实盘下单 | `/trade` | 人工开仓,划转,实时持仓(**默认首页** `/` → `/trade`) |
-| 3 | 交易记录与复盘 | `/records` | 交易记录,复盘表单,AI 历史(受顶栏 UTC 时间窗筛选) |
-| 4 | 统计分析 | `/stats` | 按北京时间交易日切日 + 分品类统计块 |
-
-## 关键位监控页
-
-- 标题去掉「5m」;规则条从 `.env` 读取(周期,确认K,量能,自动开仓盈亏比,日成交量排名).
-- 左列:活跃关键位,**pos-card** 样式展示现价/距上沿/距下沿/门控.
-- 右列:关键位历史(失效/结案),与左列等高滚动;**受顶栏 UTC 列表时间窗筛选**(默认 UTC 当日).
-- 监控类型新增:**斐波回调0.618**,**斐波回调0.786**(与 Binance 主站同一套规则,计算逻辑见仓库根目录 `fib_key_monitor_lib.py`).
-
-### 斐波关键位监控(方案 A:交易所限价)
-
-| 项 | 说明 |
-|----|------|
-| 同币互斥 | 每个币种只能有一条斐波监控(0.618 与 0.786 不可并存) |
-| 上下沿 | 上沿 **H**,下沿 **L**(须 H > L) |
-| 挂单价 E | **做多** `E = H − ratio × (H − L)`(自 H 向下回撤);**做空** `E = L + ratio × (H − L)`(自 L 向上反弹) |
-| 做多 | 限价 @ E,止损 L,止盈 H |
-| 做空 | 限价 @ E,止损 H,止盈 L |
-| 添加后 | **立即**在 Gate 挂限价单;卡片显示 **挂E**,限价单 ID |
-| 失效 | 以**标记价**判断:做多且标记价 ≥ H,做空且标记价 ≤ L,且限价**未成交** → 撤销该限价单并结案(不写历史开仓) |
-| 成交后 | 按仓位挂交易所 TP/SL → 写入 **实盘下单监控**(`monitor_type=关键位监控`,`key_signal_type=斐波回调0.618/0.786`)→ 从关键位列表移除 |
-| 撤单 | 仅撤本条斐波的 `fib_limit_order_id`,**不会** `cancel_all`,避免误伤其他委托 |
-| 盈亏比 | 计划 RR 须 > `KEY_AUTO_MIN_PLANNED_RR`(与箱体/收敛一致);0.618 理论约 1.6:1,0.786 约 3.7:1 |
-| 日成交量 | 与箱体/收敛相同,须在前 `KEY_DAILY_VOLUME_RANK_MAX` 名内方可添加 |
-
-后台轮询:`check_fib_key_monitors()`(标记价失效 / 成交检测);箱体/收敛仍走 `check_key_monitors()`,互不干扰.
-
-手动删除关键位时,若斐波限价尚未成交,会先撤交易所限价再删库记录.
-
-### 箱体 / 收敛自动开仓(来源标注)
-
-- 自动开仓写入 `order_monitors.key_signal_type`:`箱体突破` 或 `收敛突破`.
-- 持仓卡片,交易记录列表会显示「来源 · 信号类型」.
-
-## 列表时间窗(UTC,全站顶栏)
-
-共用模块:仓库根目录 `history_window_lib.py`(Gate / Binance 主站一致).
-
-| 项 | 说明 |
-|----|------|
-| 默认 | **UTC 当日**(`win_preset=utc_today`,从 UTC 0:00 至当前时刻) |
-| 可选 | 近 24 小时,近 7 天,自定义起止(UTC,`datetime-local`) |
-| 作用范围 | 关键位历史,交易记录列表,复盘记录 API,AI 历史 API,导出「交易记录」「关键位历史」 |
-| 与统计的关系 | **仅影响列表/导出**;**统计分析页仍按北京时间 `TRADING_DAY_RESET_HOUR`(默认 8:00)切交易日** |
-| 库内时间 | DB 存北京时间字符串;后端用 `utc_window_to_bj_sql_strings()` 换算后再 SQL 比较 |
-| 切换方式 | 顶栏「列表筛选(UTC)」→ 选预设 → **应用**(保留当前路由,如 `/records?win_preset=…`) |
-
-查询参数示例:
-
-- `?win_preset=utc_today`
-- `?win_preset=utc_last24h` / `utc_last7d`
-- `?win_preset=custom&from_utc=2026-05-18 00:00:00&to_utc=2026-05-19 12:00:00`
-
-## 交易记录与复盘
-
-- 平仓记录可同步交易所已实现盈亏(Gate 仓位历史等);列表盈亏列优先显示交易所数据,标注 **所** / **估**.
-- 记录页提供 **立即同步**(`POST /api/sync_exchange_pnl`),用于补全或刷新 `exchange_realized_pnl` 等字段.
-- 未做人工复盘时,展示以交易所盈亏为准(有同步数据时).
-- **列表默认只显示当前 UTC 时间窗内**的记录(见上节);导出 CSV 同步该时间窗.
-- 表头 **「止损(开仓)」**:展示开仓快照 `initial_stop_loss`(无则回退 `stop_loss`);核对/复盘仍可用有效止损字段.
-- 平仓写入 `trade_records` 时:`stop_loss` 与 `initial_stop_loss` 均写入**开仓时止损快照**;`key_signal_type` 保留箱体/收敛/斐波来源(`fib_key_monitor_lib.key_signal_type_for_trade_record`).
-- **开仓类型**(`entry_reason`):机器单平仓入库时,若未手填,按 `key_signal_type` 自动映射(见下表);列表/导出「开仓类型」列 = 复盘核对值优先,否则入库值,否则按信号映射.
-
-| `key_signal_type` | 自动写入的 `entry_reason` |
-|-------------------|---------------------------|
-| 箱体突破 | 关键位箱体突破 |
-| 收敛突破 | 关键位收敛突破 |
-| 斐波回调0.618 | 关键位斐波0.618 |
-| 斐波回调0.786 | 关键位斐波0.786 |
-
-- 复盘表单 **开仓类型** 下拉新增上述四条固定文案(与趋势/波段类并列).
-- 复盘 **离场触发** 新增 **「止盈」**;从交易记录「填入复盘」时,若结果为「止盈/保本止盈/移动止盈/止损/手动平仓」会自动选中对应触发项,并按 `key_signal_type` 预填开仓类型.
-- 勾选「保存时自动生成多周期 K 线图」时:以 **平仓时间** 为锚点,各周期向前约 `ORDER_CHART_LIMIT`(默认 100)根 K 线(`_fetch_ohlcv_ending_at`),不再固定拉「最近 100 根」.
-- `/api/journals`,`/api/reviews` 支持同一时间窗 query,与列表一致.
-
-### 导出(交易记录 v3)
-
-- 文件名:`trade_records_v3_YYYYMMDD.csv`
-- 相对 v2 增加:`key_signal_type`,`initial_stop_loss`(及开仓快照列),`planned_rr`,`actual_rr`,`risk_amount`,交易所盈亏与时间字段等;末列「开仓类型」为有效展示文案.
-- 「关键位历史」导出同样受 UTC 时间窗限制.
-
-## 实盘下单页
-
-- 左列:实盘下单监控(表单,划转,规则).
-- 右列:实时持仓(独立模块).
-- **人工开仓门控**:计划盈亏比 < `MANUAL_MIN_PLANNED_RR`(默认 **1.4**)时前端弹窗 + 后端拒绝.
-- **移动保本**(勾选启用):监控轮询达到触发 RR 后,止损阶梯上移时**同步交易所**——调用与页面「挂止盈止损」相同的 **先撤后挂**(`replace_active_monitor_tpsl_on_exchange`:撤该合约全部 TP/SL 条件单 → 按新止损 + 原止盈重挂).仅交易所成功后才写库;失败发企业微信告警,本地止损不变.未配置实盘 API 时仍只更新本地(与旧行为一致).
-
-## 统计分析页(`/stats`)
-
-| 项 | 说明 |
-|----|------|
-| 切日 | **北京时间**;交易日边界 = 每日 `TRADING_DAY_RESET_HOUR:00`(`.env` 默认 **8**) |
-| 品类下拉 | 页顶 **「统计品类」** 下拉切换(默认「全部交易」):全部交易,下单监控,关键位箱体突破,关键位收敛结构,关键位斐波0.618,关键位斐波0.786;一次只显示所选品类的日/周/月 |
-| URL | 切换后写入 `stats_segment=`(如 `all`,`manual`,`key_box`,`key_conv`,`key_fib618`,`key_fib786`),刷新 `/stats` 可保持选项 |
-| 每块指标 | 日 / 周 / 月:开单次数,平仓笔数,胜率,净盈亏,回撤,连续亏损等(与原口径一致) |
-| 开单次数 | 人工块:`monitor_type=下单监控` 且无 `key_signal_type`;关键位块:按 `order_monitors.key_signal_type` 计数 |
-| 不受 UTC 窗影响 | 统计始终基于库内全部已平仓记录,按北京交易日归类,**不**随顶栏 UTC 列表窗切换 |
-
-## 持仓与计仓
-
-- `MAX_ACTIVE_POSITIONS` 默认 **1**(可在 `.env` 调大).
-- 关键位自动开仓:在已有持仓时,若 `KEY_SIZING_USE_ZERO_POSITION_SNAPSHOT=true`,按**首笔开仓前**交易账户资金快照计仓(`trading_sessions.key_sizing_capital_snapshot`).
-
-## 配置
-
-详见 `.env.example` 中「关键位门控」「交易执行 / 人工风控」注释段.Gate 专用项(`GATE_*`,止盈止损触发等)保持原有段落不变.
-
-## 自动备份(服务器)
-
-- 脚本:`scripts/backup_data.sh`(`crypto.db` + `static/images`)
-- 定时:`scripts/install_backup_cron.sh` → 每天 **北京时间 0:00**,目录 **`/root/backups/<实例名>/YYYY-MM-DD/`**,保留 **30** 天
-- 详见 `部署文档.md` 第 5.4 节(自动备份)
-
-## 数据库(启动时自动迁移)
-
-`key_monitors` 新增斐波字段(示例):`fib_limit_order_id`,`fib_entry_price`,`fib_stop_loss`,`fib_take_profit`,`fib_order_amount`,`fib_margin_capital`,`fib_leverage`.
-
-`trade_records` / `order_monitors` 新增或沿用:`key_signal_type`,`exchange_realized_pnl`,`exchange_opened_at`,`exchange_closed_at`,`exchange_sync_key`,`entry_reason`,`reviewed_entry_reason`,`initial_stop_loss`.
-
-**历史数据**:本次**不做**旧记录的批量回填(`entry_reason` / `initial_stop_loss` / `key_signal_type` 等);仅**新产生**的平仓与复盘按新逻辑写入.旧行展示可回退已有字段.
-
-## 涉及文件(便于排查)
-
-| 路径 | 说明 |
-|------|------|
-| `history_window_lib.py` | UTC 时间窗解析与转北京时间 SQL 字符串 |
-| `fib_key_monitor_lib.py` | 斐波计算,`KEY_ENTRY_REASON_BY_SIGNAL`,`entry_reason_from_key_signal` |
-| `crypto_monitor_gate/app.py` | 列表筛选,统计分块,导出 v3,复盘 K 线锚点,入库逻辑 |
-| `crypto_monitor_gate/templates/index.html` | 顶栏时间窗,统计分块 UI,止损(开仓)列,复盘预填 |
-
-## 升级步骤
-
-1. `git pull` 后对比 `.env.example`,把新增变量合并进本地 `.env`.
-2. 在 VPS 上为 Binance / Gate / **各执行一次** `bash scripts/install_backup_cron.sh`(若尚未安装).
-3. 重启 Gate 实例服务(如 `pm2 restart crypto_gate`);首次启动会自动 `ALTER TABLE` 缺列(斐波,交易所盈亏,`entry_reason` 等).
-4. 浏览器强刷(Ctrl+F5)避免旧版 `index.html` 缓存.
-5. 打开任意页确认顶栏出现 **「列表筛选(UTC)」**;`/stats` 可见分品类统计与「北京 8:00 切日」说明.
-6. 建议在测试币上先添加一条斐波监控,确认:限价已挂出,标记价失效会撤单,成交后出现持仓监控且 TP/SL 已挂上;平仓后交易记录止损(开仓)与开仓类型是否正确.