docs: document four-exchange env sync script usage

Add docs/env-sync-scripts.md; cross-link from deploy README, feature docs, README, and script headers.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
dekun
2026-06-04 10:02:08 +08:00
parent 5e694ff795
commit 02bc3c14bc
8 changed files with 174 additions and 25 deletions
+23 -17
View File
@@ -85,31 +85,37 @@ bash deploy/setup_env.sh
3. 服务器长期运行见各目录 **《部署文档.md》**SSH SOCKS、PM2)。
4. **多账户中控**`manual_trading_hub`):编辑 `manual_trading_hub/.env``HUB_PASSWORD`、`HUB_BRIDGE_TOKEN` 等与四实例一致),再 `pm2 start ecosystem.config.cjs`;验收 `bash manual_trading_hub/scripts/verify_hub_deploy.sh`。详见 [manual_trading_hub/部署文档.md](../manual_trading_hub/部署文档.md)、[常见问题.md](../manual_trading_hub/常见问题.md)。
## 四所 `.env` 自动划转项(已有 .env 时)
## 四所 `.env` 同步脚本(已有 .env 时)
`AUTO_TRANSFER_AMOUNT` 等为交易账户目标余额(北京时间 8 点自动划入/划出,**持仓中不划转**并微信通知),与 `DAILY_START_CAPITAL` **独立**。若服务器上已有 `.env`,可合并写入(不覆盖 API 密钥):
在仓库根目录用 Python 脚本**补全或更新**四所 `crypto_monitor_*` 下的 `.env`(不覆盖 API 密钥;无 `.env` 的目录会跳过)。
```bash
# 计仓 + 划转一次同步(缺项补全,不覆盖已有 API 与自定义值)
cd /path/to/crypto_monitor
git pull
# 推荐:计仓 + 自动划转 一次补全
python scripts/sync_four_exchange_env.py
# 或仅划转:缺 AUTO_TRANSFER_AMOUNT 时默认 50(否则沿用已有 / DAILY_START_CAPITAL
python scripts/sync_four_exchange_transfer_env.py --set-amount 50 --enable-auto-transfer
# 预览
python scripts/sync_four_exchange_env.py --dry-run
# 常见:划转目标 50U 并开启 + 计仓补全
python scripts/sync_four_exchange_env.py --set-transfer-amount 50 --enable-auto-transfer
# 无仓后切全仓杠杆
python scripts/sync_four_exchange_env.py --set-mode full_margin
pm2 restart crypto-monitor-binance crypto-monitor-okx crypto-monitor-gate crypto-monitor-gate-bot
```
详见 [docs/auto-transfer-daily.md](../docs/auto-transfer-daily.md)。
| 脚本 | 作用 |
|------|------|
| `scripts/sync_four_exchange_env.py` | 一键:计仓 + 划转 |
| `scripts/sync_four_exchange_transfer_env.py` | 仅自动划转 |
| `scripts/sync_four_exchange_position_sizing_env.py` | 仅计仓模式 |
## 四所 `.env` 计仓模式项(已有 .env 时)
`POSITION_SIZING_MODE` / `FULL_MARGIN_BUFFER_RATIO` 仅能通过 env 切换;切换模式前须**无持仓**:
```bash
python scripts/sync_four_exchange_position_sizing_env.py
# 无仓后切全仓:python scripts/sync_four_exchange_position_sizing_env.py --set-mode full_margin
pm2 restart crypto-monitor-binance crypto-monitor-okx crypto-monitor-gate crypto-monitor-gate-bot
```
详见 [docs/position-sizing-mode.md](../docs/position-sizing-mode.md)。
**完整参数、缺项默认值与示例**见 **[docs/env-sync-scripts.md](../docs/env-sync-scripts.md)**。
功能说明:[计仓模式](../docs/position-sizing-mode.md)、[每日自动划转](../docs/auto-transfer-daily.md)。
## 依赖说明