aaden-cli 1.6.95 → 1.6.97

package/AadenDeploy/lightUpdate.sh

@@ -1,11 +1,102 @@
 #!/bin/bash
+# 轻量后端部署（light-update 的执行体）。
+#   - composer.lock 门：远端 raw/PHP/composer.lock == 本机？ 相同→code.zip(~1MB,保留vendor)；不同→latest.zip全量
+#   - **先下载校验，确认源存在后才做任何破坏性操作**（避免"删了迁移又没铺上"）
+#   - 部署前 tar 备份 PHP 代码(排除 vendor)；migrate 后健康检查；失败自动回滚
+#   - 绝不 snap refresh 前端、绝不 apt
+# 退出码：0=成功(或无需更新)，1=失败/已回滚。末行输出 DEPLOY_OK <ver> | ROLLED_BACK | ABORT_*
+set -uo pipefail
+S3="https://aaden-backend.s3.eu-central-1.amazonaws.com"
+STAGE=/var/tmp/aaden-lu-stage      # 绝对路径：download 与 sudo cp 必须看到同一个目录（~ 在 sudo 下会变 /root）
+BACKUP=/var/lib/aaden-php-backup
+PW='Innerken322.'
+sudoS(){ echo "$PW" | sudo -S bash -c "$*"; }
 
-cd files/ || exit
-./getFile.sh
+# 早失败：老 aaden 设备的 sudo 密码可能不是共享密码。先探一次 ——
+# 否则会一路穿到 ABORT_DOWNLOAD，把"密码不符"误报成"下载问题"，排障跑偏。
+# NOPASSWD 设备此探测同样通过（sudo 不问，管道密码被忽略）。
+if ! echo "$PW" | sudo -S true 2>/dev/null; then echo "ABORT_SUDO_AUTH (aaden sudo 密码不符?)"; exit 1; fi
 
