@ohos-cpf/3rdloop 0.0.2 → 0.0.3

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

@@ -1,518 +1,518 @@
----
-name: flutter-library-consistency-check
-description: 对 Flutter 三方库的鸿蒙化代码进行一致性检视，聚焦 ohos 目录下的 ArkTS/ETS 和 C++ 代码，对比 Android/iOS 平台的函数级实现一致性（方法签名、参数类型、返回值、行为逻辑），检测函数缺失、Stub 实现、类型错误等问题，生成严苛评分报告（0-100分）。作为 Flutter 仓库检视流程的第三阶段，依赖稳定性检视结果和接口规格文档。
-license: Apache-2.0
-compatibility: 需要访问 Git 仓库、分析 ohos 目录源码、对比 Android/iOS 实现函数
-metadata:
-  version: "1.0.0"
----
-
-# FlutterLibraryConsistencyCheckSkill
-
-对 Flutter 三方库的**鸿蒙化实现代码**进行一致性检视，对比 OHOS 实现与 Android/iOS 平台的**函数级**实现一致性，检测接口功能缺失、逻辑错误、参数类型不匹配、返回值异常等核心问题。
-
-> ⚠️ **核心定位与原则**：
-> 1. 本 SKILL **通过智能搜索定位鸿蒙化代码的实际位置**，鸿蒙代码位置不固定
-> 2. **一致性对比必须以具体函数为粒度**，禁止使用模糊文字描述（如"连接管理"）
-> 3. 每个对比项必须包含：函数名、签名、文件位置、代码片段
-> 4. 检视范围仅限鸿蒙化代码（ohos/ets/、NAPI 等），不关注非鸿蒙化部分
-
-> 📖 **详细参考文档**：
-> - 函数级对比规范：参见 [references/FUNCTION_COMPARISON_GUIDE.md](references/FUNCTION_COMPARISON_GUIDE.md)
-> - 检视清单：参见 [references/CHECKLIST.md](references/CHECKLIST.md)
-
----
-
-## 任务参数
-
-| 参数 | 必需 | 说明 |
-|------|------|------|
-| `repoUrl` | ✅ | Git 仓库地址，支持分支 `?branch=xxx` |
-| `outputDir` | ✅ | 输出目录绝对路径，存放检视报告 |
-| `interfaceDocPath` | ✅ | 接口规格说明文档路径 |
-| `repoName` | ✅ | 仓库名称（用于报告标识） |
-
----
-
-## 输入依赖
-
-本 SKILL 是 Flutter 仓库检视流程的**第三阶段**，依赖：
-
-- **前置 SKILL**: `flutter-library-stability-check`
-- **输入文件**: `接口规格说明.md`、`稳定性检视报告.md`
-- **仓库源码**: 已克隆到 `{outputDir}/source/`，重点对比鸿蒙实现与 `android/`、`ios/` 目录
-
----
-
-## 工作流程
-
-### Phase 0：鸿蒙代码智能定位与范围识别
-
-鸿蒙化代码位置**不固定**，必须通过智能搜索定位实际实现，不能仅以目录名称否定。
-
-#### 0.1 鸿蒙代码搜索策略
-
-**必须执行以下搜索步骤**定位鸿蒙化代码实际位置：
-
-| 步骤 | 搜索内容 | 搜索关键词/模式 |
-|------|----------|-----------------|
-| 1 | 鸿蒙特有导入/API | `@ohos`、`ohos_`、`OpenHarmony`、`HarmonyOS`、`napi_`、`NAPI` |
-| 2 | 鸿蒙特有文件扩展名 | `*.ets`、`module.json5`、`hvigorfile.ts`、`build-profile.json5` |
-| 3 | 鸿蒙特有目录结构 | `ohos/`、`harmony/`、`harmonyos/`、`openharmony/`、`ohosentry/` |
-| 4 | NAPI/C++ Native 绑定 | `napi_create_*`、`napi_get_*`、`napi_callback`、`napi_value`、`OH_NativeXxx` |
-
-#### 0.2 搜索结果判定
-
-| 搜索结果 | 检视范围判定 | 下一步 |
-|----------|--------------|--------|
-| ✅ 找到 `*.ets` 文件 | 定位所有 ETS 文件所在目录 | 进入 Phase 1 |
-| ✅ 找到 `@ohos` 导入 | 定位包含 OHOS API 调用的文件 | 进入 Phase 1 |
-| ✅ 找到 NAPI 绑定代码 | 定位 C++ Native 层实现 | 进入 Phase 1 |
-| ❌ 无任何鸿蒙特征 | 未实现鸿蒙化 | **评分 0 分** |
-
-#### 0.3 检视范围记录
-
-**必须在报告中记录实际定位到的鸿蒙代码位置**，包含搜索方法、定位结果、文件数。
-
----
-
-### Phase 1：函数级 API 契约一致性分析
-
-> ⚠️ **核心原则**：API 契约对比**必须以具体函数为粒度**。每个对比项必须包含函数名、完整签名、文件:行号、代码片段，禁止使用模糊文字描述。详见 [FUNCTION_COMPARISON_GUIDE.md](references/FUNCTION_COMPARISON_GUIDE.md)
-
-#### 1.1 方法签名函数级对比（15分）
-
-**必须提取所有函数签名并逐个对比**：
-
-| 检查项 | 对比对象 | 扣分规则 |
-|--------|----------|----------|
-| 方法名称 | Dart MethodChannel 名称 vs ArkTS 方法名 | **不匹配扣 5 分** |
-| 参数数量 | Dart 调用参数数量 vs ArkTS 接收参数数量 | **不匹配扣 8 分（致命）** |
-| 参数顺序 | 参数位置是否完全对应 | **顺序错误扣 6 分** |
-| 方法存在性 | Dart 接口方法是否在 OHOS 实现 | **缺失扣 10 分（致命）** |
-
-**对比格式要求**（每个对比项必须包含）：
-
-```markdown
-| # | 函数名 | Dart 签名 | OHOS 签名 | OHOS 文件:行号 | 状态 | 扣分 |
-|---|--------|-----------|-----------|---------------|------|------|
-| 1 | `connectToDevice` | `Future<bool> connectToDevice(String deviceId)` | `connectToDevice(deviceId: string): Promise<boolean>` | `plugin.ets:89` | ✅ 一致 | 0 |
-| 2 | `removeBond` | `Future<bool> removeBond(String deviceId)` | `removeBond(deviceId: string): Promise<boolean>` | `plugin.ets:278` | ⚠️ Stub | -8 |
-```
-
-**致命问题判定**：
-- OHOS 方法返回固定错误消息（如 "not supported"）→ **致命 -10 分**
-- OHOS 方法为 Stub（返回固定值无实际操作）→ **致命 -8 分**
-
-#### 1.2 参数类型函数级对比（20分）⚠️ 最易出错维度
-
-**必须列出每个参数的具体类型映射**：
-
-| 检查项 | 对比对象 | 扣分规则 |
-|--------|----------|----------|
-| 类型映射 | Dart 类型 vs OHOS 解析类型 | **类型错误扣 15 分（致命）** |
-| 空值处理 | Dart 可空类型 vs OHOS null 处理 | 不一致扣 8 分 |
-| 类型精度 | Dart int/double vs OHOS number | 精度丢失扣 5 分 |
-| 复杂对象 | Dart Map/List vs OHOS Object/Array | 序列化错误扣 8 分 |
-
-**对比格式要求**（每个参数必须独立一行）：
-
-```markdown
-| # | 函数名 | 参数名 | Dart 类型 | OHOS 解析类型 | OHOS 文件:行号 | as 语句 | 状态 | 扣分 |
-|---|--------|--------|-----------|-------------|---------------|---------|------|------|
-| 1 | `setNotifyValue` | `force_indications` | `bool` | `string` ❌ | `plugin.ets:344` | `as string` | ❌ 致命 | -15 |
-| 2 | `connectToDevice` | `deviceId` | `String` | `string` | `plugin.ets:91` | `as string` | ✅ 正确 | 0 |
-```
-
-**致命类型映射表**：
-
-| Dart 类型 | ArkTS 正确类型 | 常见致命错误 | 致命度 |
-|-----------|---------------|-------------|--------|
-| bool | boolean | `as string` → 功能完全失效 | **致命** |
-| int | number | `as string` → 数值运算失效 | 严重 |
-| List<T> | Array<T> | 元素类型混入 string | 严重 |
-| Map<K,V> | Record/Object | 键类型不一致 | 严重 |
-
-#### 1.3 返回值函数级对比（15分）
-
-**必须列出每个函数的返回值对比**：
-
-```markdown
-| # | 函数名 | Dart 期望返回 | OHOS 实际返回 | OHOS 文件:行号 | 代码片段 | 状态 | 扣分 |
-|---|--------|-------------|-------------|---------------|----------|------|------|
-| 1 | `setOptions` | `void` | `Map` ❌ | `plugin.ets:502` | `return mConnectedDevices;` | ❌ 语义错误 | -8 |
-| 2 | `removeBond` | `bool` | `boolean`(固定true) | `plugin.ets:278` | `return true;` | ⚠️ Stub | -8 |
-```
-
-| 检查项 | 对比对象 | 扣分规则 |
-|--------|----------|----------|
-| 返回值类型 | Dart 期望类型 vs OHOS 实际返回 | **类型错误扣 10 分** |
-| 返回值语义 | 返回内容是否符合接口语义 | **语义错误扣 8 分** |
-| void 返回处理 | void 方法是否正确处理 | 不正确扣 5 分 |
-| 错误返回格式 | PlatformException 格式 | 格式错误扣 6 分 |
-
-#### 1.4 异常传播函数级对比（10分）
-
-**必须列出每个函数的异常处理对比**：
-
-| 检查项 | 对比对象 | 扣分规则 |
-|--------|----------|----------|
-| 异常类型映射 | PlatformException 类型 | 不映射扣 6 分 |
-| 错误码一致性 | Android/iOS/OHOS 错误码对比 | 不一致扣 5 分 |
-| 错误消息详细度 | 错误描述信息量对比 | 缺少诊断扣 4 分 |
-| 硬编码错误码 | 错误码是否固定值而非实际状态 | **硬编码扣 8 分** |
-
----
-
-### Phase 2：函数级平台实现一致性分析
-
-> ⚠️ **核心原则**：平台功能对比**必须列出具体函数名、函数签名、文件位置、代码片段**，禁止使用"连接管理"等模糊描述。详见 [FUNCTION_COMPARISON_GUIDE.md](references/FUNCTION_COMPARISON_GUIDE.md)
-
-#### 2.1 Android vs OHOS 函数级功能对比（25分）⚠️ 核心维度
-
-> ⚠️ **平台限制豁免原则**：当某个函数在鸿蒙平台**确实不存在对应系统 API 且无替代实现路径**时，属于 🔶 平台限制而非适配缺陷，**直接不扣分**。判定规则详见 [references/PLATFORM_LIMITATION_GUIDE.md](references/PLATFORM_LIMITATION_GUIDE.md)
-
-**必须按以下格式逐函数对比**：
-
-```markdown
-| # | 函数名 | Android 文件:行号 | Android 实现摘要 | OHOS 文件:行号 | OHOS 实现摘要 | 对比状态 | 扣分 |
-|---|--------|------------------|-----------------|---------------|-------------|----------|------|
-| 1 | `connectToDevice` | `BluetoothPlugin.java:156` | ✅ 调用 `BluetoothGatt.connect()` | `plugin.ets:89` | ✅ 调用 `@ohos.bluetooth.ble.connect()` | ✅ 一致 | 0 |
-| 2 | `removeBond` | `BluetoothPlugin.java:278` | ✅ 调用 `BluetoothDevice.removeBond()` | `plugin.ets:278` | ❌ Stub: `return true;` 未调用 `unpairDevice()` | ❌ 致命不一致 | -15 |
-| 3 | `requestConnectionPriority` | `BluetoothPlugin.java:455` | ✅ 调用 `gatt.requestConnectionPriority()` | — | ⛔ 方法不存在 | 🔶 平台限制 | 0 |
-```
-
-**对比状态说明**：
-- ✅ 一致：功能行为一致
-- ❌ 不一致 / ⚠️ Stub / ⛔ 缺失：适配缺陷，需扣分
-- 🔶 **平台限制**：鸿蒙无对应系统 API 且无替代路径，**不扣分**
-
-| 功能类别 | 检查项 | 扣分规则 |
-|----------|--------|----------|
-| 核心函数缺失 | Android 函数在 OHOS 不存在 | 🔶 平台限制：0 分；❌ 适配缺陷：**缺失扣 15 分** |
-| 函数行为不一致 | 同一函数核心逻辑差异 | **行为不一致扣 12 分** |
-| 边界处理不一致 | 同一函数边界情况处理差异 | 不一致扣 8 分 |
-| 错误处理不一致 | 同一函数错误处理差异 | 不一致扣 6 分 |
-| 默认值不一致 | 函数配置默认值差异 | 不一致扣 4 分 |
-
-**函数级 Stub 方法检测表格式**：
-
-```markdown
-| # | 函数名 | OHOS 文件:行号 | Stub 代码片段 | 缺失的 @ohos API 调用 | 缺失的业务逻辑 | 扣分 |
-|---|--------|---------------|--------------|---------------------|---------------|------|
-| 1 | `removeBond` | `plugin.ets:278` | `if (!connected) return false; return true;` | `connection.unpairDevice()` | 实际解绑操作 | -8 |
-```
-
-**Stub 识别特征**：
-- 方法体仅有 `return` 语句，返回固定值
-- 未调用任何 `@ohos` 模块 API
-- 未执行实际业务操作
-
-#### 2.2 iOS vs OHOS 函数级功能对比（15分）
-
-**同样必须使用函数级对比格式**：
-
-| 功能类别 | 检查项 | 扣分规则 |
-|----------|--------|----------|
-| 核心函数缺失 | iOS 函数在 OHOS 不存在（排除平台限制） | **缺失扣 12 分** |
-| 平台限制一致 | OHOS 是否有与 iOS 类似限制 | 不一致扣 5 分 |
-| 行为一致性 | 同一函数行为对比 | 不一致扣 8 分 |
-
-#### 2.3 平台差异函数级处理（10分）
-
-| 检查项 | 检查内容 | 扣分规则 |
-|--------|----------|----------|
-| OHOS 限制标注 | 特有限制是否文档化 | 未标注扣 5 分 |
-| 平台检测机制 | 是否有 `Platform.isOHOS` 检测 | 缺失扣 4 分 |
-| 条件分支正确 | 平台特定逻辑分支 | 错误扣 6 分 |
-| 平台差异文档 | 是否有 README 说明差异 | 未文档化扣 3 分 |
-
----
-
-### Phase 3：命名一致性分析
-
-#### 3.1 函数级命名规范检查（10分）
-
-**降低权重**：命名一致性属于轻微问题。
-
-**必须使用函数级格式列出每个命名问题**：
-
-```markdown
-| # | 函数/变量名 | 当前命名 | 标准命名 | 所在文件:行号 | 扣分 |
-|---|------------|---------|---------|-------------|------|
-| 1 | 方法名 | `ConnectStateChanged` | `connectStateChanged` | `plugin.ets:1242` | -3 |
-| 2 | 私有变量 | `mConnectedDevices` vs `channel` | 统一前缀风格 | `plugin.ets` | -2 |
-```
-
-| 检查项 | 标准 | 扣分规则 |
-|--------|------|----------|
-| 类名 | PascalCase | 不规范扣 2 分 |
-| 方法名 | camelCase（动词开头） | **大写开头扣 3 分** |
-| 参数名 | camelCase（语义明确） | 不规范扣 1 分 |
-| 私有成员 | 统一前缀风格 | 不一致扣 2 分 |
-
-#### 3.2 术语一致性（5分）
-
-| 检查项 | 检查内容 | 扣分规则 |
-|--------|----------|----------|
-| 概念命名统一 | 同一概念所有平台相同名称 | 不一致扣 2 分 |
-| 缩写一致 | URL/ID/UUID 等缩写格式 | 不一致扣 1 分 |
-| 消息字段名 | MethodChannel 消息字段 | 不一致扣 2 分 |
-
----
-
-### Phase 4：严苛评分计算
-
-采用**严苛扣分制**，从 100 分开始扣减，每个函数的对比结果**独立计算扣分**：
-
-```
-初始分数：100 分
-
-扣分类型（函数级独立扣分）：
-├── 致命问题：-15 分（最多扣 60 分）
-│   ├── 参数类型致命错误（如 bool→string）................ -15
-│   ├── OHOS 函数缺失（适配缺陷，非平台限制）............ -15/函数
-│   ├── OHOS 函数为 stub（适配缺陷，非平台限制）......... -8/函数
-│   ├── OHOS 函数返回错误而非实现.......................... -10/函数
-│   ├── 返回值类型/语义完全错误........................... -10/函数
-│   ├── 函数行为致命不一致............................... -15/函数
-│   └── 错误码硬编码固定值............................... -8/函数
-│
-│   🔶 平台限制豁免（不扣分）：
-│   ├── OHOS 函数缺失（鸿蒙无对应系统 API 且无替代路径）.. 0/函数
-│   └── OHOS 函数为 stub（因平台限制无法实现）.......... 0/函数
-│
-├── 严重问题：-12 分
-│   ├── 函数行为严重不一致............................... -12/函数
-│   ├── 异常传播不完整................................... -6/函数
-│   ├── 核心函数部分缺失................................. -12/函数
-│   ├── 参数数量不匹配................................... -8/函数
-│   └── 返回值格式不标准................................. -6/函数
-│
-├── 中等问题：-8 分
-│   ├── 边界处理不一致................................... -8/函数
-│   ├── 错误消息缺少诊断信息............................. -4
-│   ├── 类型精度丢失..................................... -5
-│   └── 空值处理不完整................................... -8
-│
-├── 轻微问题：-3 分
-│   ├── 函数命名不规范................................... -3/函数
-│   ├── 术语不一致....................................... -2
-│   ├── 私有成员前缀不统一............................... -2
-│   └── 文档化不足....................................... -3
-
-特殊规则：
-├── 不存在鸿蒙代码 → 0 分
-├── 鸿蒙代码无实际实现 → 0 分
-├── 致命问题 ≥ 4 个 → 0 分
-├── 致命问题 ≥ 3 个 + 严重问题 ≥ 2 个 → 0 分
-├── 累计扣分超过 60 分 → 0 分
-
-最低分数：0 分
-```
-
----
-
-### Phase 5：生成报告
-
-输出文件：`{outputDir}/一致性检视报告.md`
-
-> ⚠️ **输出文件自检**：写入结果文件前，先确认 `{outputDir}/一致性检视报告.md` 已存在且内容完整（**独立文件，禁止只写入 result 执行结果文件**）。
-
----
-
-## 输出格式规范
-
-报告必须严格遵循以下格式，确保 `_parseFlutterLibraryScore` 函数能正确解析：
-
-> ⚠️ **评分格式要求**：必须包含 `**综合评分：XX/100**`（粗体标记，中文冒号），确保 `_parseFlutterLibraryScore` 函数的 `/\*?\*?综合评分[：:\s]*(\d{1,3})\s*\/\s*100/i` 正则匹配。
-
-### 报告结构
-
-```markdown
-# ${repoName} 一致性检视报告
-
-## 📊 一致性评分
-
-**综合评分：XX/100**
-
-> 评分说明：采用严苛扣分制，从 100 分开始扣减，最低 0 分。每个函数独立扣分计算。
-
-| 维度 | 检查函数数 | 通过数 | 失败数 | 平台限制 | 扣分 | 得分 |
-|------|-----------|--------|--------|----------|------|------|
-| 方法签名函数级对比 | X | X | X | X | -XX | X/15 |
-| 参数类型函数级对比 | X | X | X | - | -XX | X/20 |
-| 返回值函数级对比 | X | X | X | - | -XX | X/15 |
-| 异常传播函数级对比 | X | X | X | - | -XX | X/10 |
-| Android vs OHOS 函数级对比 | X | X | X | X | -XX | X/25 |
-| iOS vs OHOS 函数级对比 | X | X | X | X | -XX | X/15 |
-| 平台差异函数级对比 | X | X | X | - | -XX | X/10 |
-| 函数命名规范 | X | X | X | - | -XX | X/10 |
-| 术语一致性 | X | X | X | - | -XX | X/5 |
-
-**扣分明细**（每项必须包含函数名、文件:行号）：
-- `setNotifyValue` 参数 `force_indications` 类型错误 (bool→string)，`plugin.ets:344`（致命）：-15 分
-- `removeBond` 为 Stub 方法，`plugin.ets:278` 返回 `true` 未调用 `unpairDevice()`（致命）：-8 分
-- ...
-
----
-
-## 🔍 检视范围
-
-### 鸿蒙代码智能定位结果
-
-| 搜索方法 | 定位结果 | 文件数 | 状态 |
-|----------|----------|--------|------|
-| `@ohos` 导入 | `ohos/ets/plugin.ets` | X | ✅ |
-| `*.ets` 文件 | `ohos/ets/` | X | ✅ |
-| `napi_` 绑定 | `ohos/src/` | X | ✅ |
-
-### 对比参考定位
-
-| 平台 | 目录 | 文件数 | 状态 |
-|------|------|--------|------|
-| Android | `android/src/` | X | ✅ |
-| iOS | `ios/Classes/` | X | ✅ |
-| Dart 接口 | `lib/` | - | ⚠️ 仅接口定义 |
-
----
-
-## 🔍 详细检视结果
-
-### 1. 方法签名函数级对比
-
-| # | 函数名 | Dart 签名 | OHOS 签名 | OHOS 文件:行号 | 状态 | 扣分 |
-|---|--------|-----------|-----------|---------------|------|------|
-| 1 | `connectToDevice` | `Future<bool> connectToDevice(String)` | `connectToDevice(deviceId: string): Promise<boolean>` | `plugin.ets:89` | ✅ 一致 | 0 |
-| ... | ... | ... | ... | ... | ... | ... |
-
-### 2. 参数类型函数级对比
-
-| # | 函数名 | 参数名 | Dart 类型 | OHOS 类型 | OHOS 文件:行号 | as 语句 | 状态 | 扣分 |
-|---|--------|--------|-----------|----------|---------------|---------|------|------|
-| 1 | `setNotifyValue` | `force_indications` | `bool` | `string` ❌ | `plugin.ets:344` | `as string` | ❌ 致命 | -15 |
-| ... | ... | ... | ... | ... | ... | ... | ... | ... |
-
-### 3. 返回值函数级对比
-
-| # | 函数名 | Dart 期望返回 | OHOS 实际返回 | OHOS 文件:行号 | 代码片段 | 状态 | 扣分 |
-|---|--------|-------------|-------------|---------------|----------|------|------|
-| ... | ... | ... | ... | ... | ... | ... | ... |
-
-### 4. Android vs OHOS 函数级功能对比
-
-| # | 函数名 | Android 文件:行号 | Android 实现摘要 | OHOS 文件:行号 | OHOS 实现摘要 | 对比状态 | 扣分 |
-|---|--------|------------------|-----------------|---------------|-------------|----------|------|
-| 1 | `connectToDevice` | `BluetoothPlugin.java:156` | ✅ 调用 `BluetoothGatt.connect()` | `plugin.ets:89` | ✅ 调用 `ble.connect()` | ✅ | 0 |
-| ... | ... | ... | ... | ... | ... | ... | ... |
-
-### 5. iOS vs OHOS 函数级功能对比
-
-(同上格式，逐函数对比)
-
-### 6. 函数级 Stub 方法检测
-
-| # | 函数名 | OHOS 文件:行号 | Stub 代码片段 | 缺失的 @ohos API | 缺失逻辑 | 扣分 |
-|---|--------|---------------|--------------|----------------|---------|------|
-| ... | ... | ... | ... | ... | ... | ... |
-
-### 7. 🔶 鸿蒙平台限制函数清单
-
-> 以下函数经判定属于鸿蒙平台限制（鸿蒙系统无对应 API 且无替代实现路径），不纳入扣分计算。判定规则详见 [references/PLATFORM_LIMITATION_GUIDE.md](references/PLATFORM_LIMITATION_GUIDE.md)
-
-| # | 函数名 | Android API | 鸿蒙 API 状态 | 判定依据 | 备注 |
-|---|--------|------------|-------------|----------|------|
-| 1 | `requestConnectionPriority` | `BluetoothGatt.requestConnectionPriority()` | `@ohos.bluetooth.ble` 无此接口 | 查阅 API 10 文档确认 | iOS 亦有限制 |
-
-### 8. 函数级命名规范问题
-
-| # | 函数/变量名 | 当前命名 | 标准命名 | 文件:行号 | 扣分 |
-|---|------------|---------|---------|----------|------|
-| ... | ... | ... | ... | ... | ... |
-
----
-
-## 💡 改进建议
-
-### P0（致命问题，必须修复）
-
-1. **修复 `setNotifyValue` 参数类型**
-   - 函数：`setNotifyValue`
-   - 文件：`ohos/ets/plugin.ets:344`
-   - 修改：`as boolean` 而非 `as string`
-   - 代码片段与修复示例
-
-2. **实现 `removeBond` 实际解绑**
-   - 函数：`removeBond`
-   - 文件：`ohos/ets/plugin.ets:278`
-   - 修改：调用 `connection.unpairDevice()`
-   - Android 参考实现与 OHOS 修复方案
-
-### P1（严重问题）
-
-...
-
-### P2（轻微问题）
-
-...
-
----
-
-**检视时间**：${new Date().toLocaleString('zh-CN')}
-```
-
----
-
-## 检视清单与参考
-
-- 详细检查项：参见 [references/CHECKLIST.md](references/CHECKLIST.md)
-- 函数级对比规范：参见 [references/FUNCTION_COMPARISON_GUIDE.md](references/FUNCTION_COMPARISON_GUIDE.md)
-- 鸿蒙平台限制判定：参见 [references/PLATFORM_LIMITATION_GUIDE.md](references/PLATFORM_LIMITATION_GUIDE.md)
-
----
-
-## 输出要求
-
-1. **评分格式**：必须包含 `**综合评分：XX/100**`（粗体标记，中文冒号），确保 `_parseFlutterLibraryScore` 能解析
-2. **评分范围**：0-100 整数，严苛扣分制
-3. **函数级对比**：**所有对比必须以具体函数为粒度**，包含函数名、签名、文件:行号、代码片段
-4. **禁止模糊描述**：禁止使用"连接管理"等模糊文字，必须列出具体函数名和签名
-5. **检视范围**：记录智能搜索定位到的鸿蒙代码实际位置
-6. **扣分明细**：必须列出每个扣分项的函数名、文件:行号、具体原因
-7. **修复建议**：按优先级（P0/P1/P2）分类，必须包含函数名、修复代码示例、Android 参考实现
-8. **语言**：使用中文撰写报告内容
-
-### 结构化指标输出（必须执行）
-
-执行环境会在任务 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 分时强烈建议写明触发规则） |
-
-**说明**：该文件由执行框架自动收割入库（前端/历史列表直接读取评分，无需解析报告文本）。若 prompt 未下发该路径则跳过本节。
-
----
-
-## 特殊情况处理
-
-| 情况 | 处理方式 | 评分 |
-|------|----------|------|
-| 搜索未找到鸿蒙特征 | 报告标注"未实现鸿蒙化"，列出搜索关键词 | 0 分 |
-| 找到鸿蒙代码但无法解析 | 报告标注"鸿蒙代码解析失败"并说明原因 | 0 分 |
-| 鸿蒙代码散落在多处 | 合并所有位置的代码进行统一检视 | 按扣分规则 |
-| 致命问题 ≥ 4 个 | 报告标注"存在严重一致性缺陷，建议重构" | 0 分 |
-| 缺少对比参考（无 android/ios） | 标注"缺少对比参考，仅做接口契约分析" | 按现有维度 |
-| 鸿蒙代码在非标准目录 | 正常检视，报告中标注实际位置 | 按扣分规则 |
-| 函数过多无法逐一列出 | 按重要性排序，核心函数逐一对比，次要函数分组对比 | 按扣分规则 |
-| 函数缺失属于鸿蒙平台限制 | 经判定确认鸿蒙无对应系统 API 且无替代路径 → 标记 🔶 平台限制 | **0 分（不扣分）** |
+---
+name: flutter-library-consistency-check
+description: 对 Flutter 三方库的鸿蒙化代码进行一致性检视，聚焦 ohos 目录下的 ArkTS/ETS 和 C++ 代码，对比 Android/iOS 平台的函数级实现一致性（方法签名、参数类型、返回值、行为逻辑），检测函数缺失、Stub 实现、类型错误等问题，生成严苛评分报告（0-100分）。作为 Flutter 仓库检视流程的第三阶段，依赖稳定性检视结果和接口规格文档。
+license: Apache-2.0
+compatibility: 需要访问 Git 仓库、分析 ohos 目录源码、对比 Android/iOS 实现函数
+metadata:
+  version: "1.0.0"
+---
+
+# FlutterLibraryConsistencyCheckSkill
+
+对 Flutter 三方库的**鸿蒙化实现代码**进行一致性检视，对比 OHOS 实现与 Android/iOS 平台的**函数级**实现一致性，检测接口功能缺失、逻辑错误、参数类型不匹配、返回值异常等核心问题。
+
+> ⚠️ **核心定位与原则**：
+> 1. 本 SKILL **通过智能搜索定位鸿蒙化代码的实际位置**，鸿蒙代码位置不固定
+> 2. **一致性对比必须以具体函数为粒度**，禁止使用模糊文字描述（如"连接管理"）
+> 3. 每个对比项必须包含：函数名、签名、文件位置、代码片段
+> 4. 检视范围仅限鸿蒙化代码（ohos/ets/、NAPI 等），不关注非鸿蒙化部分
+
+> 📖 **详细参考文档**：
+> - 函数级对比规范：参见 [references/FUNCTION_COMPARISON_GUIDE.md](references/FUNCTION_COMPARISON_GUIDE.md)
+> - 检视清单：参见 [references/CHECKLIST.md](references/CHECKLIST.md)
+
+---
+
+## 任务参数
+
+| 参数 | 必需 | 说明 |
+|------|------|------|
+| `repoUrl` | ✅ | Git 仓库地址，支持分支 `?branch=xxx` |
+| `outputDir` | ✅ | 输出目录绝对路径，存放检视报告 |
+| `interfaceDocPath` | ✅ | 接口规格说明文档路径 |
+| `repoName` | ✅ | 仓库名称（用于报告标识） |
+
+---
+
+## 输入依赖
+
+本 SKILL 是 Flutter 仓库检视流程的**第三阶段**，依赖：
+
+- **前置 SKILL**: `flutter-library-stability-check`
+- **输入文件**: `接口规格说明.md`、`稳定性检视报告.md`
+- **仓库源码**: 已克隆到 `{outputDir}/source/`，重点对比鸿蒙实现与 `android/`、`ios/` 目录
+
+---
+
+## 工作流程
+
+### Phase 0：鸿蒙代码智能定位与范围识别
+
+鸿蒙化代码位置**不固定**，必须通过智能搜索定位实际实现，不能仅以目录名称否定。
+
+#### 0.1 鸿蒙代码搜索策略
+
+**必须执行以下搜索步骤**定位鸿蒙化代码实际位置：
+
+| 步骤 | 搜索内容 | 搜索关键词/模式 |
+|------|----------|-----------------|
+| 1 | 鸿蒙特有导入/API | `@ohos`、`ohos_`、`OpenHarmony`、`HarmonyOS`、`napi_`、`NAPI` |
+| 2 | 鸿蒙特有文件扩展名 | `*.ets`、`module.json5`、`hvigorfile.ts`、`build-profile.json5` |
+| 3 | 鸿蒙特有目录结构 | `ohos/`、`harmony/`、`harmonyos/`、`openharmony/`、`ohosentry/` |
+| 4 | NAPI/C++ Native 绑定 | `napi_create_*`、`napi_get_*`、`napi_callback`、`napi_value`、`OH_NativeXxx` |
+
+#### 0.2 搜索结果判定
+
+| 搜索结果 | 检视范围判定 | 下一步 |
+|----------|--------------|--------|
+| ✅ 找到 `*.ets` 文件 | 定位所有 ETS 文件所在目录 | 进入 Phase 1 |
+| ✅ 找到 `@ohos` 导入 | 定位包含 OHOS API 调用的文件 | 进入 Phase 1 |
+| ✅ 找到 NAPI 绑定代码 | 定位 C++ Native 层实现 | 进入 Phase 1 |
+| ❌ 无任何鸿蒙特征 | 未实现鸿蒙化 | **评分 0 分** |
+
+#### 0.3 检视范围记录
+
+**必须在报告中记录实际定位到的鸿蒙代码位置**，包含搜索方法、定位结果、文件数。
+
+---
+
+### Phase 1：函数级 API 契约一致性分析
+
+> ⚠️ **核心原则**：API 契约对比**必须以具体函数为粒度**。每个对比项必须包含函数名、完整签名、文件:行号、代码片段，禁止使用模糊文字描述。详见 [FUNCTION_COMPARISON_GUIDE.md](references/FUNCTION_COMPARISON_GUIDE.md)
+
+#### 1.1 方法签名函数级对比（15分）
+
+**必须提取所有函数签名并逐个对比**：
+
+| 检查项 | 对比对象 | 扣分规则 |
+|--------|----------|----------|
+| 方法名称 | Dart MethodChannel 名称 vs ArkTS 方法名 | **不匹配扣 5 分** |
+| 参数数量 | Dart 调用参数数量 vs ArkTS 接收参数数量 | **不匹配扣 8 分（致命）** |
+| 参数顺序 | 参数位置是否完全对应 | **顺序错误扣 6 分** |
+| 方法存在性 | Dart 接口方法是否在 OHOS 实现 | **缺失扣 10 分（致命）** |
+
+**对比格式要求**（每个对比项必须包含）：
+
+```markdown
+| # | 函数名 | Dart 签名 | OHOS 签名 | OHOS 文件:行号 | 状态 | 扣分 |
+|---|--------|-----------|-----------|---------------|------|------|
+| 1 | `connectToDevice` | `Future<bool> connectToDevice(String deviceId)` | `connectToDevice(deviceId: string): Promise<boolean>` | `plugin.ets:89` | ✅ 一致 | 0 |
+| 2 | `removeBond` | `Future<bool> removeBond(String deviceId)` | `removeBond(deviceId: string): Promise<boolean>` | `plugin.ets:278` | ⚠️ Stub | -8 |
+```
+
+**致命问题判定**：
+- OHOS 方法返回固定错误消息（如 "not supported"）→ **致命 -10 分**
+- OHOS 方法为 Stub（返回固定值无实际操作）→ **致命 -8 分**
+
+#### 1.2 参数类型函数级对比（20分）⚠️ 最易出错维度
+
+**必须列出每个参数的具体类型映射**：
+
+| 检查项 | 对比对象 | 扣分规则 |
+|--------|----------|----------|
+| 类型映射 | Dart 类型 vs OHOS 解析类型 | **类型错误扣 15 分（致命）** |
+| 空值处理 | Dart 可空类型 vs OHOS null 处理 | 不一致扣 8 分 |
+| 类型精度 | Dart int/double vs OHOS number | 精度丢失扣 5 分 |
+| 复杂对象 | Dart Map/List vs OHOS Object/Array | 序列化错误扣 8 分 |
+
+**对比格式要求**（每个参数必须独立一行）：
+
+```markdown
+| # | 函数名 | 参数名 | Dart 类型 | OHOS 解析类型 | OHOS 文件:行号 | as 语句 | 状态 | 扣分 |
+|---|--------|--------|-----------|-------------|---------------|---------|------|------|
+| 1 | `setNotifyValue` | `force_indications` | `bool` | `string` ❌ | `plugin.ets:344` | `as string` | ❌ 致命 | -15 |
+| 2 | `connectToDevice` | `deviceId` | `String` | `string` | `plugin.ets:91` | `as string` | ✅ 正确 | 0 |
+```
+
+**致命类型映射表**：
+
+| Dart 类型 | ArkTS 正确类型 | 常见致命错误 | 致命度 |
+|-----------|---------------|-------------|--------|
+| bool | boolean | `as string` → 功能完全失效 | **致命** |
+| int | number | `as string` → 数值运算失效 | 严重 |
+| List<T> | Array<T> | 元素类型混入 string | 严重 |
+| Map<K,V> | Record/Object | 键类型不一致 | 严重 |
+
+#### 1.3 返回值函数级对比（15分）
+
+**必须列出每个函数的返回值对比**：
+
+```markdown
+| # | 函数名 | Dart 期望返回 | OHOS 实际返回 | OHOS 文件:行号 | 代码片段 | 状态 | 扣分 |
+|---|--------|-------------|-------------|---------------|----------|------|------|
+| 1 | `setOptions` | `void` | `Map` ❌ | `plugin.ets:502` | `return mConnectedDevices;` | ❌ 语义错误 | -8 |
+| 2 | `removeBond` | `bool` | `boolean`(固定true) | `plugin.ets:278` | `return true;` | ⚠️ Stub | -8 |
+```
+
+| 检查项 | 对比对象 | 扣分规则 |
+|--------|----------|----------|
+| 返回值类型 | Dart 期望类型 vs OHOS 实际返回 | **类型错误扣 10 分** |
+| 返回值语义 | 返回内容是否符合接口语义 | **语义错误扣 8 分** |
+| void 返回处理 | void 方法是否正确处理 | 不正确扣 5 分 |
+| 错误返回格式 | PlatformException 格式 | 格式错误扣 6 分 |
+
+#### 1.4 异常传播函数级对比（10分）
+
+**必须列出每个函数的异常处理对比**：
+
+| 检查项 | 对比对象 | 扣分规则 |
+|--------|----------|----------|
+| 异常类型映射 | PlatformException 类型 | 不映射扣 6 分 |
+| 错误码一致性 | Android/iOS/OHOS 错误码对比 | 不一致扣 5 分 |
+| 错误消息详细度 | 错误描述信息量对比 | 缺少诊断扣 4 分 |
+| 硬编码错误码 | 错误码是否固定值而非实际状态 | **硬编码扣 8 分** |
+
+---
+
+### Phase 2：函数级平台实现一致性分析
+
+> ⚠️ **核心原则**：平台功能对比**必须列出具体函数名、函数签名、文件位置、代码片段**，禁止使用"连接管理"等模糊描述。详见 [FUNCTION_COMPARISON_GUIDE.md](references/FUNCTION_COMPARISON_GUIDE.md)
+
+#### 2.1 Android vs OHOS 函数级功能对比（25分）⚠️ 核心维度
+
+> ⚠️ **平台限制豁免原则**：当某个函数在鸿蒙平台**确实不存在对应系统 API 且无替代实现路径**时，属于 🔶 平台限制而非适配缺陷，**直接不扣分**。判定规则详见 [references/PLATFORM_LIMITATION_GUIDE.md](references/PLATFORM_LIMITATION_GUIDE.md)
+
+**必须按以下格式逐函数对比**：
+
+```markdown
+| # | 函数名 | Android 文件:行号 | Android 实现摘要 | OHOS 文件:行号 | OHOS 实现摘要 | 对比状态 | 扣分 |
+|---|--------|------------------|-----------------|---------------|-------------|----------|------|
+| 1 | `connectToDevice` | `BluetoothPlugin.java:156` | ✅ 调用 `BluetoothGatt.connect()` | `plugin.ets:89` | ✅ 调用 `@ohos.bluetooth.ble.connect()` | ✅ 一致 | 0 |
+| 2 | `removeBond` | `BluetoothPlugin.java:278` | ✅ 调用 `BluetoothDevice.removeBond()` | `plugin.ets:278` | ❌ Stub: `return true;` 未调用 `unpairDevice()` | ❌ 致命不一致 | -15 |
+| 3 | `requestConnectionPriority` | `BluetoothPlugin.java:455` | ✅ 调用 `gatt.requestConnectionPriority()` | — | ⛔ 方法不存在 | 🔶 平台限制 | 0 |
+```
+
+**对比状态说明**：
+- ✅ 一致：功能行为一致
+- ❌ 不一致 / ⚠️ Stub / ⛔ 缺失：适配缺陷，需扣分
+- 🔶 **平台限制**：鸿蒙无对应系统 API 且无替代路径，**不扣分**
+
+| 功能类别 | 检查项 | 扣分规则 |
+|----------|--------|----------|
+| 核心函数缺失 | Android 函数在 OHOS 不存在 | 🔶 平台限制：0 分；❌ 适配缺陷：**缺失扣 15 分** |
+| 函数行为不一致 | 同一函数核心逻辑差异 | **行为不一致扣 12 分** |
+| 边界处理不一致 | 同一函数边界情况处理差异 | 不一致扣 8 分 |
+| 错误处理不一致 | 同一函数错误处理差异 | 不一致扣 6 分 |
+| 默认值不一致 | 函数配置默认值差异 | 不一致扣 4 分 |
+
+**函数级 Stub 方法检测表格式**：
+
+```markdown
+| # | 函数名 | OHOS 文件:行号 | Stub 代码片段 | 缺失的 @ohos API 调用 | 缺失的业务逻辑 | 扣分 |
+|---|--------|---------------|--------------|---------------------|---------------|------|
+| 1 | `removeBond` | `plugin.ets:278` | `if (!connected) return false; return true;` | `connection.unpairDevice()` | 实际解绑操作 | -8 |
+```
+
+**Stub 识别特征**：
+- 方法体仅有 `return` 语句，返回固定值
+- 未调用任何 `@ohos` 模块 API
+- 未执行实际业务操作
+
+#### 2.2 iOS vs OHOS 函数级功能对比（15分）
+
+**同样必须使用函数级对比格式**：
+
+| 功能类别 | 检查项 | 扣分规则 |
+|----------|--------|----------|
+| 核心函数缺失 | iOS 函数在 OHOS 不存在（排除平台限制） | **缺失扣 12 分** |
+| 平台限制一致 | OHOS 是否有与 iOS 类似限制 | 不一致扣 5 分 |
+| 行为一致性 | 同一函数行为对比 | 不一致扣 8 分 |
+
+#### 2.3 平台差异函数级处理（10分）
+
+| 检查项 | 检查内容 | 扣分规则 |
+|--------|----------|----------|
+| OHOS 限制标注 | 特有限制是否文档化 | 未标注扣 5 分 |
+| 平台检测机制 | 是否有 `Platform.isOHOS` 检测 | 缺失扣 4 分 |
+| 条件分支正确 | 平台特定逻辑分支 | 错误扣 6 分 |
+| 平台差异文档 | 是否有 README 说明差异 | 未文档化扣 3 分 |
+
+---
+
+### Phase 3：命名一致性分析
+
+#### 3.1 函数级命名规范检查（10分）
+
+**降低权重**：命名一致性属于轻微问题。
+
+**必须使用函数级格式列出每个命名问题**：
+
+```markdown
+| # | 函数/变量名 | 当前命名 | 标准命名 | 所在文件:行号 | 扣分 |
+|---|------------|---------|---------|-------------|------|
+| 1 | 方法名 | `ConnectStateChanged` | `connectStateChanged` | `plugin.ets:1242` | -3 |
+| 2 | 私有变量 | `mConnectedDevices` vs `channel` | 统一前缀风格 | `plugin.ets` | -2 |
+```
+
+| 检查项 | 标准 | 扣分规则 |
+|--------|------|----------|
+| 类名 | PascalCase | 不规范扣 2 分 |
+| 方法名 | camelCase（动词开头） | **大写开头扣 3 分** |
+| 参数名 | camelCase（语义明确） | 不规范扣 1 分 |
+| 私有成员 | 统一前缀风格 | 不一致扣 2 分 |
+
+#### 3.2 术语一致性（5分）
+
+| 检查项 | 检查内容 | 扣分规则 |
+|--------|----------|----------|
+| 概念命名统一 | 同一概念所有平台相同名称 | 不一致扣 2 分 |
+| 缩写一致 | URL/ID/UUID 等缩写格式 | 不一致扣 1 分 |
+| 消息字段名 | MethodChannel 消息字段 | 不一致扣 2 分 |
+
+---
+
+### Phase 4：严苛评分计算
+
+采用**严苛扣分制**，从 100 分开始扣减，每个函数的对比结果**独立计算扣分**：
+
+```
+初始分数：100 分
+
+扣分类型（函数级独立扣分）：
+├── 致命问题：-15 分（最多扣 60 分）
+│   ├── 参数类型致命错误（如 bool→string）................ -15
+│   ├── OHOS 函数缺失（适配缺陷，非平台限制）............ -15/函数
+│   ├── OHOS 函数为 stub（适配缺陷，非平台限制）......... -8/函数
+│   ├── OHOS 函数返回错误而非实现.......................... -10/函数
+│   ├── 返回值类型/语义完全错误........................... -10/函数
+│   ├── 函数行为致命不一致............................... -15/函数
+│   └── 错误码硬编码固定值............................... -8/函数
+│
+│   🔶 平台限制豁免（不扣分）：
+│   ├── OHOS 函数缺失（鸿蒙无对应系统 API 且无替代路径）.. 0/函数
+│   └── OHOS 函数为 stub（因平台限制无法实现）.......... 0/函数
+│
+├── 严重问题：-12 分
+│   ├── 函数行为严重不一致............................... -12/函数
+│   ├── 异常传播不完整................................... -6/函数
+│   ├── 核心函数部分缺失................................. -12/函数
+│   ├── 参数数量不匹配................................... -8/函数
+│   └── 返回值格式不标准................................. -6/函数
+│
+├── 中等问题：-8 分
+│   ├── 边界处理不一致................................... -8/函数
+│   ├── 错误消息缺少诊断信息............................. -4
+│   ├── 类型精度丢失..................................... -5
+│   └── 空值处理不完整................................... -8
+│
+├── 轻微问题：-3 分
+│   ├── 函数命名不规范................................... -3/函数
+│   ├── 术语不一致....................................... -2
+│   ├── 私有成员前缀不统一............................... -2
+│   └── 文档化不足....................................... -3
+
+特殊规则：
+├── 不存在鸿蒙代码 → 0 分
+├── 鸿蒙代码无实际实现 → 0 分
+├── 致命问题 ≥ 4 个 → 0 分
+├── 致命问题 ≥ 3 个 + 严重问题 ≥ 2 个 → 0 分
+├── 累计扣分超过 60 分 → 0 分
+
+最低分数：0 分
+```
+
+---
+
+### Phase 5：生成报告
+
+输出文件：`{outputDir}/一致性检视报告.md`
+
+> ⚠️ **输出文件自检**：写入结果文件前，先确认 `{outputDir}/一致性检视报告.md` 已存在且内容完整（**独立文件，禁止只写入 result 执行结果文件**）。
+
+---
+
+## 输出格式规范
+
+报告必须严格遵循以下格式，确保 `_parseFlutterLibraryScore` 函数能正确解析：
+
+> ⚠️ **评分格式要求**：必须包含 `**综合评分：XX/100**`（粗体标记，中文冒号），确保 `_parseFlutterLibraryScore` 函数的 `/\*?\*?综合评分[：:\s]*(\d{1,3})\s*\/\s*100/i` 正则匹配。
+
+### 报告结构
+
+```markdown
+# ${repoName} 一致性检视报告
+
+## 📊 一致性评分
+
+**综合评分：XX/100**
+
+> 评分说明：采用严苛扣分制，从 100 分开始扣减，最低 0 分。每个函数独立扣分计算。
+
+| 维度 | 检查函数数 | 通过数 | 失败数 | 平台限制 | 扣分 | 得分 |
+|------|-----------|--------|--------|----------|------|------|
+| 方法签名函数级对比 | X | X | X | X | -XX | X/15 |
+| 参数类型函数级对比 | X | X | X | - | -XX | X/20 |
+| 返回值函数级对比 | X | X | X | - | -XX | X/15 |
+| 异常传播函数级对比 | X | X | X | - | -XX | X/10 |
+| Android vs OHOS 函数级对比 | X | X | X | X | -XX | X/25 |
+| iOS vs OHOS 函数级对比 | X | X | X | X | -XX | X/15 |
+| 平台差异函数级对比 | X | X | X | - | -XX | X/10 |
+| 函数命名规范 | X | X | X | - | -XX | X/10 |
+| 术语一致性 | X | X | X | - | -XX | X/5 |
+
+**扣分明细**（每项必须包含函数名、文件:行号）：
+- `setNotifyValue` 参数 `force_indications` 类型错误 (bool→string)，`plugin.ets:344`（致命）：-15 分
+- `removeBond` 为 Stub 方法，`plugin.ets:278` 返回 `true` 未调用 `unpairDevice()`（致命）：-8 分
+- ...
+
+---
+
+## 🔍 检视范围
+
+### 鸿蒙代码智能定位结果
+
+| 搜索方法 | 定位结果 | 文件数 | 状态 |
+|----------|----------|--------|------|
+| `@ohos` 导入 | `ohos/ets/plugin.ets` | X | ✅ |
+| `*.ets` 文件 | `ohos/ets/` | X | ✅ |
+| `napi_` 绑定 | `ohos/src/` | X | ✅ |
+
+### 对比参考定位
+
+| 平台 | 目录 | 文件数 | 状态 |
+|------|------|--------|------|
+| Android | `android/src/` | X | ✅ |
+| iOS | `ios/Classes/` | X | ✅ |
+| Dart 接口 | `lib/` | - | ⚠️ 仅接口定义 |
+
+---
+
+## 🔍 详细检视结果
+
+### 1. 方法签名函数级对比
+
+| # | 函数名 | Dart 签名 | OHOS 签名 | OHOS 文件:行号 | 状态 | 扣分 |
+|---|--------|-----------|-----------|---------------|------|------|
+| 1 | `connectToDevice` | `Future<bool> connectToDevice(String)` | `connectToDevice(deviceId: string): Promise<boolean>` | `plugin.ets:89` | ✅ 一致 | 0 |
+| ... | ... | ... | ... | ... | ... | ... |
+
+### 2. 参数类型函数级对比
+
+| # | 函数名 | 参数名 | Dart 类型 | OHOS 类型 | OHOS 文件:行号 | as 语句 | 状态 | 扣分 |
+|---|--------|--------|-----------|----------|---------------|---------|------|------|
+| 1 | `setNotifyValue` | `force_indications` | `bool` | `string` ❌ | `plugin.ets:344` | `as string` | ❌ 致命 | -15 |
+| ... | ... | ... | ... | ... | ... | ... | ... | ... |
+
+### 3. 返回值函数级对比
+
+| # | 函数名 | Dart 期望返回 | OHOS 实际返回 | OHOS 文件:行号 | 代码片段 | 状态 | 扣分 |
+|---|--------|-------------|-------------|---------------|----------|------|------|
+| ... | ... | ... | ... | ... | ... | ... | ... |
+
+### 4. Android vs OHOS 函数级功能对比
+
+| # | 函数名 | Android 文件:行号 | Android 实现摘要 | OHOS 文件:行号 | OHOS 实现摘要 | 对比状态 | 扣分 |
+|---|--------|------------------|-----------------|---------------|-------------|----------|------|
+| 1 | `connectToDevice` | `BluetoothPlugin.java:156` | ✅ 调用 `BluetoothGatt.connect()` | `plugin.ets:89` | ✅ 调用 `ble.connect()` | ✅ | 0 |
+| ... | ... | ... | ... | ... | ... | ... | ... |
+
+### 5. iOS vs OHOS 函数级功能对比
+
+(同上格式，逐函数对比)
+
+### 6. 函数级 Stub 方法检测
+
+| # | 函数名 | OHOS 文件:行号 | Stub 代码片段 | 缺失的 @ohos API | 缺失逻辑 | 扣分 |
+|---|--------|---------------|--------------|----------------|---------|------|
+| ... | ... | ... | ... | ... | ... | ... |
+
+### 7. 🔶 鸿蒙平台限制函数清单
+
+> 以下函数经判定属于鸿蒙平台限制（鸿蒙系统无对应 API 且无替代实现路径），不纳入扣分计算。判定规则详见 [references/PLATFORM_LIMITATION_GUIDE.md](references/PLATFORM_LIMITATION_GUIDE.md)
+
+| # | 函数名 | Android API | 鸿蒙 API 状态 | 判定依据 | 备注 |
+|---|--------|------------|-------------|----------|------|
+| 1 | `requestConnectionPriority` | `BluetoothGatt.requestConnectionPriority()` | `@ohos.bluetooth.ble` 无此接口 | 查阅 API 10 文档确认 | iOS 亦有限制 |
+
+### 8. 函数级命名规范问题
+
+| # | 函数/变量名 | 当前命名 | 标准命名 | 文件:行号 | 扣分 |
+|---|------------|---------|---------|----------|------|
+| ... | ... | ... | ... | ... | ... |
+
+---
+
+## 💡 改进建议
+
+### P0（致命问题，必须修复）
+
+1. **修复 `setNotifyValue` 参数类型**
+   - 函数：`setNotifyValue`
+   - 文件：`ohos/ets/plugin.ets:344`
+   - 修改：`as boolean` 而非 `as string`
+   - 代码片段与修复示例
+
+2. **实现 `removeBond` 实际解绑**
+   - 函数：`removeBond`
+   - 文件：`ohos/ets/plugin.ets:278`
+   - 修改：调用 `connection.unpairDevice()`
+   - Android 参考实现与 OHOS 修复方案
+
+### P1（严重问题）
+
+...
+
+### P2（轻微问题）
+
+...
+
+---
+
+**检视时间**：${new Date().toLocaleString('zh-CN')}
+```
+
+---
+
+## 检视清单与参考
+
+- 详细检查项：参见 [references/CHECKLIST.md](references/CHECKLIST.md)
+- 函数级对比规范：参见 [references/FUNCTION_COMPARISON_GUIDE.md](references/FUNCTION_COMPARISON_GUIDE.md)
+- 鸿蒙平台限制判定：参见 [references/PLATFORM_LIMITATION_GUIDE.md](references/PLATFORM_LIMITATION_GUIDE.md)
+
+---
+
+## 输出要求
+
+1. **评分格式**：必须包含 `**综合评分：XX/100**`（粗体标记，中文冒号），确保 `_parseFlutterLibraryScore` 能解析
+2. **评分范围**：0-100 整数，严苛扣分制
+3. **函数级对比**：**所有对比必须以具体函数为粒度**，包含函数名、签名、文件:行号、代码片段
+4. **禁止模糊描述**：禁止使用"连接管理"等模糊文字，必须列出具体函数名和签名
+5. **检视范围**：记录智能搜索定位到的鸿蒙代码实际位置
+6. **扣分明细**：必须列出每个扣分项的函数名、文件:行号、具体原因
+7. **修复建议**：按优先级（P0/P1/P2）分类，必须包含函数名、修复代码示例、Android 参考实现
+8. **语言**：使用中文撰写报告内容
+
+### 结构化指标输出（必须执行）
+
+执行环境会在任务 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 分时强烈建议写明触发规则） |
+
+**说明**：该文件由执行框架自动收割入库（前端/历史列表直接读取评分，无需解析报告文本）。若 prompt 未下发该路径则跳过本节。
+
+---
+
+## 特殊情况处理
+
+| 情况 | 处理方式 | 评分 |
+|------|----------|------|
+| 搜索未找到鸿蒙特征 | 报告标注"未实现鸿蒙化"，列出搜索关键词 | 0 分 |
+| 找到鸿蒙代码但无法解析 | 报告标注"鸿蒙代码解析失败"并说明原因 | 0 分 |
+| 鸿蒙代码散落在多处 | 合并所有位置的代码进行统一检视 | 按扣分规则 |
+| 致命问题 ≥ 4 个 | 报告标注"存在严重一致性缺陷，建议重构" | 0 分 |
+| 缺少对比参考（无 android/ios） | 标注"缺少对比参考，仅做接口契约分析" | 按现有维度 |
+| 鸿蒙代码在非标准目录 | 正常检视，报告中标注实际位置 | 按扣分规则 |
+| 函数过多无法逐一列出 | 按重要性排序，核心函数逐一对比，次要函数分组对比 | 按扣分规则 |
+| 函数缺失属于鸿蒙平台限制 | 经判定确认鸿蒙无对应系统 API 且无替代路径 → 标记 🔶 平台限制 | **0 分（不扣分）** |
 ```