crypto_monitor/crypto_monitor_binance/更新文档.md

界面与风控更新说明（Binance 实例）

顶栏导航（4 项）

顺序	名称	路由	说明
1	关键位监控	/key_monitor	关键位添加、实时门控、历史
2	实盘下单	/trade	人工开仓、划转、实时持仓（默认首页 / → /trade）
3	交易记录与复盘	/records	未改动
4	统计分析	/stats	未改动

关键位监控页

• 标题去掉「5m」；规则条从 .env 读取（周期、确认K、量能、自动开仓盈亏比、日成交量排名）。
• 左列：活跃关键位，pos-card 样式展示现价/距上沿/距下沿/门控。
• 右列：关键位历史（失效/结案），与左列等高滚动。
• 监控类型新增：斐波回调0.618、斐波回调0.786（与 Gate 主站同一套规则，计算逻辑见仓库根目录 fib_key_monitor_lib.py）。

斐波关键位监控（方案 A：交易所限价）

项	说明
同币互斥	每个币种只能有一条斐波监控（0.618 与 0.786 不可并存）
上下沿	上沿 H、下沿 L（须 H > L）
挂单价 E	E = L + ratio × (H − L)（0.618 或 0.786）
做多	限价 @ 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：箱体突破 或 收敛突破。
• 持仓与交易记录展示「来源 · 信号类型」。

交易记录与复盘

• 支持从交易所收入流水等同步已实现盈亏；盈亏列标注 所 / 估。
• 记录页 立即同步（POST /api/sync_exchange_pnl）。
• 未人工复盘时优先展示交易所盈亏（已同步时）。

实盘下单页

• 左列：实盘下单监控（表单、划转、规则）。
• 右列：实时持仓（独立模块）。
• 人工开仓门控：计划盈亏比 < MANUAL_MIN_PLANNED_RR（默认 1.4）时前端弹窗 + 后端拒绝。

持仓与计仓

• 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.3 节

数据库（启动时自动迁移）

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。

升级步骤

1. git pull 后对比 .env.example，把新增变量合并进本地 .env。
2. 在 VPS 上为 Binance / Gate / Gate Bot 各执行一次 bash scripts/install_backup_cron.sh（若尚未安装）。
3. 重启 Binance 实例（如 pm2 restart crypto_binance）；SQLite 会自动 ALTER 新列。
4. 浏览器强刷（Ctrl+F5）避免旧版 index.html 缓存。
5. 建议先用测试币验证斐波：限价挂出、标记价失效撤单、成交后 TP/SL 与订单监控是否正常。