expo-harmony-toolkit 1.7.2 → 1.8.0

package/docs/roadmap.md

@@ -2,18 +2,19 @@
 
 ## 收官定义
 
-这个项目的“完美落幕”不再定义为“一次性完美支持任意 Expo 项目”。
+这个项目的终局重新定义为：
 
-新的收官定义是：
+- 所有 Expo project types 与 package categories，最终都进入同一条 `mainline capability catalog`
+- `v2.0.0` 本身就要接近最完美、最最终的交付形态，而不是“还差最后一段 extension”
+- 公开承诺仍然按 evidence gate 逐步放开，而不是因为目标扩大就提前放宽 `latest`
+- `latest` 继续只承接完整验收的 `verified`
+- `next` 继续承接 fast track，用来加速收敛，但不伪装成 `verified`
 
-- 在 `Managed/CNG Expo` 主线下，主流官方 Expo 能力可稳定分析、可 bundle、可 debug/release 验证、可交付
-- `latest` 只承诺已经完成完整验收的 `verified` 能力
-- 长尾第三方 native module 不再挤进同一条公开承诺，而是进入 `extension model`
+这意味着：
 
-因此，路线会分成两段：
-
-- `Core Expo Coverage`：主线收官点
-- `Long-tail Extension`：收官后的持续扩展模型
+- `Managed/CNG` 仍是当前最成熟的已验证输入
+- bare workflow、高频第三方 native packages、长尾第三方依赖，不再被定义成“收官后才考虑的另一条扩展路线”
+- 它们会被逐步拉回同一条公开主线，只是进入主线的时间点和 evidence gate 不同
 
 ## 已完成里程碑
 
@@ -59,77 +60,171 @@
 - `expo-location`、`expo-camera` 进入 `preview`
 - Batch A+B preview capability 进入统一 sample / fixture / 文档 / 验收模型
 - 形成 `doctor -> sync-template -> bundle -> build-hap --mode debug` 的 preview onboarding baseline
-- 公开结论保持保守：可接入，不等于已 verified
+- `doctor` 增加 `buildabilityRisk`
+- 文档生成链收口到 marker block + renderer source data
 
 ## 当前主线
 
-### v1.8 Capability Graduation + Fast Track Release
+### v1.8.0 Intake Hardening + Parallel Promotion
 
 目标日期：`2026-05-15`
 
