@hmos-library-adapter/fast 0.0.17-beta.0 → 0.0.17-beta.2

package/node_modules/@ohos-agent/pc-adapter/templates/hap/cli-hnp-runner/entry/src/main/ets/entryability/EntryAbility.ets

@@ -0,0 +1,29 @@
+import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
+import { window } from '@kit.ArkUI';
+
+export default class EntryAbility extends UIAbility {
+  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
+  }
+
+  onDestroy(): void {
+  }
+
+  onWindowStageCreate(windowStage: window.WindowStage): void {
+    windowStage.loadContent('pages/Index', (err) => {
+      if (err) {
+        console.error('Failed to load content', JSON.stringify(err));
+        return;
+      }
+      console.info('Succeeded in loading content.');
+    });
+  }
+
+  onWindowStageDestroy(): void {
+  }
+
+  onForeground(): void {
+  }
+
+  onBackground(): void {
+  }
+}

package/node_modules/@ohos-agent/pc-adapter/templates/hap/cli-hnp-runner/entry/src/main/ets/pages/Index.ets

@@ -0,0 +1,81 @@
+// entry/src/main/ets/pages/Index.ets — cli-hnp-runner 宿主页：拉起即 fork+execv 私有 HNP 里的
+// __TOOL__ 跑用例。全套跑在 C++ worker 线程（不阻塞 ArkUI 主线程——长测试冻屏会被系统判无响应），
+// 本页 pollStatus() 每 2 秒轮询取 TAP 结果显示到屏幕（供 ohpt verify-demo 截图佐证；主证据仍是
+// hilog 原始输出）。
+// 'lib__XCOMP__.so' 的 __XCOMP__ 必须与 CMake target / napi_stub.cpp nm_modname 三处全等。
+import demo from 'lib__XCOMP__.so';
+import { common } from '@kit.AbilityKit';
+
+@Entry
+@Component
+struct Index {
+  @State message: string = '(未运行)';
+  @State running: boolean = false;
+  private timer: number = -1;
+
+  private filesDir(): string {
+    const ctx = this.getUIContext().getHostContext() as common.UIAbilityContext;
+    return ctx.filesDir;
+  }
+
+  private startRun(): void {
+    let started: string = '(空)';
+    try {
+      started = demo.runTool(this.filesDir());
+    } catch (e) {
+      this.message = 'runTool 失败: ' + JSON.stringify(e);
+      return;
+    }
+    if (started === 'busy') {
+      this.message = '上一轮还在跑…（TAP 行正实时打 hilog，可 grep 查看）';
+      return;
+    }
+    this.running = true;
+    this.message = started + ' …运行中（长测试不冻屏，完成自动更新）';
+    if (this.timer >= 0) {
+      clearInterval(this.timer);
+    }
+    this.timer = setInterval(() => {
+      let s: string = 'RUNNING';
+      try {
+        s = demo.pollStatus();
+      } catch (e) {
+        s = 'pollStatus 失败: ' + JSON.stringify(e);
+      }
+      if (s !== 'RUNNING') {
+        if (this.timer >= 0) {
+          clearInterval(this.timer);
+          this.timer = -1;
+        }
+        this.running = false;
+        this.message = s;
+      }
+    }, 2000);
+  }
+
+  aboutToAppear(): void {
+    // 拉起即自动跑一轮（`hdc shell "aa start …"` 后无需交互即可取证）
+    this.startRun();
+  }
+
+  build() {
+    Column({ space: 12 }) {
+      Text('__TOOL__ · 私有 HNP 执行器')
+        .fontSize(20)
+        .fontWeight(FontWeight.Bold)
+      Scroll() {
+        Text(this.message)
+          .fontSize(13)
+          .fontFamily('monospace')
+          .textAlign(TextAlign.Start)
+      }
+      .layoutWeight(1)
+      Button('重跑用例')
+        .enabled(!this.running)
+        .onClick(() => this.startRun())
+    }
+    .width('100%')
+    .height('100%')
+    .padding(16)
+  }
+}

package/node_modules/@ohos-agent/pc-adapter/templates/hap/cli-hnp-runner/entry/src/main/module.json5

