aaden-cli 1.6.91 → 1.6.97

package/AadenDeploy/Utils/cottiNetplan.sh

@@ -0,0 +1,84 @@
+#!/bin/bash
+
+# 此脚本为指定的网卡设置静态 IP
+# IP: 192.168.121.20/24
+# 网关: 192.168.121.1
+# DNS: 192.168.121.1
+# 在 /etc/netplan/ 下新增文件 30-cotti.yaml 并应用配置
+# 需要 root 权限运行（推荐使用 sudo）
+
+set -e  # 遇到错误立即退出
+
+# 查找所有非 lo 的以太网接口
+mapfile -t INTERFACES < <(ip -o link show | awk -F': ' '/state UP|state DOWN/ && $2 !~ /lo/ {print $2}')
+
+if [ ${#INTERFACES[@]} -eq 0 ]; then
+    echo "错误：未找到任何可用网卡！"
+    exit 1
+fi
+
+# 优先尝试自动选择以 enp 开头的网卡
+INTERFACE=""
+for iface in "${INTERFACES[@]}"; do
+    if [[ $iface == enp* ]]; then
+        INTERFACE="$iface"
+        break
+    fi
+done
+
+# 如果没有找到 enp 开头的网卡，或者用户想手动选择，则进入手动选择流程
+if [ -z "$INTERFACE" ]; then
+    echo "未找到以 enp 开头的网卡，下面列出所有可用网卡："
+    for i in "${!INTERFACES[@]}"; do
+        idx=$((i+1))
+        echo "$idx) ${INTERFACES[i]}"
+    done
+
+    if [ ${#INTERFACES[@]} -eq 1 ]; then
+        echo "只检测到一个网卡，将自动选择：${INTERFACES[0]}"
+        INTERFACE="${INTERFACES[0]}"
+    else
+        while true; do
+            echo -n "请输入要配置的网卡编号（1-${#INTERFACES[@]}）："
+            read choice
+            if [[ "$choice" =~ ^[0-9]+$ ]] && [ "$choice" -ge 1 ] && [ "$choice" -le ${#INTERFACES[@]} ]; then
+                INTERFACE="${INTERFACES[$((choice-1))]}"
+                break
+            else
+                echo "输入无效，请输入有效的编号！"
+            fi
+        done
+    fi
+else
+    echo "自动选择网卡：$INTERFACE"
+fi
+
+echo "将为网卡 $INTERFACE 配置静态 IP 192.168.121.20/24"
+
+CONFIG_FILE="/etc/netplan/30-cotti.yaml"
+
+# 使用 cat 和 heredoc 写入 YAML 文件（注意缩进严格要求）
+sudo bash -c "cat > $CONFIG_FILE" << EOF
+network:
+  version: 2
+  renderer: NetworkManager
+  ethernets:
+    $INTERFACE:
+      dhcp4: false
+      addresses:
+        - 192.168.121.20/24
+      gateway4: 192.168.121.1
+      nameservers:
+        addresses:
+          - 192.168.121.1
+EOF
+
+echo "已生成配置文件：$CONFIG_FILE"
+echo "内容如下："
+sudo cat $CONFIG_FILE
+
+# 应用配置
+echo "正在应用配置..."
+sudo netplan apply
+
+echo "配置完成！请使用 ip addr show $INTERFACE 检查 IP 是否已生效。"

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.91"};
+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>')
@@ -18630,6 +18631,7 @@ program.command('update-tse').action(updateTse)
 program.command('update-win-tse').action(updateWindowsTse)
 program.command('check-version').action(getBackendVersionOffline)
 program.command('full-update').action(fullUpdate)
+program.command('cotti-netplan').action(cottiNetplan)
 
 program.command('db').action(enterDatabase)
 program.command('printer-test').action(testPrinter)
@@ -18843,7 +18845,8 @@ async function fullUpdate() {
         'sudo service apache2 restart',
         'aaden-cli fix-cronjob',
         'aaden-cli auto-write-gdpdu',
-        'sudo systemctl daemon-reload'
+        'sudo systemctl daemon-reload',
+        'aaden-cli ensure-print-log-rotate',
     ]
     const {code} = await cli.executeInShell(command, program.debug)
     await logAction("进行了full-update", code)
@@ -19070,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
@@ -19335,6 +19435,11 @@ function ensurePrintLogRotate() {
     }
 }
 
+async function cottiNetplan() {
+    await run('AadenDeploy/Utils/cottiNetplan.sh')
+    logAction("手动设置cotti netplan")
+}
+
 })();
 
 module.exports = __webpack_exports__;

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>')
@@ -49,6 +50,7 @@ program.command('update-tse').action(updateTse)
 program.command('update-win-tse').action(updateWindowsTse)
 program.command('check-version').action(getBackendVersionOffline)
 program.command('full-update').action(fullUpdate)
+program.command('cotti-netplan').action(cottiNetplan)
 
 program.command('db').action(enterDatabase)
 program.command('printer-test').action(testPrinter)
@@ -262,7 +264,8 @@ async function fullUpdate() {
         'sudo service apache2 restart',
         'aaden-cli fix-cronjob',
         'aaden-cli auto-write-gdpdu',
-        'sudo systemctl daemon-reload'
+        'sudo systemctl daemon-reload',
+        'aaden-cli ensure-print-log-rotate',
     ]
     const {code} = await cli.executeInShell(command, program.debug)
     await logAction("进行了full-update", code)
@@ -489,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
@@ -753,3 +853,8 @@ function ensurePrintLogRotate() {
         cli.executeInShell(command, program.debug)
     }
 }
+
+async function cottiNetplan() {
+    await run('AadenDeploy/Utils/cottiNetplan.sh')
+    logAction("手动设置cotti netplan")
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aaden-cli",
-  "version": "1.6.91",
+  "version": "1.6.97",
   "description": "",
   "main": "dist/index.js",
   "scripts": {
@@ -8,11 +8,11 @@
     "update": "git add . && release-it --ci"
   },
   "bin": {
-    "aaden-cli": "./dist/index.js"
+    "aaden-cli": "dist/index.js"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/innerken-gmbh/aaden-cli.git"
+    "url": "git+https://github.com/innerken-gmbh/aaden-cli.git"
   },
   "keywords": [],
   "author": "JuHaodong@innerken",

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()