From 572239f69c8f339455aacb850f65f2e9d0079306 Mon Sep 17 00:00:00 2001
From: dekun <dekun@local>
Date: Fri, 17 Jul 2026 15:47:33 +0800
Subject: [PATCH] Fix pip --progress-bar for pip 26+ so instance deploy can
 install deps.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 deploy/lib/common.sh |  7 ++-----
 docs/更新文档.md     | 22 ++++++++++++++++++++++
 2 files changed, 24 insertions(+), 5 deletions(-)

diff --git a/deploy/lib/common.sh b/deploy/lib/common.sh
index 5e38042..2f0cf4a 100644
--- a/deploy/lib/common.sh
+++ b/deploy/lib/common.sh
@@ -192,12 +192,9 @@ install_node_pm2() {
 }
 
 # pip 安装时显示进度条(避免 -q 静默导致用户以为卡死)
+# pip>=26 已移除 ascii，仅支持 auto|on|off|raw
 pip_progress_bar_arg() {
-  if [[ -t 1 ]] || [[ -t 2 ]]; then
-    echo "on"
-  else
-    echo "ascii"
-  fi
+  echo "on"
 }
 
 pip_upgrade_tools() {
diff --git a/docs/更新文档.md b/docs/更新文档.md
index 9c3b16f..9661ac4 100644
--- a/docs/更新文档.md
+++ b/docs/更新文档.md
@@ -4,6 +4,28 @@
 
 ---
 
+## 2026-07-17 · 修复 pip>=26 部署依赖安装失败
+
+### 修改原因
+
+单所验证时 `setup_env` 升级到 pip 26 后,`--progress-bar ascii` 非法,依赖安装中断.
+
+### 修改的地方
+
+| 文件 | 改动摘要 |
+|------|----------|
+| `deploy/lib/common.sh` | `pip_progress_bar_arg` 改为 `on`(兼容 pip 26) |
+
+### 达成的目标
+
+非 TTY / SSH 下一键安装可顺利 `pip install -r`.
+
+### 交付之后的验收
+
+`bash deploy/lib/install.sh --exchange okx` 能过依赖安装并起 `crypto_okx`.
+
+---
+
 ## 2026-07-17 · 一键部署支持单所仅实例(不含中控)
 
 ### 修改原因