gate_scout_order/README.md

gate_scout_order（onchain_scout）

Gate.io USDT 永续 量化辅助工具集：包含 扫描监控端 与 下单执行器 两个独立 Python 服务，可同机或分机部署，通过 HTTP 联动。

Git 仓库： https://git.bz121.com/dekun/gate_scout_order.git

gate_scout_order/            # git clone 后的根目录（名称可自定）
├── onchain_scout_gate/      # 扫描端 · 行情监控、企微告警、信号转发（默认 :8088）
├── gate_order_executor/     # 执行器 · 接信号、Gate 下单、面板风控（默认 :8090+）
├── 部署说明.md              # ★ 完整部署 + 升级前备份清单
├── 备份恢复说明.md          # 手动备份 / 恢复（/opt → /root）
├── CLONE.md
└── README.md                # 本文件

---

两个子项目

子目录	作用	默认端口	详细说明
onchain_scout_gate/	7×24 扫描 Gate 永续；5m 箱体突破；企微推送；可选 Gemma 漏斗；面板维护多执行器转发列表	8088	onchain_scout_gate/README.md
gate_order_executor/	接收 POST /v1/signal；市价开仓 + 计划止盈/止损；盈亏比门槛；移动保本；持仓面板	8090（多账户可 8091…）	gate_order_executor/README.md

---

协作关系

flowchart LR
  gate[Gate.io 公共行情 API]
  scout[onchain_scout_gate]
  wecom[企业微信]
  ex1[gate_order_executor 实例 A]
  ex2[gate_order_executor 实例 B]
  gate --> scout
  scout --> wecom
  scout -->|同一 signal 广播| ex1
  scout -->|可选| ex2
  ex1 --> gate2[Gate 私有 API 账户 A]
  ex2 --> gate3[Gate 私有 API 账户 B]

1. 扫描端发现 TRIGGER 且通过推送门控 → 企业微信 告警。
2. 企微成功后 → 向面板中 已启用 的执行器 POST /v1/signal（方案 A 止盈/止损，同一 signal_id）。
3. 各执行器自行决定是否接单（最低盈亏比等），规则不在扫描端区分。
4. 转发请求 不走 扫描端 proxy，直连各执行器 base_url。

设计归档：onchain_scout_gate/docs/多执行器与信号转发归档.md

---

Git 克隆

git clone https://git.bz121.com/dekun/gate_scout_order.git gate_scout_order
cd gate_scout_order

• 克隆步骤摘要：CLONE.md
• 完整部署、升级备份、PM2、多执行器、关代理：部署说明.md
• 手动备份与恢复（/opt/gate_scout_order → /root）：备份恢复说明.md

---

快速开始（本机）

1. 扫描端

cd onchain_scout_gate
python -m venv .venv
# Windows: .\.venv\Scripts\Activate.ps1
# Linux:   source .venv/bin/activate
pip install -r requirements.txt
cp config.example.yaml config.yaml
# 编辑 config.yaml：wecom、gate、proxy、auth
python run.py

• 面板：http://127.0.0.1:8088/dashboard
• 部署：onchain_scout_gate/交易系统部署说明.md
• 本地 SOCKS：onchain_scout_gate/docs/本地部署-SOCKS5代理.md

2. 执行器（可先 dry_run）

cd gate_order_executor
python -m venv .venv
pip install -r requirements.txt
cp config.example.yaml config.yaml
# 编辑 config.yaml：security.webhook_secret、gate（dry_run: true 联调）
python run.py

• 健康检查：http://127.0.0.1:8090/health
• 面板：http://127.0.0.1:8090/dashboard
• 部署：gate_order_executor/docs/部署说明.md

3. 串联

1. 执行器 security.webhook_secret 与扫描端面板 「下单执行器」 里填写的 Webhook 密钥 一致。
2. 扫描端面板添加执行器：http://127.0.0.1:8090，打开总开关。
3. 执行器 gate.dry_run: false 并配置子账户 API 后才会实盘下单。

---

多执行器 / 对照实验

• 在扫描端 Web 「下单执行器 · 转发链」 添加多条 Base URL（如 :8090、:8091）。
• 每个 URL 对应 独立进程 + 独立 Gate API；盈亏比、移动保本在各执行器自己的面板/配置中修改。
• 列表保存在 onchain_scout_gate/runtime/order_executors.json，仅扫描端维护。

---

云服务器：关闭代理

本机开发若使用 proxy.enabled: true（SOCKS），迁到 可直连 api.gateio.ws 的境外云主机后，扫描端与 每个 执行器均应设：

proxy:
  enabled: false

说明见：

• onchain_scout_gate/交易系统部署说明.md §8
• gate_order_executor/docs/部署说明.md §6.1

---

文档索引

主题	路径
完整部署与备份	部署说明.md
克隆与分支	CLONE.md
多执行器归档	onchain_scout_gate/docs/多执行器与信号转发归档.md
扫描端安装	onchain_scout_gate/安装与说明.md
执行器使用	gate_order_executor/docs/使用说明.md

---

环境要求

• Python 3.10+（推荐 3.11）
• 访问 Gate.io API（扫描端可用公共行情；执行器需 API Key）
• 可选：Node.js + PM2（Linux 生产部署）
• 可选：本地 Ollama（扫描端 Gemma 漏斗）
• 走 SOCKS 时需 httpx[socks] / socksio（见各子项目 requirements.txt）

---

安全提示

• 勿 将含 config.yaml、API 密钥、runtime/ 数据库的目录提交到公开仓库。
• 执行器端口（8090 等）建议仅本机或内网访问；公网请 Nginx + HTTPS + 鉴权。
• webhook_secret 修改后须同步到 所有 执行器实例。