sync gate_bot with gate as identical copy instance

Align gate_bot app, templates, and env template with gate while keeping bot identity (port 5002, hub key gate_bot).

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

crypto_monitor_gate_bot/.env.example

@@ -62,9 +62,8 @@ BTC_LEVERAGE=10
 ALT_LEVERAGE=5
 # 交易日重置小时（北京时间）
 TRADING_DAY_RESET_HOUR=8
-# Gate 平仓历史：同步「趋势回调」交易记录与交易所已实现盈亏（北京日期 00:00 起，与 APP_TIMEZONE 一致）；留空则从近 90 天拉取
-# EXCHANGE_POSITION_SYNC_FROM_BJ=2026-05-14
-# EXCHANGE_POSITION_HISTORY_LIMIT=200
+# 整点前禁止新开仓：true=启用（默认），false=关闭（仍可保留 8 点作为交易日划分）
+TRADING_DAY_RESET_OPEN_GUARD_ENABLED=true
 
 # 是否开启 Gate 实盘下单（false=只做本地流程，true=真实下单）
 LIVE_TRADING_ENABLED=true
@@ -82,31 +81,64 @@ GATE_TPSL_USE_POSITION_ORDER=true
 GATE_TPSL_TRIGGER_EXPIRATION=604800
 # 触发参考价：0=最新成交 1=标记价 2=指数价（非法值按 0）
 GATE_TPSL_PRICE_TYPE=0
+# 仓位类 TP/SL 相对现价的最小间距（%），避免 Gate 1026「触发价须高于/低于现价」
+GATE_TPSL_LAST_PRICE_GAP_PCT=0.05
 # 页面与浏览器标签展示的交易所名称（多环境区分时可改成例如 Gate·模拟）
 # EXCHANGE_DISPLAY_NAME=Gate.io
 
 # =============================================================================
-# 交易执行 / 开仓限制（与 crypto_monitor_gate 主站一致）
+# 关键位门控（页面「关键位监控」规则条与 _key_hard_checks 共用）
 # =============================================================================
-# 【最大同时持仓】active 下单监控数达到该值后禁止再开仓（默认 1=单仓）
+# 【周期】门控 K 线周期，如 5m、15m
+KLINE_TIMEFRAME=5m
+# 【确认K】闭合 K 序列中的棒偏移：突破棒默认 -2，确认棒默认 -1
+KEY_CONFIRM_BREAKOUT_BAR=-2
+KEY_CONFIRM_BAR=-1
+# 【量能】突破棒成交量 > 前 N 根均量 × 倍数
+KEY_VOLUME_MA_BARS=20
+KEY_VOLUME_RATIO_MIN=1.3
+# 【突破K实体幅度】占开盘价百分比区间
+# 【箱体/收敛】突破K收盘越过关键位下限%；无上限（过猛由计划RR过滤）
+KEY_BREAKOUT_AMP_MIN_PCT=0.03
+KEY_BREAKOUT_AMP_MAX_PCT=0.5
+# 【阻力/支撑】突破后微信提醒
+KEY_ALERT_MAX_TIMES=3
+KEY_ALERT_INTERVAL_MINUTES=5
+# 【日成交量排名】品种须在该排名前 N 名
+KEY_DAILY_VOLUME_RANK_MAX=30
+# 【关键位自动开仓盈亏比】严格大于该值才市价开仓
+KEY_AUTO_MIN_PLANNED_RR=1.5
+# 止损：突破 K 极值向外缓冲的百分比（默认 0.5 即 0.5%）
+KEY_STOP_OUTSIDE_BREAKOUT_PCT=0.5
+# 趋势单方案：止损在突破 K 极值外侧的百分比（默认 1 即 1%）
+KEY_TREND_STOP_OUTSIDE_PCT=1
+KEY_ALERT_MAX_TIMES=3
+KEY_ALERT_INTERVAL_MINUTES=5
+
+# =============================================================================
+# 交易执行 / 人工风控（页面「实盘下单」）
+# =============================================================================
+# 【最大同时持仓】默认 1=单仓
 MAX_ACTIVE_POSITIONS=1
