chore: align binance/okx env examples with gate and add sync script

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

crypto_monitor_okx/.env.example

@@ -46,6 +46,11 @@ 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 全仓杠杆（须无仓后重启）
@@ -69,6 +74,8 @@ 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
@@ -88,6 +95,10 @@ OKX_POSITION_INST_TYPE=SWAP
 # EXCHANGE_POSITION_SYNC_FROM_BJ=2026-01-01
 # 单次拉取历史仓位条数上限（OKX 每页最多 100，程序会分页）
 # EXCHANGE_POSITION_HISTORY_LIMIT=200
+# 页面与浏览器标签展示的交易所名称（多环境区分时可改成例如 OKX·测试网）
+# EXCHANGE_DISPLAY_NAME=OKX
+# 企业微信推送里展示的账户备注
+# OKX_ACCOUNT_LABEL=
 
 # =============================================================================
 # 关键位程序自动下单（与 POSITION_SIZING_MODE 联动，修改后须重启 PM2）
@@ -105,18 +116,71 @@ OKX_POSITION_INST_TYPE=SWAP
 # 顺势加仓、趋势回调不受本开关控制；全仓模式下策略自动仍禁止。
 KEY_AUTO_ORDER_ENABLED=false
 
-# 关键位监控：5m收线突破过滤参数
+# =============================================================================
+# 关键位门控（页面「关键位监控」规则条与 _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
 
@@ -163,10 +227,7 @@ AI_MODEL=huihui_ai/deepseek-r1-abliterated:latest
 # 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
-# 关键位：标准方案止损外侧%、趋势单方案止损外侧%（默认 0.5 / 1）
-# KEY_STOP_OUTSIDE_BREAKOUT_PCT=0.5
-# KEY_TREND_STOP_OUTSIDE_PCT=1
+# 详见上文 DAILY_OPEN_ALERT_THRESHOLD / DAILY_OPEN_HARD_LIMIT；说明文档 docs/daily-open-limit.md
 # 以损定仓（按交易账户资金的百分比）
 # RISK_PERCENT=2
 # 移动保本触发（达到多少R触发）与偏移（百分比）
@@ -178,42 +239,4 @@ AI_MODEL=huihui_ai/deepseek-r1-abliterated:latest
 # DEFAULT_TRADE_STYLE=trend
 
 APP_TIMEZONE=Asia/Shanghai
-# TRADING_DAY_RESET_HOUR 现在表示「北京时间」整点，默认 8 点起算新交易日/可开仓等
-
-# 默认启用「北京时间 TRADING_DAY_RESET_HOUR 前禁止新开仓」；网页顶栏可运行时切换（写入 DB）
-TRADING_DAY_RESET_OPEN_GUARD_ENABLED=true
-
-MAX_ACTIVE_POSITIONS=1
-MANUAL_MIN_PLANNED_RR=1.4
-# 【单日开仓 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
-
-KEY_CONFIRM_BREAKOUT_BAR=-2
-KEY_CONFIRM_BAR=-1
-KEY_VOLUME_MA_BARS=20
-KEY_VOLUME_RATIO_MIN=1.3
-# 【箱体/收敛】突破K收盘越过关键位下限%
-KEY_BREAKOUT_AMP_MIN_PCT=0.03
-KEY_BREAKOUT_AMP_MAX_PCT=0.5
-# 【阻力/支撑】突破后微信提醒
-KEY_ALERT_MAX_TIMES=3
-KEY_ALERT_INTERVAL_MINUTES=5
-
-EXCHANGE_DISPLAY_NAME=OKX
-OKX_ACCOUNT_LABEL=
-
-BACKUP_ROOT=/root/backups
-BACKUP_RETENTION_DAYS=30
-BACKUP_INSTANCE=crypto_monitor_okx
+# TRADING_DAY_RESET_HOUR 现在表示「北京时间」整点，默认 8 点起算新交易日；开仓整点限制见 TRADING_DAY_RESET_OPEN_GUARD_ENABLED