aaden-cli 1.6.119 → 1.6.121

package/AadenDeploy/aadensetup.sh

@@ -32,6 +32,8 @@ DEVICE_ID="$1"
 if [ -z "$DEVICE_ID" ]; then
   read -r -p '设备号: ' DEVICE_ID
 fi
+# 测试门店号段先拦（不用联网），再查云端撞号
+source "$DIR/farmRange.sh" && farm_range_guard "$DEVICE_ID" || exit 1
 bash "$DIR/checkDeviceId.sh" "$DEVICE_ID" || exit 1
 DEVICE_ID=$((10#$DEVICE_ID))
 export AADEN_SKIP_DEVICE_CHECK=1 # 后面 set-device-id 不再问第二遍

package/AadenDeploy/appCenterSync.sh

@@ -4,6 +4,8 @@
 #
 # light-update 只发 PHP/，AppCenter 以前只能跟 465MB 的 latest.zip 走；这里单独按应用同步。
 #   - 灰度门：manifest 的 rollout = {"devices":[...], "percent":N}，本机在名单里或 deviceId%100 < N 才动；没有 rollout = 全量
+#   - 根目录应用：manifest 顶层 rootApps 里的应用装到 docroot 根（/var/www/html/<App>，如老的 /App），其余逻辑同 apps；
+#     只认白名单 APPCENTER_ROOT_APPS（默认 "App"），防止 manifest 写错把 PHP 之类的目录换掉。老 CLI 只读 apps，不受影响
 #   - 按应用灰度：manifest 带 perAppRollout=true 时，每个应用按自己的 apps.<App>.rollout 判断（没有 = 全量），
 #     顶层 rollout 只管 ensureNoCache；老版本 CLI 不认 perAppRollout，照旧整体按顶层 rollout
 #   - ensureNoCache：manifest 打开时先确保 AppCenter 的 index.html 带 no-cache（ensureAppCenterNoCache.sh）
@@ -18,6 +20,7 @@
 # 用法: appCenterSync.sh [channel]
 #   APPCENTER_BASE       产物根地址，默认 S3；测试可用 file:///var/tmp/...（curl 都支持）
 #   APPCENTER_APPS       只同步这些应用（空格分隔）；不传 = manifest 里列出的全部应用，发哪些由发布端决定
+#   APPCENTER_ROOT_APPS  允许同步到 docroot 根的应用白名单（空格分隔），默认 "App"
 #   APPCENTER_DEVICE_ID  本机 deviceId（CLI 会传）；不传就问本机 PHP
 #   APPCENTER_RESULT     结果行另存的文件（CLI 会传）
 # 结果行（同时写进 $RESULT 给 CLI 上报）：APP_OK <App> <sha12> | APP_UP_TO_DATE <App> | APP_SKIP <App> <原因> |
@@ -26,7 +29,9 @@
 set -uo pipefail
 BASE="${APPCENTER_BASE:-https://aaden-backend.s3.eu-central-1.amazonaws.com/appcenter}"
 CHANNEL="${1:-stable}"
-WEB=/var/www/html/AppCenter
+DOCROOT=/var/www/html
+WEB=$DOCROOT/AppCenter
+ROOT_ALLOW=" ${APPCENTER_ROOT_APPS:-App} "
 STAGE=/var/tmp/aaden-appcenter-stage
 BACKUP=/var/lib/aaden-appcenter-backup
 LOCK=/var/tmp/aaden-appcenter.lock
@@ -50,7 +55,7 @@ flock -n 9 || { res "SKIP_LOCKED"; exit 0; }
 
 MANIFEST=$(curl -fsSL --max-time 30 "$BASE/$CHANNEL/manifest.json") \
   || { echo "取不到 $BASE/$CHANNEL/manifest.json"; res "ABORT_MANIFEST"; exit 1; }
-# 读 manifest：mf apps.Admin.zip / mf ensureNoCache / mf eligible <deviceId> / mf eligible_app <App> <deviceId>
+# 读 manifest：mf apps.Admin.zip / mf ensureNoCache / mf eligible <deviceId> / mf eligible_app <App> <deviceId> [apps|rootApps]
 mf(){
   printf '%s' "$MANIFEST" | python3 -c '
 import json, sys
@@ -67,8 +72,10 @@ def gate(r, dev):
 if sys.argv[1] == "eligible":
     print(gate(m.get("rollout"), sys.argv[2])); sys.exit()
 if sys.argv[1] == "eligible_app":
+    # eligible_app <App> <deviceId> [apps|rootApps]
+    kind = sys.argv[4] if len(sys.argv) > 4 else "apps"
     if m.get("perAppRollout") is True:
-        app = (m.get("apps") or {}).get(sys.argv[2]) or {}
+        app = (m.get(kind) or {}).get(sys.argv[2]) or {}
         print(gate(app.get("rollout"), sys.argv[3]))
     else:
         print(gate(m.get("rollout"), sys.argv[3]))
@@ -109,26 +116,32 @@ tree_ok(){ # $1=目录 $2=期望 treeSha256
 }
 
 sync_app(){
-  local APP="$1" LIVE="$WEB/$1" NEW="$STAGE/$1" TREE ZIP ZSHA
-  TREE=$(mf "apps.$APP.treeSha256"); ZIP=$(mf "apps.$APP.zip"); ZSHA=$(mf "apps.$APP.zipSha256")
-  if [ -z "$TREE" ]; then res "APP_SKIP $APP 不在manifest里"; return 0; fi
-  if [ "$(mf eligible_app "$APP" "${DEVICE_ID:-x}")" != "yes" ]; then res "APP_SKIP_ROLLOUT $APP"; return 0; fi
+  # $1=应用名 $2=apps（AppCenter/<App>，默认）或 rootApps（docroot 根 /<App>）
+  local APP="$1" KIND="${2:-apps}" LIVE NEW BAK URLP TAG TREE ZIP ZSHA
+  if [ "$KIND" = "rootApps" ]; then
+    LIVE="$DOCROOT/$APP"; NEW="$STAGE/root-$APP"; BAK="root-$APP"; URLP="$APP"; TAG="/$APP"
+  else
+    LIVE="$WEB/$APP"; NEW="$STAGE/$APP"; BAK="$APP"; URLP="AppCenter/$APP"; TAG="$APP"
+  fi
+  TREE=$(mf "$KIND.$APP.treeSha256"); ZIP=$(mf "$KIND.$APP.zip"); ZSHA=$(mf "$KIND.$APP.zipSha256")
+  if [ -z "$TREE" ]; then res "APP_SKIP $TAG 不在manifest里"; return 0; fi
+  if [ "$(mf eligible_app "$APP" "${DEVICE_ID:-x}" "$KIND")" != "yes" ]; then res "APP_SKIP_ROLLOUT $TAG"; return 0; fi
   # manifest 来自网络：只接受预期格式，防止路径穿越
   if ! [[ "$TREE" =~ ^[0-9a-f]{64}$ && "$ZSHA" =~ ^[0-9a-f]{64}$ && "$ZIP" =~ ^blobs/[A-Za-z0-9._-]+\.zip$ ]]; then
-    res "APP_ABORT_BAD_MANIFEST $APP"; return 1
+    res "APP_ABORT_BAD_MANIFEST $TAG"; return 1
   fi
 
   # ---- manifest 门 ----
-  if tree_ok "$LIVE" "$TREE"; then res "APP_UP_TO_DATE $APP"; return 0; fi
-  echo "$APP: 本机与 manifest 不一致 → 同步到 ${TREE:0:12}"
+  if tree_ok "$LIVE" "$TREE"; then res "APP_UP_TO_DATE $TAG"; return 0; fi
+  echo "$TAG: 本机与 manifest 不一致 → 同步到 ${TREE:0:12}"
 
   # ---- 下载 + 校验（此时还没动线上目录）----
   sudoS "rm -rf '$NEW' '$NEW.zip' '$NEW.failed'"
-  curl -fsSL --max-time 1200 "$BASE/$ZIP" -o "$NEW.zip" || { res "APP_ABORT_DOWNLOAD $APP"; return 1; }
-  [ "$(sha256sum "$NEW.zip" | cut -d' ' -f1)" = "$ZSHA" ] || { res "APP_ABORT_CHECKSUM $APP"; rm -f "$NEW.zip"; return 1; }
+  curl -fsSL --max-time 1200 "$BASE/$ZIP" -o "$NEW.zip" || { res "APP_ABORT_DOWNLOAD $TAG"; return 1; }
+  [ "$(sha256sum "$NEW.zip" | cut -d' ' -f1)" = "$ZSHA" ] || { res "APP_ABORT_CHECKSUM $TAG"; rm -f "$NEW.zip"; return 1; }
   mkdir -p "$NEW" && unzip -q -o "$NEW.zip" -d "$NEW"; rm -f "$NEW.zip"
   if ! { [ -f "$NEW/index.html" ] && tree_ok "$NEW" "$TREE"; }; then
-    res "APP_ABORT_BAD_ARTIFACT $APP"; rm -rf "$NEW"; return 1
+    res "APP_ABORT_BAD_ARTIFACT $TAG"; rm -rf "$NEW"; return 1
   fi
   # zip 里带的是打包时的旧 mtime；浏览器按 Last-Modified 的年龄启发式缓存，所以改成现在（只改 mtime 不改内容，不影响校验）
   touch "$NEW/index.html"
@@ -137,7 +150,7 @@ sync_app(){
   local CARRIED=0
   if [ -d "$LIVE" ]; then
     python3 "$HERE/appcenterRefs.py" "$LIVE" | LC_ALL=C sort > "$NEW.old" \
-      || { res "APP_ABORT_REFS $APP"; rm -rf "$NEW" "$NEW.old"; return 1; }
+      || { res "APP_ABORT_REFS $TAG"; rm -rf "$NEW" "$NEW.old"; return 1; }
     paths "$NEW/.appcenter-manifest" > "$NEW.new"
     LC_ALL=C comm -23 "$NEW.old" "$NEW.new" > "$NEW.carry"
     CARRIED=$(wc -l < "$NEW.carry" | tr -d ' ')
@@ -145,34 +158,42 @@ sync_app(){
     [ "$CARRIED" -gt 0 ] && tar -C "$LIVE" -cf - -T "$NEW.carry" | tar -C "$NEW" -xf -
     rm -f "$NEW.old" "$NEW.new" "$NEW.carry"
   fi
-  echo "$APP: 保留上一代文件 $CARRIED 个"
+  echo "$TAG: 保留上一代文件 $CARRIED 个"
 
   # ---- 替换：两次 rename，中间只有毫秒级空窗 ----
-  sudoS "mkdir -p '$BACKUP' && rm -rf '$BACKUP/$APP' && chown -R www-data:www-data '$NEW'"
-  [ -d "$LIVE" ] && sudoS "mv '$LIVE' '$BACKUP/$APP'"
+  sudoS "mkdir -p '$BACKUP' && rm -rf '$BACKUP/$BAK' && chown -R www-data:www-data '$NEW'"
+  [ -d "$LIVE" ] && sudoS "mv '$LIVE' '$BACKUP/$BAK'"
   sudoS "mv '$NEW' '$LIVE'"
 
   # ---- 健康检查：首页、入口 js、文件校验 ----
   local HEALTHY=1 MAIN c
   MAIN=$(grep -oE 'src=["'"'"']?[^"'"'"' >]+\.js' "$LIVE/index.html" | grep -vE '//' | head -1 | sed -E 's/^src=["'"'"']?(\.\/)?//')
   for p in "" "$MAIN"; do
-    c=$(curl -s -o /dev/null -w '%{http_code}' "http://localhost/AppCenter/$APP/$p" --max-time 15)
-    echo "  健康检查 /AppCenter/$APP/$p -> $c"; [ "$c" = "200" ] || HEALTHY=0
+    c=$(curl -s -o /dev/null -w '%{http_code}' "http://localhost/$URLP/$p" --max-time 15)
+    echo "  健康检查 /$URLP/$p -> $c"; [ "$c" = "200" ] || HEALTHY=0
   done
   tree_ok "$LIVE" "$TREE" || { echo "  线上目录校验失败"; HEALTHY=0; }
 
   if [ "$HEALTHY" != "1" ]; then
-    sudoS "mv '$LIVE' '$NEW.failed'; [ -d '$BACKUP/$APP' ] && mv '$BACKUP/$APP' '$LIVE'"
-    res "APP_ROLLED_BACK $APP"; return 1
+    sudoS "mv '$LIVE' '$NEW.failed'; [ -d '$BACKUP/$BAK' ] && mv '$BACKUP/$BAK' '$LIVE'"
+    res "APP_ROLLED_BACK $TAG"; return 1
   fi
-  res "APP_OK $APP ${TREE:0:12} carried=$CARRIED"
+  res "APP_OK $TAG ${TREE:0:12} carried=$CARRIED"
 }
 
 # 不指定就同步 manifest 里的全部应用（营业中一直开着的 App/KDS 等，发布端先别放进 manifest）
 APPS="${APPCENTER_APPS:-$(printf '%s' "$MANIFEST" | python3 -c 'import json, sys; print(" ".join(sorted(json.load(sys.stdin).get("apps", {}))))')}"
 sudoS "mkdir -p '$STAGE' && chown $(id -un):$(id -gn) '$STAGE'"
 for APP in $APPS; do
+  [[ "$APP" == /* ]] && continue   # APPCENTER_APPS 里 /<App> 指的是根目录应用，下面单独处理
   if ! [[ "$APP" =~ ^[A-Za-z0-9_-]+$ ]]; then res "APP_SKIP $APP 名字不合法"; continue; fi
-  sync_app "$APP" || FAILED=1
+  sync_app "$APP" apps || FAILED=1
+done
+# 根目录应用（老的 /App 等）：只同步白名单里的；APPCENTER_APPS 指定了就只按它过滤
+ROOT_APPS=$(printf '%s' "$MANIFEST" | python3 -c 'import json, sys; print(" ".join(sorted(json.load(sys.stdin).get("rootApps") or {})))')
+for APP in $ROOT_APPS; do
+  if ! [[ "$APP" =~ ^[A-Za-z0-9_-]+$ ]] || [[ "$ROOT_ALLOW" != *" $APP "* ]]; then res "APP_SKIP /$APP 不在根目录白名单"; continue; fi
+  if [ -n "${APPCENTER_APPS:-}" ] && [[ " $APPCENTER_APPS " != *" /$APP "* ]]; then continue; fi
+  sync_app "$APP" rootApps || FAILED=1
 done
 exit $FAILED

package/AadenDeploy/farmRange.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+# 测试门店农场号段：只有农场的容器测试店能用（它设 AADEN_FARM=1）。真机装机、改号拿到这些号就停下——
+# 同一个号装两台机器，上报、备份、ngrok 会互相覆盖。
+# ⚠ 要和云端的 TEST_STORE_RANGES（aaden.test-stores.ranges，默认 9020-9099）保持一致，改号段两边一起改。
+# 用法：source 本文件，然后 farm_range_guard <设备号> || exit 1
+FARM_RANGE_MIN=9020
+FARM_RANGE_MAX=9099
+
+# 号在号段里且没有 AADEN_FARM=1 → 打提示、返回 1；不是数字的交给后面的检查去拦
+farm_range_guard() {
+  local id
+  id=$(printf '%s' "$1" | tr -d '[:space:]')
+  [[ "$id" =~ ^[0-9]+$ ]] || return 0
+  id=$((10#$id))
+  if [ "$id" -ge "$FARM_RANGE_MIN" ] && [ "$id" -le "$FARM_RANGE_MAX" ] && [ "${AADEN_FARM:-}" != "1" ]; then
+    echo "✗ $id 在测试门店号段（$FARM_RANGE_MIN–$FARM_RANGE_MAX）里，只能给测试门店农场用。真门店请用 ERP 里建档的设备号。"
+    return 1
+  fi
+  return 0
+}

package/AadenDeploy/setDeviceId.sh

@@ -31,6 +31,7 @@ if ! [[ "$NEW_ID" =~ ^[0-9]+$ ]]; then
   exit 1
 fi
 NEW_ID=$((10#$NEW_ID)) # 去掉前导零，和云端、ERP 编号一致
+source "$DIR/farmRange.sh" && farm_range_guard "$NEW_ID" || exit 1
 NAME="IK$(printf '%04d' "$NEW_ID")"
 HOST="aaden$(printf '%04d' "$NEW_ID")" # 和 ngrok 的 ik 号一样补到 4 位：aaden0001、aaden1958
 

package/dist/index.js

@@ -570,6 +570,29 @@ function collectHostInfo() {
 module.exports = {collectHostInfo}
 
 
+/***/ }),
+
+/***/ 5906:
+/***/ ((module) => {
+
+// 盒子上装的 aaden snap（Electron 桌面收银）版本，do-log 报给云端 device_log_model.frontend_version。
+// 以前解析 `snap info aaden` 的最后一行：装了 snap 时是 `installed: 1.2.x …`，没装时是 channels 表的
+// `latest/edge: …`，于是全网 500 多台没装 snap 的盒子都报成了字面量 "latest/edge:"。
+// 现在读 `snap list aaden`：装了就有一行以 "aaden " 开头（表头会随系统语言变，不能按行号取）；
+// 没装时 stdout 为空、报错在 stderr，返回空串。写法兼容老盒子上的 Node（不用 ?. 和 ??）。
+
+function parseSnapListVersion(output) {
+    const lines = String(output || '').split('\n')
+    for (let i = 0; i < lines.length; i++) {
+        const cols = lines[i].trim().split(/\s+/)
+        if (cols[0] === 'aaden' && cols.length >= 2) return cols[1]
+    }
+    return ''
+}
+
+module.exports = {parseSnapListVersion}
+
+
 /***/ }),
 
 /***/ 8226:
@@ -19246,7 +19269,7 @@ module.exports = JSON.parse('{"name":"axios","version":"0.19.2","description":"P
 /***/ ((module) => {
 
 "use strict";
-module.exports = {"i8":"1.6.119"};
+module.exports = {"i8":"1.6.121"};
 
 /***/ })
 
@@ -19334,6 +19357,7 @@ const prompts = __nccwpck_require__(9646)
 const {deviceEcho, logAction, getCurrentDeviceId} = __nccwpck_require__(7415)
 const {collectHostInfo} = __nccwpck_require__(3727)
 const {collectTseInfo} = __nccwpck_require__(6677)
+const {parseSnapListVersion} = __nccwpck_require__(5906)
 const deviceCommands = __nccwpck_require__(5363)
 const GlobalDeviceId = 'notset'
 
@@ -20241,12 +20265,10 @@ function doLogField(fn) {
 }
 
 async function doLog() {
-    // snap info 加超时：snapd 刷新卡住时它会一直不返回，do-log 就再也报不上来，
-    // 设备在云端看就是「失联」，云端命令也领不到
-    const frontendVersion = doLogField(() => {
-        const list = (cli.executeInShellSync('timeout 20 snap info aaden').output || '').split('\n')
-        return (list[list.length - 2] || '').replace(/\s+/g, ' ').split(' ')[1]
-    })
+    // 加超时：snapd 刷新卡住时 snap 命令会一直不返回，do-log 就再也报不上来，
+    // 设备在云端看就是「失联」，云端命令也领不到。没装 aaden snap 报空串（见 modules/snap-version.js）
+    const frontendVersion = doLogField(() =>
+        parseSnapListVersion(cli.executeInShellSync('timeout 20 snap list aaden').output))
     const diskUsage = doLogField(() => {
         const parts = (cli.executeInShellSync('timeout 20 df -h --total | command grep total | head -c-3 && echo \'\'').output || '').split(' ')
         return parts[parts.length - 1].replace('\n', '')

package/index.js

@@ -14,6 +14,7 @@ const prompts = require('prompts')
 const {deviceEcho, logAction, getCurrentDeviceId} = require('./modules/firebase')
 const {collectHostInfo} = require('./modules/host-info')
 const {collectTseInfo} = require('./modules/tse-info')
+const {parseSnapListVersion} = require('./modules/snap-version')
 const deviceCommands = require('./modules/device-commands')
 const GlobalDeviceId = 'notset'
 
@@ -921,12 +922,10 @@ function doLogField(fn) {
 }
 
 async function doLog() {
-    // snap info 加超时：snapd 刷新卡住时它会一直不返回，do-log 就再也报不上来，
-    // 设备在云端看就是「失联」，云端命令也领不到
-    const frontendVersion = doLogField(() => {
-        const list = (cli.executeInShellSync('timeout 20 snap info aaden').output || '').split('\n')
-        return (list[list.length - 2] || '').replace(/\s+/g, ' ').split(' ')[1]
-    })
+    // 加超时：snapd 刷新卡住时 snap 命令会一直不返回，do-log 就再也报不上来，
+    // 设备在云端看就是「失联」，云端命令也领不到。没装 aaden snap 报空串（见 modules/snap-version.js）
+    const frontendVersion = doLogField(() =>
+        parseSnapListVersion(cli.executeInShellSync('timeout 20 snap list aaden').output))
     const diskUsage = doLogField(() => {
         const parts = (cli.executeInShellSync('timeout 20 df -h --total | command grep total | head -c-3 && echo \'\'').output || '').split(' ')
         return parts[parts.length - 1].replace('\n', '')

package/modules/snap-version.js

@@ -0,0 +1,16 @@
+// 盒子上装的 aaden snap（Electron 桌面收银）版本，do-log 报给云端 device_log_model.frontend_version。
+// 以前解析 `snap info aaden` 的最后一行：装了 snap 时是 `installed: 1.2.x …`，没装时是 channels 表的
+// `latest/edge: …`，于是全网 500 多台没装 snap 的盒子都报成了字面量 "latest/edge:"。
+// 现在读 `snap list aaden`：装了就有一行以 "aaden " 开头（表头会随系统语言变，不能按行号取）；
+// 没装时 stdout 为空、报错在 stderr，返回空串。写法兼容老盒子上的 Node（不用 ?. 和 ??）。
+
+function parseSnapListVersion(output) {
+    const lines = String(output || '').split('\n')
+    for (let i = 0; i < lines.length; i++) {
+        const cols = lines[i].trim().split(/\s+/)
+        if (cols[0] === 'aaden' && cols.length >= 2) return cols[1]
+    }
+    return ''
+}
+
+module.exports = {parseSnapListVersion}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "aaden-cli",
-  "version": "1.6.119",
+  "version": "1.6.121",
   "description": "",
   "main": "dist/index.js",
   "scripts": {
-    "test": "node test.js",
+    "test": "node test/snap-version.test.js",
     "update": "git add . && release-it --ci"
   },
   "bin": {

package/test/snap-version.test.js

@@ -0,0 +1,24 @@
+// node test/snap-version.test.js；只用 Node 自带的 assert，老盒子上也能跑
+const assert = require('assert')
+const {parseSnapListVersion} = require('../modules/snap-version')
+
+// 装了 snap（stable 频道）
+assert.strictEqual(parseSnapListVersion(
+    'Name   Version  Rev  Tracking       Publisher  Notes\n' +
+    'aaden  1.2.158  183  latest/stable  aaden      classic\n'), '1.2.158')
+// 中文系统的表头；还停在 2020 年 edge 版本的机器
+assert.strictEqual(parseSnapListVersion(
+    '名称   版本   修订版本  追踪         发布者  注记\n' +
+    'aaden  1.4.7  73        latest/edge  aaden   classic\n'), '1.4.7')
+// 没装：stdout 为空（「未找到匹配的 snap」在 stderr）
+assert.strictEqual(parseSnapListVersion(''), '')
+assert.strictEqual(parseSnapListVersion(undefined), '')
+// 不能把别的 snap 的行当成 aaden
+assert.strictEqual(parseSnapListVersion(
+    'Name         Version  Rev  Tracking       Publisher  Notes\n' +
+    'aaden-other  9.9.9    1    latest/stable  x          -\n'), '')
+// 以前的 bug：snap info 没装时的输出，换了解析方式以后也不会再拿到 "latest/edge:"
+assert.strictEqual(parseSnapListVersion(
+    'channels:\n  latest/stable:    1.2.159 2026-10-11 (184) 122MB -\n  latest/edge:      1.4.7   2020-08-22  (73) 106MB -\n'), '')
+
+console.log('snap-version: ok')

package/test.js

@@ -1,6 +0,0 @@
-let i = 35
-while (i > 0) {
-  //console.log(`http://ik1017.ngrok.aaden.io/QR?TableName=${i}&Base=ik1017.ngrok.aaden.io`)
-  console.log(i)
-  i--
-}