aaden-cli 1.6.121 → 1.6.122

package/AadenDeploy/appCenterUsage.py

@@ -13,7 +13,9 @@ local（localhost/127.x，收银机本机）、lan（局域网 IP，平板等）
 
 用法: appCenterUsage.py [日志目录，默认 /var/log/apache2]；需要能读 access.log*（root 或 adm 组）。
 """
+import datetime
 import glob
+import hashlib
 import gzip
 import json
 import os
@@ -62,6 +64,64 @@ def parse_ts(ts):
     return day, f'{day}T{hms}'
 
 
+# index.html 里引用的入口 js（Vue CLI：js/app.1234abcd.js；Vite：assets/index-AbCd1234.js，老版 Vite：assets/index.1234abcd.js）
+MAIN_JS = re.compile(r'''src=["']?[^"'\s>]*?((?:js/(?:app|main|index)\.[0-9a-f]{8}|assets/(?:index|main)[.-][\w-]{8,})\.js)''')
+
+
+def app_version(rel):
+    try:
+        return _app_version(rel)
+    except Exception:  # 兜底：版本信息只是附带的，任何意外都不能让整份访问量上报失败
+        return {'version': 'unknown'}
+
+
+def _app_version(rel):
+    """
+    某个前端目录装的是哪个版本（前端版本遥测 A 层，云端 device_app_inventory.app_versions）。值一律是对象：
+      version / commit  AppCenter 发布时写进产物的 version.json（innerken-gmbh/workflows appcenter-publish）；
+                        没有就读目录里的 package.json；都没有是 "unknown"
+      treeSha           AppCenter 目录的 .appcenter-manifest 的 sha256，跟 S3 manifest 的 treeSha256 一致
+      fingerprint       index.html 的 sha256 前 16 位 + 入口 js 文件名：根目录老前端（不走 AppCenter、没有 version.json）
+      mainJs            靠它区分是哪次构建，云端按已知构建换算成版本号
+      deployedAt        index.html 的修改时间（≈ 装到这台机器的时间，不是构建时间）
+    读不到的字段就不带，任何异常都不能影响访问量上报。
+    """
+    d = os.path.join(DOCROOT, rel)
+    info = {'version': 'unknown'}
+    try:
+        for name, keys in (('version.json', ('version', 'commit')), ('package.json', ('version',))):
+            f = os.path.join(d, name)
+            if os.path.isfile(f):
+                with open(f, encoding='utf-8', errors='replace') as fh:
+                    data = json.load(fh)
+                for k in keys:
+                    v = str(data.get(k) or '').strip()
+                    if v:
+                        info[k] = v[:40]
+                break
+    except (OSError, ValueError, AttributeError):
+        pass
+    try:
+        mf = os.path.join(d, '.appcenter-manifest')
+        if os.path.isfile(mf):
+            with open(mf, 'rb') as fh:
+                info['treeSha'] = hashlib.sha256(fh.read()).hexdigest()
+    except OSError:
+        pass
+    try:
+        idx = os.path.join(d, 'index.html')
+        with open(idx, 'rb') as fh:
+            html = fh.read()
+        info['fingerprint'] = hashlib.sha256(html).hexdigest()[:16]
+        m = MAIN_JS.search(html.decode('utf-8', 'replace'))
+        if m:
+            info['mainJs'] = m.group(1)[:64]
+        info['deployedAt'] = datetime.datetime.fromtimestamp(os.path.getmtime(idx)).strftime('%Y-%m-%dT%H:%M:%S')
+    except OSError:
+        pass
+    return info
+
+
 def main():
     installed = []
     if os.path.isdir(APPCENTER):
@@ -135,6 +195,7 @@ def main():
         'logTo': log_to,
         'totalRequests': total,
         'installedApps': installed,
+        'appVersions': {app: app_version(app) for app in installed},
         'usage': [
             {
                 'app': app, 'day': day, 'pageLoads': s['pageLoads'], 'requests': s['requests'],

package/AadenDeploy/lightUpdate.sh

@@ -10,6 +10,13 @@
 # —— 光靠退出码分不清"TSE 忙跳过"和"产物陈旧"，deviceLog 里就只剩一句含糊的失败。
 set -uo pipefail
 S3="https://aaden-backend.s3.eu-central-1.amazonaws.com"
+# 参数只有 staging 通道（modules/release-channel.js，测试机）会传；不带参数 = 原来的 stable 路径，URL 和判断都不变。
+#   $1 = staging → 从 S3 的 staging/ 前缀拉（composer.lock 变了不退回全量包，直接跳过，由调用方这次改走 stable）
+#   $2 = semver  → 版本带「-」后缀时按 semver 比（1.9.83-staging.15 < 1.9.83）；纯 x.y.z 之间照旧
+CHANNEL="${1:-}"
+CMP="${2:-}"
+PREFIX=""
+[ "$CHANNEL" = staging ] && PREFIX="/staging"
 STAGE=/var/tmp/aaden-lu-stage      # 绝对路径：download 与 sudo cp 必须看到同一个目录（~ 在 sudo 下会变 /root）
 BACKUP=/var/lib/aaden-php-backup
 PW='Innerken322.'
@@ -29,13 +36,29 @@ if exec 9<"$LOCK" 2>/dev/null; then
 fi
 
 # 点分数字版本比较：a > b 返回 0。与 index.js 的 versionGt 同一套语义（'1.9.61' > '1.7.908'）。
-verGt(){ python3 -c "
+# 只有 staging 通道传了 semver、并且两个版本里至少一个带「-」后缀（1.9.83-staging.15）时才改用 verGtSemver；
+# 纯 x.y.z 之间、以及不带参数的 stable 路径，一律走下面原来的比较，结果和改动前逐个一致。
+verGt(){ [ "$CMP" = semver ] && case "$1$2" in *-*) verGtSemver "$1" "$2"; return;; esac; python3 -c "
 import sys
 pa=[int(x) if x.isdigit() else 0 for x in sys.argv[1].split('.')]
 pb=[int(x) if x.isdigit() else 0 for x in sys.argv[2].split('.')]
 n=max(len(pa),len(pb)); pa+=[0]*(n-len(pa)); pb+=[0]*(n-len(pb))
 sys.exit(0 if pa>pb else 1)" "$1" "$2" 2>/dev/null; }
 
+# semver：x.y.z[-预发布]，有预发布的 < 没有的，预发布逐段比（数字段按数值、数字段 < 字母段）；不合法一律「不大于」（不更新）
+verGtSemver(){ python3 -c "
+import re,sys
+def p(v):
+    m=re.fullmatch(r'(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?',v.strip())
+    if not m: return None
+    return [int(x) for x in m.groups()[:3]], (m.group(4).split('.') if m.group(4) else [])
+def key(pre):
+    if not pre: return (1,)
+    return (0,)+tuple((0,int(x),'') if x.isdigit() else (1,0,x) for x in pre)+((-1,0,''),)
+a,b=p(sys.argv[1]),p(sys.argv[2])
+if a is None or b is None: sys.exit(1)
+sys.exit(0 if (a[0],key(a[1]))>(b[0],key(b[1])) else 1)" "$1" "$2" 2>/dev/null; }
+
 # 读 package.json 的 version；读不到输出空串。
 pkgVer(){ python3 -c "
 import json,sys
@@ -48,12 +71,15 @@ except Exception: print('')" "$1" 2>/dev/null; }
 if ! echo "$PW" | sudo -S true 2>/dev/null; then finish "ABORT_SUDO_AUTH (aaden sudo 密码不符?)" 1; fi
 
 # ---- composer.lock 门 ----
-REMOTE_LOCK=$(curl -s "$S3/raw/PHP/composer.lock" --max-time 30)
+REMOTE_LOCK=$(curl -s "$S3$PREFIX/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"
+elif [ "$CHANNEL" = staging ]; then
+  # staging/ 下没有全量包：vendor 变了就这次不走 staging（调用方改走 stable），不拿 stable 的全量包冒充
+  finish "SKIP_STAGING_LOCK (staging 的 composer.lock 和本机不一致或取不到，这次不走 staging)" 1
 else
   ARTIFACT="latest.zip"; echo "composer.lock 变化(或取不到) → 全量 latest.zip"
 fi
@@ -69,7 +95,7 @@ ZIP="$STAGE/$ARTIFACT"
 DL=/var/tmp/aaden-lu-dl
 PART="$DL/$ARTIFACT.part"
 sudoS "mkdir -p $DL && chmod 777 $DL && { chown -f $(id -un):$(id -gn) $DL/* 2>/dev/null; true; }"
-HEAD=$(curl -sfI "$S3/$ARTIFACT" --max-time 30 | tr -d '\r')
+HEAD=$(curl -sfI "$S3$PREFIX/$ARTIFACT" --max-time 30 | tr -d '\r')
 ETAG=$(printf '%s\n' "$HEAD" | awk 'tolower($1)=="etag:"{print $2}' | tr -d '"')
 SIZE=$(printf '%s\n' "$HEAD" | awk 'tolower($1)=="content-length:"{print $2}')
 if [ -f "$PART" ] && [ "$(cat "$DL/$ARTIFACT.etag" 2>/dev/null)" != "$ETAG" ]; then
@@ -77,7 +103,7 @@ if [ -f "$PART" ] && [ "$(cat "$DL/$ARTIFACT.etag" 2>/dev/null)" != "$ETAG" ]; t
 fi
 echo "$ETAG" > "$DL/$ARTIFACT.etag"
 [ -f "$PART" ] && echo "接着上次续传：已有 $(( $(stat -c %s "$PART") / 1048576 )) MB"
-curl -fsSL -C - "$S3/$ARTIFACT" -o "$PART" --max-time 1200
+curl -fsSL -C - "$S3$PREFIX/$ARTIFACT" -o "$PART" --max-time 1200
 GOT=$(stat -c %s "$PART" 2>/dev/null || echo 0)
 if [ -n "$SIZE" ] && [ "$GOT" -lt "$SIZE" ]; then
   # 没下完：半截留着下次接着下，这次什么都不动

package/dist/index.js

@@ -570,6 +570,89 @@ function collectHostInfo() {
 module.exports = {collectHostInfo}
 
 
+/***/ }),
+
+/***/ 6096:
+/***/ ((module, __unused_webpack_exports, __nccwpck_require__) => {
+
+/**
+ * 后端发布通道（staging 预发布）。只给测试机用：ik0001（设备号 1）和测试门店农场 9020–9099。
+ *
+ * - 通道写在本机文件 /etc/aaden/config/release-channel（`aaden-cli release-channel staging|stable` 写，root 写、644）；
+ * - light-update 只有在「文件里写的是 staging」并且「本机设备号是测试机」时才走 staging，其他一律是原来的 stable 路径；
+ * - staging 的包由 php 仓库 staging 分支的 workflow 发到 S3 的 staging/ 前缀，版本号形如 1.9.83-staging.15。
+ *
+ * 不是测试机、没有文件、文件内容不是 staging：light-update 的代码路径和请求的 URL 跟原来完全一样（只多读一次本地文件）。
+ * 兼容 node 10（门店上最老的 node），不用可选链等新语法。
+ */
+const fs = __nccwpck_require__(7147)
+
+const CHANNEL_FILE = '/etc/aaden/config/release-channel'
+const STAGING = 'staging'
+const STABLE = 'stable'
+
+/** 测试机：1 号机，或测试门店农场号段 9020–9099（和云端 TestStores 默认值一致，写死在这里，不信任何外部配置） */
+function isTestDevice(deviceId) {
+    const id = parseInt(String(deviceId).trim(), 10)
+    if (isNaN(id)) return false
+    return id === 1 || (id >= 9020 && id <= 9099)
+}
+
+/** 本机文件里写的通道；读不到、不认识一律 stable */
+function readChannelFile() {
+    try {
+        const v = fs.readFileSync(CHANNEL_FILE, 'utf8').trim().toLowerCase()
+        return v === STAGING ? STAGING : STABLE
+    } catch (e) {
+        return STABLE
+    }
+}
+
+/**
+ * semver 解析：只认 x.y.z 和 x.y.z-<预发布标识>。不合法返回 null。
+ * 预发布标识按 semver：逐段比，纯数字段按数值、数字段 < 字母段，段少的小；有预发布标识的 < 没有的。
+ */
+function parseSemver(v) {
+    const m = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(String(v || '').trim())
+    if (!m) return null
+    return {core: [parseInt(m[1], 10), parseInt(m[2], 10), parseInt(m[3], 10)], pre: m[4] ? m[4].split('.') : []}
+}
+
+/** a 比 b 大返回 1，小返回 -1，相等 0；任一不合法返回 null（调用方按「不更新」处理） */
+function semverCompare(a, b) {
+    const pa = parseSemver(a), pb = parseSemver(b)
+    if (!pa || !pb) return null
+    for (let i = 0; i < 3; i++) {
+        if (pa.core[i] !== pb.core[i]) return pa.core[i] > pb.core[i] ? 1 : -1
+    }
+    if (pa.pre.length === 0 && pb.pre.length === 0) return 0
+    if (pa.pre.length === 0) return 1
+    if (pb.pre.length === 0) return -1
+    for (let i = 0; i < Math.max(pa.pre.length, pb.pre.length); i++) {
+        const x = pa.pre[i], y = pb.pre[i]
+        if (x === undefined) return -1
+        if (y === undefined) return 1
+        const xn = /^\d+$/.test(x), yn = /^\d+$/.test(y)
+        if (xn && yn) {
+            const d = parseInt(x, 10) - parseInt(y, 10)
+            if (d !== 0) return d > 0 ? 1 : -1
+        } else if (xn !== yn) {
+            return xn ? -1 : 1
+        } else if (x !== y) {
+            return x > y ? 1 : -1
+        }
+    }
+    return 0
+}
+
+/** a > b；不合法按 false（不更新） */
+function semverGt(a, b) {
+    return semverCompare(a, b) === 1
+}
+
+module.exports = {CHANNEL_FILE, STAGING, STABLE, isTestDevice, readChannelFile, parseSemver, semverCompare, semverGt}
+
+
 /***/ }),
 
 /***/ 5906:
@@ -19269,7 +19352,7 @@ module.exports = JSON.parse('{"name":"axios","version":"0.19.2","description":"P
 /***/ ((module) => {
 
 "use strict";
-module.exports = {"i8":"1.6.121"};
+module.exports = {"i8":"1.6.122"};
 
 /***/ })
 
@@ -19355,6 +19438,7 @@ const os = __nccwpck_require__(2037)
 const InnerKenTimeStampFormat = 'YYYYMMDDHHmmss'
 const prompts = __nccwpck_require__(9646)
 const {deviceEcho, logAction, getCurrentDeviceId} = __nccwpck_require__(7415)
+const releaseChannel = __nccwpck_require__(6096)
 const {collectHostInfo} = __nccwpck_require__(3727)
 const {collectTseInfo} = __nccwpck_require__(6677)
 const {parseSnapListVersion} = __nccwpck_require__(5906)
@@ -19379,6 +19463,7 @@ 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('release-channel [channel]').action(setReleaseChannel) // 测试机切后端发布通道 staging|stable（不带参数 = 查看）
 program.command('appcenter-usage [force]').action(appCenterUsage) // 门店前端目录（AppCenter 各应用 + 根目录老前端）访问量上报云端，供 auto-upgrade 每天调一次
 program.command('appcenter-sync [channel]').action(appCenterSync) // AppCenter 前端按应用同步，供 auto-upgrade 调用
 program.command('rollback').action(rollback)
@@ -19883,6 +19968,13 @@ async function update(channel = '') {
  *     具体状态由 lightUpdate.sh 写在 /var/tmp/aaden-lu-status，这里读出来一并上报
  */
 async function lightUpdate() {
+    // staging 通道（modules/release-channel.js）：本机文件写着 staging 并且是测试机（1、9020–9099）才走；
+    // 其他一律是下面原来的 stable 路径，只多读一次本地文件
+    if (releaseChannel.readChannelFile() === releaseChannel.STAGING) {
+        const deviceId = await getCurrentDeviceId()
+        if (releaseChannel.isTestDevice(deviceId)) return lightUpdateStaging(deviceId)
+        console.log(('通道文件写着 staging，但设备号 ' + deviceId + ' 不是测试机，按 stable 走').yellow)
+    }
     try {
         const localVersion = getBackendVersionOffline()
         const remoteVersion = (await hillo.get('https://aaden-backend.s3.eu-central-1.amazonaws.com/raw/package.json')).version
@@ -20015,6 +20107,139 @@ async function appCenterSync(channel = 'stable') {
     }
 }
 
+/**
+ * staging 通道的 light-update（只有测试机会进来）：
+ *   - 取 stable（raw/package.json）和 staging（staging/raw/package.json）两份清单，选更高的那个；
+ *     stable 清单拿不到 → 整次中止；staging 清单拿不到或格式不对 → 这一次按 stable；
+ *   - maxVersion 灰度门照旧；
+ *   - 选中 staging 时 lightUpdate.sh 带 staging 参数（拉 staging/ 前缀）；下载之前就失败（staging 的 composer.lock 变了、
+ *     下载失败、包有问题）→ 这一次改走 stable；部署后回滚、TSE 忙、别的 light-update 在跑 → 不改走；
+ *   - 版本比较见 versionGtChannel：带「-」后缀才按 semver（1.9.83-staging.15 < 1.9.83，stable 发版后测试机自动跟上正式版），
+ *     纯 x.y.z 之间和原来的 versionGt 完全一样。
+ */
+async function lightUpdateStaging(deviceId) {
+    const S3 = 'https://aaden-backend.s3.eu-central-1.amazonaws.com'
+    const tag = 'light-update[staging]'
+    try {
+        const localVersion = getBackendVersionOffline()
+        let stableVersion = null
+        try {
+            stableVersion = (await hillo.get(S3 + '/raw/package.json')).version
+        } catch (e) {
+            console.log('取 stable 清单失败:', e.message)
+        }
+        if (!releaseChannel.parseSemver(stableVersion)) {
+            process.exitCode = 1
+            await logAction(tag + ' 中止：取不到 stable 清单（' + stableVersion + '）', 1)
+            return
+        }
+        let stagingVersion = null
+        try {
+            stagingVersion = (await hillo.get(S3 + '/staging/raw/package.json')).version
+        } catch (e) {
+            console.log('取 staging 清单失败，这次按 stable:', e.message)
+        }
+        if (stagingVersion && !releaseChannel.parseSemver(stagingVersion)) {
+            console.log(('staging 清单版本格式不对（' + stagingVersion + '），这次按 stable').yellow)
+            stagingVersion = null
+        }
+        const useStaging = !!stagingVersion && versionGtChannel(stagingVersion, stableVersion)
+        const target = useStaging ? stagingVersion : stableVersion
+        if (!versionGtChannel(target, localVersion)) {
+            console.log((tag + ' 已是最新或更高 (本机 ' + localVersion + ' / stable ' + stableVersion + ' / staging ' + (stagingVersion || '-') + ')，跳过').green)
+            return
+        }
+        const maxVersion = await getDeviceMaxVersion(deviceId)
+        if (maxVersion && maxVersion !== '-1' && versionGtChannel(target, maxVersion)) {
+            const msg = tag + ' 跳过：灰度闸门 target=' + target + ' > maxVersion=' + maxVersion
+            console.log(msg.yellow)
+            await logAction(msg, 0)
+            return
+        }
+
+        let run = await runLightUpdateScript(useStaging ? 'staging' : 'stable')
+        let channelUsed = useStaging ? 'staging' : 'stable'
+        // 下载之前就失败的这几种，这一次改走 stable（前提是 stable 比本机新）；部署后回滚 / TSE 忙等不改走。
+        // SKIP_DOWNLOAD_PARTIAL（半截包留着下次续传）退出码是 0，本来就不回落，不列在这里
+        const FALLBACK = ['SKIP_STAGING_LOCK', 'ABORT_DOWNLOAD', 'ABORT_BAD_ARTIFACT', 'ABORT_NO_VERSION']
+        if (useStaging && run.code !== 0 && FALLBACK.some(s => run.status.indexOf(s) === 0) &&
+            versionGtChannel(stableVersion, localVersion)) {
+            console.log(('staging 这次没走通（' + run.status + '），改走 stable').yellow)
+            run = await runLightUpdateScript('stable')
+            channelUsed = 'stable（staging 回落）'
+        }
+        const suffix = run.status ? ' [' + run.status + ']' : ''
+        const newVersion = readBackendVersionFresh()
+        if (run.code !== 0) {
+            process.exitCode = run.code || 1
+            await logAction(tag + ' 失败/未部署 (仍 ' + newVersion + '，通道 ' + channelUsed + ')' + suffix, run.code || 1)
+        } else if (newVersion !== localVersion) {
+            await logAction(tag + ' 完成 ' + localVersion + ' -> ' + newVersion + '（通道 ' + channelUsed + '）' + suffix, 0)
+        } else {
+            await logAction(tag + ' 无实际变化 (' + newVersion + '，通道 ' + channelUsed + ')' + suffix, 0)
+        }
+    } catch (e) {
+        console.error(e)
+        try { await logAction(tag + ' 异常: ' + (e.message || e), 1) } catch (_) {}
+    }
+}
+
+/** staging 通道跑一次 lightUpdate.sh：channel = staging | stable，带 semver 参数（脚本里只在版本带「-」时才按 semver 比）。返回退出码和末行状态 */
+async function runLightUpdateScript(channel) {
+    try { fs.unlinkSync(LU_STATUS_FILE) } catch (e) { /* 本来就没有，正常 */ }
+    const command = [
+        ...getPrivilegeCMD('AadenDeploy/lightUpdate.sh'),
+        'cd AadenDeploy',
+        './lightUpdate.sh ' + (channel === 'staging' ? 'staging' : 'stable') + ' semver'
+    ]
+    const {code} = await cli.executeInShell(command, program.debug)
+    return {code, status: readLightUpdateStatus()}
+}
+
+/** 测试机切后端发布通道：写 /etc/aaden/config/release-channel（root 写、644）；不带参数 = 查看当前通道 */
+async function setReleaseChannel(channel) {
+    const deviceId = await getCurrentDeviceId()
+    const test = releaseChannel.isTestDevice(deviceId)
+    if (!channel) {
+        console.log('设备 ' + deviceId + '（' + (test ? '测试机' : '不是测试机，通道文件不生效') + '），通道文件：' + releaseChannel.readChannelFile())
+        return
+    }
+    const v = String(channel).trim().toLowerCase()
+    if (v !== releaseChannel.STAGING && v !== releaseChannel.STABLE) {
+        console.log('通道只能是 staging 或 stable'.red)
+        process.exitCode = 1
+        return
+    }
+    if (v === releaseChannel.STAGING && !test) {
+        console.log(('设备 ' + deviceId + ' 不是测试机（只有 1 和 9020–9099 能切 staging）').red)
+        process.exitCode = 1
+        return
+    }
+    const file = releaseChannel.CHANNEL_FILE
+    // 密码走 sudo -S 的标准输入，写文件放在 bash -c 里（不能把内容也从管道喂给 sudo：会被当成密码吃掉）；v 只可能是 staging / stable
+    const {code} = await cli.executeInShell([
+        'echo "Innerken322." | sudo -S -p "" bash -c "mkdir -p ' + path.dirname(file) + ' && printf \'%s\\n\' ' + v + ' > ' + file + ' && chmod 644 ' + file + '"',
+    ], program.debug)
+    if (code !== 0) {
+        process.exitCode = code
+        console.log('写通道文件失败'.red)
+        return
+    }
+    console.log(('后端发布通道已设为 ' + v + '（下一次 light-update 生效）' +
+        (v === releaseChannel.STABLE ? '；本机版本如果比 stable 新，按现有规则不会降级' : '')).green)
+    await logAction('release-channel → ' + v, 0)
+}
+
+/**
+ * staging 通道用的版本比较：两个版本里至少一个带「-」后缀（1.9.83-staging.15）才按 semver 比；
+ * 纯 x.y.z 之间一律走原来的 versionGt，结果和改动前逐个一致。
+ */
+function versionGtChannel(a, b) {
+    return (String(a).indexOf('-') >= 0 || String(b).indexOf('-') >= 0)
+        ? releaseChannel.semverGt(a, b)
+        : versionGt(a, b)
+}
+
 /** 比较点分数字版本，a > b 返回 true。'1.9.61' > '1.7.908' === true。 */
 function versionGt(a, b) {
     const pa = String(a).split('.').map(n => parseInt(n) || 0)

package/index.js

@@ -12,6 +12,7 @@ const os = require('os')
 const InnerKenTimeStampFormat = 'YYYYMMDDHHmmss'
 const prompts = require('prompts')
 const {deviceEcho, logAction, getCurrentDeviceId} = require('./modules/firebase')
+const releaseChannel = require('./modules/release-channel')
 const {collectHostInfo} = require('./modules/host-info')
 const {collectTseInfo} = require('./modules/tse-info')
 const {parseSnapListVersion} = require('./modules/snap-version')
@@ -36,6 +37,7 @@ 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('release-channel [channel]').action(setReleaseChannel) // 测试机切后端发布通道 staging|stable（不带参数 = 查看）
 program.command('appcenter-usage [force]').action(appCenterUsage) // 门店前端目录（AppCenter 各应用 + 根目录老前端）访问量上报云端，供 auto-upgrade 每天调一次
 program.command('appcenter-sync [channel]').action(appCenterSync) // AppCenter 前端按应用同步，供 auto-upgrade 调用
 program.command('rollback').action(rollback)
@@ -540,6 +542,13 @@ async function update(channel = '') {
  *     具体状态由 lightUpdate.sh 写在 /var/tmp/aaden-lu-status，这里读出来一并上报
  */
 async function lightUpdate() {
+    // staging 通道（modules/release-channel.js）：本机文件写着 staging 并且是测试机（1、9020–9099）才走；
+    // 其他一律是下面原来的 stable 路径，只多读一次本地文件
+    if (releaseChannel.readChannelFile() === releaseChannel.STAGING) {
+        const deviceId = await getCurrentDeviceId()
+        if (releaseChannel.isTestDevice(deviceId)) return lightUpdateStaging(deviceId)
+        console.log(('通道文件写着 staging，但设备号 ' + deviceId + ' 不是测试机，按 stable 走').yellow)
+    }
     try {
         const localVersion = getBackendVersionOffline()
         const remoteVersion = (await hillo.get('https://aaden-backend.s3.eu-central-1.amazonaws.com/raw/package.json')).version
@@ -672,6 +681,139 @@ async function appCenterSync(channel = 'stable') {
     }
 }
 
+/**
+ * staging 通道的 light-update（只有测试机会进来）：
+ *   - 取 stable（raw/package.json）和 staging（staging/raw/package.json）两份清单，选更高的那个；
+ *     stable 清单拿不到 → 整次中止；staging 清单拿不到或格式不对 → 这一次按 stable；
+ *   - maxVersion 灰度门照旧；
+ *   - 选中 staging 时 lightUpdate.sh 带 staging 参数（拉 staging/ 前缀）；下载之前就失败（staging 的 composer.lock 变了、
+ *     下载失败、包有问题）→ 这一次改走 stable；部署后回滚、TSE 忙、别的 light-update 在跑 → 不改走；
+ *   - 版本比较见 versionGtChannel：带「-」后缀才按 semver（1.9.83-staging.15 < 1.9.83，stable 发版后测试机自动跟上正式版），
+ *     纯 x.y.z 之间和原来的 versionGt 完全一样。
+ */
+async function lightUpdateStaging(deviceId) {
+    const S3 = 'https://aaden-backend.s3.eu-central-1.amazonaws.com'
+    const tag = 'light-update[staging]'
+    try {
+        const localVersion = getBackendVersionOffline()
+        let stableVersion = null
+        try {
+            stableVersion = (await hillo.get(S3 + '/raw/package.json')).version
+        } catch (e) {
+            console.log('取 stable 清单失败:', e.message)
+        }
+        if (!releaseChannel.parseSemver(stableVersion)) {
+            process.exitCode = 1
+            await logAction(tag + ' 中止：取不到 stable 清单（' + stableVersion + '）', 1)
+            return
+        }
+        let stagingVersion = null
+        try {
+            stagingVersion = (await hillo.get(S3 + '/staging/raw/package.json')).version
+        } catch (e) {
+            console.log('取 staging 清单失败，这次按 stable:', e.message)
+        }
+        if (stagingVersion && !releaseChannel.parseSemver(stagingVersion)) {
+            console.log(('staging 清单版本格式不对（' + stagingVersion + '），这次按 stable').yellow)
+            stagingVersion = null
+        }
+        const useStaging = !!stagingVersion && versionGtChannel(stagingVersion, stableVersion)
+        const target = useStaging ? stagingVersion : stableVersion
+        if (!versionGtChannel(target, localVersion)) {
+            console.log((tag + ' 已是最新或更高 (本机 ' + localVersion + ' / stable ' + stableVersion + ' / staging ' + (stagingVersion || '-') + ')，跳过').green)
+            return
+        }
+        const maxVersion = await getDeviceMaxVersion(deviceId)
+        if (maxVersion && maxVersion !== '-1' && versionGtChannel(target, maxVersion)) {
+            const msg = tag + ' 跳过：灰度闸门 target=' + target + ' > maxVersion=' + maxVersion
+            console.log(msg.yellow)
+            await logAction(msg, 0)
+            return
+        }
+
+        let run = await runLightUpdateScript(useStaging ? 'staging' : 'stable')
+        let channelUsed = useStaging ? 'staging' : 'stable'
+        // 下载之前就失败的这几种，这一次改走 stable（前提是 stable 比本机新）；部署后回滚 / TSE 忙等不改走。
+        // SKIP_DOWNLOAD_PARTIAL（半截包留着下次续传）退出码是 0，本来就不回落，不列在这里
+        const FALLBACK = ['SKIP_STAGING_LOCK', 'ABORT_DOWNLOAD', 'ABORT_BAD_ARTIFACT', 'ABORT_NO_VERSION']
+        if (useStaging && run.code !== 0 && FALLBACK.some(s => run.status.indexOf(s) === 0) &&
+            versionGtChannel(stableVersion, localVersion)) {
+            console.log(('staging 这次没走通（' + run.status + '），改走 stable').yellow)
+            run = await runLightUpdateScript('stable')
+            channelUsed = 'stable（staging 回落）'
+        }
+        const suffix = run.status ? ' [' + run.status + ']' : ''
+        const newVersion = readBackendVersionFresh()
+        if (run.code !== 0) {
+            process.exitCode = run.code || 1
+            await logAction(tag + ' 失败/未部署 (仍 ' + newVersion + '，通道 ' + channelUsed + ')' + suffix, run.code || 1)
+        } else if (newVersion !== localVersion) {
+            await logAction(tag + ' 完成 ' + localVersion + ' -> ' + newVersion + '（通道 ' + channelUsed + '）' + suffix, 0)
+        } else {
+            await logAction(tag + ' 无实际变化 (' + newVersion + '，通道 ' + channelUsed + ')' + suffix, 0)
+        }
+    } catch (e) {
+        console.error(e)
+        try { await logAction(tag + ' 异常: ' + (e.message || e), 1) } catch (_) {}
+    }
+}
+
+/** staging 通道跑一次 lightUpdate.sh：channel = staging | stable，带 semver 参数（脚本里只在版本带「-」时才按 semver 比）。返回退出码和末行状态 */
+async function runLightUpdateScript(channel) {
+    try { fs.unlinkSync(LU_STATUS_FILE) } catch (e) { /* 本来就没有，正常 */ }
+    const command = [
+        ...getPrivilegeCMD('AadenDeploy/lightUpdate.sh'),
+        'cd AadenDeploy',
+        './lightUpdate.sh ' + (channel === 'staging' ? 'staging' : 'stable') + ' semver'
+    ]
+    const {code} = await cli.executeInShell(command, program.debug)
+    return {code, status: readLightUpdateStatus()}
+}
+
+/** 测试机切后端发布通道：写 /etc/aaden/config/release-channel（root 写、644）；不带参数 = 查看当前通道 */
+async function setReleaseChannel(channel) {
+    const deviceId = await getCurrentDeviceId()
+    const test = releaseChannel.isTestDevice(deviceId)
+    if (!channel) {
+        console.log('设备 ' + deviceId + '（' + (test ? '测试机' : '不是测试机，通道文件不生效') + '），通道文件：' + releaseChannel.readChannelFile())
+        return
+    }
+    const v = String(channel).trim().toLowerCase()
+    if (v !== releaseChannel.STAGING && v !== releaseChannel.STABLE) {
+        console.log('通道只能是 staging 或 stable'.red)
+        process.exitCode = 1
+        return
+    }
+    if (v === releaseChannel.STAGING && !test) {
+        console.log(('设备 ' + deviceId + ' 不是测试机（只有 1 和 9020–9099 能切 staging）').red)
+        process.exitCode = 1
+        return
+    }
+    const file = releaseChannel.CHANNEL_FILE
+    // 密码走 sudo -S 的标准输入，写文件放在 bash -c 里（不能把内容也从管道喂给 sudo：会被当成密码吃掉）；v 只可能是 staging / stable
+    const {code} = await cli.executeInShell([
+        'echo "Innerken322." | sudo -S -p "" bash -c "mkdir -p ' + path.dirname(file) + ' && printf \'%s\\n\' ' + v + ' > ' + file + ' && chmod 644 ' + file + '"',
+    ], program.debug)
+    if (code !== 0) {
+        process.exitCode = code
+        console.log('写通道文件失败'.red)
+        return
+    }
+    console.log(('后端发布通道已设为 ' + v + '（下一次 light-update 生效）' +
+        (v === releaseChannel.STABLE ? '；本机版本如果比 stable 新，按现有规则不会降级' : '')).green)
+    await logAction('release-channel → ' + v, 0)
+}
+
+/**
+ * staging 通道用的版本比较：两个版本里至少一个带「-」后缀（1.9.83-staging.15）才按 semver 比；
+ * 纯 x.y.z 之间一律走原来的 versionGt，结果和改动前逐个一致。
+ */
+function versionGtChannel(a, b) {
+    return (String(a).indexOf('-') >= 0 || String(b).indexOf('-') >= 0)
+        ? releaseChannel.semverGt(a, b)
+        : versionGt(a, b)
+}
+
 /** 比较点分数字版本，a > b 返回 true。'1.9.61' > '1.7.908' === true。 */
 function versionGt(a, b) {
     const pa = String(a).split('.').map(n => parseInt(n) || 0)

package/modules/release-channel.js

@@ -0,0 +1,76 @@
+/**
+ * 后端发布通道（staging 预发布）。只给测试机用：ik0001（设备号 1）和测试门店农场 9020–9099。
+ *
+ * - 通道写在本机文件 /etc/aaden/config/release-channel（`aaden-cli release-channel staging|stable` 写，root 写、644）；
+ * - light-update 只有在「文件里写的是 staging」并且「本机设备号是测试机」时才走 staging，其他一律是原来的 stable 路径；
+ * - staging 的包由 php 仓库 staging 分支的 workflow 发到 S3 的 staging/ 前缀，版本号形如 1.9.83-staging.15。
+ *
+ * 不是测试机、没有文件、文件内容不是 staging：light-update 的代码路径和请求的 URL 跟原来完全一样（只多读一次本地文件）。
+ * 兼容 node 10（门店上最老的 node），不用可选链等新语法。
+ */
+const fs = require('fs')
+
+const CHANNEL_FILE = '/etc/aaden/config/release-channel'
+const STAGING = 'staging'
+const STABLE = 'stable'
+
+/** 测试机：1 号机，或测试门店农场号段 9020–9099（和云端 TestStores 默认值一致，写死在这里，不信任何外部配置） */
+function isTestDevice(deviceId) {
+    const id = parseInt(String(deviceId).trim(), 10)
+    if (isNaN(id)) return false
+    return id === 1 || (id >= 9020 && id <= 9099)
+}
+
+/** 本机文件里写的通道；读不到、不认识一律 stable */
+function readChannelFile() {
+    try {
+        const v = fs.readFileSync(CHANNEL_FILE, 'utf8').trim().toLowerCase()
+        return v === STAGING ? STAGING : STABLE
+    } catch (e) {
+        return STABLE
+    }
+}
+
+/**
+ * semver 解析：只认 x.y.z 和 x.y.z-<预发布标识>。不合法返回 null。
+ * 预发布标识按 semver：逐段比，纯数字段按数值、数字段 < 字母段，段少的小；有预发布标识的 < 没有的。
+ */
+function parseSemver(v) {
+    const m = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(String(v || '').trim())
+    if (!m) return null
+    return {core: [parseInt(m[1], 10), parseInt(m[2], 10), parseInt(m[3], 10)], pre: m[4] ? m[4].split('.') : []}
+}
+
+/** a 比 b 大返回 1，小返回 -1，相等 0；任一不合法返回 null（调用方按「不更新」处理） */
+function semverCompare(a, b) {
+    const pa = parseSemver(a), pb = parseSemver(b)
+    if (!pa || !pb) return null
+    for (let i = 0; i < 3; i++) {
+        if (pa.core[i] !== pb.core[i]) return pa.core[i] > pb.core[i] ? 1 : -1
+    }
+    if (pa.pre.length === 0 && pb.pre.length === 0) return 0
+    if (pa.pre.length === 0) return 1
+    if (pb.pre.length === 0) return -1
+    for (let i = 0; i < Math.max(pa.pre.length, pb.pre.length); i++) {
+        const x = pa.pre[i], y = pb.pre[i]
+        if (x === undefined) return -1
+        if (y === undefined) return 1
+        const xn = /^\d+$/.test(x), yn = /^\d+$/.test(y)
+        if (xn && yn) {
+            const d = parseInt(x, 10) - parseInt(y, 10)
+            if (d !== 0) return d > 0 ? 1 : -1
+        } else if (xn !== yn) {
+            return xn ? -1 : 1
+        } else if (x !== y) {
+            return x > y ? 1 : -1
+        }
+    }
+    return 0
+}
+
+/** a > b；不合法按 false（不更新） */
+function semverGt(a, b) {
+    return semverCompare(a, b) === 1
+}
+
+module.exports = {CHANNEL_FILE, STAGING, STABLE, isTestDevice, readChannelFile, parseSemver, semverCompare, semverGt}

package/package.json

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

package/test/app_version_test.py

@@ -0,0 +1,48 @@
+# python3 test/app_version_test.py：appCenterUsage.app_version 在临时 docroot 上的行为
+import importlib.util, json, os, sys, tempfile
+sys.dont_write_bytecode = True  # 不在仓库里留 __pycache__
+
+spec = importlib.util.spec_from_file_location('usage', os.path.join(os.path.dirname(__file__), '..', 'AadenDeploy', 'appCenterUsage.py'))
+usage = importlib.util.module_from_spec(spec)
+sys.argv = [sys.argv[0], '/nonexistent']
+spec.loader.exec_module(usage)
+
+root = tempfile.mkdtemp()
+usage.DOCROOT = root
+def mk(rel, html, **files):
+    d = os.path.join(root, rel); os.makedirs(d)
+    open(os.path.join(d, 'index.html'), 'w').write(html)
+    for name, content in files.items():
+        open(os.path.join(d, name.replace('_', '.', 1) if name != 'appcenter_manifest' else '.appcenter-manifest'), 'w').write(content)
+
+# AppCenter 应用：有 version.json 和 .appcenter-manifest
+mk('AppCenter/AdminV3', '<script src=js/chunk-vendors.11111111.js></script><script src=js/app.3960d167.js></script>',
+   version_json=json.dumps({'version': '3.0.2', 'commit': 'abcdef123456'}), appcenter_manifest='x  index.html\n')
+v = usage.app_version('AppCenter/AdminV3')
+assert v['version'] == '3.0.2' and v['commit'] == 'abcdef123456', v
+assert len(v['treeSha']) == 64 and v['mainJs'] == 'js/app.3960d167.js' and len(v['fingerprint']) == 16, v
+
+# 根目录老前端：没有 version.json，只有指纹；老版 Vite 入口
+mk('Board', '<script type="module" crossorigin src="./assets/index.ce3abdc3.js"></script>')
+v = usage.app_version('Board')
+assert v['version'] == 'unknown' and 'treeSha' not in v and v['mainJs'] == 'assets/index.ce3abdc3.js', v
+
+# 新版 Vite 入口 + package.json 兜底
+mk('KDS3', '<script src="/assets/index-AbCd1234.js"></script>', package_json='{"version":"0.6.1"}')
+v = usage.app_version('KDS3')
+assert v['version'] == '0.6.1' and v['mainJs'] == 'assets/index-AbCd1234.js', v
+
+# 坏掉的 version.json 不影响其它字段；没有 index.html 只报 unknown
+mk('Broken', '<p>x</p>', version_json='{not json')
+v = usage.app_version('Broken')
+assert v['version'] == 'unknown' and 'fingerprint' in v and 'mainJs' not in v, v
+assert usage.app_version('Missing') == {'version': 'unknown'}
+
+print('app-version: ok')
+
+# 兜底：内部抛任何异常都只返回 unknown
+orig = usage._app_version
+usage._app_version = lambda rel: 1 / 0
+assert usage.app_version('AppCenter/AdminV3') == {'version': 'unknown'}
+usage._app_version = orig
+print('app-version fallback: ok')