-目标：优先把“已经接入的 preview 能力”推进到可晋升状态，而不是只继续堆新模块数量。
+目标：先把“任何 Expo 项目都能被正确分类并拿到下一步”做硬，再把现有 preview 能力和主线阻塞项并行推进。
+
+- `doctor` 增加：
+  - `coverageProfile`
+  - `gapCategory`
+  - `nextActions`
+- 先把任意项目分进四类：
+  - `managed-core`
+  - `managed-native-heavy`
+  - `bare`
+  - `third-party-native-heavy`
+- 四项 preview capability 进入同一个 graduation board：
+  - `expo-file-system`
+  - `expo-image-picker`
+  - `expo-location`
+  - `expo-camera`
+- `react-native-gesture-handler` 从“矩阵外模糊探索”拉回主线：
+  - 必须可被 `doctor` 明确识别
+  - 必须有独立 fixture
+  - 必须有独立 sample / build / test coverage
+  - 来不及 verified 也不能继续停留在灰区
+- sample 策略升级成双层：
+  - combined smoke
+  - per-capability acceptance
+
+### v1.8.x Capability Board Closeout
+
+目标日期：`2026-06-15`
+
+目标：把 v1.8.0 建好的 intake + promotion 架子收口到可持续执行的证据节奏。
+
+- 每个 preview capability 必须单独维护：
+  - bundle evidence
+  - debug build evidence
+  - device acceptance record
+  - release acceptance record
+- combined sample 只负责回归烟测，不再替代单 capability 证据
+- `toolkit-config.json`、`doctor-report.json`、roadmap、support matrix、acceptance board 保持同源同步
+- `latest` 仍不承接任何证据未闭环的 capability
+
+### v1.9.0 Bare Workflow Baseline + App Foundation Modules
+
+目标日期：`2026-08-31`
+
+目标：先把 bare workflow 拉进主线，并补齐最容易卡死真实项目的官方基础模块。
+
+- bare workflow 正式进入主线里程碑
+- 优先补齐：
+  - `expo-secure-store`
+  - `expo-asset`
+  - `expo-device`
+  - `expo-clipboard`
+  - `expo-haptics`
+- 高频第三方 native dependencies 开始进入同一 capability catalog
+- 对每个新能力继续坚持：
+  - fixture
+  - sample route
+  - doctor
+  - sync-template
+  - bundle
+  - debug build
+  - acceptance 记录
+
+### v1.9.1 Third-party Native Wave A
+
+目标日期：`2026-09-30`
+
+目标：优先清掉最容易挡住“任何 Expo 项目”的高频第三方 native blocker。
+
+- 第一批高频第三方 native blocker 进入正式 onboarding：
+  - `react-native-gesture-handler`
+  - `react-native-safe-area-context`
+  - `react-native-screens`
+  - `@react-native-async-storage/async-storage`
+- 建立第三方 native capability onboarding checklist：
+  - catalog entry
+  - shim / adapter strategy
+  - doctor diagnostics
+  - sample / fixture
+  - debug + release evidence
+- 任何进入 Wave A 的 blocker，都不允许继续停留在“矩阵外模糊探索”
+
+### v1.9.2 Third-party Native Wave B + Regression Farm
+
+目标日期：`2026-10-31`
 
-- 建立 capability graduation 流水线：
-  `doctor --strict`、`doctor --target-tier preview`、`sync-template`、`bundle`、`build-hap --mode debug`、device acceptance、release acceptance
-- `DoctorReport`、`toolkit-config.json`、support matrix 全部引入 `runtimeMode` 与 `evidence`
-- `expo-file-system`、`expo-image-picker` 优先冲刺 verified 所需的真 runtime 与 device 证据
-- `expo-location`、`expo-camera` 从 throw-only shim 推进到可验证的 adapter-backed preview
-- 发布节奏改成双轨：
-  `latest` 只承接完整验收的 verified 能力，`next` 承接 preview fast track
+目标：扩大第三方 native 覆盖，并建立“任何 Expo 项目”目标需要的持续回归面。
 
-### v1.9 App Foundation Modules
+- 第二批高频第三方 native 依赖进入主线
+- 引入 project-shape regression farm：
+  - managed core
+  - managed native heavy
+  - bare
+  - third-party native heavy
+- 至少维护一组“未知项目导入 -> doctor 分类 -> nextActions -> sample/build gate”的持续回归案例
+- 继续收口 preview capability 的 release evidence，尽量减少 `v2.0.0` 前的残留灰区
 
-目标日期：`2026-07-31`
+### v1.10.0 Any-project Intake Freeze
 
-目标：优先补齐最能解锁真实 Managed/CNG Expo 项目的基础官方模块。
+目标日期：`2026-11-15`
 
-- 依序接入：`expo-secure-store`、`expo-device`、`expo-asset`、`expo-clipboard`、`expo-haptics`
-- 每个能力都必须同时具备：
-  fixture、sample route、doctor、sync-template、bundle、debug build、acceptance 记录
-- 完成 `expo-location`、`expo-camera` verified 晋升
-- 如果某项能力无法在同版晋升，则必须明确记录阻塞点与缺失证据，而不是模糊停留
+目标：先冻结“任何 Expo 项目”入口面的产品故事，确保不存在无法分类、无法给下一步、无法明确阻断原因的项目。
 
