@ohos-cpf/3rdloop 0.0.2 → 0.0.3

package/vendor/Server/Skills/arkts-library-stability-check/assets/REPORT_TEMPLATE.md

@@ -1,154 +1,154 @@
-# 稳定性检视报告模板
-
-> 本模板为 `arkts-library-stability-check` 的最终输出模板。生成报告时**严格遵循此格式**，替换 `{占位符}` 内容。
->
-> ⚠️ **后端解析依赖**：报告必须包含 `**综合评分：XX/100**` 格式（粗体标记、中文冒号），以便后端 `_parseArktsLibraryScore` 函数正确解析评分。
-
----
-
-## 报告模板
-
-```markdown
-# {repoName} 稳定性检视报告
-
-## 一、检视概览
-
-| 字段 | 内容 |
-|------|------|
-| **仓库名称** | {repoName} |
-| **检视类型** | ArkTS 稳定性检视（核心实现） |
-| **检视时间** | {timestamp} |
-| **分析文件数** | {fileCount} |
-| **检视范围** | {鸿蒙核心代码定位结果摘要} |
-| **排除范围** | example/demo/sample/test 相关代码 |
-
-## 二、综合评分
-
-**综合评分：{score}/100**
-
-> 评分说明：采用严苛扣分制，7 个维度独立评分后汇总，最低 0 分。**仅对库核心实现代码评分**，example/demo/sample/test 代码不参与评分。
-
-| 维度 | 基础分 | 扣分 | 得分 |
-|------|--------|------|------|
-| 异常处理完整性 | 25 | {扣分} | {得分}/25 |
-| 资源释放安全性 | 25 | {扣分} | {得分}/25 |
-| 并发安全 | 20 | {扣分} | {得分}/20 |
-| ArkTS 生命周期管理 | 10 | {扣分} | {得分}/10 |
-| NAPI 跨语言调用 | 15 | {扣分} | {得分}/15 |
-| C++ 内存管理 | 10 | {扣分} | {得分}/10 |
-| 调用链完整性 | 5 | {扣分} | {得分}/5 |
-
-**扣分明细**：
-- {检查项编号}：{问题描述}（{严重度}）：-{扣分值} 分
-- ……
-
-{归零规则触发时追加：}
-> ⚠️ 触发归零规则：{规则描述}，综合评分直接为 0 分
-
-## 三、检视范围
-
-### 鸿蒙核心代码定位结果
-
-**扫描策略**：通过文件类型 + API 特征 + 配置文件智能识别，**排除 example/demo/sample/test 代码**
-
-| 扫描维度 | 发现文件数 | 检视状态 |
-|----------|------------|----------|
-| `.ets` 文件（核心） | {count} | ✅ 已检视（核心） |
-| `module.json5` | {count} | ✅ 已检视 |
-| NAPI C++ 文件 | {count} | ✅ 已检视 |
-| `@ohos` API 导入 | {count} 处 | ✅ 已检视 |
-| example/demo/sample/test | {count} | ❌ 已排除 |
-
-**实际检视文件列表**（仅核心实现）：
-- `{文件路径}` ✅
-- ……
-
-**已排除文件列表**：
-- `{example/demo/sample/test 文件路径}` ❌ 已排除（非核心代码）
-
-## 四、检视维度明细
-
-### 4.1 异常处理完整性
-
-| 检查项编号 | 检查项 | 严重度 | 发现数量 | 扣分 | 详情 |
-|------------|--------|--------|----------|------|------|
-| E-01 | …… | …… | …… | …… | …… |
-| …… | …… | …… | …… | …… | …… |
-
-### 4.2 资源释放安全性
-……
-
-### 4.3 并发安全
-……
-
-### 4.4 ArkTS 生命周期管理
-……
-
-### 4.5 NAPI 跨语言调用
-……
-
-### 4.6 C++ 内存管理
-……
-
-## 五、调用链完整性分析
-
-### 5.1 核心功能调用链图
-
-**核心功能 1**：{功能名称}
-
-```
-调用链：{methodA} → {methodB} → {nativeMethodC}
-异常处理：✅ / ❌（标注每个节点）
-```
-
-### 5.2 异常传播链检查
-
-| 检查项编号 | 检查项 | 扣分 | 详情 |
-|------------|--------|------|------|
-| CH-01 | …… | …… | …… |
-
-## 六、问题清单
-
-| # | 文件 | 行号 | 检查项编号 | 严重度 | 描述 | 修复建议 |
-|---|------|------|------------|--------|------|----------|
-| …… | …… | …… | …… | …… | …… | …… |
-
-## 七、改进建议
-
-### 优先级 P0（Critical，必须修复）
-……
-
-### 优先级 P1（Major，强烈建议修复）
-……
-
-### 优先级 P2（Minor，建议改进）
-……
-
----
-
-**报告生成时间**：{timestamp}
-```
-
----
-
-## 填充说明
-
-| 占位符 | 说明 |
-|--------|------|
-| `{repoName}` | 仓库名称（来自任务参数） |
-| `{timestamp}` | 报告生成时间 |
-| `{fileCount}` | 实际检视的核心文件数 |
-| `{score}` | 综合评分（0-100） |
-| `{扣分}` / `{得分}` | 各维度扣分与得分 |
-| `{count}` | 各扫描维度的文件数 |
-
-## 评分等级速查
-
-| 分数段 | 等级 | 说明 |
-|--------|------|------|
-| 90-100 | 优秀 | 异常处理完善，资源管理规范，无稳定性风险 |
-| 80-89 | 良好 | 存在少量 Minor 问题，不影响核心稳定性 |
-| 70-79 | 一般 | 存在 Major 级别问题需关注，有一定风险 |
-| 60-69 | 较差 | 存在 Critical 级别问题，稳定性堪忧 |
-| <60 | 严重不足 | 多个 Critical 问题，崩溃/泄露风险极高 |
-| 0 | 不可用 | 触发归零规则或完全缺失稳定性设计 |
+# 稳定性检视报告模板
+
+> 本模板为 `arkts-library-stability-check` 的最终输出模板。生成报告时**严格遵循此格式**，替换 `{占位符}` 内容。
+>
+> ⚠️ **后端解析依赖**：报告必须包含 `**综合评分：XX/100**` 格式（粗体标记、中文冒号），以便后端 `_parseArktsLibraryScore` 函数正确解析评分。
+
+---
+
+## 报告模板
+
+```markdown
+# {repoName} 稳定性检视报告
+
+## 一、检视概览
+
+| 字段 | 内容 |
+|------|------|
+| **仓库名称** | {repoName} |
+| **检视类型** | ArkTS 稳定性检视（核心实现） |
+| **检视时间** | {timestamp} |
+| **分析文件数** | {fileCount} |
+| **检视范围** | {鸿蒙核心代码定位结果摘要} |
+| **排除范围** | example/demo/sample/test 相关代码 |
+
+## 二、综合评分
+
+**综合评分：{score}/100**
+
+> 评分说明：采用严苛扣分制，7 个维度独立评分后汇总，最低 0 分。**仅对库核心实现代码评分**，example/demo/sample/test 代码不参与评分。
+
+| 维度 | 基础分 | 扣分 | 得分 |
+|------|--------|------|------|
+| 异常处理完整性 | 25 | {扣分} | {得分}/25 |
+| 资源释放安全性 | 25 | {扣分} | {得分}/25 |
+| 并发安全 | 20 | {扣分} | {得分}/20 |
+| ArkTS 生命周期管理 | 10 | {扣分} | {得分}/10 |
+| NAPI 跨语言调用 | 15 | {扣分} | {得分}/15 |
+| C++ 内存管理 | 10 | {扣分} | {得分}/10 |
+| 调用链完整性 | 5 | {扣分} | {得分}/5 |
+
+**扣分明细**：
+- {检查项编号}：{问题描述}（{严重度}）：-{扣分值} 分
+- ……
+
+{归零规则触发时追加：}
+> ⚠️ 触发归零规则：{规则描述}，综合评分直接为 0 分
+
+## 三、检视范围
+
+### 鸿蒙核心代码定位结果
+
+**扫描策略**：通过文件类型 + API 特征 + 配置文件智能识别，**排除 example/demo/sample/test 代码**
+
+| 扫描维度 | 发现文件数 | 检视状态 |
+|----------|------------|----------|
+| `.ets` 文件（核心） | {count} | ✅ 已检视（核心） |
+| `module.json5` | {count} | ✅ 已检视 |
+| NAPI C++ 文件 | {count} | ✅ 已检视 |
+| `@ohos` API 导入 | {count} 处 | ✅ 已检视 |
+| example/demo/sample/test | {count} | ❌ 已排除 |
+
+**实际检视文件列表**（仅核心实现）：
+- `{文件路径}` ✅
+- ……
+
+**已排除文件列表**：
+- `{example/demo/sample/test 文件路径}` ❌ 已排除（非核心代码）
+
+## 四、检视维度明细
+
+### 4.1 异常处理完整性
+
+| 检查项编号 | 检查项 | 严重度 | 发现数量 | 扣分 | 详情 |
+|------------|--------|--------|----------|------|------|
+| E-01 | …… | …… | …… | …… | …… |
+| …… | …… | …… | …… | …… | …… |
+
+### 4.2 资源释放安全性
+……
+
+### 4.3 并发安全
+……
+
+### 4.4 ArkTS 生命周期管理
+……
+
+### 4.5 NAPI 跨语言调用
+……
+
+### 4.6 C++ 内存管理
+……
+
+## 五、调用链完整性分析
+
+### 5.1 核心功能调用链图
+
+**核心功能 1**：{功能名称}
+
+```
+调用链：{methodA} → {methodB} → {nativeMethodC}
+异常处理：✅ / ❌（标注每个节点）
+```
+
+### 5.2 异常传播链检查
+
+| 检查项编号 | 检查项 | 扣分 | 详情 |
+|------------|--------|------|------|
+| CH-01 | …… | …… | …… |
+
+## 六、问题清单
+
+| # | 文件 | 行号 | 检查项编号 | 严重度 | 描述 | 修复建议 |
+|---|------|------|------------|--------|------|----------|
+| …… | …… | …… | …… | …… | …… | …… |
+
+## 七、改进建议
+
+### 优先级 P0（Critical，必须修复）
+……
+
+### 优先级 P1（Major，强烈建议修复）
+……
+
+### 优先级 P2（Minor，建议改进）
+……
+
+---
+
+**报告生成时间**：{timestamp}
+```
+
+---
+
+## 填充说明
+
+| 占位符 | 说明 |
+|--------|------|
+| `{repoName}` | 仓库名称（来自任务参数） |
+| `{timestamp}` | 报告生成时间 |
+| `{fileCount}` | 实际检视的核心文件数 |
+| `{score}` | 综合评分（0-100） |
+| `{扣分}` / `{得分}` | 各维度扣分与得分 |
+| `{count}` | 各扫描维度的文件数 |
+
+## 评分等级速查
+
+| 分数段 | 等级 | 说明 |
+|--------|------|------|
+| 90-100 | 优秀 | 异常处理完善，资源管理规范，无稳定性风险 |
+| 80-89 | 良好 | 存在少量 Minor 问题，不影响核心稳定性 |
+| 70-79 | 一般 | 存在 Major 级别问题需关注，有一定风险 |
+| 60-69 | 较差 | 存在 Critical 级别问题，稳定性堪忧 |
+| <60 | 严重不足 | 多个 Critical 问题，崩溃/泄露风险极高 |
+| 0 | 不可用 | 触发归零规则或完全缺失稳定性设计 |