-cd
-cd files || exit
-cp -rf backendFiles/* /var/www/html/
+# ---- composer.lock 门 ----
+REMOTE_LOCK=$(curl -s "$S3/raw/PHP/composer.lock" --max-time 30)
+LOCAL_LOCK=$(cat /var/www/html/PHP/composer.lock 2>/dev/null)
+RH=$(printf '%s' "$REMOTE_LOCK" | shasum -a 256 | cut -d' ' -f1)
+LH=$(printf '%s' "$LOCAL_LOCK"  | shasum -a 256 | cut -d' ' -f1)
+if [ -n "$REMOTE_LOCK" ] && [ "$RH" = "$LH" ]; then
+  ARTIFACT="code.zip"; echo "composer.lock 一致 → 轻量 code.zip"
+else
+  ARTIFACT="latest.zip"; echo "composer.lock 变化(或取不到) → 全量 latest.zip"
+fi
 
-cd /var/www/html/PHP || exit
-vendor/bin/phinx migrate
+# ---- 下载 + 解压到绝对暂存 ----
+sudoS "rm -rf $STAGE && mkdir -p $STAGE && chown $(id -un):$(id -gn) $STAGE"
+# 用 curl 而非 axel：axel 在设备上是 snap 包，受限写不进 /var/tmp。
+# code.zip 仅 ~1MB，curl 瞬间完成；latest.zip 全量走 curl 稍慢但那是罕见 fallback。
+ZIP="$STAGE/$ARTIFACT"
+curl -fsSL "$S3/$ARTIFACT" -o "$ZIP" --max-time 1200
+if [ ! -s "$ZIP" ]; then echo "下载失败或为空: $ARTIFACT"; echo "ABORT_DOWNLOAD"; exit 1; fi
+unzip -q -o "$ZIP" -d "$STAGE" && rm -f "$ZIP"
+
+# ---- 关键：破坏任何东西之前，先确认源 PHP 代码确实在 ----
+if [ ! -f "$STAGE/PHP/composer.lock" ] || [ ! -d "$STAGE/PHP" ]; then
+  echo "源包缺 PHP/ 或 composer.lock，中止（未改动任何文件）"
+  echo "ABORT_BAD_ARTIFACT"; exit 1
+fi
+
+# ---- TSE 门：绝不在有进行中的交易/TSE 签名时部署 ----
+# 结账把 START/FINISH 塞进 TseExecuteQueue，后台 worker 签名后置 finished=1（出错也置 1）。
+# 信号 = "未完成 且 已到期 且 新鲜(<5min)"：
+#   · 开着的桌吃两小时 → 不阻塞（TSE 任务早签完置 1 了）——正是要避免的"活动单门过严"
+#   · 正在签/待签的交易 → 有 finished=0 行 → 跳过等下轮 ——正是不能打断的瞬间
+#   · 5min 上界 → worker 挂了留下的卡死行不会永久拦住更新
+# 紧贴 cp 之前查，消掉"下载几秒期间开了新交易"的竞态。DB 凭据从 config.ini 读（全网 aaden/共享密码）。
+CONF=/var/www/html/Resource/config/config.ini
+DBCREDS=$(sudoS "php -r '\$c=@parse_ini_file(\"$CONF\",true);\$d=\$c[\"DB\"]??[];echo (\$d[\"host\"]??\"localhost\").\"|\".(\$d[\"user\"]??\"aaden\").\"|\".(\$d[\"password\"]??\"\");'" 2>/dev/null)
+DB_HOST="${DBCREDS%%|*}"; _r="${DBCREDS#*|}"; DB_USER="${_r%%|*}"; DB_PASS="${_r#*|}"
+if [ -n "$DB_USER" ] && [ -n "$DB_PASS" ]; then
+  DUE=$(MYSQL_PWD="$DB_PASS" mysql -u"$DB_USER" -h"${DB_HOST:-localhost}" -N -e \
+    "SELECT COUNT(*) FROM aaden.TseExecuteQueue WHERE finished=0 AND nextExecuteTime<=NOW() AND createdAt>=NOW()-INTERVAL 5 MINUTE;" 2>/dev/null)
+else
+  DUE=""
+fi
+if [ -z "$DUE" ]; then
+  # 查不到 = 无法确认 TSE 状态 → 对财政数据保守跳过（不部署也不冒险打断签名）。
+  # 非破坏性：此刻还没动任何文件。版本停滞会被 fleet-rollout-status 监控发现。
+  echo "TSE 队列查询失败，保守跳过本轮（未改动任何文件）"; echo "SKIP_TSE_QUERY"; exit 0
+fi
+if [ "$DUE" -gt 0 ]; then
+  echo "有进行中的交易/TSE 签名 (due=$DUE)，跳过本轮，等下个周期"; echo "SKIP_TSE_BUSY"; exit 0
+fi
+echo "TSE 队列空闲 (due=0)，可安全部署"
+
+# ---- 备份 PHP 代码(排除 vendor) ----
+sudoS "rm -rf $BACKUP && mkdir -p $BACKUP && tar czf $BACKUP/php-code.tgz --exclude='PHP/vendor' -C /var/www/html PHP package.json 2>/dev/null"
+
+# ---- 部署（源已校验，可安全 rm+cp）----
+sudoS "rm -rf /var/www/html/PHP/DB/migrations/*"
+if [ "$ARTIFACT" = "code.zip" ]; then
+  sudoS "cp -rf $STAGE/PHP/. /var/www/html/PHP/"
+  sudoS "curl -s '$S3/raw/package.json' -o /var/www/html/package.json --max-time 30"
+else
+  sudoS "cp -rf $STAGE/. /var/www/html/"
+fi
+sudoS "chmod -R 777 /var/www/html/Resource; chmod +x /var/www/html/crontab.sh /var/www/html/PHP/vendor/bin/phinx 2>/dev/null; chown -hR www-data:www-data /var/www/html"
+
+# ---- migrate ----
+sudoS "cd /var/www/html/PHP && vendor/bin/phinx migrate" 2>&1 | tail -3
+
+# ---- 健康检查 ----
+HEALTHY=1
+for ep in "Orders.php?op=getCurrentActiveOrders&lang=DE" "MyVersion.php?op=version"; do
+  c=$(curl -s -o /dev/null -w '%{http_code}' "http://localhost/PHP/$ep" --max-time 15)
+  echo "  健康检查 $ep -> $c"; [ "$c" = "200" ] || HEALTHY=0
+done
+
+# ---- 回滚 or 成功 ----
+if [ "$HEALTHY" != "1" ]; then
+  echo "健康检查失败 → 回滚"
+  sudoS "tar xzf $BACKUP/php-code.tgz -C /var/www/html && chown -hR www-data:www-data /var/www/html"
+  sudoS "rm -rf $STAGE"; echo "ROLLED_BACK"; exit 1
+fi
+sudoS "rm -rf $STAGE"
+echo "DEPLOY_OK $(python3 -c "import json;print(json.load(open('/var/www/html/package.json'))['version'])" 2>/dev/null)"

package/AadenDeploy/upgrade.sh

@@ -8,4 +8,7 @@ sudo npm i aaden-cli -g
 
 aaden-cli patch
 
-
+# 后端也走 aaden-cli 通道自愈：light-update 自带 版本门/灰度门/活动单门，
+# 已最新则空跑，营业时间被 @reboot 触发也不会打断收银（不 snap refresh 前端、不 apt）。
+# 这条让"后端自动更新"重新依赖活着的 npm+S3 管线，而不是失效的 git token。
+aaden-cli light-update

package/dist/index.js

@@ -18507,7 +18507,7 @@ module.exports = JSON.parse('{"name":"axios","version":"0.19.2","description":"P
 /***/ ((module) => {
 
 "use strict";
-module.exports = {"i8":"1.6.95"};
+module.exports = {"i8":"1.6.97"};
 
 /***/ })
 
