@ohos-cpf/3rdloop 0.0.1

package/vendor/Server/Skills/rn-library-consistency-check/SKILL.md

@@ -0,0 +1,299 @@
+---
+name: rn-library-consistency-check
+description: 对 RN 三方库的鸿蒙化代码进行一致性检视，对比 source/ohos/ 下的鸿蒙化实现与 source/RN/ 下 Android/iOS 原生模块的函数级实现一致性，检测方法缺失、Stub 实现、参数类型致命错误、返回值异常、TurboModule/NAPI 桥接不一致、原生组件 Props/Commands/事件不一致、Props副作用&关联影响不一致、非rawProps属性默认值不一致等问题，生成严苛评分报告（0-100分）。作为 RN 仓库检视流程的第三阶段，依赖稳定性检视和接口规格文档。Use when 需要对 RN 鸿蒙化库进行实现一致性检视或评估鸿蒙化完成度。
+license: Apache-2.0
+compatibility: 需要访问双仓库源码（ohos + RN 上游）、对比鸿蒙化与 Android/iOS 原生实现
+metadata:
+  version: "1.0.0"
+---
+
+# RNLibraryConsistencyCheckSkill
+
+对 RN 三方库的**鸿蒙化实现代码**进行一致性检视，对比 `source/ohos/` 中的鸿蒙化实现与 `source/RN/` 中 Android/iOS 原生模块的实现。按四类型（`cppComp`/`cppTM`/`arktsComp`/`arktsTM`）分类检视：组件类检查 Props/Command/Methods/Callback/Lifecycle 五个关键点 + Props副作用&关联影响 + 非rawProps属性默认值；TurboModule 类检查函数签名/返回值/实现逻辑三个关键点。每个检查点均要求与 Android/iOS 做行为级对比，**最关键检查项为实现逻辑一致性**。扣分按四维度路由，副作用&关联影响、非rawProps默认值采用条件路由（有文档且合理→维度4，其余→维度2）。
+
+> ⚠️ **核心定位与原则**：
+> 1. 本 SKILL 同时使用**两个仓库**的源码：`source/ohos/`（鸿蒙化）和 `source/RN/`（上游原库）
+> 2. **一致性对比必须以具体函数为粒度**，禁止使用模糊文字描述（如"连接管理"）
+> 3. 每个对比项必须包含：函数名、签名、文件位置、代码片段
+> 4. 检视范围仅限鸿蒙化代码 vs 原库 Android/iOS 原生实现
+
+---
+
+## 任务参数
+
+| 参数 | 必需 | 说明 |
+|------|------|------|
+| `repoUrl` | ✅ | 鸿蒙化仓库地址 |
+| `outputDir` | ✅ | 输出目录绝对路径 |
+| `interfaceDocPath` | ✅ | 接口规格说明文档路径 |
+| `repoName` | ✅ | 仓库名称 |
+
+---
+
+## 输入依赖
+
+本 SKILL 是 RN 仓库检视流程的**第三阶段**，依赖：
+
+- **前置 SKILL**: `rn-library-interface-check`、`rn-library-stability-check`
+- **输入文件**: `接口规格说明.md`、`稳定性检视报告.md`
+- **仓库源码**: `{outputDir}/source/ohos/`（鸿蒙化）+ `{outputDir}/source/RN/`（原库）
+
+---
+
+## 工作流程概览
+
+```
+Phase 0: 鸿蒙代码智能定位与范围识别（四类型 cppComp/cppTM/arktsComp/arktsTM）
+    ↓
+Phase 1: cppComp 检视（C++ 组件层）— Props/Command/Methods/Callback/Lifecycle
+    ↓
+Phase 2: cppTM 检视（C++ TurboModule 层）— 函数签名/返回值/实现逻辑
+    ↓
+Phase 3: arktsComp 检视（ArkTS @Component 层）— Props/Command/Methods/Callback/Lifecycle
+    ↓
+Phase 4: arktsTM 检视（ArkTS TurboModule 层）— 函数签名/返回值/实现逻辑 ⚠️最关键
+    ↓
+Phase 5: 其他架构检视 — NAPI桥接/NativeModule架构/平台差异记录
+    ↓
+Phase 6: 严苛评分计算 — 四维度加权扣分制（0-100分）
+    ↓
+Phase 7: 生成报告 — 一致性检视报告.md
+```
+
+> 📖 **详细参考文档索引**（渐进式披露，按需加载）：
+>
+> | 参考文件 | 内容 | 加载时机 |
+> |----------|------|----------|
+> | [references/SCORING_STANDARD.md](references/SCORING_STANDARD.md) | 完整扣分规则、豁免规则、归零规则、维度加权计算 | Phase 6 评分计算时 |
+> | [references/NATIVE_COMPONENT_IDENTIFICATION.md](references/NATIVE_COMPONENT_IDENTIFICATION.md) | 四类型原生实体识别、注册链路定位流程、搜索模式 | Phase 0 代码定位时 |
+> | [references/CPP_COMPONENT_CHECK_GUIDE.md](references/CPP_COMPONENT_CHECK_GUIDE.md) | C++ 组件层检视：Props/Command/Methods/Callback/Lifecycle 检查点详细操作 | Phase 1 执行时 |
+> | [references/CPP_TURBOMODULE_CHECK_GUIDE.md](references/CPP_TURBOMODULE_CHECK_GUIDE.md) | C++ TurboModule 层检视：函数签名/返回值/实现逻辑 详细操作 | Phase 2 执行时 |
+> | [references/ARKTS_COMPONENT_CHECK_GUIDE.md](references/ARKTS_COMPONENT_CHECK_GUIDE.md) | ArkTS @Component 层检视：Props/Command/Methods/Callback/Lifecycle + 副作用&默认值 | Phase 3 执行时 |
+> | [references/ARKTS_TURBOMODULE_CHECK_GUIDE.md](references/ARKTS_TURBOMODULE_CHECK_GUIDE.md) | ArkTS TurboModule 层检视：函数签名/返回值/实现逻辑 + Stub检测 | Phase 4 执行时 |
+> | [references/FUNCTION_COMPARISON_GUIDE.md](references/FUNCTION_COMPARISON_GUIDE.md) | 函数级对比规范：粒度要求、提取流程、对比表格格式、Stub识别特征 | 各Phase对比时 |
+> | [references/CHECKLIST.md](references/CHECKLIST.md) | RN 一致性检视清单：四维度检查项速查表 | 检视过程参考 |
+> | [assets/REPORT_TEMPLATE.md](assets/REPORT_TEMPLATE.md) | 报告输出模板：完整Markdown格式规范 | Phase 7 生成报告时 |
+
+---
+
+## 评分体系摘要
+
+采用**严苛扣分制**（从100分开始扣减），按四维度加权：
+
+| 维度编号 | 维度 | 权重 | 满分 | 核心检查内容 |
+|----------|------|------|------|-------------|
+| 维度1 | API 契约一致性 | 35% | 35 | 方法签名、参数类型、返回值、事件/回调对比 |
+| 维度2 | 平台实现一致性 | 30% | 30 | Android/iOS vs OHOS 函数级功能对比；副作用&默认值（无文档/不合理部分） |
+| 维度3 | RN 架构一致性 | 20% | 20 | TurboModule/NativeModule/NAPI 桥接一致性 |
+| 维度4 | 平台适配合理性 | 15% | 15 | 合理差异判定；副作用&默认值（有文档且合理部分） |
+
+**归零规则**：致命≥4 / 致命≥3+严重≥2 / 累计扣分>60 / 无鸿蒙代码 / 全部Stub → 0分
+
+> 📖 完整扣分规则、豁免规则、条件路由规则、评分等级说明详见 [SCORING_STANDARD.md](references/SCORING_STANDARD.md)
+
+---
+
+## Phase 0：鸿蒙代码智能定位与范围识别
+
+鸿蒙化代码位置**可能不固定**，必须通过智能搜索定位实际实现。
+
+### 0.1 四类型原生桥接实体识别
+
+RN 库的鸿蒙化代码包含四种类型的原生桥接实体，必须分别识别：
+
+| 类型标识 | 全称 | 关键文件特征 |
+|----------|------|-------------|
+| `cppComp` | C++ 组件层 | `*Package.h`、`*JSIBinder.h`、`*NapiBinder.h` |
+| `cppTM` | C++ TurboModule 层 | `*TurboModule*FactoryDelegate*`、`turbo_modules/*JSIBinder.h` |
+| `arktsComp` | ArkTS 组件层 | `@Component struct`、`*EtsProps.ts`、`*EtsCommandPayload.ts` |
+| `arktsTM` | ArkTS TurboModule 层 | `*TurboModule.ets`、`generated/turboModules/*.ts` |
+
+### 0.2 搜索流程
+
+搜索分两步执行：
+
+1. **JS/TS 层扫描与名称提取**：定位 `codegenNativeComponent`（组件注册）和 `TurboModuleRegistry.getEnforcing`（TM注册），提取组件名和TM名清单
+2. **四类桥接层文件识别**：根据名称清单逐一定位各类型的桥接层文件和实现文件
+
+> 📖 详细搜索步骤、关键词模式、提取模板详见 [NATIVE_COMPONENT_IDENTIFICATION.md](references/NATIVE_COMPONENT_IDENTIFICATION.md)
+
+### 0.3 搜索结果判定
+
+| 搜索结果 | 判定 | 下一步 |
+|----------|------|--------|
+| 找到 `*.ets`/`*.cpp`/`*.h`/`@ohos`/NAPI 绑定 | 定位鸿蒙化代码 | 进入对应Phase |
+| 找到 RN 原生组件注册链路 | 按四类型分别定位 | 进入 Phase 1-4 |
+| ❌ 无任何鸿蒙特征 | 未实现鸿蒙化 | **评分 0 分** |
+
+> 💡 RN 库可能同时包含四种类型实体，每种类型独立检视、独立扣分。
+
+### 0.4 检视范围记录
+
+必须在报告中记录实际定位到的鸿蒙代码位置（搜索方法、定位结果、文件数、类型标识）。四类型原生实体定位记录表格式详见 [REPORT_TEMPLATE.md](assets/REPORT_TEMPLATE.md) 第四节。
+
+---
+
+## Phase 1：cppComp 检视（C++ 组件层）
+
+> ⚠️ **适用条件**：Phase 0 中识别到 `cppComp` 类型文件时必须执行。
+> 📖 **完整检视方法**详见 [CPP_COMPONENT_CHECK_GUIDE.md](references/CPP_COMPONENT_CHECK_GUIDE.md) 第 3 节
+
+每个检查点覆盖三个维度：**①契约一致性**、**②平台实现差异**、**③架构桥接一致性**。
+
+| 检查点 | ①契约一致性 | ②平台实现差异 | ③架构桥接一致性 |
+|--------|-------------|---------------|-----------------|
+| **Props** | 传递完整性(-8/个)、类型一致性(-5)、默认值(-4)、NapiBinder桥接(-5) | 实现逻辑一致性(-8~-15)；副作用&关联影响(条件路由) | 全链路断桥检测(JS→C++→ArkTS→build()) |
+| **Command** | 注册完整性(-8)、签名一致性(-8/-15) | 实现逻辑一致性(-10~-15)、边界处理(-8) | （已覆盖） |
+| **Methods** | 组件名一致性(-5) | N/A | Package注册(-8)、JSIBinder映射(-8) |
+| **Callback** | 事件注册(-5)、事件名映射(-5)、数据格式(-6) | 回调触发时机一致性(-8) | C++事件名→OHOS映射(-5) |
+| **Lifecycle** | N/A | 构造逻辑(-5)、析构逻辑(-5) | （已覆盖） |
+
+---
+
+## Phase 2：cppTM 检视（C++ TurboModule 层）
+
+> ⚠️ **适用条件**：Phase 0 中识别到 `cppTM` 类型文件时必须执行。
+> 📖 **完整检视方法**详见 [CPP_TURBOMODULE_CHECK_GUIDE.md](references/CPP_TURBOMODULE_CHECK_GUIDE.md) 第 3 节
+
+| 检查点 | ①契约一致性 | ②平台实现差异 | ③架构桥接一致性 |
+|--------|-------------|---------------|-----------------|
+| **函数签名** | TM名一致性(-5)、方法名(-8)、方法存在性(-10)、参数数量(-8)、参数类型(-10)、参数顺序(-6) | 方法签名vs Android/iOS | TurboModule注册完整性(-10) |
+| **返回值** | 返回值类型(-10)、语义(-8)、Promise(-6)、getConstants()(-5) | 返回值vs Android/iOS | （已覆盖） |
+| **实现逻辑** | N/A | C++→ArkTS映射(-8)、回调绑定(-8)、回调参数类型(-10) | （已覆盖） |
+
+---
+
+## Phase 3：arktsComp 检视（ArkTS @Component 层）
+
+> ⚠️ **适用条件**：Phase 0 中识别到 `arktsComp` 类型文件时必须执行。
+> 📖 **完整检视方法**详见 [ARKTS_COMPONENT_CHECK_GUIDE.md](references/ARKTS_COMPONENT_CHECK_GUIDE.md) 第 3 节
+
+**⚠️ 前置过滤规则**：检视前先检查 JS/TS Spec 注册的 Component 名是否在 ArkTS Package 中注册。未注册 → 致命-15 + ⛔跳过该组件内部逐项检查。
+
+| 检查点 | ①契约一致性 | ②平台实现差异 | ③架构桥接一致性 |
+|--------|-------------|---------------|-----------------|
+| **Props** | rawProps读取完整性(-5/-3)、类型断言(-4)、默认值(-4)、build()断桥(-5/-3) | 实现逻辑一致性(-8~-15)；副作用&关联影响(条件路由)；非rawProps默认值(-12/-8) | （已覆盖） |
+| **Command** | 注册完整性(-15)、签名(-8)、参数类型(-15)、fall-through(-10) | 实现逻辑一致性(-10~-15)、边界处理(-8) | （已覆盖） |
+| **Methods** | 组件名注册一致性(-5) | N/A | （已覆盖） |
+| **Callback** | Events emit完整性(-8)、Payload完整性(-3/字段) | 回调触发时机一致性(-8) | （已覆盖） |
+| **Lifecycle** | N/A | aboutToAppear(-5)、aboutToDisappear(-5) | （已覆盖） |
+
+---
+
+## Phase 4：arktsTM 检视（ArkTS TurboModule 层）
+
+> ⚠️ **适用条件**：Phase 0 中识别到 `arktsTM` 类型文件时必须执行。
+> 📖 **完整检视方法**详见 [ARKTS_TURBOMODULE_CHECK_GUIDE.md](references/ARKTS_TURBOMODULE_CHECK_GUIDE.md) 第 3 节
+
+**⚠️ 前置过滤规则**：检视前先检查 JS/TS Spec 注册的 TurboModule 名是否在 ArkTS Factory 中注册。未注册 → 致命-15 + ⛔跳过该TM内部方法逐项检查。
+
+**Stub 识别特征**：方法体仅有 `return` 固定值；未调用 `@ohos` API；未执行实际业务操作。
+
+| 检查点 | ①契约一致性 | ②平台实现差异 | ③架构桥接一致性 |
+|--------|-------------|---------------|-----------------|
+| **函数签名** | NAME常量(-5)、Spec接口实现(-8)、方法存在性(-15)、签名(-8)、参数类型(-10)、参数顺序(-6) | 方法签名vs Android/iOS | （已覆盖） |
+| **返回值** | 返回值类型(-10)、语义(-8)、Promise(-6)、常量导出(-5)、常量值(-3) | 返回值vs Android/iOS | （已覆盖） |
+| **实现逻辑 ⚠️最关键** | N/A | Stub检测(致命-8/合理0)、方法行为跨平台对比(致命-15/严重-12)、边界处理(-8)、错误处理(-6) | 回调/事件机制(-12) |
+
+---
+
+## Phase 5：其他架构检视（如适用）
+
+### 5.1 NAPI/C++ 桥接层一致性（适用于含 C++ Native 层但非 RN 新架构的库）
+
+| 检查项 | 对比对象 | 扣分 |
+|--------|----------|------|
+| NAPI 函数注册 | C++ 导出函数 vs JS 期望方法 | -8 |
+| NAPI 类型转换 | napi_value 类型与 JS 期望类型 | -10 |
+| JSI 绑定一致性 | JSI HostFunction vs 原库实现 | -8 |
+
+### 5.2 NativeModule 架构一致性（适用于旧架构库）
+
+| 检查项 | 对比对象 | 扣分 |
+|--------|----------|------|
+| 模块名注册 | Android getName() vs OHOS 模块名 | -5 |
+| 方法导出 | @ReactMethod / RCT_EXPORT_METHOD vs OHOS 导出 | -8 |
+| Promise 处理 | Android/iOS Promise vs OHOS Promise | -6 |
+| Callback 处理 | Android/iOS Callback vs OHOS 回调 | -5 |
+| 事件发送 | Android/iOS sendEvent vs OHOS 事件 | -5 |
+
+### 5.3 平台差异记录
+
+| 检查项 | 检查内容 | 扣分 |
+|--------|----------|------|
+| OHOS 限制标注 | 特有限制是否文档化 | -3 |
+| 平台检测机制 | 是否有 `Platform.OS` 判断 | -2 |
+| 平台差异文档 | 是否有 README 说明差异 | -3 |
+
+---
+
+## Phase 6：严苛评分计算
+
+基于 Phase 1-5 检视结果进行**四维度加权扣分**（0-100分）：
+
+1. 按检查项维度标签将扣分归入对应维度（①→维度1, ②→维度2, ③→维度3）
+2. 副作用&关联影响、非rawProps默认值采用**条件路由**：无文档/不合理→维度2，有文档且合理→维度4
+3. 各维度实际扣分 = min(扣分上限, 累计扣分)
+4. 执行归零检查（致命≥4 / 致命≥3+严重≥2 / 累计>60 / 无代码 / 全Stub）
+5. 最终分 = max(0, 100 - 各维度实际扣分之和)
+
+> 📖 完整扣分规则、条件路由详情、维度扣分来源映射详见 [SCORING_STANDARD.md](references/SCORING_STANDARD.md)
+
+---
+
+## Phase 7：生成报告
+
+输出文件：`{outputDir}/一致性检视报告.md`
+
+> ⚠️ **评分格式要求**：报告必须包含 `**综合评分：XX/100**`（粗体标记，中文冒号），确保 `_parseRNLibraryScore` 函数正确解析。
+
+> ⚠️ **扣分维度标注**：所有检视表格扣分列须标注维度编号，格式 `-X（维度N）`。
+
+> 📖 完整报告结构、表格模板详见 [REPORT_TEMPLATE.md](assets/REPORT_TEMPLATE.md)
+
+---
+
+## 输出产物
+
+| 产物 | 文件名 | 说明 |
+|------|--------|------|
+| 一致性检视报告 | `一致性检视报告.md` | 四类型分类检视 + Props副作用&关联影响分析 + 非rawProps属性默认值对比 + 函数级对比表格 + Stub检测 + 全链路Props对比 + 扣分维度标注 + 平台差异记录 |
+
+所有产物写入 `{outputDir}` 目录。
+
+> ⚠️ **输出文件自检**：写入结果文件前，先确认 `一致性检视报告.md` 已存在且内容完整（**独立文件，禁止只写入 result 执行结果文件**）。若报告内容仅在草稿中，必须先将其保存为上述独立文件。
+
+### 结构化指标输出（必须执行）
+
+执行环境会在任务 prompt 中下发一个**结构化指标文件输出路径**（`stepId{X}_loop{L}_meta_{N}.json`）。
+检视完成后，**必须**将最终评分以下述 JSON 对象写入该路径：
+
+```json
+{
+  "consistencyScore": 85,
+  "scoreReason": "致命问题2处-30，Stub方法1处-8等（一句话判定依据，≤50字；触发一票否决时必须注明）"
+}
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `consistencyScore` | number | 一致性评分（0-100 整数，与报告中 `**综合评分：XX/100**` 的数值一致） |
+| `scoreReason` | string | 评分判定依据摘要（可选，前端悬浮提示展示；0 分时强烈建议写明触发规则，如"全Stub实现触发归零"） |
+
+**说明**：该文件由执行框架自动收割入库（前端/历史列表直接读取评分，无需解析报告文本）。若 prompt 未下发该路径则跳过本节。
+
+---
+
+## 评分权重
+
+本 SKILL 在 RN 仓库检视综合评分中权重为 **20%**。
+
+---
+
+## 与前置/后置 SKILL 的衔接
+
+| 衔接方向 | SKILL 名称 | 依赖/产出 |
+|----------|-----------|-----------|
+| 前置依赖 | `rn-library-interface-check` | 输入：`接口规格说明.md` |
+| 前置依赖 | `rn-library-stability-check` | 输入：`稳定性检视报告.md` |
+| 后置衔接 | `rn-library-code-quality-check` | 输出：`一致性检视报告.md` 供编码质量检视参考 |

package/vendor/Server/Skills/rn-library-consistency-check/assets/REPORT_TEMPLATE.md

@@ -0,0 +1,293 @@
+# 一致性检视报告输出模板
+
+本模板定义 RN 鸿蒙化一致性检视报告的完整输出格式。检视报告必须严格遵循此格式，确保 `_parseRNLibraryScore` 函数能正确解析评分。
+
+> 📖 **引用来源**：SKILL.md Phase 7 输出格式规范节的详细内容。
+
+> ⚠️ **扣分维度标注规则**：所有检视表格的扣分列，必须在分数后标注维度编号，格式为 **`-X（维度N）`**。详见 [SCORING_STANDARD.md](references/SCORING_STANDARD.md) 第 7 节。
+
+> ⚠️ **评分格式要求**：必须包含 `**综合评分：XX/100**`（粗体标记，中文冒号）。
+
+---
+
+## 报告结构
+
+```markdown
+# {repoName} 一致性检视报告
+
+## 一、检视概览
+
+| 字段 | 内容 |
+|------|------|
+| **仓库名称** | {repoName} |
+| **检视类型** | RN 鸿蒙化实现一致性检视 |
+| **检视时间** | {timestamp} |
+| **对比平台** | Android / iOS / OHOS |
+| **分析方法数** | {methodCount} |
+| **致命问题数** | {criticalCount} |
+| **严重问题数** | {majorCount} |
+
+## 二、综合评分
+
+**综合评分：{score}/100**
+
+评分等级：{grade}
+
+> 评分说明：采用严苛扣分制，从 100 分开始扣减，最低 0 分。致命/严重/中等/轻微问题独立扣分计算。
+
+## 三、各维度评分明细
+
+| 维度编号 | 检视维度 | 权重 | 扣分 | 维度得分 | 致命数 | 严重数 | 中等数 | 轻微数 |
+|----------|----------|------|------|----------|--------|--------|--------|--------|
+| 维度1 | API 契约一致性 | 35% | {api扣分} | {api得分} | {c1} | {m1} | {n1} | {l1} |
+| 维度2 | 平台实现一致性 | 30% | {platform扣分} | {platform得分} | {c2} | {m2} | {n2} | {l2} |
+| 维度3 | RN 架构一致性 | 20% | {arch扣分} | {arch得分} | {c3} | {m3} | {n3} | {l3} |
+| 维度4 | 平台适配合理性 | 15% | {adapt扣分} | {adapt得分} | {c4} | {m4} | {n4} | {l4} |
+
+**扣分明细**（按四类型分组，表格形式，每项标注维度编号）：
+
+| # | 类型 | 检查点 | 方法名/属性名 | 问题描述 | 文件:行号 | 严重度 | 维度 | 扣分 |
+|---|------|--------|-------------|---------|----------|--------|------|------|
+| 1 | arktsTM | 实现逻辑 | `startScan` 参数 `force` 类型错误 (boolean→string) | 参数类型致命错误 | `NativeModule.ets:344` | 致命 | 维度1 | -15 |
+| 2 | arktsTM | 实现逻辑 | `removeBond` 为 Stub 方法，返回 `true` 未调用 `unpairDevice()` | Stub实现 | `NativeModule.ets:278` | 致命 | 维度2 | -8 |
+| 3 | cppComp | Props | `src` Prop JSIBinder→NapiBinder 断桥 | 桥接缺失 | `JSIBinder.h:56` | 中等 | 维度3 | -5 |
+| 4 | arktsComp | Props副作用 | `forceDarkOn` 影响 backgroundColor(White/Transparent)，Android无此副作用，无文档说明 | 无文档副作用 | `RNCWebView.ets:547` | 致命 | 维度2 | -15 |
+| ... | ... | ... | ... | ... | ... | ... | ... | ... |
+
+## 四、检视范围
+
+### 鸿蒙代码智能定位结果
+
+| 搜索方法 | 类型 | 定位结果 | 文件数 | 状态 |
+|----------|------|----------|--------|------|
+| `codegenNativeComponent` | arktsComp/cppComp | JS 层组件注册文件 | X | ✅/⚠️ 无 |
+| `TurboModuleRegistry.getEnforcing` | arktsTM/cppTM | JS 层 TurboModule Spec 文件 | X | ✅/⚠️ 无 |
+| `*Package extends RNOHPackage` | — | ArkTS Package 注册文件 | X | ✅/⚠️ 无 |
+| C++ Package | cppComp | `harmony/<module>/src/main/cpp/*Package.h` | X | ✅/⚠️ 无 |
+| C++ JSIBinder | cppComp | `generated/*JSIBinder.h` | X | ✅/⚠️ 无 |
+| C++ NapiBinder | cppComp | `generated/*NapiBinder.h` | X | ✅/⚠️ 无 NapiBinder |
+| C++ EventEmitRequestHandler | cppComp | `*Package.h` 中 `supportedEventNames` | X | ✅/⚠️ 无 |
+| C++ TurboModule FactoryDelegate | cppTM | `generated/turbo_modules/*` | X | ✅/⚠️ 无 |
+| C++ TurboModule JSIBinder | cppTM | `turbo_modules/*JSIBinder.h` | X | ✅/⚠️ 无 |
+| @Component struct | arktsComp | 组件实现文件 | X | ✅/⚠️ 无 |
+| generated Props 类型 | arktsComp | `generated/*EtsProps.ts` | X | ✅/⚠️ 无 |
+| generated Commands Payload | arktsComp | `generated/*EtsCommandPayload.ts` | X | ✅/⚠️ 无 |
+| generated EventEmitRequestHandler | arktsComp | `generated/*EtsEventEmitRequestHandler.ts` | X | ✅/⚠️ 无 |
+| ArkTS TurboModule 实现文件 | arktsTM | `harmony/<module>/src/main/ets/*TurboModule.ets` | X | ✅/⚠️ 无 |
+| generated TurboModule Spec 类型 | arktsTM | `generated/turboModules/*.ts` | X | ✅/⚠️ 无 |
+
+### 四类型原生实体注册链路
+
+| 原生实体名 | 类型 | JS 层注册文件:行号 | 桥接层文件:行号 | 原生实现文件:行号 |
+|------------|------|-------------------|---------------|-------------------|
+| {组件名} | cppComp | {JS文件}:{行号} | {JSIBinder}:{行号}; {NapiBinder}:{行号} | {Package.h}:{行号} |
+| {TurboModule名} | cppTM | {JS Spec}:{行号} | {JSIBinder}:{行号}; {FactoryDelegate}:{行号} | {FactoryDelegate.h}:{行号} |
+| {组件名} | arktsComp | {JS文件}:{行号} | {EtsProps}:{行号}; {EtsCommandPayload}:{行号} | {Component.ets}:{行号} |
+| {TurboModule名} | arktsTM | {JS Spec}:{行号} | {TM Spec.ts}:{行号} | {TurboModule.ets}:{行号} |
+
+> 若库不含某类型实体，在表中标注"⚠️ 无该类型"即可。
+
+### 对比参考定位
+
+| 平台 | 目录 | 文件数 | 状态 |
+|------|--------|--------|------|
+| Android | `source/RN/android/` | X | ✅ |
+| iOS | `source/RN/ios/` | X | ✅ |
+| JS 接口 | `source/RN/src/` | - | ⚠️ 仅接口定义 |
+
+## 五、详细检视结果（按四类型分类）
+
+#### cppComp 检视结果（C++ 组件层，如适用）
+
+> 📖 详见 [CPP_COMPONENT_CHECK_GUIDE.md](references/CPP_COMPONENT_CHECK_GUIDE.md) 第 6 节输出格式。
+
+**C++ Package 模式**：{Thin Wrapper / Hand-Written / ⚠️ 无 cppComp}
+
+**1. Props 检视**：
+
+| # | Prop 名 | 上游 NativeProps | C++ JSIBinder | C++ NapiBinder | OHOS DirectRawProps | ArkTS rawProps 使用 | 断桥位置 | 扣分 |
+|---|---------|----------------|--------------|---------------|--------------------|-------------------|---------|------|
+| ... | ... | ... | ... | ... | ... | ... | ... | ... |
+
+**1a. Props 副作用&关联影响分析**（仅 C++ 渲染模式；桥接转发模式标注"⛔ 由arktsComp覆盖"）：
+
+| # | 渲染模式 | Prop 名 | 主映射行为 | 副作用/关联影响 | Android/iOS 是否有同副作用 | 文档说明 | 文档合理性 | 致命度 | 扣分 |
+|---|---------|---------|-----------|-------------|--------------------------|---------|-----------|--------|------|
+| （桥接转发）| ⛔ 桥接转发 | — | — | — | — | — | — | — | 0 |
+| （C++渲染）| ✅ C++渲染 | `propA` | ... | ... | ❌ | ❌ 无文档 | — | 致命 | -15（维度2） |
+| （C++渲染）| ✅ C++渲染 | `propB` | ... | ... | ❌ | ✅ 有文档且合理 | ✅ | 轻微 | -3（维度4） |
+
+**2. Command 检视**：
+
+| # | Command 名 | 上游 JS Spec | C++ Command handler | C++ 实现逻辑 | Android/iOS 实现 | 实现逻辑一致性 | 扣分 |
+|---|-----------|-------------|--------------------|-------------|----------------|---------------|------|
+| ... | ... | ... | ... | ... | ... | ... | ... |
+
+**3. Methods 检视**（Package 注册等）：
+
+| # | 检查项 | 上游实现 | OHOS C++ 实现 | 状态 | 扣分 |
+|---|--------|---------|-------------|------|------|
+| 1 | 组件注册完整性 | ... | ... | ... | ... |
+| 2 | JSIBinder 映射完整性 | ... | ... | ... | ... |
+
+**4. Callback 检视**（EventEmitRequestHandler）：
+
+| # | 事件名 | 上游 JS onXxx | C++ supportedEventNames | C++→JS 映射 | 回调触发时机 vs Android/iOS | 扣分 |
+|---|--------|-------------|-------------------------|------------|---------------------------|------|
+| ... | ... | ... | ... | ... | ... | ... |
+
+**5. Lifecycle 检视**（C++ 组件构造/析构）：
+
+| # | 生命周期 | Android/iOS 实现 | OHOS C++ 实现 | 一致性 | 扣分 |
+|---|---------|----------------|-------------|--------|------|
+| ... | ... | ... | ... | ... | ... |
+
+#### cppTM 检视结果（C++ TurboModule 层，如适用）
+
+> 📖 详见 [CPP_TURBOMODULE_CHECK_GUIDE.md](references/CPP_TURBOMODULE_CHECK_GUIDE.md) 第 7 节输出格式。
+
+**C++ TurboModule 模式**：{Codegen / Legacy / ⚠️ 无 cppTM}
+
+**1. 函数签名检视**：
+
+| # | TurboModule 名 | JS Spec 注册名 | C++ FactoryDelegate | C++ JSIBinder 方法 | C++ 文件:行号 | 状态 | 扣分 |
+|---|--------------|--------------|--------------------|-----------------|-------------|------|------|
+| ... | ... | ... | ... | ... | ... | ... | ... |
+
+**TurboModule JSIBinder 方法级对比**：
+
+| # | 方法名 | JS Spec 签名 | C++ JSIBinder 签名 | C++ 文件:行号 | 状态 | 扣分 |
+|---|--------|-------------|-------------------|-------------|------|------|
+| ... | ... | ... | ... | ... | ... | ... |
+
+**2. 返回值检视**：
+
+| # | 方法名 | JS Spec 期望返回 | C++ TurboModule 返回 | C++ 文件:行号 | 状态 | 扣分 |
+|---|--------|----------------|--------------------|-------------|------|------|
+| ... | ... | ... | ... | ... | ... | ... |
+
+**3. 实现逻辑检视**（C++→ArkTS 映射）：
+
+| # | TurboModule 名 | C++ FactoryDelegate 类名 | ArkTS TurboModule 类名 | 映射状态 | 扣分 |
+|---|--------------|--------------------|--------------------|--------|------|
+| ... | ... | ... | ... | ... | ... |
+
+#### arktsComp 检视结果（ArkTS @Component 层，如适用）
+
+> 📖 详见 [ARKTS_COMPONENT_CHECK_GUIDE.md](references/ARKTS_COMPONENT_CHECK_GUIDE.md) 第 7 节输出格式。
+
+**ArkTS 组件模式**：{Codegen DirectRawProps / Legacy 手动读取 / ⚠️ 无 arktsComp}
+
+**1. Props 检视**：
+
+| # | Prop 名 | OHOS generated 类型 | ArkTS rawProps 读取 | as-类型断言 | build() 传递给原生组件 | 上游 Android/iOS Prop 处理 | 实现逻辑一致性 | 断桥位置 | 扣分 |
+|---|---------|--------------------|-------------------|------------|--------------------|------------------------|---------------|---------|------|
+| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+
+**1a. Props 副作用&关联影响分析**：
+
+| # | Prop 名 | 主映射原生属性 | 副作用/关联影响原生属性 | Android/iOS 是否有同副作用 | 文档说明 | 文档合理性 | 致命度 | 扣分 |
+|---|---------|-------------|-------------------|--------------------------|---------|-----------|--------|------|
+| 1 | `forceDarkOn` | .darkMode() | .backgroundColor(White/Transparent条件) | ❌ Android始终Transparent | ❌ 无文档 | — | 致命 | -15（维度2） |
+| 2 | `propX` | ... | ... | ✅ | — | — | — | 0 |
+| 3 | `propY` | ... | ... | ❌ | ✅ 有文档且合理 | ✅ | 轻微 | -3（维度4） |
+
+**1b. build() 非 rawProps 属性跨平台默认值对比**：
+
+| # | 原生属性 | OHOS build() 值 | 值来源类型 | Android 默认值 | iOS 默认值 | 一致性 | 文档说明 | 影响范围 | 扣分 |
+|---|---------|----------------|-----------|-------------|-----------|--------|---------|---------|------|
+| 1 | backgroundColor | getColorMode===On ? White : Transparent | 条件计算 | TRANSPARENT | clearColor | ❌ | ❌ 无文档 | 核心行为 | -12（维度2） |
+| 2 | propX | ... | ... | ... | ... | ❌ | ✅ 有文档且合理 | 次要 | -3（维度4） |
+
+**2. Command 检视**：
+
+| # | Command 名 | 上游 JS Spec | ArkTS Command handler | ArkTS 实现逻辑 | 上游 Android/iOS Command 实现 | 实现逻辑一致性 | fall-through | 扣分 |
+|---|-----------|-------------|--------------------|--------------|------------------------|---------------|-------------|------|
+| ... | ... | ... | ... | ... | ... | ... | ... | ... |
+
+**3. Methods 检视**（组件注册等）：
+
+| # | 检查项 | 上游实现 | OHOS ArkTS 实现 | 状态 | 扣分 |
+|---|--------|---------|---------------|------|------|
+| 1 | 组件名注册一致性 | ... | ... | ... | ... |
+
+**4. Callback 检视**（Events emit）：
+
+| # | 事件名 | 上游 JS onXxx | C++ Handler | ArkTS emitEvent | ArkTS Payload | 上游 nativeEvent | 回调触发时机 vs Android/iOS | 扣分 |
+|---|--------|-------------|------------|----------------|--------------|----------------|---------------------------|------|
+| ... | ... | ... | ... | ... | ... | ... | ... | ... |
+
+**5. Lifecycle 检视**（aboutToAppear/aboutToDisappear）：
+
+| # | 生命周期 | Android/iOS 实现 | OHOS ArkTS 实现 | 一致性 | 扣分 |
+|---|---------|----------------|---------------|--------|------|
+| ... | ... | ... | ... | ... | ... |
+
+#### arktsTM 检视结果（ArkTS TurboModule 层，如适用）
+
+> 📖 详见 [ARKTS_TURBOMODULE_CHECK_GUIDE.md](references/ARKTS_TURBOMODULE_CHECK_GUIDE.md) 第 7 节输出格式。
+
+**ArkTS TurboModule 模式**：{Codegen（implements TM.Xxx.Spec）/ Legacy（手写）/ ⚠️ 无 arktsTM}
+
+**1. 函数签名检视**：
+
+| # | TurboModule 名 | ArkTS 类名 | NAME 常量 | JS Spec 注册名 | C++ FactoryDelegate | implements Spec? | 状态 | 扣分 |
+|---|--------------|-----------|----------|--------------|--------------------|----------------|------|------|
+| ... | ... | ... | ... | ... | ... | ... | ... | ... |
+
+**方法级签名对比**：
+
+| # | 方法名 | JS Spec 签名 | generated Spec 签名 | ArkTS TurboModule 签名 | ArkTS 文件:行号 | 状态 | 扣分 |
+|---|--------|-------------|--------------------|----------------------|---------------|------|------|
+| ... | ... | ... | ... | ... | ... | ... | ... |
+
+**2. 返回值检视**：
+
+| # | 方法名 | JS Spec 期望返回 | ArkTS TurboModule 返回 | ArkTS 文件:行号 | 状态 | 扣分 |
+|---|--------|----------------|----------------------|---------------|------|------|
+| ... | ... | ... | ... | ... | ... | ... |
+
+**常量导出对比**：
+
+| # | 常量名 | Android getConstants() | iOS getConstants() | ArkTS TurboModule getConstants() | ArkTS 文件:行号 | 值一致性 | 状态 | 扣分 |
+|---|--------|----------------------|--------------------|--------------------------------|---------------|---------|------|------|
+| ... | ... | ... | ... | ... | ... | ... | ... | ... |
+
+**3. 实现逻辑检视**：
+
+**Stub 检测**：
+
+| # | 方法名 | ArkTS 文件:行号 | Stub 代码 | Android 实现 | iOS 实现 | Stub 合理性 | 缺失逻辑 | 严重度 | 扣分 |
+|---|--------|---------------|----------|-------------|---------|------------|---------|--------|------|
+| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+
+**方法行为跨平台对比**：
+
+| # | 方法名 | Android 实现摘要 | iOS 实现摘要 | ArkTS 实现摘要 | ArkTS 文件:行号 | 行为对比状态 | 扣分 |
+|---|--------|----------------|-------------|--------------|---------------|------------|------|
+| ... | ... | ... | ... | ... | ... | ... | ... |
+
+#### NAPI/C++ 桥接一致性（如适用，适用于含 C++ Native 层但非 RN 新架构的库）
+
+| # | 检查项 | 原库 C++ 实现 | OHOS NAPI 实现 | 状态 | 扣分 |
+|---|--------|-------------|---------------|------|------|
+| ... | ... | ... | ... | ... | ... |
+
+#### NativeModule 架构一致性（如适用，适用于旧架构库）
+
+| # | 检查项 | Android/iOS 实现 | OHOS 实现 | 状态 | 扣分 |
+|---|--------|-----------------|----------|------|------|
+| ... | ... | ... | ... | ... | ... |
+
+## 六、平台差异记录
+
+| # | 差异项 | Android/iOS 实现 | OHOS 实现 | 合理性判定 | 说明 |
+|---|--------|-----------------|----------|-----------|------|
+| 1 | `requestPriority` | ✅ 调用 `gatt.requestConnectionPriority()` | ⛔ 不支持 | 🔶 合理差异 | 鸿蒙蓝牙 API 无对应接口 |
+
+---
+
+**报告生成时间**：{timestamp}
+```
+
+> **重要**：报告必须包含 `**综合评分：XX/100**` 格式，且评分值位于"二、综合评分"章节，确保可被 `_parseRNLibraryScore` 函数正确解析。