aaden-cli 1.6.101 → 1.6.103-rc.0

package/.github/workflows/publish.yml

@@ -0,0 +1,97 @@
+name: Publish to npm
+
+# 推 tag 后发布到 npm，走 npm Trusted Publishing（OIDC）：不需要 npm token，也不需要 OTP。
+# npmjs.com 上 aaden-cli 的 Trusted Publisher 必须登记这个文件名（publish.yml）并允许 npm publish，改名要同步改那边。
+#
+# - `x.y.z`（`npm run update` 打的）→ npm `latest`。
+#   ⚠️ 全网约 650 台设备每天 04:55 `npm install aaden-cli -g` 装 latest：发出去就等于全网发布。
+# - `x.y.z-任意后缀`（如 1.6.103-rc.0，任何分支都可以打）→ npm `next`，设备不会自动装。
+#   用来灰度：在某台设备上 `sudo npm i -g aaden-cli@next` 先试；那台设备第二天 04:55 会自己回到 latest。
+on:
+  push:
+    tags:
+      - '[0-9]+.[0-9]+.[0-9]+'
+      - '[0-9]+.[0-9]+.[0-9]+-*'
+
+permissions:
+  contents: write # 发布成功后建 GitHub Release
+  id-token: write # Trusted Publishing 用 OIDC 换发布权限
+
+concurrency:
+  group: npm-publish
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: '24'
+          registry-url: 'https://registry.npmjs.org'
+          package-manager-cache: false
+
+      - name: 决定发布渠道
+        id: channel
+        run: |
+          if [[ "$GITHUB_REF_NAME" == *-* ]]; then
+            echo "dist_tag=next" >> "$GITHUB_OUTPUT"
+          else
+            echo "dist_tag=latest" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: 校验 tag（latest）
+        if: steps.channel.outputs.dist_tag == 'latest'
+        run: |
+          VERSION=$(node -p "require('./package.json').version")
+          if [ "$GITHUB_REF_NAME" != "$VERSION" ]; then
+            echo "::error::tag $GITHUB_REF_NAME 和 package.json 的版本 $VERSION 不一致"
+            exit 1
+          fi
+          # 只发 master 上的提交：从别的分支推个 tag 不能直接发到全网
+          if ! git merge-base --is-ancestor "$GITHUB_SHA" origin/master; then
+            echo "::error::tag $GITHUB_REF_NAME 指向的提交不在 master 上"
+            exit 1
+          fi
+
+      # 预发布的版本号以 tag 为准，不用为了灰度去提交一次版本号
+      - name: 写入预发布版本号（next）
+        if: steps.channel.outputs.dist_tag == 'next'
+        run: npm version "$GITHUB_REF_NAME" --no-git-tag-version
+
+      - run: npm ci
+
+      - name: 打包
+        run: npx ncc build index.js -o dist -C
+
+      - name: 冒烟检查
+        run: |
+          OUT=$(node dist/index.js --version | tail -n 1)
+          if [ "$OUT" != "$GITHUB_REF_NAME" ]; then
+            echo "::error::dist/index.js --version 输出「$OUT」，期望 $GITHUB_REF_NAME"
+            exit 1
+          fi
+          npm pack --dry-run 2>&1 | grep -q 'dist/index.js' || {
+            echo "::error::npm 包里没有 dist/index.js"
+            exit 1
+          }
+
+      # 私有仓库不支持 provenance，显式关掉免得 publish 失败
+      - name: 发布到 npm
+        env:
+          NPM_CONFIG_PROVENANCE: 'false'
+        run: npm publish --tag "${{ steps.channel.outputs.dist_tag }}"
+
+      - name: GitHub Release
+        if: steps.channel.outputs.dist_tag == 'latest'
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release create "$GITHUB_REF_NAME" \
+            --title "aaden-cli: release v$GITHUB_REF_NAME" \
+            --generate-notes \
+            --verify-tag

package/AadenDeploy/appCenterSync.sh

