dekun
0b3b415328
Keep only existing related docs after the docs prune. Co-authored-by: Cursor <cursoragent@cursor.com>
138 lines
4.1 KiB
Markdown
138 lines
4.1 KiB
Markdown
# 三所 `.env` 同步脚本说明
|
|
|
|
在**仓库根目录**执行.仅处理三所实例目录下的 `.env`,**不覆盖** API 密钥与已存在的自定义值;若某目录无 `.env` 会 `SKIP`(需先 `cp .env.example .env`).
|
|
|
|
| 目录 |
|
|
|------|
|
|
| `crypto_monitor_binance` |
|
|
| `crypto_monitor_okx` |
|
|
| `crypto_monitor_gate` |
|
|
| `crypto_monitor_gate` |
|
|
|
|
修改 `.env` 后须 **`pm2 restart`** 对应实例后生效.
|
|
|
|
---
|
|
|
|
## 一键同步(推荐)
|
|
|
|
`scripts/sync_four_exchange_env.py`:依次执行**计仓** + **自动划转** 两个子脚本.
|
|
|
|
```bash
|
|
cd /path/to/crypto_monitor
|
|
git pull
|
|
|
|
# 仅补全缺失项(已有值保留)
|
|
python scripts/sync_four_exchange_env.py
|
|
|
|
# 预览,不写文件
|
|
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
|
|
```
|
|
|
|
| 参数 | 说明 |
|
|
|------|------|
|
|
| `--dry-run` | 只打印将做的变更,不写 `.env` |
|
|
| `--set-mode risk\|full_margin` | 强制三所 `POSITION_SIZING_MODE` |
|
|
| `--set-transfer-amount U` | 强制三所 `AUTO_TRANSFER_AMOUNT` |
|
|
| `--enable-auto-transfer` | 强制三所 `AUTO_TRANSFER_ENABLED=true` |
|
|
|
|
---
|
|
|
|
## 仅自动划转
|
|
|
|
`scripts/sync_four_exchange_transfer_env.py`
|
|
|
|
行为说明见上文「仅自动划转」参数表（补全缺失项、目标金额、开启开关）。
|
|
|
|
```bash
|
|
# 补全缺失项
|
|
python scripts/sync_four_exchange_transfer_env.py
|
|
python scripts/sync_four_exchange_transfer_env.py --dry-run
|
|
|
|
# 目标 50U 并开启
|
|
python scripts/sync_four_exchange_transfer_env.py --set-amount 50 --enable-auto-transfer
|
|
```
|
|
|
|
| 参数 | 说明 |
|
|
|------|------|
|
|
| `--dry-run` | 预览 |
|
|
| `--set-amount U` | 强制 `AUTO_TRANSFER_AMOUNT` |
|
|
| `--enable-auto-transfer` | 强制 `AUTO_TRANSFER_ENABLED=true` |
|
|
|
|
**缺项默认**(未使用 `--set-amount` 且文件中无该键时):
|
|
|
|
1. 若已有 `AUTO_TRANSFER_AMOUNT` → 保留
|
|
2. 否则若存在 `DAILY_START_CAPITAL` → 沿用其值
|
|
3. 否则 → **50**
|
|
|
|
补全时会写入(若缺失):`AUTO_TRANSFER_FROM=funding`,`AUTO_TRANSFER_TO=swap`,`TRANSFER_CCY=USDT`,`AUTO_TRANSFER_BJ_HOUR=8`;币安额外补 `BINANCE_FUNDING_INCLUDE_SPOT=false`.
|
|
|
|
---
|
|
|
|
## 仅计仓模式
|
|
|
|
`scripts/sync_four_exchange_position_sizing_env.py`
|
|
|
|
行为说明见上文「仅计仓模式」参数表（补全缺失项、切模式、缓冲比例）。
|
|
|
|
```bash
|
|
# 补全缺失项(默认 risk,FULL_MARGIN_BUFFER_RATIO=0.98)
|
|
python scripts/sync_four_exchange_position_sizing_env.py
|
|
python scripts/sync_four_exchange_position_sizing_env.py --dry-run
|
|
|
|
# 无仓后切全仓
|
|
python scripts/sync_four_exchange_position_sizing_env.py --set-mode full_margin
|
|
|
|
# 无仓后切回以损定仓
|
|
python scripts/sync_four_exchange_position_sizing_env.py --set-mode risk
|
|
|
|
# 强制缓冲比例
|
|
python scripts/sync_four_exchange_position_sizing_env.py --set-buffer 0.98
|
|
```
|
|
|
|
| 参数 | 说明 |
|
|
|------|------|
|
|
| `--dry-run` | 预览 |
|
|
| `--set-mode risk\|full_margin` | 强制 `POSITION_SIZING_MODE`(**须无持仓**后 restart) |
|
|
| `--set-buffer RATIO` | 强制 `FULL_MARGIN_BUFFER_RATIO` |
|
|
|
|
---
|
|
|
|
## 共用交易 / 关键位 / 轮询项
|
|
|
|
`scripts/sync_common_trading_env.py`:以 Gate `.env.example` 为基准,向**币安,OKX** 的 `.env` **追加缺失项**(不覆盖 API 密钥与已有自定义值).
|
|
|
|
```bash
|
|
python scripts/sync_common_trading_env.py
|
|
python scripts/sync_common_trading_env.py --dry-run
|
|
python scripts/sync_common_trading_env.py --instances crypto_monitor_okx
|
|
python scripts/sync_common_trading_env.py --apply-force-close-policy
|
|
```
|
|
|
|
补全项含:`RECONCILE_*`,`PRICE_REFRESH_SECONDS`,`KEY_*` 门控,`KEY_SIZING_USE_ZERO_POSITION_SNAPSHOT` 等(**不含** `FORCE_CLOSE_*`,由 `--apply-force-close-policy` 单独处理).
|
|
|
|
**强制清仓策略**(仅 Gate 开启):
|
|
|
|
```bash
|
|
python scripts/sync_common_trading_env.py --apply-force-close-policy
|
|
```
|
|
|
|
或服务器一键:`bash deploy/pull_and_restart.sh`
|
|
|
|
---
|
|
|
|
## 部署后重启
|
|
|
|
```bash
|
|
pm2 restart crypto-monitor-binance crypto-monitor-okx crypto-monitor-gate
|
|
```
|
|
|
|
## 相关文档
|
|
|
|
- [部署说明](../deploy/README.md)
|