+# 【人工下单最低盈亏比】低于该值前后端均拒绝（默认 1.4，即须 >=1.4:1）
+MANUAL_MIN_PLANNED_RR=1.4
+# 【关键位连开计仓】已有持仓时按无仓时资金快照算基数
+KEY_SIZING_USE_ZERO_POSITION_SNAPSHOT=true
 # 【单日开仓 AI 提醒】本交易日开仓达到该次数时推送企业微信 AI 克制提醒（不拦单）
 DAILY_OPEN_ALERT_THRESHOLD=5
 # 【单日开仓硬上限】本交易日开仓次数>=该值后禁止一切新开仓直至下一交易日（北京时间 TRADING_DAY_RESET_HOUR 切日）；0=不启用
 DAILY_OPEN_HARD_LIMIT=0
-# 整点前禁止新开仓：true=启用（默认），false=关闭（交易日划分仍用 TRADING_DAY_RESET_HOUR）
-# TRADING_DAY_RESET_OPEN_GUARD_ENABLED=true
-
-# 关键位监控：5m收线突破过滤参数
-KLINE_TIMEFRAME=5m
-KEY_BREAKOUT_LIMIT_PCT=1.5
-KEY_ALERT_MAX_TIMES=3
-KEY_ALERT_INTERVAL_MINUTES=5
 
 # 资金与仓位刷新周期（秒）
 BALANCE_REFRESH_SECONDS=60
+# 前端价格快照轮询（秒）
+PRICE_REFRESH_SECONDS=5
 # 后台监控轮询周期（秒）
 MONITOR_POLL_SECONDS=3
+# 重启后多少秒内不做「外部平仓」同步（避免 API 未就绪误判）
+RECONCILE_STARTUP_GRACE_SEC=90
+# 连续多少次轮询确认交易所空仓后，才记为外部平仓（默认 3 次 ≈ 9 秒）
+RECONCILE_FLAT_CONFIRM_POLLS=3
 # 使用可用资金时的缓冲比例（如0.98代表用98%）
 FULL_MARGIN_BUFFER_RATIO=0.98
 
@@ -129,13 +161,12 @@ FORCE_CLOSE_ENABLED=false
 # 推送与AI超时（秒）
 WECHAT_TIMEOUT_SECONDS=10
 AI_TIMEOUT_SECONDS=120
-AI_REVIEW_TIMEOUT_SECONDS=300
 
+# AI 提供方：openai（默认）| ollama
 AI_PROVIDER=openai
 OPENAI_API_BASE=https://op.bz121.com/v1
 OPENAI_API_KEY=你的密钥
-# 须与网关「模型分布」里已启用节点的 Model ID 完全一致（示例为 4070s 节点）
-OPENAI_MODEL=huihui_ai/gemma-4-abliterated:e4b
+OPENAI_MODEL=gemma4:e4b
 OLLAMA_API=http://127.0.0.1:11434/api/generate
 AI_MODEL=huihui_ai/deepseek-r1-abliterated:latest
 
@@ -165,12 +196,5 @@ AI_MODEL=huihui_ai/deepseek-r1-abliterated:latest
 # 开单风格默认值：trend / swing
 # DEFAULT_TRADE_STYLE=trend
 
-# 趋势回调策略（可选，见 趋势回调策略说明.md）
-# TREND_PULLBACK_DCA_LEGS=5
-# TREND_PULLBACK_PREVIEW_TTL_SECONDS=120
-# 趋势回调手动保本：相对持仓均价的默认偏移（%）；多=均价×(1+pct/100)，空=均价×(1-pct/100)
-# TREND_PULLBACK_MANUAL_BREAKEVEN_OFFSET_PCT=0.3
-# TREND_PREVIEW_MAX_BALANCE_DRIFT_PCT=5
-
 APP_TIMEZONE=Asia/Shanghai
 # TRADING_DAY_RESET_HOUR 现在表示「北京时间」整点，默认 8 点起算新交易日；开仓整点限制见 TRADING_DAY_RESET_OPEN_GUARD_ENABLED

crypto_monitor_gate_bot/README.md

