新增新机纯实盘部署文档，并与部署/使用说明互相链接。

Co-authored-by: Cursor <cursoragent@cursor.com>

使用说明.md

@@ -4,7 +4,7 @@
 
 基于 Flask 的 **OKX 期权 / 对冲** Web 控制台.与中控、其它交易所实例无关.
 
-**部署 / PM2 / SOCKS** 见 **[部署文档.md](./部署文档.md)**:
+**部署 / PM2 / SOCKS** 见 **[部署文档.md](./部署文档.md)**；**新机纯实盘**见 **[新机纯实盘部署.md](./新机纯实盘部署.md)**:
 
 ```bash
 curl -fsSL https://git.bz121.com/dekun/crypto_okx/raw/branch/main/deploy/manage.sh | bash

新机纯实盘部署.md

@@ -0,0 +1,215 @@
+# 新机纯实盘部署指南（crypto_okx）
+
+适用场景：**新开一台服务器，直接接 OKX 实盘 API，不做同机模拟→实盘切换**。
+
+当前推荐用法：
+
+| 机器 | 用途 |
+|------|------|
+| 现有模拟机 | 不接 API Key，本地模拟撮合 + 公开行情 |
+| **本机（新机）** | 只跑实盘，从部署起就是 `live` |
+
+与主仓 `crypto_monitor` **隔离**：请用独立子账户 / 独立 API Key，避免双实例同 Key 抢仓。
+
+通用安装步骤见 [部署文档.md](./部署文档.md)；页面操作见 [使用说明.md](./使用说明.md)。
+
+---
+
+## 1. 上线前准备
+
+1. OKX **实盘**账户（非演示盘），建议专用子账户、小资金。
+2. API Key 权限：交易（期权 + 如需币本位则含现货）；按需开提现（一般不必）。
+3. IP 白名单绑定到新机公网 IP。
+4. 确认持仓模式 / 保证金模式与下文 `.env` 一致（如双向 + 全仓）。
+5. 确认本机或经 SOCKS 能访问 `https://www.okx.com`。
+
+---
+
+## 2. 一键部署
+
+新机 root：
+
+```bash
+curl -fsSL https://git.bz121.com/dekun/crypto_okx/raw/branch/main/deploy/manage.sh | bash
+```
+
+菜单选 **1. 一键部署**。默认路径 `/opt/crypto_okx`，端口 `5004`。
+
+或手动：
+
+```bash
+cd /opt
+git clone https://git.bz121.com/dekun/crypto_okx.git crypto_okx
+cd /opt/crypto_okx
+cp -n .env.example .env
+bash deploy/setup_env.sh --install-system-deps
+```
+
+---
+
+## 3. 纯实盘 `.env` 必改项
+
+编辑：
+
+```bash
+nano /opt/crypto_okx/.env
+```
+
+### 3.1 模式：直接 live（不要 sim）
+
+```env
+# 启动即实盘（不要写成 sim）
+SIM_DEFAULT_MODE=live
+
+# 允许真实下单
+LIVE_TRADING_ENABLED=true
+```
+
+说明：
+
+- 新机不要依赖页面「切换到实盘」；部署时就把 `SIM_DEFAULT_MODE=live` 写好。
+- 期权路径主要认 API Key；`LIVE_TRADING_ENABLED` 仍建议保持 `true`，与文档口径一致。
+
+### 3.2 实盘 API（必填）
+
+```env
+OKX_API_KEY=你的实盘Key
+OKX_API_SECRET=你的实盘Secret
+OKX_API_PASSPHRASE=你的Passphrase
+OKX_OPTIONS_ENABLED=true
+EXCHANGE_DISPLAY_NAME=OKX·实盘
+```
+
+不要用演示盘 Key；本仓库未接 `x-simulated-trading`。
+
+### 3.3 交易模式与预算（按策略改）
+
+单独期权（常见起步）：
+
+```env
+OKX_TRADE_MODE=options
+OKX_OPTIONS_MARGIN_MODE=coin
+OKX_OPTIONS_COIN_BUDGET_USDT=10
+OKX_OPTIONS_TRADE_BUDGET_USDC=10
+```
+
+若做对冲，再改为 `perp_options` / `options_options`，并打开：
+
+```env
+HEDGE_PLAN_LIVE_ORDER=true
+```
+
+起步建议先 `HEDGE_PLAN_LIVE_ORDER=false` 或页面 dry_run，跑通单独期权后再开对冲真下单。
+
+### 3.4 代理（按网络需要）
+
+若服务器直连 OKX 不稳定：
+
+```env
+OKX_SOCKS_PROXY=socks5h://127.0.0.1:1080
+```
+
+并先在本机建好 SSH SOCKS（见部署文档）。
+
+---
+
+## 4. 启动与确认
+
+```bash
+cd /opt/crypto_okx
+pm2 restart crypto_okx --update-env
+# 若尚未创建进程，用一键脚本或:
+# pm2 start ecosystem.config.cjs
+pm2 status
+pm2 logs crypto_okx --lines 50
+```
+
+打开：`http://<新机IP>:5004`
+
+核对：
+
+1. 能登录。
+2. 顶栏为 **实盘**（`okx_live`），**没有**「模拟」徽章。
+3. 资金条能读到交易所余额（不是本地模拟钱包初始值）。
+4. 系统设置 → 模拟资金：当前模式应为 **live**（勿再切回 sim）。
+
+可用接口自检：
+
+```bash
+curl -s -u '用户名:密码' http://127.0.0.1:5004/api/sim/status
+# 期望含 "mode":"live"
+```
+
+---
+
+## 5. 小额冒烟（必做）
+
+在真钱前用 **最小张数 / 最小预算**：
+
+1. `/options` 开 1 张（或最小允许张数）→ 看交易所成交与本地记录。
+2. 持仓出现在页面监控。
+3. 平仓 → 余额变化符合预期。
+4. 若币本位：确认买币桥 → 开期权 → 平 → 卖回（或按你策略保留币）。
+5. `/options/review`：复盘列表有记录；可选勾选自动 K 线（公开行情，有 Key 也可画）。
+
+任一步异常：**先停手**，查 `pm2 logs crypto_okx`，不要加大仓位。
+
+---
+
+## 6. 与模拟机、主仓的隔离
+
+| 不要做 | 原因 |
+|--------|------|
+| 模拟机与实盘机共用同一 API Key | 双实例监控/下单互相干扰 |
+| 与正在跑的 `crypto_monitor` 共用同一 Key | 同上 |
+| 在实盘机再切回 sim「玩玩」 | 易混仓、混认知；模拟请继续用旧模拟机 |
+| 把 `.env` 提交进 Git | 泄密 |
+
+---
+
+## 7. 日常更新（实盘机）
+
+```bash
+cd /opt/crypto_okx
+git pull
+pm2 restart crypto_okx --update-env
+git log -1 --oneline
+```
+
+或：
+
+```bash
+bash /opt/crypto_okx/deploy/pull_and_restart.sh
+```
+
+`git pull` **不会**覆盖 `.env`。大版本更新前可：`cp .env .env.backup.$(date +%Y%m%d)`。
+
+---
+
+## 8. 故障快速对照
+
+| 现象 | 排查 |
+|------|------|
+| 顶栏仍显示模拟 | `.env` 是否 `SIM_DEFAULT_MODE=live`；是否重启 `--update-env`；设置页是否被改回 sim |
+| 读不到余额 / 下单失败 | Key、权限、IP 白名单、SOCKS、OKX 账户是否实盘 |
+| 能开单但监控不对 | 是否与其它实例同 Key；持仓模式是否与 `OKX_POS_MODE` 一致 |
+| 复盘无自动 K 线 | 服务器能否访问 OKX 公开行情；看日志是否画图失败 |
+
+---
+
+## 9. 推荐启动清单（可打印）
+
+- [ ] 新机已部署 `/opt/crypto_okx`
+- [ ] `SIM_DEFAULT_MODE=live`
+- [ ] `LIVE_TRADING_ENABLED=true`
+- [ ] 实盘 `OKX_API_*` 已填，且非演示盘
+- [ ] Key 与主仓 / 模拟机隔离
+- [ ] 顶栏确认 live，资金为交易所余额
+- [ ] 小额开平冒烟通过
+- [ ] 企业微信 / 监控按需开启
+
+---
+
+## 免责声明
+
+实盘有亏损风险。请遵守当地法规与交易所条款；操作与资金安全自负。

部署文档.md

@@ -4,6 +4,8 @@
 
 **功能与页面操作**见同目录 **[使用说明.md](./使用说明.md)**.脚本细节见 **[deploy/README.md](./deploy/README.md)**.
 
+**新开服务器、直接接 API 跑实盘（不与模拟同机切换）**见 **[新机纯实盘部署.md](./新机纯实盘部署.md)**.
+
 ---
 
 ## 一键部署(推荐)