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>

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()

crypto_monitor_okx/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="#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>

crypto_monitor_okx/static/icons/manifest.webmanifest

@@ -0,0 +1,23 @@
+{
+  "name": "OKX 交易系统",
+  "short_name": "OKX 交易系统",
+  "description": "OKX 永续交易监控与复盘",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#0b0d14",
+  "theme_color": "#FFFFFF",
+  "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_okx/templates/key_focus.html

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

crypto_monitor_okx/templates/order_focus.html

@@ -0,0 +1,195 @@
+<!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 = fmt(order.trigger_price, 8);
+    document.getElementById("m-sl").innerText = fmt(order.stop_loss, 8);
+    document.getElementById("m-tp").innerText = fmt(order.take_profit, 8);
+    const rr = order.rr_ratio;
+    document.getElementById("m-rr").innerText = (rr === null || typeof rr === "undefined") ? "-:1" : `${Number(rr).toFixed(2)}:1`;
+    document.getElementById("m-price").innerText = fmt(order.current_price, 8);
+    const pnlEl = document.getElementById("m-pnl");
+    pnlEl.innerText = `${fmt(order.float_pnl, 4)}U (${fmt(order.float_pct, 2)}%)`;
+    pnlEl.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_okx/使用说明.md

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

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

@@ -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_okx/更新文档.md

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

crypto_monitor_okx/部署文档.md

@@ -0,0 +1,367 @@
+# `crypto_monitor_okx` 部署文档(Ubuntu)
+
+**功能与页面操作** 见同目录 **[使用说明.md](./使用说明.md)**.Ubuntu 环境(Python / Node / PM2)见 **[docs/ubuntu-server.md](../docs/ubuntu-server.md)**.策略与 AI 见 **[策略交易说明.md](../策略交易说明.md)**,**[AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)**.
+
+---
+
+# 本地部署 + SSH SOCKS 转发 + PM2 启动指南(Ubuntu)
+
+本文面向:**本地 Ubuntu 机器运行项目**,但 **本机直连 OKX 会被 TLS/SNI reset** 的场景.解决思路是:
+
+- 本机启动 `ssh -D` 动态转发,把 **SOCKS5 出口**放到你可正常访问 OKX 的 VPS 上
+- 项目通过环境变量 `OKX_SOCKS_PROXY=socks5h://127.0.0.1:1080` 让 `ccxt` 走 SOCKS
+- **SSH 隧道**用 `ssh -D` 常驻(可用 tmux / autossh);**Flask 应用** 仅用 **PM2** 托管(见 [docs/ubuntu-server.md](../docs/ubuntu-server.md))
+
+> 安全提醒:不要把 `.env`,私钥 `.pem`,OKX API Key 提交到 Git;文档里只用占位符.
+
+---
+
+## 0. 你需要准备的东西
+
+- 一台 **Ubuntu** 本地机器(下文称“本机”)
+- 一台可 SSH 登录,且 **能正常访问 OKX** 的 VPS(示例公网 IP:`47.76.87.111`,用户:`root`)
+- VPS 登录方式:**SSH 私钥**(推荐)或密码(不推荐用于无人值守)
+- 本机已安装:
+  - `python3`,`python3-venv`,`pip`(或 `python3-pip`)
+  - `git`(可选)
+  - `curl`,`ssh`
+  - `node` + `npm`(用于安装 `pm2`)
+
+---
+
+## 1. 从云服务器把项目同步到本地(推荐:打包下载)
+
+在云服务器项目目录(包含 `app.py` 的目录)执行:
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_okx
+
+# 可选:清理 Python 缓存,减少小文件传输
+find . -type d -name __pycache__ -prune -exec rm -rf {} +
+find . -type f -name "*.pyc" -delete
+
+tar -czf crypto_monitor.tgz .
+```
+
+下载 `crypto_monitor.tgz` 到本机后解压:
+
+```bash
+mkdir -p /opt/crypto_monitor_user/crypto_monitor_okx
+cd /opt/crypto_monitor_user
+tar -xzf crypto_monitor.tgz -C crypto_monitor_okx
+cd crypto_monitor_okx
+cp -n .env.example .env    # 若尚无 .env
+```
+
+---
+
+## 2. 配置 SSH 私钥与 `~/.ssh/config`(推荐)
+
+把私钥放到本机(示例:`~/.ssh/vps1.pem`),并设置权限:
+
+```bash
+mkdir -p ~/.ssh
+chmod 700 ~/.ssh
+mv ~/Downloads/vps1.pem ~/.ssh/vps1.pem
+chmod 600 ~/.ssh/vps1.pem
+```
+
+编辑 `~/.ssh/config`(没有就创建),添加:
+
+```sshconfig
+Host okx-vps
+  HostName 47.76.87.111
+  User root
+  IdentityFile ~/.ssh/vps1.pem
+  IdentitiesOnly yes
+  ServerAliveInterval 30
+  ServerAliveCountMax 3
+  ExitOnForwardFailure yes
+  BatchMode yes
+```
+
+测试:
+
+```bash
+ssh okx-vps true
+```
+
+> 如果你还没完全切到密钥登录(还会交互要密码),先把 `BatchMode yes` 注释掉,等密钥登录稳定后再打开.
+
+---
+
+## 3. 先手工验证:SSH SOCKS + OKX API
+
+### 3.1 开一个本地 SOCKS(1080)
+
+```bash
+ssh -N -D 127.0.0.1:1080 okx-vps
+```
+
+保持该进程运行(另开终端继续下面步骤).
+
+### 3.2 验证 OKX 走 SOCKS 可用
+
+```bash
+curl -4 -Iv --max-time 15 --proxy socks5h://127.0.0.1:1080 https://www.okx.com/api/v5/public/time
+```
+
+看到 `HTTP/2 200`(或至少 TLS 握手成功且返回 JSON)即 OK.
+
+---
+
+## 4. Python 虚拟环境(venv)
+
+在本机项目目录:
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_okx
+
+python3 -m venv .venv
+source .venv/bin/activate
+
+python -m pip install -U pip
+pip install flask requests ccxt werkzeug PySocks Pillow
+```
+
+> 说明:本仓库当前没有 `requirements.txt`.如果你希望“完全复刻云服务器依赖”,可以在云服务器项目环境里执行 `pip freeze > requirements.txt` 带回本机再 `pip install -r requirements.txt`(记得删掉明显无关/体积巨大的包).
+
+建议减少 `.pyc` 垃圾文件(可选):
+
+```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_okx
+
+cp -n .env.example .env    # 已存在 .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` 后重填.
+
+**AI 复盘**:三所共用根目录 **`ai_client.py`**.默认 **`AI_PROVIDER=openai`**,网关 `https://op.bz121.com/v1`,模型 `gemma4:e4b`;或改 **`ollama`** 走本机 Ollama.PM2 须 **`PYTHONPATH=..`**.详见 **[AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)**.
+
+### 5.3 必填项检查(OKX + 代理)
+
+至少确认/填写这些关键项(示例):
+
+```env
+APP_HOST=127.0.0.1
+APP_PORT=5000
+
+# OKX(如需实盘)
+LIVE_TRADING_ENABLED=false
+OKX_API_KEY=...
+OKX_API_SECRET=...
+OKX_API_PASSPHRASE=...
+
+# OKX 出口:走本机 SSH 动态转发 SOCKS
+OKX_SOCKS_PROXY=socks5h://127.0.0.1:1080
+
+# 开仓多周期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=5
+# DAILY_OPEN_HARD_LIMIT=0
+# 说明见仓库 docs/daily-open-limit.md
+
+# AI 复盘(默认 OpenAI 兼容网关;与 Ollama 二选一)
+AI_PROVIDER=openai
+AI_TIMEOUT_SECONDS=120
+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=你的模型名
+```
+
+> 完整说明见仓库根 **[AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)**.`OPENAI_API_KEY` 在 [op.bz121.com](https://op.bz121.com/) 的 `gateway.json` 获取.
+
+> `OKX_SOCKS_PROXY` 使用 `socks5h`:让 SOCKS 侧做域名解析(更贴近你 `curl --proxy socks5h://...` 的成功路径).
+
+---
+
+## 6. 本机手工启动(验证 Flask)
+
+确保:
+
+1. SOCKS 隧道已运行(127.0.0.1:1080)
+2. 虚拟环境已 `activate`
+3. `.env` 已配置
+
+启动:
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_okx
+source .venv/bin/activate
+python app.py
+```
+
+浏览器访问:`http://127.0.0.1:5000`(或你在 `.env` 配的端口).
+
+---
+
+## 7. 安装 PM2(Node)
+
+```bash
+sudo npm i -g pm2
+pm2 -v
+```
+
+---
+
+## 8. 用 PM2 启动 SSH SOCKS 隧道(推荐:密钥免交互)
+
+### 8.1 启动隧道进程
+
+```bash
+pm2 start "ssh" --name okx-socks-tunnel -- \
+  -N -D 127.0.0.1:1080 okx-vps \
+  -o ServerAliveInterval=30 -o ServerAliveCountMax=3 \
+  -o ExitOnForwardFailure=yes -o BatchMode=yes
+```
+
+查看日志:
+
+```bash
+pm2 logs okx-socks-tunnel --lines 200
+```
+
+### 8.2 仍然验证 OKX
+
+```bash
+curl -4 -Iv --max-time 15 --proxy socks5h://127.0.0.1:1080 https://www.okx.com/api/v5/public/time
+```
+
+### 8.3 开机自启(可选)
+
+```bash
+pm2 save
+pm2 startup
+```
+
+---
+
+## 9. 用 PM2 启动 Flask(`app.py`)
+
+`pm2` 管理 Python 的常用方式是直接启动解释器:
+
+```bash
+cd /opt/crypto_monitor_user/crypto_monitor_okx
+
+pm2 start /opt/crypto_monitor_user/crypto_monitor_okx/.venv/bin/python --name crypto-monitor -- \
+  /opt/crypto_monitor_user/crypto_monitor_okx/app.py
+```
+
+> 若项目目录与上文不一致,请替换为实际绝对路径;或用 `readlink -f app.py` 得到绝对路径.
+
+查看日志:
+
+```bash
+pm2 logs crypto-monitor --lines 200
+```
+
+保存进程列表:
+
+```bash
+pm2 save
+```
+
+---
+
+## 10. 常见问题排查(高频)
+
+### 10.1 OKX 仍然失败:先看隧道是否在
+
+```bash
+ss -lntp | grep 1080 || true
+pm2 status
+```
+
+### 10.2 `pm2` 里的 `ssh` 立刻退出
+
+常见原因:
+
+- 私钥权限不对(`chmod 600`)
+- `~/.ssh/config` 写错 `HostName/User/IdentityFile`
+- 开了 `BatchMode yes` 但仍需要密码(会失败)
+
+### 10.3 `ccxt` SOCKS 报错 / 代理不生效
+
+本机 Python 依赖通常需要:
+
+```bash
+source .venv/bin/activate
+pip install PySocks
+```
+
+### 10.4 `.pyc` 很多导致同步慢
+
+`.pyc` 是缓存,删除不影响功能:
+
+```bash
+find . -type d -name __pycache__ -prune -exec rm -rf {} +
+find . -type f -name "*.pyc" -delete
+```
+
+---
+
+## 11. 推荐的启动顺序(固定习惯)
+
+1. `pm2` 启动 `okx-socks-tunnel`
+2. `curl --proxy socks5h://127.0.0.1:1080 ...` 验证 OKX
+3. `pm2` 启动 `crypto-monitor`
+
+---
+
+## 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='保本止盈'`
+
+如果你想,我还可以再给你一条“先自动备份 DB 再执行”的一键命令.