expo-harmony-toolkit 1.7.2 → 1.7.3

package/docs/support-matrix.md

@@ -5,6 +5,7 @@
 - `supportTier` 表示公开承诺层级
 - `runtimeMode` 表示当前运行时接入形态：`shim`、`adapter`、`verified`
 - `evidence` 表示距离 verified 还缺哪些证据格
+- `evidenceSource` 表示每个证据格来自自动化、人工记录，还是当前无证据
 
 `doctor --strict` 继续只代表 `verified`。
 
@@ -12,6 +13,7 @@
 
 唯一 `verified` 矩阵仍是 `expo55-rnoh082-ui-stack`。
 
+<!-- GENERATED:support-matrix-verified-matrix:start -->
 | 项目 | 要求 |
 | --- | --- |
 | Expo SDK | `55` |
@@ -21,9 +23,10 @@
 | `@react-native-oh/react-native-harmony-cli` | `0.82.18` |
 | `@react-native-community/cli` | `20.x` |
 | `metro` | `0.83.x` |
-| App Shell 依赖 | `expo-router` `6.x`、`expo-linking` `55.x`、`expo-constants` `55.x` |
+| App Shell 依赖 | `expo-router` `55.x`、`expo-linking` `55.x`、`expo-constants` `55.x`、`@expo/metro-runtime` `55.x`、`react-dom` `19.1.1` |
 | UI stack 依赖 | `react-native-reanimated` `3.6.0`、`react-native-svg` `15.0.0` |
 | 原生标识 | 至少设置 `android.package` 或 `ios.bundleIdentifier` |
+<!-- GENERATED:support-matrix-verified-matrix:end -->
 
 ## Support Tiers
 
@@ -36,26 +39,31 @@
 
 ## Verified Allowlist
 
+<!-- GENERATED:support-matrix-verified-allowlist:start -->
 - `expo`
+- `@expo/metro-runtime`
 - `expo-constants`
 - `expo-linking`
 - `expo-router`
 - `react`
+- `react-dom`
 - `react-native`
 - `expo-status-bar`
 - `@babel/runtime`
 - `@react-native-community/cli`
 - `metro`
-- `expo-harmony-toolkit`
 - `@react-native-oh/react-native-harmony`
 - `@react-native-oh/react-native-harmony-cli`
+- `expo-harmony-toolkit`
 - `react-native-reanimated`
-- `react-native-svg`
 - `@react-native-oh-tpl/react-native-reanimated`
+- `react-native-svg`
 - `@react-native-oh-tpl/react-native-svg`
+<!-- GENERATED:support-matrix-verified-allowlist:end -->
 
 ## Capability Telemetry
 
+<!-- GENERATED:support-matrix-capability-telemetry:start -->
 所有 capability 从现在开始都同时公开：
 
 - `supportTier`
@@ -64,12 +72,17 @@
 - `evidence.debugBuild`
 - `evidence.device`
 - `evidence.release`
+- `evidenceSource.bundle`
+- `evidenceSource.debugBuild`
+- `evidenceSource.device`
+- `evidenceSource.release`
 
 判读规则：
 
 - `runtimeMode=shim`：说明当前还在桥接或占位阶段，即使 bundle / debug build 已完成，也不应宣称 verified
 - `runtimeMode=adapter`：说明已经进入真实适配路径，但仍缺少某些验收证据
 - `runtimeMode=verified`：说明能力已进入正式承诺，且证据闭环完成
+<!-- GENERATED:support-matrix-capability-telemetry:end -->
 
 为了避免把“只差真机”与“当前子 API 还没实现到位”混在一起，`v1.7.x` 文档额外使用以下标记：
 
@@ -78,17 +91,20 @@
 
 ## Preview 能力
 
+<!-- GENERATED:support-matrix-preview-capabilities:start -->
 | Expo 能力 | 当前层级 | runtimeMode | evidence | Harmony 依赖方向 | 受管权限 | 官方 sample route |
 | --- | --- | --- | --- | --- | --- | --- |
