# 使用说明

**本文件对应仓库：`crypto_monitor_okx`（OKX USDT 永续）。**  
界面与 Binance / Gate 主站版基本一致，差异在 **`.env` 的 `OKX_*` 变量** 与 OKX 合约 API（含 Passphrase）。

**部署（SSH SOCKS、PM2、备份）** 见同目录 **[部署文档.md](./部署文档.md)**。  
**策略交易、AI 复盘** 为四所共用根目录逻辑，见 **[策略交易说明.md](../策略交易说明.md)**、**[AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)**。

---

## 1. 它能做什么

| 模块 | 说明 |
|------|------|
| **关键位监控** | 5m 收线门控、企业微信推送；部分类型可自动市价开仓。 |
| **实盘下单监控** | 以损定仓、条件止盈止损、移动保本等。 |
| **策略交易** | 顶栏 **`/strategy`**：左 **趋势回调**、右 **顺势加仓**（双栏并列）。 |
| **交易记录 / 复盘** | 归档、导出；可选 **AI 复盘**（`.env` 中 `AI_PROVIDER` 等）。 |
| **统计分析** | 按北京时间切日的统计（与顶栏 UTC 列表窗无关）。 |

---

## 2. 运行前必须配置（`.env`）

```bash
cp -n .env.example .env
nano .env
```

| 类别 | 说明 |
|------|------|
| **登录** | `APP_PASSWORD`、`FLASK_SECRET_KEY` |
| **OKX API** | `OKX_API_KEY`、`OKX_API_SECRET`、`OKX_API_PASSPHRASE` |
| **代理** | 本机 SSH SOCKS 时常用 `OKX_SOCKS_PROXY=socks5h://127.0.0.1:1080` |
| **实盘开关** | `LIVE_TRADING_ENABLED=false` 仅本地逻辑，不测真下单 |
| **AI 复盘** | 默认 `AI_PROVIDER=openai`，`OPENAI_API_BASE=https://op.bz121.com/v1`、`OPENAI_API_KEY`、`OPENAI_MODEL=gemma4:e4b`；或 `ollama` + `OLLAMA_API` / `AI_MODEL` |

---

## 3. 启动与顶栏

1. 按 **部署文档** 建 venv、装依赖、配 SOCKS（如需）。  
2. `python app.py` 或 PM2 `ecosystem.config.cjs`（须 **`PYTHONPATH=..`**）。  
3. 浏览器登录后顶栏：**关键位监控** | **实盘下单** | **策略交易** | **交易记录与复盘** | **统计分析**。

旧链接 `/strategy/trend`、`/strategy/roll` 会重定向到 **`/strategy`**。

---

## 4. 相关文档

| 文档 | 内容 |
|------|------|
| [部署文档.md](./部署文档.md) | Ubuntu、PM2、`.env`、备份 |
| [策略交易说明.md](../策略交易说明.md) | 趋势回调 + 顺势加仓 |
| [AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md) | OpenAI 网关 / Ollama |
| [crypto_monitor_binance/使用说明.md](../crypto_monitor_binance/使用说明.md) | 关键位细则（流程与 OKX 版对齐） |