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

package/node_modules/@ohos-agent/pc-adapter/templates/hap/cpp-terminal-demo/entry/src/main/ets/pages/Index.ets

@@ -0,0 +1,234 @@
+// entry/src/main/ets/pages/Index.ets — cpp-terminal-demo 宿主页：
+// ① TAP 通道（runTool，回归用）② 终端上屏通道（runPty → 读 pty-raw.log → VT 子集解析 → 屏幕渲染）。
+// 渲染面 = PTY 捕获流在设备屏幕上的可视重放；上屏证据 = `ohpt verify-demo` 截图 + hilog B64 全量流。
+// 'lib__XCOMP__.so' 的 __XCOMP__ 必须与 CMake target / napi_stub.cpp nm_modname 三处全等。
+import demo from 'lib__XCOMP__.so';
+import { fileIo as fs } from '@kit.CoreFileKit';
+import { common } from '@kit.AbilityKit';
+
+/** VT 子集屏幕模型：解析 pty-raw.log 的转义序列流，维护 80×24 字符网格 + 光标。
+ *  支持子集（与 pc-capability-domains terminal-render 条目一致）：
+ *  \r \n \b、CSI A/B/C/D（光标移动）、H/f（CUP）、K（EL）、J（ED）、m（SGR 颜色记账）、
+ *  G（CHA）、d（VPA）；OSC/charset/priv-mode 序列跳过。
+ *  ⚠️ 渲染面只管**可视存档**——语义正确性的机判 ground truth 是宿主侧 pyte buffer 断言
+ *  （pc-device-verify「终端上屏验证」操作节），两者共用同一份 pty-raw.log。 */
+class VtScreen {
+  readonly w: number;
+  readonly h: number;
+  private grid: string[][] = [];
+  private cx: number = 0;
+  private cy: number = 0;
+  cursorX: number = 0;
+  cursorY: number = 0;
+
+  constructor(w: number, h: number) {
+    this.w = w;
+    this.h = h;
+    this.clearAll();
+  }
+
+  private blankRow(): string[] {
+    const row: string[] = [];
+    for (let i = 0; i < this.w; i++) {
+      row.push(' ');
+    }
+    return row;
+  }
+
+  private clearAll(): void {
+    this.grid = [];
+    for (let r = 0; r < this.h; r++) {
+      this.grid.push(this.blankRow());
+    }
+    this.cx = 0;
+    this.cy = 0;
+  }
+
+  private scrollUp(): void {
+    this.grid.shift();
+    this.grid.push(this.blankRow());
+  }
+
+  private newline(): void {
+    this.cy++;
+    if (this.cy >= this.h) {
+      this.cy = this.h - 1;
+      this.scrollUp();
+    }
+  }
+
+  private put(ch: string): void {
+    this.grid[this.cy][this.cx] = ch;
+    this.cx++;
+    if (this.cx >= this.w) {  // DECAWM 自动换行
+      this.cx = 0;
+      this.newline();
+    }
+  }
+
+  private csi(params: string, final: string): void {
+    const nums: number[] = [];
+    let acc = '';
+    for (let i = 0; i <= params.length; i++) {
+      const ch = i < params.length ? params.charAt(i) : ';';
+      if (ch >= '0' && ch <= '9') {
+        acc += ch;
+      } else {
+        nums.push(acc === '' ? -1 : parseInt(acc));
+        acc = '';
+      }
+    }
+    const p0 = nums.length > 0 ? nums[0] : -1;
+    const p1 = nums.length > 1 ? nums[1] : -1;
+    const def1 = (v: number): number => (v < 0 ? 1 : v);
+    if (final === 'A') { this.cy = Math.max(0, this.cy - def1(p0)); }
+    else if (final === 'B') { this.cy = Math.min(this.h - 1, this.cy + def1(p0)); }
+    else if (final === 'C') { this.cx = Math.min(this.w - 1, this.cx + def1(p0)); }
+    else if (final === 'D') { this.cx = Math.max(0, this.cx - def1(p0)); }
+    else if (final === 'H' || final === 'f') {
+      this.cy = Math.min(this.h - 1, Math.max(0, def1(p0) - 1));
+      this.cx = Math.min(this.w - 1, Math.max(0, def1(p1) - 1));
+    } else if (final === 'K') {
+      const mode = p0 < 0 ? 0 : p0;
+      const from = mode === 2 ? 0 : this.cx;
+      for (let x = from; x < this.w; x++) {
+        if (mode === 1 ? x <= this.cx : true) this.grid[this.cy][x] = ' ';
+      }
+    } else if (final === 'J') {
+      const mode = p0 < 0 ? 0 : p0;
+      if (mode === 2) { this.clearAll(); }
+      else if (mode === 0) {
+        for (let x = this.cx; x < this.w; x++) this.grid[this.cy][x] = ' ';
+        for (let y = this.cy + 1; y < this.h; y++) this.grid[y] = this.blankRow();
+      }
+    } else if (final === 'G') { this.cx = Math.min(this.w - 1, Math.max(0, def1(p0) - 1)); }
+    else if (final === 'd') { this.cy = Math.min(this.h - 1, Math.max(0, def1(p0) - 1)); }
+    // m/h/l/r/n/c 等对纯文本渲染无影响，忽略
+  }
+
+  feed(s: string): void {
+    let i = 0;
+    while (i < s.length) {
+      const ch = s.charAt(i);
+      if (ch === '\x1b') {
+        if (i + 1 >= s.length) break;
+        const nxt = s.charAt(i + 1);
+        if (nxt === '[') {
+          let j = i + 2;
+          let params = '';
+          while (j < s.length && ((s.charAt(j) >= '0' && s.charAt(j) <= '9') || s.charAt(j) === ';' || s.charAt(j) === '?')) {
+            params += s.charAt(j);
+            j++;
+          }
+          if (j >= s.length) break;
+          this.csi(params.replace(/\?/g, ''), s.charAt(j));
+          i = j + 1;
+          continue;
+        }
+        if (nxt === ']') {  // OSC：吞到 BEL 或 ST
+          let j = i + 2;
+          while (j < s.length && s.charAt(j) !== '\x07' && !(s.charAt(j) === '\x1b' && j + 1 < s.length && s.charAt(j + 1) === '\\')) j++;
+          i = j + (j < s.length ? 1 : 0);
+          continue;
+        }
+        if (nxt === '(' || nxt === ')') { i += 3; continue; }  // charset 指定：吞 1 字节
+        i += 2;  // 其余两字节转义（=、>、7、8…）忽略
+        continue;
+      }
+      if (ch === '\r') { this.cx = 0; }
+      else if (ch === '\n') { this.newline(); }
+      else if (ch === '\b') { this.cx = Math.max(0, this.cx - 1); }
+      else if (ch === '\x07') { /* BEL 忽略 */ }
+      else if (ch >= ' ') { this.put(ch); }
+      i++;
+    }
+    this.cursorX = this.cx;
+    this.cursorY = this.cy;
+  }
+
+  displayLines(): string[] {
+    const out: string[] = [];
+    for (let r = 0; r < this.h; r++) {
+      out.push(this.grid[r].join(''));
+    }
+    return out;
+  }
+}
+
+@Entry
+@Component
+struct Index {
+  @State message: string = '(TAP 未运行)';
+  @State ptySummary: string = '(PTY 未运行)';
+  @State termRows: string[] = [];
+  @State cursorInfo: string = '';
+
+  private runOnce(): void {
+    try {
+      const ctx = this.getUIContext().getHostContext() as common.UIAbilityContext;
+      this.message = demo.runTool(ctx.filesDir);
+    } catch (e) {
+      this.message = 'runTool 失败: ' + JSON.stringify(e);
+    }
+  }
+
+  private runPtyOnce(): void {
+    try {
+      const ctx = this.getUIContext().getHostContext() as common.UIAbilityContext;
+      this.ptySummary = demo.runPty(ctx.filesDir);
+      const rawPath = ctx.filesDir + '/pty-raw.log';
+      const raw = fs.readTextSync(rawPath);
+      const screen = new VtScreen(80, 24);
+      screen.feed(raw);
+      this.termRows = screen.displayLines();
+      this.cursorInfo = `cursor=(${screen.cursorX},${screen.cursorY}) raw=${raw.length}B`;
+    } catch (e) {
+      this.ptySummary = 'runPty 失败: ' + JSON.stringify(e);
+    }
+  }
+
+  aboutToAppear(): void {
+    this.runOnce();
+    this.runPtyOnce();
+  }
+
+  build() {
+    Column({ space: 8 }) {
+      Text('__APPNAME__ · 终端上屏验证（PTY 宿主 + VT 渲染面）')
+        .fontSize(16)
+        .fontWeight(FontWeight.Bold)
+      Text(this.ptySummary).fontSize(11)
+      Text(this.cursorInfo).fontSize(11)
+      // 终端渲染面：PTY 捕获流重放后的 80×24 屏幕（上屏证据 = verify-demo 截图）
+      Column() {
+        ForEach(this.termRows, (row: string, idx: number) => {
+          Text(row.length === 0 ? ' ' : row)
+            .fontSize(9)
+            .fontFamily('monospace')
+            .fontColor(Color.White)
+            .textAlign(TextAlign.Start)
+            .width('100%')
+        }, (row: string, idx: number) => `${idx}-${row}`)
+      }
+      .backgroundColor(Color.Black)
+      .padding(6)
+      .border({ width: 1, color: Color.Gray })
+      .width('100%')
+      .layoutWeight(1)
+      Scroll() {
+        Text(this.message)
+          .fontSize(11)
+          .fontFamily('monospace')
+          .textAlign(TextAlign.Start)
+      }
+      .layoutWeight(1)
+      Row({ space: 8 }) {
+        Button('重跑 TAP').onClick(() => this.runOnce())
+        Button('重跑 PTY 上屏').onClick(() => this.runPtyOnce())
+      }
+    }
+    .width('100%')
+    .height('100%')
+    .padding(12)
+  }
+}