@@ -0,0 +1,166 @@
+#!/bin/bash
+# AppCenter 前端同步（aaden-cli appcenter-sync 的执行体）。产物由 aaden-php-backend scripts/publish-appcenter-artifact.sh 发布：
+#   <base>/<channel>/manifest.json + <base>/blobs/<App>-<sha>.zip
+#
+# light-update 只发 PHP/，AppCenter 以前只能跟 465MB 的 latest.zip 走；这里单独按应用同步。
+#   - 灰度门：manifest 的 rollout = {"devices":[...], "percent":N}，本机在名单里或 deviceId%100 < N 才动；没有 rollout = 全量
+#   - ensureNoCache：manifest 打开时先确保 AppCenter 的 index.html 带 no-cache（ensureAppCenterNoCache.sh）
+#   - manifest 门：本机 .appcenter-manifest 的 sha256 == manifest 的 treeSha256 且 `sha256sum -c` 通过 → 什么都不做，
+#     每天只花一次几 KB 的请求。被 latest.zip 全量覆盖过、文件对不上 → 校验失败 → 重新铺一遍（自愈）
+#   - 先下载并校验（zipSha256 + 解压后 sha256sum -c），确认无误才动线上目录
+#   - 保留上一代：旧目录里「旧 index.html 用得到、新版没有」的文件拷进新目录（appcenterRefs.py），
+#     正开着的旧页面懒加载 chunk 时不会 404；更早手工覆盖堆下来的历史文件就此清掉
+#   - 整目录 rename 替换，旧目录留一份在 BACKUP；健康检查失败就换回去
+#   - 不碰 PHP、不碰数据库，所以不需要 TSE 门
+#
+# 用法: appCenterSync.sh [channel]
+#   APPCENTER_BASE       产物根地址，默认 S3；测试可用 file:///var/tmp/...（curl 都支持）
+#   APPCENTER_APPS       只同步这些应用（空格分隔）；不传 = manifest 里列出的全部应用，发哪些由发布端决定
+#   APPCENTER_DEVICE_ID  本机 deviceId（CLI 会传）；不传就问本机 PHP
+#   APPCENTER_RESULT     结果行另存的文件（CLI 会传）
+# 结果行（同时写进 $RESULT 给 CLI 上报）：APP_OK <App> <sha12> | APP_UP_TO_DATE <App> | APP_SKIP <App> <原因> |
+#   APP_ROLLED_BACK <App> | APP_ABORT_* <App> | NOCACHE_* | SKIP_ROLLOUT | SKIP_DEPS | SKIP_LOCKED | ABORT_*
+# 退出码：0=全部成功、无需更新或不在灰度内；1=有失败（失败的已回滚或未动线上目录）
+set -uo pipefail
+BASE="${APPCENTER_BASE:-https://aaden-backend.s3.eu-central-1.amazonaws.com/appcenter}"
+CHANNEL="${1:-stable}"
+WEB=/var/www/html/AppCenter
+STAGE=/var/tmp/aaden-appcenter-stage
+BACKUP=/var/lib/aaden-appcenter-backup
+LOCK=/var/tmp/aaden-appcenter.lock
+RESULT="${APPCENTER_RESULT:-/var/tmp/aaden-appcenter-result.txt}"   # CLI 传一个自己建的临时文件，读回来上报
+HERE="$(cd "$(dirname "$0")" && pwd)"
+PW='Innerken322.'
+sudoS(){ echo "$PW" | sudo -S bash -c "$*"; }
+res(){ echo "$*"; echo "$*" >> "$RESULT"; }
+
+: > "$RESULT" 2>/dev/null || { RESULT=$(mktemp); : > "$RESULT"; }
+
+MISSING=""
+for c in curl python3 unzip sha256sum flock tar cut comm; do command -v "$c" >/dev/null || MISSING="$MISSING $c"; done
+if [ -n "$MISSING" ]; then res "SKIP_DEPS$MISSING"; exit 0; fi
+if ! echo "$PW" | sudo -S true 2>/dev/null; then res "ABORT_SUDO_AUTH"; exit 1; fi
+
+# 同一时间只跑一个（auto-upgrade 与手动触发可能撞上）。只读打开即可 flock，root/aaden 谁先建文件都行
+[ -e "$LOCK" ] || touch "$LOCK"
+exec 9<"$LOCK"
+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(){
+  printf '%s' "$MANIFEST" | python3 -c '
+import json, sys
+m = json.load(sys.stdin)
+if sys.argv[1] == "eligible":
+    r = m.get("rollout")
+    if r is None:
+        print("yes"); sys.exit()
+    try:
+        d = int(sys.argv[2])
+    except ValueError:
+        print("no"); sys.exit()
+    ok = d in [int(x) for x in r.get("devices", [])] or d % 100 < int(r.get("percent", 0))
+    print("yes" if ok else "no"); sys.exit()
+v = m
+for k in sys.argv[1].split("."):
+    v = v.get(k) if isinstance(v, dict) else None
+print("" if v is None else (str(v).lower() if isinstance(v, bool) else v))
+' "$@"
+}
+
+# ---- 灰度门 ----
+DEVICE_ID="${APPCENTER_DEVICE_ID:-}"
+if [ -z "$DEVICE_ID" ] || [ "$DEVICE_ID" = "-1" ]; then
+  DEVICE_ID=$(curl -s --max-time 10 "http://localhost/PHP/AccessLog.php?op=deviceId" \
+    | python3 -c 'import json,sys; print(json.load(sys.stdin).get("content",""))' 2>/dev/null)
+fi
+if [ "$(mf eligible "${DEVICE_ID:-x}")" != "yes" ]; then
+  res "SKIP_ROLLOUT device=${DEVICE_ID:-?}"; exit 0
+fi
+
+FAILED=0
+# ---- index.html no-cache（先于换前端：让之后拿到的 index.html 都不再被启发式缓存）----
+if [ "$(mf ensureNoCache)" = "true" ]; then
+  NC=$(bash "$HERE/ensureAppCenterNoCache.sh"); NC_CODE=$?
+  printf '%s\n' "$NC" | sed '$d'
+  res "$(printf '%s\n' "$NC" | tail -1)"
+  [ "$NC_CODE" = 0 ] || FAILED=1
+fi
+
+# 清单第 67 列起是路径（64 位 hash + 两个空格）
+paths(){ cut -c67- "$1" | LC_ALL=C sort; }
+tree_ok(){ # $1=目录 $2=期望 treeSha256
+  [ -f "$1/.appcenter-manifest" ] \
+    && [ "$(sha256sum < "$1/.appcenter-manifest" | cut -d' ' -f1)" = "$2" ] \
+    && (cd "$1" && sha256sum -c --quiet --strict .appcenter-manifest >/dev/null 2>&1)
+}
+
+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
+  # 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
+  fi
+
+  # ---- manifest 门 ----
+  if tree_ok "$LIVE" "$TREE"; then res "APP_UP_TO_DATE $APP"; return 0; fi
+  echo "$APP: 本机与 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; }
+  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
+  fi
+  # zip 里带的是打包时的旧 mtime；浏览器按 Last-Modified 的年龄启发式缓存，所以改成现在（只改 mtime 不改内容，不影响校验）
+  touch "$NEW/index.html"
+
+  # ---- 保留上一代 ----
+  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; }
+    paths "$NEW/.appcenter-manifest" > "$NEW.new"
+    LC_ALL=C comm -23 "$NEW.old" "$NEW.new" > "$NEW.carry"
+    CARRIED=$(wc -l < "$NEW.carry" | tr -d ' ')
+    # 用 tar 而不是 rsync：老设备不一定装了 rsync；清单里的文件都确实存在（appcenterRefs 只列存在的）
+    [ "$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 个"
+
+  # ---- 替换：两次 rename，中间只有毫秒级空窗 ----
+  sudoS "mkdir -p '$BACKUP' && rm -rf '$BACKUP/$APP' && chown -R www-data:www-data '$NEW'"
+  [ -d "$LIVE" ] && sudoS "mv '$LIVE' '$BACKUP/$APP'"
+  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
+  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
+  fi
+  res "APP_OK $APP ${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
+  if ! [[ "$APP" =~ ^[A-Za-z0-9_-]+$ ]]; then res "APP_SKIP $APP 名字不合法"; continue; fi
+  sync_app "$APP" || FAILED=1
+done
+exit $FAILED

package/AadenDeploy/appCenterUsage.py

@@ -0,0 +1,141 @@
+#!/usr/bin/env python3
+"""门店前端目录的实际访问量（aaden-cli appcenter-usage 的执行体）。只读 Apache access.log，结果 JSON 打到 stdout。
+
+统计两类目录，应用名用 docroot 下的相对路径：
+  - AppCenter 下的应用 → "AppCenter/Admin"、"AppCenter/App" …
+  - docroot 根目录下带 index.html 的前端（老的 /Admin、/App 等）→ "Admin"、"App" …
+一个请求归到某个目录，满足其一即可：
+  - 请求路径在该目录下（页面和静态资源）
+  - Referer 指向该目录（页面里发出的 PHP 接口请求；index.html 被浏览器缓存时只能靠这个看出有人在用）
+来源按 Referer 主机名分：ngrok（远程。经 ik%04d.ngrok 进来的客户端 IP 都是 127.0.0.1，只能看 Referer）、
+local（localhost/127.x，收银机本机）、lan（局域网 IP，平板等）、none（没有 Referer，一般是直接打开页面）。
+只统计真实存在的目录，扫描器乱打的路径不算。
+
+用法: appCenterUsage.py [日志目录，默认 /var/log/apache2]；需要能读 access.log*（root 或 adm 组）。
+"""
+import glob
+import gzip
+import json
+import os
+import re
+import sys
+from collections import defaultdict
+
+LOG_DIR = sys.argv[1] if len(sys.argv) > 1 else '/var/log/apache2'
+DOCROOT = '/var/www/html'
+APPCENTER = os.path.join(DOCROOT, 'AppCenter')
+# 根目录下不是前端的目录
+NOT_FRONTEND = {'AppCenter', 'PHP', 'Resource', 'TseHost', 'docs', 'scripts', 'ngrok', 'vendor', 'node_modules'}
+LINE = re.compile(
+    r'^(?P<ip>\S+) \S+ \S+ \[(?P<ts>[^\]]+)\] "(?P<method>[A-Z]+) (?P<path>\S+)[^"]*" (?P<status>\d{3}) \S+ '
+    r'"(?P<ref>[^"]*)" "(?P<ua>[^"]*)"'
+)
+# /AppCenter/<App>/... 或 /<根目录前端>/...；第一组是 "AppCenter/"（可空），第二组是目录名
+APP_IN_PATH = re.compile(r'^/(AppCenter/)?([^/?#]+)')
+APP_IN_REF = re.compile(r'^https?://([^/]+)/(AppCenter/)?([^/?#]+)')
+MONTHS = {m: i + 1 for i, m in enumerate('Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec'.split())}
+
+
+def source_of(ref_host):
+    if ref_host is None:
+        return 'none'
+    host = ref_host.split(':')[0].lower()
+    if 'ngrok' in host:
+        return 'ngrok'
+    if host == 'localhost' or host.startswith('127.'):
+        return 'local'
+    return 'lan'
+
+
+def parse_ts(ts):
+    """'03/Oct/2026:12:20:40 +0200' → ('2026-10-03', '2026-10-03T12:20:40')，比 strptime 快得多"""
+    d, mon, rest = ts[0:2], ts[3:6], ts[7:]
+    year, hms = rest[0:4], rest[5:13]
+    day = f'{year}-{MONTHS.get(mon, 0):02d}-{d}'
+    return day, f'{day}T{hms}'
+
+
+def main():
+    installed = []
+    if os.path.isdir(APPCENTER):
+        installed += ['AppCenter/' + d for d in os.listdir(APPCENTER) if os.path.isdir(os.path.join(APPCENTER, d))]
+    if os.path.isdir(DOCROOT):
+        installed += [
+            d for d in os.listdir(DOCROOT)
+            if d not in NOT_FRONTEND and not d.startswith('.') and os.path.isfile(os.path.join(DOCROOT, d, 'index.html'))
+        ]
+    installed.sort()
+    known = set(installed)
+    # 快速预筛：行里得出现某个已知目录的路径段，绝大多数 PHP 轮询行直接跳过
+    roots = sorted({k.split('/')[0] for k in known}, key=len, reverse=True)
+    prefilter = re.compile('/(?:' + '|'.join(re.escape(r) for r in roots) + ')[/?# "]') if roots else None
+    stats = defaultdict(lambda: {
+        'pageLoads': 0, 'requests': 0, 'clients': set(),
+        'sources': {'none': 0, 'local': 0, 'lan': 0, 'ngrok': 0}, 'lastSeen': '',
+    })
+    log_from = log_to = None
+    total = 0
+    for f in sorted(glob.glob(os.path.join(LOG_DIR, 'access.log*'))):
+        opener = gzip.open if f.endswith('.gz') else open
+        try:
+            fh = opener(f, 'rt', errors='replace')
+        except OSError:
+            continue
+        with fh:
+            for line in fh:
+                total += 1
+                # 时间范围按所有行算，统计只看和 AppCenter 有关的行
+                lb = line.find('[')
+                if lb > 0:
+                    day, at = parse_ts(line[lb + 1:lb + 21])
+                    if log_from is None or at < log_from:
+                        log_from = at
+                    if log_to is None or at > log_to:
+                        log_to = at
+                if prefilter is None or not prefilter.search(line):
+                    continue
+                m = LINE.match(line)
+                if not m:
+                    continue
+                path, ref = m['path'], m['ref']
+                pm = APP_IN_PATH.match(path)
+                rm = APP_IN_REF.match(ref) if ref and ref != '-' else None
+                path_app = (pm.group(1) or '') + pm.group(2) if pm else None
+                ref_app = (rm.group(2) or '') + rm.group(3) if rm else None
+                if path_app not in known:
+                    path_app = None
+                if ref_app not in known:
+                    ref_app, rm = None, None
+                app = path_app or ref_app
+                if not app:
+                    continue
+                day, at = parse_ts(m['ts'])
+                s = stats[(app, day)]
+                s['requests'] += 1
+                bare = path.split('?')[0].split('#')[0]
+                if path_app and m['method'] == 'GET' and m['status'] in ('200', '304') and bare in (
+                        f'/{app}', f'/{app}/', f'/{app}/index.html'):
+                    s['pageLoads'] += 1
+                ref_host = rm.group(1) if rm else None
+                s['clients'].add((m['ip'], ref_host or '-', m['ua'][:120]))
+                s['sources'][source_of(ref_host)] += 1
+                if at > s['lastSeen']:
+                    s['lastSeen'] = at
+    out = {
+        'logFrom': log_from,
+        'logTo': log_to,
+        'totalRequests': total,
+        'installedApps': installed,
+        'usage': [
+            {
+                'app': app, 'day': day, 'pageLoads': s['pageLoads'], 'requests': s['requests'],
+                'clients': len(s['clients']), 'sources': s['sources'], 'lastSeen': s['lastSeen'],
+            }
+            for (app, day), s in sorted(stats.items())
+        ],
+    }
+    json.dump(out, sys.stdout, ensure_ascii=False, separators=(',', ':'))
+
+
+if __name__ == '__main__':
+    main()

package/AadenDeploy/appcenterRefs.py

@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+"""
+列出一个 AppCenter 应用目录里「当前这版 index.html 实际用得到」的文件（相对路径，一行一个，只列存在的）。
+
+appCenterSync.sh 用它保留上一代：替换目录前，把旧目录里这些文件中新版没有的拷进新目录，
+正开着的旧页面懒加载 chunk 时就不会 404。再往前历次手工覆盖堆下来的文件不在这个闭包里，顺带清掉。
+
+闭包算法与 aaden-php-backend scripts/appcenter_artifact.py 的 referenced() 相同，改一边记得改另一边：
+index.html 的 src/href → webpack runtime 的 chunk→hash 表 → js/css 文本里的 hash 资源路径。
+"""
+import os
+import re
+import sys
+
+ATTR = re.compile(r'''(?:src|href)=["']?([^"'\s>]+)''')
+RUNTIME = re.compile(r'(js|css)/"\+\(\{([^}]*)\}\[\w+\]\|\|\w+\)\+"\."\+\{([^}]*)\}')
+PAIR = re.compile(r'"?([\w\-]+)"?:"([\w\-]+)"')
+ASSET_REF = re.compile(r'(?<![\w\-])((?:js|css|img|fonts|media)/[\w\-.@]+\.[0-9a-f]{8}\.[A-Za-z0-9]+)')
+PRECACHE = re.compile(r'precache-manifest\.[0-9a-f]+\.js')
+
+
+def norm(ref):
+    ref = ref.split('?')[0].split('#')[0]
+    if re.match(r'^[a-z]+:|^//', ref):
+        return None
+    while ref.startswith('./'):
+        ref = ref[2:]
+    return ref.lstrip('/') or None
+
+
+def read_text(path):
+    with open(path, 'rb') as f:
+        return f.read().decode('utf-8', 'replace')
+
+
+def main(root):
+    if not os.path.isfile(os.path.join(root, 'index.html')):
+        return
+    seen, found = set(), []
+    queue = [r for r in (norm(m) for m in ATTR.findall(read_text(os.path.join(root, 'index.html')))) if r]
+    queue.append('index.html')
+    sw = os.path.join(root, 'service-worker.js')
+    if os.path.exists(sw):
+        queue.append('service-worker.js')
+        queue += PRECACHE.findall(read_text(sw))
+    while queue:
+        ref = queue.pop()
+        if ref in seen:
+            continue
+        seen.add(ref)
+        path = os.path.join(root, ref)
+        if not os.path.isfile(path):
+            continue
+        found.append(ref)
+        if not ref.endswith(('.js', '.css')):
+            continue
+        text = read_text(path)
+        for kind, names, hashes in RUNTIME.findall(text):
+            name_of = dict(PAIR.findall(names))
+            for chunk, h in PAIR.findall(hashes):
+                queue.append('%s/%s.%s.%s' % (kind, name_of.get(chunk, chunk), h, kind))
+        queue += ASSET_REF.findall(text)
+    sys.stdout.write(''.join(r + '\n' for r in sorted(found)))
+
+
+if __name__ == '__main__':
+    main(sys.argv[1])

package/AadenDeploy/ensureAppCenterNoCache.sh

@@ -0,0 +1,84 @@
+#!/bin/bash
+# 确保 AppCenter 下各前端的 index.html 带 `Cache-Control: no-cache`。由 appCenterSync.sh 在 manifest 打开
+# ensureNoCache 时调用（受 manifest 的灰度门控制）；幂等，已生效时只做几个文件比较就返回。
+#
+# 病症：设备 Apache 默认没开 mod_headers，index.html 只带 Last-Modified/ETag，浏览器按「文件年龄 × 10%」自行缓存，
+# 这段时间里同一个 URL 直接用缓存、不问服务器。aaden-vue-app 打开后台带的 chaos= 是收银程序启动时间，
+# 程序不重启 URL 就不变 → appcenter-sync 换了新版也看不到；期间若又发一版，缓存里的旧 index.html
+# 去请求已被清掉的旧 chunk → 白屏。js/css 文件名带内容 hash，不受影响，所以只管 index.html。
+# no-cache = 每次用之前先向服务器确认，不是不缓存。（mod_deflate 给 ETag 加了 -gzip，条件请求对不上，
+# 实际每次回 200 约 3KB 而不是 304，可忽略。）只对之后的新响应生效，已缓存的旧响应要等它自己过期。
+#
+# 风险控制（配置写坏时 reload 会被 configtest 拦住、继续跑旧配置，但下次重启 Apache 就起不来、收银全停）：
+#   - 动手前先 configtest：本来就过不了的设备一律不碰
+#   - 配置包在 <IfModule> 里；写完立刻 configtest，不过就原样撤回（删配置、关掉本次才开的模块）
+#   - 只 graceful reload，不 restart：正在处理的请求（打印、TSE 签名）不被打断
+# 末行输出：NOCACHE_OK（已生效）| NOCACHE_APPLIED | NOCACHE_SKIP_<原因> | NOCACHE_REVERTED | NOCACHE_FAILED
+# 退出码：只有 NOCACHE_FAILED（撤回后配置仍坏 / reload 失败）为 1
+# 撤销：a2disconf aaden-appcenter-cache && systemctl reload apache2
+set -u
+NAME=aaden-appcenter-cache
+CONF=/etc/apache2/conf-available/$NAME.conf
+PW='Innerken322.'
+sudoS(){ echo "$PW" | sudo -S bash -c "$*"; }
+configtest(){ sudoS "apache2ctl configtest" >/dev/null 2>&1; }
+
+if ! command -v apache2ctl >/dev/null || ! command -v a2enmod >/dev/null; then
+  echo "  没有 apache2ctl/a2enmod（不是 apt 装的 Apache？），不碰"; echo "NOCACHE_SKIP_NO_APACHE"; exit 0
+fi
+
+TMP=$(mktemp)
+trap 'rm -f "$TMP" "$TMP.old"' EXIT
+cat > "$TMP" <<'EOF'
+# 由 aaden-cli AadenDeploy/ensureAppCenterNoCache.sh 维护，手改会被覆盖。
+# AppCenter 前端的入口页每次先向服务器确认，避免更新后还在用缓存里的旧 index.html。
+# 只匹配 /var/www/html/AppCenter 下的 index.html；PHP 接口、js/css、根目录 /App/ /Admin/ 不受影响。
+<IfModule mod_headers.c>
+  <Directory /var/www/html/AppCenter>
+    <FilesMatch "^index\.html$">
+      Header set Cache-Control "no-cache"
+    </FilesMatch>
+  </Directory>
+</IfModule>
+EOF
+
+MOD_WAS_ON=0; [ -e /etc/apache2/mods-enabled/headers.load ] && MOD_WAS_ON=1
+CONF_WAS_ON=0; [ -e "/etc/apache2/conf-enabled/$NAME.conf" ] && CONF_WAS_ON=1
+if [ "$MOD_WAS_ON" = 1 ] && [ "$CONF_WAS_ON" = 1 ] && cmp -s "$TMP" "$CONF"; then
+  echo "NOCACHE_OK"; exit 0
+fi
+if ! configtest; then
+  echo "  Apache 配置本来就过不了 configtest，不碰（这台设备需要人工处理）"; echo "NOCACHE_SKIP_CONFIG_BROKEN"; exit 0
+fi
+HAD_CONF=0; [ -f "$CONF" ] && { HAD_CONF=1; cp "$CONF" "$TMP.old"; }
+
+# 撤回到动手前的状态：只关本次才开的模块/配置，原来就有的不碰
+revert(){
+  [ "$CONF_WAS_ON" = 0 ] && sudoS "a2disconf -q $NAME" >/dev/null 2>&1
+  if [ "$HAD_CONF" = 1 ]; then sudoS "cp '$TMP.old' '$CONF'"; else sudoS "rm -f '$CONF'"; fi
+  [ "$MOD_WAS_ON" = 0 ] && sudoS "a2dismod -q headers" >/dev/null 2>&1
+  if configtest; then echo "  已撤回，Apache 配置恢复正常"; return 0; fi
+  echo "  !!! 撤回后 configtest 仍失败，需要人工处理（重启前务必修好）"; return 1
+}
+
+sudoS "cp '$TMP' '$CONF' && chmod 644 '$CONF'"
+[ "$MOD_WAS_ON" = 1 ] || sudoS "a2enmod -q headers" >/dev/null
+[ "$CONF_WAS_ON" = 1 ] || sudoS "a2enconf -q $NAME" >/dev/null
+
+if ! configtest; then
+  echo "  写入后 configtest 失败（未 reload，线上仍是旧配置），撤回"
+  if revert; then echo "NOCACHE_REVERTED"; exit 0; fi
+  echo "NOCACHE_FAILED"; exit 1
+fi
+if ! sudoS "systemctl reload apache2 || apache2ctl graceful"; then
+  echo "  reload 失败，撤回"
+  revert; echo "NOCACHE_FAILED"; exit 1
+fi
+
+# graceful 后新配置由新起的子进程接手，稍等再验
+sleep 2
+if [ -f /var/www/html/AppCenter/Admin/index.html ]; then
+  H=$(curl -sI --max-time 10 http://localhost/AppCenter/Admin/ | tr -d '\r' | grep -i '^cache-control:')
+  echo "  验证 /AppCenter/Admin/ -> ${H:-（没有 Cache-Control 头！）}"
+fi
+echo "NOCACHE_APPLIED"

package/AadenDeploy/upgrade.sh

@@ -17,7 +17,14 @@ sudo npm i aaden-cli -g
 
 aaden-cli patch
 
+# 前端目录访问量上报（AppCenter 各应用 + 根目录老前端；只读 Apache 日志，20 小时内报过就空跑）。放在 light-update 前面，后端部署出问题也不影响统计
+aaden-cli appcenter-usage
+
 # 后端也走 aaden-cli 通道自愈：light-update 自带 版本门/灰度门/活动单门，
 # 已最新则空跑，营业时间被 @reboot 触发也不会打断收银（不 snap refresh 前端、不 apt）。
 # 这条让"后端自动更新"重新依赖活着的 npm+S3 管线，而不是失效的 git token。
 aaden-cli light-update
+
+# AppCenter 前端（Admin 等）单独同步：light-update 不发 AppCenter。灰度由 S3 manifest 的 rollout 控制，
+# 不在灰度内 / 已最新时空跑（一次几 KB 的 manifest 请求）；不碰 PHP 和数据库，营业时间触发也安全。
+aaden-cli appcenter-sync

package/README.md

@@ -35,3 +35,23 @@ Commands:
   help [command]                          display help for command
 
 ```
+
+## 发布
+
+1. 在 master 上运行 `npm run update`：release-it 把版本号升一个 patch，提交 `aaden-cli: release vX.Y.Z`，打 tag `X.Y.Z` 并推上去。本地不再发布 npm。
+   要在普通 clone 里运行：release-it 13 认不出 `git worktree`，在 worktree 里只会改版本号，不会提交、打 tag。
+2. tag 推上去后，GitHub Actions 的 `.github/workflows/publish.yml` 自动执行：
+   - 校验 tag 和 `package.json` 的版本一致，并且 tag 指向的提交在 master 上；
+   - 从这个 tag 对应的提交 `npm ci` 并用 ncc 打包，冒烟检查 `dist/index.js --version`；
+   - 用 npm Trusted Publishing（OIDC）执行 `npm publish`，不需要 npm token 或 OTP；
+   - 创建 GitHub Release。
+3. 全网设备在第二天 04:55 自动 `npm install aaden-cli -g` 装上新版本。
+
+⚠️ `latest` 一发布就是全网发布。要先在个别设备上试，用预发布通道：
+
+- 在任意分支的提交上打 `x.y.z-后缀` 形式的 tag（如 `1.6.103-rc.0`）并推上去，CI 会把这个提交按 tag 的版本号发到 npm 的 `next`（不需要提交版本号）。
+- 设备每天只装 `latest`，不会自动装 `next`。要试的设备上手动运行 `sudo npm i -g aaden-cli@next`；这台设备第二天 04:55 会自动回到 `latest`。
+
+CI 发布失败时的手动兜底：在 tag 对应的提交上运行 `npx ncc build index.js -o dist -C && npm publish`（需要 npm 2FA）。
+
+一次性配置：npmjs.com → aaden-cli → Settings → Trusted Publisher → GitHub Actions，填组织 `innerken-gmbh`、仓库 `aaden-cli`、workflow `publish.yml`；允许的操作要勾上 `npm publish`（2026-09-03 之后新建的配置默认只允许 `npm stage publish`，直接 publish 会报 403 "OIDC permission denied for this action"）。

package/dist/index.js

@@ -7,7 +7,7 @@
 
 const util = __nccwpck_require__(3837)
 const colors = __nccwpck_require__(3045)
-const {spawnSync, spawn} = __nccwpck_require__(8493)
+const {spawnSync, spawn} = __nccwpck_require__(2081)
 
 function getLine(char, lineLength = 20) {
     return char.repeat(lineLength)
@@ -99,7 +99,7 @@ const {hillo} = __nccwpck_require__(6365)
 const version = (__nccwpck_require__(4147)/* .version */ .i8)
 const colors = __nccwpck_require__(3045)
 const defaultData = {
-    frontendVersion: '', cliVersion: '', diskUsage: '', upTime: '', ngrokIsNew: false
+    frontendVersion: '', cliVersion: '', diskUsage: '', upTime: '', ngrokIsNew: false, hostInfo: {}
 }
 
 async function deviceEcho(data) {
@@ -110,7 +110,7 @@ async function deviceEcho(data) {
     Object.entries(data).forEach(en => {
         console.log(...en)
     })
-    const {frontendVersion, cliVersion, diskUsage, upTime, ngrokIsNew} = Object.assign({}, defaultData, data)
+    const {frontendVersion, cliVersion, diskUsage, upTime, ngrokIsNew, hostInfo} = Object.assign({}, defaultData, data)
     if (parseInt(myDeviceId) === -1) {
         return
     }
@@ -131,7 +131,8 @@ async function deviceEcho(data) {
             diskUsage,
             lastUptime: upTime,
             ngrokOk: ngrokIsNew,
-            deviceName: `${name}\n${adress1}\n${postCode} ${city} ${state}`
+            deviceName: `${name}\n${adress1}\n${postCode} ${city} ${state}`,
+            ...hostInfo
         })
         console.log('report to remote server complete')
     } catch (e) {
@@ -179,6 +180,75 @@ async function getNiceRestaurantInfo() {
 
 
 
+/***/ }),
+
+/***/ 3727:
+/***/ ((module, __unused_webpack_exports, __nccwpck_require__) => {
+
+const os = __nccwpck_require__(2037)
+const fs = __nccwpck_require__(7147)
+const {execSync} = __nccwpck_require__(2081)
+
+// do-log 顺带上报的宿主机信息，用来在云端看车队的系统/硬件分布。
+// 每一项单独兜底：探测失败就报 null，不能让 do-log 本身挂掉。
+
+function safe(fn, fallback = null) {
+    try {
+        const value = fn()
+        return value === undefined ? fallback : value
+    } catch (e) {
+        return fallback
+    }
+}
+
+function run(cmd) {
+    return execSync(cmd, {
+        encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore']
+    }).trim()
+}
+
+function osRelease() {
+    const text = fs.readFileSync('/etc/os-release', 'utf-8')
+    const match = text.match(/^PRETTY_NAME="?([^"\n]*)"?$/m)
+    return match ? match[1] : null
+}
+
+function rootDisk() {
+    // 第二行是 "<size> <avail>"，单位字节
+    const [size, avail] = run('df -B1 --output=size,avail /')
+        .split('\n')[1].trim().split(/\s+/).map(Number)
+    const toGb = bytes => Math.round(bytes / 1024 / 1024 / 1024)
+    return {diskTotalGb: toGb(size), diskAvailGb: toGb(avail)}
+}
+
+function dockerVersion() {
+    // 没装 docker 报空串，和"探测失败"(null) 区分开
+    const output = run('command -v docker >/dev/null && docker --version || true')
+    const match = output.match(/version ([^,\s]+)/)
+    return match ? match[1] : ''
+}
+
+function collectHostInfo() {
+    const cpus = safe(() => os.cpus(), [])
+    const disk = safe(rootDisk, {diskTotalGb: null, diskAvailGb: null})
+    return {
+        osRelease: safe(osRelease),
+        kernelVersion: safe(() => os.release()),
+        // WSL1 内核是 "4.4.0-19041-Microsoft"，WSL2 是 "5.15.x-microsoft-standard-WSL2"
+        wsl: safe(() => /microsoft|wsl/i.test(os.release())),
+        cpuModel: cpus.length ? cpus[0].model.trim() : null,
+        cpuCores: cpus.length || null,
+        cpuArch: safe(() => os.arch()),
+        memTotalMb: safe(() => Math.round(os.totalmem() / 1024 / 1024)),
+        diskTotalGb: disk.diskTotalGb,
+        diskAvailGb: disk.diskAvailGb,
+        dockerVersion: safe(dockerVersion),
+    }
+}
+
+module.exports = {collectHostInfo}
+
+
 /***/ }),
 
 /***/ 6545:
@@ -3079,7 +3149,7 @@ module.exports = {
  */
 
 const EventEmitter = (__nccwpck_require__(2361).EventEmitter);
-const spawn = (__nccwpck_require__(8493).spawn);
+const spawn = (__nccwpck_require__(2081).spawn);
 const path = __nccwpck_require__(1017);
 const fs = __nccwpck_require__(7147);
 
@@ -6851,7 +6921,7 @@ module.exports = (flag, argv = process.argv) => {
 
 /***/ }),
 
-/***/ 2081:
+/***/ 7299:
 /***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
 
 "use strict";
@@ -7024,7 +7094,7 @@ Object.defineProperty(exports, "__esModule", ({
 }));
 exports["default"] = void 0;
 
-var _http = __nccwpck_require__(2081);
+var _http = __nccwpck_require__(7299);
 
 var _sweetalert = _interopRequireDefault(__nccwpck_require__(6091));
 
@@ -7213,7 +7283,7 @@ exports["default"] = exports.hillo = void 0;
 
 var _request = _interopRequireDefault(__nccwpck_require__(7798));
 
-var _http = __nccwpck_require__(2081);
+var _http = __nccwpck_require__(7299);
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
@@ -18383,7 +18453,7 @@ module.exports = require("assert");
 
 /***/ }),
 
-/***/ 8493:
+/***/ 2081:
 /***/ ((module) => {
 
 "use strict";
@@ -18507,7 +18577,7 @@ module.exports = JSON.parse('{"name":"axios","version":"0.19.2","description":"P
 /***/ ((module) => {
 
 "use strict";
-module.exports = {"i8":"1.6.101"};
+module.exports = JSON.parse('{"i8":"1.6.103-rc.0"}');
 
 /***/ })
 
@@ -18587,9 +18657,13 @@ var __webpack_exports__ = {};
 const dayjs = __nccwpck_require__(7401)
 const colors = __nccwpck_require__(3045)
 const fs = __nccwpck_require__(7147)
+const path = __nccwpck_require__(1017)
+const {execSync} = __nccwpck_require__(2081)
+const os = __nccwpck_require__(2037)
 const InnerKenTimeStampFormat = 'YYYYMMDDHHmmss'
 const prompts = __nccwpck_require__(9646)
 const {deviceEcho, logAction, getCurrentDeviceId} = __nccwpck_require__(7415)
+const {collectHostInfo} = __nccwpck_require__(3727)
 const GlobalDeviceId = 'notset'
 
 const {program} = __nccwpck_require__(1904)
@@ -18610,6 +18684,8 @@ 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('appcenter-usage [force]').action(appCenterUsage) // 门店前端目录（AppCenter 各应用 + 根目录老前端）访问量上报云端，供 auto-upgrade 每天调一次
+program.command('appcenter-sync [channel]').action(appCenterSync) // AppCenter 前端按应用同步，供 auto-upgrade 调用
 program.command('rollback').action(rollback)
 program
     .command('install <deviceId>')
@@ -19162,6 +19238,78 @@ async function lightUpdate() {
     }
 }
 
+/**
+ * 门店前端目录的实际访问量 → cloud（ERP「租户管理」里看全网哪些目录还有人用、从哪儿访问）。
+ * 包括 AppCenter 下各应用（"AppCenter/Admin"）和 docroot 根目录的老前端（"Admin"、"App"）。
+ * 统计在 AadenDeploy/appCenterUsage.py（只读 Apache access.log，按 目录×天 汇总）。
+ * Apache 日志保留 14 天，所以每次都把整个窗口重报一遍，云端按 设备×应用×天 覆盖；新装上的第一次就能带回两周历史。
+ * 每天随 auto-upgrade 跑一次，20 小时内报过就跳过（@reboot 也会触发 auto-upgrade），传 force 跳过这道门。
+ * 最低 CPU/IO 优先级；失败只打印，不写 deviceLog 事件（免得 650 台每天各刷一条）。
+ */
+async function appCenterUsage(force) {
+    const stamp = '/var/tmp/aaden-appcenter-usage.last'
+    try {
+        if (force !== 'force' && fs.existsSync(stamp) && Date.now() - fs.statSync(stamp).mtimeMs < 20 * 3600 * 1000) {
+            console.log('appcenter-usage: 20 小时内已上报，跳过')
+            return
+        }
+        const deviceId = await getCurrentDeviceId()
+        if (parseInt(deviceId) === -1) {
+            return
+        }
+        const script = path.join(findMe(), '..', 'AadenDeploy', 'appCenterUsage.py')
+        const output = execSync(
+            `echo "Innerken322." | sudo -S nice -n 19 $(command -v ionice >/dev/null && echo ionice -c3) python3 ${script}`,
+            {encoding: 'utf-8', maxBuffer: 32 * 1024 * 1024, timeout: 15 * 60 * 1000, stdio: ['ignore', 'pipe', 'ignore']}
+        )
+        const report = JSON.parse(output)
+        // 和 do-log 一样按 deviceId 错开，别让全网同一秒打云端
+        await new Promise(resolve => setTimeout(resolve, (parseInt(deviceId) % 30) * 1000))
+        await hillo.jsonPost('https://cloud-v2.aaden.io/deviceLog/appUsage', {deviceId, cliVersion: version, ...report})
+        try {
+            fs.writeFileSync(stamp, new Date().toISOString())
+        } catch (_) {}
+        console.log(`appcenter-usage: 已上报 ${report.usage.length} 条（${report.logFrom} ~ ${report.logTo}）`)
+    } catch (e) {
+        console.error('appcenter-usage 失败:', e.message || e)
+    }
+}
+
+/**
+ * AppCenter 前端同步 —— light-update 只发 PHP/，AppCenter 以前只能跟 465MB 的 latest.zip 走。
+ * 每天随 auto-upgrade 跑一次；不跟后端版本门绑定（只改前端时后端版本不变，绑了就永远不跑）。
+ *
+ * 全部逻辑在 AadenDeploy/appCenterSync.sh：灰度门（S3 manifest 的 rollout）、index.html no-cache、
+ * treeSha256 门（一致就空跑）、下载校验、保留上一代、换目录、健康检查失败回滚。
+ * 这里只负责传 deviceId、把有动作的结果写进 cloud 事件日志 —— 空跑（已最新 / 不在灰度内）不上报，
+ * 免得 650 台每天各刷一条。
+ */
+async function appCenterSync(channel = 'stable') {
+    const resultFile = path.join(fs.mkdtempSync(path.join(os.tmpdir(), 'aaden-appcenter-')), 'result.txt')
+    try {
+        const deviceId = await getCurrentDeviceId()
+        const command = [
+            ...getPrivilegeCMD('AadenDeploy/appCenterSync.sh'),
+            'cd AadenDeploy',
+            `APPCENTER_DEVICE_ID=${deviceId} APPCENTER_RESULT=${resultFile} ./appCenterSync.sh ${channel}`
+        ]
+        const {code} = await cli.executeInShell(command, program.debug)
+        let lines = []
+        try {
+            lines = fs.readFileSync(resultFile, 'utf8').split('\n').filter(l => l.trim())
+        } catch (_) {}
+        const quiet = /^(APP_UP_TO_DATE|SKIP_ROLLOUT|SKIP_LOCKED|NOCACHE_OK)\b/
+        if (code !== 0 || lines.some(l => !quiet.test(l))) {
+            await logAction('appcenter-sync: ' + (lines.join(' | ') || '无结果输出'), code || 0)
+        }
+    } catch (e) {
+        console.error(e)
+        try { await logAction('appcenter-sync 异常: ' + (e.message || e), 1) } catch (_) {}
+    } finally {
+        try { fs.rmSync(path.dirname(resultFile), {recursive: true, force: true}) } 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)
@@ -19362,7 +19510,8 @@ async function doLog() {
             cliVersion: version,
             diskUsage: diskUsage[diskUsage.length - 1].replace('\n', ''),
             upTime: getUpTime(),
-            ngrokIsNew: ngrokNewestVersion()
+            ngrokIsNew: ngrokNewestVersion(),
+            hostInfo: collectHostInfo()
         }
     )
     console.log('finish')

package/index.js

@@ -6,9 +6,13 @@
 const dayjs = require('dayjs')
 const colors = require('colors')
 const fs = require('fs')
+const path = require('path')
+const {execSync} = require('child_process')
+const os = require('os')
 const InnerKenTimeStampFormat = 'YYYYMMDDHHmmss'
 const prompts = require('prompts')
 const {deviceEcho, logAction, getCurrentDeviceId} = require('./modules/firebase')
+const {collectHostInfo} = require('./modules/host-info')
 const GlobalDeviceId = 'notset'
 
 const {program} = require('commander')
@@ -29,6 +33,8 @@ 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('appcenter-usage [force]').action(appCenterUsage) // 门店前端目录（AppCenter 各应用 + 根目录老前端）访问量上报云端，供 auto-upgrade 每天调一次
+program.command('appcenter-sync [channel]').action(appCenterSync) // AppCenter 前端按应用同步，供 auto-upgrade 调用
 program.command('rollback').action(rollback)
 program
     .command('install <deviceId>')
@@ -581,6 +587,78 @@ async function lightUpdate() {
     }
 }
 
+/**
+ * 门店前端目录的实际访问量 → cloud（ERP「租户管理」里看全网哪些目录还有人用、从哪儿访问）。
+ * 包括 AppCenter 下各应用（"AppCenter/Admin"）和 docroot 根目录的老前端（"Admin"、"App"）。
+ * 统计在 AadenDeploy/appCenterUsage.py（只读 Apache access.log，按 目录×天 汇总）。
+ * Apache 日志保留 14 天，所以每次都把整个窗口重报一遍，云端按 设备×应用×天 覆盖；新装上的第一次就能带回两周历史。
+ * 每天随 auto-upgrade 跑一次，20 小时内报过就跳过（@reboot 也会触发 auto-upgrade），传 force 跳过这道门。
+ * 最低 CPU/IO 优先级；失败只打印，不写 deviceLog 事件（免得 650 台每天各刷一条）。
+ */
+async function appCenterUsage(force) {
+    const stamp = '/var/tmp/aaden-appcenter-usage.last'
+    try {
+        if (force !== 'force' && fs.existsSync(stamp) && Date.now() - fs.statSync(stamp).mtimeMs < 20 * 3600 * 1000) {
+            console.log('appcenter-usage: 20 小时内已上报，跳过')
+            return
+        }
+        const deviceId = await getCurrentDeviceId()
+        if (parseInt(deviceId) === -1) {
+            return
+        }
+        const script = path.join(findMe(), '..', 'AadenDeploy', 'appCenterUsage.py')
+        const output = execSync(
+            `echo "Innerken322." | sudo -S nice -n 19 $(command -v ionice >/dev/null && echo ionice -c3) python3 ${script}`,
+            {encoding: 'utf-8', maxBuffer: 32 * 1024 * 1024, timeout: 15 * 60 * 1000, stdio: ['ignore', 'pipe', 'ignore']}
+        )
+        const report = JSON.parse(output)
+        // 和 do-log 一样按 deviceId 错开，别让全网同一秒打云端
+        await new Promise(resolve => setTimeout(resolve, (parseInt(deviceId) % 30) * 1000))
+        await hillo.jsonPost('https://cloud-v2.aaden.io/deviceLog/appUsage', {deviceId, cliVersion: version, ...report})
+        try {
+            fs.writeFileSync(stamp, new Date().toISOString())
+        } catch (_) {}
+        console.log(`appcenter-usage: 已上报 ${report.usage.length} 条（${report.logFrom} ~ ${report.logTo}）`)
+    } catch (e) {
+        console.error('appcenter-usage 失败:', e.message || e)
+    }
+}
+
+/**
+ * AppCenter 前端同步 —— light-update 只发 PHP/，AppCenter 以前只能跟 465MB 的 latest.zip 走。
+ * 每天随 auto-upgrade 跑一次；不跟后端版本门绑定（只改前端时后端版本不变，绑了就永远不跑）。
+ *
+ * 全部逻辑在 AadenDeploy/appCenterSync.sh：灰度门（S3 manifest 的 rollout）、index.html no-cache、
+ * treeSha256 门（一致就空跑）、下载校验、保留上一代、换目录、健康检查失败回滚。
+ * 这里只负责传 deviceId、把有动作的结果写进 cloud 事件日志 —— 空跑（已最新 / 不在灰度内）不上报，
+ * 免得 650 台每天各刷一条。
+ */
+async function appCenterSync(channel = 'stable') {
+    const resultFile = path.join(fs.mkdtempSync(path.join(os.tmpdir(), 'aaden-appcenter-')), 'result.txt')
+    try {
+        const deviceId = await getCurrentDeviceId()
+        const command = [
+            ...getPrivilegeCMD('AadenDeploy/appCenterSync.sh'),
+            'cd AadenDeploy',
+            `APPCENTER_DEVICE_ID=${deviceId} APPCENTER_RESULT=${resultFile} ./appCenterSync.sh ${channel}`
+        ]
+        const {code} = await cli.executeInShell(command, program.debug)
+        let lines = []
+        try {
+            lines = fs.readFileSync(resultFile, 'utf8').split('\n').filter(l => l.trim())
+        } catch (_) {}
+        const quiet = /^(APP_UP_TO_DATE|SKIP_ROLLOUT|SKIP_LOCKED|NOCACHE_OK)\b/
+        if (code !== 0 || lines.some(l => !quiet.test(l))) {
+            await logAction('appcenter-sync: ' + (lines.join(' | ') || '无结果输出'), code || 0)
+        }
+    } catch (e) {
+        console.error(e)
+        try { await logAction('appcenter-sync 异常: ' + (e.message || e), 1) } catch (_) {}
+    } finally {
+        try { fs.rmSync(path.dirname(resultFile), {recursive: true, force: true}) } 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)
@@ -781,7 +859,8 @@ async function doLog() {
             cliVersion: version,
             diskUsage: diskUsage[diskUsage.length - 1].replace('\n', ''),
             upTime: getUpTime(),
-            ngrokIsNew: ngrokNewestVersion()
+            ngrokIsNew: ngrokNewestVersion(),
+            hostInfo: collectHostInfo()
         }
     )
     console.log('finish')

package/modules/firebase.js

@@ -3,7 +3,7 @@ const {hillo} = require('hillo')
 const version = require('./../package.json').version
 const colors = require('colors')
 const defaultData = {
-    frontendVersion: '', cliVersion: '', diskUsage: '', upTime: '', ngrokIsNew: false
+    frontendVersion: '', cliVersion: '', diskUsage: '', upTime: '', ngrokIsNew: false, hostInfo: {}
 }
 
 export async function deviceEcho(data) {
@@ -14,7 +14,7 @@ export async function deviceEcho(data) {
     Object.entries(data).forEach(en => {
         console.log(...en)
     })
-    const {frontendVersion, cliVersion, diskUsage, upTime, ngrokIsNew} = Object.assign({}, defaultData, data)
+    const {frontendVersion, cliVersion, diskUsage, upTime, ngrokIsNew, hostInfo} = Object.assign({}, defaultData, data)
     if (parseInt(myDeviceId) === -1) {
         return
     }
@@ -35,7 +35,8 @@ export async function deviceEcho(data) {
             diskUsage,
             lastUptime: upTime,
             ngrokOk: ngrokIsNew,
-            deviceName: `${name}\n${adress1}\n${postCode} ${city} ${state}`
+            deviceName: `${name}\n${adress1}\n${postCode} ${city} ${state}`,
+            ...hostInfo
         })
         console.log('report to remote server complete')
     } catch (e) {

package/modules/host-info.js

@@ -0,0 +1,62 @@
+const os = require('os')
+const fs = require('fs')
+const {execSync} = require('child_process')
+
+// do-log 顺带上报的宿主机信息，用来在云端看车队的系统/硬件分布。
+// 每一项单独兜底：探测失败就报 null，不能让 do-log 本身挂掉。
+
+function safe(fn, fallback = null) {
+    try {
+        const value = fn()
+        return value === undefined ? fallback : value
+    } catch (e) {
+        return fallback
+    }
+}
+
+function run(cmd) {
+    return execSync(cmd, {
+        encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore']
+    }).trim()
+}
+
+function osRelease() {
+    const text = fs.readFileSync('/etc/os-release', 'utf-8')
+    const match = text.match(/^PRETTY_NAME="?([^"\n]*)"?$/m)
+    return match ? match[1] : null
+}
+
+function rootDisk() {
+    // 第二行是 "<size> <avail>"，单位字节
+    const [size, avail] = run('df -B1 --output=size,avail /')
+        .split('\n')[1].trim().split(/\s+/).map(Number)
+    const toGb = bytes => Math.round(bytes / 1024 / 1024 / 1024)
+    return {diskTotalGb: toGb(size), diskAvailGb: toGb(avail)}
+}
+
+function dockerVersion() {
+    // 没装 docker 报空串，和"探测失败"(null) 区分开
+    const output = run('command -v docker >/dev/null && docker --version || true')
+    const match = output.match(/version ([^,\s]+)/)
+    return match ? match[1] : ''
+}
+
+function collectHostInfo() {
+    const cpus = safe(() => os.cpus(), [])
+    const disk = safe(rootDisk, {diskTotalGb: null, diskAvailGb: null})
+    return {
+        osRelease: safe(osRelease),
+        kernelVersion: safe(() => os.release()),
+        // WSL1 内核是 "4.4.0-19041-Microsoft"，WSL2 是 "5.15.x-microsoft-standard-WSL2"
+        wsl: safe(() => /microsoft|wsl/i.test(os.release())),
+        cpuModel: cpus.length ? cpus[0].model.trim() : null,
+        cpuCores: cpus.length || null,
+        cpuArch: safe(() => os.arch()),
+        memTotalMb: safe(() => Math.round(os.totalmem() / 1024 / 1024)),
+        diskTotalGb: disk.diskTotalGb,
+        diskAvailGb: disk.diskAvailGb,
+        dockerVersion: safe(dockerVersion),
+    }
+}
+
+module.exports = {collectHostInfo}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aaden-cli",
-  "version": "1.6.101",
+  "version": "1.6.103-rc.0",
   "description": "",
   "main": "dist/index.js",
   "scripts": {
@@ -21,7 +21,12 @@
     "hooks": {
       "after:bump": "ncc build index.js -o dist -C"
     },
-    "github.release": true,
+    "npm": {
+      "publish": false
+    },
+    "github": {
+      "release": false
+    },
     "git": {
       "commitMessage": "aaden-cli: release v${version}",
       "requireCleanWorkingDir": false