Initialize crypto_monitor_user (user edition) from monitor codebase.

Retarget git remote, install path, and deploy docs from crypto_monitor to crypto_monitor_user.

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

.cursor/rules/auto-push-deploy.mdc

@@ -0,0 +1,18 @@
+---
+description: After each completed code change, commit, push origin/main, and deploy to zk.hyf2.cc
+alwaysApply: true
+---
+
+# Auto push & deploy
+
+When a user-facing code change is **finished** (not mid-debug / not "先不要改代码"):
+
+1. Commit only the relevant files (skip unrelated CRLF-only docs noise).
+2. `git push origin main` to `https://git.bz121.com/dekun/crypto_monitor_user.git`.
+3. Deploy to production `zk.hyf2.cc`:`cd /opt/crypto_monitor_user && git pull && bash deploy/pull_and_restart.sh`.
+4. Confirm PM2 processes are online; briefly report commit hash + deploy status.
+
+Do **not** wait for the user to say "推送并部署" again unless they cancel this habit.
+
+SSH: Prefer key auth; if BatchMode fails, use existing Paramiko root login path used in this project.
+Do not print or put passwords in user-facing replies.

.cursor/rules/no-touch-existing-positions.mdc

@@ -0,0 +1,14 @@
+---
+description: Never trade or close the user's existing option/perp positions during testing
+alwaysApply: true
+---
+
+# Do not touch existing positions
+
+When testing option open/close, pending orders, monitors, or any live exchange path on this project:
+
+- **Never** flatten, reduce, cancel-close, or otherwise close positions the user already holds.
+- **Never** reuse an existing live position for smoke tests.
+- If a live trade test is required: open a **new** minimal test position only after explicit approval, then close **only that test position**.
+- If the only way to verify something needs an existing position: **stop and ask the user first**.
+- Prefer unit tests / dry paths over live orders when sufficient.

.gitattributes

@@ -0,0 +1,7 @@
+# Shell 脚本在仓库内统一 LF，避免 Linux 上 bash: pipefail: invalid option name（CRLF）
+*.sh text eol=lf
+deploy/** text eol=lf
+# 文档统一 LF，避免 Windows 编辑后产生 CRLF 脏 diff
+docs/** text eol=lf
+# .env 模板统一 LF，避免 Linux PM2 source 报 $'\r': command not found
+**/.env.example text eol=lf

.gitignore

@@ -0,0 +1,30 @@
+# 本地真实配置（含 API 密钥），勿提交
+**/.env
+.env
+
+# 允许提交模板
+!**/.env.example
+!.env.example
+
+# Python
+**/__pycache__/
+**/*.pyc
+**/.venv/
+
+# 本地备份（可选，勿提交）
+**/.env.backup*
+**/.env.bak
+**/.env.local
+manual_trading_hub/hub_settings.json
+manual_trading_hub/hub_backup_state.json
+manual_trading_hub/hub_fund_history.json
+manual_trading_hub/hub_supervisor_state.json
+manual_trading_hub/hub_ai_summaries.json
+manual_trading_hub/hub_ai_chat.json
+manual_trading_hub/hub_ai_fund_history.json
+manual_trading_hub/data/
+backups/
+
+# 数据库与上传（运行时生成）
+**/*.sqlite
+**/crypto.db

AI复盘与模型配置说明.md