package/node_modules/@ohos-agent/pc-adapter/templates/hap/cpp-terminal-demo/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/cpp-terminal-demo/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/cpp-terminal-demo/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/cpp-terminal-demo/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/cpp-terminal-demo/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/cpp-terminal-demo/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/cpp-terminal-demo/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/cpp-terminal-demo/scripts/build-hap.sh

@@ -0,0 +1,215 @@
+#!/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__-term-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/bin/__TOOL__"
+# TOOL_VERSION：HNP 包版本号（随便填一个语义版本即可，只影响设备上的落地目录名）
+TOOL_VERSION="1.0.0"
+# __DRIVER__：PTY 交互 driver（链被验证库，stdin 读键 / stdout 写渲染输出，见模板 README「写你的 driver」）
+# EXTRA_BIN：同一 HNP 包里要一起带上的其它可执行/数据文件（可留空）
+EXTRA_BIN=("dist/bin/__DRIVER__")
+# HAP_LIBS：driver 链接的适配产物 .so（它的 NEEDED 依赖）——必须随 HAP 分发到
+# /data/storage/el1/bundle/libs/arm64/，否则 execv 后动态链接失败 rc=127
+#（实证坑 2026-09-07：HNP 只装 bin/share，**不装 .so**；HNP 包里放 .so 是错的，就放 HAP libs）
+HAP_LIBS=("dist/lib/<你的适配产物>.so")
+# ===========================================================================
+
+: "${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_BIN[@]+"${EXTRA_BIN[@]}"}; do
+        [[ "$extra" = /* ]] || extra="$WORKSPACE/$extra"
+        cp "$extra" "$pkg/bin/"
+    done
+    printf '{"type":"hnp-config","name":"__TOOL__","version":"%s","install":{}}\n' "$TOOL_VERSION" > "$pkg/hnp.json"
+
+    rm -f "$HNP_DIR/__TOOL__.hnp"
+    local hnpcli="$DEVECO_SDK_HOME/default/openharmony/toolchains/hnpcli"
+    if [[ -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_py; then
+        : # python 打包成功
+    elif pack_hnp_node; then
+        : # node 打包成功
+    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:
+    dirs = set()
+    for base, _, names in os.walk(pkg):
+        rel_dir = os.path.relpath(base, hnp_dir).replace(os.sep, '/')
+        parts = rel_dir.split('/')
+        for i in range(1, len(parts) + 1):
+            dirs.add('/'.join(parts[:i]) + '/')
+        for n in names:
+            full = os.path.join(base, n)
+            rel = os.path.relpath(full, hnp_dir).replace(os.sep, '/')
+            zi = zipfile.ZipInfo(rel)
+            zi.external_attr = (0o100667 << 16)
+            zi.compress_type = zipfile.ZIP_DEFLATED
+            with open(full, 'rb') as f:
+                z.writestr(zi, f.read())
+    for d in sorted(dirs):
+        z.writestr(zipfile.ZipInfo(d), '')
+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"
+    # driver 的 NEEDED .so 随 HAP libs 分发（execv 出的子进程不继承 HAP 进程已加载的库，
+    # 动态链接只认 /data/storage/el1/bundle/libs/arm64/ 里的文件——缺失即 rc=127）
+    local libdir="$DEMO_DIR/entry/libs/arm64-v8a"
+    mkdir -p "$libdir"
+    local l
+    for l in ${HAP_LIBS[@]+"${HAP_LIBS[@]}"}; do
+        [[ "$l" = /* ]] || l="$WORKSPACE/$l"
+        [[ -f "$l" ]] || { echo "[ERROR] HAP_LIBS 文件不存在: $l"; exit 1; }
+        cp -f "$l" "$libdir/"
+    done
+    echo "[OK] HAP libs staged: $(ls "$libdir" | tr '\n' ' ')"
+}
+
+build_hap() {
+    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 unzip -l "$HAP" | grep -q '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/"
+        (cd "$stage" && zip -q -r "$HAP" hnp/)
+        rm -rf "$stage"
+        echo "[OK] injected hnp/arm64-v8a/__TOOL__.hnp"
+    fi
+
+    mkdir -p "$DIST_DIR"
+    cp "$HAP" "$DIST_DIR/__TOOL__-term-unsigned.hap"
+    unzip -l "$DIST_DIR/__TOOL__-term-unsigned.hap" | grep -E 'hnp/|lib__XCOMP__' || true
+    echo "[OK] HAP: $DIST_DIR/__TOOL__-term-unsigned.hap"
+    echo "     下一步: ohpt sign-demo -w \"$WORKSPACE\" --demo-dir __OUT__ --hap dist/app/__TOOL__-term-unsigned.hap --install"
+}
+
+pack_hnp
+stage_hnp
+build_hap

package/node_modules/@ohos-agent/pc-adapter/templates/hap/electron-app/toolchain-manifest.json

@@ -0,0 +1,17 @@
+{
+  "schema_version": 1,
+  "repo": "https://gitcode.com/OhosAgent/static-resource",
+  "description": "Electron-OH 运行时发布包清单：引擎别名 → 远端目录级引用（electron/v34、electron/v37……）。目录内恰 1 个 release zip，小版本浮动自动跟随——本清单不钉工件文件名/URL/sha256，那些在 fetch 时从 gitcode 目录清单现场解析（blob sha 内容寻址）。下载与校验由 `ohpt-agent fetch-electron-toolchain --engine <别名>` 执行。",
+  "engines": {
+    "v34.8.5": {
+      "dir": "electron/v34",
+      "node": "20.18",
+      "chromium": "132"
+    },
+    "v37.2.3": {
+      "dir": "electron/v37",
+      "node": "22.16",
+      "chromium": "138"
+    }
+  }
+}

package/node_modules/@ohos-agent/pc-adapter/templates/hap/electron-app/v34.8.5/AppScope/app.json5

@@ -0,0 +1,15 @@
+{
+  "app": {
+    "bundleName": "com.example.helloelectron",
+    "vendor": "example",
+    "versionCode": 1000000,
+    "versionName": "1.0.0",
+    "icon": "$media:app_icon",
+    "label": "$string:app_name",
+    "configuration": "$profile:configuration",
+    "multiAppMode": {
+      "multiAppModeType": "multiInstance",
+      "maxCount": 1
+    }
+  }
+}

package/node_modules/@ohos-agent/pc-adapter/templates/hap/electron-app/v34.8.5/AppScope/resources/base/element/string.json

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

package/node_modules/@ohos-agent/pc-adapter/templates/hap/electron-app/v34.8.5/AppScope/resources/base/profile/configuration.json

@@ -0,0 +1,6 @@
+{
+  "configuration": {
+    "fontSizeScale": "followSystem",
+    "fontSizeMaxScale": "1.45"
+  }
+}

package/node_modules/@ohos-agent/pc-adapter/templates/hap/electron-app/v34.8.5/build-profile.json5

@@ -0,0 +1,44 @@
+{
+  "app": {
+    "products": [
+      {
+        "name": "default",
+        "signingConfig": "default",
+        "compatibleSdkVersion": "6.0.0(20)",
+        "compatibleSdkVersionStage": "release",
+        "runtimeOS": "HarmonyOS",
+        "buildOption": {
+          "nativeLib": {
+            "collectAllLibs": true
+          }
+        }
+      }
+    ],
+    "buildModeSet": [
+      {
+        "name": "debug",
+      },
+      {
+        "name": "release"
+      }
+    ]
+  },
+  "modules": [
+    {
+      "name": "electron",
+      "srcPath": "./electron",
+      "targets": [
+        {
+          "name": "default",
+          "applyToProducts": [
+            "default"
+          ]
+        }
+      ]
+    },
+    {
+      "name": "web_engine",
+      "srcPath": "./web_engine"
+    }
+  ]
+}