@ohos-cpf/3rdloop 0.0.1

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

@@ -0,0 +1,129 @@
+# 稳定性检视报告模板
+
+> 生成报告时复制此模板，替换 `{占位符}` 内容。报告文件名：`稳定性检视报告.md`。
+
+---
+
+```markdown
+# {repoName} 稳定性检视报告
+
+## 一、检视概览
+
+| 字段 | 内容 |
+|------|------|
+| **仓库名称** | {repoName} |
+| **检视类型** | RN 稳定性检视 |
+| **检视时间** | {timestamp} |
+| **分析文件数** | {fileCount} |
+| **检视范围** | {鸿蒙代码定位结果摘要} |
+
+## 二、综合评分
+
+**综合评分：{score}/100**
+
+> 评分说明：采用严苛扣分制，6 个维度独立评分后汇总，最低 0 分
+
+| 维度 | 基础分 | 扣分 | 得分 |
+|------|--------|------|------|
+| 异常处理完整性 | 25 | {扣分} | {得分}/25 |
+| 资源释放安全性 | 20 | {扣分} | {得分}/20 |
+| 并发安全 | 20 | {扣分} | {得分}/20 |
+| ArkTS 生命周期管理 | 10 | {扣分} | {得分}/10 |
+| NAPI 跨语言调用 | 15 | {扣分} | {得分}/15 |
+| C++ 内存管理 | 10 | {扣分} | {得分}/10 |
+
+**调用链完整性扣分**：-{扣分} 分（CH-01~CH-03）
+
+**扣分明细**：
+- {检查项编号}：{问题描述}（{严重度}）：-{扣分值} 分
+- ……
+
+{归零规则触发时追加：}
+> ⚠️ 触发归零规则：{规则描述}，综合评分直接为 0 分
+
+## 三、检视范围
+
+### 鸿蒙代码定位结果
+
+**扫描策略**：通过文件类型 + API 特征 + 配置文件智能识别
+
+| 扫描维度 | 发现文件数 | 检视状态 |
+|----------|------------|----------|
+| `.ets` 文件 | {count} | ✅ 已检视（核心） |
+| `module.json5` | {count} | ✅ 已检视 |
+| NAPI C++ 文件 | {count} | ✅ 已检视 |
+| TurboModule 注册 | {count} 处 | ✅ 已检视 |
+| `@ohos` API 导入 | {count} 处 | ✅ 已检视 |
+
+**实际检视文件列表**：
+- `{文件路径}` ✅
+- ……
+
+## 四、检视维度明细
+
+### 4.1 异常处理完整性
+
+| 检查项编号 | 检查项 | 严重度 | 发现数量 | 扣分 | 详情 |
+|------------|--------|--------|----------|------|------|
+| E-01 | …… | …… | …… | …… | …… |
+| …… | …… | …… | …… | …… | …… |
+
+### 4.2 资源释放安全性
+……
+
+### 4.3 并发安全
+……
+
+### 4.4 ArkTS 生命周期管理
+……
+
+### 4.5 NAPI 跨语言调用
+……
+
+### 4.6 C++ 内存管理
+……
+
+## 五、调用链完整性分析
+
+### 5.1 关键功能调用链图
+
+**关键功能 1**：{功能名称}
+
+```
+调用链：{jsMethod} → {turboModuleMethod} → {nativeMethod}
+异常处理：✅ / ❌（标注每个节点）
+```
+
+### 5.2 异常传播链检查
+
+| 检查项编号 | 检查项 | 扣分 | 详情 |
+|------------|--------|------|------|
+| CH-01 | …… | …… | …… |
+
+## 六、问题清单
+
+| # | 文件 | 行号 | 检查项编号 | 严重度 | 描述 | 修复建议 |
+|---|------|------|------------|--------|------|----------|
+| …… | …… | …… | …… | …… | …… | …… |
+
+## 七、改进建议
+
+### 优先级 P0（Critical，必须修复）
+……
+
+### 优先级 P1（Major，强烈建议修复）
+……
+
+### 优先级 P2（Minor，建议改进）
+……
+
+---
+
+**报告生成时间**：{timestamp}
+```
+
+---
+
+## 报告格式约束
+
+> **重要**：报告必须包含 `**综合评分：XX/100**` 格式（粗体标记、中文冒号），且评分值位于"二、综合评分"章节，确保可被 `_parseRNLibraryScore` 函数正确解析。评分正则匹配优先级为 `综合评分` > `总体评分/评分` > `得分`。

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