-### v2.0 Managed/CNG Core Expo Coverage
+- `doctor` 对任意 Expo 项目必须满足：
+  - 能分类
+  - 能指出 blocker 属于官方模块、bare workflow、还是第三方 native gap
+  - 能输出有顺序的 remediation actions
+- roadmap / support matrix / acceptance board 与实际 catalog 保持零漂移
+- 对外叙事从“更多项目开始进入主线”升级成“任何项目都有明确处理路径”
 
-目标日期：`2026-10-31`
+### v1.11.0 Final Blocker Burn-down
 
-定义：在单一 `verified` runtime matrix 下，把主流 `Managed/CNG Expo` 生产项目推进到完整可用、可构建、可交付。
+目标日期：`2026-11-30`
 
-- 官方高频 Expo 能力覆盖达到可交付水平
-- `latest` 只包含完整验收能力
-- release readiness 路径完整闭环
-- roadmap 对外叙事从“sample 可跑”升级为“核心 Managed/CNG Expo 项目可稳定交付”
+目标：把还会阻止“任何 Expo 项目可靠打包”的剩余高频 blocker 清到只剩极少数明确已知例外。
 
-这是最早可以对外宣告“主目标收官”的时间点。
+- 逐项清掉剩余高频 blocker：
+  - adapter 不稳定
+  - bare workflow release gap
+  - 高频第三方 native 缺失 release evidence
+  - 自动生成 sidecar 与真实项目 drift
+- 对仍无法在 `v2.0.0` 前关闭的项，必须提前明确降级策略与替代路径
+- `v2.0.0` 不接受“先宣布完成，再慢慢补长尾”
 
-### v2.x Long-tail Native Module Extension
+### v2.0.0 Any Expo Project Reliable Packaging
 
-目标日期：`2027-03-31` 前启动
+目标日期：`2026-12-31`
 
-目标：把“任何 Expo 项目都能打包成鸿蒙 APP”从内建承诺，转成有边界、可扩展、可持续维护的 extension model。
+定义：任何 Expo 项目，只要依赖已经存在于主线 capability catalog 内，就能可靠打包成鸿蒙 App；`v2.0.0` 本身就是基本接近最完美、最最终的形态。
 
-- 引入第三方 native module extension / onboarding 模型
-- 建立 capability registry、adapter、fixture、acceptance 规范
-- 把未知或未验证第三方包从“公开承诺”切换为“显式扩展”
-- 不对未验证长尾模块提前给出正式可用声明
+- 不再只覆盖“主流项目”，而是把“任何 Expo 项目都能可靠打包成鸿蒙 App”作为正式版本定义
+- `Managed/CNG` 与 bare workflow 都必须进入稳定交付路径
+- 高频官方 Expo 模块与高频第三方 native blockers 必须已经进入同一公开 capability catalog
+- `doctor -> sync-template -> bundle -> build-hap --mode debug|release` 必须对主线 catalog 内项目形成稳定闭环
+- 只允许极少数、明确列名、已有替代策略的已知例外存在；不允许存在大类空白地带
 
 ## 长期方向
 
-- 先做到 `Managed/CNG Core Expo Coverage`
-- 再通过 `Long-tail Native Module Extension` 逼近“任意 Expo 项目”
-- 推进速度依赖 `next` 快速收敛反馈，但公开承诺继续由 `latest` 控制
+- 所有输入最终都进入同一个 `mainline capability catalog`
+- `v2.0.0` 就是“任何 Expo 项目可靠打包成鸿蒙 App”的正式目标版本
+- `latest` 只由完整验收能力驱动
+- `next` 用来加速收敛主线 backlog，而不是制造伪 verified 叙事
+- roadmap 的关键问题不再是“要不要把某类项目算进主线”，而是“它何时进入主线、当前缺哪格 evidence、下一步怎么 unblock”
 
 ## 路线约束
 
