@ohos-cpf/3rdloop 0.0.2 → 0.0.4

package/vendor/Server/Skills/rn-ohos-xts-generator/references/COVERAGE_ANALYZER.md

@@ -1,147 +1,147 @@
-# 测试覆盖率分析器
-
----
-
-## 一、模块概述
-
-测试覆盖率分析器用于分析现有 XTS 测试文件，识别已覆盖和未覆盖的 API，为补充测试用例提供依据。
-
----
-
-## 二、分析目标
-
-### 2.1 测试套件信息
-
-- describe 块名称
-- 测试函数（it）列表
-- 测试级别分布
-
-### 2.2 API 覆盖信息
-
-- 已测试的方法列表
-- 已测试的参数组合
-- 已测试的事件
-- 已测试的错误码
-- 已测试的边界值
-
-### 2.3 测试模式识别
-
-- TurboModule 方法测试
-- NativeEventEmitter 事件测试
-- NativeComponent 组件测试
-- 权限相关测试
-
----
-
-## 三、分析步骤
-
-### 3.1 定位测试文件
-
-```bash
-# RN 三方库 XTS Jest 测试文件通常位于
-{RN_TEST_PROJECT}/__tests__/
-# 或用户指定的测试目录
-```
-
-### 3.2 提取测试用例信息
-
-搜索测试文件中的模式：
-
-```bash
-# 搜索所有 describe 块
-grep -r "describe(" __tests__/ --include="*.test.ts"
-
-# 搜索所有 it 函数
-grep -r "it(" __tests__/ --include="*.test.ts"
-
-# 搜索所有 @tc.number
-grep -r "@tc.number" __tests__/ --include="*.test.ts"
-```
-
-### 3.3 与 API 清单对比
-
-将提取的测试用例与源码解析阶段输出的 API 清单进行对比：
-
-```
-=== 覆盖率分析报告 ===
-
-[总 API 数] 10
-[已覆盖] 6 (60%)
-[未覆盖] 4 (40%)
-
-[已覆盖 API]
-✅ prepareRecordingAtPath - 3 个测试用例
-✅ startRecording - 2 个测试用例
-✅ stopRecording - 2 个测试用例
-✅ isRecording - 1 个测试用例
-✅ requestAuthorization - 1 个测试用例
-✅ AudioUtils.FilesDirectoryPath - 1 个测试用例
-
-[未覆盖 API]
-❌ pauseRecording - 无测试用例
-❌ resumeRecording - 无测试用例
-❌ onProgress 事件 - 无测试用例
-❌ onFinishRecording 事件 - 无测试用例
-
-[测试级别分布]
-LEVEL0: 1 个
-LEVEL1: 5 个
-LEVEL2: 3 个
-LEVEL3: 1 个
-```
-
----
-
-## 四、覆盖率驱动模式
-
-### 4.1 触发条件
-
-当用户提供覆盖率报告或要求补充测试时，使用覆盖率驱动模式。
-
-### 4.2 处理流程
-
-```
-1. 读取覆盖率报告（或执行覆盖分析）
-2. 提取未覆盖的 API 列表
-3. 按优先级排序未覆盖项
-4. 为每个未覆盖项生成测试用例
-5. 输出补充测试文件
-```
-
-### 4.3 优先级排序
-
-| 优先级 | 未覆盖项类型 | 说明 |
-|--------|------------|------|
-| P0 | 核心方法 | 库的主要功能方法 |
-| P1 | 状态查询方法 | 返回状态信息的方法 |
-| P1 | 权限方法 | 涉及权限的方法 |
-| P2 | 事件回调 | NativeEventEmitter 事件 |
-| P2 | 辅助方法 | pause/resume 等 |
-| P3 | 常量验证 | 路径常量等 |
-
----
-
-## 五、输出格式
-
-### 5.1 覆盖率报告
-
-```
-=== @react-native-ohos/react-native-audio 覆盖率报告 ===
-
-总 API 数: 10
-已覆盖: 6 (60%)
-未覆盖: 4 (40%)
-
-建议补充的测试用例:
-1. [P0] pauseRecording - 正常暂停流程
-2. [P0] resumeRecording - 正常恢复流程
-3. [P1] onProgress 事件 - 录音进度回调
-4. [P1] onFinishRecording 事件 - 录音完成回调
-```
-
-### 5.2 补充测试建议
-
-根据覆盖率分析结果，生成具体的补充测试建议，包括：
-- 需要补充的测试用例名称
-- 建议的测试级别
-- 建议的测试类型（PARAM/ERROR/RETURN/EVENT）
+# 测试覆盖率分析器
+
+---
+
+## 一、模块概述
+
+测试覆盖率分析器用于分析现有 XTS 测试文件，识别已覆盖和未覆盖的 API，为补充测试用例提供依据。
+
+---
+
+## 二、分析目标
+
+### 2.1 测试套件信息
+
+- describe 块名称
+- 测试函数（it）列表
+- 测试级别分布
+
+### 2.2 API 覆盖信息
+
+- 已测试的方法列表
+- 已测试的参数组合
+- 已测试的事件
+- 已测试的错误码
+- 已测试的边界值
+
+### 2.3 测试模式识别
+
+- TurboModule 方法测试
+- NativeEventEmitter 事件测试
+- NativeComponent 组件测试
+- 权限相关测试
+
+---
+
+## 三、分析步骤
+
+### 3.1 定位测试文件
+
+```bash
+# RN 三方库 XTS Jest 测试文件通常位于
+{RN_TEST_PROJECT}/__tests__/
+# 或用户指定的测试目录
+```
+
+### 3.2 提取测试用例信息
+
+搜索测试文件中的模式：
+
+```bash
+# 搜索所有 describe 块
+grep -r "describe(" __tests__/ --include="*.test.ts"
+
+# 搜索所有 it 函数
+grep -r "it(" __tests__/ --include="*.test.ts"
+
+# 搜索所有 @tc.number
+grep -r "@tc.number" __tests__/ --include="*.test.ts"
+```
+
+### 3.3 与 API 清单对比
+
+将提取的测试用例与源码解析阶段输出的 API 清单进行对比：
+
+```
+=== 覆盖率分析报告 ===
+
+[总 API 数] 10
+[已覆盖] 6 (60%)
+[未覆盖] 4 (40%)
+
+[已覆盖 API]
+✅ prepareRecordingAtPath - 3 个测试用例
+✅ startRecording - 2 个测试用例
+✅ stopRecording - 2 个测试用例
+✅ isRecording - 1 个测试用例
+✅ requestAuthorization - 1 个测试用例
+✅ AudioUtils.FilesDirectoryPath - 1 个测试用例
+
+[未覆盖 API]
+❌ pauseRecording - 无测试用例
+❌ resumeRecording - 无测试用例
+❌ onProgress 事件 - 无测试用例
+❌ onFinishRecording 事件 - 无测试用例
+
+[测试级别分布]
+LEVEL0: 1 个
+LEVEL1: 5 个
+LEVEL2: 3 个
+LEVEL3: 1 个
+```
+
+---
+
+## 四、覆盖率驱动模式
+
+### 4.1 触发条件
+
+当用户提供覆盖率报告或要求补充测试时，使用覆盖率驱动模式。
+
+### 4.2 处理流程
+
+```
+1. 读取覆盖率报告（或执行覆盖分析）
+2. 提取未覆盖的 API 列表
+3. 按优先级排序未覆盖项
+4. 为每个未覆盖项生成测试用例
+5. 输出补充测试文件
+```
+
+### 4.3 优先级排序
+
+| 优先级 | 未覆盖项类型 | 说明 |
+|--------|------------|------|
+| P0 | 核心方法 | 库的主要功能方法 |
+| P1 | 状态查询方法 | 返回状态信息的方法 |
+| P1 | 权限方法 | 涉及权限的方法 |
+| P2 | 事件回调 | NativeEventEmitter 事件 |
+| P2 | 辅助方法 | pause/resume 等 |
+| P3 | 常量验证 | 路径常量等 |
+
+---
+
+## 五、输出格式
+
+### 5.1 覆盖率报告
+
+```
+=== @react-native-ohos/react-native-audio 覆盖率报告 ===
+
+总 API 数: 10
+已覆盖: 6 (60%)
+未覆盖: 4 (40%)
+
+建议补充的测试用例:
+1. [P0] pauseRecording - 正常暂停流程
+2. [P0] resumeRecording - 正常恢复流程
+3. [P1] onProgress 事件 - 录音进度回调
+4. [P1] onFinishRecording 事件 - 录音完成回调
+```
+
+### 5.2 补充测试建议
+
+根据覆盖率分析结果，生成具体的补充测试建议，包括：
+- 需要补充的测试用例名称
+- 建议的测试级别
+- 建议的测试类型（PARAM/ERROR/RETURN/EVENT）

