上游是 Kotlin 2.4.0 / Gradle 9.1.0 / AGP 9.0.1。wrapper 降 8.14.1、AGP 整体剥离、Kotlin 钉。同时删除上游的（Gradle 9 专属的 daemon 工具链文件，8.14.1 下反而会触发 foojay 下载），里的 foojay resolver 插件一并移除，JDK 21 走JAVA_HOME。google()上游 shared（

上游 hyphen（commonMain = 引擎 + Compose UI 混居）→ 源码集切分：不 import compose 的留下（引擎 10 文件），UI 隔离 composeMain→ 三处手工微调（剥注解 / 纯函数归位 / 公共入口）→ 工具链对齐 HarmonyOS Kotlin 2.2.21-1.0.0 + Gradle 8.14.1（qrose 组合）→ 根构建替换（cmp

上游 combo-breaker（几何内核 + Android 排版层 + Compose UI）→ 拆源码集：commonMain（算法）/ composeMain（归档）→ 工具链对齐 Kotlin 2.2.21-1.0.0 / Gradle 8.14.1（含镜像 init 脚本双坑）→ ohosArm64 / ohosX64 KLIB + 双 ABI 动态库→ 桥内文本度量引擎（TTF 解析

本仓核心是"逻辑搬移"的纯 Kotlin，不依赖任何 kotlinx 制品线，因此沿用社区早期批准的钉法：HarmonyOS Kotlin（qrose / haze 同款）。这条线的要求是 Gradle 8.14.1——上游 wrapper 是 9.7.0，必须替换；钉与（KN 分发从 Maven 取，本机~/.konan已有 2.2.21-1.0.0 预编译与 ohos sysroot 缓存，离

社区早期钉法是 HarmonyOS Kotlin（qrose 用），multiplatform-settings 因为不引 coroutines 也停留在这条线。但依赖Kotlin 钉（orbit-mvi / SimpleMVI / krogress 同款验证组合）。Gradle 侧与 KStore 不同：上游因 KT-55751 把 wrapper 钉死 7.6.1（注释原文 “can’t up

与 KStore 同款结论:coroutines的 stdlib 元数据是 2.4.20,旧钉法 Kotlin(qrose / haze 用的)编译期直接报。Kotlin 钉。上游源码本来就是 Kotlin 2.4.0 编的,2.4.20 同代,源码级兼容成本为零;Gradle 9.6.1 上游 wrapper 原样沿用,不像 2.2.21 旧线必须降 8.14.1。google()// depe

上游纯 Kotlin 内核（spec/navargs/result/utils）→ 独立 example 构建 + ohosArm64/ohosX64 Kotlin/Native→ ArkTS JSON 解析→ ArkUI 四 Tab 真机页面。

RouteComposer (Swift, 151 文件)→ 六大实体协议 + Any*/Box 类型擦除（ArkTS 接口 + 包装类）→ DefaultRouter 三阶段引擎（逐语义移植）→ 逻辑屏幕树（UIKit 容器 → RootHost/TabsHost/NavHost/ModalHost）→ 九个 Action 平台落地（NavPathStack / Tabs / 覆盖层）→ Ark