-- `v2.0` 前继续坚持单一 verified runtime matrix
-- `v2.0` 前不把 bare Expo 拉进主线，只保留 `Managed/CNG`
+- 当前公开 `verified` runtime matrix 仍然只有 `expo55-rnoh082-ui-stack`
 - `doctor --strict` 继续只代表 `verified`
-- `latest` 只承诺完整验收的 `verified` 能力
+- `latest` 只承诺完整验收的 `verified`
 - `next` 可以承接 preview fast track，但不得伪装成 verified
+- 没有 fixture、sample、文档、构建证据、人工验收记录的能力，不得晋升到 `verified`
 - roadmap、support matrix、README、acceptance 记录必须在同一 PR 同步更新
-- 没有 sample、fixture、文档、构建证据、人工验收记录的能力，不得晋升到 `verified`
+- 目标扩大不等于当前对外承诺扩大；任何公开边界放宽都必须先有证据闭环
 
 ## 风险与顺延条件
 
-- 收官前提是从 `2026-03-31` 起持续具备 Harmony 模拟器或真机验证条件，并保持周级别验收节奏
-- 如果 Expo SDK / RNOH 在 `2026-05-15` 前发生大矩阵漂移，`v2.0` 收官点应顺延到 `2026-12-31` 左右
+- 继续依赖 Harmony 模拟器或真机的稳定验证条件
+- 继续依赖周级别的 acceptance 节奏，而不是只做 sample 展示
+- 如果 Expo SDK / RNOH 在 `2026-05-15` 前发生较大矩阵漂移，`v1.8.x` 收口和 `v2.0.0` 时间点都需要相应顺延

package/docs/signing-and-release.md

@@ -27,6 +27,7 @@ expo-harmony env
 
 - `debug` 构建仍可继续做本地验证
 - `release` 构建不应视为 ready
+- 可以直接从 `.expo-harmony/signing.local.example.json` 复制出 `.expo-harmony/signing.local.json` 再填入真实材料
 
 ## 推荐流程
 
@@ -40,6 +41,8 @@ expo-harmony build-hap --mode debug
 ### Release 验证
 
 ```bash
+cp .expo-harmony/signing.local.example.json .expo-harmony/signing.local.json
+$EDITOR .expo-harmony/signing.local.json
 expo-harmony env
 expo-harmony build-hap --mode release
 ```

package/docs/support-matrix.md

@@ -1,10 +1,19 @@
-# v1.7 支持矩阵
+# v1.8 支持矩阵
 
-`v1.7` 继续采用 tiered support model，但从现在开始把“层级”与“晋升距离”拆开表达：
+`v1.8` 继续采用 tiered support model，但从现在开始把“层级”与“晋升距离”拆开表达：
 
 - `supportTier` 表示公开承诺层级
 - `runtimeMode` 表示当前运行时接入形态：`shim`、`adapter`、`verified`
 - `evidence` 表示距离 verified 还缺哪些证据格
+- `evidenceSource` 表示每个证据格来自自动化、人工记录，还是当前无证据
+- `coverageProfile` 表示当前项目属于哪条主线输入形态
+- `nextActions` 表示 toolkit 为当前项目生成的有序下一步
+
+同时，`v1.8.x` 的 roadmap 已经改成单一 `mainline capability catalog` 方向：
+
+- bare workflow 与第三方 native package 不再被描述成“收官后才考虑的另一条 extension 终局”
+- `v2.0.0` 本身被定义成“任何 Expo 项目都能可靠打包成鸿蒙 App”的目标版本
+- 但当前公开承诺依旧没有放宽；它们只是进入同一主线 backlog，而不是已经进入 `verified`
 
 `doctor --strict` 继续只代表 `verified`。
 
@@ -12,6 +21,7 @@
 
 唯一 `verified` 矩阵仍是 `expo55-rnoh082-ui-stack`。
 
+<!-- GENERATED:support-matrix-verified-matrix:start -->
 | 项目 | 要求 |
 | --- | --- |
 | Expo SDK | `55` |