package/vendor/Server/Skills/rn-ohos-xts-generator/references/DESIGN_DOC_GUIDE.md

@@ -1,148 +1,148 @@
-# 测试设计文档生成器
-
----
-
-## 一、模块概述
-
-测试设计文档生成器负责在生成测试用例的同时，同步生成结构化的测试设计文档，确保测试用例和测试设计文档的一致性和完整性。
-
----
-
-## 二、生成模式
-
-| 模式 | 描述 | 适用场景 |
-|------|------|---------|
-| **完整模式** | 包含所有章节的完整测试设计文档 | 重要 API、新功能开发 |
-| **简化模式** | 核心章节的简化测试设计文档 | 快速迭代、辅助功能 |
-
----
-
-## 三、测试设计文档模板
-
-### 3.1 完整模式模板
-
-```markdown
-# [库名] XTS 测试设计文档
-
-## 1. 测试概述
-
-### 1.1 测试目标
-为 @react-native-ohos/[库名] 生成 XTS 测试用例，覆盖以下功能：
-- [功能1]
-- [功能2]
-- [功能3]
-
-### 1.2 测试范围
-- 测试平台：HarmonyOS
-- 测试框架：Jest
-- 被测库版本：[版本号]
-- 被测库路径：[oh_modules 路径或接口规格说明文档路径]
-
-### 1.3 测试环境
-- OH_ROOT：[路径]
-- RN_TEST_PROJECT：[路径]
-
-## 2. API 清单
-
-### 2.1 TurboModule 方法
-
-| 方法名 | 参数 | 返回值 | 类型 | 实现状态 |
-|--------|------|--------|------|---------|
-| method1 | param1: string | boolean | 同步 | ✅ 已实现 |
-| method2 | 无 | Promise\<void\> | 异步 | ✅ 已实现 |
-| method3 | data: Object | void | 同步 | ❌ 未实现 |
-
-### 2.2 事件列表
-
-| 事件名 | 回调参数 | 实现状态 |
-|--------|---------|---------|
-| onEvent1 | { data: string } | ✅ 已实现 |
-| onEvent2 | { status: number } | ⚠️ 可能不稳定 |
-
-### 2.3 常量列表
-
-| 常量名 | 类型 | 说明 |
-|--------|------|------|
-| CONSTANT1 | string | 描述 |
-| CONSTANT2 | number | 描述 |
-
-## 3. 测试用例设计
-
-### 3.1 [API名称] 测试
-
-#### 3.1.1 正常参数测试
-
-| 用例编号 | 用例名称 | 输入 | 预期输出 | 级别 |
-|---------|---------|------|---------|------|
-| SUB_RNOH_XXX_METHOD_PARAM_0001 | testMethodNormal001 | 正常参数 | 返回 true | LEVEL1 |
-| SUB_RNOH_XXX_METHOD_PARAM_0002 | testMethodEmptyParam001 | 空参数 | 抛出异常 | LEVEL2 |
-
-#### 3.1.2 错误码测试
-
-| 用例编号 | 用例名称 | 输入 | 预期错误码 | 级别 |
-|---------|---------|------|-----------|------|
-| SUB_RNOH_XXX_METHOD_ERROR_401_0001 | testMethodError401001 | 无效参数 | 401 | LEVEL3 |
-
-### 3.2 [事件名称] 测试
-
-| 用例编号 | 用例名称 | 触发条件 | 预期结果 | 级别 |
-|---------|---------|---------|---------|------|
-| SUB_RNOH_XXX_EVENT_EVENT_0001 | testEventCallback001 | 正常触发 | 回调被调用 | LEVEL1 |
-
-## 4. 平台兼容性说明
-
-### 4.1 HarmonyOS 可用 API
-- [API 列表]
-
-### 4.2 HarmonyOS 不可用 API（不测试）
-- [API 列表及原因]
-
-### 4.3 需要特殊处理的 API
-- [API 列表及处理方式]
-
-## 5. 权限需求
-
-| 权限名 | 涉及 API | 说明 |
-|--------|---------|------|
-| ohos.permission.MICROPHONE | startRecording | 录音功能 |
-
-## 6. 已知限制
-
-1. [限制1说明]
-2. [限制2说明]
-```
-
-### 3.2 简化模式模板
-
-```markdown
-# [库名] XTS 测试设计文档（简化版）
-
-## API 清单
-[API 列表表格]
-
-## 测试用例
-[测试用例列表表格]
-
-## 平台兼容性
-[可用/不可用 API 列表]
-```
-
----
-
-## 四、命名规范
-
-```
-格式: [测试文件名].design.md
-示例:
-  - AudioRecorderTest.test.ts → AudioRecorderTest.test.design.md
-  - AudioUtilsTest.test.ts → AudioUtilsTest.test.design.md
-```
-
----
-
-## 五、同步生成原则
-
-- **一一对应**：每个测试用例都有对应的测试设计文档场景
-- **内容一致**：设计文档内容必须与测试用例实现保持一致
-- **版本同步**：测试用例修改时，设计文档必须同步更新
-- **完整覆盖**：设计文档必须涵盖所有测试场景
+# 测试设计文档生成器
+
+---
+
+## 一、模块概述
+
+测试设计文档生成器负责在生成测试用例的同时，同步生成结构化的测试设计文档，确保测试用例和测试设计文档的一致性和完整性。
+
+---
+
+## 二、生成模式
+
+| 模式 | 描述 | 适用场景 |
+|------|------|---------|
+| **完整模式** | 包含所有章节的完整测试设计文档 | 重要 API、新功能开发 |
+| **简化模式** | 核心章节的简化测试设计文档 | 快速迭代、辅助功能 |
+
+---
+
+## 三、测试设计文档模板
+
+### 3.1 完整模式模板
+
+```markdown
+# [库名] XTS 测试设计文档
+
+## 1. 测试概述
+
+### 1.1 测试目标
+为 @react-native-ohos/[库名] 生成 XTS 测试用例，覆盖以下功能：
+- [功能1]
+- [功能2]
+- [功能3]
+
+### 1.2 测试范围
+- 测试平台：HarmonyOS
+- 测试框架：Jest
+- 被测库版本：[版本号]
+- 被测库路径：[oh_modules 路径或接口规格说明文档路径]
+
+### 1.3 测试环境
+- OH_ROOT：[路径]
+- RN_TEST_PROJECT：[路径]
+
+## 2. API 清单
+
+### 2.1 TurboModule 方法
+
+| 方法名 | 参数 | 返回值 | 类型 | 实现状态 |
+|--------|------|--------|------|---------|
+| method1 | param1: string | boolean | 同步 | ✅ 已实现 |
+| method2 | 无 | Promise\<void\> | 异步 | ✅ 已实现 |
+| method3 | data: Object | void | 同步 | ❌ 未实现 |
+
+### 2.2 事件列表
+
+| 事件名 | 回调参数 | 实现状态 |
+|--------|---------|---------|
+| onEvent1 | { data: string } | ✅ 已实现 |
+| onEvent2 | { status: number } | ⚠️ 可能不稳定 |
+
+### 2.3 常量列表
+
+| 常量名 | 类型 | 说明 |
+|--------|------|------|
+| CONSTANT1 | string | 描述 |
+| CONSTANT2 | number | 描述 |
+
+## 3. 测试用例设计
+
+### 3.1 [API名称] 测试
+
+#### 3.1.1 正常参数测试
+
+| 用例编号 | 用例名称 | 输入 | 预期输出 | 级别 |
+|---------|---------|------|---------|------|
+| SUB_RNOH_XXX_METHOD_PARAM_0001 | testMethodNormal001 | 正常参数 | 返回 true | LEVEL1 |
+| SUB_RNOH_XXX_METHOD_PARAM_0002 | testMethodEmptyParam001 | 空参数 | 抛出异常 | LEVEL2 |
+
+#### 3.1.2 错误码测试
+
+| 用例编号 | 用例名称 | 输入 | 预期错误码 | 级别 |
+|---------|---------|------|-----------|------|
+| SUB_RNOH_XXX_METHOD_ERROR_401_0001 | testMethodError401001 | 无效参数 | 401 | LEVEL3 |
+
+### 3.2 [事件名称] 测试
+
+| 用例编号 | 用例名称 | 触发条件 | 预期结果 | 级别 |
+|---------|---------|---------|---------|------|
+| SUB_RNOH_XXX_EVENT_EVENT_0001 | testEventCallback001 | 正常触发 | 回调被调用 | LEVEL1 |
+
+## 4. 平台兼容性说明
+
+### 4.1 HarmonyOS 可用 API
+- [API 列表]
+
+### 4.2 HarmonyOS 不可用 API（不测试）
+- [API 列表及原因]
+
+### 4.3 需要特殊处理的 API
+- [API 列表及处理方式]
+
+## 5. 权限需求
+
+| 权限名 | 涉及 API | 说明 |
+|--------|---------|------|
+| ohos.permission.MICROPHONE | startRecording | 录音功能 |
+
+## 6. 已知限制
+
+1. [限制1说明]
+2. [限制2说明]
+```
+
+### 3.2 简化模式模板
+
+```markdown
+# [库名] XTS 测试设计文档（简化版）
+
+## API 清单
+[API 列表表格]
+
+## 测试用例
+[测试用例列表表格]
+
+## 平台兼容性
+[可用/不可用 API 列表]
+```
+
+---
+
+## 四、命名规范
+
+```
+格式: [测试文件名].design.md
+示例:
+  - AudioRecorderTest.test.ts → AudioRecorderTest.test.design.md
+  - AudioUtilsTest.test.ts → AudioUtilsTest.test.design.md
+```
+
+---
+
+## 五、同步生成原则
+
+- **一一对应**：每个测试用例都有对应的测试设计文档场景
+- **内容一致**：设计文档内容必须与测试用例实现保持一致
+- **版本同步**：测试用例修改时，设计文档必须同步更新
+- **完整覆盖**：设计文档必须涵盖所有测试场景