@@ -0,0 +1,70 @@
+# AI 复盘与模型配置说明
+
+三个 `crypto_monitor_*` 实例共用仓库根目录 **`ai_client.py`**(通过 `PYTHONPATH=..` 导入).用于 **交易记录与复盘** 页的 AI 点评,短评建议,以及从复盘截图提取结构化 JSON.
+
+---
+
+## 一,二选一:`AI_PROVIDER`
+
+| 值 | 说明 |
+|----|------|
+| **`openai`**(默认) | OpenAI 兼容 **Chat Completions** 接口 |
+| **`ollama`** | 本机 Ollama **`/api/generate`**(流式 NDJSON) |
+
+在对应子目录 **`.env`** 中设置(各所 `.env.example` 已含模板):
+
+```bash
+AI_PROVIDER=openai
+AI_TIMEOUT_SECONDS=120
+
+# OpenAI 兼容网关(默认)
+OPENAI_API_BASE=https://op.bz121.com/v1
+OPENAI_API_KEY=你的密钥
+OPENAI_MODEL=gemma4:e4b
+
+# 本机 Ollama(仅当 AI_PROVIDER=ollama)
+OLLAMA_API=http://127.0.0.1:11434/api/generate
+AI_MODEL=huihui_ai/deepseek-r1-abliterated:latest
+```
+
+### OpenAI 兼容网关
+
+- **Base URL**:`https://op.bz121.com/v1`(请求路径为 `{base}/chat/completions`).
+- **API Key**:在 [op.bz121.com](https://op.bz121.com/) 登录后,于 **`gateway.json`** 页面复制(与网关账号一致).
+- **默认模型**:`gemma4:e4b`(可通过 `OPENAI_MODEL` 覆盖).
+
+### Ollama
+
+- 需本机已安装并拉取对应模型;`AI_PROVIDER=ollama` 时使用 `OLLAMA_API` 与 `AI_MODEL`.
+- 三所 `app.py` **不再** 直连 Ollama;统一走 `ai_client.ai_generate` / `ai_review` / `ai_short_advice`.
+
+---
+
+## 二,部署注意
+
+1. **PM2 / 手工启动**:`ecosystem.config.cjs` 中 **`PYTHONPATH=..`** 必须包含仓库根,否则无法 `from ai_client import ...`.
+2. 修改 `.env` 后重启对应实例,例如:`pm2 restart crypto_binance`(名称以你机器为准).
+3. **`git pull`** 不会改 `.env`;若 `.env.example` 新增 AI 变量,请手动补进本机 `.env`.
+4. **勿** 将含真实 `OPENAI_API_KEY` 的 `.env` 提交 Git.
+
+---
+
+## 三,功能入口(网页)
+
+登录后进入 **「交易记录与复盘」**:
+
+- 单条记录 **AI 复盘** / **短评**(依赖上述配置).
+- 上传复盘图后 **从图片提取** 字段(内部调用 `ai_generate`,与所选 provider 一致).
+
+若请求超时或返回错误,请检查:密钥是否有效,网关是否可达,`AI_TIMEOUT_SECONDS` 是否过短,Ollama 是否已启动(仅 ollama 模式).
+
+---
+
+## 四,相关文件
+
+| 路径 | 说明 |
+|------|------|
+| `ai_client.py` | 统一封装 OpenAI / Ollama |
+| `crypto_monitor_*/.env.example` | 各所环境变量模板 |
+| 各所《部署文档.md》§ AI 复盘 | 与本文一致的简表 |
+| 各所《使用说明.md》 | 运行前配置中的 AI 项 |

README.md

@@ -0,0 +1,91 @@
+# 复盘交易系统(crypto_monitor_user · 用户版)
+
+多交易所 **USDT 永续** 的下单监控,**关键位**,**策略交易**,**止盈止损 / 移动保本** 与 **AI 复盘**,三所独立部署 + 可选 **中控** 聚合监控.
+
+**远程仓库**:[https://git.bz121.com/dekun/crypto_monitor_user.git](https://git.bz121.com/dekun/crypto_monitor_user.git)
+
+---
+
+## 部署环境(必读)
+
+| 项 | 约定 |
+|----|------|
+| 系统 | **Ubuntu 22.04 / 24.04** |
+| 用户 | **root** |
+| 路径 | **`/opt/crypto_monitor_user`** |
+| 进程 | **PM2**(唯一推荐的常驻方式) |
+
+**环境详解**(Python 3.10+,Node,PM2 安装与启动顺序):**[docs/ubuntu-server.md](./docs/ubuntu-server.md)**  
+**一键部署管理器**:`curl -fsSL .../deploy/manage.sh | bash` → **[deploy/README.md](./deploy/README.md)**
+
+```bash
+# 新服务器(推荐)
+curl -fsSL https://git.bz121.com/dekun/crypto_monitor_user/raw/branch/main/deploy/manage.sh | bash
+
+# 或手动 clone
+cd /opt
+git clone https://git.bz121.com/dekun/crypto_monitor_user.git crypto_monitor_user
+cd /opt/crypto_monitor_user
+bash deploy/manage.sh
+```
+
+配置与运维脚本: **[docs/env-sync-scripts.md](./docs/env-sync-scripts.md)** · **[备份与恢复.md](./备份与恢复.md)**
+
+---
+
+## 功能导航
+
+| 功能 | 说明 | 文档 |
+|------|------|------|
+| **关键位监控** | 箱体/收敛自动开仓,阻力支撑提醒,斐波限价;止盈止损方案与 **移动保本** 开关 | 各所 [关键位自动下单说明.md](./crypto_monitor_binance/关键位自动下单说明.md)(Gate/OKX 目录内同名);方案细则 **[关键位止盈止损与移动保本更新说明.md](./关键位止盈止损与移动保本更新说明.md)** |
+| **实盘下单 / 下单监控** | 首仓,以损定仓;监控内 **止盈 / 止损**,**移动保本**(步进 R,偏移%) | 各所 [使用说明.md](./crypto_monitor_binance/使用说明.md) · 顶栏「实盘下单」`/trade` |
+| **策略交易** | **趋势回调** + **顺势加仓**(`/strategy` 双栏) | **[策略交易说明.md](./策略交易说明.md)** · 趋势细则 [docs/trend-pullback-strategy.md](./docs/trend-pullback-strategy.md) |
+| **策略交易记录** | 已结束计划快照(最近 100 条),筛选与展开详情 | [策略交易说明.md §五](./策略交易说明.md) · 顶栏 `/strategy/records` |
+| **交易复盘** | 平仓记录,错过机会,图表;**AI 点评** | **[AI复盘与模型配置说明.md](./AI复盘与模型配置说明.md)** · 顶栏「交易记录与复盘」`/records` |
+| **中控** | 多账户持仓/委托聚合,行情 K 线,紧急全平(**不在中控网页下单**) | [manual_trading_hub/使用说明.md](./manual_trading_hub/使用说明.md) · [部署文档.md](./manual_trading_hub/部署文档.md) |
+
+其它专题:[计仓模式](./docs/position-sizing-mode.md) · [每日自动划转](./docs/auto-transfer-daily.md) · [Chrome 快捷方式图标](./docs/shortcut-icon.md)
+
+---
+
+## 仓库目录
+
+| 目录 | 交易所 / 角色 | 部署文档 |
+|------|----------------|----------|
+| `crypto_monitor_binance/` | Binance U 本位永续 | [部署文档.md](./crypto_monitor_binance/部署文档.md) |
+| `crypto_monitor_gate/` | Gate | [部署文档.md](./crypto_monitor_gate/部署文档.md) |
+| `crypto_monitor_okx/` | OKX 永续 | [部署文档.md](./crypto_monitor_okx/部署文档.md) |
+| `manual_trading_hub/` | 中控 + 子代理 | [部署文档.md](./manual_trading_hub/部署文档.md) |
+| `lib/` | **共用模块**(策略,关键位,交易,中控库,AI,静态与模板) | **[docs/lib-structure.md](./docs/lib-structure.md)** |
+| `brand/` | 各所共用图标与 manifest | — |
+| `docs/`,`deploy/`,`scripts/`,`tests/` | 文档,环境,脚本,单元测试 | — |
+
+共用代码 import 示例:`from lib.strategy.strategy_db import init_strategy_tables`(各所启动时仍将仓库根加入 `PYTHONPATH`).详见 **[docs/lib-structure.md](./docs/lib-structure.md)**.
+
+---
+
+## 技术要点
+
+- **Python 3.10+**,Flask,ccxt,SQLite(`crypto.db`)
+- 三所 `.env` 前缀不同(`BINANCE_*` / `GATE_*` / `OKX_*`),**不可混用**
+- 实盘须 `LIVE_TRADING_ENABLED=true` 且理解 API 权限与 IP 白名单风险
+- 经 **SOCKS** 访问交易所时配置各所 `*_SOCKS_PROXY` 并安装 PySocks
+
+---
+
+## 推荐阅读顺序
+
+1. [docs/ubuntu-server.md](./docs/ubuntu-server.md) — 装 Python / Node / PM2,PM2 启动三所 + 中控  
+2. 各所 **`.env`**(从 `.env.example` 复制)  
+3. 所用功能对应上表 **功能导航** 文档  
+4. [备份与恢复.md](./备份与恢复.md) — 生产机备份习惯  
+
+---
+
+## 安全
+
+- **勿** 将 `.env`,API Secret,`.pem` 提交 Git  
+- 公网暴露中控须配置登录,`HUB_BRIDGE_TOKEN`,HTTPS Cookie  
+- 实盘风险由使用者自行承担  
+
+若子目录 README 与本文冲突,以 **子目录《部署文档》与当前代码** 为准.

brand/icon.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <defs>
+    <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#22d3ee"/>
+      <stop offset="100%" stop-color="#34d399"/>
+    </linearGradient>
+  </defs>
+  <rect width="512" height="512" rx="108" fill="#0c1019"/>
+  <rect x="36" y="36" width="440" height="440" rx="88" fill="#141b2d"/>
+  <rect x="36" y="36" width="440" height="440" rx="88" fill="none" stroke="url(#g)" stroke-width="12"/>
+  <path d="M120 320 L200 248 L280 272 L392 168" fill="none" stroke="url(#g)" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="392" cy="168" r="18" fill="#34d399"/>
+  <rect x="168" y="268" width="28" height="64" rx="6" fill="#f87171"/>
+  <line x1="182" y1="248" x2="182" y2="340" stroke="#f87171" stroke-width="10" stroke-linecap="round"/>
+  <rect x="268" y="220" width="28" height="96" rx="6" fill="#34d399"/>
+  <line x1="282" y1="200" x2="282" y2="340" stroke="#34d399" stroke-width="10" stroke-linecap="round"/>
+</svg>

brand/icons/binance/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <rect width="512" height="512" rx="108" fill="#0c1019"/>
+  <rect x="36" y="36" width="440" height="440" rx="88" fill="#141b2d"/>
+  <rect x="36" y="36" width="440" height="440" rx="88" fill="none" stroke="#F0B90B" stroke-width="12"/>
+  <polygon points="256,150 362,256 256,362 150,256" fill="#F0B90B"/><polygon points="256,210 302,256 256,302 210,256" fill="#1a160a"/>
+</svg>

brand/icons/gate/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <rect width="512" height="512" rx="108" fill="#0c1019"/>
+  <rect x="36" y="36" width="440" height="440" rx="88" fill="#141b2d"/>
+  <rect x="36" y="36" width="440" height="440" rx="88" fill="none" stroke="#17E6A1" stroke-width="12"/>
+  <text x="256" y="310" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="220" font-weight="700" fill="#17E6A1">G</text>
+</svg>

brand/icons/icon.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <defs>
+    <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#22d3ee"/>
+      <stop offset="100%" stop-color="#34d399"/>
+    </linearGradient>
+  </defs>
+  <rect width="512" height="512" rx="108" fill="#0c1019"/>
+  <rect x="36" y="36" width="440" height="440" rx="88" fill="#141b2d"/>
+  <rect x="36" y="36" width="440" height="440" rx="88" fill="none" stroke="url(#g)" stroke-width="12"/>
+  <path d="M120 320 L200 248 L280 272 L392 168" fill="none" stroke="url(#g)" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="392" cy="168" r="18" fill="#34d399"/>
+  <rect x="168" y="268" width="28" height="64" rx="6" fill="#f87171"/>
+  <line x1="182" y1="248" x2="182" y2="340" stroke="#f87171" stroke-width="10" stroke-linecap="round"/>
+  <rect x="268" y="220" width="28" height="96" rx="6" fill="#34d399"/>
+  <line x1="282" y1="200" x2="282" y2="340" stroke="#34d399" stroke-width="10" stroke-linecap="round"/>
+</svg>

brand/icons/okx/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <rect width="512" height="512" rx="108" fill="#0c1019"/>
+  <rect x="36" y="36" width="440" height="440" rx="88" fill="#141b2d"/>
+  <rect x="36" y="36" width="440" height="440" rx="88" fill="none" stroke="#FFFFFF" stroke-width="12"/>
+  <rect x="168" y="168" width="72" height="72" rx="10" fill="#FFFFFF"/><rect x="272" y="168" width="72" height="72" rx="10" fill="#FFFFFF"/><rect x="168" y="272" width="72" height="72" rx="10" fill="#FFFFFF"/>
+</svg>

brand/manifest.binance.webmanifest

@@ -0,0 +1,23 @@
+{
+  "name": "Binance 交易系统",
+  "short_name": "Binance 交易系统",
+  "description": "Binance 永续交易监控与复盘",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#0b0d14",
+  "theme_color": "#F0B90B",
+  "icons": [
+    {
+      "src": "__ICON_PREFIX__/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "__ICON_PREFIX__/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any maskable"
+    }
+  ]
+}

brand/manifest.exchange.webmanifest

@@ -0,0 +1,23 @@
+{
+  "name": "交易系统",
+  "short_name": "交易系统",
+  "description": "加密货币永续交易监控与复盘(请使用各所独立 manifest)",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#0b0d14",
+  "theme_color": "#0b0d14",
+  "icons": [
+    {
+      "src": "__ICON_PREFIX__/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "__ICON_PREFIX__/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any maskable"
+    }
+  ]
+}

brand/manifest.gate.webmanifest

@@ -0,0 +1,23 @@
+{
+  "name": "Gate 交易系统",
+  "short_name": "Gate 交易系统",
+  "description": "Gate 永续交易监控与复盘",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#0b0d14",
+  "theme_color": "#17E6A1",
+  "icons": [
+    {
+      "src": "__ICON_PREFIX__/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "__ICON_PREFIX__/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any maskable"
+    }
+  ]
+}

brand/manifest.okx.webmanifest

@@ -0,0 +1,23 @@
+{
+  "name": "OKX 交易系统",
+  "short_name": "OKX 交易系统",
+  "description": "OKX 永续交易监控与复盘",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#0b0d14",
+  "theme_color": "#FFFFFF",
+  "icons": [
+    {
+      "src": "__ICON_PREFIX__/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "__ICON_PREFIX__/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any maskable"
+    }
+  ]
+}

brand/manifest.webmanifest

@@ -0,0 +1,23 @@
+{
+  "name": "复盘系统中控",
+  "short_name": "中控",
+  "description": "三所交易监控与行情中控",
+  "start_url": "/monitor",
+  "display": "standalone",
+  "background_color": "#0b0e18",
+  "theme_color": "#0b0e18",
+  "icons": [
+    {
+      "src": "__ICON_PREFIX__/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "__ICON_PREFIX__/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any maskable"
+    }
+  ]
+}

crypto_monitor_binance/.env.example

@@ -0,0 +1,233 @@
+# =============================================================================
+# 环境配置模板(可提交 Git).程序运行时只读取同目录下的 .env.
+#
+# 首次部署 / 新机:
+#   cp .env.example .env
+#   nano .env          # 填入真实密钥,端口,代理等
+#
+# 升级代码(git pull)前建议备份(.env 不在 Git 中,pull 不会覆盖):
+#   cp .env .env.backup.$(date +%Y%m%d)
+#
+# 从备份恢复:
+#   cp .env.backup.YYYYMMDD .env
+# =============================================================================
+
+APP_ENV=production
+# 服务监听地址(云服务器通常用 0.0.0.0)
+APP_HOST=0.0.0.0
+# 服务端口
+APP_PORT=5001
+# 是否开启调试模式(生产建议 false)
+APP_DEBUG=false
+
+# 登录账号
+APP_USERNAME=admin
+# 登录密码(请改成你自己的强密码)
+APP_PASSWORD=admin123
+# 是否关闭登录校验(局域网可设 true;公网务必 false)
+APP_AUTH_DISABLED=true
+# --- 多账户交易中控 manual_trading_hub ---
+# 中控请求本实例 /api/hub/* 时携带请求头 X-Hub-Token,须与中控启动环境变量 HUB_BRIDGE_TOKEN 一致
+# 未设置且 APP_AUTH_DISABLED=false 时,仅网页登录后可访问;本机联调可保持 APP_AUTH_DISABLED=true
+# HUB_BRIDGE_TOKEN=your-long-random-token
+# Flask 会话密钥(必须替换为长随机字符串)
+FLASK_SECRET_KEY=CHANGE_TO_LONG_RANDOM_SECRET
+
+# 企业微信机器人 Webhook(用于行情/风控推送)
+WECHAT_WEBHOOK=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=REPLACE_WITH_REAL_KEY
+
+# 数据库文件路径(相对路径会自动按项目目录解析)
+DB_PATH=crypto.db
+# 交易截图上传目录
+UPLOAD_DIR=static/images
+
+# 自动备份(scripts/backup_data.sh + cron,可选;默认即可)
+# BACKUP_ROOT=/root/backups
+# BACKUP_RETENTION_DAYS=30
+# BACKUP_INSTANCE=crypto_monitor_binance
+
+# 已废弃:资金账户仅显示交易所 funding 余额,不再读取此变量
+# TOTAL_CAPITAL=100
+# 页顶「资金账户」默认仅 Binance Funding 钱包;若 USDT 主要在现货,可改为 true 合并 Spot
+# BINANCE_FUNDING_INCLUDE_SPOT=false
+# 计仓:risk=以损定仓(默认);full_margin=合约可用×FULL_MARGIN_BUFFER_RATIO 全仓杠杆(须无仓后重启)
+POSITION_SIZING_MODE=risk
+# 方向限制(默认 false=双向均可;true 时按 TRADE_DIRECTION 限制,修改后须重启)
+# TRADE_DIRECTION=long_only | short_only | both(或 多/空/双向)
+TRADE_DIRECTION_RESTRICT_ENABLED=false
+TRADE_DIRECTION=both
+# 币种白名单(默认 false=全币种可手输;true 时关键位/下单/策略仅下拉选择)
+TRADE_SYMBOL_RESTRICT_ENABLED=false
+TRADE_SYMBOL_WHITELIST=BTC,ETH
+# 每天起始基数(U)
+DAILY_START_CAPITAL=30
+# 日内回撤后基数(U)
+DAILY_LOSS_CAPITAL=20
+# 日内盈利后基数(U)
+DAILY_PROFIT_CAPITAL=50
+# BTC 默认杠杆倍数
+BTC_LEVERAGE=10
+# 山寨币默认杠杆倍数
+ALT_LEVERAGE=5
+# 交易日重置小时(北京时间)
+TRADING_DAY_RESET_HOUR=8
+# 整点前禁止新开仓:true=启用(默认),false=关闭(仍可保留 8 点作为交易日划分)
+TRADING_DAY_RESET_OPEN_GUARD_ENABLED=true
+
+# 是否开启 Binance 实盘下单(false=只做本地流程,true=真实下单)
+LIVE_TRADING_ENABLED=true
+# Binance API Key(需开通合约,万向划转等权限)
+BINANCE_API_KEY=REPLACE_WITH_BINANCE_API_KEY
+# Binance API Secret
+BINANCE_API_SECRET=REPLACE_WITH_BINANCE_API_SECRET
+# 保证金模式:cross=全仓,isolated=逐仓
+BINANCE_MARGIN_MODE=cross
+# 持仓模式:hedge=双向(需账户开启双向持仓,下单带 positionSide);oneway=单向
+BINANCE_POSITION_MODE=hedge
+# 条件单触发参考价:CONTRACT_PRICE=最新成交价 MARK_PRICE=标记价(更易触发时用标记价)
+BINANCE_TRIGGER_WORKING_TYPE=CONTRACT_PRICE
+# 页面与浏览器标签展示的交易所名称(多环境区分时可改成例如 Binance·测试网)
+EXCHANGE_DISPLAY_NAME=Binance
+# 企业微信推送里展示的账户备注
+# BINANCE_ACCOUNT_LABEL=binance实盘账户
+# 平仓盈亏估算:false=按仓位历史口径(已实现盈亏+手续费,不含资金费);true=含资金费
+# BINANCE_PNL_INCLUDE_FUNDING=false
+
+# =============================================================================
+# 关键位程序自动下单(与 POSITION_SIZING_MODE 联动,修改后须重启 PM2)
+# =============================================================================
+# 默认 false = 关闭所有关键位程序自动单(箱体/收敛/斐波/假突破/触价)
+#
+#   POSITION_SIZING_MODE=risk(以损定仓)
+#     false → 不执行任何关键位自动单;支撑/阻力提醒,人工下单,顺势加仓不受影响
+#     true  → 允许关键位全套自动(含触价)
+#
+#   POSITION_SIZING_MODE=full_margin(全仓杠杆,须无仓切换)
+#     false → 不执行触价自动单
+#     true  → 仅回调/突破触价可程序自动开仓;箱体/斐波等仍禁止
+#
+# 顺势加仓,趋势回调不受本开关控制;全仓模式下策略自动仍禁止.
+KEY_AUTO_ORDER_ENABLED=false
+
+# =============================================================================
+# 关键位门控(页面「关键位监控」规则条与 _key_hard_checks 共用)
+# =============================================================================
+# 【周期】门控 K 线周期,如 5m,15m;仅影响关键位硬条件,不改变顶栏分区
+KLINE_TIMEFRAME=5m
+# 【确认K】闭合 K 序列中的棒偏移:突破棒默认 -2(倒数第2根),确认棒默认 -1(倒数第1根)
+KEY_CONFIRM_BREAKOUT_BAR=-2
+KEY_CONFIRM_BAR=-1
+# 【量能】突破棒成交量 > 前 N 根均量 × 倍数(默认 N=20,倍数=1.3 即放大 30%)
+KEY_VOLUME_MA_BARS=20
+KEY_VOLUME_RATIO_MIN=1.3
+# 【箱体/收敛】突破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
+# 【关键位自动开仓盈亏比】按确认K收盘 E 计算,严格大于该值才市价开仓(如 1.5 表示须 >1.5:1)
+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
+
+# =============================================================================
+# 交易执行 / 人工风控(页面「实盘下单」)
+# =============================================================================
+# 【最大同时持仓】active 订单数达到该值后禁止人工与关键位自动再加仓(默认 1=单仓)
+MAX_ACTIVE_POSITIONS=1
+# 【人工下单最低盈亏比】按当前价与 SL/TP 计算,低于该值前后端均拒绝(默认 1.4,即须 >=1.4:1)
+MANUAL_MIN_PLANNED_RR=1.4
+# 【关键位连开计仓】true=已有持仓时关键位自动单仍按「无仓时」资金快照算保证金基数
+KEY_SIZING_USE_ZERO_POSITION_SNAPSHOT=true
+# 【单日开仓 AI 提醒】本交易日开仓达到该次数时推送企业微信 AI 克制提醒(不拦单)
+DAILY_OPEN_ALERT_THRESHOLD=5
+# 【单日开仓硬上限】本交易日开仓次数>=该值后禁止一切新开仓直至下一交易日(北京时间 TRADING_DAY_RESET_HOUR 切日);0=不启用
+DAILY_OPEN_HARD_LIMIT=0
+
+# =============================================================================
+# 账户冷静期 / 日冻结风控(手动平仓,外部平仓,复盘情绪标签)
+# 详见 docs/account-risk-cooldown.md
+# =============================================================================
+RISK_CONTROL_ENABLED=true
+RISK_COOLING_HOURS_MANUAL=4
+RISK_COOLING_HOURS_MANUAL_JOURNAL=1
+RISK_MANUAL_CLOSE_DAILY_LIMIT=2
+RISK_MOOD_ISSUES_DAILY_FREEZE=true
+
+# 资金与仓位刷新周期(秒)
+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
+
+# =============================================================================
+# 自动划转(页顶「将 swap 补足到 XU」;与 DAILY_START_CAPITAL 独立,需一致时请设为相同值)
+# =============================================================================
+AUTO_TRANSFER_ENABLED=false
+# 交易账户(swap)目标余额 U:每日 8 点(北京)自动划入或划出至 funding;持仓中不划转
+AUTO_TRANSFER_AMOUNT=30
+AUTO_TRANSFER_FROM=funding
+AUTO_TRANSFER_TO=swap
+TRANSFER_CCY=USDT
+# 北京时间该整点小时内尝试;账簿按 UTC 自然日去重
+AUTO_TRANSFER_BJ_HOUR=8
+# 强制清仓整点(北京时间,默认 0=凌晨00点)
+FORCE_CLOSE_BJ_HOUR=0
+# 是否启用强制清仓(默认关闭,true 才会在整点执行)
+FORCE_CLOSE_ENABLED=false
+
+# 推送与AI超时(秒)
+WECHAT_TIMEOUT_SECONDS=10
+AI_TIMEOUT_SECONDS=120
+
+# AI 提供方:openai(默认,OpenAI 兼容网关)| ollama(本机 Ollama)
+AI_PROVIDER=openai
+# OpenAI 兼容接口(示例:https://op.bz121.com/v1 ,账号见 gateway.json)
+OPENAI_API_BASE=https://op.bz121.com/v1
+OPENAI_API_KEY=你的密钥
+OPENAI_MODEL=gemma4:e4b
+# 本机 Ollama(AI_PROVIDER=ollama 时使用)
+OLLAMA_API=http://127.0.0.1:11434/api/generate
+AI_MODEL=huihui_ai/deepseek-r1-abliterated:latest
+
+# Binance 代理(可选):本机网络不稳定时通过 SSH 动态转发 SOCKS5 出口
+# 1) 先在本机建立隧道(示例):
+#    ssh -N -D 127.0.0.1:1080 user@vps -o ServerAliveInterval=30 -o ExitOnForwardFailure=yes
+# 2) 再启用下面这一行(推荐 socks5h,让远端解析域名):
+# BINANCE_SOCKS_PROXY=socks5h://127.0.0.1:1080
+#
+# 如你更偏向 HTTP 代理(VPS 上跑 tinyproxy 之类),可用:
+# BINANCE_HTTP_PROXY=http://127.0.0.1:3128
+# BINANCE_HTTPS_PROXY=http://127.0.0.1:3128
+
+# 开仓多周期K线图(可选)
+# ORDER_CHART_ENABLED=true
+# ORDER_CHART_TFS=4h,1h,15m,5m
+# ORDER_CHART_LIMIT=100
+# ORDER_CHART_DIR=static/images/order_charts
+# 详见上文 DAILY_OPEN_ALERT_THRESHOLD / DAILY_OPEN_HARD_LIMIT;说明文档 docs/daily-open-limit.md
+# 以损定仓(按交易账户资金的百分比)
+# RISK_PERCENT=2
+# 移动保本触发(达到多少R触发)与偏移(百分比)
+# BREAKEVEN_RR_TRIGGER=1.0
+# 移动保本阶梯(每多少R继续上移一次,默认1R)
+# BREAKEVEN_STEP_R=1.0
+# BREAKEVEN_OFFSET_PCT=0.02
+# 开单风格默认值:trend / swing
+# DEFAULT_TRADE_STYLE=trend
+
+APP_TIMEZONE=Asia/Shanghai
+# TRADING_DAY_RESET_HOUR 现在表示「北京时间」整点,默认 8 点起算新交易日;开仓整点限制见 TRADING_DAY_RESET_OPEN_GUARD_ENABLED

crypto_monitor_binance/README.md

@@ -0,0 +1,83 @@
+# crypto_monitor_binance
+
+基于 **Flask** 的加密货币 **下单监控 / 关键位监控 / 交易复盘** 小系统,行情与实盘接口统一走 **Binance(USDT-M 永续)**,通过 **ccxt** 访问.
+
+## 功能概要
+
+- **关键位监控**:价格与硬条件校验,企业微信推送(可选)
+- **下单监控**:本地风控(含移动保本逻辑),触达止盈/止损后尝试市价平仓并记账
+- **策略交易**:顶栏 `/strategy`(趋势回调 + 顺势加仓),见仓库根 [策略交易说明.md](../策略交易说明.md)
+- **AI 复盘**:OpenAI 兼容网关(默认)或 Ollama,见 [AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)
+- **实盘(可选)**:`LIVE_TRADING_ENABLED=true` 且配置 `BINANCE_API_KEY` / `BINANCE_API_SECRET` 时,支持合约开仓,平仓,余额读取与内部划转(依赖 API 权限)
+- **止盈止损(Binance)**:市价成交后挂 **`STOP_MARKET`**(止损),**`TAKE_PROFIT_MARKET`**(止盈);双向持仓带 `positionSide`;不显式传 `reduceOnly`(避免 API `-1106`).触发参考价由 `BINANCE_TRIGGER_WORKING_TYPE` 控制(最新价 / 标记价)
+
+## 环境要求
+
+- Python 3.10+(建议)
+- 依赖:`flask`,`requests`,`ccxt`,`werkzeug`,`Pillow`(K 线图可选);经 SOCKS 代理时需 **`PySocks`**
+
+安装示例:
+
+```bash
+# 推荐在 /opt/crypto_monitor_user 执行仓库根目录 deploy/setup_env.sh
+cd /opt/crypto_monitor_user/crypto_monitor_binance
+source .venv/bin/activate
+pip install -r ../requirements.txt
+```
+
+页面上的 **「当日资金(交易账户)」** 与 **「可开仓」可用 U** 仅统计 **Binance U 本位永续合约账户**(`fetch_balance` 的 `swap` / FAPI `assets` 中的 USDT),**不会**再用现货余额顶替.
+
+## 配置说明(`.env.example` → `.env`)
+
+- **`.env.example`**:模板(可提交 Git);首次:`cp .env.example .env` 后编辑.
+- **`.env`**:本机真实配置(勿提交);`app.py` 只读此文件.`git pull` 不覆盖 `.env`;升级前可 `cp .env .env.backup.$(date +%Y%m%d)`.
+
+与 Binance 相关的常用变量:
+
+| 变量 | 说明 |
+|------|------|
+| `BINANCE_API_KEY` / `BINANCE_API_SECRET` | 币安 API(需合约等权限) |
+| `LIVE_TRADING_ENABLED` | `true` 时允许真实下单;`false` 仅本地逻辑 |
+| `BINANCE_MARGIN_MODE` | `cross` 全仓 / `isolated` 逐仓 |
+| `BINANCE_POSITION_MODE` | `hedge` 双向(需账户开启双向持仓)/ `oneway` 单向 |
+| `BINANCE_TRIGGER_WORKING_TYPE` | `CONTRACT_PRICE` 或 `MARK_PRICE`(条件单触发参考) |
+| `BINANCE_SOCKS_PROXY` / `BINANCE_HTTP_PROXY` | 可选代理(与部署文档一致) |
+| `EXCHANGE_DISPLAY_NAME` | 页面展示的交易所名称,默认 `Binance` |
+| `BINANCE_ACCOUNT_LABEL` | 推送文案中的账户备注 |
+
+其余变量(登录,企业微信,风控参数,**`AI_PROVIDER` / `OPENAI_*` / `OLLAMA_*`**,数据库路径等)见 **`.env.example` 内注释** 或 `app.py` 顶部默认值.
+
+## 运行
+
+生产环境使用 **PM2**(`ecosystem.config.cjs`).临时调试:
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_binance
+source .venv/bin/activate
+python app.py
+```
+
+环境说明见 [docs/ubuntu-server.md](../docs/ubuntu-server.md).
+
+默认监听端口由 `.env` 的 `APP_PORT` 决定(未设置时多为 `5000`).
+
+## 部署(Linux / PM2 / SSH SOCKS)
+
+详见 **[部署文档.md](./部署文档.md)**(Ubuntu + PM2 + 可选 SOCKS 访问 Binance).
+
+## 自检脚本
+
+```bash
+python scripts/verify_binance_funding.py
+```
+
+用于核对 Key 前缀(不含 Secret)并尝试读取资金钱包 / 合约钱包 USDT(需网络与 API 权限).
+
+## 数据与脚本
+
+- 默认 SQLite:`crypto.db`(路径由 `DB_PATH` 指定)
+- `scripts/fix_breakeven_labels.py`:批量修正「止损」但盈亏为正的记录标签(见部署文档附录)
+
+## 风险与合规
+
+实盘交易有亏损风险.请自行确认 API 权限,IP 白名单,杠杆与保证金模式与币安账户设置一致,并遵守当地法律法规与 Binance 用户协议.

crypto_monitor_binance/ecosystem.config.cjs

@@ -0,0 +1,34 @@
+/**
+ * PM2 进程定义(Ubuntu / Linux).
+ *
+ * 仅托管 Flask 应用.**SSH SOCKS 隧道**用 `ssh -D` 常驻(可用 tmux / autossh),勿交给 PM2.
+ * 与 `.env` 里 `BINANCE_SOCKS_PROXY` 端口一致即可;不必交给 PM2.
+ *
+ * 使用前:项目根目录存在 `.venv`,且已安装依赖(走 SOCKS 时需 PySocks).
+ *
+ * 启动:
+ *   pm2 start ecosystem.config.cjs
+ * 保存开机列表:
+ *   pm2 save && pm2 startup
+ */
+const path = require("path");
+
+const ROOT = __dirname;
+const REPO_ROOT = path.join(ROOT, "..");
+const PY = path.join(ROOT, ".venv", "bin", "python");
+
+module.exports = {
+  apps: [
+    {
+      name: "crypto_binance",
+      cwd: ROOT,
+      script: path.join(ROOT, "app.py"),
+      interpreter: PY,
+      instances: 1,
+      autorestart: true,
+      watch: false,
+      max_memory_restart: "800M",
+      env: { PYTHONPATH: REPO_ROOT },
+    },
+  ],
+};

crypto_monitor_binance/scripts/_layout_snippet.html

@@ -0,0 +1,2 @@
+        {% if page == 'key_monitor' %}
+        <motion class="dual-panel-grid" style="grid-column:1/-1">

crypto_monitor_binance/scripts/backup_data.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+# Daily backup: SQLite DB + static/images → /root/backups/<instance>/<YYYY-MM-DD>/
+# Prune backup folders older than RETENTION_DAYS (default 30).
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$PROJECT_DIR"
+
+BACKUP_ROOT="${BACKUP_ROOT:-/root/backups}"
+RETENTION_DAYS="${RETENTION_DAYS:-30}"
+INSTANCE_NAME="${BACKUP_INSTANCE:-$(basename "$PROJECT_DIR")}"
+TZ_NAME="${BACKUP_TZ:-Asia/Shanghai}"
+
+log() {
+  printf '[%s] %s\n' "$(TZ="$TZ_NAME" date '+%Y-%m-%d %H:%M:%S %Z')" "$*"
+}
+
+read_env_var() {
+  local key="$1"
+  local default="$2"
+  local line
+  if [[ ! -f .env ]]; then
+    printf '%s' "$default"
+    return
+  fi
+  line="$(grep -E "^${key}=" .env 2>/dev/null | tail -1 || true)"
+  if [[ -z "$line" ]]; then
+    printf '%s' "$default"
+    return
+  fi
+  printf '%s' "${line#*=}" | tr -d '\r'
+}
+
+resolve_project_path() {
+  local p="$1"
+  if [[ "$p" == /* ]]; then
+    printf '%s' "$p"
+  else
+    printf '%s' "$PROJECT_DIR/$p"
+  fi
+}
+
+prune_old_backups() {
+  local base="$BACKUP_ROOT/$INSTANCE_NAME"
+  [[ -d "$base" ]] || return 0
+  local cutoff
+  cutoff="$(TZ="$TZ_NAME" date -d "-${RETENTION_DAYS} days" +%Y-%m-%d 2>/dev/null || true)"
+  if [[ -z "$cutoff" ]]; then
+    find "$base" -mindepth 1 -maxdepth 1 -type d -mtime +"$RETENTION_DAYS" -print0 |
+      xargs -r -0 rm -rf
+    return 0
+  fi
+  local dir name
+  for dir in "$base"/*/; do
+    [[ -d "$dir" ]] || continue
+    name="$(basename "$dir")"
+    [[ "$name" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]] || continue
+    if [[ "$name" < "$cutoff" ]]; then
+      log "prune: remove $dir (older than ${RETENTION_DAYS} days)"
+      rm -rf "$dir"
+    fi
+  done
+}
+
+DB_REL="$(read_env_var DB_PATH crypto.db)"
+UPLOAD_REL="$(read_env_var UPLOAD_DIR static/images)"
+BACKUP_ROOT="$(read_env_var BACKUP_ROOT "$BACKUP_ROOT")"
+RETENTION_DAYS="$(read_env_var BACKUP_RETENTION_DAYS "$RETENTION_DAYS")"
+INSTANCE_NAME="$(read_env_var BACKUP_INSTANCE "$INSTANCE_NAME")"
+
+DB_PATH="$(resolve_project_path "$DB_REL")"
+UPLOAD_DIR="$(resolve_project_path "$UPLOAD_REL")"
+DATE_TAG="$(TZ="$TZ_NAME" date +%Y-%m-%d)"
+DEST="$BACKUP_ROOT/$INSTANCE_NAME/$DATE_TAG"
+
+if [[ ! -f "$DB_PATH" ]]; then
+  log "error: database not found: $DB_PATH"
+  exit 1
+fi
+
+mkdir -p "$DEST"
+log "start backup instance=$INSTANCE_NAME dest=$DEST"
+
+if command -v sqlite3 >/dev/null 2>&1; then
+  sqlite3 "$DB_PATH" ".backup '$DEST/crypto.db'"
+  log "db: sqlite3 backup -> $DEST/crypto.db"
+else
+  cp -a "$DB_PATH" "$DEST/crypto.db"
+  log "db: cp -> $DEST/crypto.db (sqlite3 not installed)"
+fi
+
+if [[ -d "$UPLOAD_DIR" ]]; then
+  tar -czf "$DEST/static_images.tar.gz" -C "$(dirname "$UPLOAD_DIR")" "$(basename "$UPLOAD_DIR")"
+  log "images: $UPLOAD_DIR -> $DEST/static_images.tar.gz"
+else
+  log "warn: upload dir missing, skip images: $UPLOAD_DIR"
+fi
+
+{
+  echo "instance=$INSTANCE_NAME"
+  echo "project_dir=$PROJECT_DIR"
+  echo "backup_date=$DATE_TAG"
+  echo "db_path=$DB_PATH"
+  echo "upload_dir=$UPLOAD_DIR"
+} >"$DEST/manifest.txt"
+
+prune_old_backups
+log "done"

crypto_monitor_binance/scripts/fix_breakeven_labels.py

@@ -0,0 +1,108 @@
+#!/usr/bin/env python3
+"""
+一次性修复历史交易记录标签:
+将 trade_records 里“止损但实际盈利”的记录改为“保本止盈”.
+
+默认条件(可通过参数修改):
+- monitor_type = 下单监控
+- result = 止损
+- pnl_amount > 0
+
+用法示例:
+1) 仅预览(不落库):
+   python scripts/fix_breakeven_labels.py --db ./crypto.db --dry-run
+
+2) 执行修复:
+   python scripts/fix_breakeven_labels.py --db ./crypto.db --apply
+"""
+
+from __future__ import annotations
+
+import argparse
+import sqlite3
+import sys
+from pathlib import Path
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description="Fix historical stop-loss records with positive pnl.")
+    parser.add_argument("--db", required=True, help="Path to sqlite db file, e.g. ./crypto.db")
+    parser.add_argument("--monitor-type", default="下单监控", help="Filter by monitor_type (default: 下单监控)")
+    parser.add_argument("--from-result", default="止损", help="Source result label (default: 止损)")
+    parser.add_argument("--to-result", default="保本止盈", help="Target result label (default: 保本止盈)")
+    parser.add_argument("--dry-run", action="store_true", help="Preview only, no write")
+    parser.add_argument("--apply", action="store_true", help="Execute update")
+    return parser.parse_args()
+
+
+def main() -> int:
+    args = parse_args()
+    db_path = Path(args.db).expanduser().resolve()
+    if not db_path.exists():
+        print(f"[ERR] DB not found: {db_path}")
+        return 1
+
+    if args.dry_run and args.apply:
+        print("[ERR] --dry-run and --apply are mutually exclusive.")
+        return 1
+    if not args.dry_run and not args.apply:
+        print("[INFO] No mode provided, defaulting to --dry-run.")
+        args.dry_run = True
+
+    conn = sqlite3.connect(str(db_path))
+    conn.row_factory = sqlite3.Row
+    cur = conn.cursor()
+
+    where_sql = """
+        monitor_type = ?
+        AND result = ?
+        AND CAST(COALESCE(pnl_amount, 0) AS REAL) > 0
+    """
+    params = (args.monitor_type, args.from_result)
+
+    cur.execute(f"SELECT COUNT(*) AS c FROM trade_records WHERE {where_sql}", params)
+    will_change = int(cur.fetchone()["c"])
+    print(f"[INFO] Candidate rows: {will_change}")
+
+    if will_change == 0:
+        print("[INFO] Nothing to update.")
+        conn.close()
+        return 0
+
+    cur.execute(
+        f"""
+        SELECT id, symbol, result, pnl_amount, closed_at
+        FROM trade_records
+        WHERE {where_sql}
+        ORDER BY id DESC
+        LIMIT 10
+        """,
+        params,
+    )
+    sample = cur.fetchall()
+    print("[INFO] Sample (latest 10):")
+    for r in sample:
+        print(
+            f"  id={r['id']} symbol={r['symbol']} result={r['result']} "
+            f"pnl={r['pnl_amount']} closed_at={r['closed_at']}"
+        )
+
+    if args.dry_run:
+        print("[DRY-RUN] No write executed.")
+        conn.close()
+        return 0
+
+    cur.execute(
+        f"UPDATE trade_records SET result=? WHERE {where_sql}",
+        (args.to_result, *params),
+    )
+    changed = int(cur.rowcount)
+    conn.commit()
+    conn.close()
+    print(f"[DONE] Updated rows: {changed}")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())
+

crypto_monitor_binance/scripts/install_backup_cron.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# Install daily backup cron: Beijing 00:00 (CRON_TZ=Asia/Shanghai).
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+BACKUP_SCRIPT="$SCRIPT_DIR/backup_data.sh"
+INSTANCE_NAME="${BACKUP_INSTANCE:-$(basename "$PROJECT_DIR")}"
+LOG_FILE="${BACKUP_CRON_LOG:-/var/log/crypto-monitor-backup-${INSTANCE_NAME}.log}"
+if [[ ! -x "$BACKUP_SCRIPT" ]]; then
+  chmod +x "$BACKUP_SCRIPT"
+fi
+
+TMP="$(mktemp)"
+trap 'rm -f "$TMP"' EXIT
+
+{
+  crontab -l 2>/dev/null | grep -vF "$BACKUP_SCRIPT" || true
+  echo "CRON_TZ=Asia/Shanghai"
+  echo "0 0 * * * $BACKUP_SCRIPT >> $LOG_FILE 2>&1"
+} >"$TMP"
+
+# Keep a single CRON_TZ line at top.
+awk '
+  BEGIN { tz = 0 }
+  /^CRON_TZ=Asia\/Shanghai$/ {
+    if (tz++) next
+  }
+  { print }
+' "$TMP" >"${TMP}.2"
+mv "${TMP}.2" "$TMP"
+
+crontab "$TMP"
+echo "Installed cron for $INSTANCE_NAME"
+echo "  Schedule : daily 00:00 Asia/Shanghai"
+echo "  Script   : $BACKUP_SCRIPT"
+echo "  Log      : $LOG_FILE"
+crontab -l | grep -F "$BACKUP_SCRIPT" || true

crypto_monitor_binance/scripts/patch_index_layout.py

@@ -0,0 +1,358 @@
+# -*- coding: utf-8 -*-
+"""Patch index.html layout for key_monitor / trade split."""
+from pathlib import Path
+import re
+
+TAG = "div"
+
+PATHS = [
+    Path(__file__).resolve().parent.parent / "templates" / "index.html",
+    Path(r"c:\Users\dekun\Desktop\crypto_monitor\crypto_monitor_gate\templates\index.html"),
+]
+
+KEY_START = "        {% if page == 'key_monitor' %}"
+KEY_START_ALT = "        {% if page == 'trade' %}"
+RECORDS_START = "        {% if page == 'records' %}"
+
+
+def build_section(order_loop: str) -> str:
+    t = TAG
+    return f"""        {{% if page == 'key_monitor' %}}
+        <{t} class="dual-panel-grid" style="grid-column:1/-1">
+        <{t} class="card">
+            <{t} style="display:flex;align-items:center;justify-content:space-between;gap:8px;flex-wrap:wrap;margin-bottom:8px">
+                <h2 style="margin-bottom:0">关键位监控</h2>
+                {{% if focus_key_id %}}
+                <a href="/key_focus?key_id={{{{ focus_key_id }}}}" class="btn-del" style="text-decoration:none;background:#1f3a5a;color:#8fc8ff">放大查看K线(默认200根)</a>
+                {{% else %}}
+                <a href="/key_focus" class="btn-del" style="text-decoration:none;background:#1f3a5a;color:#8fc8ff">输入币种查看K线</a>
+                {{% endif %}}
+            </{t}>
+            <form id="key-form" action="/add_key" method="post" class="form-row">
+                <input name="symbol" placeholder="BTC 或 BTC/USDT" required>
+                <select name="type" required>
+                    <option value="箱体突破">箱体突破</option>
+                    <option value="收敛突破">收敛突破</option>
+                    <option value="关键阻力位">关键阻力位</option>
+                    <option value="关键支撑位">关键支撑位</option>
+                </select>
+                <select name="direction" required>
+                    <option value="">方向</option><option value="long">做多</option><option value="short">做空</option>
+                </select>
+                <input name="upper" step="0.0001" placeholder="上沿/阻力" required>
+                <input name="lower" step="0.0001" placeholder="下沿/支撑" required>
+                <button type="submit">添加</button>
+            </form>
+            <{t} class="rule-tip">{{{{ key_gate_rule_text }}}}</{t}>
+            <{t} class="panel-scroll pos-list">
+                {{% for k in key %}}
+                <{t} class="pos-card" id="key-row-{{{{ k.id }}}}">
+                    <{t} class="pos-card-head">
+                        <{t} class="pos-card-symbol">
+                            <strong>{{{{ k.symbol }}}}</strong>
+                            <span class="pos-side-badge {{{{ 'pos-side-long' if k.direction == 'long' else 'pos-side-short' }}}}">{{{{ '做多' if k.direction == 'long' else '做空' }}}}</span>
+                            <span class="badge direction" style="margin-left:4px">{{{{ k.monitor_type }}}}</span>
+                        </{t}>
+                        <button type="button" class="pos-close-btn" style="border:none;cursor:pointer" onclick="deleteKeyMonitor({{{{ k.id }}}})">删</button>
+                    </{t}>
+                    <{t} class="pos-meta">
+                        <span class="pos-meta-item">上沿: {{{{ k.upper }}}}</span>
+                        <span class="pos-meta-item">下沿: {{{{ k.lower }}}}</span>
+                        <span class="pos-meta-item">已提醒: {{{{ k.notification_count or 0 }}}}/{{{{ k.max_notify or 3 }}}}</span>
+                    </{t}>
+                    <{t} class="pos-grid">
+                        <{t} class="pos-cell"><span class="pos-label">现价</span><span class="pos-value" id="key-price-{{{{ k.id }}}}">-</span></{t}>
+                        <{t} class="pos-cell"><span class="pos-label">距上沿</span><span class="pos-value" id="key-up-diff-{{{{ k.id }}}}">-</span></{t}>
+                        <{t} class="pos-cell"><span class="pos-label">距下沿</span><span class="pos-value" id="key-low-diff-{{{{ k.id }}}}">-</span></{t}>
+                        <{t} class="pos-cell"><span class="pos-label">门控</span><span class="pos-value" id="key-gate-{{{{ k.id }}}}" style="color:#9aa">-</span></{t}>
+                    </{t}>
+                    <{t} class="pos-meta" style="margin-top:8px"><span class="pos-meta-item" id="key-gate-metrics-{{{{ k.id }}}}" style="color:#8fc8ff"></span></{t}>
+                </{t}>
+                {{% else %}}
+                <{t} class="pos-empty">暂无监控中的关键位</{t}>
+                {{% endfor %}}
+            </{t}>
+        </{t}>
+        <{t} class="card">
+            <h2 style="margin-bottom:8px">关键位历史</h2>
+            <{t} class="sub" style="font-size:.72rem;color:#8892b0;margin-bottom:8px">失效或已结案的关键位</{t}>
+            <{t} class="panel-scroll pos-list">
+                {{% for h in key_history %}}
+                <{t} class="pos-card">
+                    <{t} class="pos-card-head">
+                        <{t} class="pos-card-symbol">
+                            <strong>{{{{ h.symbol }}}}</strong>
+                            <span class="pos-side-badge {{{{ 'pos-side-long' if h.direction == 'long' else 'pos-side-short' }}}}">{{{{ '做多' if h.direction == 'long' else '做空' }}}}</span>
+                        </{t}>
+                        <button type="button" class="table-del" onclick="deleteKeyHistory({{{{ h.id }}}})">删除</button>
+                    </{t}>
+                    <{t} class="pos-meta">
+                        <span class="pos-meta-item">{{{{ h.monitor_type }}}}</span>
+                        <span class="pos-meta-item">{{{{ h.close_reason }}}}</span>
+                        <span class="pos-meta-item">{{{{ (h.closed_at or '-')[:16] }}}}</span>
+                    </{t}>
+                    <{t} class="pos-meta">
+                        <span class="pos-meta-item">上: {{{{ h.upper }}}} 下: {{{{ h.lower }}}}</span>
+                        <span class="pos-meta-item">提醒: {{{{ h.notification_count }}}}</span>
+                    </{t}>
+                    {{% if h.last_alert_message %}}<{t} style="font-size:.75rem;color:#aab;margin-top:6px;white-space:pre-wrap">{{{{ h.last_alert_message[:180] }}}}{{% if h.last_alert_message|length > 180 %}}…{{% endif %}}</{t}>{{% endif %}}
+                </{t}>
+                {{% else %}}
+                <{t} class="pos-empty">暂无历史</{t}>
+                {{% endfor %}}
+            </{t}>
+        </{t}>
+        </{t}>
+        {{% elif page == 'trade' %}}
+        <{t} class="dual-panel-grid" style="grid-column:1/-1">
+        <{t} class="card">
+            <{t} style="display:flex;align-items:center;justify-content:space-between;gap:8px;flex-wrap:wrap;margin-bottom:8px">
+                <h2 style="margin-bottom:0">实盘下单监控</h2>
+                {{% if focus_order_id %}}
+                <a href="/order_focus?order_id={{{{ focus_order_id }}}}" class="btn-del" style="text-decoration:none;background:#1f3a5a;color:#8fc8ff">放大查看K线(100根)</a>
+                {{% else %}}
+                <span class="btn-del" style="background:#2f2f44;color:#9aa;cursor:not-allowed">暂无持仓可放大</span>
+                {{% endif %}}
+            </{t}>
+            <{t} class="rule-tip" id="order-rule-tip">
+                规则:最多 {{{{ max_active_positions }}}} 仓;BTC {{{{ btc_leverage }}}}x / 山寨 {{{{ alt_leverage }}}}x;
+                {{% if can_trade %}}可开仓{{% else %}}不可开仓(持仓已满或未到北京时间 {{{{ reset_hour }}}}:00){{% endif %}};
+                人工开仓盈亏比不得低于 {{{{ manual_min_planned_rr }}}}:1
+            </{t}>
+            <{t} class="rule-tip">
+                以损定仓:风险 {{{{ risk_percent }}}}% ｜移动保本:下单可勾选关闭;开启时 {{{{ breakeven_rr_trigger }}}}R 触发(每 1R 阶梯上移),偏移 {{{{ breakeven_offset_pct }}}}%
+            </{t}>
+            <{t} class="rule-tip">
+                划转:自动划转 {{{{ '开启' if auto_transfer_enabled else '关闭' }}}}(每天<strong>北京时间 {{{{ auto_transfer_bj_hour }}}}:00</strong>起该整点小时内尝试;账簿按 <strong>UTC 自然日</strong>去重;界面时间为北京;将 {{{{ auto_transfer_to }}}} 补足到 {{{{ auto_transfer_amount }}}}U,来自 {{{{ auto_transfer_from }}}})
+            </{t}>
+            <form action="/manual_transfer" method="post" class="form-row">
+                <input name="amount" type="number" min="0.01" step="0.01" placeholder="手动划转金额U" required>
+                <select name="from_account">
+                    <option value="funding" {{% if auto_transfer_from == 'funding' %}}selected{{% endif %}}>from: funding</option>
+                    <option value="swap" {{% if auto_transfer_from == 'swap' %}}selected{{% endif %}}>from: swap</option>
+                    <option value="spot" {{% if auto_transfer_from == 'spot' %}}selected{{% endif %}}>from: spot</option>
+                </select>
+                <select name="to_account">
+                    <option value="swap" {{% if auto_transfer_to == 'swap' %}}selected{{% endif %}}>to: swap</option>
+                    <option value="funding" {{% if auto_transfer_to == 'funding' %}}selected{{% endif %}}>to: funding</option>
+                    <option value="spot" {{% if auto_transfer_to == 'spot' %}}selected{{% endif %}}>to: spot</option>
+                </select>
+                <button type="submit">手动划转</button>
+            </form>
+            <form id="add-order-form" action="/add_order" method="post" class="form-row">
+                <input id="order-symbol" name="symbol" placeholder="BTC 或 BTC/USDT" required>
+                <select id="order-direction" name="direction" required>
+                    <option value="">方向</option><option value="long">做多</option><option value="short">做空</option>
+                </select>
+                <select id="sltp-mode" name="sltp_mode">
+                    <option value="price">止盈止损:价格模式</option>
+                    <option value="pct">止盈止损:百分比模式</option>
+                </select>
+                <select name="trade_style" required>
+                    <option value="trend">趋势单</option>
+                    <option value="swing">波段单</option>
+                </select>
+                <input id="order-leverage" name="leverage" type="number" min="1" step="1" placeholder="杠杆(可选)">
+                <label style="display:flex;align-items:center;gap:4px;font-size:.82rem;color:#cfd3ef">
+                    <input type="checkbox" name="breakeven_enabled" value="1" checked> 启用移动保本(关闭则仅保留初始止损与交易所挂单)
+                </label>
+                <label style="display:flex;align-items:center;gap:4px;font-size:.82rem;color:#cfd3ef">
+                    <input type="checkbox" name="order_chart" value="true"> 开仓后生成多周期K线图(各周期100根,含开平仓标记)
+                </label>
+                <span style="display:flex;align-items:center;padding:0 10px;font-size:.8rem;color:#8fc8ff">成交价自动取交易所实时+成交回报</span>
+                <input id="order-sl" name="sl" step="any" placeholder="止损价格" required>
+                <input id="order-tp" name="tgt" step="any" placeholder="止盈价格" required>
+                <input id="order-sl-pct" name="sl_pct" type="number" min="0.01" step="0.01" placeholder="止损%" style="display:none">
+                <input id="order-tp-pct" name="tp_pct" type="number" min="0.01" step="0.01" placeholder="止盈%" style="display:none">
+                <button type="submit">开仓(以损定仓)</button>
+            </form>
+        </{t}>
+        <{t} class="card">
+            <h2 style="margin-bottom:8px">实时持仓</h2>
+            <{t} class="panel-scroll pos-list">
+                {order_loop}
+            </{t}>
+        </{t}>
+        </{t}>
+        {{% endif %}}
+
+"""
+
+
+def patch_nav(text: str) -> str:
+    old = '<a href="/trade" class="{% if page == \'trade\' %}active{% endif %}">交易执行</a>'
+    new = (
+        '<a href="/key_monitor" class="{% if page == \'key_monitor\' %}active{% endif %}">关键位监控</a>\n'
+        '        <a href="/trade" class="{% if page == \'trade\' %}active{% endif %}">实盘下单</a>'
+    )
+    if "关键位监控" not in text:
+        text = text.replace(old, new)
+    return text
+
+
+def patch_js(text: str) -> str:
+  # page id on body
+    if 'id="page-trade"' not in text:
+        text = text.replace("<body>", '<body data-page="{{ page }}">', 1)
+    if "MANUAL_MIN_PLANNED_RR" not in text:
+        insert = """
+const MANUAL_MIN_PLANNED_RR = {{ manual_min_planned_rr }};
+function calcClientRr(direction, entry, sl, tp){
+    const e = Number(entry), s = Number(sl), t = Number(tp);
+    if(!Number.isFinite(e) || !Number.isFinite(s) || !Number.isFinite(t)) return null;
+    if(direction === 'short'){
+        if(s <= e || t >= e) return null;
+        return (e - t) / (s - e);
+    }
+    if(s >= e || t <= e) return null;
+    return (t - e) / (e - s);
+}
+"""
+        text = text.replace("let latestAvailableUsdt = null;", insert + "\nlet latestAvailableUsdt = null;")
+    if "add-order-form" not in text or "calcClientRr" in text and "addOrderForm" not in text:
+        hook = """
+const addOrderForm = document.getElementById("add-order-form");
+if(addOrderForm){
+    addOrderForm.addEventListener("submit", function(ev){
+        const direction = (document.getElementById("order-direction")||{}).value || "long";
+        const mode = (document.getElementById("sltp-mode")||{}).value || "price";
+        let sl, tp, entry;
+        if(mode === "pct"){
+            alert("百分比模式请确认盈亏比后再提交;建议使用价格模式以便校验.");
+            return;
+        }
+        sl = Number((document.getElementById("order-sl")||{}).value);
+        tp = Number((document.getElementById("order-tp")||{}).value);
+        entry = sl;
+        fetch(`/api/order_defaults?symbol=${encodeURIComponent((document.getElementById("order-symbol")||{}).value||"")}&direction=${encodeURIComponent(direction)}`)
+            .then(r=>r.json())
+            .then(data=>{
+                const px = data.last_price || data.price;
+                if(px) entry = Number(px);
+                const rr = calcClientRr(direction, entry, sl, tp);
+                if(rr === null || rr < MANUAL_MIN_PLANNED_RR){
+                    alert(`计划盈亏比 ${rr === null ? '无效' : rr.toFixed(2)}:1 低于最低要求 ${MANUAL_MIN_PLANNED_RR}:1,已阻止人工下单.`);
+                    return;
+                }
+                addOrderForm.submit();
+            })
+            .catch(()=>{ ev.preventDefault(); alert("无法校验盈亏比,请稍后重试"); });
+        ev.preventDefault();
+    });
+}
+"""
+        text = text.replace("refreshOrderDefaults();", hook + "\nrefreshOrderDefaults();")
+    if "max_active_positions" not in text and "order-rule-tip" in text:
+        text = text.replace(
+            "规则:单仓;",
+            "规则:最多 {{ max_active_positions }} 仓;",
+        )
+    # account snapshot tip
+    old_tip = '`规则:单仓;BTC {{ btc_leverage }}x'
+    if old_tip in text:
+        text = text.replace(
+            old_tip,
+            "`规则:最多 ${data.max_active_positions || {{ max_active_positions }}} 仓;BTC {{ btc_leverage }}x",
+        )
+    text = text.replace(
+        'const canTradeText = data.can_trade ? "可开仓" : "不可开仓(有持仓或未到北京时间 {{ reset_hour }}:00)";',
+        'const canTradeText = data.can_trade ? "可开仓" : `不可开仓(持仓 ${data.active_count||0}/${data.max_active_positions||{{ max_active_positions }}} 或未到北京时间 {{ reset_hour }}:00)`;',
+    )
+    text = text.replace(
+        "if(!data.in_top30){",
+        "const rankMax = data.rank_max || 30;\n                if(!data.in_top30){",
+    )
+    text = text.replace(
+        "不在前30,已拦截",
+        "不在前${rankMax},已拦截",
+    )
+    # conditional price refresh
+    if "data-page" in text and "refreshPriceSnapshotConditional" not in text:
+        text = text.replace(
+            "setInterval(refreshPriceSnapshot, {{ price_refresh_seconds * 1000 }});",
+            """function refreshPriceSnapshotConditional(){
+    const page = document.body.getAttribute("data-page") || "";
+    fetch("/api/price_snapshot").then(r=>r.json()).then(data=>{
+        const updatedEl = document.getElementById("price-last-updated");
+        if(data.updated_at && updatedEl) updatedEl.innerText = data.updated_at;
+        if(page === "key_monitor"){
+            (data.key_prices || []).forEach(k=>{
+                const pEl = document.getElementById(`key-price-${k.id}`);
+                if(pEl){ pEl.innerText = k.price_display || (Number.isFinite(Number(k.price)) ? Number(k.price).toFixed(6) : "-"); paintPriceTrend(pEl, `k-${k.id}`, Number(k.price)); }
+                const upEl = document.getElementById(`key-up-diff-${k.id}`);
+                if(upEl) upEl.innerText = `${formatSigned(k.upper_diff, 4)} (${formatSigned(k.upper_pct, 2)}%)`;
+                const lowEl = document.getElementById(`key-low-diff-${k.id}`);
+                if(lowEl) lowEl.innerText = `${formatSigned(k.lower_diff, 4)} (${formatSigned(k.lower_pct, 2)}%)`;
+                const gateEl = document.getElementById(`key-gate-${k.id}`);
+                if(gateEl){ gateEl.innerText = k.gate_summary || "-"; gateEl.style.color = k.gate_ok ? "#4cd97f" : "#ff8f8f"; }
+                const gateMetricEl = document.getElementById(`key-gate-metrics-${k.id}`);
+                if(gateMetricEl) gateMetricEl.innerText = k.gate_metrics || "";
+            });
+        }
+        if(page === "trade"){
+            (data.order_prices || []).forEach(o=>{
+                const pEl = document.getElementById(`order-price-${o.id}`);
+                if(pEl){
+                    const hasMark = (()=>{ const x = o.exchange_mark_price; if(x===null||x===undefined||x==="")return false; const n=Number(x); return !Number.isNaN(n); })();
+                    let disp = "";
+                    if(hasMark && o.exchange_mark_price_display) disp = o.exchange_mark_price_display;
+                    else if(o.price_display) disp = o.price_display;
+                    else { const px = hasMark ? Number(o.exchange_mark_price) : Number(o.price); disp = Number.isFinite(px) ? px.toFixed(6) : "-"; }
+                    pEl.innerText = disp;
+                    const pxNum = hasMark ? Number(o.exchange_mark_price) : Number(o.price);
+                    paintPriceTrend(pEl, `o-${o.id}`, Number.isFinite(pxNum) ? pxNum : px);
+                }
+                const exM = document.getElementById(`order-ex-margin-${o.id}`);
+                if(exM){
+                    const mv = o.exchange_initial_margin;
+                    const mn = (mv === null || mv === undefined || mv === "") ? NaN : Number(mv);
+                    if(!Number.isNaN(mn)) exM.innerText = `${mn.toFixed(2)}U`;
+                    else { const prc = (typeof data.positions_raw_count === "number") ? data.positions_raw_count : null; exM.innerText = (prc === 0) ? "无仓数据" : "-"; }
+                }
+                const pnlEl = document.getElementById(`order-pnl-${o.id}`);
+                if(pnlEl){
+                    pnlEl.innerText = `${formatSigned(o.float_pnl, 2)}U (${formatSigned(o.float_pct, 2)}%)`;
+                    pnlEl.classList.remove("price-up","price-down","price-flat");
+                    if(Number(o.float_pnl) > 0) pnlEl.classList.add("price-up");
+                    else if(Number(o.float_pnl) < 0) pnlEl.classList.add("price-down");
+                    else pnlEl.classList.add("price-flat");
+                }
+                const rrEl = document.getElementById(`order-rr-${o.id}`);
+                if(rrEl) rrEl.innerText = formatRrRatio(o.rr_ratio);
+            });
+        }
+    }).catch(()=>{});
+}
+setInterval(refreshPriceSnapshotConditional, {{ price_refresh_seconds * 1000 }});""",
+        )
+    return text
+
+
+def main():
+    for path in PATHS:
+        if not path.exists():
+            print("skip", path)
+            continue
+        text = path.read_text(encoding="utf-8")
+        start = text.find(KEY_START)
+        if start < 0:
+            start = text.find(KEY_START_ALT)
+        end = text.find(RECORDS_START)
+        if start < 0 or end < 0:
+            raise SystemExit(f"markers not found: {path}")
+        old = text[start:end]
+        m = re.search(r"(\{% for o in order %\}.*?\{% endfor %\})", old, re.S)
+        if not m:
+            raise SystemExit(f"order loop not found: {path}")
+        order_loop = m.group(1)
+        section = build_section(order_loop)
+        section = section.replace("{{%", "{%").replace("%}}", "%}").replace("{{{{", "{{").replace("}}}}", "}}")
+        out = text[:start] + section + "\n\n" + text[end:]
+        out = patch_nav(out)
+        out = patch_js(out)
+        path.write_text(out, encoding="utf-8")
+        print("patched", path)
+
+
+if __name__ == "__main__":
+    main()

crypto_monitor_binance/scripts/sync_gate_app.py

@@ -0,0 +1,116 @@
+# -*- coding: utf-8 -*-
+"""Apply binance app.py risk/layout changes to gate app.py (pattern replace)."""
+from pathlib import Path
+
+binance = Path(__file__).resolve().parent.parent / "app.py"
+gate = Path(r"c:\Users\dekun\Desktop\crypto_monitor\crypto_monitor_gate\app.py")
+
+b = binance.read_text(encoding="utf-8")
+g = gate.read_text(encoding="utf-8")
+
+# 1) env block
+old_env = """KEY_BREAKOUT_LIMIT_PCT = float(os.getenv("KEY_BREAKOUT_LIMIT_PCT", "1.5"))
+KEY_AUTO_MIN_PLANNED_RR = float(os.getenv("KEY_AUTO_MIN_PLANNED_RR", "1.5"))
+KEY_STOP_OUTSIDE_BREAKOUT_PCT = float(os.getenv("KEY_STOP_OUTSIDE_BREAKOUT_PCT", "0.5"))"""
+
+new_env = """KEY_AUTO_MIN_PLANNED_RR = float(os.getenv("KEY_AUTO_MIN_PLANNED_RR", "1.5"))
+KEY_STOP_OUTSIDE_BREAKOUT_PCT = float(os.getenv("KEY_STOP_OUTSIDE_BREAKOUT_PCT", "0.5"))
+MANUAL_MIN_PLANNED_RR = float(os.getenv("MANUAL_MIN_PLANNED_RR", "1.4"))
+MAX_ACTIVE_POSITIONS = max(1, int(os.getenv("MAX_ACTIVE_POSITIONS", "1")))
+KEY_VOLUME_MA_BARS = max(1, int(os.getenv("KEY_VOLUME_MA_BARS", "20")))
+KEY_VOLUME_RATIO_MIN = float(os.getenv("KEY_VOLUME_RATIO_MIN", "1.3"))
+KEY_BREAKOUT_AMP_MIN_PCT = float(os.getenv("KEY_BREAKOUT_AMP_MIN_PCT", "0.03"))
+KEY_BREAKOUT_AMP_MAX_PCT = float(os.getenv("KEY_BREAKOUT_AMP_MAX_PCT", "0.5"))
+KEY_DAILY_VOLUME_RANK_MAX = max(1, int(os.getenv("KEY_DAILY_VOLUME_RANK_MAX", "30")))
+KEY_CONFIRM_BREAKOUT_BAR = int(os.getenv("KEY_CONFIRM_BREAKOUT_BAR", "-2"))
+KEY_CONFIRM_BAR = int(os.getenv("KEY_CONFIRM_BAR", "-1"))
+KEY_SIZING_USE_ZERO_POSITION_SNAPSHOT = os.getenv("KEY_SIZING_USE_ZERO_POSITION_SNAPSHOT", "true").lower() == "true")"""
+
+if old_env in g:
+    g = g.replace(old_env, new_env)
+
+# 2) DB migration snippet
+snip = """    try:
+        c.execute("ALTER TABLE trading_sessions ADD COLUMN key_sizing_capital_snapshot REAL")
+    except Exception:
+        pass
+
+    c.execute("""
+if snip not in g and 'key_sizing_capital_snapshot' not in g:
+    g = g.replace(
+        '    c.execute(\n        """CREATE TABLE IF NOT EXISTS key_monitor_history',
+        """    try:
+        c.execute("ALTER TABLE trading_sessions ADD COLUMN key_sizing_capital_snapshot REAL")
+    except Exception:
+        pass
+
+    c.execute(
+        \"\"\"CREATE TABLE IF NOT EXISTS key_monitor_history""",
+        1,
+    )
+
+# 3) precheck block - extract from binance
+import re
+m = re.search(
+    r"def get_active_position_count\(conn\):.*?return True, \"\"\n\n\ndef prepare_order_amount",
+    b,
+    re.S,
+)
+if m and "get_active_position_count" not in g:
+    g = g.replace(
+        "def precheck_risk(conn, symbol, direction):\n    now = app_now()\n    if not trading_day_reset_allows_new_open(now):\n        return False, f\"北京时间 {TRADING_DAY_RESET_HOUR}:00 前不允许持仓\"\n    active_count = conn.execute(\"SELECT COUNT(*) FROM order_monitors WHERE status='active'\").fetchone()[0]\n    if active_count > 0:\n        return False, \"一次只能持有一个仓位\"\n    if direction not in (\"long\", \"short\"):\n        return False, \"方向必须为 long 或 short\"\n    if symbol.upper().startswith(\"BTC\") or symbol.upper().startswith(\"ETH\"):\n        expected = BTC_LEVERAGE\n    else:\n        expected = ALT_LEVERAGE\n    if expected <= 0:\n        return False, \"杠杆配置异常\"\n    return True, \"\"\n\n\ndef prepare_order_amount",
+        m.group(0),
+    )
+
+# 4) render_main_page can_trade + template vars + route
+if "key_monitor_page" not in g:
+    g = g.replace(
+        "    can_trade = trading_day_reset_allows_new_open(now) and active_count == 0\n    conn.close()\n    return render_template(",
+        """    can_trade = trading_day_reset_allows_new_open(now) and active_count < MAX_ACTIVE_POSITIONS
+    key_gate_rule_text = (
+        f"周期 {KLINE_TIMEFRAME}｜确认K:突破棒偏移 {KEY_CONFIRM_BREAKOUT_BAR},确认棒偏移 {KEY_CONFIRM_BAR}｜"
+        f"量能:突破量 > 前{KEY_VOLUME_MA_BARS}均量×{KEY_VOLUME_RATIO_MIN}｜"
+        f"自动开仓盈亏比 > {KEY_AUTO_MIN_PLANNED_RR}:1｜日成交量排名前 {KEY_DAILY_VOLUME_RANK_MAX}"
+    )
+    conn.close()
+    return render_template(""",
+    )
+    g = g.replace(
+        "        exchange_display=EXCHANGE_DISPLAY_NAME,\n    )\n\n\n@app.route(\"/\")\n@login_required\ndef index():\n    return redirect(\"/trade\")\n\n\n@app.route(\"/trade\")",
+        """        exchange_display=EXCHANGE_DISPLAY_NAME,
+        max_active_positions=MAX_ACTIVE_POSITIONS,
+        manual_min_planned_rr=MANUAL_MIN_PLANNED_RR,
+        key_auto_min_planned_rr=KEY_AUTO_MIN_PLANNED_RR,
+        key_gate_rule_text=key_gate_rule_text,
+        kline_timeframe=KLINE_TIMEFRAME,
+    )
+
+
+@app.route("/")
+@login_required
+def index():
+    return redirect("/trade")
+
+
+@app.route("/key_monitor")
+@login_required
+def key_monitor_page():
+    return render_main_page("key_monitor")
+
+
+@app.route("/trade")""",
+    )
+
+# api account
+g = g.replace(
+    "    active_count = conn.execute(\"SELECT COUNT(*) FROM order_monitors WHERE status='active'\").fetchone()[0]\n    conn.close()\n    can_trade = trading_day_reset_allows_new_open(now) and active_count == 0",
+    "    active_count = get_active_position_count(conn)\n    conn.close()\n    can_trade = trading_day_reset_allows_new_open(now) and active_count < MAX_ACTIVE_POSITIONS",
+)
+if '"max_active_positions"' not in g:
+    g = g.replace(
+        '"can_trade": can_trade,\n        "trading_day": trading_day\n    })',
+        '"can_trade": can_trade,\n        "max_active_positions": MAX_ACTIVE_POSITIONS,\n        "manual_min_planned_rr": MANUAL_MIN_PLANNED_RR,\n        "trading_day": trading_day\n    })',
+    )
+
+gate.write_text(g, encoding="utf-8")
+print("gate app partially synced; manual review _key_hard_checks add_order still needed")

crypto_monitor_binance/scripts/verify_binance_funding.py

@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""
+  python scripts/verify_binance_funding.py
+
+打印 BINANCE_API_KEY 前 8 位便于与 Binance 控制台核对(不含 Secret).用于服务器自检.
+对比 App:资产 → 资金账户(Funding) / 现货账户(Spot) / U本位合约.
+"""
+import os
+import sys
+
+BASE = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+sys.path.insert(0, BASE)
+
+
+def load_env(path):
+    if not os.path.exists(path):
+        return
+    for line in open(path, "r", encoding="utf-8", errors="ignore"):
+        line = line.strip()
+        if not line or line.startswith("#") or "=" not in line:
+            continue
+        k, v = line.split("=", 1)
+        k = k.strip().lstrip("\ufeff")
+        if k.replace("_", "").isalnum():
+            os.environ[k] = v.strip().strip('"').strip("'")
+
+
+def main():
+    load_env(os.path.join(BASE, ".env"))
+    k = (os.getenv("BINANCE_API_KEY") or "").strip()
+    s = (os.getenv("BINANCE_API_SECRET") or "").strip()
+    if not k or "REPLACE" in k.upper():
+        print("WARN: BINANCE_API_KEY 为空或仍像占位符,请核对 .env")
+    if not s or "REPLACE" in s.upper():
+        print("WARN: BINANCE_API_SECRET 为空或仍像占位符,请核对 .env")
+    print("BINANCE_API_KEY prefix (8 chars):", (k[:8] + "…") if len(k) > 8 else "(short)")
+    print("BINANCE_FUNDING_INCLUDE_SPOT:", os.getenv("BINANCE_FUNDING_INCLUDE_SPOT", "false"))
+
+    import app as mod  # noqa: E402
+
+    mod.ensure_markets_loaded()
+    ccy = getattr(mod, "TRANSFER_CCY", "USDT")
+
+    try:
+        raw = mod.exchange.sapiGetAssetWalletBalance({"quoteAsset": ccy})
+        print(f"\n>>> sapi/v1/asset/wallet/balance (quoteAsset={ccy}):")
+        if isinstance(raw, list):
+            for row in raw:
+                if isinstance(row, dict):
+                    print(
+                        "   ",
+                        row.get("walletName"),
+                        "activate=",
+                        row.get("activate"),
+                        "balance=",
+                        row.get("balance"),
+                    )
+        else:
+            print("   ", raw)
+    except Exception as e:
+        print(">>> wallet/balance error:", e)
+
+    try:
+        raw = mod.exchange.sapiPostAssetGetFundingAsset({"asset": ccy})
+        print(f"\n>>> get-funding-asset (asset={ccy}):", raw)
+    except Exception as e:
+        print(">>> get-funding-asset error:", e)
+
+    fu = mod._fetch_binance_funding_usdt()
+    print("\n>>> _fetch_binance_funding_usdt() (页顶资金账户) =", fu)
+    try:
+        fw = mod._fetch_binance_funding_usdt_from_wallet_overview()
+        print(">>> _fetch_binance_funding_usdt_from_wallet_overview() =", fw)
+        sp = mod._fetch_binance_spot_usdt_total()
+        print(">>> _fetch_binance_spot_usdt_total() =", sp)
+        sw = mod._fetch_binance_swap_usdt_total()
+        print(">>> _fetch_binance_swap_usdt_total() (合约账户) =", sw)
+        sf = mod._fetch_binance_swap_usdt_free()
+        print(">>> _fetch_binance_swap_usdt_free() (合约可用) =", sf)
+    except Exception as e:
+        print(">>> balance fetch error:", e)
+
+
+if __name__ == "__main__":
+    main()

crypto_monitor_binance/static/icons/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <rect width="512" height="512" rx="108" fill="#0c1019"/>
+  <rect x="36" y="36" width="440" height="440" rx="88" fill="#141b2d"/>
+  <rect x="36" y="36" width="440" height="440" rx="88" fill="none" stroke="#F0B90B" stroke-width="12"/>
+  <polygon points="256,150 362,256 256,362 150,256" fill="#F0B90B"/><polygon points="256,210 302,256 256,302 210,256" fill="#1a160a"/>
+</svg>

crypto_monitor_binance/static/icons/manifest.webmanifest

@@ -0,0 +1,23 @@
+{
+  "name": "Binance 交易系统",
+  "short_name": "Binance 交易系统",
+  "description": "Binance 永续交易监控与复盘",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#0b0d14",
+  "theme_color": "#F0B90B",
+  "icons": [
+    {
+      "src": "/static/icons/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "/static/icons/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any maskable"
+    }
+  ]
+}

crypto_monitor_binance/templates/key_focus.html

@@ -0,0 +1 @@
+ok2

crypto_monitor_binance/templates/order_focus.html

@@ -0,0 +1,194 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+    <meta charset="UTF-8">
+    <title>实盘下单放大 | 100根K线</title>
+    <style>
+        *{margin:0;padding:0;box-sizing:border-box}
+        body{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,sans-serif;background:#0b0d14;color:#eaeaea;padding:14px}
+        .container{width:min(98vw,1900px);margin:0 auto}
+        .card{background:#121726;border-radius:10px;padding:12px;border:1px solid #2a3150;margin-bottom:12px}
+        .row{display:flex;gap:8px;align-items:center;flex-wrap:wrap}
+        .btn{padding:7px 10px;border-radius:8px;text-decoration:none;border:1px solid #304164;background:#151a2a;color:#8fc8ff;cursor:pointer}
+        .btn:hover{background:#1f2740}
+        select,button{padding:8px 10px;border-radius:8px;border:1px solid #2e2e45;background:#1a1a29;color:#fff}
+        .meta{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:8px;margin-top:10px}
+        .meta-item{background:#141b2f;border:1px solid #27324e;border-radius:8px;padding:8px}
+        .meta-item .k{font-size:.76rem;color:#9fb0d8}
+        .meta-item .v{font-size:1rem;margin-top:4px;word-break:break-all}
+        .status{font-size:.84rem;color:#95a2c2}
+        .status.err{color:#ff8080}
+        #chart-wrap{height:560px;background:#0f1320;border:1px solid #2a3150;border-radius:10px;padding:8px}
+        #chart{width:100%;height:100%}
+        .empty{padding:18px;color:#95a2c2}
+    </style>
+</head>
+<body>
+<div class="container">
+    <div class="card">
+        <div class="row" style="justify-content:space-between">
+            <div class="row">
+                <a class="btn" href="/">返回首页</a>
+                <strong style="color:#dbe4ff">实盘下单放大(100根K线)</strong>
+            </div>
+            <div class="status">最近刷新:<span id="updated-at">--</span></div>
+        </div>
+        {% if orders %}
+        <div class="row" style="margin-top:10px">
+            <label>订单</label>
+            <select id="order-id">
+                {% for o in orders %}
+                <option value="{{ o.id }}" {% if selected_order and o.id == selected_order.id %}selected{% endif %}>
+                    #{{ o.id }} {{ o.symbol }} {{ '做多' if o.direction == 'long' else '做空' }}
+                </option>
+                {% endfor %}
+            </select>
+            <label>周期</label>
+            <select id="timeframe">
+                {% for tf in ['1m','3m','5m','15m','30m','1h','4h','1d'] %}
+                <option value="{{ tf }}" {% if tf == default_timeframe %}selected{% endif %}>{{ tf }}</option>
+                {% endfor %}
+            </select>
+            <button id="manual-refresh" type="button">刷新</button>
+            <span id="load-status" class="status"></span>
+        </div>
+        {% else %}
+        <div class="empty">当前没有激活订单,无法展示放大K线.</div>
+        {% endif %}
+    </div>
+
+    {% if orders %}
+    <div class="card">
+        <div class="meta">
+            <div class="meta-item"><div class="k">交易对</div><div class="v" id="m-symbol">-</div></div>
+            <div class="meta-item"><div class="k">方向</div><div class="v" id="m-direction">-</div></div>
+            <div class="meta-item"><div class="k">成交价</div><div class="v" id="m-entry">-</div></div>
+            <div class="meta-item"><div class="k">止损</div><div class="v" id="m-sl">-</div></div>
+            <div class="meta-item"><div class="k">止盈</div><div class="v" id="m-tp">-</div></div>
+            <div class="meta-item"><div class="k">盈亏比</div><div class="v" id="m-rr">-</div></div>
+            <div class="meta-item"><div class="k">现价</div><div class="v" id="m-price">-</div></div>
+            <div class="meta-item"><div class="k">浮盈亏</div><div class="v" id="m-pnl">-</div></div>
+        </div>
+    </div>
+
+    <div class="card">
+        <div id="chart-wrap"><div id="chart"></div></div>
+    </div>
+    {% endif %}
+</div>
+
+{% if orders %}
+<script src="https://unpkg.com/lightweight-charts/dist/lightweight-charts.standalone.production.js"></script>
+<script>
+const refreshMs = Math.max({{ price_refresh_seconds * 1000 }}, 5000);
+const orderSelect = document.getElementById("order-id");
+const tfSelect = document.getElementById("timeframe");
+const statusEl = document.getElementById("load-status");
+const updatedAtEl = document.getElementById("updated-at");
+const chartHost = document.getElementById("chart");
+const fmt = (v, d=6) => (v === null || typeof v === "undefined" || Number.isNaN(Number(v))) ? "-" : Number(v).toFixed(d);
+
+let chart = null;
+let candleSeries = null;
+let priceLines = [];
+
+function ensureChart(){
+    if(chart){ return true; }
+    if(!window.LightweightCharts){
+        statusEl.className = "status err";
+        statusEl.innerText = "图表库加载失败";
+        return false;
+    }
+    chart = LightweightCharts.createChart(chartHost, {
+        layout: { background: { color: "#0f1320" }, textColor: "#d6deff" },
+        grid: { vertLines: { color: "#1e263d" }, horzLines: { color: "#1e263d" } },
+        rightPriceScale: { borderColor: "#2a3150" },
+        timeScale: { borderColor: "#2a3150", timeVisible: true, secondsVisible: false },
+        crosshair: { mode: 0 }
+    });
+    candleSeries = chart.addCandlestickSeries({
+        upColor: "#4cd97f",
+        downColor: "#ff6666",
+        borderVisible: false,
+        wickUpColor: "#4cd97f",
+        wickDownColor: "#ff6666"
+    });
+    window.addEventListener("resize", () => {
+        chart.applyOptions({ width: chartHost.clientWidth, height: chartHost.clientHeight });
+    });
+    chart.applyOptions({ width: chartHost.clientWidth, height: chartHost.clientHeight });
+    return true;
+}
+
+function resetPriceLines(){
+    if(!candleSeries){ return; }
+    priceLines.forEach(line => {
+        try { candleSeries.removePriceLine(line); } catch (_) {}
+    });
+    priceLines = [];
+}
+
+function addLine(price, title, color){
+    if(!candleSeries || typeof price === "undefined" || price === null){ return; }
+    const p = Number(price);
+    if(Number.isNaN(p) || p <= 0){ return; }
+    priceLines.push(candleSeries.createPriceLine({
+        price: p, color, lineWidth: 1, lineStyle: 0, axisLabelVisible: true, title
+    }));
+}
+
+function paintOrder(order){
+    document.getElementById("m-symbol").innerText = order.symbol || "-";
+    document.getElementById("m-direction").innerText = (order.direction === "short") ? "做空" : "做多";
+    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 = order.current_price_display || fmt(order.current_price, 8);
+    const pnlEl = document.getElementById("m-pnl");
+    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");
+}
+
+async function loadOrderKline(){
+    if(!ensureChart()){ return; }
+    const orderId = orderSelect.value;
+    const timeframe = tfSelect.value;
+    if(!orderId){ return; }
+    statusEl.className = "status";
+    statusEl.innerText = "加载中...";
+    try{
+        const resp = await fetch(`/api/order_kline?order_id=${encodeURIComponent(orderId)}&timeframe=${encodeURIComponent(timeframe)}`);
+        const data = await resp.json();
+        if(!resp.ok || !data.ok){ throw new Error(data.msg || "请求失败"); }
+        const candles = Array.isArray(data.candles) ? data.candles : [];
+        if(!candles.length){
+            statusEl.className = "status err";
+            statusEl.innerText = "暂无K线数据";
+            return;
+        }
+        candleSeries.setData(candles);
+        resetPriceLines();
+        addLine(data.order.trigger_price, "成交价", "#42a5f5");
+        addLine(data.order.stop_loss, "止损", "#ff6666");
+        addLine(data.order.take_profit, "止盈", "#4cd97f");
+        chart.timeScale().fitContent();
+        paintOrder(data.order || {});
+        updatedAtEl.innerText = data.updated_at || "--";
+        statusEl.className = "status";
+        statusEl.innerText = `已加载 ${candles.length} 根K线`;
+    }catch(err){
+        statusEl.className = "status err";
+        statusEl.innerText = err && err.message ? err.message : "加载失败";
+    }
+}
+
+document.getElementById("manual-refresh").addEventListener("click", loadOrderKline);
+orderSelect.addEventListener("change", loadOrderKline);
+tfSelect.addEventListener("change", loadOrderKline);
+loadOrderKline();
+setInterval(loadOrderKline, refreshMs);
+</script>
+{% endif %}
+</body>
+</html>

crypto_monitor_binance/使用说明.md

@@ -0,0 +1,139 @@
+# 使用说明
+
+**本文件对应仓库:`crypto_monitor_binance`(Binance U 本位永续).**  
+功能,界面与 **Gate.io USDT 永续版**(目录 `crypto_monitor_gate`)基本一致,差异主要在 **`.env` 里交易所密钥与部分参数名**(`BINANCE_*` / `GATE_*`),文末有对照.
+
+**部署,代理,PM2 等**请参考本仓库说明或 **`crypto_monitor_gate`** 下的 **`部署文档.md`**(该文以 Gate + SSH SOCKS 为例;Binance 侧将 API 与密钥改为 `BINANCE_*` 即可类比).  
+**关键位自动开仓的规则,RR,结案原因**见本目录 **`关键位自动下单说明.md`**.
+
+---
+
+## 1. 它能做什么
+
+面向个人盘面的 **Web 控制台**,主要能力包括:
+
+| 模块 | 说明 |
+|------|------|
+| **关键位监控** | 录入上/下沿与类型,按 **5m 收线** 做硬条件过滤;符合条件后 **企业微信** 提醒,部分类型可 **自动市价开仓**(见第 4 节与专门文档). |
+| **实盘下单监控** | 手工填止损/止盈,**以损定仓** 市价开单,挂上条件止盈止损,并在页面跟踪浮盈亏,保本逻辑等. |
+| **交易记录 / 复盘** | 平仓结果,盈亏,错过的单等归档与导出;可选 **AI 复盘**(见仓库根 [AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)). |
+| **策略交易** | 顶栏 `/strategy`:**趋势回调**(左)与 **顺势加仓**(右)左右并列;细则见 [策略交易说明.md](../策略交易说明.md). |
+| **策略交易记录** | 顶栏 `/strategy/records`:趋势/顺势分两栏,可筛选,库内保留最近 100 条结束快照. |
+
+后台按 **`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** | **本仓库:** `BINANCE_API_KEY`,`BINANCE_API_SECRET`;永续相关见 `BINANCE_MARGIN_MODE`,`BINANCE_POSITION_MODE`,`BINANCE_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). |
+
+网络需要代理时可配置 **`BINANCE_SOCKS_PROXY` / `BINANCE_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`,最近 100 条结束快照)| **交易记录与复盘** | **统计分析**.
+
+---
+
+## 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. Gate 版(`crypto_monitor_gate`)差异速查
+
+| 项目 | Binance 本仓库 | Gate 版 |
+|------|----------------|--------|
+| API 变量 | `BINANCE_API_KEY`,`BINANCE_API_SECRET`,`BINANCE_*` | `GATE_API_KEY`,`GATE_API_SECRET`,`GATE_*` |
+| 代理示例 | `BINANCE_SOCKS_PROXY` | `GATE_SOCKS_PROXY` |
+| TP/SL 实现 | `_binance_place_tp_sl_orders` | `_gate_place_tp_sl_orders`,`GATE_TPSL_*` |
+| 资金舍入口径 | **`FUNDS_DECIMALS`**(与记账一致) | 以 Gate 仓库实现为准 |
+
+业务流程(登录,四种关键位,手工单,单仓)两份程序对齐;仅需更换目录与 `.env`.

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

@@ -0,0 +1,192 @@
+# 关键位监控说明(自动开仓 + 人工盯盘)
+
+**适用: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_binance`(Binance U 本位)**  
+Gate / 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_binance/更新文档.md

@@ -0,0 +1,147 @@
+# 界面与风控更新说明(Binance 实例)
+
+## 顶栏导航(4 项)
+
+| 顺序 | 名称 | 路由 | 说明 |
+|------|------|------|------|
+| 1 | 关键位监控 | `/key_monitor` | 关键位添加,实时门控,历史 |
+| 2 | 实盘下单 | `/trade` | 人工开仓,划转,实时持仓(**默认首页** `/` → `/trade`) |
+| 3 | 交易记录与复盘 | `/records` | 交易记录,复盘表单,AI 历史(受顶栏 UTC 时间窗筛选) |
+| 4 | 统计分析 | `/stats` | 按北京时间交易日切日 + 分品类统计块 |
+
+## 关键位监控页
+
+- 标题去掉「5m」;规则条从 `.env` 读取(周期,确认K,量能,自动开仓盈亏比,日成交量排名).
+- 左列:活跃关键位,**pos-card** 样式展示现价/距上沿/距下沿/门控.
+- 右列:关键位历史(失效/结案),与左列等高滚动;**受顶栏 UTC 列表时间窗筛选**(默认 UTC 当日).
+- 监控类型新增:**斐波回调0.618**,**斐波回调0.786**(与 Gate 主站同一套规则,计算逻辑见仓库根目录 `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 |
+| 添加后 | **立即**在 Binance U 本位挂限价单;卡片显示 **挂E**,限价单 ID |
+| 失效 | 以**标记价**判断:做多且标记价 ≥ H,做空且标记价 ≤ L,且限价**未成交** → 撤销该限价单并结案 |
+| 成交后 | 挂交易所 TP/SL(含 Algo 通道条件单)→ 写入 **实盘下单监控**(`monitor_type=关键位监控`,`key_signal_type=斐波回调…`)→ 从关键位列表移除 |
+| 撤单 | 仅撤本条斐波的订单 ID,**不会**对该合约 `cancel_all_orders` / 全撤 Algo,避免误伤其他委托 |
+| 盈亏比 | 计划 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`
+
+## 交易记录与复盘
+
+- 交易记录盈亏以**本地估算**为准(平仓时按成交/计划价计算);盈亏列可标注 **估**.
+- 与币安 App 不一致时,请在「核对修改」或复盘中 **手工填写** `reviewed_pnl_amount` 覆盖展示(不再提供批量「同步交易所盈亏」).
+- **列表默认只显示当前 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 后,止损阶梯上移时**同步交易所**——**先撤**该合约全部 TP/SL(含 Algo 条件单)**再挂**新止损 + 原止盈(`replace_active_monitor_tpsl_on_exchange`).仅交易所成功后才写库;失败发企业微信告警.未配置实盘 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` 中「关键位门控」「交易执行 / 人工风控」注释段.
+
+## 自动备份(服务器)
+
+- 脚本:`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_binance/app.py` | 列表筛选,统计分块,导出 v3,复盘 K 线锚点,入库逻辑 |
+| `crypto_monitor_binance/templates/index.html` | 顶栏时间窗,统计分块 UI,止损(开仓)列,复盘预填 |
+
+## 升级步骤
+
+1. `git pull` 后对比 `.env.example`,把新增变量合并进本地 `.env`.
+2. 在 VPS 上为 Binance / Gate / **各执行一次** `bash scripts/install_backup_cron.sh`(若尚未安装).
+3. 重启 Binance 实例(如 `pm2 restart crypto_binance`);SQLite 会自动 `ALTER` 缺列(斐波,交易所盈亏,`entry_reason` 等).
+4. 浏览器强刷(Ctrl+F5)避免旧版 `index.html` 缓存.
+5. 打开任意页确认顶栏出现 **「列表筛选(UTC)」**;`/stats` 可见分品类统计与「北京 8:00 切日」说明.
+6. 建议先用测试币验证斐波:限价挂出,标记价失效撤单,成交后 TP/SL 与订单监控是否正常;平仓后检查交易记录止损(开仓)与开仓类型.

crypto_monitor_binance/部署文档.md

@@ -0,0 +1,389 @@
+# `crypto_monitor_binance` 部署指南:SSH SOCKS + Binance + PM2(Ubuntu)
+
+项目功能,环境变量总览见 **[README.md](./README.md)**.Ubuntu 环境(Python / Node / PM2)见 **[docs/ubuntu-server.md](../docs/ubuntu-server.md)**.
+
+本文面向:**在本机或 VPS 上运行本项目**,但 **直连 Binance API 不稳定,超时或被网络策略拦截** 的场景.思路是:
+
+- 本机用 `ssh -D` 做动态转发,把 **SOCKS5 出口**放到能稳定访问 Binance 的机器(常见为一台境外 VPS)
+- 项目在 `.env` 中设置 **`BINANCE_SOCKS_PROXY=socks5h://127.0.0.1:1080`**(或你实际端口),`ccxt` 经 SOCKS 访问交易所
+- **SSH 隧道**:用 `ssh -D` 在本机常驻(可用 **tmux** 或 **autossh** 保持连接),**不要** 把 `ssh` 交给 PM2
+- 使用 **PM2** 仅托管 **Flask 应用**;仓库根目录 **`ecosystem.config.cjs`** 默认进程名为 **`crypto-monitor-binance`**
+
+> 安全提醒:不要把 `.env`,私钥 `.pem`,Binance API Key / Secret 提交到 Git;下文只用占位符.
+
+---
+
+## 0. 你需要准备的东西
+
+- 一台 **Ubuntu**(或同类 Linux)运行项目的机器(下文称「本机」)
+- 一台可 SSH 登录,且 **能正常访问 Binance API** 的 VPS(示例:`HostName` 填你的服务器 IP,用户如 `root`)
+- SSH:**私钥登录**(推荐,便于隧道脚本无人值守)
+- 本机已安装:`python3`,`python3-venv`,`pip`,`curl`,`ssh`,`git`(可选),`node` + `npm`(安装 PM2)
+- Binance 账户:已开通 **USDT-M 永续合约**;API Key 勾选 **合约**,**万向划转**(若使用资金↔合约划转)等所需权限,并配置 **IP 白名单**(若启用)
+
+---
+
+## 1. 获取代码与目录
+
+将包含 `app.py` 的项目放到固定目录,例如:
+
+```bash
+mkdir -p /opt/crypto_monitor_user
+cd /opt/crypto_monitor_user
+git clone https://git.bz121.com/dekun/crypto_monitor_user.git
+cd crypto_monitor/crypto_monitor_binance
+```
+
+下文用 **`/opt/crypto_monitor_user/crypto_monitor_binance`** 仅为示例,请换成你的实际绝对路径.
+
+拉取代码后,若目录下尚无 `.env`,先从模板生成(**勿**把填好密钥的 `.env` 提交 Git):
+
+```bash
+cp -n .env.example .env    # -n:已存在 .env 时不覆盖
+```
+
+---
+
+## 2. 配置 SSH 私钥与 `~/.ssh/config`
+
+```bash
+mkdir -p ~/.ssh
+chmod 700 ~/.ssh
+# 私钥示例:~/.ssh/vps1.pem
+chmod 600 ~/.ssh/vps1.pem
+```
+
+编辑 `~/.ssh/config`(示例别名 **`bn-vps`**,与你手工启动 `ssh -D ... bn-vps` 一致即可):
+
+```sshconfig
+Host bn-vps
+  HostName 你的_VPS_IP
+  User root
+  IdentityFile ~/.ssh/vps1.pem
+  IdentitiesOnly yes
+  ServerAliveInterval 30
+  ServerAliveCountMax 3
+  ExitOnForwardFailure yes
+  BatchMode yes
+```
+
+测试:
+
+```bash
+ssh bn-vps true
+```
+
+> 若尚未完全改为密钥登录,可暂时注释 `BatchMode yes`,调试完成后再打开.
+
+---
+
+## 3. 手工验证:SSH SOCKS + Binance API
+
+### 3.1 本地 SOCKS(示例端口 1080)
+
+```bash
+ssh -N -D 127.0.0.1:1080 bn-vps
+```
+
+保持运行,另开终端继续.
+
+### 3.2 验证经 SOCKS 可访问 Binance(公开接口)
+
+```bash
+curl -4 -sS --max-time 15 --proxy socks5h://127.0.0.1:1080 https://api.binance.com/api/v3/time
+```
+
+应返回 JSON(含 `serverTime` 字段).若此处失败,**不要先启动应用**:先修隧道或 VPS 出站.
+
+---
+
+## 4. Python 虚拟环境
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_binance
+
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install -U pip
+pip install flask requests ccxt werkzeug PySocks Pillow
+```
+
+走 SOCKS 时 **必须** 安装 **`PySocks`**,否则易出现代理相关报错.
+
+可选:
+
+```bash
+export PYTHONDONTWRITEBYTECODE=1
+```
+
+---
+
+## 5. 配置环境变量(`.env.example` → `.env`)
+
+| 文件 | 是否进 Git | 说明 |
+|------|------------|------|
+| **`.env.example`** | ✅ 是 | 变量模板与注释,可随 `git pull` 更新 |
+| **`.env`** | ❌ 否 | 本机真实配置;`app.py` **只读此文件** |
+
+### 5.1 首次配置
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_binance
+
+cp -n .env.example .env    # 已存在 .env 时不覆盖
+nano .env                  # 填入 API,登录密码,端口,代理等
+```
+
+### 5.2 备份与 `git pull`
+
+- **`.env` 已被仓库根目录 `.gitignore` 忽略**:`git pull` **不会**覆盖或删除你本地的 `.env`.
+- 若远端更新了 **`.env.example`**(新增变量名),pull 后请对照模板,**手动把新行补进你的 `.env`**(不会自动合并进 `.env`).
+- **建议在每次 `git pull` 或大批量改配置前备份**:
+
+```bash
+cp .env .env.backup.$(date +%Y%m%d)
+# 恢复示例:cp .env.backup.20260516 .env
+```
+
+- **换机 / 迁移**:用 `scp` 复制整份 `.env` 到新机器对应目录;或在新机重新 `cp .env.example .env` 后填写.
+
+### 5.3 AI 复盘与模型(可选)
+
+三所共用仓库根目录 **`ai_client.py`**(PM2 的 **`PYTHONPATH=..`** 须包含仓库根).在 `.env` 中配置 **`AI_PROVIDER`**:
+
+| 模式 | 主要变量 |
+|------|----------|
+| **`openai`**(默认) | `OPENAI_API_BASE=https://op.bz121.com/v1`,`OPENAI_API_KEY`,`OPENAI_MODEL=gemma4:e4b` |
+| **`ollama`** | `OLLAMA_API`,`AI_MODEL`(本机 Ollama) |
+
+密钥在 [op.bz121.com](https://op.bz121.com/) 的 **`gateway.json`** 页面获取.改 `.env` 后需 **`pm2 restart`** 对应进程.详见根目录 **[AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)**.
+
+### 5.4 自动备份(数据库 + 复盘图片)
+
+默认每天 **北京时间 0:00** 备份到 **`/root/backups`**,保留 **30 天** 后自动删除更早的目录.
+
+备份内容(路径来自 `.env` 的 `DB_PATH`,`UPLOAD_DIR`):
+
+- `crypto.db`(优先 `sqlite3 .backup` 热备)
+- `static/images` 打包为 `static_images.tar.gz`
+
+目录结构示例:
+
+```text
+/root/backups/crypto_monitor_binance/2026-05-17/
+  crypto.db
+  static_images.tar.gz
+  manifest.txt
+```
+
+**一次性安装定时任务**(在对应项目目录执行,Binance / Gate 各执行一次):
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_binance
+chmod +x scripts/backup_data.sh scripts/install_backup_cron.sh
+bash scripts/install_backup_cron.sh
+```
+
+Gate 实例:
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_gate
+bash scripts/install_backup_cron.sh
+```
+
+实例(趋势回调等):
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_gate
+bash scripts/install_backup_cron.sh
+```
+
+**立即试跑**(不写 cron):
+
+```bash
+bash scripts/backup_data.sh
+```
+
+日志默认:`/var/log/crypto-monitor-backup-<项目目录名>.log`.可选在 `.env` 中覆盖:`BACKUP_ROOT`,`BACKUP_RETENTION_DAYS`,`BACKUP_INSTANCE`.
+
+**恢复示例**(先停 PM2,再覆盖文件):
+
+```bash
+pm2 stop crypto-monitor-binance
+cp /root/backups/crypto_monitor_binance/2026-05-16/crypto.db ./crypto.db
+tar -xzf /root/backups/crypto_monitor_binance/2026-05-16/static_images.tar.gz -C .
+pm2 start ecosystem.config.cjs
+```
+
+建议安装:`apt install -y sqlite3`(热备更稳).
+
+### 5.5 必填项检查(Binance + 代理)
+
+与交易所相关的变量使用 **`BINANCE_`** 前缀(与代码一致).至少确认:
+
+```env
+APP_HOST=127.0.0.1
+APP_PORT=5000
+
+# 实盘(按需)
+LIVE_TRADING_ENABLED=false
+BINANCE_API_KEY=你的_Key
+BINANCE_API_SECRET=你的_Secret
+
+# 保证金:cross=全仓 isolated=逐仓(与币安账户/习惯一致)
+BINANCE_MARGIN_MODE=cross
+
+# 持仓模式:hedge=双向(需在币安开启双向持仓);oneway=单向
+BINANCE_POSITION_MODE=hedge
+
+# 条件单触发参考:CONTRACT_PRICE=最新成交价 MARK_PRICE=标记价
+BINANCE_TRIGGER_WORKING_TYPE=CONTRACT_PRICE
+
+# 经本机 SSH 动态转发访问 Binance(端口与隧道一致)
+BINANCE_SOCKS_PROXY=socks5h://127.0.0.1:1080
+
+# 若不用 SOCKS,可改用 HTTP 代理(一般二选一)
+# BINANCE_HTTP_PROXY=http://127.0.0.1:7890
+# BINANCE_HTTPS_PROXY=http://127.0.0.1:7890
+```
+
+说明:**推荐 `socks5h://`**,由 SOCKS 端解析域名,与 `curl --proxy socks5h://...` 行为一致.
+
+**止盈止损说明(应用逻辑)**:实盘开仓后,程序会在 Binance USDT-M 永续上挂 **`STOP_MARKET`(止损)** 与 **`TAKE_PROFIT_MARKET`(止盈)**;`BINANCE_POSITION_MODE=hedge` 时会自动带 **`positionSide`**,须与币安合约「双向持仓」开关一致.不显式传 **`reduceOnly`**(否则易触发 API **`-1106`**:`Parameter 'reduceOnly' sent when not required`).
+
+---
+
+## 6. 自检脚本(可选)
+
+在已配置 `.env` 且网络可达的前提下:
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_binance
+source .venv/bin/activate
+python scripts/verify_binance_funding.py
+```
+
+用于粗测资金钱包与合约钱包 USDT 读取(需有效 API 与权限).
+
+---
+
+## 7. 手工启动 Flask(验证)
+
+1. SOCKS 已监听 `127.0.0.1:1080`(若使用代理)
+2. 已 `source .venv/bin/activate`
+3. `.env` 已按需配置 `BINANCE_SOCKS_PROXY` 等
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_binance
+source .venv/bin/activate
+python app.py
+```
+
+浏览器访问:`http://127.0.0.1:5000`(或你在 `.env` 中的端口).
+
+---
+
+## 8. 安装 PM2
+
+```bash
+sudo npm i -g pm2
+pm2 -v
+```
+
+---
+
+## 9. PM2:使用仓库内 `ecosystem.config.cjs`(推荐)
+
+在项目根目录:
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_binance
+pm2 start ecosystem.config.cjs
+pm2 status
+pm2 logs --lines 200
+```
+
+默认只启动 **`crypto-monitor-binance`**(`.venv/bin/python app.py`).
+
+### 本机已可直连 Binance,不需要隧道时
+
+`.env` 里应 **去掉或留空** `BINANCE_SOCKS_PROXY`(除非仍要走别的代理),再 `pm2 start ecosystem.config.cjs`.
+
+### 开机自启
+
+```bash
+pm2 save
+pm2 startup
+# 按屏幕提示执行一条 sudo 命令
+```
+
+---
+
+## 10. 等价手工命令(不使用 ecosystem 文件时)
+
+### 10.1 SSH SOCKS(自行后台常驻,不推荐用 PM2)
+
+示例(前台调试;生产请用 **PM2**,见本文 §6 与 [docs/ubuntu-server.md](../docs/ubuntu-server.md)):
+
+```bash
+ssh -N -D 127.0.0.1:1080 bn-vps \
+  -o ServerAliveInterval=30 -o ServerAliveCountMax=3 \
+  -o ExitOnForwardFailure=yes
+```
+
+### 10.2 Flask
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_binance
+pm2 start /opt/crypto_monitor_user/crypto_monitor_binance/.venv/bin/python --name crypto-monitor-binance -- \
+  /opt/crypto_monitor_user/crypto_monitor_binance/app.py
+```
+
+---
+
+## 11. 交易所「连接不上」排查清单
+
+1. **`.env` 是否为 Binance 变量**:`BINANCE_SOCKS_PROXY` / `BINANCE_HTTP_PROXY` / `BINANCE_API_KEY` / `BINANCE_API_SECRET` 等前缀需与代码一致.
+2. **隧道是否在本机端口监听**(若配置了 `BINANCE_SOCKS_PROXY`):
+   ```bash
+   ss -lntp | grep 1080 || true
+   ```
+3. **curl 复测 Binance**(与第 3.2 节相同);curl 不通则应用也不会通.
+4. **PySocks**:`pip show PySocks`,缺失则 `pip install PySocks`.
+5. **SSH 隧道连不上**:检查私钥权限,`~/.ssh/config`,VPS 出站与端口是否与 `.env` 一致.
+6. **API 权限与 IP 白名单**:Secret 错误,权限不足,未放行当前出口 IP 时,私有接口会失败.
+7. **启动顺序**:若走代理,先保证 SOCKS 已监听,再 `pm2 start` 应用(或重启应用).
+
+---
+
+## 12. 推荐启动顺序(习惯)
+
+1. 若走代理:先启动并确认 SSH SOCKS 已监听,再 `curl --proxy socks5h://127.0.0.1:1080 https://api.binance.com/api/v3/time` 成功
+2. `pm2 start ecosystem.config.cjs`
+3. 再确认页面与余额等接口正常
+
+---
+
+## 13. 免责声明
+
+交易所有合规与地区政策要求.请确保使用方式符合当地法律法规与交易所条款.本文仅描述网络与工程部署路径.
+
+---
+
+## 附录:数据库标签修复脚本 `scripts/fix_breakeven_labels.py`
+
+在 Ubuntu 上:
+
+1)预览(不写库):
+
+```bash
+python scripts/fix_breakeven_labels.py --db ./crypto.db --dry-run
+```
+
+2)确认后执行:
+
+```bash
+python scripts/fix_breakeven_labels.py --db ./crypto.db --apply
+```
+
+默认修复条件:`monitor_type='下单监控'` 且 `result='止损'` 且 `pnl_amount > 0` → 改为 `result='保本止盈'`.

crypto_monitor_gate/.env.example

@@ -0,0 +1,233 @@
+# =============================================================================
+# 环境配置模板(可提交 Git).程序运行时只读取同目录下的 .env.
+#
+# 首次部署 / 新机:
+#   cp .env.example .env
+#   nano .env          # 填入真实密钥,端口,代理等
+#
+# 升级代码(git pull)前建议备份(.env 不在 Git 中,pull 不会覆盖):
+#   cp .env .env.backup.$(date +%Y%m%d)
+#
+# 从备份恢复:
+#   cp .env.backup.YYYYMMDD .env
+# =============================================================================
+
+APP_ENV=production
+# 服务监听地址(云服务器通常用 0.0.0.0)
+APP_HOST=0.0.0.0
+# 服务端口
+APP_PORT=5000
+# 是否开启调试模式(生产建议 false)
+APP_DEBUG=false
+
+# 登录账号
+APP_USERNAME=admin
+# 登录密码(请改成你自己的强密码)
+APP_PASSWORD=admin123
+# 是否关闭登录校验(局域网可设 true;公网务必 false)
+APP_AUTH_DISABLED=true
+# --- 多账户交易中控 manual_trading_hub ---
+# 中控请求本实例 /api/hub/* 时携带请求头 X-Hub-Token,须与中控启动环境变量 HUB_BRIDGE_TOKEN 一致
+# 未设置且 APP_AUTH_DISABLED=false 时,仅网页登录后可访问;本机联调可保持 APP_AUTH_DISABLED=true
+# HUB_BRIDGE_TOKEN=your-long-random-token
+# Flask 会话密钥(必须替换为长随机字符串)
+FLASK_SECRET_KEY=CHANGE_TO_LONG_RANDOM_SECRET
+
+# 企业微信机器人 Webhook(用于行情/风控推送)
+WECHAT_WEBHOOK=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=REPLACE_WITH_REAL_KEY
+
+# 数据库文件路径(相对路径会自动按项目目录解析)
+DB_PATH=crypto.db
+# 交易截图上传目录
+UPLOAD_DIR=static/images
+
+# 自动备份(scripts/backup_data.sh + cron,可选;默认即可)
+# BACKUP_ROOT=/root/backups
+# BACKUP_RETENTION_DAYS=30
+# BACKUP_INSTANCE=crypto_monitor_gate
+
+# 已废弃:资金账户仅显示交易所 funding 余额,不再读取此变量
+# TOTAL_CAPITAL=100
+# 计仓:risk=以损定仓(默认);full_margin=合约可用×FULL_MARGIN_BUFFER_RATIO 全仓杠杆(须无仓后重启)
+POSITION_SIZING_MODE=risk
+# 方向限制(默认 false=双向均可;true 时按 TRADE_DIRECTION 限制,修改后须重启)
+# TRADE_DIRECTION=long_only | short_only | both(或 多/空/双向)
+TRADE_DIRECTION_RESTRICT_ENABLED=false
+TRADE_DIRECTION=both
+# 币种白名单(默认 false=全币种可手输;true 时关键位/下单/策略仅下拉选择)
+TRADE_SYMBOL_RESTRICT_ENABLED=false
+TRADE_SYMBOL_WHITELIST=BTC,ETH
+# 每天起始基数(U)
+DAILY_START_CAPITAL=30
+# 日内回撤后基数(U)
+DAILY_LOSS_CAPITAL=20
+# 日内盈利后基数(U)
+DAILY_PROFIT_CAPITAL=50
+# BTC 默认杠杆倍数
+BTC_LEVERAGE=10
+# 山寨币默认杠杆倍数
+ALT_LEVERAGE=5
+# 交易日重置小时(北京时间)
+TRADING_DAY_RESET_HOUR=8
+# 整点前禁止新开仓:true=启用(默认),false=关闭(仍可保留 8 点作为交易日划分)
+TRADING_DAY_RESET_OPEN_GUARD_ENABLED=true
+
+# 是否开启 Gate 实盘下单(false=只做本地流程,true=真实下单)
+LIVE_TRADING_ENABLED=true
+# Gate API Key(实盘)
+GATE_API_KEY=REPLACE_WITH_GATE_API_KEY
+# Gate API Secret(实盘)
+GATE_API_SECRET=REPLACE_WITH_GATE_API_SECRET
+# 保证金模式:cross=全仓,isolated=逐仓
+GATE_TD_MODE=cross
+# 持仓筛选:hedge=双向持仓下按多空腿过滤;其它值(如 single)不按腿过滤
+GATE_POS_MODE=hedge
+# 永续止盈止损:是否优先用官方仓位类触发单(POST price_orders,close-*-position);false=仅用旧版两张 ccxt 条件单
+GATE_TPSL_USE_POSITION_ORDER=true
+# 触发单超时(秒),默认 604800=7 天;设为 0 或负数则不向 API 传 expiration
+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
+
+# =============================================================================
+# 关键位程序自动下单(与 POSITION_SIZING_MODE 联动,修改后须重启 PM2)
+# =============================================================================
+# 默认 false = 关闭所有关键位程序自动单(箱体/收敛/斐波/假突破/触价)
+#
+#   POSITION_SIZING_MODE=risk(以损定仓)
+#     false → 不执行任何关键位自动单;支撑/阻力提醒,人工下单,顺势加仓不受影响
+#     true  → 允许关键位全套自动(含触价)
+#
+#   POSITION_SIZING_MODE=full_margin(全仓杠杆,须无仓切换)
+#     false → 不执行触价自动单
+#     true  → 仅回调/突破触价可程序自动开仓;箱体/斐波等仍禁止
+#
+# 顺势加仓,趋势回调不受本开关控制;全仓模式下策略自动仍禁止.
+KEY_AUTO_ORDER_ENABLED=false
+
+# =============================================================================
+# 关键位门控(页面「关键位监控」规则条与 _key_hard_checks 共用)
+# =============================================================================
+# 【周期】门控 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
+
+# =============================================================================
+# 账户冷静期 / 日冻结风控(手动平仓,外部平仓,复盘情绪标签)
+# 详见 docs/account-risk-cooldown.md
+# =============================================================================
+RISK_CONTROL_ENABLED=true
+RISK_COOLING_HOURS_MANUAL=4
+RISK_COOLING_HOURS_MANUAL_JOURNAL=1
+RISK_MANUAL_CLOSE_DAILY_LIMIT=2
+RISK_MOOD_ISSUES_DAILY_FREEZE=true
+
+# 资金与仓位刷新周期(秒)
+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
+
+# =============================================================================
+# 自动划转(页顶「将 swap 补足到 XU」;与 DAILY_START_CAPITAL 独立,需一致时请设为相同值)
+# =============================================================================
+AUTO_TRANSFER_ENABLED=false
+# 交易账户(swap)目标余额 U:每日 8 点(北京)自动划入或划出至 funding;持仓中不划转
+AUTO_TRANSFER_AMOUNT=30
+AUTO_TRANSFER_FROM=funding
+AUTO_TRANSFER_TO=swap
+TRANSFER_CCY=USDT
+# 北京时间该整点小时内尝试;账簿按 UTC 自然日去重
+AUTO_TRANSFER_BJ_HOUR=8
+# 强制清仓整点(北京时间,默认 0=凌晨00点)
+FORCE_CLOSE_BJ_HOUR=0
+# 是否启用强制清仓(默认关闭,true 才会在整点执行)
+FORCE_CLOSE_ENABLED=false
+
+# 推送与AI超时(秒)
+WECHAT_TIMEOUT_SECONDS=10
+AI_TIMEOUT_SECONDS=120
+
+# AI 提供方:openai(默认)| ollama
+AI_PROVIDER=openai
+OPENAI_API_BASE=https://op.bz121.com/v1
+OPENAI_API_KEY=你的密钥
+OPENAI_MODEL=gemma4:e4b
+OLLAMA_API=http://127.0.0.1:11434/api/generate
+AI_MODEL=huihui_ai/deepseek-r1-abliterated:latest
+
+# Gate 代理(可选):本机网络不稳定时通过 SSH 动态转发 SOCKS5 出口
+# 1) 先在本机建立隧道(示例):
+#    ssh -N -D 127.0.0.1:1080 root@你的VPS_IP -o ServerAliveInterval=30 -o ExitOnForwardFailure=yes
+# 2) 再启用下面这一行(推荐 socks5h,让远端解析域名):
+# GATE_SOCKS_PROXY=socks5h://127.0.0.1:1080
+#
+# 如你更偏向 HTTP 代理(VPS 上跑 tinyproxy 之类),可用:
+# GATE_HTTP_PROXY=http://127.0.0.1:3128
+# GATE_HTTPS_PROXY=http://127.0.0.1:3128
+
+# 开仓多周期K线图(可选)
+# ORDER_CHART_ENABLED=true
+# ORDER_CHART_TFS=4h,1h,15m,5m
+# ORDER_CHART_LIMIT=100
+# ORDER_CHART_DIR=static/images/order_charts
+# 详见 DAILY_OPEN_ALERT_THRESHOLD / DAILY_OPEN_HARD_LIMIT;说明文档 docs/daily-open-limit.md
+# 以损定仓(按交易账户资金的百分比)
+# RISK_PERCENT=2
+# 移动保本触发(达到多少R触发)与偏移(百分比)
+# BREAKEVEN_RR_TRIGGER=1.0
+# 移动保本阶梯(每多少R继续上移一次,默认1R)
+# BREAKEVEN_STEP_R=1.0
+# BREAKEVEN_OFFSET_PCT=0.02
+# 开单风格默认值:trend / swing
+# DEFAULT_TRADE_STYLE=trend
+
+APP_TIMEZONE=Asia/Shanghai
+# TRADING_DAY_RESET_HOUR 现在表示「北京时间」整点,默认 8 点起算新交易日;开仓整点限制见 TRADING_DAY_RESET_OPEN_GUARD_ENABLED

crypto_monitor_gate/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_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/ecosystem.config.cjs

@@ -0,0 +1,34 @@
+/**
+ * PM2 进程定义(Ubuntu / Linux).
+ *
+ * 仅托管 Flask 应用.**SSH SOCKS 隧道**用 `ssh -D` 常驻(可用 tmux / autossh),勿交给 PM2.
+ * 与 `.env` 里 `GATE_SOCKS_PROXY` 端口一致即可;不必交给 PM2.
+ *
+ * 使用前:项目根目录存在 `.venv`,且已安装依赖(走 SOCKS 时需 PySocks).
+ *
+ * 启动:
+ *   pm2 start ecosystem.config.cjs
+ * 保存开机列表:
+ *   pm2 save && pm2 startup
+ */
+const path = require("path");
+
+const ROOT = __dirname;
+const REPO_ROOT = path.join(ROOT, "..");
+const PY = path.join(ROOT, ".venv", "bin", "python");
+
+module.exports = {
+  apps: [
+    {
+      name: "crypto_gate",
+      cwd: ROOT,
+      script: path.join(ROOT, "app.py"),
+      interpreter: PY,
+      instances: 1,
+      autorestart: true,
+      watch: false,
+      max_memory_restart: "800M",
+      env: { PYTHONPATH: REPO_ROOT },
+    },
+  ],
+};

crypto_monitor_gate/scripts/backup_data.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+# Daily backup: SQLite DB + static/images → /root/backups/<instance>/<YYYY-MM-DD>/
+# Prune backup folders older than RETENTION_DAYS (default 30).
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$PROJECT_DIR"
+
+BACKUP_ROOT="${BACKUP_ROOT:-/root/backups}"
+RETENTION_DAYS="${RETENTION_DAYS:-30}"
+INSTANCE_NAME="${BACKUP_INSTANCE:-$(basename "$PROJECT_DIR")}"
+TZ_NAME="${BACKUP_TZ:-Asia/Shanghai}"
+
+log() {
+  printf '[%s] %s\n' "$(TZ="$TZ_NAME" date '+%Y-%m-%d %H:%M:%S %Z')" "$*"
+}
+
+read_env_var() {
+  local key="$1"
+  local default="$2"
+  local line
+  if [[ ! -f .env ]]; then
+    printf '%s' "$default"
+    return
+  fi
+  line="$(grep -E "^${key}=" .env 2>/dev/null | tail -1 || true)"
+  if [[ -z "$line" ]]; then
+    printf '%s' "$default"
+    return
+  fi
+  printf '%s' "${line#*=}" | tr -d '\r'
+}
+
+resolve_project_path() {
+  local p="$1"
+  if [[ "$p" == /* ]]; then
+    printf '%s' "$p"
+  else
+    printf '%s' "$PROJECT_DIR/$p"
+  fi
+}
+
+prune_old_backups() {
+  local base="$BACKUP_ROOT/$INSTANCE_NAME"
+  [[ -d "$base" ]] || return 0
+  local cutoff
+  cutoff="$(TZ="$TZ_NAME" date -d "-${RETENTION_DAYS} days" +%Y-%m-%d 2>/dev/null || true)"
+  if [[ -z "$cutoff" ]]; then
+    find "$base" -mindepth 1 -maxdepth 1 -type d -mtime +"$RETENTION_DAYS" -print0 |
+      xargs -r -0 rm -rf
+    return 0
+  fi
+  local dir name
+  for dir in "$base"/*/; do
+    [[ -d "$dir" ]] || continue
+    name="$(basename "$dir")"
+    [[ "$name" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]] || continue
+    if [[ "$name" < "$cutoff" ]]; then
+      log "prune: remove $dir (older than ${RETENTION_DAYS} days)"
+      rm -rf "$dir"
+    fi
+  done
+}
+
+DB_REL="$(read_env_var DB_PATH crypto.db)"
+UPLOAD_REL="$(read_env_var UPLOAD_DIR static/images)"
+BACKUP_ROOT="$(read_env_var BACKUP_ROOT "$BACKUP_ROOT")"
+RETENTION_DAYS="$(read_env_var BACKUP_RETENTION_DAYS "$RETENTION_DAYS")"
+INSTANCE_NAME="$(read_env_var BACKUP_INSTANCE "$INSTANCE_NAME")"
+
+DB_PATH="$(resolve_project_path "$DB_REL")"
+UPLOAD_DIR="$(resolve_project_path "$UPLOAD_REL")"
+DATE_TAG="$(TZ="$TZ_NAME" date +%Y-%m-%d)"
+DEST="$BACKUP_ROOT/$INSTANCE_NAME/$DATE_TAG"
+
+if [[ ! -f "$DB_PATH" ]]; then
+  log "error: database not found: $DB_PATH"
+  exit 1
+fi
+
+mkdir -p "$DEST"
+log "start backup instance=$INSTANCE_NAME dest=$DEST"
+
+if command -v sqlite3 >/dev/null 2>&1; then
+  sqlite3 "$DB_PATH" ".backup '$DEST/crypto.db'"
+  log "db: sqlite3 backup -> $DEST/crypto.db"
+else
+  cp -a "$DB_PATH" "$DEST/crypto.db"
+  log "db: cp -> $DEST/crypto.db (sqlite3 not installed)"
+fi
+
+if [[ -d "$UPLOAD_DIR" ]]; then
+  tar -czf "$DEST/static_images.tar.gz" -C "$(dirname "$UPLOAD_DIR")" "$(basename "$UPLOAD_DIR")"
+  log "images: $UPLOAD_DIR -> $DEST/static_images.tar.gz"
+else
+  log "warn: upload dir missing, skip images: $UPLOAD_DIR"
+fi
+
+{
+  echo "instance=$INSTANCE_NAME"
+  echo "project_dir=$PROJECT_DIR"
+  echo "backup_date=$DATE_TAG"
+  echo "db_path=$DB_PATH"
+  echo "upload_dir=$UPLOAD_DIR"
+} >"$DEST/manifest.txt"
+
+prune_old_backups
+log "done"

crypto_monitor_gate/scripts/fix_breakeven_labels.py

@@ -0,0 +1,108 @@
+#!/usr/bin/env python3
+"""
+一次性修复历史交易记录标签:
+将 trade_records 里“止损但实际盈利”的记录改为“保本止盈”.
+
+默认条件(可通过参数修改):
+- monitor_type = 下单监控
+- result = 止损
+- pnl_amount > 0
+
+用法示例:
+1) 仅预览(不落库):
+   python scripts/fix_breakeven_labels.py --db ./crypto.db --dry-run
+
+2) 执行修复:
+   python scripts/fix_breakeven_labels.py --db ./crypto.db --apply
+"""
+
+from __future__ import annotations
+
+import argparse
+import sqlite3
+import sys
+from pathlib import Path
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description="Fix historical stop-loss records with positive pnl.")
+    parser.add_argument("--db", required=True, help="Path to sqlite db file, e.g. ./crypto.db")
+    parser.add_argument("--monitor-type", default="下单监控", help="Filter by monitor_type (default: 下单监控)")
+    parser.add_argument("--from-result", default="止损", help="Source result label (default: 止损)")
+    parser.add_argument("--to-result", default="保本止盈", help="Target result label (default: 保本止盈)")
+    parser.add_argument("--dry-run", action="store_true", help="Preview only, no write")
+    parser.add_argument("--apply", action="store_true", help="Execute update")
+    return parser.parse_args()
+
+
+def main() -> int:
+    args = parse_args()
+    db_path = Path(args.db).expanduser().resolve()
+    if not db_path.exists():
+        print(f"[ERR] DB not found: {db_path}")
+        return 1
+
+    if args.dry_run and args.apply:
+        print("[ERR] --dry-run and --apply are mutually exclusive.")
+        return 1
+    if not args.dry_run and not args.apply:
+        print("[INFO] No mode provided, defaulting to --dry-run.")
+        args.dry_run = True
+
+    conn = sqlite3.connect(str(db_path))
+    conn.row_factory = sqlite3.Row
+    cur = conn.cursor()
+
+    where_sql = """
+        monitor_type = ?
+        AND result = ?
+        AND CAST(COALESCE(pnl_amount, 0) AS REAL) > 0
+    """
+    params = (args.monitor_type, args.from_result)
+
+    cur.execute(f"SELECT COUNT(*) AS c FROM trade_records WHERE {where_sql}", params)
+    will_change = int(cur.fetchone()["c"])
+    print(f"[INFO] Candidate rows: {will_change}")
+
+    if will_change == 0:
+        print("[INFO] Nothing to update.")
+        conn.close()
+        return 0
+
+    cur.execute(
+        f"""
+        SELECT id, symbol, result, pnl_amount, closed_at
+        FROM trade_records
+        WHERE {where_sql}
+        ORDER BY id DESC
+        LIMIT 10
+        """,
+        params,
+    )
+    sample = cur.fetchall()
+    print("[INFO] Sample (latest 10):")
+    for r in sample:
+        print(
+            f"  id={r['id']} symbol={r['symbol']} result={r['result']} "
+            f"pnl={r['pnl_amount']} closed_at={r['closed_at']}"
+        )
+
+    if args.dry_run:
+        print("[DRY-RUN] No write executed.")
+        conn.close()
+        return 0
+
+    cur.execute(
+        f"UPDATE trade_records SET result=? WHERE {where_sql}",
+        (args.to_result, *params),
+    )
+    changed = int(cur.rowcount)
+    conn.commit()
+    conn.close()
+    print(f"[DONE] Updated rows: {changed}")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())
+

crypto_monitor_gate/scripts/install_backup_cron.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# Install daily backup cron: Beijing 00:00 (CRON_TZ=Asia/Shanghai).
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+BACKUP_SCRIPT="$SCRIPT_DIR/backup_data.sh"
+INSTANCE_NAME="${BACKUP_INSTANCE:-$(basename "$PROJECT_DIR")}"
+LOG_FILE="${BACKUP_CRON_LOG:-/var/log/crypto-monitor-backup-${INSTANCE_NAME}.log}"
+
+if [[ ! -x "$BACKUP_SCRIPT" ]]; then
+  chmod +x "$BACKUP_SCRIPT"
+fi
+
+TMP="$(mktemp)"
+trap 'rm -f "$TMP"' EXIT
+
+{
+  crontab -l 2>/dev/null | grep -vF "$BACKUP_SCRIPT" || true
+  echo "CRON_TZ=Asia/Shanghai"
+  echo "0 0 * * * $BACKUP_SCRIPT >> $LOG_FILE 2>&1"
+} >"$TMP"
+
+awk '
+  BEGIN { tz = 0 }
+  /^CRON_TZ=Asia\/Shanghai$/ {
+    if (tz++) next
+  }
+  { print }
+' "$TMP" >"${TMP}.2"
+mv "${TMP}.2" "$TMP"
+
+crontab "$TMP"
+echo "Installed cron for $INSTANCE_NAME"
+echo "  Schedule : daily 00:00 Asia/Shanghai"
+echo "  Script   : $BACKUP_SCRIPT"
+echo "  Log      : $LOG_FILE"
+crontab -l | grep -F "$BACKUP_SCRIPT" || true

crypto_monitor_gate/scripts/verify_gate_funding.py

@@ -0,0 +1,93 @@
+"""
+在项目根目录执行(会加载根目录 .env):
+  python scripts/verify_gate_funding.py
+
+依次探测:[0] swap 余额(与 App「交易账户」同源);[1]–[3] 现货 / 统一账户资金路径.
+打印 GATE_API_KEY 前 8 位便于与 Gate 控制台核对(不含 Secret).用于服务器自检.
+"""
+from __future__ import annotations
+
+import importlib.util
+import os
+import sys
+
+ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+if ROOT not in sys.path:
+    sys.path.insert(0, ROOT)
+
+
+def _load_app():
+    path = os.path.join(ROOT, "app.py")
+    spec = importlib.util.spec_from_file_location("crypto_app", path)
+    mod = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(mod)
+    return mod
+
+
+def main():
+    os.chdir(ROOT)
+    mod = _load_app()
+    print("LIVE_TRADING_ENABLED =", os.getenv("LIVE_TRADING_ENABLED"))
+    ok, reason = mod.ensure_exchange_live_ready()
+    print("ensure_exchange_live_ready =", ok, repr(reason))
+    if not ok:
+        print("跳过私有接口探测")
+        return 1
+
+    mod.ensure_markets_loaded()
+
+    k = (os.getenv("GATE_API_KEY") or "").strip()
+    s = (os.getenv("GATE_API_SECRET") or "").strip()
+    if not k or "REPLACE" in k.upper():
+        print("WARN: GATE_API_KEY 为空或仍像占位符,请核对 .env")
+    if not s or "REPLACE" in s.upper():
+        print("WARN: GATE_API_SECRET 为空或仍像占位符,请核对 .env")
+    print("GATE_API_KEY prefix (8 chars):", (k[:8] + "…") if len(k) > 8 else "(short)")
+
+    # 0) swap — 与 App「交易账户」余额同源(优先看此项是否与网页一致)
+    try:
+        bal = mod.exchange.fetch_balance({"type": "swap"})
+        v0 = mod._extract_usdt_total(bal)
+        print("[0] fetch_balance(swap) USDT total =", v0)
+    except Exception as e:
+        print("[0] fetch_balance(swap) FAILED:", type(e).__name__, e)
+
+    # 1) fetch_balance spot + marginMode spot
+    try:
+        bal = mod.exchange.fetch_balance({"type": "spot", "marginMode": "spot"})
+        v = mod._extract_usdt_total(bal)
+        print("[1] fetch_balance(spot,marginMode=spot) USDT total =", v)
+    except Exception as e:
+        print("[1] fetch_balance(spot) FAILED:", type(e).__name__, e)
+
+    # 2) raw spot accounts
+    try:
+        resp = mod.exchange.privateSpotGetAccounts({})
+        v2 = mod._parse_gate_spot_accounts_response_usdt(resp)
+        print("[2] privateSpotGetAccounts USDT =", v2)
+    except Exception as e:
+        print("[2] privateSpotGetAccounts FAILED:", type(e).__name__, e)
+
+    # 3) unified accounts raw
+    try:
+        raw = mod.exchange.privateUnifiedGetAccounts({})
+        body = raw
+        if isinstance(body, dict) and isinstance(body.get("result"), dict):
+            body = body["result"]
+        if isinstance(body, dict):
+            keys = sorted(body.keys())
+            print("[3] unified top-level keys (sample):", keys[:25], "..." if len(keys) > 25 else "")
+        v3 = mod._parse_usdt_from_gate_unified_accounts_body(body) if isinstance(body, dict) else None
+        print("[3] parsed unified USDT =", v3)
+    except Exception as e:
+        print("[3] privateUnifiedGetAccounts FAILED:", type(e).__name__, e)
+
+    fu = mod._fetch_gate_funding_usdt()
+    print(">>> _fetch_gate_funding_usdt() =", fu)
+    f, t = mod.get_exchange_capitals(force=True)
+    print(">>> get_exchange_capitals(force=True) funding, trading =", f, t)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

crypto_monitor_gate/static/icons/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <rect width="512" height="512" rx="108" fill="#0c1019"/>
+  <rect x="36" y="36" width="440" height="440" rx="88" fill="#141b2d"/>
+  <rect x="36" y="36" width="440" height="440" rx="88" fill="none" stroke="#17E6A1" stroke-width="12"/>
+  <text x="256" y="310" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="220" font-weight="700" fill="#17E6A1">G</text>
+</svg>

crypto_monitor_gate/static/icons/manifest.webmanifest

@@ -0,0 +1,23 @@
+{
+  "name": "Gate 交易系统",
+  "short_name": "Gate 交易系统",
+  "description": "Gate 永续交易监控与复盘",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#0b0d14",
+  "theme_color": "#17E6A1",
+  "icons": [
+    {
+      "src": "/static/icons/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "/static/icons/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any maskable"
+    }
+  ]
+}

crypto_monitor_gate/templates/key_focus.html

@@ -0,0 +1 @@
+ok2

crypto_monitor_gate/templates/order_focus.html

@@ -0,0 +1,194 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+    <meta charset="UTF-8">
+    <title>实盘下单放大 | 100根K线</title>
+    <style>
+        *{margin:0;padding:0;box-sizing:border-box}
+        body{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,sans-serif;background:#0b0d14;color:#eaeaea;padding:14px}
+        .container{width:min(98vw,1900px);margin:0 auto}
+        .card{background:#121726;border-radius:10px;padding:12px;border:1px solid #2a3150;margin-bottom:12px}
+        .row{display:flex;gap:8px;align-items:center;flex-wrap:wrap}
+        .btn{padding:7px 10px;border-radius:8px;text-decoration:none;border:1px solid #304164;background:#151a2a;color:#8fc8ff;cursor:pointer}
+        .btn:hover{background:#1f2740}
+        select,button{padding:8px 10px;border-radius:8px;border:1px solid #2e2e45;background:#1a1a29;color:#fff}
+        .meta{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:8px;margin-top:10px}
+        .meta-item{background:#141b2f;border:1px solid #27324e;border-radius:8px;padding:8px}
+        .meta-item .k{font-size:.76rem;color:#9fb0d8}
+        .meta-item .v{font-size:1rem;margin-top:4px;word-break:break-all}
+        .status{font-size:.84rem;color:#95a2c2}
+        .status.err{color:#ff8080}
+        #chart-wrap{height:560px;background:#0f1320;border:1px solid #2a3150;border-radius:10px;padding:8px}
+        #chart{width:100%;height:100%}
+        .empty{padding:18px;color:#95a2c2}
+    </style>
+</head>
+<body>
+<div class="container">
+    <div class="card">
+        <div class="row" style="justify-content:space-between">
+            <div class="row">
+                <a class="btn" href="/">返回首页</a>
+                <strong style="color:#dbe4ff">实盘下单放大(100根K线)</strong>
+            </div>
+            <div class="status">最近刷新:<span id="updated-at">--</span></div>
+        </div>
+        {% if orders %}
+        <div class="row" style="margin-top:10px">
+            <label>订单</label>
+            <select id="order-id">
+                {% for o in orders %}
+                <option value="{{ o.id }}" {% if selected_order and o.id == selected_order.id %}selected{% endif %}>
+                    #{{ o.id }} {{ o.symbol }} {{ '做多' if o.direction == 'long' else '做空' }}
+                </option>
+                {% endfor %}
+            </select>
+            <label>周期</label>
+            <select id="timeframe">
+                {% for tf in ['1m','3m','5m','15m','30m','1h','4h','1d'] %}
+                <option value="{{ tf }}" {% if tf == default_timeframe %}selected{% endif %}>{{ tf }}</option>
+                {% endfor %}
+            </select>
+            <button id="manual-refresh" type="button">刷新</button>
+            <span id="load-status" class="status"></span>
+        </div>
+        {% else %}
+        <div class="empty">当前没有激活订单,无法展示放大K线.</div>
+        {% endif %}
+    </div>
+
+    {% if orders %}
+    <div class="card">
+        <div class="meta">
+            <div class="meta-item"><div class="k">交易对</div><div class="v" id="m-symbol">-</div></div>
+            <div class="meta-item"><div class="k">方向</div><div class="v" id="m-direction">-</div></div>
+            <div class="meta-item"><div class="k">成交价</div><div class="v" id="m-entry">-</div></div>
+            <div class="meta-item"><div class="k">止损</div><div class="v" id="m-sl">-</div></div>
+            <div class="meta-item"><div class="k">止盈</div><div class="v" id="m-tp">-</div></div>
+            <div class="meta-item"><div class="k">盈亏比</div><div class="v" id="m-rr">-</div></div>
+            <div class="meta-item"><div class="k">现价</div><div class="v" id="m-price">-</div></div>
+            <div class="meta-item"><div class="k">浮盈亏</div><div class="v" id="m-pnl">-</div></div>
+        </div>
+    </div>
+
+    <div class="card">
+        <div id="chart-wrap"><div id="chart"></div></div>
+    </div>
+    {% endif %}
+</div>
+
+{% if orders %}
+<script src="https://unpkg.com/lightweight-charts/dist/lightweight-charts.standalone.production.js"></script>
+<script>
+const refreshMs = Math.max({{ price_refresh_seconds * 1000 }}, 5000);
+const orderSelect = document.getElementById("order-id");
+const tfSelect = document.getElementById("timeframe");
+const statusEl = document.getElementById("load-status");
+const updatedAtEl = document.getElementById("updated-at");
+const chartHost = document.getElementById("chart");
+const fmt = (v, d=6) => (v === null || typeof v === "undefined" || Number.isNaN(Number(v))) ? "-" : Number(v).toFixed(d);
+
+let chart = null;
+let candleSeries = null;
+let priceLines = [];
+
+function ensureChart(){
+    if(chart){ return true; }
+    if(!window.LightweightCharts){
+        statusEl.className = "status err";
+        statusEl.innerText = "图表库加载失败";
+        return false;
+    }
+    chart = LightweightCharts.createChart(chartHost, {
+        layout: { background: { color: "#0f1320" }, textColor: "#d6deff" },
+        grid: { vertLines: { color: "#1e263d" }, horzLines: { color: "#1e263d" } },
+        rightPriceScale: { borderColor: "#2a3150" },
+        timeScale: { borderColor: "#2a3150", timeVisible: true, secondsVisible: false },
+        crosshair: { mode: 0 }
+    });
+    candleSeries = chart.addCandlestickSeries({
+        upColor: "#4cd97f",
+        downColor: "#ff6666",
+        borderVisible: false,
+        wickUpColor: "#4cd97f",
+        wickDownColor: "#ff6666"
+    });
+    window.addEventListener("resize", () => {
+        chart.applyOptions({ width: chartHost.clientWidth, height: chartHost.clientHeight });
+    });
+    chart.applyOptions({ width: chartHost.clientWidth, height: chartHost.clientHeight });
+    return true;
+}
+
+function resetPriceLines(){
+    if(!candleSeries){ return; }
+    priceLines.forEach(line => {
+        try { candleSeries.removePriceLine(line); } catch (_) {}
+    });
+    priceLines = [];
+}
+
+function addLine(price, title, color){
+    if(!candleSeries || typeof price === "undefined" || price === null){ return; }
+    const p = Number(price);
+    if(Number.isNaN(p) || p <= 0){ return; }
+    priceLines.push(candleSeries.createPriceLine({
+        price: p, color, lineWidth: 1, lineStyle: 0, axisLabelVisible: true, title
+    }));
+}
+
+function paintOrder(order){
+    document.getElementById("m-symbol").innerText = order.symbol || "-";
+    document.getElementById("m-direction").innerText = (order.direction === "short") ? "做空" : "做多";
+    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 = order.current_price_display || fmt(order.current_price, 8);
+    const pnlEl = document.getElementById("m-pnl");
+    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");
+}
+
+async function loadOrderKline(){
+    if(!ensureChart()){ return; }
+    const orderId = orderSelect.value;
+    const timeframe = tfSelect.value;
+    if(!orderId){ return; }
+    statusEl.className = "status";
+    statusEl.innerText = "加载中...";
+    try{
+        const resp = await fetch(`/api/order_kline?order_id=${encodeURIComponent(orderId)}&timeframe=${encodeURIComponent(timeframe)}`);
+        const data = await resp.json();
+        if(!resp.ok || !data.ok){ throw new Error(data.msg || "请求失败"); }
+        const candles = Array.isArray(data.candles) ? data.candles : [];
+        if(!candles.length){
+            statusEl.className = "status err";
+            statusEl.innerText = "暂无K线数据";
+            return;
+        }
+        candleSeries.setData(candles);
+        resetPriceLines();
+        addLine(data.order.trigger_price, "成交价", "#42a5f5");
+        addLine(data.order.stop_loss, "止损", "#ff6666");
+        addLine(data.order.take_profit, "止盈", "#4cd97f");
+        chart.timeScale().fitContent();
+        paintOrder(data.order || {});
+        updatedAtEl.innerText = data.updated_at || "--";
+        statusEl.className = "status";
+        statusEl.innerText = `已加载 ${candles.length} 根K线`;
+    }catch(err){
+        statusEl.className = "status err";
+        statusEl.innerText = err && err.message ? err.message : "加载失败";
+    }
+}
+
+document.getElementById("manual-refresh").addEventListener("click", loadOrderKline);
+orderSelect.addEventListener("change", loadOrderKline);
+tfSelect.addEventListener("change", loadOrderKline);
+loadOrderKline();
+setInterval(loadOrderKline, refreshMs);
+</script>
+{% endif %}
+</body>
+</html>

crypto_monitor_gate/使用说明.md

@@ -0,0 +1,147 @@
+# 使用说明
+
+**本文件对应仓库:`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

@@ -0,0 +1,192 @@
+# 关键位监控说明(自动开仓 + 人工盯盘)
+
+**适用: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

@@ -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 / **各执行一次** `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 已挂上;平仓后交易记录止损(开仓)与开仓类型是否正确.

crypto_monitor_gate/部署文档.md

@@ -0,0 +1,305 @@
+# `crypto_monitor_gate` 部署指南:SSH SOCKS + Gate.io + PM2(Ubuntu)
+
+Ubuntu 环境(Python / Node / PM2,/opt 路径)见 **[docs/ubuntu-server.md](../docs/ubuntu-server.md)**.
+
+本文面向:**在本机运行本项目**,但 **直连 Gate.io API 不稳定或被重置** 的场景.思路是:
+
+- 本机用 `ssh -D` 做动态转发,把 **SOCKS5 出口**放到能正常访问 Gate 的机器(常见为一台境外 VPS)
+- 项目在 `.env` 中设置 **`GATE_SOCKS_PROXY=socks5h://127.0.0.1:1080`**(或你实际端口),`ccxt` 经 SOCKS 访问交易所
+- **SSH 隧道**:用 `ssh -D` 在本机常驻(可用 **tmux** 或 **autossh** 保持连接),**不要** 把 `ssh` 交给 PM2
+- 使用 **PM2** 仅托管 **Flask 应用**;仓库根目录 **`ecosystem.config.cjs`** 只定义 `crypto-monitor-gate`
+
+> 安全提醒:不要把 `.env`,私钥 `.pem`,Gate API Key 提交到 Git;下文只用占位符.
+
+---
+
+## 0. 你需要准备的东西
+
+- 一台 **Ubuntu**(或同类 Linux)运行项目的机器(下文称「本机」)
+- 一台可 SSH 登录,且 **能正常访问 Gate.io API** 的 VPS(示例:`HostName` 填你的服务器 IP,用户如 `root`)
+- SSH:**私钥登录**(推荐,便于隧道脚本无人值守)
+- 本机已安装:`python3`,`python3-venv`,`pip`,`curl`,`ssh`,`git`(可选),`node` + `npm`(安装 PM2)
+
+---
+
+## 1. 获取代码与目录
+
+将包含 `app.py` 的项目放到固定目录,例如:
+
+```bash
+mkdir -p /opt/crypto_monitor_user
+cd /opt/crypto_monitor_user
+git clone https://git.bz121.com/dekun/crypto_monitor_user.git
+cd crypto_monitor/crypto_monitor_gate
+```
+
+下文用 **`/opt/crypto_monitor_user/crypto_monitor_gate`** 仅为示例,请换成你的实际绝对路径.
+
+拉取代码后,若目录下尚无 `.env`:
+
+```bash
+cp -n .env.example .env
+```
+
+---
+
+## 2. 配置 SSH 私钥与 `~/.ssh/config`
+
+```bash
+mkdir -p ~/.ssh
+chmod 700 ~/.ssh
+# 私钥示例:~/.ssh/vps1.pem
+chmod 600 ~/.ssh/vps1.pem
+```
+
+编辑 `~/.ssh/config`(示例别名 **`gate-vps`**,与你手工启动 `ssh -D ... gate-vps` 一致即可):
+
+```sshconfig
+Host gate-vps
+  HostName 你的_VPS_IP
+  User root
+  IdentityFile ~/.ssh/vps1.pem
+  IdentitiesOnly yes
+  ServerAliveInterval 30
+  ServerAliveCountMax 3
+  ExitOnForwardFailure yes
+  BatchMode yes
+```
+
+测试:
+
+```bash
+ssh gate-vps true
+```
+
+> 若尚未完全改为密钥登录,可暂时注释 `BatchMode yes`,调试完成后再打开.
+
+---
+
+## 3. 手工验证:SSH SOCKS + Gate API
+
+### 3.1 本地 SOCKS(示例端口 1080)
+
+```bash
+ssh -N -D 127.0.0.1:1080 gate-vps
+```
+
+保持运行,另开终端继续.
+
+### 3.2 验证经 SOCKS 可访问 Gate
+
+```bash
+curl -4 -sS --max-time 15 --proxy socks5h://127.0.0.1:1080 https://api.gateio.ws/api/v4/spot/time
+```
+
+应返回 JSON(含服务器时间字段).若此处失败,**不要先启动应用**:先修隧道或 VPS 出站.
+
+---
+
+## 4. Python 虚拟环境
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_gate
+
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install -U pip
+pip install flask requests ccxt werkzeug PySocks Pillow
+```
+
+走 SOCKS 时 **必须** 安装 **`PySocks`**,否则易出现代理相关报错.
+
+可选:
+
+```bash
+export PYTHONDONTWRITEBYTECODE=1
+```
+
+---
+
+## 5. 配置环境变量(`.env.example` → `.env`)
+
+| 文件 | 是否进 Git | 说明 |
+|------|------------|------|
+| **`.env.example`** | ✅ 是 | 变量模板与注释,可随 `git pull` 更新 |
+| **`.env`** | ❌ 否 | 本机真实配置;`app.py` **只读此文件** |
+
+### 5.1 首次配置
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_gate
+
+cp -n .env.example .env
+nano .env
+```
+
+### 5.2 备份与 `git pull`
+
+- **`.env` 不在 Git 中**:`git pull` **不会**覆盖本地 `.env`.
+- 远端若更新 **`.env.example`**,pull 后请**手动**把新增变量补进你的 `.env`.
+- **升级前备份**:`cp .env .env.backup.$(date +%Y%m%d)`;恢复:`cp .env.backup.YYYYMMDD .env`.
+- **换机**:`scp` 复制 `.env`,或新机 `cp .env.example .env` 后重填.
+
+### 5.3 AI 复盘与模型(可选)
+
+共用根目录 **`ai_client.py`**(`PYTHONPATH=..`).`.env` 中 **`AI_PROVIDER=openai`**(默认)时使用 `OPENAI_API_BASE=https://op.bz121.com/v1`,`OPENAI_API_KEY`,`OPENAI_MODEL=gemma4:e4b`;改 **`ollama`** 则用 `OLLAMA_API` + `AI_MODEL`.详见 **[AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)**.
+
+### 5.4 自动备份(数据库 + 复盘图片)
+
+与 Binance 实例相同:每天 **北京时间 0:00** → **`/root/backups`**,保留 **30 天**.
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_gate
+chmod +x scripts/backup_data.sh scripts/install_backup_cron.sh
+bash scripts/install_backup_cron.sh
+bash scripts/backup_data.sh   # 试跑
+```
+
+备份目录:`/root/backups/crypto_monitor_gate/YYYY-MM-DD/`.详见 Binance 项目 `部署文档.md` 第 5.4 节(恢复步骤,可选 `.env` 变量相同).
+
+若还部署了 **`crypto_monitor_okx`**,请在该目录同样执行 `bash scripts/install_backup_cron.sh`.
+
+### 5.5 必填项检查(Gate + 代理)
+
+与交易所相关的变量必须是 **Gate** 前缀(**不要**再写 OKX 变量,否则代理不会生效,密钥也不会被识别).至少确认:
+
+```env
+APP_HOST=127.0.0.1
+APP_PORT=5000
+
+# 实盘(按需)
+LIVE_TRADING_ENABLED=false
+GATE_API_KEY=你的_Key
+GATE_API_SECRET=你的_Secret
+
+# 经本机 SSH 动态转发访问 Gate(端口与隧道一致)
+GATE_SOCKS_PROXY=socks5h://127.0.0.1:1080
+
+# 若不用 SOCKS,可改用 HTTP 代理(一般二选一)
+# GATE_HTTP_PROXY=http://127.0.0.1:7890
+# GATE_HTTPS_PROXY=http://127.0.0.1:7890
+```
+
+说明:**推荐 `socks5h://`**,由 SOCKS 端解析域名,与 `curl --proxy socks5h://...` 行为一致.
+
+---
+
+## 6. 手工启动 Flask(验证)
+
+1. SOCKS 已监听 `127.0.0.1:1080`
+2. 已 `source .venv/bin/activate`
+3. `.env` 已含 `GATE_SOCKS_PROXY`
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_gate
+source .venv/bin/activate
+python app.py
+```
+
+浏览器访问:`http://127.0.0.1:5000`(或你在 `.env` 中的端口).
+
+---
+
+## 7. 安装 PM2
+
+```bash
+sudo npm i -g pm2
+pm2 -v
+```
+
+---
+
+## 8. PM2:使用仓库内 `ecosystem.config.cjs`(推荐)
+
+在项目根目录:
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_gate
+pm2 start ecosystem.config.cjs
+pm2 status
+pm2 logs --lines 200
+```
+
+默认只启动 **`crypto-monitor-gate`**(`.venv/bin/python app.py`).
+
+### 本机已可直连 Gate,不需要隧道时
+
+`.env` 里应 **去掉或留空** `GATE_SOCKS_PROXY`(除非仍要走别的代理),再 `pm2 start ecosystem.config.cjs`.
+
+### 开机自启
+
+```bash
+pm2 save
+pm2 startup
+# 按屏幕提示执行一条 sudo 命令
+```
+
+---
+
+## 9. 等价手工命令(不使用 ecosystem 文件时)
+
+### 9.1 SSH SOCKS(自行后台常驻,不推荐用 PM2)
+
+示例(前台调试;生产请用 **PM2**,见本文与 [docs/ubuntu-server.md](../docs/ubuntu-server.md)):
+
+```bash
+ssh -N -D 127.0.0.1:1080 gate-vps \
+  -o ServerAliveInterval=30 -o ServerAliveCountMax=3 \
+  -o ExitOnForwardFailure=yes
+```
+
+### 9.2 Flask
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_gate
+pm2 start /opt/crypto_monitor_user/crypto_monitor_gate/.venv/bin/python --name crypto-monitor-gate -- \
+  /opt/crypto_monitor_user/crypto_monitor_gate/app.py
+```
+
+---
+
+## 10. 交易所「连接不上」排查清单
+
+1. **`.env` 是否为 Gate 变量**:必须是 `GATE_SOCKS_PROXY` / `GATE_API_KEY` / `GATE_API_SECRET`,不是 OKX.
+2. **隧道是否在本机端口监听**(若配置了 `GATE_SOCKS_PROXY`):
+   ```bash
+   ss -lntp | grep 1080 || true
+   ```
+3. **curl 复测 Gate**(与第 3.2 节相同);curl 不通则应用也不会通.
+4. **PySocks**:`pip show PySocks`,缺失则 `pip install PySocks`.
+5. **SSH 隧道连不上**:检查私钥权限,`~/.ssh/config`,VPS 出站与端口是否与 `.env` 一致.
+6. **启动顺序**:先保证 SOCKS 已监听,再 `pm2 start` 应用(或重启应用).
+
+---
+
+## 11. 推荐启动顺序(习惯)
+
+1. 若走代理:先启动并确认 SSH SOCKS 已监听,再 `curl --proxy socks5h://127.0.0.1:1080 https://api.gateio.ws/api/v4/spot/time` 成功
+2. `pm2 start ecosystem.config.cjs`
+3. 再确认页面与余额等接口正常
+
+---
+
+## 12. 免责声明
+
+交易所有合规与地区政策要求.请确保使用方式符合当地法律法规与交易所条款.本文仅描述网络与工程部署路径.
+
+---
+
+## 附录:数据库标签修复脚本 `scripts/fix_breakeven_labels.py`
+
+在 Ubuntu 上:
+
+1)预览(不写库):
+
+```bash
+python scripts/fix_breakeven_labels.py --db ./crypto.db --dry-run
+```
+
+2)确认后执行:
+
+```bash
+python scripts/fix_breakeven_labels.py --db ./crypto.db --apply
+```
+
+默认修复条件:`monitor_type='下单监控'` 且 `result='止损'` 且 `pnl_amount > 0` → 改为 `result='保本止盈'`.

crypto_monitor_okx/.env.example

@@ -0,0 +1,276 @@
+# =============================================================================
+# 环境配置模板(可提交 Git).程序运行时只读取同目录下的 .env.
+#
+# 首次部署 / 新机:
+#   cp .env.example .env
+#   nano .env          # 填入真实密钥,端口,代理等
+#
+# 升级代码(git pull)前建议备份(.env 不在 Git 中,pull 不会覆盖):
+#   cp .env .env.backup.$(date +%Y%m%d)
+#
+# 从备份恢复:
+#   cp .env.backup.YYYYMMDD .env
+# =============================================================================
+
+APP_ENV=production
+# 服务监听地址(云服务器通常用 0.0.0.0)
+APP_HOST=0.0.0.0
+# 服务端口
+APP_PORT=5004
+# 是否开启调试模式(生产建议 false)
+APP_DEBUG=false
+
+# 登录账号
+APP_USERNAME=admin
+# 登录密码(请改成你自己的强密码)
+APP_PASSWORD=admin123
+# 是否关闭登录校验(局域网可设 true;公网务必 false)
+APP_AUTH_DISABLED=true
+# --- 多账户交易中控 manual_trading_hub ---
+# 中控请求本实例 /api/hub/* 时携带请求头 X-Hub-Token,须与中控启动环境变量 HUB_BRIDGE_TOKEN 一致
+# 未设置且 APP_AUTH_DISABLED=false 时,仅网页登录后可访问;本机联调可保持 APP_AUTH_DISABLED=true
+# HUB_BRIDGE_TOKEN=your-long-random-token
+# 允许复盘中控 iframe 内嵌本实例(与 hub 域名一致;默认已开启)
+# APP_ALLOW_HUB_EMBED=true
+# HUB_EMBED_PARENT_ORIGINS=https://hub.example.com
+# HTTPS 且经 iframe 打开时建议 true;不设则 hub-sso 在 HTTPS 下也会自动尝试 SameSite=None
+# APP_COOKIE_SECURE=true
+# Flask 会话密钥(必须替换为长随机字符串)
+FLASK_SECRET_KEY=CHANGE_TO_LONG_RANDOM_SECRET
+
+# 企业微信机器人 Webhook(用于行情/风控推送)
+WECHAT_WEBHOOK=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=REPLACE_WITH_REAL_KEY
+
+# 数据库文件路径(相对路径会自动按项目目录解析)
+DB_PATH=crypto.db
+# 交易截图上传目录
+UPLOAD_DIR=static/images
+
+# 自动备份(scripts/backup_data.sh + cron,可选;默认即可)
+# BACKUP_ROOT=/root/backups
+# BACKUP_RETENTION_DAYS=30
+# BACKUP_INSTANCE=crypto_monitor_okx
+
+# 训练总资金(U)
+# TOTAL_CAPITAL=100  # 已弃用,资金展示读交易所
+# 计仓:risk=以损定仓(默认);full_margin=合约可用×FULL_MARGIN_BUFFER_RATIO 全仓杠杆(须无仓后重启)
+POSITION_SIZING_MODE=risk
+# 方向限制(默认 false=双向均可;true 时按 TRADE_DIRECTION 限制,修改后须重启)
+# TRADE_DIRECTION=long_only | short_only | both(或 多/空/双向)
+TRADE_DIRECTION_RESTRICT_ENABLED=false
+TRADE_DIRECTION=both
+# 币种白名单(默认 false=全币种可手输;true 时关键位/下单/策略仅下拉选择)
+TRADE_SYMBOL_RESTRICT_ENABLED=false
+TRADE_SYMBOL_WHITELIST=BTC,ETH
+# 每天起始基数(U)
+DAILY_START_CAPITAL=30
+# 日内回撤后基数(U)
+DAILY_LOSS_CAPITAL=20
+# 日内盈利后基数(U)
+DAILY_PROFIT_CAPITAL=50
+# BTC 默认杠杆倍数
+BTC_LEVERAGE=10
+# 山寨币默认杠杆倍数
+ALT_LEVERAGE=5
+# 交易日重置小时(北京时间)
+TRADING_DAY_RESET_HOUR=8
+# 整点前禁止新开仓:true=启用(默认),false=关闭(仍可保留 8 点作为交易日划分)
+TRADING_DAY_RESET_OPEN_GUARD_ENABLED=true
+
+# 是否开启 OKX 实盘下单(false=只做本地流程,true=真实下单)
+LIVE_TRADING_ENABLED=true
+# OKX API Key(实盘)
+OKX_API_KEY=REPLACE_WITH_OKX_API_KEY
+# OKX API Secret(实盘)
+OKX_API_SECRET=REPLACE_WITH_OKX_API_SECRET
+# OKX API Passphrase(实盘)
+OKX_API_PASSPHRASE=REPLACE_WITH_OKX_API_PASSPHRASE
+# 保证金模式:cross=全仓,isolated=逐仓
+OKX_TD_MODE=cross
+# 持仓模式:hedge=双向持仓,net=单向净持仓
+OKX_POS_MODE=hedge
+# 仓位查询 instType(OKX)
+OKX_POSITION_INST_TYPE=SWAP
+# 从 OKX 历史仓位同步已实现盈亏(北京时间起点,空=近 90 天 0 点起)
+# EXCHANGE_POSITION_SYNC_FROM_BJ=2026-01-01
+# 单次拉取历史仓位条数上限(OKX 每页最多 100,程序会分页)
+# EXCHANGE_POSITION_HISTORY_LIMIT=200
+# 页面与浏览器标签展示的交易所名称(多环境区分时可改成例如 OKX·测试网)
+EXCHANGE_DISPLAY_NAME=OKX
+# 企业微信推送里展示的账户备注
+# OKX_ACCOUNT_LABEL=
+
+# =============================================================================
+# 期权(主账户 API,与永续子账户 OKX_API_* 分离;修改后须重启 PM2)
+# 详见 docs/期权方案.md 与 docs/期权用法.md
+# =============================================================================
+OKX_OPTIONS_ENABLED=false
+OKX_OPTIONS_API_KEY=
+OKX_OPTIONS_API_SECRET=
+OKX_OPTIONS_API_PASSPHRASE=
+OKX_OPTIONS_ACCOUNT_LABEL=主账户·期权
+OKX_OPTIONS_TRADE_BUDGET_USDC=10
+OKX_OPTIONS_BUDGET_BUFFER=0.95
+OKX_OPTIONS_DEFAULT_UNDERLY=ETH
+OKX_OPTIONS_MAX_DTE_DAYS=2
+OKX_OPTIONS_CHAIN_MAX_DTE_DAYS=14
+OKX_SUB_ACCOUNT_NAME=
+OKX_OPTIONS_ITM_MAX_DIST_USD=30
+OKX_OPTIONS_PROFIT_ALERT_RATIO=1.0
+OKX_OPTIONS_POLL_SECONDS=15
+OKX_OPTIONS_TD_MODE=isolated
+OKX_OPTIONS_ALLOW_MARKET_CLOSE=false
+
+# =============================================================================
+# 对冲计划(仅 OKX;前端 env「对冲计划」;详见 docs/对冲计划开发方案.md)
+# =============================================================================
+HEDGE_PLAN_ENABLED=false
+HEDGE_PLAN_LIVE_ORDER=false
+HEDGE_PLAN_OPEN_ORDER=options_first
+HEDGE_PLAN_ON_PERP_SL_CLOSE_OPTIONS=true
+HEDGE_PLAN_ON_PERP_TP_CLOSE_OPTIONS=false
+HEDGE_PLAN_OO_CLOSE_WINNER_ONLY=true
+MAX_ACTIVE_HEDGE_PLANS=1
+HEDGE_PLAN_MONITOR_POLL_SECONDS=15
+HEDGE_PLAN_PARTIAL_AUTO_CLOSE_OPTION=true
+
+# =============================================================================
+# 关键位程序自动下单(与 POSITION_SIZING_MODE 联动,修改后须重启 PM2)
+# =============================================================================
+# 默认 false = 关闭所有关键位程序自动单(箱体/收敛/斐波/假突破/触价)
+#
+#   POSITION_SIZING_MODE=risk(以损定仓)
+#     false → 不执行任何关键位自动单;支撑/阻力提醒,人工下单,顺势加仓不受影响
+#     true  → 允许关键位全套自动(含触价)
+#
+#   POSITION_SIZING_MODE=full_margin(全仓杠杆,须无仓切换)
+#     false → 不执行触价自动单
+#     true  → 仅回调/突破触价可程序自动开仓;箱体/斐波等仍禁止
+#
+# 顺势加仓,趋势回调不受本开关控制;全仓模式下策略自动仍禁止.
+KEY_AUTO_ORDER_ENABLED=false
+
+# =============================================================================
+# 关键位门控(页面「关键位监控」规则条与 _key_hard_checks 共用)
+# =============================================================================
+# 【周期】门控 K 线周期,如 5m,15m;仅影响关键位硬条件,不改变顶栏分区
+KLINE_TIMEFRAME=5m
+# OKX 遗留:突破过滤百分比(与 KEY_BREAKOUT_AMP_* 并存,程序仍读取)
+KEY_BREAKOUT_LIMIT_PCT=1.5
+# 【确认K】闭合 K 序列中的棒偏移:突破棒默认 -2(倒数第2根),确认棒默认 -1(倒数第1根)
+KEY_CONFIRM_BREAKOUT_BAR=-2
+KEY_CONFIRM_BAR=-1
+# 【量能】突破棒成交量 > 前 N 根均量 × 倍数(默认 N=20,倍数=1.3 即放大 30%)
+KEY_VOLUME_MA_BARS=20
+KEY_VOLUME_RATIO_MIN=1.3
+# 【箱体/收敛】突破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
+# 【关键位自动开仓盈亏比】按确认K收盘 E 计算,严格大于该值才市价开仓(如 1.5 表示须 >1.5:1)
+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
+
+# =============================================================================
+# 交易执行 / 人工风控(页面「实盘下单」)
+# =============================================================================
+# 【最大同时持仓】active 订单数达到该值后禁止人工与关键位自动再加仓(默认 1=单仓)
+MAX_ACTIVE_POSITIONS=1
+# 【人工下单最低盈亏比】按当前价与 SL/TP 计算,低于该值前后端均拒绝(默认 1.4,即须 >=1.4:1)
+MANUAL_MIN_PLANNED_RR=1.4
+# 【关键位连开计仓】true=已有持仓时关键位自动单仍按「无仓时」资金快照算保证金基数
+KEY_SIZING_USE_ZERO_POSITION_SNAPSHOT=true
+# 【单日开仓 AI 提醒】本交易日开仓达到该次数时推送企业微信 AI 克制提醒(不拦单)
+DAILY_OPEN_ALERT_THRESHOLD=5
+# 【单日开仓硬上限】本交易日开仓次数>=该值后禁止一切新开仓直至下一交易日(北京时间 TRADING_DAY_RESET_HOUR 切日);0=不启用
+DAILY_OPEN_HARD_LIMIT=0
+
+# =============================================================================
+# 账户冷静期 / 日冻结风控(手动平仓,外部平仓,复盘情绪标签)
+# 详见 docs/account-risk-cooldown.md
+# =============================================================================
+RISK_CONTROL_ENABLED=true
+RISK_COOLING_HOURS_MANUAL=4
+RISK_COOLING_HOURS_MANUAL_JOURNAL=1
+RISK_MANUAL_CLOSE_DAILY_LIMIT=2
+RISK_MOOD_ISSUES_DAILY_FREEZE=true
+
+# 资金与仓位刷新周期(秒)
+BALANCE_REFRESH_SECONDS=60
+# 前端价格快照轮询(秒)
+PRICE_REFRESH_SECONDS=5
+# 后台监控轮询周期(秒)
+MONITOR_POLL_SECONDS=3
+# 移动保本同步交易所止盈止损的最小间隔(秒),避免频繁撤挂叠单
+BREAKEVEN_EXCHANGE_MIN_INTERVAL_SEC=60
+# 重启后多少秒内不做「外部平仓」同步(避免 API 未就绪误判)
+RECONCILE_STARTUP_GRACE_SEC=90
+# 连续多少次轮询确认交易所空仓后,才记为外部平仓(默认 3 次 ≈ 9 秒)
+RECONCILE_FLAT_CONFIRM_POLLS=3
+# 使用可用资金时的缓冲比例(如0.98代表用98%)
+FULL_MARGIN_BUFFER_RATIO=0.98
+
+# =============================================================================
+# 自动划转(页顶「将 swap 补足到 XU」;与 DAILY_START_CAPITAL 独立,需一致时请设为相同值)
+# =============================================================================
+AUTO_TRANSFER_ENABLED=false
+# 交易账户(swap)目标余额 U:每日 8 点(北京)自动划入或划出至 funding;持仓中不划转
+AUTO_TRANSFER_AMOUNT=30
+AUTO_TRANSFER_FROM=funding
+AUTO_TRANSFER_TO=swap
+TRANSFER_CCY=USDT
+# 北京时间该整点小时内尝试;账簿按 UTC 自然日去重
+AUTO_TRANSFER_BJ_HOUR=8
+# 强制清仓整点(北京时间,默认 0=凌晨00点)
+FORCE_CLOSE_BJ_HOUR=0
+# 是否启用强制清仓(默认关闭,true 才会在整点执行)
+FORCE_CLOSE_ENABLED=false
+
+# 推送与AI超时(秒)
+WECHAT_TIMEOUT_SECONDS=10
+AI_TIMEOUT_SECONDS=120
+
+# AI 复盘服务地址(本机 Ollama 默认地址)
+AI_PROVIDER=openai
+OPENAI_API_BASE=https://op.bz121.com/v1
+OPENAI_API_KEY=你的密钥
+OPENAI_MODEL=gemma4:e4b
+OLLAMA_API=http://127.0.0.1:11434/api/generate
+AI_MODEL=huihui_ai/deepseek-r1-abliterated:latest
+
+# OKX 代理(可选,仅本地开发网络受限时用;云服务器部署请留空,直连 OKX 即可)
+# 1) 先在本机建立隧道(示例):
+#    ssh -N -D 127.0.0.1:1080 root@你的VPS_IP -o ServerAliveInterval=30 -o ExitOnForwardFailure=yes
+# 2) 再启用下面这一行(推荐 socks5h,让远端解析域名):
+# OKX_SOCKS_PROXY=socks5h://127.0.0.1:1080
+#
+# 如你更偏向 HTTP 代理(VPS 上跑 tinyproxy 之类),可用:
+# OKX_HTTP_PROXY=http://127.0.0.1:3128
+# OKX_HTTPS_PROXY=http://127.0.0.1:3128
+
+# 开仓多周期K线图(可选)
+# ORDER_CHART_ENABLED=true
+# ORDER_CHART_TFS=4h,1h,15m,5m
+# ORDER_CHART_LIMIT=100
+# ORDER_CHART_DIR=static/images/order_charts
+# 详见上文 DAILY_OPEN_ALERT_THRESHOLD / DAILY_OPEN_HARD_LIMIT;说明文档 docs/daily-open-limit.md
+# 以损定仓(按交易账户资金的百分比)
+# RISK_PERCENT=2
+# 移动保本触发(达到多少R触发)与偏移(百分比)
+# BREAKEVEN_RR_TRIGGER=1.0
+# 移动保本阶梯(每多少R继续上移一次,默认1R)
+# BREAKEVEN_STEP_R=1.0
+# BREAKEVEN_OFFSET_PCT=0.02
+# 开单风格默认值:trend / swing
+# DEFAULT_TRADE_STYLE=trend
+
+APP_TIMEZONE=Asia/Shanghai
+# TRADING_DAY_RESET_HOUR 现在表示「北京时间」整点,默认 8 点起算新交易日;开仓整点限制见 TRADING_DAY_RESET_OPEN_GUARD_ENABLED

crypto_monitor_okx/README.md

@@ -0,0 +1,53 @@
+# crypto_monitor_okx
+
+基于 **Flask** 的加密货币 **下单监控 / 关键位监控 / 交易复盘** 小系统,行情与实盘接口统一走 **OKX(USDT 永续)**,通过 **ccxt** 访问.功能与界面已与 **`crypto_monitor_binance`** 对齐(顶栏分栏,风控参数,交易所 TP/SL 管理等),差异主要在 **`.env` 的 `OKX_*` 变量** 与 OKX API(含 Passphrase).
+
+## 功能概要
+
+- **关键位监控**:`/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`**.
+
+## 运行
+
+```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/ecosystem.config.cjs

@@ -0,0 +1,34 @@
+/**
+ * PM2 进程定义(Ubuntu / Linux).
+ *
+ * 仅托管 Flask 应用.**SSH SOCKS 隧道**用 `ssh -D` 常驻(可用 tmux / autossh),勿交给 PM2.
+ * 与 `.env` 里 `OKX_SOCKS_PROXY` 端口一致即可;不必交给 PM2.
+ *
+ * 使用前:项目根目录存在 `.venv`,且已安装依赖(走 SOCKS 时需 PySocks).
+ *
+ * 启动:
+ *   pm2 start ecosystem.config.cjs
+ * 保存开机列表:
+ *   pm2 save && pm2 startup
+ */
+const path = require("path");
+
+const ROOT = __dirname;
+const REPO_ROOT = path.join(ROOT, "..");
+const PY = path.join(ROOT, ".venv", "bin", "python");
+
+module.exports = {
+  apps: [
+    {
+      name: "crypto_okx",
+      cwd: ROOT,
+      script: path.join(ROOT, "app.py"),
+      interpreter: PY,
+      instances: 1,
+      autorestart: true,
+      watch: false,
+      max_memory_restart: "800M",
+      env: { PYTHONPATH: REPO_ROOT },
+    },
+  ],
+};

crypto_monitor_okx/scripts/backup_data.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+# Daily backup: SQLite DB + static/images → /root/backups/<instance>/<YYYY-MM-DD>/
+# Prune backup folders older than RETENTION_DAYS (default 30).
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$PROJECT_DIR"
+
+BACKUP_ROOT="${BACKUP_ROOT:-/root/backups}"
+RETENTION_DAYS="${RETENTION_DAYS:-30}"
+INSTANCE_NAME="${BACKUP_INSTANCE:-$(basename "$PROJECT_DIR")}"
+TZ_NAME="${BACKUP_TZ:-Asia/Shanghai}"
+
+log() {
+  printf '[%s] %s\n' "$(TZ="$TZ_NAME" date '+%Y-%m-%d %H:%M:%S %Z')" "$*"
+}
+
+read_env_var() {
+  local key="$1"
+  local default="$2"
+  local line
+  if [[ ! -f .env ]]; then
+    printf '%s' "$default"
+    return
+  fi
+  line="$(grep -E "^${key}=" .env 2>/dev/null | tail -1 || true)"
+  if [[ -z "$line" ]]; then
+    printf '%s' "$default"
+    return
+  fi
+  printf '%s' "${line#*=}" | tr -d '\r'
+}
+
+resolve_project_path() {
+  local p="$1"
+  if [[ "$p" == /* ]]; then
+    printf '%s' "$p"
+  else
+    printf '%s' "$PROJECT_DIR/$p"
+  fi
+}
+
+prune_old_backups() {
+  local base="$BACKUP_ROOT/$INSTANCE_NAME"
+  [[ -d "$base" ]] || return 0
+  local cutoff
+  cutoff="$(TZ="$TZ_NAME" date -d "-${RETENTION_DAYS} days" +%Y-%m-%d 2>/dev/null || true)"
+  if [[ -z "$cutoff" ]]; then
+    find "$base" -mindepth 1 -maxdepth 1 -type d -mtime +"$RETENTION_DAYS" -print0 |
+      xargs -r -0 rm -rf
+    return 0
+  fi
+  local dir name
+  for dir in "$base"/*/; do
+    [[ -d "$dir" ]] || continue
+    name="$(basename "$dir")"
+    [[ "$name" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]] || continue
+    if [[ "$name" < "$cutoff" ]]; then
+      log "prune: remove $dir (older than ${RETENTION_DAYS} days)"
+      rm -rf "$dir"
+    fi
+  done
+}
+
+DB_REL="$(read_env_var DB_PATH crypto.db)"
+UPLOAD_REL="$(read_env_var UPLOAD_DIR static/images)"
+BACKUP_ROOT="$(read_env_var BACKUP_ROOT "$BACKUP_ROOT")"
+RETENTION_DAYS="$(read_env_var BACKUP_RETENTION_DAYS "$RETENTION_DAYS")"
+INSTANCE_NAME="$(read_env_var BACKUP_INSTANCE "$INSTANCE_NAME")"
+
+DB_PATH="$(resolve_project_path "$DB_REL")"
+UPLOAD_DIR="$(resolve_project_path "$UPLOAD_REL")"
+DATE_TAG="$(TZ="$TZ_NAME" date +%Y-%m-%d)"
+DEST="$BACKUP_ROOT/$INSTANCE_NAME/$DATE_TAG"
+
+if [[ ! -f "$DB_PATH" ]]; then
+  log "error: database not found: $DB_PATH"
+  exit 1
+fi
+
+mkdir -p "$DEST"
+log "start backup instance=$INSTANCE_NAME dest=$DEST"
+
+if command -v sqlite3 >/dev/null 2>&1; then
+  sqlite3 "$DB_PATH" ".backup '$DEST/crypto.db'"
+  log "db: sqlite3 backup -> $DEST/crypto.db"
+else
+  cp -a "$DB_PATH" "$DEST/crypto.db"
+  log "db: cp -> $DEST/crypto.db (sqlite3 not installed)"
+fi
+
+if [[ -d "$UPLOAD_DIR" ]]; then
+  tar -czf "$DEST/static_images.tar.gz" -C "$(dirname "$UPLOAD_DIR")" "$(basename "$UPLOAD_DIR")"
+  log "images: $UPLOAD_DIR -> $DEST/static_images.tar.gz"
+else
+  log "warn: upload dir missing, skip images: $UPLOAD_DIR"
+fi
+
+{
+  echo "instance=$INSTANCE_NAME"
+  echo "project_dir=$PROJECT_DIR"
+  echo "backup_date=$DATE_TAG"
+  echo "db_path=$DB_PATH"
+  echo "upload_dir=$UPLOAD_DIR"
+} >"$DEST/manifest.txt"
+
+prune_old_backups
+log "done"

crypto_monitor_okx/scripts/fix_breakeven_labels.py

@@ -0,0 +1,108 @@
+#!/usr/bin/env python3
+"""
+一次性修复历史交易记录标签:
+将 trade_records 里“止损但实际盈利”的记录改为“保本止盈”.
+
+默认条件(可通过参数修改):
+- monitor_type = 下单监控
+- result = 止损
+- pnl_amount > 0
+
+用法示例:
+1) 仅预览(不落库):
+   python scripts/fix_breakeven_labels.py --db ./crypto.db --dry-run
+
+2) 执行修复:
+   python scripts/fix_breakeven_labels.py --db ./crypto.db --apply
+"""
+
+from __future__ import annotations
+
+import argparse
+import sqlite3
+import sys
+from pathlib import Path
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description="Fix historical stop-loss records with positive pnl.")
+    parser.add_argument("--db", required=True, help="Path to sqlite db file, e.g. ./crypto.db")
+    parser.add_argument("--monitor-type", default="下单监控", help="Filter by monitor_type (default: 下单监控)")
+    parser.add_argument("--from-result", default="止损", help="Source result label (default: 止损)")
+    parser.add_argument("--to-result", default="保本止盈", help="Target result label (default: 保本止盈)")
+    parser.add_argument("--dry-run", action="store_true", help="Preview only, no write")
+    parser.add_argument("--apply", action="store_true", help="Execute update")
+    return parser.parse_args()
+
+
+def main() -> int:
+    args = parse_args()
+    db_path = Path(args.db).expanduser().resolve()
+    if not db_path.exists():
+        print(f"[ERR] DB not found: {db_path}")
+        return 1
+
+    if args.dry_run and args.apply:
+        print("[ERR] --dry-run and --apply are mutually exclusive.")
+        return 1
+    if not args.dry_run and not args.apply:
+        print("[INFO] No mode provided, defaulting to --dry-run.")
+        args.dry_run = True
+
+    conn = sqlite3.connect(str(db_path))
+    conn.row_factory = sqlite3.Row
+    cur = conn.cursor()
+
+    where_sql = """
+        monitor_type = ?
+        AND result = ?
+        AND CAST(COALESCE(pnl_amount, 0) AS REAL) > 0
+    """
+    params = (args.monitor_type, args.from_result)
+
+    cur.execute(f"SELECT COUNT(*) AS c FROM trade_records WHERE {where_sql}", params)
+    will_change = int(cur.fetchone()["c"])
+    print(f"[INFO] Candidate rows: {will_change}")
+
+    if will_change == 0:
+        print("[INFO] Nothing to update.")
+        conn.close()
+        return 0
+
+    cur.execute(
+        f"""
+        SELECT id, symbol, result, pnl_amount, closed_at
+        FROM trade_records
+        WHERE {where_sql}
+        ORDER BY id DESC
+        LIMIT 10
+        """,
+        params,
+    )
+    sample = cur.fetchall()
+    print("[INFO] Sample (latest 10):")
+    for r in sample:
+        print(
+            f"  id={r['id']} symbol={r['symbol']} result={r['result']} "
+            f"pnl={r['pnl_amount']} closed_at={r['closed_at']}"
+        )
+
+    if args.dry_run:
+        print("[DRY-RUN] No write executed.")
+        conn.close()
+        return 0
+
+    cur.execute(
+        f"UPDATE trade_records SET result=? WHERE {where_sql}",
+        (args.to_result, *params),
+    )
+    changed = int(cur.rowcount)
+    conn.commit()
+    conn.close()
+    print(f"[DONE] Updated rows: {changed}")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())
+

crypto_monitor_okx/scripts/install_backup_cron.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# Install daily backup cron: Beijing 00:00 (CRON_TZ=Asia/Shanghai).
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+BACKUP_SCRIPT="$SCRIPT_DIR/backup_data.sh"
+INSTANCE_NAME="${BACKUP_INSTANCE:-$(basename "$PROJECT_DIR")}"
+LOG_FILE="${BACKUP_CRON_LOG:-/var/log/crypto-monitor-backup-${INSTANCE_NAME}.log}"
+if [[ ! -x "$BACKUP_SCRIPT" ]]; then
+  chmod +x "$BACKUP_SCRIPT"
+fi
+
+TMP="$(mktemp)"
+trap 'rm -f "$TMP"' EXIT
+
+{
+  crontab -l 2>/dev/null | grep -vF "$BACKUP_SCRIPT" || true
+  echo "CRON_TZ=Asia/Shanghai"
+  echo "0 0 * * * $BACKUP_SCRIPT >> $LOG_FILE 2>&1"
+} >"$TMP"
+
+# Keep a single CRON_TZ line at top.
+awk '
+  BEGIN { tz = 0 }
+  /^CRON_TZ=Asia\/Shanghai$/ {
+    if (tz++) next
+  }
+  { print }
+' "$TMP" >"${TMP}.2"
+mv "${TMP}.2" "$TMP"
+
+crontab "$TMP"
+echo "Installed cron for $INSTANCE_NAME"
+echo "  Schedule : daily 00:00 Asia/Shanghai"
+echo "  Script   : $BACKUP_SCRIPT"
+echo "  Log      : $LOG_FILE"
+crontab -l | grep -F "$BACKUP_SCRIPT" || true

crypto_monitor_okx/scripts/verify_okx_funding.py

@@ -0,0 +1,52 @@
+#!/usr/bin/env python3
+"""
+  python scripts/verify_okx_funding.py
+
+打印 OKX_API_KEY 前 8 位便于与 Binance 控制台核对(不含 Secret).用于服务器自检.
+"""
+import os
+import sys
+
+BASE = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+sys.path.insert(0, BASE)
+
+
+def load_env(path):
+    if not os.path.exists(path):
+        return
+    for line in open(path, "r", encoding="utf-8", errors="ignore"):
+        line = line.strip()
+        if not line or line.startswith("#") or "=" not in line:
+            continue
+        k, v = line.split("=", 1)
+        k = k.strip().lstrip("\ufeff")
+        if k.replace("_", "").isalnum():
+            os.environ[k] = v.strip().strip('"').strip("'")
+
+
+def main():
+    load_env(os.path.join(BASE, ".env"))
+    k = (os.getenv("OKX_API_KEY") or "").strip()
+    s = (os.getenv("OKX_API_SECRET") or "").strip()
+    if not k or "REPLACE" in k.upper():
+        print("WARN: OKX_API_KEY 为空或仍像占位符,请核对 .env")
+    if not s or "REPLACE" in s.upper():
+        print("WARN: OKX_API_SECRET 为空或仍像占位符,请核对 .env")
+    print("OKX_API_KEY prefix (8 chars):", (k[:8] + "…") if len(k) > 8 else "(short)")
+
+    import app as mod  # noqa: E402
+
+    mod.ensure_markets_loaded()
+    fu = mod._fetch_okx_funding_usdt()
+    print(">>> _fetch_okx_funding_usdt() =", fu)
+    try:
+        sw = mod._fetch_okx_swap_usdt_total()
+        print(">>> _fetch_okx_swap_usdt_total() (合约账户) =", sw)
+        sf = mod._fetch_okx_swap_usdt_free()
+        print(">>> _fetch_okx_swap_usdt_free() (合约可用) =", sf)
+    except Exception as e:
+        print(">>> swap balance fetch error:", e)
+
+
+if __name__ == "__main__":
+    main()