@@ -0,0 +1,90 @@
+# crypto_monitor_gate
+
+基于 **Flask** 的加密货币 **下单监控 / 关键位监控 / 交易复盘** 小系统，行情与实盘接口统一走 **Gate.io USDT 永续**，通过 **ccxt** 访问。
+
+## 文档导航
+
+| 文档 | 说明 |
+|------|------|
+| **[使用说明.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 线导出等可选用）
+
+安装示例：
+
+```bash
+cd /opt/crypto_monitor/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_bot/templates/order_focus.html

@@ -140,13 +140,13 @@ function addLine(price, title, color){
 function paintOrder(order){
     document.getElementById("m-symbol").innerText = order.symbol || "-";
     document.getElementById("m-direction").innerText = (order.direction === "short") ? "做空" : "做多";
-    document.getElementById("m-entry").innerText = fmt(order.trigger_price, 8);
-    document.getElementById("m-sl").innerText = fmt(order.stop_loss, 8);
-    document.getElementById("m-tp").innerText = fmt(order.take_profit, 8);
+    document.getElementById("m-entry").innerText = order.trigger_price_display || fmt(order.trigger_price, 8);
+    document.getElementById("m-sl").innerText = order.stop_loss_display || fmt(order.stop_loss, 8);
+    document.getElementById("m-tp").innerText = order.take_profit_display || fmt(order.take_profit, 8);
     document.getElementById("m-rr").innerText = (order.rr_ratio === null || typeof order.rr_ratio === "undefined") ? "-" : `1:${Number(order.rr_ratio).toFixed(2)}`;
-    document.getElementById("m-price").innerText = fmt(order.current_price, 8);
+    document.getElementById("m-price").innerText = order.current_price_display || fmt(order.current_price, 8);
     const pnlEl = document.getElementById("m-pnl");
-    pnlEl.innerText = `${fmt(order.float_pnl, 4)}U (${fmt(order.float_pct, 2)}%)`;
+    pnlEl.innerText = `${fmt(order.float_pnl, 2)}U (${fmt(order.float_pct, 2)}%)`;
     pnlEl.style.color = Number(order.float_pnl || 0) > 0 ? "#4cd97f" : (Number(order.float_pnl || 0) < 0 ? "#ff6666" : "#d6deff");
 }
 

crypto_monitor_gate_bot/使用说明.md

@@ -0,0 +1,145 @@
+# 使用说明
+
+**本文件对应仓库：`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 次微信**，然后本条 **结案进历史**。 |
+   | **关键支撑位** | 同上（仅提醒）。 |
+
+3. **方向**：做多 / 做空（必选）。  
+4. **上沿 / 下沿**：必填；保存时会按交易所 **价格精度** 取整。
+
+**限制：**  
+活跃持仓数达到 **`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_bot/关键位自动下单说明.md

@@ -0,0 +1,142 @@
+# 关键位监控说明（自动开仓 + 人工盯盘）
+
+**适用：`crypto_monitor_gate`（Gate U 本位永续）**  
+Binance / OKX 见各自目录下同名文档；共享逻辑在仓库根目录 `key_monitor_lib.py`。
+
+本文档与 `.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 | 必选 | 限价挂单逻辑 | 见斐波说明（**不在下文展开**） |
+
+**添加时（所有类型）：** 品种须 **日成交量排名前 `KEY_DAILY_VOLUME_RANK_MAX`（默认 30）**；上沿 **>** 下沿。
+
+---
+
+## 二、关键阻力位 / 关键支撑位（人工盯盘）
+
+### 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` | 含义 |
+|----------------|------|
+| `rr_insufficient` | 门控通过但 RR 不达标或 SL/TP 几何无效 |
+| `exchange_failed` | RR 达标但实盘/交易所等原因未开仓 |
+| `auto_opened` | RR 达标且市价开仓成功 |
+| `key_level_alert_done` | 阻力/支撑 **3 次提醒** 完成 |
+
+---
+
+## 四、环境与参数（`.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_bot/更新文档.md

@@ -0,0 +1,148 @@
+# 界面与风控更新说明（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 / Gate Bot **各执行一次** `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 已挂上；平仓后交易记录止损(开仓)与开仓类型是否正确。

manual_trading_hub/settings_store.py

@@ -48,7 +48,7 @@ DEFAULT_EXCHANGES = [
         "flask_url": "http://127.0.0.1:5002",
         "review_url": "http://127.0.0.1:5002/records",
         "enabled": True,
-        "capabilities": ["trend"],
+        "capabilities": ["key", "trend"],
     },
 ]