@@ -0,0 +1,59 @@
+{
+  "module": {
+    "name": "entry",
+    "type": "entry",
+    "description": "$string:entry_desc",
+    "mainElement": "EntryAbility",
+    "deviceTypes": [
+      "2in1",
+      "tablet",
+      "phone"
+    ],
+    "deliveryWithInstall": true,
+    "installationFree": false,
+    "extractNativeLibs": true,
+    // 私有 HNP 声明——本模板的要害。二进制随 HAP 装到 /data/app/<bundle>.org/<name>_<ver>/bin/，
+    // 标签 private_hnp_file:s0，app 域原生模块可直接 exec；同时在 /data/app/bin/<tool> 生成符号链接。
+    // 包文件本身由 build/build-hap.sh 打包并 zip 注入（hvigor 不会自动收 .hnp）。
+    "hnpPackages": [
+      {
+        "package": "__TOOL__.hnp",
+        "type": "private"
+      }
+    ],
+    "pages": "$profile:main_pages",
+    "abilities": [
+      {
+        "name": "EntryAbility",
+        "srcEntry": "./ets/entryability/EntryAbility.ets",
+        "description": "$string:entry_desc",
+        "icon": "$media:app_icon",
+        "label": "$string:app_name",
+        "startWindowIcon": "$media:app_icon",
+        "startWindowBackground": "$color:start_window_background",
+        "exported": true,
+        "skills": [
+          {
+            "entities": [
+              "entity.system.home"
+            ],
+            "actions": [
+              "action.system.home"
+            ]
+          }
+        ]
+      }
+    ],
+    "metadata": [
+      {
+        "name": "ArkTSPartialUpdate",
+        "value": "true"
+      }
+    ],
+    "requestPermissions": [
+      {
+        "name": "ohos.permission.INTERNET"
+      }
+    ]
+  }
+}

package/node_modules/@ohos-agent/pc-adapter/templates/hap/cli-hnp-runner/entry/src/main/resources/base/element/color.json

@@ -0,0 +1,8 @@
+{
+  "color": [
+    {
+      "name": "start_window_background",
+      "value": "#FFFFFF"
+    }
+  ]
+}

package/node_modules/@ohos-agent/pc-adapter/templates/hap/cli-hnp-runner/entry/src/main/resources/base/element/string.json

@@ -0,0 +1,8 @@
+{
+  "string": [
+    {
+      "name": "entry_desc",
+      "value": "__APPNAME__"
+    }
+  ]
+}

package/node_modules/@ohos-agent/pc-adapter/templates/hap/cli-hnp-runner/entry/src/main/resources/base/profile/main_pages.json

@@ -0,0 +1,5 @@
+{
+  "src": [
+    "pages/Index"
+  ]
+}

package/node_modules/@ohos-agent/pc-adapter/templates/hap/cli-hnp-runner/hvigor/hvigor-config.json5

@@ -0,0 +1,13 @@
+{
+  "modelVersion": "5.0.0",
+  "dependencies": {
+  },
+  "execution": {
+  },
+  "logging": {
+  },
+  "debugging": {
+  },
+  "nodeOptions": {
+  }
+}

package/node_modules/@ohos-agent/pc-adapter/templates/hap/cli-hnp-runner/hvigorfile.ts

@@ -0,0 +1,6 @@
+import { appTasks } from '@ohos/hvigor-ohos-plugin';
+
+export default {
+    system: appTasks,  /* Built-in plugin of Hvigor. It cannot be modified. */
+    plugins: []       /* Custom plugin to extend the functionality of Hvigor. */
+}

package/node_modules/@ohos-agent/pc-adapter/templates/hap/cli-hnp-runner/oh-package.json5

@@ -0,0 +1,8 @@
+{
+  "modelVersion": "5.0.0",
+  "description": "__APPNAME__ (cli-hnp-runner scaffold)",
+  "dependencies": {
+  },
+  "devDependencies": {
+  }
+}

package/node_modules/@ohos-agent/pc-adapter/templates/hap/cli-hnp-runner/scripts/build-hap.sh