-| `expo-file-system` | `preview` | `adapter` | `bundle=yes, debugBuild=yes, device=yes, release=no` | toolkit-managed sandbox file adapter | 无新增必需权限 | `/file-system` |
-| `expo-image-picker` | `preview` | `adapter` | `bundle=yes, debugBuild=yes, device=yes, release=no` | toolkit-managed Harmony media picker adapter | `ohos.permission.CAMERA`、`ohos.permission.MICROPHONE`、`ohos.permission.READ_IMAGEVIDEO` | `/image-picker` |
-| `expo-location` | `preview` | `adapter` | `bundle=yes, debugBuild=yes, device=yes, release=no` | toolkit-managed `@ohos.geoLocationManager` TurboModule | `ohos.permission.LOCATION`、`ohos.permission.APPROXIMATELY_LOCATION`、`ohos.permission.LOCATION_IN_BACKGROUND`、`ohos.permission.ACCELEROMETER` | `/location` |
-| `expo-camera` | `preview` | `adapter` | `bundle=yes, debugBuild=yes, device=yes, release=no` | toolkit-managed embedded camera preview + control TurboModule | `ohos.permission.CAMERA`、`ohos.permission.MICROPHONE` | `/camera` |
+| `expo-file-system` | `preview` | `adapter` | `bundle=yes[automated], debugBuild=yes[automated], device=yes[manual-doc], release=no[none]` | react-native-fs | 无新增必需权限 | `/file-system` |
+| `expo-image-picker` | `preview` | `adapter` | `bundle=yes[automated], debugBuild=yes[automated], device=yes[manual-doc], release=no[none]` | react-native-image-picker, react-native-permissions | ohos.permission.CAMERA、ohos.permission.MICROPHONE、ohos.permission.READ_IMAGEVIDEO | `/image-picker` |
+| `expo-location` | `preview` | `adapter` | `bundle=yes[automated], debugBuild=yes[automated], device=yes[manual-doc], release=no[none]` | @react-native-community/geolocation, react-native-permissions | ohos.permission.LOCATION、ohos.permission.APPROXIMATELY_LOCATION、ohos.permission.LOCATION_IN_BACKGROUND、ohos.permission.ACCELEROMETER | `/location` |
+| `expo-camera` | `preview` | `adapter` | `bundle=yes[automated], debugBuild=yes[automated], device=yes[manual-doc], release=no[none]` | react-native-camera-kit, react-native-permissions | ohos.permission.CAMERA、ohos.permission.MICROPHONE | `/camera` |
+<!-- GENERATED:support-matrix-preview-capabilities:end -->
 
 说明：
 
 - 当前四项 preview capability 都已经完成 preview baseline 的 bundle / debug build / route walkthrough
-- 四项 preview capability 都已经进入 `adapter` 路径；`device=yes` 只表示已有样例侧与运行时路径证据，仍不代表 verified 或 release-ready
+- 四项 preview capability 都已经进入 `adapter` 路径；`device=yes[manual-doc]` 只表示已有人工设备验收记录，仍不代表 verified 或 release-ready
+- 当前 preview baseline 的默认 evidenceSource 固定为：`bundle/debugBuild=automated`、`device=manual-doc`、`release=none`
 - `expo-file-system`
   - `🟡` 当前主路径是 UTF-8/base64 sandbox I/O、append/partial read、`getInfoAsync({ md5: true })` 与 `downloadAsync`
 - `expo-image-picker`
@@ -107,6 +123,7 @@
 
 ## UI Stack 配对规则
 
+<!-- GENERATED:support-matrix-ui-stack:start -->
 canonical 包与 Harmony adapter 包固定为双向强制：
 
 - `react-native-reanimated` ↔ `@react-native-oh-tpl/react-native-reanimated`