@@ -0,0 +1,581 @@
+# RN 稳定性检视完整检查清单
+
+本文件包含所有检查项的详细说明、判定标准和代码示例。
+
+---
+
+## 一、异常处理完整性（维度总分 25 分）
+
+### E-01：关键 API 调用无 try-catch（-10 分）
+
+**判定标准**：涉及 `@ohos.*` 系统模块调用、网络请求、文件 I/O、蓝牙/传感器等系统资源操作的公共方法入口，若无 try-catch 包裹则触发。
+
+**RN 鸿蒙化典型场景**：
+- TurboModule 注册方法中对 `@ohos.*` API 的调用
+- Native Module 桥接方法中涉及系统资源操作
+- `source/ohos/` 下所有对外暴露的 ArkTS 方法
+
+```typescript
+// ❌ 触发 E-01（扣 10 分）
+async startTracking(options: TrackingOptions): Promise<void> {
+  await geoLocationManager.on('locationChange', this.request, this.callback);
+  // @ohos.geoLocationManager 调用无异常捕获
+}
+
+// ✅ 正确实现
+async startTracking(options: TrackingOptions): Promise<void> {
+  try {
+    await geoLocationManager.on('locationChange', this.request, this.callback);
+  } catch (e) {
+    throw new Error(`startTracking failed: ${(e as Error).message}`);
+  }
+}
+```
+
+### E-02：Promise rejection 未处理（-8 分）
+
+**判定标准**：
+- `.then()` 链无 `.catch()` 或 `.then(null, handler)`
+- `await` 调用未在 try-catch 中
+- TurboModule 返回 Promise 的方法未处理 rejection
+
+```typescript
+// ❌ 触发 E-02（扣 8 分）
+fetchData(): void {
+  this.httpClient.request(url)  // Promise 未 await 也未 catch
+    .then(data => this.processData(data));
+  // 缺少 .catch()
+}
+
+// ✅ 正确实现
+async fetchData(): Promise<void> {
+  try {
+    const data = await this.httpClient.request(url);
+    this.processData(data);
+  } catch (e) {
+    logger.error('fetchData failed', e);
+    throw new Error(`fetchData failed: ${(e as Error).message}`);
+  }
+}
+```
+
+### E-03：异常吞没（-7 分）
+
+**判定标准**：catch 块为空、仅 `console.log`/`console.error`，既不恢复状态、不重新抛出、也不通过回调/TurboModule 向 JS 层上报。
+
+```typescript
+// ❌ 触发 E-03（扣 7 分）
+async connect(url: string): Promise<void> {
+  try {
+    await this.socket.connect(url);
+  } catch (e) {
+    console.log('connect error'); // 仅打印，无处理
+  }
+}
+
+// ✅ 正确实现 - 重新抛出
+async connect(url: string): Promise<void> {
+  try {
+    await this.socket.connect(url);
+  } catch (e) {
+    throw new Error(`Socket connect failed: ${(e as Error).message}`);
+  }
+}
+
+// ✅ 正确实现 - 状态恢复 + 上报
+async connect(url: string): Promise<void> {
+  try {
+    await this.socket.connect(url);
+  } catch (e) {
+    this.connectionState = ConnectionState.DISCONNECTED;
+    this.emit('error', { message: (e as Error).message });
+  }
+}
+```
+
+### E-04：参数验证缺失（-5 分）
+
+**判定标准**：TurboModule 注册方法或公共 API 入口，对外部传入参数无类型检查、空值判断或边界验证。
+
+```typescript
+// ❌ 触发 E-04（扣 5 分）
+setItem(key: string, value: string): void {
+  this.storage.put(key, value); // 无参数验证
+}
+
+// ✅ 正确实现
+setItem(key: string, value: string): void {
+  if (!key || key.length === 0) {
+    throw new Error('key must not be empty');
+  }
+  if (typeof value !== 'string') {
+    throw new Error('value must be a string');
+  }
+  this.storage.put(key, value);
+}
+```
+
+### E-05：异常类型窄化（-3 分）
+
+**判定标准**：仅捕获特定异常类型（如仅 catch BusinessError），遗漏其他可能的异常类型。
+
+```typescript
+// ❌ 触发 E-05（扣 3 分）
+try {
+  await bluetooth.connect(deviceId);
+} catch (e) {
+  if ((e as BusinessError).code === 12345) {
+    // 仅处理特定业务错误，遗漏其他异常
+  }
+}
+
+// ✅ 正确实现
+try {
+  await bluetooth.connect(deviceId);
+} catch (e) {
+  if ((e as BusinessError).code === 12345) {
+    // 处理特定业务错误
+  } else {
+    // 处理其他异常
+    throw new Error(`Bluetooth connect failed: ${(e as Error).message}`);
+  }
+}
+```
+
+### E-06：finally 缺失（-2 分）
+
+**判定标准**：涉及资源操作（文件/网络/传感器）的方法，无 finally 块确保清理路径。
+
+```typescript
+// ❌ 触发 E-06（扣 2 分）
+async readFile(path: string): Promise<string> {
+  const file = fs.openSync(path);
+  try {
+    return fs.readTextSync(file.fd);
+  } catch (e) {
+    throw new Error(`Read failed: ${(e as Error).message}`);
+    // 异常路径未关闭文件
+  }
+}
+
+// ✅ 正确实现
+async readFile(path: string): Promise<string> {
+  let file: fs.File | null = null;
+  try {
+    file = fs.openSync(path);
+    return fs.readTextSync(file.fd);
+  } catch (e) {
+    throw new Error(`Read failed: ${(e as Error).message}`);
+  } finally {
+    if (file) {
+      fs.closeSync(file);
+    }
+  }
+}
+```
+
+---
+
+## 二、资源释放安全性（维度总分 20 分）
+
+### R-01：系统资源未释放（-10 分）
+
+**判定标准**：使用 `@ohos.*` 模块申请的系统资源（sensor/location/network/bluetooth/ble），在组件销毁或功能停止时未调用对应的 `unregister`/`disable`/`off` 释放。
+
+**RN 鸿蒙化关键关注点**：
+- TurboModule 中注册的系统资源监听
+- NativeEventEmitter 绑定的系统事件
+
+```typescript
+// ❌ 触发 R-01（扣 10 分）
+export class SensorModule extends TurboModule {
+  startAccelerometer(callback: Function): void {
+    sensor.on(sensor.SensorType.ACCELEROMETER, (data) => {
+      callback(data);
+    });
+    // 缺少 off() 释放！
+  }
+}
+
+// ✅ 正确实现
+export class SensorModule extends TurboModule {
+  private subscribed: boolean = false;
+
+  startAccelerometer(callback: Function): void {
+    sensor.on(sensor.SensorType.ACCELEROMETER, (data) => {
+      callback(data);
+    });
+    this.subscribed = true;
+  }
+
+  stopAccelerometer(): void {
+    if (this.subscribed) {
+      sensor.off(sensor.SensorType.ACCELEROMETER);
+      this.subscribed = false;
+    }
+  }
+
+  destroy(): void {
+    this.stopAccelerometer();
+  }
+}
+```
+
+### R-02：事件订阅未取消（-8 分）
+
+**判定标准**：通过 `on()` 注册的事件监听器（包括 `@ohos.*` 模块事件和 emitter 事件），未在组件销毁或模块卸载时通过 `off()` 移除。
+
+```typescript
+// ❌ 触发 R-02（扣 8 分）
+export class NetworkModule extends TurboModule {
+  addListener(eventName: string): void {
+    connection.on('netChange', (data) => {
+      this.sendEvent(eventName, data);
+    });
+    // 未保存订阅引用，无法取消
+  }
+}
+
+// ✅ 正确实现
+export class NetworkModule extends TurboModule {
+  private netChangeListener: Function | null = null;
+
+  addListener(eventName: string): void {
+    this.netChangeListener = (data) => {
+      this.sendEvent(eventName, data);
+    };
+    connection.on('netChange', this.netChangeListener);
+  }
+
+  removeListeners(): void {
+    if (this.netChangeListener) {
+      connection.off('netChange', this.netChangeListener);
+      this.netChangeListener = null;
+    }
+  }
+}
+```
+
+### R-03：Stream/Connection 泄露（-5 分）
+
+**判定标准**：打开的 I/O 流（`fs.open`/`socket`/`http` 连接）未在正确路径关闭。
+
+```typescript
+// ❌ 触发 R-03（扣 5 分）
+async fetchData(url: string): Promise<string> {
+  const httpClient = http.createHttp();
+  const response = await httpClient.request(url);
+  return response.result as string;
+  // httpClient 未 destroy()
+}
+
+// ✅ 正确实现
+async fetchData(url: string): Promise<string> {
+  const httpClient = http.createHttp();
+  try {
+    const response = await httpClient.request(url);
+    return response.result as string;
+  } finally {
+    httpClient.destroy();
+  }
+}
+```
+
+### R-04：Timer 未清理（-3 分）
+
+**判定标准**：`setInterval`/`setTimeout` 创建的定时器，未在组件/模块销毁时通过 `clearInterval`/`clearTimeout` 清除。
+
+### R-05：Worker 未终止（-3 分）
+
+**判定标准**：通过 `worker.ThreadWorker` 创建的 Worker 线程，未在适当时机调用 `terminate()`。
+
+---
+
+## 三、并发安全（维度总分 20 分）
+
+### C-01：主线程阻塞操作（-10 分）
+
+**判定标准**：在 UI 主线程执行耗时同步操作，包括：
+- 大循环计算（>100ms 可感知）
+- 同步文件 I/O（`fs.openSync`/`fs.readSync` 在主线程调用）
+- 同步网络请求
+- 同步数据库操作
+
+```typescript
+// ❌ 触发 C-01（扣 10 分）
+processLargeData(data: string): Result {
+  // 在主线程执行大量计算
+  const parsed = JSON.parse(data);  // 大 JSON 可能阻塞
+  for (let i = 0; i < parsed.items.length; i++) {
+    // 耗时循环
+  }
+  return result;
+}
+
+// ✅ 正确实现 - 使用 Worker
+async processLargeData(data: string): Promise<Result> {
+  const worker = new worker.ThreadWorker('workers/processor.ets');
+  return new Promise((resolve, reject) => {
+    worker.onmessage = (e) => {
+      worker.terminate();
+      resolve(e.data);
+    };
+    worker.onerror = (e) => {
+      worker.terminate();
+      reject(new Error(e.message));
+    };
+    worker.postMessage(data);
+  });
+}
+```
+
+### C-02：共享状态无同步保护（-7 分）
+
+**判定标准**：多个异步回调/Promise 修改同一状态变量，无锁机制、队列串行化或原子操作保护。
+
+```typescript
+// ❌ 触发 C-02（扣 7 分）
+export class DataModule extends TurboModule {
+  private cache: Map<string, string> = new Map();
+
+  async getValue(key: string): Promise<string | null> {
+    if (this.cache.has(key)) {
+      return this.cache.get(key)!;
+    }
+    const value = await this.fetchFromNetwork(key);
+    this.cache.set(key, value);  // 多个并发调用可能同时写入
+    return value;
+  }
+}
+
+// ✅ 正确实现 - 使用队列串行化
+export class DataModule extends TurboModule {
+  private cache: Map<string, string> = new Map();
+  private pendingRequests: Map<string, Promise<string>> = new Map();
+
+  async getValue(key: string): Promise<string | null> {
+    if (this.cache.has(key)) {
+      return this.cache.get(key)!;
+    }
+    if (this.pendingRequests.has(key)) {
+      return this.pendingRequests.get(key)!;
+    }
+    const promise = this.fetchFromNetwork(key).then(value => {
+      this.cache.set(key, value);
+      this.pendingRequests.delete(key);
+      return value;
+    });
+    this.pendingRequests.set(key, promise);
+    return promise;
+  }
+}
+```
+
+### C-03：回调重入无防护（-3 分）
+
+**判定标准**：异步回调可能重入导致状态混乱，缺少重入标志或互斥机制。
+
+```typescript
+// ❌ 触发 C-03（扣 3 分）
+async refreshData(): Promise<void> {
+  const data = await this.fetchData();
+  this.state = data;  // 多次调用 refreshData 可能导致状态不一致
+}
+
+// ✅ 正确实现
+private refreshing: boolean = false;
+async refreshData(): Promise<void> {
+  if (this.refreshing) return;
+  this.refreshing = true;
+  try {
+    const data = await this.fetchData();
+    this.state = data;
+  } finally {
+    this.refreshing = false;
+  }
+}
+```
+
+---
+
+## 四、ArkTS 生命周期管理（维度总分 10 分）
+
+### L-01：aboutToDisappear/onDestroy 未清理（-8 分）
+
+**判定标准**：自定义组件的 `aboutToDisappear()` 或 Ability 的 `onDestroy()` 未释放资源、移除监听、取消订阅。
+
+**RN 鸿蒙化关注点**：
+- TurboModule 的 `destroy()`/`invalidate()` 方法是否清理所有资源
+- RN Component 的鸿蒙化实现是否在 `aboutToDisappear` 中释放系统资源
+
+```typescript
+// ❌ 触发 L-01（扣 8 分）
+@Component
+export struct RNMapView {
+  private mapController: map.MapComponentController | null = null;
+
+  aboutToAppear(): void {
+    this.mapController = new map.MapComponentController();
+  }
+  // 缺少 aboutToDisappear 清理！
+}
+
+// ✅ 正确实现
+@Component
+export struct RNMapView {
+  private mapController: map.MapComponentController | null = null;
+
+  aboutToAppear(): void {
+    this.mapController = new map.MapComponentController();
+  }
+
+  aboutToDisappear(): void {
+    if (this.mapController) {
+      // 释放地图资源
+      this.mapController = null;
+    }
+  }
+}
+```
+
+### L-02：@State/@Link 对象持有大引用未释放（-2 分）
+
+**判定标准**：`@State`/`@Link` 装饰的变量持有大对象（图片/音频/大数据缓存），在组件销毁后未释放引用。
+
+---
+
+## 五、NAPI 跨语言调用安全（维度总分 15 分）
+
+### N-01：napi_ref 创建/释放不匹配（-10 分）
+
+**判定标准**：`napi_create_reference` 和 `napi_delete_reference` 数量不匹配，或释放路径不对称（如异常分支未释放）。
+
+```cpp
+// ❌ 触发 N-01（扣 10 分）
+static napi_value RegisterCallback(napi_env env, napi_callback_info info) {
+  napi_ref callbackRef;
+  napi_create_reference(env, argv[0], 1, &callbackRef);
+  // ... 使用 callbackRef ...
+  // 缺少 napi_delete_reference！
+  return nullptr;
+}
+
+// ✅ 正确实现
+static napi_value RegisterCallback(napi_env env, napi_callback_info info) {
+  napi_ref callbackRef;
+  napi_create_reference(env, argv[0], 1, &callbackRef);
+  // ... 使用 callbackRef ...
+  napi_delete_reference(env, callbackRef);  // 必须释放
+  return nullptr;
+}
+```
+
+### N-02：napi_handle_scope 未清理（-8 分）
+
+**判定标准**：`napi_open_handle_scope` 无对应 `napi_close_handle_scope`，或异常路径遗漏关闭。
+
+```cpp
+// ❌ 触发 N-02（扣 8 分）
+static napi_value ProcessData(napi_env env, napi_callback_info info) {
+  napi_handle_scope scope;
+  napi_open_handle_scope(env, &scope);
+  // ... 业务逻辑，可能提前返回 ...
+  if (error) {
+    return nullptr;  // 未关闭 scope！
+  }
+  napi_close_handle_scope(env, scope);
+  return result;
+}
+
+// ✅ 正确实现
+static napi_value ProcessData(napi_env env, napi_callback_info info) {
+  napi_handle_scope scope;
+  napi_open_handle_scope(env, &scope);
+  napi_value result = nullptr;
+  // ... 业务逻辑 ...
+  napi_close_handle_scope(env, scope);  // 始终关闭
+  return result;
+}
+```
+
+### N-03：napi_value 类型转换无边界检查（-5 分）
+
+**判定标准**：`napi_get_value_int32`/`napi_get_value_string_utf8` 等类型转换函数，调用前未使用 `napi_typeof` 验证类型。
+
+### N-04：napi_create_async_work 缺少异常处理（-5 分）
+
+**判定标准**：异步 work 的 execute/complete 回调未检查 `napi_status` 返回值。
+
+### N-05：Native 对象与 JS 对象生命周期不一致（-3 分）
+
+**判定标准**：C++ 侧对象未绑定 JS 侧 GC 回调（`napi_wrap` + finalize callback），导致 Native 对象泄露。
+
+---
+
+## 六、C++ 内存管理安全（维度总分 10 分）
+
+### M-01：malloc/new 与 free/delete 不匹配（-8 分）
+
+**判定标准**：
+- `malloc` 配 `delete` 或 `new` 配 `free`
+- 分配/释放数量不对称
+- 双重释放风险
+
+```cpp
+// ❌ 触发 M-01（扣 8 分）
+char* buffer = (char*)malloc(1024);
+// ...
+delete buffer;  // malloc 应配 free！
+
+// ✅ 正确实现
+char* buffer = (char*)malloc(1024);
+// ...
+free(buffer);
+```
+
+### M-02：异常路径资源未释放（-5 分）
+
+**判定标准**：try/catch 中分配的资源在异常分支未释放。
+
+```cpp
+// ❌ 触发 M-02（扣 5 分）
+void process() {
+  char* buffer = new char[1024];
+  someOperation();  // 可能抛出异常
+  delete[] buffer;  // 异常路径未执行
+}
+
+// ✅ 正确实现
+void process() {
+  char* buffer = new char[1024];
+  try {
+    someOperation();
+    delete[] buffer;
+  } catch (...) {
+    delete[] buffer;
+    throw;
+  }
+}
+```
+
+### M-03：未使用 RAII 管理资源（-3 分）
+
+**判定标准**：裸指针管理资源，可改用智能指针（`std::unique_ptr`/`std::shared_ptr`）但未使用。
+
+---
+
+## 七、调用链完整性（维度总分 5 分，独立于维度外额外扣分）
+
+### CH-01：ArkTS → Native 异常传播断裂（-10 分）
+
+**判定标准**：Native C++ 层异常未通过 `napi_throw_error`/`napi_throw_type_error` 传播到 ArkTS 层，导致上层调用者无法感知错误。
+
+### CH-02：跨模块调用异常未传播（-5 分）
+
+**判定标准**：TurboModule 间调用或模块间调用时，异常被吞没而非向调用者传播。
+
+### CH-03：关键功能调用链缺失异常处理节点（-3 分）
+
+**判定标准**：关键功能的完整调用链中，至少一个节点无异常处理。
+
+**必须追踪至少 3 个关键功能的完整调用链**，标注每个节点的异常处理状态。