# 复盘交易系统（crypto_monitor）

多交易所 **USDT 永续** 的下单监控、**关键位**、**策略交易**、**止盈止损 / 移动保本** 与 **AI 复盘**，三所独立部署 + 可选 **中控** 聚合监控。

**远程仓库**：[https://git.bz121.com/dekun/crypto_monitor.git](https://git.bz121.com/dekun/crypto_monitor.git)

---

## 部署环境（必读）

| 项 | 约定 |
|----|------|
| 系统 | **Ubuntu 22.04 / 24.04** |
| 用户 | **root** |
| 路径 | **`/opt/crypto_monitor`** |
| 进程 | **PM2**（唯一推荐的常驻方式） |

**环境详解**（Python 3.10+、Node、PM2 安装与启动顺序）：**[docs/ubuntu-server.md](./docs/ubuntu-server.md)**  
**一键 venv**：`bash deploy/setup_env.sh` → **[deploy/README.md](./deploy/README.md)**

```bash
cd /opt
git clone https://git.bz121.com/dekun/crypto_monitor.git crypto_monitor
cd /opt/crypto_monitor
bash deploy/setup_env.sh --install-system-deps
```

配置与运维脚本： **[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 与本文冲突，以 **子目录《部署文档》与当前代码** 为准。