@@ -0,0 +1,402 @@
+#!/usr/bin/env bash
+# build-hap.sh — 构建 cli-hnp-runner HAP（零售机上 CLI 二进制的设备侧 exec 验证载体）。
+#
+# 链路：打 HNP 包 → hvigor 构建 unsigned HAP → zip 增量注入 hnp/arm64-v8a/
+#      （hvigor **不会**自动收 .hnp，必须注入；依据 pc-knowledge-base「app域执行二进制与JIT限制」）
+#      → 产物 dist/app/__TOOL__-runner-unsigned.hap（签名装机走 `ohpt sign-demo --hap … --install`）。
+#
+# 前置：DEVECO_SDK_HOME 已设置（定位见 pc-knowledge-base「定位 DevEco SDK」）。
+#
+# 骨架来自 `ohpt scaffold --kind cli-hnp-runner`，只改下方参数段——
+# 禁止手写 harmony-demo/build-profile.json5（runtimeOS/compileSdkVersion 配错触发 E121）。
+
+set -euo pipefail
+
+WORKSPACE="$(cd "$(dirname "$0")/__WSREL__" && pwd)"
+DEMO_DIR="$WORKSPACE/__OUT__"
+DIST_DIR=__DIST__
+HNP_DIR="$DIST_DIR/../hnp"
+
+# ===[按你的库改这里]=========================================================
+# TOOL_BIN：要装进设备的 CLI 可执行文件（你交叉编译出的 aarch64-ohos ELF；
+#           绝对路径或相对 $WORKSPACE，如 "dist/lib/__TOOL__"）
+TOOL_BIN="dist/lib/__TOOL__"
+# TOOL_VERSION：HNP 包版本号（随便填一个语义版本即可，只影响设备上的落地目录名）
+TOOL_VERSION="1.0.0"
+# EXTRA_BIN：同一 HNP 包里要一起带上的其它可执行/数据文件（可留空）
+EXTRA_BIN=()
+# EXTRA_LIB：CLI 动态依赖的 .so（放 pkg/bin，与工具同级——runner 设 LD_LIBRARY_PATH=bin 目录，
+#           依赖 .so 只能放这里才能被解析；ELF 链接期 RPATH/rpath 是宿主路径，设备上无效）。
+#           相对 $WORKSPACE，如 "dist/lib/libs/libfoo.so.0"。可留空。
+EXTRA_LIB=()
+# EXTRA_DIR：需随包带入的脚本/数据目录（可选，如某调试工具的 tcl 脚本目录），相对 $WORKSPACE，整树打进 pkg/。
+# EXTRA_DIR="dist/lib/tcl"
+# ===========================================================================
+
+: "${DEVECO_SDK_HOME:?未设置 DEVECO_SDK_HOME——定位方法见 pc-knowledge-base「定位 DevEco SDK」}"
+export PATH="$DEVECO_SDK_HOME/default/openharmony/toolchains:$PATH"
+
+pack_hnp() {
+    local src="$TOOL_BIN"
+    [[ "$src" = /* ]] || src="$WORKSPACE/$src"
+    [[ -f "$src" ]] || { echo "[ERROR] 找不到 CLI 产物: $src（先跑交叉编译，或改本脚本的 TOOL_BIN）"; exit 1; }
+
+    # HNP 包 = 含 pkg/{bin/…, hnp.json} 的 zip。用 SDK 自带 hnpcli；没有则退回 zip
+    # （.hnp 本质就是 zip，实测可用——不引入"宿主必须有某工具"的假前提）。
+    local pkg="$HNP_DIR/pkg"
+    rm -rf "$pkg"
+    mkdir -p "$pkg/bin"
+    cp "$src" "$pkg/bin/__TOOL__"
+    chmod +x "$pkg/bin/__TOOL__"
+    # 运行时数据随包（runtime_assets）：dist/share/<数据族>/ 存在则整体打入 pkg/share/
+    # （探针 __data-family-probe__ 按 HNP 装机路径可达性核对；声明见 03-adapt.json runtime_assets[]，
+    #  判定方法见 pc-capability-domains runtime-data-assets——terminfo 族实例：dist/share/terminfo/）
+    if [[ -d "$WORKSPACE/dist/share" ]]; then
+        mkdir -p "$pkg/share"
+        cp -R "$WORKSPACE/dist/share/." "$pkg/share/"
+        echo "[OK] runtime data staged: dist/share -> pkg/share"
+    fi
+    local extra
+    for extra in ${EXTRA_LIB[@]+"${EXTRA_LIB[@]}"}; do
+        [[ "$extra" = /* ]] || extra="$WORKSPACE/$extra"
+        cp "$extra" "$pkg/bin/"
+    done
+    for extra in ${EXTRA_BIN[@]+"${EXTRA_BIN[@]}"}; do
+        [[ "$extra" = /* ]] || extra="$WORKSPACE/$extra"
+        cp "$extra" "$pkg/bin/"
+    done
+    # 脚本/数据目录随包（某调试工具的 tcl 之类）——工具在设备上按相对路径找它
+    if [[ -n "${EXTRA_DIR:-}" && -d "$WORKSPACE/$EXTRA_DIR" ]]; then
+        cp -r "$WORKSPACE/$EXTRA_DIR" "$pkg/$(basename "$EXTRA_DIR")"
+        echo "[OK] extra dir staged: $EXTRA_DIR -> pkg/$(basename "$EXTRA_DIR")"
+    fi
+    # CRLF→LF 归一化（Windows checkout 的文本数据被 git 换成 CRLF 行尾）：
+    # 数据驱动的官方测试二进制会因此全军覆没——evp 向量 'Cipher = AES-128-CBC\r' 失配
+    #（9/9 fail 实证）、conf 内 '${ENV::TEST_CERTS_DIR}/cert.pem\r' 拼出 ENOENT 路径
+    #（ssl_test 7/7 fail 实证，某国密 OpenSSL 分支 2026-09-17）。声明式配置解析器对 \r 同样零容忍：
+    # 逐行 'ignoring unsupported character' → help 正文被当顶层语句 → syntax error →
+    # 配置生成不了 → 依赖配置的用例连锁失败（10+ 例一损俱损实证 2026-09-18）。
+    # ⚠️ 必须**递归全树**且按 NUL 判二进制——白名单扩展名会漏掉无扩展名文本
+    #    （框架函数库/构建脚本/符号表清单）与未列举的子目录，那正是重灾区。
+    if command -v python >/dev/null 2>&1; then
+        _py=python
+    elif command -v python3 >/dev/null 2>&1; then
+        _py=python3
+    fi
+    if [[ -n "${_py:-}" ]]; then
+        "$_py" - "$pkg" <<'PYEOF'
+import os, sys
+root = sys.argv[1]
+fixed = clean = bin_ = 0
+for base, _dirs, names in os.walk(root):
+    for n in names:
+        p = os.path.join(base, n)
+        with open(p, 'rb') as f:
+            data = f.read()
+        if b'\x00' in data:
+            bin_ += 1
+            continue
+        if b'\r' in data:
+            with open(p, 'wb') as f:
+                f.write(data.replace(b'\r\n', b'\n').replace(b'\r', b'\n'))
+            fixed += 1
+        else:
+            clean += 1
+print(f"[OK] CRLF->LF normalized (recursive, NUL-binary-skipped): fixed={fixed} clean={clean} binary={bin_}")
+PYEOF
+    elif command -v perl >/dev/null 2>&1; then
+        # 无 python 时退 perl 白名单（覆盖常见数据扩展名）——无扩展名文本仍会漏，装机前自查
+        find "$pkg" -type f \( -name '*.txt' -o -name '*.cnf' -o -name '*.pem' \
+             -o -name '*.crt' -o -name '*.key' -o -name '*.cer' -o -name '*.csr' \
+             -o -name '*.conf' -o -name '*.cnf.in' -o -name '*.cfg' -o -name '*.tcl' \
+             -o -name '*.in' -o -name '*.mk' -o -name '*.sh' \) \
+            -exec perl -i -pe 's/\r\n/\n/' {} +
+        echo "[WARN] 无 python，CRLF 归一化退白名单扩展名——无扩展名文本（框架脚本/清单类）请自查"
+    else
+        echo "[WARN] 无 python 也无 perl，跳过 CRLF 归一化——数据驱动测试可能因行尾失配失败"
+    fi
+    # shebang 自指修正：随包 wrapper 脚本（busybox/coreutils 的 applet 链接、构建框架脚本）
+    # 常带宿主 shebang `#!/bin/bash`——设备无标准 FHS，/bin/bash 不存在 → exec rc=126
+    #（"bad interpreter: No such file or directory"，全链用例失败实证 2026-09-18）。
+    # 统一改写为 HNP 内 bash 的绝对装机路径 /data/app/<name>.org/<name>_<ver>/bin/bash。
+    local hnp_bash="/data/app/__TOOL__.org/__TOOL___${TOOL_VERSION}/bin/bash"
+    find "$pkg" -type f \( -name '*.sh' -o -name 'busybox*' -o -name '*' ! -name '*.*' \) -print0 2>/dev/null |
+    while IFS= read -r -d '' f; do
+        if [ "$(head -c 12 "$f" 2>/dev/null)" = "#!/bin/bash" ] || \
+           [ "$(head -c 15 "$f" 2>/dev/null)" = "#!/usr/bin/bash" ] || \
+           [ "$(head -c 19 "$f" 2>/dev/null)" = "#!/usr/bin/env bash" ]; then
+            tail -c +$(($(head -1 "$f" | wc -c) + 1)) "$f" > "$f.tmp" && \
+                printf '#!%s\n' "$hnp_bash" | cat - "$f.tmp" > "$f" && rm -f "$f.tmp" && chmod +x "$f"
+        fi
+    done
+    echo "[OK] shebang rewritten to $hnp_bash (if any)"
+    printf '{"type":"hnp-config","name":"__TOOL__","version":"%s","install":{}}\n' "$TOOL_VERSION" > "$pkg/hnp.json"
+
+    rm -f "$HNP_DIR/__TOOL__.hnp"
+    # hnpcli 打包把 zip 条目 origin 写成 MS-DOS 且丢执行位（装机后 symlink 农场 exec 报 EACCES，poco 案例实证），
+    # 统一禁用 hnpcli，走 node 兜底（version-made-by=Unix 3<<8 + external_attr 有 X 位），python 再兜底。
+    local hnpcli="$DEVECO_SDK_HOME/default/openharmony/toolchains/hnpcli"
+    if false && [[ -x "$hnpcli" ]] && (cd "$HNP_DIR" && "$hnpcli" pack -i "$pkg" -o "$HNP_DIR" -n __TOOL__ -v "$TOOL_VERSION" >/dev/null 2>&1); then
+        : # hnpcli 已禁用
+    elif pack_hnp_node; then
+        : # node 打包成功（执行位正确）
+    elif pack_hnp_py; then
+        : # python 打包成功
+    else
+        echo "[WARN] 无 python/node 可用，退回 zip -r（依赖 Info-ZIP 继承文件权限，Windows tar/zip 会丢执行位）"
+        (cd "$HNP_DIR" && zip -q -r "__TOOL__.hnp" pkg)
+    fi
+    [[ -f "$HNP_DIR/__TOOL__.hnp" ]] || { echo "[ERROR] HNP 打包失败"; exit 1; }
+    # 执行位兜底校验：zip 内文件无 X 位 → 装机后 execve EACCES（poco 案例实证，表象类似 SELinux）
+    if command -v unzip >/dev/null 2>&1; then
+        unzip -Z -v "$HNP_DIR/__TOOL__.hnp" 2>/dev/null | grep -q 'rwx' \
+            || echo "[WARN] __TOOL__.hnp 内文件可能缺执行位——请用 zipinfo 核对 pkg/bin/__TOOL__ 的 Unix 权限"
+    fi
+    echo "[OK] hnp <- $src ($(stat -c%s "$HNP_DIR/__TOOL__.hnp" 2>/dev/null || wc -c < "$HNP_DIR/__TOOL__.hnp") bytes)"
+}
+
+# python 兜底打包：显式目录条目 + 每个文件 external_attr=0o100667（zip 内自带执行位，
+# 不依赖宿主 zip 实现继承文件系统权限——Windows 的 tar/zip 会丢 X 位）。
+pack_hnp_py() {
+    local py
+    py="$(command -v python || command -v python3 || true)"
+    [[ -n "$py" ]] || return 1
+    "$py" - "$HNP_DIR" "__TOOL__" <<'PYEOF'
+import os, sys, zipfile
+hnp_dir, tool = sys.argv[1], sys.argv[2]
+pkg = os.path.join(hnp_dir, 'pkg')
+out = os.path.join(hnp_dir, tool + '.hnp')
+with zipfile.ZipFile(out, 'w', zipfile.ZIP_DEFLATED) as z:
+    files, dirs = [], set()
+    for base, _, names in os.walk(pkg):
+        for n in names:
+            full = os.path.join(base, n)
+            rel = os.path.relpath(full, hnp_dir).replace(os.sep, '/')
+            files.append((rel, full))
+            parts = rel.split('/')[:-1]
+            for i in range(1, len(parts) + 1):
+                dirs.add('/'.join(parts[:i]) + '/')
+    # 目录条目先行（E134：安装器不建父目录，目录必须先于内容出现，否则 9568407）
+    for d in sorted(dirs):
+        zi = zipfile.ZipInfo(d)
+        zi.create_system = 3
+        zi.external_attr = (0o40755 << 16)
+        z.writestr(zi, '')
+    for rel, full in files:
+        zi = zipfile.ZipInfo(rel)
+        zi.create_system = 3          # Unix：让 external_attr 高 16 位 mode 生效（默认 0=MS-DOS 丢执行位）
+        zi.external_attr = (0o100667 << 16)
+        zi.compress_type = zipfile.ZIP_DEFLATED
+        with open(full, 'rb') as f:
+            z.writestr(zi, f.read())
+print('[py] packed', out)
+PYEOF
+}
+
+# node 兜底打包（hvigor 依赖 node，跑本脚本必有 node）：store 模式手写 zip，
+# 中央目录 external_attr=0o100667<<16 自带执行位；msys 无 python/zip 时仍能打。
+pack_hnp_node() {
+    local node_bin
+    node_bin="$(command -v node || true)"
+    [[ -n "$node_bin" ]] || return 1
+    "$node_bin" - "$HNP_DIR" "__TOOL__" <<'JSEOF'
+const fs = require('fs'), path = require('path');
+const [hnpDir, tool] = process.argv.slice(2);
+const pkg = path.join(hnpDir, 'pkg');
+const out = path.join(hnpDir, tool + '.hnp');
+const T = [];
+for (let n = 0; n < 256; n++) { let c = n; for (let k = 0; k < 8; k++) c = c & 1 ? 0xEDB88320 ^ (c >>> 1) : c >>> 1; T[n] = c >>> 0; }
+const crc32 = (b) => { let c = 0xFFFFFFFF; for (const x of b) c = T[(c ^ x) & 0xFF] ^ (c >>> 8); return (c ^ 0xFFFFFFFF) >>> 0; };
+const files = [];
+(function walk(d) { for (const e of fs.readdirSync(d, { withFileTypes: true })) { const f = path.join(d, e.name); e.isDirectory() ? walk(f) : files.push(f); } })(pkg);
+const relOf = (f) => path.relative(hnpDir, f).split(path.sep).join('/');
+const dirSet = new Set();
+for (const f of files) { const parts = relOf(f).split('/'); parts.pop(); for (let i = 1; i <= parts.length; i++) dirSet.add(parts.slice(0, i).join('/') + '/'); }
+const entries = [...dirSet].sort().map((d) => ({ rel: d, data: null })).concat(files.map((f) => ({ rel: relOf(f), data: fs.readFileSync(f) })));
+const chunks = [], central = [];
+let offset = 0;
+for (const e of entries) {
+  const name = Buffer.from(e.rel, 'utf8');
+  const data = e.data ?? Buffer.alloc(0);
+  const isDir = e.data === null;
+  const crc = crc32(data);
+  const attr = ((isDir ? 0o40755 : 0o100667) << 16) >>> 0;
+  const lh = Buffer.alloc(30);
+  lh.writeUInt32LE(0x04034b50, 0); lh.writeUInt16LE(20, 4); lh.writeUInt16LE(0x0800, 6);
+  lh.writeUInt32LE(crc, 14); lh.writeUInt32LE(data.length, 18); lh.writeUInt32LE(data.length, 22);
+  lh.writeUInt16LE(name.length, 26); lh.writeUInt16LE(0, 28);
+  chunks.push(lh, name, data);
+  const ch = Buffer.alloc(46);
+  ch.writeUInt32LE(0x02014b50, 0); ch.writeUInt16LE((3 << 8) | 20, 4); ch.writeUInt16LE(20, 6);
+  ch.writeUInt16LE(0x0800, 8); ch.writeUInt32LE(crc, 16); ch.writeUInt32LE(data.length, 20);
+  ch.writeUInt32LE(data.length, 24); ch.writeUInt16LE(name.length, 28); ch.writeUInt32LE(attr, 38);
+  ch.writeUInt32LE(offset, 42);
+  central.push(ch, name);
+  offset += 30 + name.length + data.length;
+}
+const cdBuf = Buffer.concat(central);
+const end = Buffer.alloc(22);
+end.writeUInt32LE(0x06054b50, 0); end.writeUInt16LE(entries.length, 8); end.writeUInt16LE(entries.length, 10);
+end.writeUInt32LE(cdBuf.length, 12); end.writeUInt32LE(offset, 16);
+fs.writeFileSync(out, Buffer.concat([...chunks, cdBuf, end]));
+console.log('[node] packed', out);
+JSEOF
+}
+
+stage_hnp() {
+    # HNP 进工程源码树（module.json5 的 hnpPackages 声明引用它）
+    local dst="$DEMO_DIR/entry/hnp/arm64-v8a/__TOOL__.hnp"
+    mkdir -p "$(dirname "$dst")"
+    cp "$HNP_DIR/__TOOL__.hnp" "$dst"
+}
+
+# ---- 注入链的 zip 兜底：Git Bash 常无 zip/unzip，退 python 标准库 zipfile ----
+#（打包链见上方 pack_hnp_py/pack_hnp_node；注入是「往已有 zip 追加」，node 无内置 zip
+#  读写不参与此链——宿主既无 zip 又无 python 时给出明确报错而不是晦涩的 127。）
+zip_has_entry() {  # $1=zip  $2=条目子串
+    if command -v unzip >/dev/null 2>&1; then
+        unzip -l "$1" | grep -q "$2"
+    else
+        local py
+        py="$(command -v python || command -v python3 || true)"
+        [[ -n "$py" ]] || { echo "[ERROR] 宿主无 unzip 也无 python——无法检查 zip 条目" >&2; return 1; }
+        "$py" - "$1" "$2" <<'PYEOF'
+import sys, zipfile
+names = zipfile.ZipFile(sys.argv[1]).namelist()
+sys.exit(0 if any(sys.argv[2] in n for n in names) else 1)
+PYEOF
+    fi
+}
+
+zip_append_dir() {  # $1=zip（追加目标） $2=目录（其内 hnp/ 子树追加进 zip）
+    if command -v zip >/dev/null 2>&1; then
+        (cd "$2" && zip -q -r "$1" hnp)
+    else
+        local py
+        py="$(command -v python || command -v python3 || true)"
+        if [[ -z "$py" ]]; then
+            echo "[ERROR] 宿主无 zip 也无 python——无法注入 hnp/ 进 HAP。装其一后重跑（python 走标准库，零第三方依赖）" >&2
+            return 1
+        fi
+        "$py" - "$1" "$2" <<'PYEOF'
+import os, sys, zipfile
+hap, stage = sys.argv[1], sys.argv[2]
+with zipfile.ZipFile(hap, 'a', zipfile.ZIP_DEFLATED) as zf:
+    for base, _dirs, files in os.walk(stage):
+        for n in files:
+            full = os.path.join(base, n)
+            zf.write(full, os.path.relpath(full, stage).replace(os.sep, '/'))
+print('[py] injected hnp/ ->', hap)
+PYEOF
+    fi
+}
+
+# 自检清单（肉眼核对用）：打印 zip 内命中模式的条目；unzip/python 都没有时静默跳过
+zip_list_match() {  # $1=zip  $2=正则
+    if command -v unzip >/dev/null 2>&1; then
+        unzip -l "$1" | grep -E "$2" || true
+    else
+        local py
+        py="$(command -v python || command -v python3 || true)"
+        [[ -n "$py" ]] || return 0
+        "$py" - "$1" "$2" <<'PYEOF'
+import re, sys, zipfile
+pat = re.compile(sys.argv[2])
+for n in zipfile.ZipFile(sys.argv[1]).namelist():
+    if pat.search(n):
+        print(' ', n)
+PYEOF
+    fi
+}
+
+build_hap() {
+    # ── libs/ 反向校验（libbsd 9/12 实证）：entry/libs/ 里的自编交叉 .so 会毒化同 bundle
+    #    的 HNP exec 白名单（装机 success + dlopen 正常 + 所有 HNP ELF exec 即 SIGSEGV）。
+    #    白名单 = 系统库 libc++_shared.so + 本工程 napi 模块 lib*_demo.so；命中白名单外的
+    #    .so 一律 ERROR——交叉库的正确位置是 HNP 的 pkg/bin/（EXTRA_LIB），不是 HAP libs/。
+    local libs_dir="$DEMO_DIR/entry/libs/arm64-v8a"
+    if [[ -d "$libs_dir" ]]; then
+        local offenders=""
+        local f
+        for f in "$libs_dir"/*.so "$libs_dir"/*.so.*; do
+            [[ -e "$f" ]] || continue
+            local base
+            base="$(basename "$f")"
+            if [[ "$base" != "libc++_shared.so" && "$base" != lib*_demo.so ]]; then
+                offenders="$offenders $base"
+            fi
+        done
+        if [[ -n "$offenders" ]]; then
+            echo "[ERROR] entry/libs/arm64-v8a/ 存在白名单外的自编 .so:$offenders"
+            echo "        交叉库放这里会毒化同 bundle 的 HNP ELF exec 白名单（exec 全 SIGSEGV、零输出）。"
+            echo "        依赖 .so 的正确位置是 HNP 的 pkg/bin/（build-hap.sh 的 EXTRA_LIB）——与工具同级，"
+            echo "        exec 时经 LD_LIBRARY_PATH 解析；in-process dlopen 型用例请改走 bin 型 exec（唯一共存形态）。"
+            exit 1
+        fi
+    fi
+
+    cd "$DEMO_DIR"
+    "$DEVECO_SDK_HOME/../tools/hvigor/bin/hvigorw" assembleApp -p product=default --no-daemon
+    local HAP
+    HAP="$(find "$DEMO_DIR/entry/build/default/outputs/default" -name '*.hap' 2>/dev/null | head -1)"
+    [[ -f "$HAP" ]] || { echo "[ERROR] 未找到 hvigor 产物 hap"; exit 1; }
+
+    # zip 增量注入 hnp/（hvigor 不收 .hnp——这一步漏了，装机后 /data/app/bin/ 里不会有你的工具）
+    if zip_has_entry "$HAP" 'hnp/arm64-v8a/__TOOL__.hnp'; then
+        echo "[WARN] HAP 已含 __TOOL__.hnp，跳过注入"
+    else
+        local stage
+        stage="$(mktemp -d)"
+        mkdir -p "$stage/hnp/arm64-v8a"
+        cp "$HNP_DIR/__TOOL__.hnp" "$stage/hnp/arm64-v8a/"
+        zip_append_dir "$HAP" "$stage"
+        rm -rf "$stage"
+        echo "[OK] injected hnp/arm64-v8a/__TOOL__.hnp"
+    fi
+
+    # ⚠️ 按需解除注释：手编 .so 时注入 libc++_shared.so（不走 hvigor CMake 时不自收 C++ 运行时）
+    # 症状：NAPI 模块加载失败（MUSL-LDSO "Error loading shared library libc++_shared.so"
+    # → ArkCompiler "export objects of native so is undefined" → 全部用例「调用失败: {}」
+    # 零 OHPTCASE 行；CLI demo 项目 2026-09-15 真机实证。
+    # 走 hvigor CMake（默认路径）时下面的注入块不要打开——hvigor 已自收 libc++_shared.so。
+    # if ! zip_has_entry "$HAP" 'libs/arm64-v8a/libc++_shared.so'; then
+    #     local CXXSHARED
+    #     CXXSHARED="$DEVECO_SDK_HOME/default/openharmony/native/llvm/lib/aarch64-linux-ohos/libc++_shared.so"
+    #     [[ -f "$CXXSHARED" ]] || { echo "[ERROR] NDK 找不到 libc++_shared.so"; exit 1; }
+    #     local _cs
+    #     _cs="$(mktemp -d)"
+    #     mkdir -p "$_cs/libs/arm64-v8a"
+    #     cp "$CXXSHARED" "$_cs/libs/arm64-v8a/"
+    #     zip_append_dir "$HAP" "$_cs"
+    #     rm -rf "$_cs"
+    #     echo "[OK] injected libs/arm64-v8a/libc++_shared.so"
+    # fi
+
+    # 手编 .so 注入：仅当 napi_stub.cpp 不走 hvigor CMake（如单独 g++/clang++ 编译 .so）
+    # 时才需要。走 hvigor CMake（默认路径）时这里会告警但继续——hvigor 已自收 lib__XCOMP___demo.so。
+    local SO_SRC="$DEMO_DIR/entry/build/default/intermediates/cmake/default/obj/arm64-v8a/lib__XCOMP___demo.so"
+    if [[ -f "$SO_SRC" ]] && ! zip_has_entry "$HAP" 'libs/arm64-v8a/lib__XCOMP___demo.so'; then
+        local _so_stage
+        _so_stage="$(mktemp -d)"
+        mkdir -p "$_so_stage/libs/arm64-v8a"
+        cp "$SO_SRC" "$_so_stage/libs/arm64-v8a/"
+        zip_append_dir "$HAP" "$_so_stage"
+        rm -rf "$_so_stage"
+        echo "[OK] injected libs/arm64-v8a/lib__XCOMP___demo.so (hand-compiled .so path)"
+    else
+        # hvigor CMake 路径：确认 .so 已自动包装
+        if zip_has_entry "$HAP" 'libs/arm64-v8a/lib__XCOMP___demo.so'; then
+            echo "[OK] lib__XCOMP___demo.so auto-packed by hvigor (CMake path)"
+        fi
+    fi
+
+    mkdir -p "$DIST_DIR"
+    cp "$HAP" "$DIST_DIR/__TOOL__-runner-unsigned.hap"
+    zip_list_match "$DIST_DIR/__TOOL__-runner-unsigned.hap" 'hnp/|lib__XCOMP__|libc\+\+_shared'
+    echo "[OK] HAP: $DIST_DIR/__TOOL__-runner-unsigned.hap"
+    echo "     下一步: ohpt sign-demo -w \"$WORKSPACE\" --demo-dir __OUT__ --hap dist/app/__TOOL__-runner-unsigned.hap --install"
+}
+
+pack_hnp
+stage_hnp
+build_hap

package/node_modules/@ohos-agent/pc-adapter/templates/hap/cpp-gui-owb-demo/AppScope/app.json5

@@ -0,0 +1,12 @@
+{
+  "app": {
+    "bundleName": "__BUNDLE__",
+    "vendor": "example",
+    "versionCode": 1000000,
+    "versionName": "1.0.0",
+    "icon": "$media:app_icon",
+    "label": "$string:app_name",
+    "targetAPIVersion": 12,
+    "minAPIVersion": 12
+  }
+}

package/node_modules/@ohos-agent/pc-adapter/templates/hap/cpp-gui-owb-demo/AppScope/resources/base/element/string.json

@@ -0,0 +1,8 @@
+{
+  "string": [
+    {
+      "name": "app_name",
+      "value": "__APPNAME__"
+    }
+  ]
+}