@@ -123,6 +140,7 @@ canonical 包与 Harmony adapter 包固定为双向强制：
 
 - `@react-native-oh-tpl/react-native-reanimated`: `github:react-native-oh-library/react-native-harmony-reanimated#9fdbe676209937383907be0592291223c6ca7ad7&path:react-native-harmony-reanimated`
 - `@react-native-oh-tpl/react-native-svg`: `github:react-native-oh-library/react-native-harmony-svg#97c31d2f72559931d62fa84a9c86e86d343753d3&path:react-native-harmony-svg`
+<!-- GENERATED:support-matrix-ui-stack:end -->
 
 ## `doctor`
 
@@ -147,10 +165,15 @@ expo-harmony doctor --project-root /path/to/app --target-tier preview
 - `capabilities[].evidence.debugBuild`
 - `capabilities[].evidence.device`
 - `capabilities[].evidence.release`
+- `capabilities[].evidenceSource.bundle`
+- `capabilities[].evidenceSource.debugBuild`
+- `capabilities[].evidenceSource.device`
+- `capabilities[].evidenceSource.release`
 
 判读方式：
 
 - 任一 `evidence.* = false`，表示晋升到 verified 前仍缺证据
+- `evidenceSource.device = manual-doc`，表示该证据来自人工验收记录，不应被表述成自动化设备验证
 - `runtimeMode !== verified`，表示即使已有部分证据，也仍不属于正式承诺
 
 当前公开阻断 issue code 继续包括：
@@ -184,13 +207,14 @@ toolkit 受管的核心产物仍包括：
 
 - `entry/src/main/module.json5` 的 `requestPermissions` 由 toolkit 根据已启用能力自动补齐
 - preview / experimental 能力的 Metro import path 通过 `.expo-harmony/shims/<package>` 接管
-- `toolkit-config.json` 会记录 capability 的 `runtimeMode` 与 `evidence`
+- `toolkit-config.json` 会记录 capability 的 `runtimeMode`、`evidence` 与 `evidenceSource`
 - verified UI stack 依赖继续走现有 autolinking + `.har` 管理逻辑
 
 ## Release Tracks
 
 从 `v1.8` 开始，发布节奏按双轨设计：
 
+<!-- GENERATED:support-matrix-release-tracks:start -->
 - `latest`
   - 只承接完整验收的 `verified` 能力
   - 只允许 verified sample / gate 作为发布依据
@@ -198,6 +222,7 @@ toolkit 受管的核心产物仍包括：
   - 承接 preview fast track
   - 必须至少通过 preview sample、bundle、debug build gate
   - 不得被描述为 verified 或 release-ready
+<!-- GENERATED:support-matrix-release-tracks:end -->
 
 ## Capability Promotion Gate
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-harmony-toolkit",
-  "version": "1.7.2",
+  "version": "1.7.3",
   "description": "面向 Managed/CNG Expo 项目的 HarmonyOS 迁移、准入检查与 UI-stack 构建工具链",
   "main": "app.plugin.js",
   "types": "build/index.d.ts",
@@ -23,12 +23,21 @@
     "README.md",
     "README.en.md",
     "LICENSE",
