增加3.9

部署说明.md

@@ -143,8 +143,10 @@ cp -a /root/backup_gate_xxxx/gate_order_executor/runtime/* "$NEW/gate_order_exec
 
 ## 3. 服务器环境准备
 
+> **Python 版本**：项目要求 **3.9～3.12**（不支持 3.8）。Ubuntu 20.04 默认 `python3` 为 3.8，请安装 `python3.9` 或更高版本，详见 **[Python3.9部署说明.md](Python3.9部署说明.md)**。
+
 ```bash
-sudo apt update && sudo apt install -y python3 python3-venv python3-pip curl git
+sudo apt update && sudo apt install -y python3.9 python3.9-venv python3.9-dev curl git
 
 # Node.js + PM2（任选一种安装 Node 的方式）
 curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
@@ -202,10 +204,11 @@ git push -u origin main
 cd /opt/gate_scout_order/onchain_scout_gate
 chmod +x deploy/*.sh
 
-python3 -m venv .venv
-source .venv/bin/activate
-pip install -U pip
-pip install -r requirements.txt
+# 推荐：自动选用 python3.9～3.12（见 Python3.9部署说明.md）
+bash deploy/bootstrap.sh /opt/gate_scout_order/onchain_scout_gate
+
+# 或手动（Ubuntu 20.04 务必用 python3.9，不要用默认 python3）：
+# python3.9 -m venv .venv && source .venv/bin/activate && pip install -U pip && pip install -r requirements.txt
 
 # 若无 config.yaml（升级已从备份恢复则跳过）
 cp config.example.yaml config.yaml
@@ -411,6 +414,7 @@ pm2 save
 |------|------|
 | `git clone` 403 / 认证失败 | 检查 Gitea 账号、Token；或改用 SSH |
 | 扫描端拉不到行情 | `proxy`、防火墙；`curl -I https://api.gateio.ws` |
+| `matplotlib` / `str \| None` / Pydantic 注解报错 | Python 版本低于 3.9 或 venv 用错；见 **[Python3.9部署说明.md](Python3.9部署说明.md)** |
 | 有 TRIGGER 未下单 | 面板执行器总开关、列表为空、webhook 不一致；日志搜 `order_executor_` |
 | 执行器 401 | `X-Webhook-Secret` 与配置不一致 |
 | 升级后面板策略丢了 | 是否未恢复 `runtime/alerts.db` |