dekun/crypto_monitor
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

修复md文档

Browse Source
This commit is contained in:
dekun
2026-05-23 12:02:57 +08:00
parent ada9478713
commit c5f7f0c10d
15 changed files with 202 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AI复盘与模型配置说明.md
+70
View File
@@ -0,0 +1,70 @@
# AI 复盘与模型配置说明
四个 `crypto_monitor_*` 实例共用仓库根目录 **`ai_client.py`**（通过 `PYTHONPATH=..` 导入）。用于 **交易记录与复盘** 页的 AI 点评、短评建议，以及从复盘截图提取结构化 JSON。
---
## 一、二选一：`AI_PROVIDER`
| 值 | 说明 |
|----|------|
| **`openai`**（默认） | OpenAI 兼容 **Chat Completions** 接口 |
| **`ollama`** | 本机 Ollama **`/api/generate`**（流式 NDJSON） |
在对应子目录 **`.env`** 中设置（各所 `.env.example` 已含模板）：
```bash
AI_PROVIDER=openai
AI_TIMEOUT_SECONDS=120
# OpenAI 兼容网关（默认）
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=huihui_ai/deepseek-r1-abliterated:latest
```
### OpenAI 兼容网关
- **Base URL**：`https://op.bz121.com/v1`（请求路径为 `{base}/chat/completions`）。
- **API Key**：在 [op.bz121.com](https://op.bz121.com/) 登录后，于 **`gateway.json`** 页面复制（与网关账号一致）。
- **默认模型**：`gemma4:e4b`（可通过 `OPENAI_MODEL` 覆盖）。
### Ollama
- 需本机已安装并拉取对应模型；`AI_PROVIDER=ollama` 时使用 `OLLAMA_API` 与 `AI_MODEL`。
- 四所 `app.py` **不再** 直连 Ollama；统一走 `ai_client.ai_generate` / `ai_review` / `ai_short_advice`。
---
## 二、部署注意
1. **PM2 / 手工启动**：`ecosystem.config.cjs` 中 **`PYTHONPATH=..`** 必须包含仓库根，否则无法 `from ai_client import ...`。
2. 修改 `.env` 后重启对应实例，例如：`pm2 restart crypto_binance`（名称以你机器为准）。
3. **`git pull`** 不会改 `.env`；若 `.env.example` 新增 AI 变量，请手动补进本机 `.env`。
4. **勿** 将含真实 `OPENAI_API_KEY` 的 `.env` 提交 Git。
---
## 三、功能入口（网页）
登录后进入 **「交易记录与复盘」**：
- 单条记录 **AI 复盘** / **短评**（依赖上述配置）。
- 上传复盘图后 **从图片提取** 字段（内部调用 `ai_generate`，与所选 provider 一致）。
若请求超时或返回错误，请检查：密钥是否有效、网关是否可达、`AI_TIMEOUT_SECONDS` 是否过短、Ollama 是否已启动（仅 ollama 模式）。
---
## 四、相关文件
| 路径 | 说明 |
|------|------|
| `ai_client.py` | 统一封装 OpenAI / Ollama |
| `crypto_monitor_*/.env.example` | 各所环境变量模板 |
| 各所《部署文档.md》§ AI 复盘 | 与本文一致的简表 |
| 各所《使用说明.md》 | 运行前配置中的 AI 项 |
README.md
+8 -5
View File
@@ -26,10 +26,11 @@ cd crypto_monitor
|------|-----------------|----------|
| `crypto_monitor_binance/` | Binance USDT-M 永续 | [部署文档.md](./crypto_monitor_binance/部署文档.md) · [README.md](./crypto_monitor_binance/README.md) |
| `crypto_monitor_gate/` | Gate.io 永续（主号） | [部署文档.md](./crypto_monitor_gate/部署文档.md) |
| `crypto_monitor_gate_bot/` | Gate.io 永续（机器人；含趋势回调等） | [部署文档.md](./crypto_monitor_gate_bot/部署文档.md) · [趋势回调策略说明.md](./crypto_monitor_gate_bot/趋势回调策略说明.md) |
| `crypto_monitor_okx/` | OKX 永续 | [部署文档.md](./crypto_monitor_okx/部署文档.md) |
| `crypto_monitor_gate_bot/` | Gate.io 永续（机器人；含趋势回调等） | [部署文档.md](./crypto_monitor_gate_bot/部署文档.md) · [趋势回调策略说明.md](./crypto_monitor_gate_bot/趋势回调策略说明.md) · [策略交易说明.md](./策略交易说明.md) |
| `crypto_monitor_okx/` | OKX 永续 | [部署文档.md](./crypto_monitor_okx/部署文档.md) · [使用说明.md](./crypto_monitor_okx/使用说明.md) |
| `manual_trading_hub/` | 多账户中控（监控 + 紧急全平 + 登录；**不在中控网页下单**） | [README.md](./manual_trading_hub/README.md) · [使用说明.md](./manual_trading_hub/使用说明.md) · [部署文档.md](./manual_trading_hub/部署文档.md) · [常见问题.md](./manual_trading_hub/常见问题.md) |
| 根目录 `strategy_*.py` | **策略交易**（趋势回调 + 顺势加仓共用逻辑） | [策略交易说明.md](./策略交易说明.md) |
| 根目录 `ai_client.py` | **AI 复盘**（OpenAI 兼容网关 / Ollama 二选一） | [AI复盘与模型配置说明.md](./AI复盘与模型配置说明.md) |
前四列为四个 **`crypto_monitor_*`** 交易/监控应用；`manual_trading_hub` 与四者 **进程独立**，无需改四者代码即可并行使用。
@@ -39,7 +40,8 @@ cd crypto_monitor
- **技术栈**：Python 3.10+、`Flask` Web、`ccxt` 调交易所 API、本地 SQLite（默认 `crypto.db`）等。
- **能力类型**（各所细节见各自 README / 部署文档）：
- **关键位监控**、**下单监控**（含风控与移动保本等逻辑）、**交易复盘**；
- **关键位监控**、**下单监控**（含风控与移动保本等逻辑）、**交易复盘**（AI 点评，见 [AI复盘与模型配置说明.md](./AI复盘与模型配置说明.md)）；
- **策略交易**（顶栏 `/strategy`：趋势回调 + 顺势加仓双栏，四所共用根目录逻辑，见 [策略交易说明.md](./策略交易说明.md)）；
- **实盘（可选）**：在对应 `.env` 中开启 `LIVE_TRADING_ENABLED=true` 并配置各所 API 后，由程序发起真实委托（请务必理解风险并做好权限与 IP 白名单控制）。
- **网络**：若本机直连交易所不稳定，可通过 **SSH 动态转发 SOCKS** 或 HTTP/S 代理；经 SOCKS 时依赖中需包含 **`PySocks`**（各《部署文档》中有说明）。
- **进程托管**：Linux 上常用 **PM2** 托管 `app.py`；各目录内一般有 `ecosystem.config.cjs` 或文档中的等价命令。
@@ -105,8 +107,9 @@ cd crypto_monitor
2. 根据实际交易所进入对应 **`crypto_monitor_*`** 目录，编辑 **`.env`**（填入 API 与密码等；部署脚本已可从 `.env.example` 复制）。
3. 阅读该目录下的 **《部署文档.md》**（Ubuntu / PM2 / 代理 / 升级说明）。
4. 服务器部署完成后，按 **[备份与恢复.md](./备份与恢复.md)** 配置自动备份与 `.env` 备份习惯。
5. 需要 **Gate 趋势回调** 规则时，阅读 [crypto_monitor_gate_bot/趋势回调策略说明.md](./crypto_monitor_gate_bot/趋势回调策略说明.md)。
6. 需要 **多账户一块看 + 紧急全平** 时，阅读 [manual_trading_hub](./manual_trading_hub/) 下 [使用说明](./manual_trading_hub/使用说明.md)、[部署文档](./manual_trading_hub/部署文档.md)；遇问题先查 [常见问题](./manual_trading_hub/常见问题.md)。
5. 需要 **策略交易**（趋势回调 / 顺势加仓）时，阅读 [策略交易说明.md](./策略交易说明.md)；趋势细则另见 [crypto_monitor_gate_bot/趋势回调策略说明.md](./crypto_monitor_gate_bot/趋势回调策略说明.md)。
6. 需要 **AI 复盘**（OpenAI 网关或 Ollama）时，阅读 [AI复盘与模型配置说明.md](./AI复盘与模型配置说明.md)，并在各所 `.env` 配置 `AI_PROVIDER` 等。
7. 需要 **多账户一块看 + 紧急全平** 时，阅读 [manual_trading_hub](./manual_trading_hub/) 下 [使用说明](./manual_trading_hub/使用说明.md)、[部署文档](./manual_trading_hub/部署文档.md)；遇问题先查 [常见问题](./manual_trading_hub/常见问题.md)。
---
crypto_monitor_binance/README.md
+3 -1
View File
@@ -6,6 +6,8 @@
- **关键位监控**：价格与硬条件校验、企业微信推送（可选）
- **下单监控**：本地风控（含移动保本逻辑）、触达止盈/止损后尝试市价平仓并记账
- **策略交易**：顶栏 `/strategy`（趋势回调 + 顺势加仓），见仓库根 [策略交易说明.md](../策略交易说明.md)
- **AI 复盘**：OpenAI 兼容网关（默认）或 Ollama，见 [AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)
- **实盘（可选）**：`LIVE_TRADING_ENABLED=true` 且配置 `BINANCE_API_KEY` / `BINANCE_API_SECRET` 时，支持合约开仓、平仓、余额读取与内部划转（依赖 API 权限）
- **止盈止损（Binance）**：市价成交后挂 **`STOP_MARKET`**（止损）、**`TAKE_PROFIT_MARKET`**（止盈）；双向持仓带 `positionSide`；不显式传 `reduceOnly`（避免 API `-1106`）。触发参考价由 `BINANCE_TRIGGER_WORKING_TYPE` 控制（最新价 / 标记价）
@@ -42,7 +44,7 @@ pip install flask requests ccxt werkzeug PySocks Pillow
| `EXCHANGE_DISPLAY_NAME` | 页面展示的交易所名称，默认 `Binance` |
| `BINANCE_ACCOUNT_LABEL` | 推送文案中的账户备注 |
其余变量（登录、企业微信、风控参数、数据库路径等）见 **`.env.example` 内注释** 或 `app.py` 顶部默认值。
其余变量（登录、企业微信、风控参数、**`AI_PROVIDER` / `OPENAI_*` / `OLLAMA_*`**、数据库路径等）见 **`.env.example` 内注释** 或 `app.py` 顶部默认值。
## 本地运行
crypto_monitor_binance/使用说明.md
+4 -2
View File
@@ -16,7 +16,8 @@
|------|------|
| **关键位监控** | 录入上/下沿与类型，按 **5m 收线** 做硬条件过滤；符合条件后 **企业微信** 提醒，部分类型可 **自动市价开仓**（见第 4 节与专门文档）。 |
| **实盘下单监控** | 手工填止损/止盈，**以损定仓** 市价开单，挂上条件止盈止损，并在页面跟踪浮盈亏、保本逻辑等。 |
| **交易记录 / 复盘** | 平仓结果、盈亏、错过的单等归档与导出。 |
| **交易记录 / 复盘** | 平仓结果、盈亏、错过的单等归档与导出；可选 **AI 复盘**（见仓库根 [AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)）。 |
| **策略交易** | 顶栏 `/strategy`：**趋势回调**（左）与 **顺势加仓**（右）左右并列；细则见 [策略交易说明.md](../策略交易说明.md)。 |
后台按 **`MONITOR_POLL_SECONDS`**（默认几秒）轮询行情与监控逻辑。**切勿**在未理解规则时同时运行两套程序共用一个实盘账户。
@@ -35,6 +36,7 @@
| **是否真下单** | `LIVE_TRADING_ENABLED=false`：**不会**向交易所发送开仓指令（适合测试流程）。改为 `true` 且密钥正确才会实盘。 |
| **交易所 API** | **本仓库：** `BINANCE_API_KEY`、`BINANCE_API_SECRET`；永续相关见 `BINANCE_MARGIN_MODE`、`BINANCE_POSITION_MODE`、`BINANCE_TRIGGER_WORKING_TYPE` 等。**勿**把 `.env` 提交到 Git。 |
| **关键位 RR / 止损外扩** | `KEY_AUTO_MIN_PLANNED_RR`、`KEY_STOP_OUTSIDE_BREAKOUT_PCT`（详见 `关键位自动下单说明.md`）。 |
| **AI 复盘** | 默认 `AI_PROVIDER=openai`，`OPENAI_API_BASE=https://op.bz121.com/v1`、`OPENAI_API_KEY`、`OPENAI_MODEL=gemma4:e4b`；或 `AI_PROVIDER=ollama` + `OLLAMA_API` / `AI_MODEL`。详见 [AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)。 |
网络需要代理时可配置 **`BINANCE_SOCKS_PROXY` / `BINANCE_HTTP_PROXY`**（与 Gate 版 `GATE_*_PROXY` 用法类似）。
@@ -46,7 +48,7 @@
2. 启动 Flask 应用（可用 **`ecosystem.config.cjs`** 交给 PM2，或本地 `python app.py` / `flask run`，以你当前脚本为准）。
3. 浏览器访问站点，打开 **`/login`**，使用 **`.env` 里的 `APP_PASSWORD`** 登录。
登录后顶栏为四页：**关键位监控** | **实盘下单**（默认首页）| **交易记录与复盘** | **统计分析**。
登录后顶栏：**关键位监控** | **实盘下单**（默认首页）| **策略交易**（`/strategy`，趋势回调 + 顺势加仓双栏）| **交易记录与复盘** | **统计分析**。
---
crypto_monitor_binance/更新文档.md
+1 -1
View File
@@ -118,7 +118,7 @@
- 脚本：`scripts/backup_data.sh`（`crypto.db` + `static/images`）
- 定时：`scripts/install_backup_cron.sh` → 每天 **北京时间 0:00**，目录 **`/root/backups/<实例名>/YYYY-MM-DD/`**，保留 **30** 天
- 详见 `部署文档.md` 第 5.3 节
- 详见 `部署文档.md` 第 5.4 节（自动备份）
## 数据库（启动时自动迁移）
crypto_monitor_binance/部署文档.md
+13 -2
View File
@@ -147,7 +147,18 @@ cp .env .env.backup.$(date +%Y%m%d)
- **换机 / 迁移**：用 `scp` 复制整份 `.env` 到新机器对应目录；或在新机重新 `cp .env.example .env` 后填写。
### 5.3 自动备份（数据库 + 复盘图片）
### 5.3 AI 复盘与模型（可选）
四所共用仓库根目录 **`ai_client.py`**（PM2 的 **`PYTHONPATH=..`** 须包含仓库根）。在 `.env` 中配置 **`AI_PROVIDER`**：
| 模式 | 主要变量 |
|------|----------|
| **`openai`**（默认） | `OPENAI_API_BASE=https://op.bz121.com/v1`、`OPENAI_API_KEY`、`OPENAI_MODEL=gemma4:e4b` |
| **`ollama`** | `OLLAMA_API`、`AI_MODEL`（本机 Ollama） |
密钥在 [op.bz121.com](https://op.bz121.com/) 的 **`gateway.json`** 页面获取。改 `.env` 后需 **`pm2 restart`** 对应进程。详见根目录 **[AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)**。
### 5.4 自动备份（数据库 + 复盘图片）
默认每天 **北京时间 0:00** 备份到 **`/root/backups`**，保留 **30 天** 后自动删除更早的目录。
@@ -206,7 +217,7 @@ pm2 start ecosystem.config.cjs
建议安装：`apt install -y sqlite3`（热备更稳）。
### 5.4 必填项检查（Binance + 代理）
### 5.5 必填项检查（Binance + 代理）
与交易所相关的变量使用 **`BINANCE_`** 前缀（与代码一致）。至少确认：
crypto_monitor_gate/使用说明.md
+4 -2
View File
@@ -16,7 +16,8 @@
|------|------|
| **关键位监控** | 录入上/下沿与类型，按 **5m 收线** 做硬条件过滤；符合条件后 **企业微信** 提醒，部分类型可 **自动市价开仓**（见第 4 节与专门文档）。 |
| **实盘下单监控** | 手工填止损/止盈，**以损定仓** 市价开单，挂上条件止盈止损，并在页面跟踪浮盈亏、保本逻辑等。 |
| **交易记录 / 复盘** | 平仓结果、盈亏、错过的单等归档与导出。 |
| **交易记录 / 复盘** | 平仓结果、盈亏、错过的单等归档与导出；可选 **AI 复盘**（见 [AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)）。 |
| **策略交易** | 顶栏 `/strategy`：趋势回调 + 顺势加仓双栏；见 [策略交易说明.md](../策略交易说明.md)。 |
后台按 **`MONITOR_POLL_SECONDS`**（默认几秒）轮询行情与监控逻辑。**切勿**在未理解规则时同时运行两套程序共用一个实盘账户。
@@ -35,6 +36,7 @@
| **是否真下单** | `LIVE_TRADING_ENABLED=false`：**不会**向交易所发送开仓指令（适合测试流程）。改为 `true` 且密钥正确才会实盘。 |
| **交易所 API** | **本仓库：** `GATE_API_KEY`、`GATE_API_SECRET`；合约相关见 `GATE_MARGIN_MODE`、`GATE_POS_MODE`、`GATE_TPSL_*` 等。**勿**把 `.env` 提交到 Git。 |
| **关键位 RR / 止损外扩** | `KEY_AUTO_MIN_PLANNED_RR`、`KEY_STOP_OUTSIDE_BREAKOUT_PCT`（详见 `关键位自动下单说明.md`）。 |
| **AI 复盘** | `AI_PROVIDER=openai`（默认）或 `ollama`；变量见 `.env.example` 与 [AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)。 |
网络不稳定时可为 Gate 配置 **`GATE_SOCKS_PROXY`** 等（见 **`部署文档.md`**）。
@@ -46,7 +48,7 @@
2. 启动 Flask 应用（本仓库可用 **`ecosystem.config.cjs`** 交给 PM2，或本地 `python app.py` / `flask run`，以你当前脚本为准）。
3. 浏览器访问站点，打开 **`/login`**，使用 **`.env` 里的 `APP_PASSWORD`** 登录。
登录后顶栏为四页：**关键位监控** | **实盘下单**（默认首页）| **交易记录与复盘** | **统计分析**。
登录后顶栏：**关键位监控** | **实盘下单** | **策略交易** | **交易记录与复盘** | **统计分析**。
---
crypto_monitor_gate/更新文档.md
+1 -1
View File
@@ -119,7 +119,7 @@
- 脚本：`scripts/backup_data.sh`（`crypto.db` + `static/images`）
- 定时：`scripts/install_backup_cron.sh` → 每天 **北京时间 0:00**，目录 **`/root/backups/<实例名>/YYYY-MM-DD/`**，保留 **30** 天
- 详见 `部署文档.md` 第 5.3 节
- 详见 `部署文档.md` 第 5.4 节（自动备份）
## 数据库（启动时自动迁移）
crypto_monitor_gate/部署文档.md
+7 -3
View File
@@ -138,7 +138,11 @@ nano .env
- **升级前备份**：`cp .env .env.backup.$(date +%Y%m%d)`；恢复：`cp .env.backup.YYYYMMDD .env`。
- **换机**：`scp` 复制 `.env`，或新机 `cp .env.example .env` 后重填。
### 5.3 自动备份（数据库 + 复盘图片）
### 5.3 AI 复盘与模型（可选）
共用根目录 **`ai_client.py`**（`PYTHONPATH=..`）。`.env` 中 **`AI_PROVIDER=openai`**（默认）时使用 `OPENAI_API_BASE=https://op.bz121.com/v1`、`OPENAI_API_KEY`、`OPENAI_MODEL=gemma4:e4b`；改 **`ollama`** 则用 `OLLAMA_API` + `AI_MODEL`。详见 **[AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)**。
### 5.4 自动备份（数据库 + 复盘图片）
与 Binance 实例相同：每天 **北京时间 0:00** → **`/root/backups`**，保留 **30 天**。
@@ -149,11 +153,11 @@ bash scripts/install_backup_cron.sh
bash scripts/backup_data.sh # 试跑
```
备份目录：`/root/backups/crypto_monitor_gate/YYYY-MM-DD/`。详见 Binance 项目 `部署文档.md` 第 5.3 节（恢复步骤、可选 `.env` 变量相同）。
备份目录：`/root/backups/crypto_monitor_gate/YYYY-MM-DD/`。详见 Binance 项目 `部署文档.md` 第 5.4 节（恢复步骤、可选 `.env` 变量相同）。
若还部署了 **`crypto_monitor_gate_bot`**，请在该目录同样执行 `bash scripts/install_backup_cron.sh`。
### 5.4 必填项检查（Gate + 代理）
### 5.5 必填项检查（Gate + 代理）
与交易所相关的变量必须是 **Gate** 前缀（**不要**再写 OKX 变量，否则代理不会生效、密钥也不会被识别）。至少确认：
crypto_monitor_gate_bot/趋势回调策略说明.md
+4 -2
View File
@@ -1,12 +1,14 @@
# 趋势回调策略（机器人）说明
本文描述本仓库内 **「趋势回调」** 自动交易计划的业务规则与实现口径，便于单独策略账户使用与审计。
本文描述 **「趋势回调」** 自动交易计划的业务规则与实现口径。
**四所主站**（Binance / Gate / OKX / 本目录 `crypto_monitor_gate_bot`）均在顶栏 **策略交易 → `/strategy`** 左栏提供同一套逻辑（共用 `strategy_trend_register.py`）；本目录侧重 **Gate 子账户 / 机器人** 实例，可与主 Gate 账户隔离部署。
---
## 1. 适用场景
- 单独用于跑策略的 **Gate.io USDT 永续** 子账户（建议与主资金隔离）。
- 单独用于跑策略的 **Gate.io USDT 永续** 子账户（建议与主资金隔离）；其它交易所实例同理，使用各自 API 与 `crypto.db`。
- 你已明确：**方向、止损价、补仓区间边界价、止盈价、杠杆**，并接受程序按风险预算拆分 **首仓 50% + 多档补仓 50%**。
---
crypto_monitor_gate_bot/部署文档.md
+6 -2
View File
@@ -138,7 +138,11 @@ nano .env
- **升级前备份**：`cp .env .env.backup.$(date +%Y%m%d)`；恢复：`cp .env.backup.YYYYMMDD .env`。
- **换机**：`scp` 复制 `.env`，或新机 `cp .env.example .env` 后重填。
### 5.3 自动备份（数据库 + 复盘图片）
### 5.3 AI 复盘与模型（可选）
共用根目录 **`ai_client.py`**（`PYTHONPATH=..`）。`.env` 默认 **`AI_PROVIDER=openai`** + `OPENAI_API_BASE` / `OPENAI_API_KEY` / `OPENAI_MODEL`；或 **`ollama`** + `OLLAMA_API` / `AI_MODEL`。详见 **[AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)**。
### 5.4 自动备份（数据库 + 复盘图片）
每天 **北京时间 0:00** 备份到 **`/root/backups`**，保留 **30 天**（`crypto.db` + `static/images`）。
@@ -149,7 +153,7 @@ bash scripts/install_backup_cron.sh
bash scripts/backup_data.sh # 试跑
```
备份目录：`/root/backups/crypto_monitor_gate_bot/YYYY-MM-DD/`。与 Binance / Gate 实例规则相同，详见 `crypto_monitor_binance/部署文档.md` 第 5.3 节（恢复步骤、可选 `.env` 变量）。
备份目录：`/root/backups/crypto_monitor_gate_bot/YYYY-MM-DD/`。与 Binance / Gate 实例规则相同，详见 `crypto_monitor_binance/部署文档.md` 第 5.4 节（恢复步骤、可选 `.env` 变量）。
若服务器同时跑 **binance、gate、gate_bot** 三个实例，请在**各自项目目录**各执行一次 `install_backup_cron.sh`。
crypto_monitor_okx/使用说明.md
+57
View File
@@ -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
+18 -2
View File
@@ -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://...` 的成功路径）。
---
deploy/README.md
+1 -1
View File
@@ -73,7 +73,7 @@ bash deploy/setup_env.sh
## 部署之后
1. 编辑各子目录 **`.env`**（API、登录密码、SOCKS 代理等）。
1. 编辑各子目录 **`.env`**（API、登录密码、SOCKS 代理、**AI 复盘** 等）。AI 默认走 OpenAI 兼容网关 `https://op.bz121.com/v1`（`AI_PROVIDER=openai`，`OPENAI_API_KEY` 等），详见根目录 [AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)。
2. 本地试运行（以 Binance 为例）：
```bash
策略交易说明.md
+5 -5
View File
@@ -14,7 +14,7 @@ strategy_config.py # 各所 app → 统一回调配置（交易所 API
strategy_register.py # Flask POST：/strategy/roll/preview、/strategy/roll/execute
strategy_ui.py # 主站 index 页数据（滚仓组、持仓列表等）
strategy_exchange_*.py # 适配器说明（实际下单仍走各所 app 的 ccxt）
strategy_templates/ # 主站内嵌 panel（subnav、roll、trend 禁用说明）
strategy_templates/ # strategy_trading_page.html（双栏）、trend/roll 面板片段
```
| 层级 | 职责 |
@@ -84,7 +84,7 @@ strategy_templates/ # 主站内嵌 panel（subnav、roll、trend 禁用
### 4.5 操作步骤
1. 打开 **策略·顺势加仓** `/strategy/roll`。
1. 打开顶栏 **策略交易** `/strategy`，在 **右栏·顺势加仓** 操作。
2. 选择持仓币种、方向、加仓方式，填写 H/L（斐波时）、**新统一止损**、总风险%。
3. 点击 **执行滚仓**（市价立即加仓并更新止损；限价则挂委托，成交后需再处理止损——当前版本限价 pending 后提示手动同步）。
4. 查看页底 **滚仓腿历史**。
@@ -110,7 +110,8 @@ pm2 restart crypto_binance crypto_gate crypto_gate_bot crypto_okx manual-trading
| 文档 | 内容 |
|------|------|
| [crypto_monitor_gate_bot/趋势回调策略说明.md](./crypto_monitor_gate_bot/趋势回调策略说明.md) | 趋势回调细则 |
| [crypto_monitor_gate_bot/趋势回调策略说明.md](./crypto_monitor_gate_bot/趋势回调策略说明.md) | 趋势回调细则（与四所共用逻辑一致） |
| [AI复盘与模型配置说明.md](./AI复盘与模型配置说明.md) | 复盘页 AI（与策略无关） |
| [manual_trading_hub/使用说明.md](./manual_trading_hub/使用说明.md) | 中控（不含策略交易） |
| [fib_key_monitor_lib.py](./fib_key_monitor_lib.py) | 斐波公式共用 |
@@ -119,5 +120,4 @@ pm2 restart crypto_binance crypto_gate crypto_gate_bot crypto_okx manual-trading
## 七、后续可增强（未实现）
- 滚仓页内嵌预览按钮、限价成交后一键同步止损。
- 趋势回调计划逻辑进一步迁入 `strategy_trend_lib` + 各所 adapter 类（当前仅拆出网格/拆档计算）。
- Binance / Gate 主站 / OKX 移植趋势回调自动补仓（需复制 `check_trend_pullback_plans` 轮询）。
- 趋势回调计划逻辑进一步迁入 `strategy_trend_lib` + 各所 adapter 类（当前网格/拆档与四所轮询已共用）。