@ohos-cpf/3rdloop 0.0.1

package/vendor/Server/Skills/rn-library-stability-check/references/SCORING_RULES.md

@@ -0,0 +1,138 @@
+# 评分规则详细说明
+
+> 本文档包含稳定性检视的完整评分规则，包括维度评分公式、归零规则、严重度映射和评分等级。
+
+---
+
+## 1. 维度评分公式
+
+采用**严苛扣分制**，每个维度独立计算扣分后汇总：
+
+| 维度 | 基础分 | 扣分上限 | 检查项范围 | 说明 |
+|------|--------|----------|------------|------|
+| 异常处理完整性 | 25 | -25 | E-01~E-06 | 各项扣分叠加，维度得分不低于 0 |
+| 资源释放安全性 | 20 | -20 | R-01~R-05 | 各项扣分叠加，维度得分不低于 0 |
+| 并发安全 | 20 | -20 | C-01~C-03 | 各项扣分叠加，维度得分不低于 0 |
+| ArkTS 生命周期 | 10 | -10 | L-01~L-02 | 各项扣分叠加，维度得分不低于 0 |
+| NAPI 跨语言调用 | 15 | -15 | N-01~N-05 | 各项扣分叠加，维度得分不低于 0 |
+| C++ 内存管理 | 10 | -10 | M-01~M-03 | 各项扣分叠加，维度得分不低于 0 |
+
+### 计算公式
+
+```
+维度得分 = max(0, 基础分 - 该维度累计扣分)
+
+综合评分 = Σ(各维度得分) - 调用链完整性扣分
+```
+
+- 综合评分范围：0-100
+- **调用链完整性**（CH-01~CH-03）的扣分在维度汇总后**额外扣减**，不占基础分
+- 调用链完整性扣分可能导致综合评分低于 0，此时取 0
+
+### 计算示例
+
+```
+异常处理完整性：25 - (10 + 8 + 0 + 0 + 0 + 0) = 7
+资源释放安全性：20 - (10 + 0 + 0 + 0 + 0) = 10
+并发安全：      20 - (0 + 0 + 0) = 20
+ArkTS 生命周期：10 - (8 + 0) = 2
+NAPI 跨语言：   15 - (0 + 0 + 0 + 0 + 0) = 15
+C++ 内存管理：  10 - (0 + 0 + 0) = 10
+维度汇总 = 7 + 10 + 20 + 2 + 15 + 10 = 64
+调用链扣分 = -10（CH-01 触发）
+综合评分 = 64 - 10 = 54
+```
+
+---
+
+## 2. 特殊归零规则
+
+归零规则**叠加于维度扣分之上**，触发任一规则则综合评分直接为 0 分：
+
+| 规则 | 条件 | 结果 | 说明 |
+|------|------|------|------|
+| 归零规则 1 | Critical 级别问题 ≥ 5 个 | **直接评 0 分** | 致命问题密集，稳定性不可接受 |
+| 归零规则 2 | Critical ≥ 3 个 + Major ≥ 4 个 | **直接评 0 分** | 严重问题组合触发，风险极高 |
+| 归零规则 3 | 关键路径异常处理完全缺失（≥ 3 个关键 API 调用无 try-catch） | **直接评 0 分** | 核心路径无防护，崩溃风险极高 |
+| 归零规则 4 | NAPI 引用管理完全不匹配（创建远多于释放） | **直接评 0 分** | Native 内存泄露不可控 |
+| 归零规则 5 | 未发现鸿蒙化代码 | **0 分** | 无检视对象 |
+| 归零规则 6 | 源码目录不可访问 | **0 分** | 无法执行检视 |
+
+### 归零规则判定流程
+
+```
+1. 完成所有维度检查后，统计 Critical 和 Major 数量
+2. 依次检查归零规则 1~4
+3. 若任一规则触发 → 综合评分 = 0，报告标注触发规则
+4. 若无归零规则触发 → 按维度评分公式计算
+5. 归零规则 5/6 在 Phase 1 即可判定，提前终止流程
+```
+
+---
+
+## 3. 严重度映射
+
+问题严重度按**单次扣分值**映射，用于问题清单分类和改进建议优先级排序：
+
+| 严重度 | 扣分范围 | 说明 | 报告标注 |
+|--------|----------|------|----------|
+| **Critical** | ≥ 8 分 | 致命问题，可能导致崩溃或严重资源泄露 | P0 |
+| **Major** | 5-7 分 | 严重问题，影响系统稳定性 | P1 |
+| **Minor** | ≤ 3 分（含负数） | 轻微问题，建议改进 | P2 |
+
+### 检查项严重度对照
+
+| 检查项 | 扣分 | 严重度 |
+|--------|------|--------|
+| E-01 | -10 | Critical |
+| E-02 | -8 | Critical |
+| E-03 | -7 | Major |
+| E-04 | -5 | Major |
+| E-05 | -3 | Minor |
+| E-06 | -2 | Minor |
+| R-01 | -10 | Critical |
+| R-02 | -8 | Critical |
+| R-03 | -5 | Major |
+| R-04 | -3 | Minor |
+| R-05 | -3 | Minor |
+| C-01 | -10 | Critical |
+| C-02 | -7 | Major |
+| C-03 | -3 | Minor |
+| L-01 | -8 | Critical |
+| L-02 | -2 | Minor |
+| N-01 | -10 | Critical |
+| N-02 | -8 | Critical |
+| N-03 | -5 | Major |
+| N-04 | -5 | Major |
+| N-05 | -3 | Minor |
+| M-01 | -8 | Critical |
+| M-02 | -5 | Major |
+| M-03 | -3 | Minor |
+| CH-01 | -10 | Critical |
+| CH-02 | -5 | Major |
+| CH-03 | -3 | Minor |
+
+---
+
+## 4. 评分等级说明
+
+| 分数段 | 等级 | 说明 | 改进建议 |
+|--------|------|------|----------|
+| 90-100 | 优秀 | 异常处理完善，资源管理规范，无稳定性风险 | 维持现有质量标准 |
+| 80-89 | 良好 | 存在少量 Minor 问题，不影响核心稳定性 | 建议修复 Minor 问题 |
+| 70-79 | 一般 | 存在 Major 级别问题需关注，有一定风险 | 修复 Major 问题后可提升至良好 |
+| 60-69 | 较差 | 存在 Critical 级别问题，稳定性堪忧 | 必须修复 Critical 问题 |
+| <60 | 严重不足 | 多个 Critical 问题，崩溃/泄露风险极高 | 全面重构稳定性设计 |
+| 0 | 不可用 | 触发归零规则或完全缺失稳定性设计 | 需要从头实现稳定性保障 |
+
+---
+
+## 5. 特殊情况评分
+
+| 情况 | 评分 | 报告标注 |
+|------|------|----------|
+| 未发现 `.ets` 文件和鸿蒙 API 特征 | 0 分 | "未发现鸿蒙化实现代码" |
+| 仅发现目录名含 `ohos` 但无代码文件 | 0-30 分 | "鸿蒙化代码疑似缺失" |
+| 发现鸿蒙代码但解析失败 | 0 分 | "鸿蒙代码解析失败"并说明原因 |
+| Critical 问题 ≥ 5 个 | 0 分 | "存在严重稳定性风险"（归零规则 1） |
+| 扫描到 `.ets` 但不在 `ohos/` 目录 | 正常评分 | 标注实际路径 |