@@ -18589,7 +18589,7 @@ const colors = __nccwpck_require__(3045)
 const fs = __nccwpck_require__(7147)
 const InnerKenTimeStampFormat = 'YYYYMMDDHHmmss'
 const prompts = __nccwpck_require__(9646)
-const {deviceEcho, logAction} = __nccwpck_require__(7415)
+const {deviceEcho, logAction, getCurrentDeviceId} = __nccwpck_require__(7415)
 const GlobalDeviceId = 'notset'
 
 const {program} = __nccwpck_require__(1904)
@@ -18609,6 +18609,7 @@ console.log(
 program
     .option('-d, --debug', 'use Debug Out put')
 program.command('update [channel]').action(update)
+program.command('light-update').action(lightUpdate) // 轻量+带闸门的后端部署，供 auto-upgrade/patch 调用
 program.command('rollback').action(rollback)
 program
     .command('install <deviceId>')
@@ -19072,6 +19073,103 @@ async function update(channel = '') {
 
 }
 
+/**
+ * 轻量、带闸门的后端部署 —— 专为「每日 auto-upgrade / 一次性 patch」自动调用而设计。
+ *
+ * 与 `update`（走 update.sh）的区别：
+ *   - **不 snap refresh aaden-vue-app**（不会重启收银前端）
+ *   - **不 apt install**
+ *   - 三道闸门保证「营业时间被触发也安全」：
+ *       ① 版本门：S3 版本 == 本机版本 → 跳过（已最新，重启也不白部署）
+ *       ② 灰度门：只部署到 cloud `deviceLog.maxVersion` 允许的版本（-1=不设限）
+ *                 → 可先给少数设备设 maxVersion 做金丝雀，其余自动跳过
+ *       ③ TSE 门：有进行中的交易/TSE 签名 → 跳过（在 lightUpdate.sh 里查 TseExecuteQueue，
+ *                 紧贴 cp 之前，避免"下载期间开了新交易"的竞态；开桌吃饭不阻塞，只有正在签的交易阻塞）
+ *   - 结果（部署/跳过/失败）经 logAction 写入 cloud 事件日志，可在 deviceLog/eventList 观测
+ */
+async function lightUpdate() {
+    try {
+        const localVersion = getBackendVersionOffline()
+        const remoteVersion = (await hillo.get('https://aaden-backend.s3.eu-central-1.amazonaws.com/raw/package.json')).version
+
+        // ① 版本门：只在 S3 **严格更新** 时部署。
+        // 不能只判 `===`：raw/package.json 可能比 latest.zip 晚几分钟才刷新，
+        // 那个窗口里某台设备可能已经比 raw 标记的版本更新——只判相等会把它降级重铺。
+        // 只往上升、绝不降级。
+        if (!versionGt(remoteVersion, localVersion)) {
+            console.log(('后端已是最新或更高 (本机 ' + localVersion + ' / S3 ' + remoteVersion + ')，跳过 light-update').green)
+            return
+        }
+
+        // ② 灰度门（maxVersion 来自 cloud deviceLog；-1 或取不到 = 不设限，与既有 git 逻辑一致）
+        const deviceId = await getCurrentDeviceId()
+        const maxVersion = await getDeviceMaxVersion(deviceId)
+        if (maxVersion && maxVersion !== '-1' && versionGt(remoteVersion, maxVersion)) {
+            const msg = 'light-update 跳过：灰度闸门 remote=' + remoteVersion + ' > maxVersion=' + maxVersion
+            console.log(msg.yellow)
+            await logAction(msg, 0)
+            return
+        }
+
+        // ③ TSE 门已下移到 lightUpdate.sh：在 cp 之前查 TseExecuteQueue（finished=0 且到期且新鲜），
+        // 有进行中的交易/TSE 签名就跳过。放在脚本里而非这里，是为了紧贴破坏性 cp、
+        // 消掉"这里查过没单 → 下载几秒 → 期间开了新交易 → cp 打断签名"的竞态窗口。
+
+        // lightUpdate.sh 自己完成：TSE 门 + composer.lock 门(选 code.zip 或 latest.zip) + 下载 + 备份
+        // + 部署 + migrate + 健康检查/失败回滚。退出码：0=成功，1=已回滚。
+        const command = [
+            ...getPrivilegeCMD('AadenDeploy/lightUpdate.sh'),
+            'cd AadenDeploy',
+            './lightUpdate.sh'
+        ]
+        const {code} = await cli.executeInShell(command, program.debug)
+
+        const newVersion = readBackendVersionFresh()
+        if (code !== 0) {
+            await logAction('light-update 失败/已回滚 (仍 ' + newVersion + ')', code || 1)
+        } else if (newVersion !== localVersion) {
+            await logAction('light-update 完成 ' + localVersion + ' -> ' + newVersion, 0)
+        } else {
+            await logAction('light-update 无实际变化 (' + newVersion + ')', 0)
+        }
+    } catch (e) {
+        console.error(e)
+        try { await logAction('light-update 异常: ' + (e.message || e), 1) } catch (_) {}
+    }
+}
+
+/** 比较点分数字版本，a > b 返回 true。'1.9.61' > '1.7.908' === true。 */
+function versionGt(a, b) {
+    const pa = String(a).split('.').map(n => parseInt(n) || 0)
+    const pb = String(b).split('.').map(n => parseInt(n) || 0)
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const x = pa[i] || 0, y = pb[i] || 0
+        if (x > y) return true
+        if (x < y) return false
+    }
+    return false
+}
+
+/** 从 cloud deviceLog 取本机版本天花板；取不到按不设限（-1），与 UpdateSelf 的 getDeviceLog 一致。 */
+async function getDeviceMaxVersion(deviceId) {
+    try {
+        const res = await hillo.get('https://cloud-v2.aaden.io/deviceLog/get/' + deviceId)
+        return (res && res.maxVersion) ? res.maxVersion : '-1'
+    } catch (e) {
+        console.log('取 maxVersion 失败，按不设限处理:', e.message)
+        return '-1'
+    }
+}
+
+/** 直接读文件、绕过 require 缓存 —— 部署后读到的必须是新版本号，不能是进程启动时缓存的旧值。 */
+function readBackendVersionFresh() {
+    try {
+        return JSON.parse(fs.readFileSync('/var/www/html/package.json', 'utf8')).version
+    } catch (e) {
+        return '0.0.0'
+    }
+}
+
 async function install(deviceId) {
     const channel = 'stable'
     const installApp = true

package/dist/patch/202608181934restoreBackendViaS3.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# 一次性修复：因 GitHub token 失效，git 后端自动更新已停摆，几百台设备卡在旧版本。
+# 改走活着的 S3 通道把当前 stable 铺下来。light-update 幂等且带三道闸门，重复跑安全。
+aaden-cli light-update

package/index.js

@@ -8,7 +8,7 @@ const colors = require('colors')
 const fs = require('fs')
 const InnerKenTimeStampFormat = 'YYYYMMDDHHmmss'
 const prompts = require('prompts')
-const {deviceEcho, logAction} = require('./modules/firebase')
+const {deviceEcho, logAction, getCurrentDeviceId} = require('./modules/firebase')
 const GlobalDeviceId = 'notset'
 
 const {program} = require('commander')
@@ -28,6 +28,7 @@ console.log(
 program
     .option('-d, --debug', 'use Debug Out put')
 program.command('update [channel]').action(update)
+program.command('light-update').action(lightUpdate) // 轻量+带闸门的后端部署，供 auto-upgrade/patch 调用
 program.command('rollback').action(rollback)
 program
     .command('install <deviceId>')
@@ -491,6 +492,103 @@ async function update(channel = '') {
 
 }
 
+/**
+ * 轻量、带闸门的后端部署 —— 专为「每日 auto-upgrade / 一次性 patch」自动调用而设计。
+ *
+ * 与 `update`（走 update.sh）的区别：
+ *   - **不 snap refresh aaden-vue-app**（不会重启收银前端）
+ *   - **不 apt install**
+ *   - 三道闸门保证「营业时间被触发也安全」：
+ *       ① 版本门：S3 版本 == 本机版本 → 跳过（已最新，重启也不白部署）
+ *       ② 灰度门：只部署到 cloud `deviceLog.maxVersion` 允许的版本（-1=不设限）
+ *                 → 可先给少数设备设 maxVersion 做金丝雀，其余自动跳过
+ *       ③ TSE 门：有进行中的交易/TSE 签名 → 跳过（在 lightUpdate.sh 里查 TseExecuteQueue，
+ *                 紧贴 cp 之前，避免"下载期间开了新交易"的竞态；开桌吃饭不阻塞，只有正在签的交易阻塞）
+ *   - 结果（部署/跳过/失败）经 logAction 写入 cloud 事件日志，可在 deviceLog/eventList 观测
+ */
+async function lightUpdate() {
+    try {
+        const localVersion = getBackendVersionOffline()
+        const remoteVersion = (await hillo.get('https://aaden-backend.s3.eu-central-1.amazonaws.com/raw/package.json')).version
+
+        // ① 版本门：只在 S3 **严格更新** 时部署。
+        // 不能只判 `===`：raw/package.json 可能比 latest.zip 晚几分钟才刷新，
+        // 那个窗口里某台设备可能已经比 raw 标记的版本更新——只判相等会把它降级重铺。
+        // 只往上升、绝不降级。
+        if (!versionGt(remoteVersion, localVersion)) {
+            console.log(('后端已是最新或更高 (本机 ' + localVersion + ' / S3 ' + remoteVersion + ')，跳过 light-update').green)
+            return
+        }
+
+        // ② 灰度门（maxVersion 来自 cloud deviceLog；-1 或取不到 = 不设限，与既有 git 逻辑一致）
+        const deviceId = await getCurrentDeviceId()
+        const maxVersion = await getDeviceMaxVersion(deviceId)
+        if (maxVersion && maxVersion !== '-1' && versionGt(remoteVersion, maxVersion)) {
+            const msg = 'light-update 跳过：灰度闸门 remote=' + remoteVersion + ' > maxVersion=' + maxVersion
+            console.log(msg.yellow)
+            await logAction(msg, 0)
+            return
+        }
+
+        // ③ TSE 门已下移到 lightUpdate.sh：在 cp 之前查 TseExecuteQueue（finished=0 且到期且新鲜），
+        // 有进行中的交易/TSE 签名就跳过。放在脚本里而非这里，是为了紧贴破坏性 cp、
+        // 消掉"这里查过没单 → 下载几秒 → 期间开了新交易 → cp 打断签名"的竞态窗口。
+
+        // lightUpdate.sh 自己完成：TSE 门 + composer.lock 门(选 code.zip 或 latest.zip) + 下载 + 备份
+        // + 部署 + migrate + 健康检查/失败回滚。退出码：0=成功，1=已回滚。
+        const command = [
+            ...getPrivilegeCMD('AadenDeploy/lightUpdate.sh'),
+            'cd AadenDeploy',
+            './lightUpdate.sh'
+        ]
+        const {code} = await cli.executeInShell(command, program.debug)
+
+        const newVersion = readBackendVersionFresh()
+        if (code !== 0) {
+            await logAction('light-update 失败/已回滚 (仍 ' + newVersion + ')', code || 1)
+        } else if (newVersion !== localVersion) {
+            await logAction('light-update 完成 ' + localVersion + ' -> ' + newVersion, 0)
+        } else {
+            await logAction('light-update 无实际变化 (' + newVersion + ')', 0)
+        }
+    } catch (e) {
+        console.error(e)
+        try { await logAction('light-update 异常: ' + (e.message || e), 1) } catch (_) {}
+    }
+}
+
+/** 比较点分数字版本，a > b 返回 true。'1.9.61' > '1.7.908' === true。 */
+function versionGt(a, b) {
+    const pa = String(a).split('.').map(n => parseInt(n) || 0)
+    const pb = String(b).split('.').map(n => parseInt(n) || 0)
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const x = pa[i] || 0, y = pb[i] || 0
+        if (x > y) return true
+        if (x < y) return false
+    }
+    return false
+}
+
+/** 从 cloud deviceLog 取本机版本天花板；取不到按不设限（-1），与 UpdateSelf 的 getDeviceLog 一致。 */
+async function getDeviceMaxVersion(deviceId) {
+    try {
+        const res = await hillo.get('https://cloud-v2.aaden.io/deviceLog/get/' + deviceId)
+        return (res && res.maxVersion) ? res.maxVersion : '-1'
+    } catch (e) {
+        console.log('取 maxVersion 失败，按不设限处理:', e.message)
+        return '-1'
+    }
+}
+
+/** 直接读文件、绕过 require 缓存 —— 部署后读到的必须是新版本号，不能是进程启动时缓存的旧值。 */
+function readBackendVersionFresh() {
+    try {
+        return JSON.parse(fs.readFileSync('/var/www/html/package.json', 'utf8')).version
+    } catch (e) {
+        return '0.0.0'
+    }
+}
+
 async function install(deviceId) {
     const channel = 'stable'
     const installApp = true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aaden-cli",
-  "version": "1.6.95",
+  "version": "1.6.97",
   "description": "",
   "main": "dist/index.js",
   "scripts": {

package/patch/202608181934restoreBackendViaS3.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# 一次性修复：因 GitHub token 失效，git 后端自动更新已停摆，几百台设备卡在旧版本。
+# 改走活着的 S3 通道把当前 stable 铺下来。light-update 幂等且带三道闸门，重复跑安全。
+aaden-cli light-update

package/scripts/fleet-rollout-status.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+"""车队后端版本滚动进度表。数据源：cloud-v2 的 deviceLog/list（每台每 5 分钟上报）。
+
+用法:
+    python3 scripts/fleet-rollout-status.py 1.9.62        # 看向 1.9.62 铺开的进度
+    python3 scripts/fleet-rollout-status.py 1.9.62 --behind   # additionally 列出落后设备
+    python3 scripts/fleet-rollout-status.py               # 不给目标版本则只看分布
+"""
+import sys, json, time, urllib.request
+from collections import Counter
+
+LIST_URL = "https://cloud-v2.aaden.io/deviceLog/list"
+STALE_MIN = 30  # 超过这么多分钟没上报，视为离线/失联
+
+def fetch():
+    with urllib.request.urlopen(LIST_URL, timeout=60) as r:
+        return json.load(r)
+
+def main():
+    target = next((a for a in sys.argv[1:] if not a.startswith('-')), None)
+    show_behind = '--behind' in sys.argv
+    d = fetch()
+    now = int(time.time() * 1000)
+    total = len(d)
+    dist = Counter(x.get('backendVersion', '?') for x in d)
+    stale = [x for x in d if now - int(x.get('timestamp', 0) or 0) > STALE_MIN * 60 * 1000]
+
+    print(f"车队共 {total} 台   (数据源 deviceLog/list，每台每 5 分钟上报)")
+    print(f"失联(>{STALE_MIN}分钟无上报): {len(stale)} 台")
+    print()
+    if target:
+        on = [x for x in d if x.get('backendVersion') == target]
+        behind = [x for x in d if x.get('backendVersion') != target]
+        pct = len(on) * 100.0 / total if total else 0
+        bar = '#' * int(pct // 2.5) + '.' * (40 - int(pct // 2.5))
+        print(f"目标后端版本: {target}")
+        print(f"  已到位  [{bar}] {len(on)}/{total}  {pct:.1f}%")
+        print(f"  未到位  {len(behind)} 台")
+        print()
+        print("未到位版本分布:")
+        for v, n in Counter(x.get('backendVersion', '?') for x in behind).most_common():
+            print(f"    {v:>10}  {n} 台")
+        if show_behind:
+            print()
+            print("未到位设备(deviceId / 版本 / 名称首行):")
+            for x in sorted(behind, key=lambda x: x.get('deviceId', '')):
+                name = (x.get('deviceName') or '').split('\n')[0][:32]
+                print(f"    {str(x.get('deviceId','?')):>6}  {x.get('backendVersion','?'):>10}  {name}")
+    else:
+        print("后端版本分布:")
+        for v, n in dist.most_common():
+            print(f"    {v:>10}  {n} 台")
+
+if __name__ == '__main__':
+    main()