修复md文档

crypto_monitor_okx/使用说明.md

@@ -0,0 +1,57 @@
+# 使用说明
+
+**本文件对应仓库：`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 版对齐） |

crypto_monitor_okx/部署文档.md

@@ -1,4 +1,10 @@
-# `crypto_monitor` 本地部署 + SSH SOCKS 转发 + PM2 启动指南（Ubuntu）
+# `crypto_monitor_okx` 部署文档（Ubuntu）
+
+**功能与页面操作** 见同目录 **[使用说明.md](./使用说明.md)**。策略与 AI 见仓库根 **[策略交易说明.md](../策略交易说明.md)**、**[AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)**。
+
+---
+
+# 本地部署 + SSH SOCKS 转发 + PM2 启动指南（Ubuntu）
 
 本文面向：**本地 Ubuntu 机器运行项目**，但 **本机直连 OKX 会被 TLS/SNI reset** 的场景。解决思路是：
 
@@ -151,6 +157,8 @@ nano .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 + 代理）
 
 至少确认/填写这些关键项（示例）：
@@ -175,11 +183,19 @@ OKX_SOCKS_PROXY=socks5h://127.0.0.1:1080
 # ORDER_CHART_DIR=static/images/order_charts
 # DAILY_OPEN_ALERT_THRESHOLD=5
 
-# Ollama（如本机跑）
+# 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://...` 的成功路径）。
 
 ---