package/vendor/Server/Skills/rn-library-stability-check/scripts/scan-harmony-code.py

@@ -0,0 +1,168 @@
+#!/usr/bin/env python3
+# @tool scan-harmony-code
+# @description 扫描 RN 三方库源码目录，智能识别鸿蒙化代码文件，输出分类统计结果
+# @param sourceDir: string - 源码目录绝对路径
+
+import sys
+import json
+import os
+import re
+
+def parse_args():
+    if len(sys.argv) > 1:
+        args = json.loads(sys.argv[1]) if sys.argv[1].startswith('{') else {}
+    else:
+        args = {}
+    source_dir = args.get('sourceDir', '')
+    if not source_dir:
+        print("Error: sourceDir parameter is required")
+        sys.exit(1)
+    if not os.path.isdir(source_dir):
+        print(f"Error: Source directory does not exist: {source_dir}")
+        sys.exit(1)
+    return source_dir
+
+def find_files(root, extensions=None, name_patterns=None):
+    results = []
+    for dirpath, dirnames, filenames in os.walk(root):
+        for filename in filenames:
+            filepath = os.path.join(dirpath, filename)
+            matched = False
+            if name_patterns:
+                for pattern in name_patterns:
+                    if pattern in filename:
+                        matched = True
+                        break
+            elif extensions:
+                for ext in extensions:
+                    if filename.endswith(ext):
+                        matched = True
+                        break
+            if matched:
+                results.append(filepath)
+    return results
+
+def grep_files(files, pattern):
+    regex = re.compile(pattern)
+    matched = []
+    for filepath in files:
+        try:
+            with open(filepath, 'r', encoding='utf-8', errors='ignore') as f:
+                if regex.search(f.read()):
+                    matched.append(filepath)
+        except (IOError, OSError):
+            pass
+    return matched
+
+def find_dirs(root, keywords):
+    results = []
+    for dirpath, dirnames, _ in os.walk(root):
+        for dirname in dirnames:
+            for kw in keywords:
+                if kw in dirname.lower():
+                    results.append(os.path.join(dirpath, dirname))
+                    break
+    return results
+
+def main():
+    source_dir = parse_args()
+
+    print("=== 鸿蒙化代码扫描结果 ===")
+    print(f"扫描目录: {source_dir}")
+    print()
+
+    # 1. ArkTS/ETS 文件
+    print("--- 1. ArkTS/ETS 文件 ---")
+    ets_files = find_files(source_dir, extensions=['.ets'])
+    if ets_files:
+        print(f"发现 {len(ets_files)} 个 .ets 文件:")
+        for f in ets_files:
+            print(f"  {f}")
+    else:
+        print("未发现 .ets 文件")
+    print()
+
+    # 2. 鸿蒙配置文件
+    print("--- 2. 鸿蒙配置文件 ---")
+    config_files = find_files(source_dir, name_patterns=['module.json5', 'oh-package.json5'])
+    if config_files:
+        print(f"发现 {len(config_files)} 个鸿蒙配置文件:")
+        for f in config_files:
+            print(f"  {f}")
+    else:
+        print("未发现鸿蒙配置文件")
+    print()
+
+    # 3. @ohos API 导入
+    print("--- 3. @ohos API 导入 ---")
+    ts_ets_files = find_files(source_dir, extensions=['.ets', '.ts'])
+    ohos_files = grep_files(ts_ets_files, r'import.*@ohos')
+    if ohos_files:
+        print(f"发现 {len(ohos_files)} 个文件含 @ohos API 导入:")
+        for f in ohos_files:
+            print(f"  {f}")
+    else:
+        print("未发现 @ohos API 导入")
+    print()
+
+    # 4. NAPI C++ 文件
+    print("--- 4. NAPI C++ 文件 ---")
+    cpp_files = find_files(source_dir, extensions=['.cpp', '.h'])
+    napi_files = grep_files(cpp_files, r'napi_')
+    if napi_files:
+        print(f"发现 {len(napi_files)} 个 NAPI 相关 C++ 文件:")
+        for f in napi_files:
+            print(f"  {f}")
+    else:
+        print("未发现 NAPI C++ 文件")
+    print()
+
+    # 5. TurboModule/NativeModule 注册
+    print("--- 5. TurboModule/NativeModule 注册 ---")
+    all_src = ts_ets_files + cpp_files
+    turbo_files = grep_files(all_src, r'TurboModule|NativeModule|registerModule')
+    if turbo_files:
+        print(f"发现 {len(turbo_files)} 个 TurboModule/NativeModule 注册文件:")
+        for f in turbo_files:
+            print(f"  {f}")
+    else:
+        print("未发现 TurboModule/NativeModule 注册代码")
+    print()
+
+    # 6. 目录标识
+    print("--- 6. 目录标识 ---")
+    ohos_dirs = find_dirs(source_dir, ['ohos', 'harmony', 'openharmony'])
+    if ohos_dirs:
+        print(f"发现 {len(ohos_dirs)} 个鸿蒙相关目录:")
+        for d in ohos_dirs:
+            print(f"  {d}")
+    else:
+        print("未发现鸿蒙相关目录名")
+    print()
+
+    # 总结
+    ets_count = len(ets_files)
+    config_count = len(config_files)
+    napi_count = len(napi_files)
+    turbo_count = len(turbo_files)
+    ohos_dir_count = len(ohos_dirs)
+
+    print("=== 扫描总结 ===")
+    print(f"  .ets 文件:           {ets_count}")
+    print(f"  鸿蒙配置文件:        {config_count}")
+    print(f"  @ohos API 导入文件:  {len(ohos_files)}")
+    print(f"  NAPI C++ 文件:       {napi_count}")
+    print(f"  TurboModule 注册:    {turbo_count}")
+    print(f"  鸿蒙相关目录:        {ohos_dir_count}")
+    print()
+
+    total = ets_count + config_count + napi_count + turbo_count
+    if total > 0:
+        print(f"判定: ✅ 存在鸿蒙化代码 ({total} 个核心文件)")
+    elif ohos_dir_count > 0:
+        print("判定: ⚠️ 疑似鸿蒙化（有目录标识但无代码文件）")
+    else:
+        print("判定: ❌ 未发现鸿蒙化代码")
+
+if __name__ == '__main__':
+    main()