package/vendor/Server/Skills/arkts-library-stability-check/references/CHECKLIST.md

@@ -1,166 +1,166 @@
-# ArkTS 稳定性检视详细检查清单
-
-本文件为 `ArktsLibraryStabilityCheckSkill` 的详细检查项参考，供深度检视时按项逐查。
-
-> ⚠️ **检视范围限定**：以下所有检查项**仅适用于库核心实现代码**，排除 example、demo、sample 及 test 相关代码。仅检视库对外暴露的公共 API、核心业务逻辑、NAPI 绑定层。
-
----
-
-## 相关参考文档
-
-| 文档 | 内容 | 位置 |
-|------|------|------|
-| **代码示例** | 各维度正确/错误代码示例对照 | [CODE_EXAMPLES.md](CODE_EXAMPLES.md) |
-| **评分规则** | 评分计算方式、归零规则、等级说明 | [SCORING_RULES.md](SCORING_RULES.md) |
-
----
-
-## 1. 鸿蒙代码定位清单
-
-### 1.0 范围过滤（排除非核心代码）
-
-**在扫描前先过滤掉非核心代码**，确保检视聚焦于库的核心能力：
-
-| 排除类型 | 目录/文件特征 | 说明 |
-|----------|---------------|------|
-| **示例代码** | 目录名含 `example`、`demo`、`sample`、`samples` | 库的使用示例，不代表核心能力 |
-| **测试代码** | 目录名含 `test`、`tests`、`__test__`、`spec`、`unittest` | 测试代码验证功能而非实现功能 |
-| **文档示例** | 文件名含 `example`、`demo`、`sample` 的 `.ets/.ts` 文件 | 嵌入文档中的示例代码 |
-
-> **过滤原则**：目录路径中包含 `example/demo/sample/test` 关键词时，该目录下所有文件均不检视。
-
-### 1.1 文件类型特征扫描
-
-| 特征 | 模式 | 权重 | 说明 |
-|------|------|------|------|
-| ArkTS/ETS 文件 | `*.ets`（排除 example/demo/sample/test） | ⭐⭐⭐ 高 | 最强鸿蒙化特征 |
-| 鸿蒙配置 | `module.json5`、`oh-package.json5`（排除 example/demo/sample/test） | ⭐⭐⭐ 高 | 鸿蒙特有配置 |
-| TypeScript | `*.ts`（含 `@ohos` 导入，排除 example/demo/sample/test） | ⭐⭐ 中 | 需配合 API 特征判断 |
-| NAPI C++ 文件 | `*.cpp`、`*.h`（含 `napi_*` 调用，排除 example/demo/sample/test） | ⭐⭐ 中 | Native 层绑定 |
-
-### 1.2 API 调用特征扫描
-
-| 特征 | 模式 | 说明 |
-|------|------|------|
-| 鸿蒙系统 API | `@ohos.*`、`import from '@ohos'` | 鸿蒙官方模块（核心代码范围） |
-| NAPI 绑定 | `napi_create_*`、`napi_get_*`、`napi_call_function` | Native 接口（核心代码范围） |
-| 鸿蒙组件 | `@Entry`、`@Component`、`@Builder` | ArkUI 声明式组件（核心代码范围） |
-| 鸿蒙生命周期 | `aboutToAppear`、`aboutToDisappear`、`onPageShow` | 组件/页面生命周期（核心代码范围） |
-| 鸿蒙服务 | `geoLocationManager`、`sensor`、`network` | 系统服务调用（核心代码范围） |
-
-### 1.3 判定规则
-
-| 扫描结果 | 判定 | 评分 | 后续操作 |
-|----------|------|------|----------|
-| 发现核心 `.ets` 文件 | ✅ 存在鸿蒙化 | 正常评分 | 进入深度分析 |
-| 发现核心 `module.json5` + NAPI 代码 | ✅ 存在鸿蒙化 | 正常评分 | 进入深度分析 |
-| 仅发现目录名含 `ohos` 但无代码文件 | ⚠️ 疑似未完成 | 0-30 分 | 标注"鸿蒙化代码疑似缺失" |
-| 未发现任何鸿蒙特征（核心代码） | ❌ 未实现鸿蒙化 | 0 分 | 标注"未发现鸿蒙化核心实现代码" |
-| 仅在 example/demo/sample/test 中发现鸿蒙代码 | ⚠️ 核心实现缺失 | 0 分 | 标注"鸿蒙化代码仅存在于示例中" |
-| 无法访问源码目录 | ❌ 无法检视 | 0 分 | 标注"源码目录不可访问" |
-
----
-
-## 2. ArkTS 核心实现层稳定性检查清单
-
-### 2.1 异常处理完整性（25 分）
-
-**仅检视库核心实现代码**，不分析 example/demo/sample 及 test 代码。
-
-| # | 检查项 | 扣分 | 检查方式 | 关键路径定义 |
-|---|--------|------|----------|-------------|
-| E-01 | 核心公共 API 调用无 try-catch | **-10** | 搜索 `@ohos.*` 调用上下文是否包裹 try-catch（排除 example/demo/sample/test） | 库对外暴露方法、涉及系统资源的核心操作 |
-| E-02 | Promise rejection 未处理 | **-8** | 搜索 `.then()` 无 `.catch()`、await 无 try-catch | 所有异步操作链（核心实现） |
-| E-03 | 异常吞没 | **-7** | catch 块为空或仅 `console.log`，未恢复/上报/重新抛出 | 所有 catch 块（核心实现） |
-| E-04 | 参数验证缺失 | **-5** | 库公共 API 方法入口无类型/边界/空值检查 | 对外暴露的公共方法 |
-| E-05 | 异常类型窄化 | **-3** | 仅捕获特定异常类型，遗漏其他可能异常 | 涉及多种异常源的核心操作 |
-| E-06 | finally 缺失 | **-2** | 涉及资源操作但无 finally 清理路径 | 含资源分配的 try-catch（核心实现） |
-
-### 2.2 资源释放安全性（25 分）
-
-**仅检视库核心实现代码**，不分析 example/demo/sample 及 test 代码。
-
-| # | 检查项 | 扣分 | 检查方式 |
-|---|--------|------|----------|
-| R-01 | 系统资源未释放（sensor/location/network） | **-12** | 搜索核心代码中 `sensor.on()`/`geoLocationManager.on()` 等是否有对应 `.off()`/`.disable()`（排除 example/demo/sample/test） |
-| R-02 | 事件订阅未取消 | **-8** | 搜索核心代码中 `on()` 注册是否在组件 `aboutToDisappear` 或 Ability `onDestroy` 中对应 `off()`（排除 example/demo/sample/test） |
-| R-03 | Stream/Connection 泄露 | **-5** | 搜索 `createConnection`/`openSession` 是否有 `close`/`disconnect` |
-| R-04 | Timer 未清理 | **-5** | 搜索 `setInterval`/`setTimeout` 是否在销毁时 `clearInterval`/`clearTimeout` |
-| R-05 | Worker 未终止 | **-5** | 搜索 Worker 创建是否在适当时机 `terminate()` |
-
-### 2.3 并发安全（20 分）
-
-**仅检视库核心实现代码**，不分析 example/demo/sample 及 test 代码。
-
-| # | 检查项 | 扣分 | 检查方式 |
-|---|--------|------|----------|
-| C-01 | 主线程阻塞 | **-10** | 搜索核心 API 执行路径中是否存在耗时同步操作（大循环、同步 I/O、同步锁等待） |
-| C-02 | 共享状态无同步保护 | **-7** | 搜索多个异步回调修改同一状态变量，无锁/队列/原子操作 |
-| C-03 | 回调重入 | **-3** | 搜索异步回调可能重入导致状态混乱，缺少重入防护标志 |
-
-### 2.4 ArkTS 生命周期管理（10 分）
-
-**仅检视库核心实现代码**，不分析 example/demo/sample 及 test 代码。
-
-| # | 检查项 | 扣分 | 检查方式 |
-|---|--------|------|----------|
-| L-01 | aboutToDisappear 未清理 | **-8** | 库核心组件销毁钩子是否释放资源/移除监听/取消订阅 |
-| L-02 | @State 对象持有大引用 | **-2** | 核心状态变量持有大对象引用在组件销毁后未释放 |
-
----
-
-## 3. C++ Native 核心层稳定性检查清单
-
-**仅检视库核心 NAPI 绑定和 C++ 实现代码**，不分析 example/demo/sample 及 test 代码。
-
-### 3.1 NAPI 跨语言调用（15 分）
-
-| # | 检查项 | 扣分 | 检查方式 |
-|---|--------|------|----------|
-| N-01 | napi_ref 创建/释放不匹配 | **-10** | 搜索核心 NAPI 代码中 `napi_create_reference` 和 `napi_delete_reference` 是否数量匹配、路径对称（排除 example/demo/sample/test） |
-| N-02 | napi_handle_scope 未清理 | **-8** | 搜索 `napi_open_handle_scope` 是否有对应 `napi_close_handle_scope` |
-| N-03 | napi_value 类型转换无边界检查 | **-5** | 搜索 `napi_get_value_*` 是否有类型检查和边界验证 |
-| N-04 | napi_create_async_work 缺少异常处理 | **-5** | 搜索异步 work 的 execute/complete 回调是否检查返回值 |
-| N-05 | Native 对象与 ArkTS 对象生命周期不一致 | **-3** | 搜索 Native 侧对象是否绑定 ArkTS 侧 GC 回调 |
-
-### 3.2 C++ 内存管理安全（10 分）
-
-| # | 检查项 | 扣分 | 检查方式 |
-|---|--------|------|----------|
-| M-01 | malloc/new 与 free/delete 不匹配 | **-8** | 搜索分配/释放是否对称，是否存在双重释放 |
-| M-02 | 异常路径资源未释放 | **-5** | 搜索 try/catch 中分配的资源是否在异常分支释放 |
-| M-03 | 未使用 RAII 管理资源 | **-3** | 搜索裸指针管理资源是否可改用智能指针 |
-
----
-
-## 4. 核心功能调用链完整性检查清单
-
-**仅追踪库对外暴露的核心功能调用链**，不分析 example/demo/sample 中展示的调用链。
-
-### 4.1 跨层级调用链追踪
-
-| # | 检查项 | 扣分 | 检查方式 |
-|---|--------|------|----------|
-| CH-01 | ArkTS → Native 异常传播断裂 | **-10** | Native 异常是否通过 `napi_throw` 传播到 ArkTS 层 |
-| CH-02 | 跨模块调用异常未传播 | **-8** | 模块间调用异常是否正确传播而非被吞没 |
-| CH-03 | 核心功能调用链缺失异常处理节点 | **-7** | 追踪核心功能完整调用链，标注每个节点的异常处理状态 |
-
----
-
-## 5. 特殊归零规则
-
-| 规则 | 条件 | 结果 |
-|------|------|------|
-| 归零规则 1 | Critical 级别问题 ≥ 5 个 | 直接评 0 分 |
-| 归零规则 2 | Critical 级别问题 ≥ 3 个 + Major 级别问题 ≥ 4 个 | 直接评 0 分 |
-| 归零规则 3 | 核心公共 API 异常处理完全缺失（≥ 3 个核心 API 调用无 try-catch，不含 example/demo 代码） | 直接评 0 分 |
-| 归零规则 4 | NAPI 引用管理完全不匹配（创建远多于释放） | 直接评 0 分 |
-| 归零规则 5 | 未发现鸿蒙化核心实现代码 | 0 分 |
-| 归零规则 6 | 源码目录不可访问 | 0 分 |
-
----
-
-## 6. 评分规则参考
-
-> 评分计算方式、严重度映射、等级说明详见 [SCORING_RULES.md](SCORING_RULES.md)。
+# ArkTS 稳定性检视详细检查清单
+
+本文件为 `ArktsLibraryStabilityCheckSkill` 的详细检查项参考，供深度检视时按项逐查。
+
+> ⚠️ **检视范围限定**：以下所有检查项**仅适用于库核心实现代码**，排除 example、demo、sample 及 test 相关代码。仅检视库对外暴露的公共 API、核心业务逻辑、NAPI 绑定层。
+
+---
+
+## 相关参考文档
+
+| 文档 | 内容 | 位置 |
+|------|------|------|
+| **代码示例** | 各维度正确/错误代码示例对照 | [CODE_EXAMPLES.md](CODE_EXAMPLES.md) |
+| **评分规则** | 评分计算方式、归零规则、等级说明 | [SCORING_RULES.md](SCORING_RULES.md) |
+
+---
+
+## 1. 鸿蒙代码定位清单
+
+### 1.0 范围过滤（排除非核心代码）
+
+**在扫描前先过滤掉非核心代码**，确保检视聚焦于库的核心能力：
+
+| 排除类型 | 目录/文件特征 | 说明 |
+|----------|---------------|------|
+| **示例代码** | 目录名含 `example`、`demo`、`sample`、`samples` | 库的使用示例，不代表核心能力 |
+| **测试代码** | 目录名含 `test`、`tests`、`__test__`、`spec`、`unittest` | 测试代码验证功能而非实现功能 |
+| **文档示例** | 文件名含 `example`、`demo`、`sample` 的 `.ets/.ts` 文件 | 嵌入文档中的示例代码 |
+
+> **过滤原则**：目录路径中包含 `example/demo/sample/test` 关键词时，该目录下所有文件均不检视。
+
+### 1.1 文件类型特征扫描
+
+| 特征 | 模式 | 权重 | 说明 |
+|------|------|------|------|
+| ArkTS/ETS 文件 | `*.ets`（排除 example/demo/sample/test） | ⭐⭐⭐ 高 | 最强鸿蒙化特征 |
+| 鸿蒙配置 | `module.json5`、`oh-package.json5`（排除 example/demo/sample/test） | ⭐⭐⭐ 高 | 鸿蒙特有配置 |
+| TypeScript | `*.ts`（含 `@ohos` 导入，排除 example/demo/sample/test） | ⭐⭐ 中 | 需配合 API 特征判断 |
+| NAPI C++ 文件 | `*.cpp`、`*.h`（含 `napi_*` 调用，排除 example/demo/sample/test） | ⭐⭐ 中 | Native 层绑定 |
+
+### 1.2 API 调用特征扫描
+
+| 特征 | 模式 | 说明 |
+|------|------|------|
+| 鸿蒙系统 API | `@ohos.*`、`import from '@ohos'` | 鸿蒙官方模块（核心代码范围） |
+| NAPI 绑定 | `napi_create_*`、`napi_get_*`、`napi_call_function` | Native 接口（核心代码范围） |
+| 鸿蒙组件 | `@Entry`、`@Component`、`@Builder` | ArkUI 声明式组件（核心代码范围） |
+| 鸿蒙生命周期 | `aboutToAppear`、`aboutToDisappear`、`onPageShow` | 组件/页面生命周期（核心代码范围） |
+| 鸿蒙服务 | `geoLocationManager`、`sensor`、`network` | 系统服务调用（核心代码范围） |
+
+### 1.3 判定规则
+
+| 扫描结果 | 判定 | 评分 | 后续操作 |
+|----------|------|------|----------|
+| 发现核心 `.ets` 文件 | ✅ 存在鸿蒙化 | 正常评分 | 进入深度分析 |
+| 发现核心 `module.json5` + NAPI 代码 | ✅ 存在鸿蒙化 | 正常评分 | 进入深度分析 |
+| 仅发现目录名含 `ohos` 但无代码文件 | ⚠️ 疑似未完成 | 0-30 分 | 标注"鸿蒙化代码疑似缺失" |
+| 未发现任何鸿蒙特征（核心代码） | ❌ 未实现鸿蒙化 | 0 分 | 标注"未发现鸿蒙化核心实现代码" |
+| 仅在 example/demo/sample/test 中发现鸿蒙代码 | ⚠️ 核心实现缺失 | 0 分 | 标注"鸿蒙化代码仅存在于示例中" |
+| 无法访问源码目录 | ❌ 无法检视 | 0 分 | 标注"源码目录不可访问" |
+
+---
+
+## 2. ArkTS 核心实现层稳定性检查清单
+
+### 2.1 异常处理完整性（25 分）
+
+**仅检视库核心实现代码**，不分析 example/demo/sample 及 test 代码。
+
+| # | 检查项 | 扣分 | 检查方式 | 关键路径定义 |
+|---|--------|------|----------|-------------|
+| E-01 | 核心公共 API 调用无 try-catch | **-10** | 搜索 `@ohos.*` 调用上下文是否包裹 try-catch（排除 example/demo/sample/test） | 库对外暴露方法、涉及系统资源的核心操作 |
+| E-02 | Promise rejection 未处理 | **-8** | 搜索 `.then()` 无 `.catch()`、await 无 try-catch | 所有异步操作链（核心实现） |
+| E-03 | 异常吞没 | **-7** | catch 块为空或仅 `console.log`，未恢复/上报/重新抛出 | 所有 catch 块（核心实现） |
+| E-04 | 参数验证缺失 | **-5** | 库公共 API 方法入口无类型/边界/空值检查 | 对外暴露的公共方法 |
+| E-05 | 异常类型窄化 | **-3** | 仅捕获特定异常类型，遗漏其他可能异常 | 涉及多种异常源的核心操作 |
+| E-06 | finally 缺失 | **-2** | 涉及资源操作但无 finally 清理路径 | 含资源分配的 try-catch（核心实现） |
+
+### 2.2 资源释放安全性（25 分）
+
+**仅检视库核心实现代码**，不分析 example/demo/sample 及 test 代码。
+
+| # | 检查项 | 扣分 | 检查方式 |
+|---|--------|------|----------|
+| R-01 | 系统资源未释放（sensor/location/network） | **-12** | 搜索核心代码中 `sensor.on()`/`geoLocationManager.on()` 等是否有对应 `.off()`/`.disable()`（排除 example/demo/sample/test） |
+| R-02 | 事件订阅未取消 | **-8** | 搜索核心代码中 `on()` 注册是否在组件 `aboutToDisappear` 或 Ability `onDestroy` 中对应 `off()`（排除 example/demo/sample/test） |
+| R-03 | Stream/Connection 泄露 | **-5** | 搜索 `createConnection`/`openSession` 是否有 `close`/`disconnect` |
+| R-04 | Timer 未清理 | **-5** | 搜索 `setInterval`/`setTimeout` 是否在销毁时 `clearInterval`/`clearTimeout` |
+| R-05 | Worker 未终止 | **-5** | 搜索 Worker 创建是否在适当时机 `terminate()` |
+
+### 2.3 并发安全（20 分）
+
+**仅检视库核心实现代码**，不分析 example/demo/sample 及 test 代码。
+
+| # | 检查项 | 扣分 | 检查方式 |
+|---|--------|------|----------|
+| C-01 | 主线程阻塞 | **-10** | 搜索核心 API 执行路径中是否存在耗时同步操作（大循环、同步 I/O、同步锁等待） |
+| C-02 | 共享状态无同步保护 | **-7** | 搜索多个异步回调修改同一状态变量，无锁/队列/原子操作 |
+| C-03 | 回调重入 | **-3** | 搜索异步回调可能重入导致状态混乱，缺少重入防护标志 |
+
+### 2.4 ArkTS 生命周期管理（10 分）
+
+**仅检视库核心实现代码**，不分析 example/demo/sample 及 test 代码。
+
+| # | 检查项 | 扣分 | 检查方式 |
+|---|--------|------|----------|
+| L-01 | aboutToDisappear 未清理 | **-8** | 库核心组件销毁钩子是否释放资源/移除监听/取消订阅 |
+| L-02 | @State 对象持有大引用 | **-2** | 核心状态变量持有大对象引用在组件销毁后未释放 |
+
+---
+
+## 3. C++ Native 核心层稳定性检查清单
+
+**仅检视库核心 NAPI 绑定和 C++ 实现代码**，不分析 example/demo/sample 及 test 代码。
+
+### 3.1 NAPI 跨语言调用（15 分）
+
+| # | 检查项 | 扣分 | 检查方式 |
+|---|--------|------|----------|
+| N-01 | napi_ref 创建/释放不匹配 | **-10** | 搜索核心 NAPI 代码中 `napi_create_reference` 和 `napi_delete_reference` 是否数量匹配、路径对称（排除 example/demo/sample/test） |
+| N-02 | napi_handle_scope 未清理 | **-8** | 搜索 `napi_open_handle_scope` 是否有对应 `napi_close_handle_scope` |
+| N-03 | napi_value 类型转换无边界检查 | **-5** | 搜索 `napi_get_value_*` 是否有类型检查和边界验证 |
+| N-04 | napi_create_async_work 缺少异常处理 | **-5** | 搜索异步 work 的 execute/complete 回调是否检查返回值 |
+| N-05 | Native 对象与 ArkTS 对象生命周期不一致 | **-3** | 搜索 Native 侧对象是否绑定 ArkTS 侧 GC 回调 |
+
+### 3.2 C++ 内存管理安全（10 分）
+
+| # | 检查项 | 扣分 | 检查方式 |
+|---|--------|------|----------|
+| M-01 | malloc/new 与 free/delete 不匹配 | **-8** | 搜索分配/释放是否对称，是否存在双重释放 |
+| M-02 | 异常路径资源未释放 | **-5** | 搜索 try/catch 中分配的资源是否在异常分支释放 |
+| M-03 | 未使用 RAII 管理资源 | **-3** | 搜索裸指针管理资源是否可改用智能指针 |
+
+---
+
+## 4. 核心功能调用链完整性检查清单
+
+**仅追踪库对外暴露的核心功能调用链**，不分析 example/demo/sample 中展示的调用链。
+
+### 4.1 跨层级调用链追踪
+
+| # | 检查项 | 扣分 | 检查方式 |
+|---|--------|------|----------|
+| CH-01 | ArkTS → Native 异常传播断裂 | **-10** | Native 异常是否通过 `napi_throw` 传播到 ArkTS 层 |
+| CH-02 | 跨模块调用异常未传播 | **-8** | 模块间调用异常是否正确传播而非被吞没 |
+| CH-03 | 核心功能调用链缺失异常处理节点 | **-7** | 追踪核心功能完整调用链，标注每个节点的异常处理状态 |
+
+---
+
+## 5. 特殊归零规则
+
+| 规则 | 条件 | 结果 |
+|------|------|------|
+| 归零规则 1 | Critical 级别问题 ≥ 5 个 | 直接评 0 分 |
+| 归零规则 2 | Critical 级别问题 ≥ 3 个 + Major 级别问题 ≥ 4 个 | 直接评 0 分 |
+| 归零规则 3 | 核心公共 API 异常处理完全缺失（≥ 3 个核心 API 调用无 try-catch，不含 example/demo 代码） | 直接评 0 分 |
+| 归零规则 4 | NAPI 引用管理完全不匹配（创建远多于释放） | 直接评 0 分 |
+| 归零规则 5 | 未发现鸿蒙化核心实现代码 | 0 分 |
+| 归零规则 6 | 源码目录不可访问 | 0 分 |
+
+---
+
+## 6. 评分规则参考
+
+> 评分计算方式、严重度映射、等级说明详见 [SCORING_RULES.md](SCORING_RULES.md)。
 | 归零规则 6 | 源码目录不可访问 | 0 分 |