@ohos-cpf/3rdloop 0.0.2 → 0.0.4

package/vendor/Server/Skills/rn-library-test-coverage-check/references/REPORT_TEMPLATE.md

@@ -1,209 +1,220 @@
-# 报告格式模板
-
-本文档定义 RNLibraryTestCoverageCheckSkill 最终输出报告 `用例覆盖度检视报告.md` 的格式模板。
-
----
-
-## 格式要求
-
-> ⚠️ **关键格式约束**：
-> 1. 综合评分必须使用 `**综合评分：XX/100**` 格式（粗体标记、中文冒号）
-> 2. 每个维度必须包含 `**维度评分：XX/100**` 格式
-> 3. 覆盖度明细必须列出每个公开接口的覆盖状态
-> 4. 评分正则匹配优先级：`综合评分` > `总体评分/评分` > `得分`
-
----
-
-## 完整模板
-
-```markdown
-# {repoName} 用例覆盖度检视报告
-
-## 一、检视概览
-
-| 字段 | 内容 |
-|------|------|
-| **仓库名称** | {repoName} |
-| **检视类型** | RN 用例覆盖度检视（脚本自动化） |
-| **检视时间** | {timestamp} |
-| **公开接口总数** | {totalInterfaces} |
-| **平台特有接口数（排除）** | {platformSpecificCount} |
-| **有效接口数** | {effectiveInterfaceCount} |
-| **已覆盖接口数** | {coveredInterfaces} |
-| **test 目录接口覆盖率** | {testCoverageRate}% |
-| **DEMO 目录接口覆盖率** | {demoCoverageRate}% |
-| **综合接口覆盖率（原始）** | {rawMaxCoverage}% |
-| **有效综合接口覆盖率（排除平台特有）** | {effectiveCoverageRate}% |
-| **鸿蒙测试文件数** | {testFileCount} |
-| **检视范围** | {鸿蒙代码定位结果摘要} |
-
-## 二、脚本执行记录
-
-| 步骤 | 脚本 | 参数 | 产出文件 | 状态 |
-|------|------|------|----------|------|
-| Phase 2 | rn-extract-interfaces.cjs | --repoDir {ohosDir} --output interface-spec.json | interface-spec.json | ✅ |
-| Phase 3 | rn-analyze-test-coverage.cjs | --spec {specPath} --libroot {ohosDir} | test-coverage-report.md | ✅ |
-| Phase 4 | rn-analyze-demo-coverage.cjs | --spec {specPath} --libroot {ohosDir} --src {demoRoot} | demo-coverage-report.md | ✅/⚠️ |
-
-## 二·一、平台特有接口排除清单
-
-> 以下接口被识别为 Android/iOS 平台特有接口，从未覆盖列表中排除，不计入扣分和归零规则判定。
-
-| 接口名称 | 类名 | 判定特征 | 判定依据 | 排除原因 |
-|----------|------|----------|----------|----------|
-| {fullName} | {className} | 特征{N} | {详细说明} | {Android专属/iOS专属/无鸿蒙侧实现} |
-
-> 若无平台特有接口，填写：「本次检视未识别到平台特有接口，所有未覆盖接口均计入有效未覆盖列表。」
-
-## 三、综合评分
-
-**综合评分：{score}/100**
-
-> 评分等级：{level}。{levelDescription}
-
-> 综合接口覆盖率：{coverageRate}%
-
-| 维度 | 权重 | 基础分 | 扣分 | 得分 | 子评分 |
-|------|------|--------|------|------|--------|
-| 公开接口覆盖率 | 70% | 70 | {扣分} | {得分}/70 | {子评分}/100 |
-| 测试质量 | 30% | 30 | {扣分} | {得分}/30 | {子评分}/100 |
-
-### 扣分明细
-
-| 检查项编号 | 检查项 | 严重度 | 数量 | 单项扣分 | 小计 | 详情 |
-|------------|--------|--------|------|----------|------|------|
-| RTC-01 | 核心接口未覆盖 | Critical | {count} | -20 | {total} | {未覆盖核心接口列表} |
-| RTC-02 | 重要接口未覆盖 | Major | {count} | -15 | {total} | {未覆盖重要接口列表} |
-| RTC-04 | 可选接口未覆盖 | Minor | {count} | -3 | {total} | {未覆盖可选接口列表} |
-| RTC-05 | 接口参数组合未覆盖 | Major | {count} | -5 | {total} | {详情} |
-| RTC-06 | 回调/事件接口未覆盖 | Major | {count} | -8 | {total} | {未覆盖事件接口列表} |
-| RTC-03 | 边界场景缺失 | Minor | {count} | -5 | {total} | {详情} |
-| RTC-07 | 测试框架覆盖度 | Minor | {count} | -5 | {total} | {详情} |
-
-{归零规则触发时追加：}
-> ⚠️ 触发归零规则：{规则描述}，综合评分直接为 0 分
-
-## 四、检视范围
-
-### 鸿蒙代码定位结果
-
-**扫描策略**：脚本自动检测 + AST/正则双层匹配
-
-| 扫描维度 | 发现文件数 | 检视状态 |
-|----------|------------|----------|
-| 测试文件 | {count} | ✅ 已检视 |
-| Demo 文件 | {count} | ✅ 已检视 |
-| 接口规格 | {count} 个接口 | ✅ 已提取 |
-
-### 脚本扫描详情
-
-**测试覆盖率扫描**：
-- 测试目录：{testDir}
-- 扫描文件数：{testFileCount}
-- 匹配模式：{mode}（AST/正则）
-
-**Demo 覆盖率扫描**：
-- Demo 目录：{demoDir}
-- 扫描文件数：{demoFileCount}
-- 匹配模式：{mode}（AST/正则）
-
-## 五、检视维度明细
-
-### 5.1 公开接口覆盖率
-
-**维度评分：{dim1SubScore}/100**
-
-| 检查项编号 | 检查项 | 严重度 | 发现数量 | 扣分 | 详情 |
-|------------|--------|--------|----------|------|------|
-| RTC-01 | 核心接口未覆盖 | Critical | {count} | {扣分} | {详情} |
-| RTC-02 | 重要接口未覆盖 | Major | {count} | {扣分} | {详情} |
-| RTC-04 | 可选接口未覆盖 | Minor | {count} | {扣分} | {详情} |
-| RTC-05 | 接口参数组合未覆盖 | Major | {count} | {扣分} | {详情} |
-| RTC-06 | 回调/事件接口未覆盖 | Major | {count} | {扣分} | {详情} |
-
-### 5.2 测试质量
-
-**维度评分：{dim2SubScore}/100**
-
-| 检查项编号 | 检查项 | 严重度 | 发现数量 | 扣分 | 详情 |
-|------------|--------|--------|----------|------|------|
-| RTC-03 | 边界场景缺失 | Minor | {count} | {扣分} | {详情} |
-| RTC-07 | 测试框架覆盖度 | Minor | {count} | {扣分} | {详情} |
-
-## 六、覆盖度明细
-
-| 接口名称 | 是否有测试 | 测试文件 | 是否有DEMO调用 | DEMO文件 | 覆盖来源 | 平台特有 | 覆盖质量 | 边界场景覆盖 |
-|----------|-----------|----------|---------------|----------|----------|----------|----------|-------------|
-| {fullName} | ✅/❌ | {testFiles} | ✅/❌ | {demoFiles} | test/demo/both/none | 否/是(特征N) | {质量评价} | ✅ 已覆盖/不需要/{缺失说明} |
-
-> 覆盖来源说明：
-> - `test`：仅测试目录覆盖
-> - `demo`：仅 Demo 目录覆盖
-> - `both`：测试和 Demo 均覆盖
-> - `none`：两个来源均未覆盖
-> - 平台特有列标注「是」的接口，覆盖来源填 `平台特有（排除）`，不计入未覆盖
-
-## 七、未覆盖接口清单
-
-> 以下为**有效未覆盖接口**（已排除平台特有接口）。
-
-| 接口名称 | 严重度 | 检查项编号 | 说明 |
-|----------|--------|------------|------|
-| {fullName} | Critical/Major/Minor | RTC-XX | {未覆盖原因} |
-
-## 八、改进建议
-
-### 优先级 P0（Critical，必须补充测试）
-1. {接口名} — {建议}
-2. ...
-
-### 优先级 P1（Major，强烈建议补充测试）
-1. {接口名} — {建议}
-2. ...
-
-### 优先级 P2（Minor，建议改进）
-1. {接口名} — {建议}
-2. ...
-
----
-
-**报告生成时间**：{timestamp}
-```
-
----
-
-## 评分等级说明
-
-| 分数区间 | 等级 | 说明 |
-|----------|------|------|
-| 90-100 分 | 优秀 | 接口覆盖率高、测试质量好 |
-| 80-89 分 | 良好 | 主要接口有测试，质量尚可 |
-| 70-79 分 | 一般 | 部分接口有测试，测试质量有不足 |
-| 60-69 分 | 较差 | 覆盖率低或测试质量差 |
-| 50-59 分 | 严重不足 | 核心接口缺少测试保障 |
-| <50 分 | 不可用 | 触发归零规则或几乎所有接口无测试 |
-| 0 分 | 完全缺失 | 无任何测试或触发归零规则 |
-
-> ⚠️ **严苛标准**：测试覆盖度是库质量的最后防线。80 分以下即存在明显测试不足，50 分以下视为严重不可用。
-
----
-
-## 严重度映射
-
-| 严重度 | 扣分范围 | 说明 |
-|--------|----------|------|
-| **Critical** | ≥ 10 分 | 致命问题，核心接口无测试 |
-| **Major** | 5-9 分 | 严重问题，重要测试缺失或测试质量差 |
-| **Minor** | ≤ 4 分 | 轻微问题，测试规范性不足 |
-
----
-
-## 维度子评分计算
-
-每个维度独立计算子评分（用于报告中明细展示）：
-
-```
-维度子评分 = (维度得分 / 基础分) × 100
-```
-
-例如：公开接口覆盖率维度得分 42/70，则维度子评分 = (42/70) × 100 = 60/100
+# 报告格式模板
+
+本文档定义 RNLibraryTestCoverageCheckSkill 最终输出报告 `用例覆盖度检视报告.md` 的格式模板。
+
+---
+
+## 格式要求
+
+> ⚠️ **关键格式约束**：
+> 1. 综合评分必须使用 `**综合评分：XX/100**` 格式（粗体标记、中文冒号）
+> 2. 每个维度必须包含 `**维度评分：XX/100**` 格式
+> 3. 覆盖度明细必须列出每个公开接口的覆盖状态
+> 4. 评分正则匹配优先级：`综合评分` > `总体评分/评分` > `得分`
+
+---
+
+## 完整模板
+
+```markdown
+# {repoName} 用例覆盖度检视报告
+
+## 一、检视概览
+
+| 字段 | 内容 |
+|------|------|
+| **仓库名称** | {repoName} |
+| **检视类型** | RN 用例覆盖度检视（脚本自动化） |
+| **检视时间** | {timestamp} |
+| **公开接口总数** | {totalInterfaces} |
+| **平台特有接口数（排除）** | {platformSpecificCount} |
+| **有效接口数** | {effectiveInterfaceCount} |
+| **已覆盖接口数** | {coveredInterfaces} |
+| **test 目录接口覆盖率** | {testCoverageRate}% |
+| **DEMO 目录接口覆盖率** | {demoCoverageRate}% |
+| **综合接口覆盖率（原始）** | {rawMaxCoverage}% |
+| **有效综合接口覆盖率（排除平台特有）** | {effectiveCoverageRate}% |
+| **脚本假阴性修正数（交叉验证）** | {falseNegativeFixedCount} |
+| **鸿蒙测试文件数** | {testFileCount} |
+| **检视范围** | {鸿蒙代码定位结果摘要} |
+
+## 二、脚本执行记录
+
+| 步骤 | 脚本 | 参数 | 产出文件 | 状态 |
+|------|------|------|----------|------|
+| Phase 2 | rn-extract-interfaces.cjs | --repoDir {ohosDir} --output interface-spec.json | interface-spec.json | ✅ |
+| Phase 3 | rn-analyze-test-coverage.cjs | --spec {specPath} --libroot {ohosDir} | test-coverage-report.md | ✅ |
+| Phase 4 | rn-analyze-demo-coverage.cjs | --spec {specPath} --libroot {ohosDir} --src {demoRoot} | demo-coverage-report.md | ✅/⚠️ |
+
+## 二·一、平台特有接口排除清单
+
+> 以下接口被识别为 Android/iOS 平台特有接口，从未覆盖列表中排除，不计入扣分和归零规则判定。
+
+| 接口名称 | 类名 | 判定特征 | 判定依据 | 排除原因 |
+|----------|------|----------|----------|----------|
+| {fullName} | {className} | 特征{N} | {详细说明} | {Android专属/iOS专属/无鸿蒙侧实现} |
+
+> 若无平台特有接口，填写：「本次检视未识别到平台特有接口，所有未覆盖接口均计入有效未覆盖列表。」
+
+## 二·二、脚本假阴性修正清单
+
+> 以下接口经 grep 交叉验证（测试与 Demo 双来源）确认为脚本假阴性（如索引签名 `[key: string]: T` 提取的伪成员），由未覆盖修正为已覆盖，修正后重新计算有效覆盖率。
+
+| 接口名称 | 修正原因 | 验证证据（文件+行号+访问形式） |
+|----------|----------|-------------------------------|
+| {fullName} | 索引签名伪成员 / 其他假阴性 | {grep 命中位置与访问形式} |
+
+> 若无修正项，填写：「本次检视未发现脚本假阴性，脚本未覆盖列表经交叉验证全部属实。」
+
+## 三、综合评分
+
+**综合评分：{score}/100**
+
+> 评分等级：{level}。{levelDescription}
+
+> 综合接口覆盖率：{coverageRate}%
+
+| 维度 | 权重 | 基础分 | 扣分 | 得分 | 子评分 |
+|------|------|--------|------|------|--------|
+| 公开接口覆盖率 | 70% | 70 | {扣分} | {得分}/70 | {子评分}/100 |
+| 测试质量 | 30% | 30 | {扣分} | {得分}/30 | {子评分}/100 |
+
+### 扣分明细
+
+| 检查项编号 | 检查项 | 严重度 | 数量 | 单项扣分 | 小计 | 详情 |
+|------------|--------|--------|------|----------|------|------|
+| RTC-01 | 核心接口未覆盖 | Critical | {count} | -20 | {total} | {未覆盖核心接口列表} |
+| RTC-02 | 重要接口未覆盖 | Major | {count} | -15 | {total} | {未覆盖重要接口列表} |
+| RTC-04 | 可选接口未覆盖 | Minor | {count} | -3 | {total} | {未覆盖可选接口列表} |
+| RTC-05 | 接口参数组合未覆盖 | Major | {count} | -5 | {total} | {详情} |
+| RTC-06 | 回调/事件接口未覆盖 | Major | {count} | -8 | {total} | {未覆盖事件接口列表} |
+| RTC-03 | 边界场景缺失 | Minor | {count} | -5 | {total} | {详情} |
+| RTC-07 | 测试框架覆盖度 | Minor | {count} | -5 | {total} | {详情} |
+
+{归零规则触发时追加：}
+> ⚠️ 触发归零规则：{规则描述}，综合评分直接为 0 分
+
+## 四、检视范围
+
+### 鸿蒙代码定位结果
+
+**扫描策略**：脚本自动检测 + AST/正则双层匹配
+
+| 扫描维度 | 发现文件数 | 检视状态 |
+|----------|------------|----------|
+| 测试文件 | {count} | ✅ 已检视 |
+| Demo 文件 | {count} | ✅ 已检视 |
+| 接口规格 | {count} 个接口 | ✅ 已提取 |
+
+### 脚本扫描详情
+
+**测试覆盖率扫描**：
+- 测试目录：{testDir}
+- 扫描文件数：{testFileCount}
+- 匹配模式：{mode}（AST/正则）
+
+**Demo 覆盖率扫描**：
+- Demo 目录：{demoDir}
+- 扫描文件数：{demoFileCount}
+- 匹配模式：{mode}（AST/正则）
+
+## 五、检视维度明细
+
+### 5.1 公开接口覆盖率
+
+**维度评分：{dim1SubScore}/100**
+
+| 检查项编号 | 检查项 | 严重度 | 发现数量 | 扣分 | 详情 |
+|------------|--------|--------|----------|------|------|
+| RTC-01 | 核心接口未覆盖 | Critical | {count} | {扣分} | {详情} |
+| RTC-02 | 重要接口未覆盖 | Major | {count} | {扣分} | {详情} |
+| RTC-04 | 可选接口未覆盖 | Minor | {count} | {扣分} | {详情} |
+| RTC-05 | 接口参数组合未覆盖 | Major | {count} | {扣分} | {详情} |
+| RTC-06 | 回调/事件接口未覆盖 | Major | {count} | {扣分} | {详情} |
+
+### 5.2 测试质量
+
+**维度评分：{dim2SubScore}/100**
+
+| 检查项编号 | 检查项 | 严重度 | 发现数量 | 扣分 | 详情 |
+|------------|--------|--------|----------|------|------|
+| RTC-03 | 边界场景缺失 | Minor | {count} | {扣分} | {详情} |
+| RTC-07 | 测试框架覆盖度 | Minor | {count} | {扣分} | {详情} |
+
+## 六、覆盖度明细
+
+| 接口名称 | 是否有测试 | 测试文件 | 是否有DEMO调用 | DEMO文件 | 覆盖来源 | 平台特有 | 覆盖质量 | 边界场景覆盖 |
+|----------|-----------|----------|---------------|----------|----------|----------|----------|-------------|
+| {fullName} | ✅/❌ | {testFiles} | ✅/❌ | {demoFiles} | test/demo/both/none | 否/是(特征N) | {质量评价} | ✅ 已覆盖/不需要/{缺失说明} |
+
+> 覆盖来源说明：
+> - `test`：仅测试目录覆盖
+> - `demo`：仅 Demo 目录覆盖
+> - `both`：测试和 Demo 均覆盖
+> - `none`：两个来源均未覆盖
+> - 平台特有列标注「是」的接口，覆盖来源填 `平台特有（排除）`，不计入未覆盖
+
+## 七、未覆盖接口清单
+
+> 以下为**有效未覆盖接口**（已排除平台特有接口）。
+
+| 接口名称 | 严重度 | 检查项编号 | 说明 |
+|----------|--------|------------|------|
+| {fullName} | Critical/Major/Minor | RTC-XX | {未覆盖原因} |
+
+## 八、改进建议
+
+### 优先级 P0（Critical，必须补充测试）
+1. {接口名} — {建议}
+2. ...
+
+### 优先级 P1（Major，强烈建议补充测试）
+1. {接口名} — {建议}
+2. ...
+
+### 优先级 P2（Minor，建议改进）
+1. {接口名} — {建议}
+2. ...
+
+---
+
+**报告生成时间**：{timestamp}
+```
+
+---
+
+## 评分等级说明
+
+| 分数区间 | 等级 | 说明 |
+|----------|------|------|
+| 90-100 分 | 优秀 | 接口覆盖率高、测试质量好 |
+| 80-89 分 | 良好 | 主要接口有测试，质量尚可 |
+| 70-79 分 | 一般 | 部分接口有测试，测试质量有不足 |
+| 60-69 分 | 较差 | 覆盖率低或测试质量差 |
+| 50-59 分 | 严重不足 | 核心接口缺少测试保障 |
+| <50 分 | 不可用 | 触发归零规则或几乎所有接口无测试 |
+| 0 分 | 完全缺失 | 无任何测试或触发归零规则 |
+
+> ⚠️ **严苛标准**：测试覆盖度是库质量的最后防线。80 分以下即存在明显测试不足，50 分以下视为严重不可用。
+
+---
+
+## 严重度映射
+
+| 严重度 | 扣分范围 | 说明 |
+|--------|----------|------|
+| **Critical** | ≥ 10 分 | 致命问题，核心接口无测试 |
+| **Major** | 5-9 分 | 严重问题，重要测试缺失或测试质量差 |
+| **Minor** | ≤ 4 分 | 轻微问题，测试规范性不足 |
+
+---
+
+## 维度子评分计算
+
+每个维度独立计算子评分（用于报告中明细展示）：
+
+```
+维度子评分 = (维度得分 / 基础分) × 100
+```
+
+例如：公开接口覆盖率维度得分 42/70，则维度子评分 = (42/70) × 100 = 60/100