@@ -21,9 +31,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 +47,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,31 +80,40 @@
 - `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` 文档额外使用以下标记：
+为了避免把“只差真机”与“当前子 API 还没实现到位”混在一起，`v1.8.x` 文档额外使用以下标记：
 
 - `🟡 可用待晋升`：当前子集已经有可信实现，样例和模拟器路径可用；下一步主要缺真机 / release 证据
 - `⛔ 完全不支持`：能力仍在 catalog 外，或根本不在当前公开承诺范围
 
 ## 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`
+- `v1.8.x` 开始，combined sample smoke 只负责总回归；每项 capability 还必须单独维护 device / release acceptance 记录，见 [acceptance/v1.8.x-capability-board.md](../acceptance/v1.8.x-capability-board.md)
 - `expo-file-system`
   - `🟡` 当前主路径是 UTF-8/base64 sandbox I/O、append/partial read、`getInfoAsync({ md5: true })` 与 `downloadAsync`
 - `expo-image-picker`
@@ -107,6 +132,7 @@
 
 ## UI Stack 配对规则
 
+<!-- GENERATED:support-matrix-ui-stack:start -->
 canonical 包与 Harmony adapter 包固定为双向强制：
 
 - `react-native-reanimated` ↔ `@react-native-oh-tpl/react-native-reanimated`
@@ -123,6 +149,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,11 +174,22 @@ 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`
+- `coverageProfile`
+- `dependencies[].gapCategory`
+- `nextActions[]`
 
 判读方式：
 
 - 任一 `evidence.* = false`，表示晋升到 verified 前仍缺证据
+- `evidenceSource.device = manual-doc`，表示该证据来自人工验收记录，不应被表述成自动化设备验证
 - `runtimeMode !== verified`，表示即使已有部分证据，也仍不属于正式承诺
+- `coverageProfile=bare`，表示当前项目已落入 bare workflow 主线规划，但不等于当前 matrix 已正式支持 bare
+- `gapCategory=third-party-native-gap`，表示问题不应再被模糊描述成普通 matrix drift，而是主线 blocker
+- `nextActions[]` 的顺序即 toolkit 当前建议的处理顺序
 
 当前公开阻断 issue code 继续包括：
 
@@ -184,13 +222,15 @@ 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`
+- `toolkit-config.json` 也会记录当前项目的 `coverageProfile` 与有序 `nextActions`
 - verified UI stack 依赖继续走现有 autolinking + `.har` 管理逻辑
 
 ## Release Tracks
 
 从 `v1.8` 开始，发布节奏按双轨设计：
 
+<!-- GENERATED:support-matrix-release-tracks:start -->
 - `latest`
   - 只承接完整验收的 `verified` 能力
   - 只允许 verified sample / gate 作为发布依据
@@ -198,6 +238,7 @@ toolkit 受管的核心产物仍包括：
   - 承接 preview fast track
   - 必须至少通过 preview sample、bundle、debug build gate
   - 不得被描述为 verified 或 release-ready
+<!-- GENERATED:support-matrix-release-tracks:end -->
 
 ## Capability Promotion Gate
 
@@ -211,8 +252,13 @@ toolkit 受管的核心产物仍包括：
 - release signing / release HAP 验收完成
 - 文档、矩阵、roadmap、acceptance 记录同 PR 更新
 
-## 当前不在短期输入范围
+## 当前仍未进入正式公开承诺
 
 - bare Expo
 - 多 Expo / RNOH 并行 verified 矩阵
 - 任意第三方 native package 的即时正式承诺
+
+说明：
+
+- 上述项目并没有从 roadmap 消失；它们会逐步进入同一条主线 capability catalog
+- 这份 support matrix 只记录当前已经公开验证到哪一步，而不是未来愿景本身

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-harmony-toolkit",
-  "version": "1.7.2",
+  "version": "1.8.0",
   "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"