-    "docs"
+    "docs/cli-build.md",
+    "docs/npm-release.md",
+    "docs/official-app-shell-sample.md",
+    "docs/official-minimal-sample.md",
+    "docs/official-native-capabilities-sample.md",
+    "docs/official-ui-stack-sample.md",
+    "docs/roadmap.md",
+    "docs/signing-and-release.md",
+    "docs/support-matrix.md"
   ],
   "scripts": {
-    "build": "tsc --project tsconfig.json",
+    "build": "rm -rf build && tsc --project tsconfig.json",
     "clean": "rm -rf build coverage",
-    "pack:check": "npm pack --dry-run",
+    "docs:sync": "node ./scripts/update-generated-docs.js",
+    "pack:check": "node ./scripts/pack.js --dry-run --json",
     "release:check": "node ./scripts/release-check.js",
     "test": "jest --runInBand",
     "prepare": "pnpm build"
@@ -77,7 +86,6 @@
     "@types/jest": "^30.0.0",
     "@types/node": "^24.5.2",
     "@types/semver": "^7.7.1",
-    "expo": "^55.0.8",
     "jest": "^30.2.0",
     "ts-jest": "^29.4.4",
     "typescript": "^5.9.2"

package/docs/v1.5.1-acceptance.md

@@ -1,385 +0,0 @@
-# v1.5.1 验收记录
-
-日期：2026-03-27
-
-基线：
-
-- 仓库：`Expo-Harmony-Toolkit`
-- tag：`v1.5.1`
-- commit：`1a51b0c10f08f5228c2918da3d7722d29c8be95b`
-
-## 结论
-
-这次 `v1.5.1` 收尾验收只完成了部分目标。
-
-- 已确认 npm 包与 Git tag 对齐，`official-ui-stack-sample` 的 `doctor -> init -> sync-template -> bundle -> env` 链路可跑通。
-- `Build Debug Hap(s)` 仍未通过。阻塞点已经从本地工具链缺失与 `ohpm` 无法安装 `.har`，收敛到 ArkTS 编译阶段的 adapter / RNOH 不匹配。
-- 因为没有产出可安装的 debug HAP，所以本次未完成设备侧 SVG、gesture 动画、动画后路由跳转的最终人工运行时验收。
-- npm 已发布 README 的原文内容可读性正常；npm 网页端的实时渲染未能在本次自动化环境中完成最终可视确认。
-
-## 环境
-
-- macOS `26.3` (`25D125`)
-- Node `v20.19.6`
-- pnpm `10.32.1`
-- npm `10.8.2`
-- DevEco Studio：`/Applications/DevEco-Studio.app`
-- Harmony SDK：`/Applications/DevEco-Studio.app/Contents/sdk`
-- Java：`/usr/bin/java`
-- ohpm：`/Applications/DevEco-Studio.app/Contents/tools/ohpm/bin/ohpm`
-- hvigor：`/Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw.js`
-- hdc：`/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc`
-- 在线目标：`127.0.0.1:5555`
-
-## 命令结果
-
-### 1. Sample 安装
-
-执行：
-
-```bash
-cd examples/official-ui-stack-sample
-pnpm install --ignore-scripts
-```
-
-结果：
-
-- 成功。
-- 继续沿用当前仓库推荐的 `--ignore-scripts` 安装方式。
-
-### 2. CLI 验证
-
-执行：
-
-```bash
-pnpm run harmony:doctor:strict
-pnpm run harmony:init
-pnpm run harmony:sync-template
-pnpm run harmony:bundle
-pnpm run harmony:env
-```
-
-结果：
-
-- `doctor --strict`：通过，矩阵识别为 `expo55-rnoh082-ui-stack`。
-- `init`：通过。
-- `sync-template`：通过。
-- `bundle`：初次失败，报 `Cannot find module 'babel-preset-expo'`；修正 sample Babel 解析后复跑通过。
-- `env`：`ready`，本机可定位 DevEco / SDK / ohpm / hvigor / hdc；`signingConfigs` 仍为空，只影响 release HAP，不阻塞 debug 验证。
-
-### 3. Debug HAP 构建
-
-执行：
-
-```bash
-pnpm run harmony:build:debug
-```
-
-结果：
-
-- 未通过。
-- 问题拆成了两个阶段：
-
-1. 初始失败点
-
-- `ohpm install` 无法直接安装 npm 包内分发的本地 `*.har`。
-- 原因是这些 `*.har` 实际上是带 `package/` 前缀的 tarball，`ohpm` 本地安装时期望根目录直接存在 `oh-package.json5`。
-
-2. 修正后失败点
-
-- toolkit 现在会在 `build-hap` 前先把本地 `*.har` 规范化展开到 `harmony/.expo-harmony/ohpm-local-deps/`，`ohpm install` 随后可通过。
-- `hvigor assembleHap` 继续失败，进入 ArkTS 编译阶段后出现 adapter / RNOH 接口不匹配。
-- 关键现象：
-  - `@react-native-oh-tpl/react-native-gesture-handler` 当前包内 `oh-package.json5` 依赖的是 `@rnoh/react-native-openharmony: ^0.72.32`
-  - 本仓库公开矩阵固定的是 `@react-native-oh/react-native-harmony@0.82.18`
-  - 编译错误集中在 `RNGestureHandlerButton.ts`、`RNGestureHandlerRootView.ts`、`RNGestureHandlerModule.ts` 与 `RNOHPackagesFactory.ets`
-
-当前判断：
-
-- `Build Debug Hap(s)` 的最终阻塞已经不是本机环境问题，而是当前公开 matrix 下 UI-stack adapter 与 RNOH 运行时的兼容性问题。
-
-## 运行时人工验收结论
-
-已完成：
-
-- `open -a /Applications/DevEco-Studio.app examples/official-ui-stack-sample/harmony` 成功。
-- `hdc list targets` 能列出 `127.0.0.1:5555`。
-
-未完成：
-
-- 首页启动
-- `Constants.expoConfig?.name` 显示
-- SVG 圆环渲染
-- gesture 触发位移 / 旋转 / 回弹
-- `/details` 路由跳转与返回
-- 动画后路由仍正常
-
-原因：
-
-- 没有可安装的 debug HAP 产物，无法继续设备侧运行时验收。
-
-## npm README 检查
-
-### 已确认
-
-通过：
-
-```bash
-npm view expo-harmony-toolkit readme --json
-```
-
-检查到当前已发布 README 原文中包含：
-
-- 顶部徽章
-- 相对链接
-- 中英文跳转链接
-- fenced code blocks
-
-静态内容层面没有发现 README 被 npm 发布流程截断或丢失关键区块。
-
-### 未完成
-
-未能完成 npm 网页端的实时可视验收。
-
-阻塞：
-
-- 直接自动抓取 npmjs 页面受限。
-- 试图补装 Playwright 浏览器 runtime 时，`npx playwright install chrome` 因 npm registry `ECONNRESET` 失败。
-
-因此本次对 npm README 的最终结论是：
-
-- 已发布内容原文正常。
-- 网页端实际渲染仍待后续在网络正常的浏览器环境中补一次可视确认。
-
-## 本次为验收补的修正
-
-- [examples/official-ui-stack-sample/babel.config.js](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/examples/official-ui-stack-sample/babel.config.js)
-  - 显式通过 Expo 包根目录解析 `babel-preset-expo`
-  - 同时加入 `expo-router/babel`
-  - 解决 pnpm workspace 下 `bundle` 无法解析 Babel preset 的问题
-- [src/core/build.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/src/core/build.ts)
-  - 在 `build-hap` 前把 tarball 形态的本地 `*.har` 展开成 `ohpm` 可安装目录
-  - 构建后恢复生成的 `oh-package.json5`，避免工作区残留临时 specifier
-- [templates/harmony/entry/src/main/cpp/CMakeLists.txt](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/templates/harmony/entry/src/main/cpp/CMakeLists.txt)
-  - 增加 `.expo-harmony/ohpm-local-deps` 的 RNOH C++ 源码回退查找
-- [tests/build.test.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/tests/build.test.ts)
-  - 补了本地 HAR 规范化与恢复逻辑的测试
-
-## 证据
-
-- `pnpm test`：`10` 个 suite，`40` 个测试全部通过
-- `pnpm build`：通过
-- `hdc list targets`：返回 `127.0.0.1:5555`
-- `doctor --strict`：识别为 `expo55-rnoh082-ui-stack`，`18 supported, 0 manual, 0 unknown`
-- `build-hap --mode debug`：已推进到 ArkTS 编译阶段，但最终失败，说明本机 DevEco / SDK / hvigor / ohpm 已真正参与构建
-
-## 对 v1.5.1 的最终状态判断
-
-- `doctor / init / sync-template / bundle / env`：可用
-- `official-ui-stack-sample` runtime 手动验收：未完成
-- `Build Debug Hap(s)`：未通过
-- npm README 已发布原文：正常
-- npm README live page 可视验收：待补
-
-## 追加进展（2026-03-27 晚间）
-
-这轮继续补验收后，`Build Debug Hap(s)` 已经打通，但设备侧人工验收仍未完成。
-
-### 新增验证结果
-
-执行：
-
-```bash
-pnpm build
-pnpm test -- --runInBand tests/build.test.ts tests/init.test.ts tests/officialUiStackSample.test.ts
-cd examples/official-ui-stack-sample
-pnpm run harmony:build:debug
-```
-
-结果：
-
-- `pnpm build`：通过。
-- 定向测试：`3` 个 suite、`15` 个测试全部通过。
-- `build-hap --mode debug`：通过，已产出：
-
-```text
-examples/official-ui-stack-sample/harmony/entry/build/default/outputs/default/entry-default-unsigned.hap
-```
-
-### 为打通 Debug HAP 新补的修正
-
-- [src/core/template.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/src/core/template.ts)
-  - 将 autolinking 生成物与 `ts.ts` shim 标记为 build-required managed files
-  - `build-hap` 前会强制刷新这些生成文件，但不会顺带覆盖其他用户可漂移模板
-- [src/core/build.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/src/core/build.ts)
-  - `bundleProject()` 改为在构建前强制同步 build-required managed files
-  - 对规范化后的本地 gesture-handler HAR 增加 `react/renderer/debug/SystraceSection.h -> <cxxreact/SystraceSection.h>` 兼容 shim
-- [templates/harmony/entry/hvigorfile.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/templates/harmony/entry/hvigorfile.ts)
-  - 显式设置 `autolinking: null`
-  - 禁用 hvigor 二次 autolinking，避免其用旧模板回写 `RNOHPackagesFactory.h`
-- [tests/build.test.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/tests/build.test.ts)
-  - 增补 build-required managed files 强制刷新测试
-  - 增补 gesture-handler Systrace shim 测试
-- [tests/init.test.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/tests/init.test.ts)
-  - 断言生成的 `harmony/entry/hvigorfile.ts` 含 `autolinking: null`
-
-### 设备侧仍未完成的原因
-
-这次已经不再是 HAP 构建阻塞，而是当前本机模拟器实例不可用。
-
-- `hdc list targets -v`：当前返回 `[Empty]`
-- DevEco Emulator CLI 可列出实例名：`Enjoy 90 Pro Max`
-- 该实例目录存在：`/Users/blackishgreen03/.Huawei/Emulator/deployed/Enjoy 90 Pro Max`
-- 但当前系统进程中没有活跃的 emulator/qemu guest，无法安装 HAP
-- 实例日志显示最近一次 guest 在 `2026-03-27 18:49` 出现 `Guest no response` / `hdc is abnormal`
-- 随后在 `2026-03-27 19:04` 尝试重新拉起时，又出现 `can not read uuid file` / `can not read sn`
-
-因此当前未完成项变成：
-
-- `hdc install -r entry-default-unsigned.hap`
-- `aa start` 拉起 `com.blackishgreen.expoharmonyuistack/EntryAbility`
-- 首页、SVG、gesture、reanimated、路由跳转的最终人工运行时验收
-
-### 对当前状态的更新判断
-
-- `doctor / init / sync-template / bundle / env`：可用
-- `Build Debug Hap(s)`：已通过
-- `official-ui-stack-sample` runtime 手动验收：仍待补
-- 当前阻塞：模拟器实例健康状态 / `hdc` target 缺失，而非 toolkit 构建链路
-
-## 设备侧补验收（2026-03-30 下午）
-
-这轮在同一台机器上继续补了模拟器侧验收，结论是：`build/install/start` 链路现在都已经真正打通，但 `official-ui-stack-sample` 仍未达到可验首页状态，最新阻塞已经从 native 构建前移到 JS runtime 兼容层。
-
-### 新增验证结果
-
-执行：
-
-```bash
-pnpm build
-pnpm test -- --runInBand tests/build.test.ts
-cd examples/official-ui-stack-sample
-pnpm exec tsc --noEmit
-pnpm run harmony:build:debug
-/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc list targets -v
-/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc install -r harmony/entry/build/default/outputs/default/entry-default-unsigned.hap
-/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc shell aa start -a EntryAbility -b com.blackishgreen.expoharmonyuistack
-```
-
-结果：
-
-- `pnpm build`：通过。
-- `tests/build.test.ts`：`1` 个 suite、`13` 个测试全部通过。
-- sample `tsc --noEmit`：通过。
-- `build-hap --mode debug`：通过，持续产出 `entry-default-unsigned.hap`。
-- `hdc list targets -v`：返回 `127.0.0.1:5555 TCP Connected localhost`。
-- `hdc install -r entry-default-unsigned.hap`：通过，返回 `install bundle successfully`。
-- `aa start -a EntryAbility -b com.blackishgreen.expoharmonyuistack`：通过，返回 `start ability successfully`。
-
-### 新增运行时结论
-
-- 之前 sample 中直接引用 `react-native-reanimated/lib/module/reanimated2` 深路径会在模拟器上红屏，现已改回从 `react-native-reanimated` 包入口导入，旧的模块解析红屏已消失。
-- 覆盖安装完成后单独重新拉起应用，进程可以稳定存活，不再是安装期把 Ability 顶掉。
-- 但当前前台画面仍是白屏，尚未进入可人工点击验收的首页。
-
-本次从 `hilog` 抓到的关键运行时错误包括：
-
-- `Invariant Violation: Looks like you're passing a function component "BaseImage" to createAnimatedComponent`
-- `Error: Incompatible React versions`
-- 日志明确显示：
-  - `react: 19.2.0`
-  - `react-native-renderer: 19.1.1`
-
-### 对阻塞点的最新判断
-
-- 当前已确认不是 `hdc` target、安装、Ability 拉起、ArkTS/C++ 编译、也不是深路径 `reanimated2` 模块解析问题。
-- 当前阻塞已经收敛为 JS runtime 侧的版本窗/adapter 兼容问题：
-  - 公开矩阵当前宣称的是 `Expo 55 + React 19.2.x + React Native 0.83.x + @react-native-oh/react-native-harmony 0.82.18`
-  - 但本机实际安装的 `@react-native-oh/react-native-harmony@0.82.18` `peerDependencies.react-native` 仍明确要求 `0.82.1`
-  - 设备侧运行日志也与这条不匹配相吻合
-
-因此截至 `2026-03-30 15:42 CST` 的最新结论变为：
-
-- `doctor / init / sync-template / bundle / env`：可用
-- `Build Debug Hap(s)`：可用
-- `hdc install`：可用
-- `aa start`：可用
-- `official-ui-stack-sample` runtime 手动验收：仍未通过
-- 当前阻塞：`react` / `react-native` / `@react-native-oh/react-native-harmony` / reanimated 组合在设备侧的 JS runtime 兼容性，而非 toolkit 构建链路本身
-
-## 最终收口（2026-03-30 18:05 CST）
-
-这轮没有继续维持一个“文档里支持 gesture，设备上却跑不通”的公开矩阵，而是把 `expo55-rnoh082-ui-stack` 收口到当前真实可运行的窗口：
-
-- 保留：`expo-router`、`expo-linking`、`expo-constants`、`react-native-reanimated`、`react-native-svg`
-- 移出公开矩阵：`react-native-gesture-handler`
-- `gesture-handler` 继续保留为矩阵外的手动探索项，不再作为 `doctor --strict` 通过条件，也不再作为官方 sample 的运行时承诺
-
-### 本轮补的修正
-
-- [src/data/uiStack.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/src/data/uiStack.ts)
-  - 从 `UI_STACK_VALIDATED_ADAPTERS` 移除 `react-native-gesture-handler`
-- [src/data/dependencyCatalog.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/src/data/dependencyCatalog.ts)
-  - 将 `gesture-handler` 及其 Harmony adapter 调整为矩阵外 `manual` 状态
-- [examples/official-ui-stack-sample/package.json](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/examples/official-ui-stack-sample/package.json)
-  - 移除 `react-native-gesture-handler` 与 `@react-native-oh-tpl/react-native-gesture-handler`
-- [examples/official-ui-stack-sample/app/_layout.tsx](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/examples/official-ui-stack-sample/app/_layout.tsx)
-  - 移除 `GestureHandlerRootView`
-- [examples/official-ui-stack-sample/app/index.tsx](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/examples/official-ui-stack-sample/app/index.tsx)
-  - 将首页交互改成纯 `react-native` `Pressable` + `react-native-reanimated` 的 spring rail
-- [examples/official-ui-stack-sample/app/details.tsx](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/examples/official-ui-stack-sample/app/details.tsx)
-  - 文案改为当前真实验证项
-- [README.md](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/README.md)、[README.en.md](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/README.en.md)、[docs/support-matrix.md](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/docs/support-matrix.md)
-  - 将公开矩阵、sample 说明和 release gate 同步到真实版本窗
-
-### 重新执行的验证
-
-执行：
-
-```bash
-pnpm install --ignore-scripts
-pnpm exec jest tests/doctor.test.ts tests/officialUiStackSample.test.ts tests/docs.test.ts --runInBand
-pnpm build
-
-cd examples/official-ui-stack-sample
-pnpm run harmony:doctor:strict
-pnpm run harmony:init
-pnpm run harmony:sync-template
-pnpm run harmony:bundle
-pnpm run harmony:env
-pnpm run harmony:build:debug
-/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc install -r harmony/entry/build/default/outputs/default/entry-default-unsigned.hap
-/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc shell aa start -a EntryAbility -b com.blackishgreen.expoharmonyuistack
-/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc shell aa start -a EntryAbility -b com.blackishgreen.expoharmonyuistack -U expoharmonyuistack://details
-```
-
-结果：
-
-- 定向 Jest：`3` 个 suite、`20` 个测试全部通过
-- `pnpm build`：通过
-- `doctor --strict`：通过，sample 当前为 `16 supported, 0 manual, 0 unknown`
-- `init / sync-template / bundle / env / build-hap --mode debug`：全部通过
-- `hdc install -r`：通过，返回 `install bundle successfully`
-- `aa start`：通过，返回 `start ability successfully`
-- `aa dump --all`：确认 `com.blackishgreen.expoharmonyuistack` 处于 `FOREGROUND`
-- `hilog`：已出现 `JS bundle executed successfully`，未再出现此前的 `gesture-handler` / reanimated runtime fatal
-
-### 设备侧证据
-
-- 首页截图：
-  [official-ui-stack-sample-home-reset.jpeg](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/.tmp-acceptance/official-ui-stack-sample-home-reset.jpeg)
-- `/details` 路由截图：
-  [official-ui-stack-sample-deeplink.jpeg](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/.tmp-acceptance/official-ui-stack-sample-deeplink.jpeg)
-
-当前观察到的设备侧状态：
-
-- 首页能正常显示标题、SVG、`Constants.expoConfig?.name`、`Linking.createURL('/details')`
-- `/details` 页面可通过 scheme deep link 进入并稳定显示
-- 调试环境下仍会出现 Dev Menu websocket / packager 重连日志，这不是当前 sample 运行阻塞
-
-### 对 `v1.5.1` 的最终状态改判
-
-- 公开矩阵：已修正到真实可运行版本窗
-- `doctor / init / sync-template / bundle / env / build-hap / install / start`：可用
-- 官方 UI-stack sample：可在当前模拟器上正常显示首页与 `/details`
-- 设备侧剩余未纳入公开承诺的项：`react-native-gesture-handler`