@ohos-cpf/3rdloop 0.0.2 → 0.0.3

package/vendor/Server/Skills/tpc-cpp-check/references/REPORT_TEMPLATE.md

@@ -1,250 +1,250 @@
-# tpc_c_cplusplus 适配库检视报告模板
-
-本模板用于生成 tpc_c_cplusplus 适配库检视报告，输出至 `{outputDir}/check-report.md`。
-
-**数据来源说明**：本检视基于 GitCode API 按需获取 PR 变更文件内容，不克隆整个仓库。检视范围仅限于 PR 中实际变更的文件（增量模式）或所有必需文件（全量模式）。
-
----
-
-```markdown
-# 适配库规范性检视报告：{libName}
-
-**检视时间**: {YYYY-MM-DD HH:mm:ss}
-**检视路径**: `{libPath}`
-**库类型**: {thirdparty / community}
-**构建类型**: {cmake / configure / automake / make / meson}
-**检视模式**: {增量检视 / 全量检视}
-
----
-
-## 概要信息
-
-| 字段 | 内容 |
-|------|------|
-| **库名** | {libName} |
-| **库类型** | {thirdparty / community} |
-| **路径** | {libPath} |
-| **构建类型** | {cmake / configure / automake / make / meson} |
-| **检视模式** | {增量检视 / 全量检视} |
-
----
-
-## 问题统计
-
-| 严重程度 | 数量 |
-|----------|------|
-| 严重 (Critical) | N 个 |
-| 重要 (Major) | N 个 |
-| 一般 (Minor) | N 个 |
-| 表面 (Cosmetic) | N 个 |
-| **合计** | N 个 |
-
-> **⚠️ 合入阻断提醒：严重 (Critical) 和重要 (Major) 问题必须在合入前全部修复，否则不予批准合入！当前共有 X 个严重 + Y 个重要 = Z 项阻断性问题待解决。**
-
----
-
-## 检视范围
-
-**本次检视模式**：{增量检视 / 全量检视}
-
-**增量检视说明**：仅检查 PR 中变更的文件，不对未修改的文件进行合规性检查。预存问题不在增量检视范围内。
-
-**全量检视说明**：对所有必需文件和可选文件进行完整合规性检查。
-
-**实际检查文件清单**：
-
-| 文件 | 是否检查 | 说明 |
-|------|----------|------|
-| HPKBUILD | ✅ / — | {说明} |
-| SHA512SUM | ✅ / — | {说明} |
-| README.OpenSource | ✅ / — | {说明} |
-| README_zh.md | ✅ / — | {说明} |
-| docs/hap_integrate.md | ✅ / — | {说明} |
-| HPKCHECK | ✅ / — | {说明} |
-| OAT.xml | ✅ / — | {说明} |
-
----
-
-## 变更文件检查
-
-> 增量模式下仅检查变更文件，全量模式下检查所有必需文件。
-
-### HPKBUILD 检查
-
-> 若 HPKBUILD 为变更文件（增量）或全量检视模式，进行详细检查。
-
-#### 字段完整性
-
-| 字段 | 状态 | 说明 |
-|------|------|------|
-| pkgname | ✅ / ❌ | {值} / {问题描述} |
-| pkgver | ✅ / ❌ | {值} / {问题描述} |
-| pkgrel | ✅ / ❌ | {值} / {问题描述} |
-| pkgdesc | ✅ / ❌ | {值} / {问题描述} |
-| url | ✅ / ❌ | {值} / {问题描述} |
-| archs | ✅ / ❌ | {值} / {问题描述} |
-| license | ✅ / ❌ | {值} / {问题描述} |
-| depends | ✅ / ❌ | {值} / {问题描述} |
-| makedepends | ✅ / ❌ | {值} / {问题描述} |
-| source | ✅ / ❌ | {值} / {问题描述} |
-| downloadpackage | ✅ / ❌ | {值} / {问题描述} |
-| autounpack | ✅ / ❌ | {值} / {问题描述} |
-| builddir | ✅ / ❌ | {值} / {问题描述} |
-| packagename | ✅ / ❌ | {值} / {问题描述} |
-
-#### 函数完整性
-
-| 函数 | 状态 | 说明 |
-|------|------|------|
-| prepare() | ✅ / ❌ | {说明} |
-| build() | ✅ / ❌ | {说明} |
-| package() | ✅ / ❌ | {说明} |
-| check() | ✅ / ❌ | {说明} |
-| cleanbuild() | ✅ / ❌ | {说明} |
-
-#### 构建类型检查
-
-**构建类型**：{cmake / configure / automake / make / meson}
-
-| 检查项 | 状态 | 说明 |
-|--------|------|------|
-| {检查项} | ✅ / ❌ | {说明} |
-
-#### 头部检查
-
-| 检查项 | 状态 |
-|--------|------|
-| Apache 2.0 许可证头部 | ✅ / ❌ |
-| Contributor 信息 | ✅ / ❌ |
-| Maintainer 信息 | ✅ / ❌ |
-
-### SHA512SUM 检查
-
-| 检查项 | 状态 | 说明 |
-|--------|------|------|
-| 文件非空 | ✅ / ❌ | {说明} |
-| 格式正确 | ✅ / ❌ | {说明} |
-| 包含源码校验值 | ✅ / ❌ | {说明} |
-
-### README.OpenSource 检查
-
-| 检查项 | 状态 | 说明 |
-|--------|------|------|
-| JSON 格式合法 | ✅ / ❌ | {说明} |
-| 必需字段完整 | ✅ / ❌ | {说明} |
-
-### README_zh.md 检查
-
-| 检查项 | 状态 | 说明 |
-|--------|------|------|
-| 标题格式 | ✅ / ❌ | {说明} |
-| 功能简介章节 | ✅ / ❌ | {说明} |
-| 三方库版本章节 | ✅ / ❌ | {说明} |
-| 已适配功能章节 | ✅ / ❌ | {说明} |
-| 使用约束章节 | ✅ / ❌ | {说明} |
-| 集成方式章节 | ✅ / ❌ | {说明} |
-| 链接路径正确 | ✅ / ❌ | {说明} |
-
-### docs/hap_integrate.md 检查
-
-| 检查项 | 状态 | 说明 |
-|--------|------|------|
-| 标题格式 | ✅ / ❌ | {说明} |
-| 必需章节完整 | ✅ / ❌ | {说明} |
-| 开发环境链接 | ✅ / ❌ | {说明} |
-| 截图引用 | ✅ / ❌ | {说明} |
-
-### 可选文件检查
-
-| 文件 | 状态 | 说明 |
-|------|------|------|
-| HPKCHECK | ✅ / ❌ / — | {说明} |
-| OAT.xml | ✅ / ❌ / — | {说明} |
-
----
-
-## 问题清单
-
-### ⛔ 严重 (Critical) — N 项 【必须修复后方可合入】
-
-| 编号 | 类别 | 文件 | 问题描述 | 修复建议 |
-|------|------|------|----------|----------|
-| C1 | {类别} | {文件路径} | {问题描述} | {修复建议} |
-
-> 若无 Critical 问题，填写：**无**
-
-### 🚫 重要 (Major) — N 项 【必须修复后方可合入】
-
-| 编号 | 类别 | 文件 | 问题描述 | 修复建议 |
-|------|------|------|----------|----------|
-| M1 | {类别} | {文件路径} | {问题描述} | {修复建议} |
-
-> 若无 Major 问题，填写：**无**
-
-### 💡 一般 (Minor) — N 项
-
-| 编号 | 类别 | 文件 | 问题描述 | 修复建议 |
-|------|------|------|----------|----------|
-| N1 | {类别} | {文件路径} | {问题描述} | {修复建议} |
-
-> 若无 Minor 问题，填写：**无**
-
-### 📝 表面 (Cosmetic) — N 项
-
-| 编号 | 类别 | 文件 | 问题描述 | 修复建议 |
-|------|------|------|----------|----------|
-| S1 | {类别} | {文件路径} | {问题描述} | {修复建议} |
-
-> 若无 Cosmetic 问题，填写：**无**
-
----
-
-> **🔴 合入阻断提醒：以上 C1~CX（严重）和 M1~MY（重要）共 Z 项问题为合入前置条件，必须在 PR 合入前全部修复。一般和表面级别问题可在后续迭代中改善。**
-
----
-
-*本报告由 TpcCheckSkill 自动生成，仅供参考，最终合入决策由人工评审确认。*
-```
-
----
-
-## result.txt 文件生成规范
-
-检视完成后，生成 `{outputDir}/result.txt` 文件供前端展示和数据库存储。
-
-```txt
-=== 合入建议分级报告 ===
-PR 地址：{prUrl}
-仓库：{owner}/{repo}
-PR 编号：#{prNumber}
-生成时间：{YYYY-MM-DD HH:mm:ss}
-
-【合入建议】：{等级标识}
-
-【问题统计】
-- Critical 级别：{criticalCount} 个
-- Major 级别：{majorCount} 个
-- Minor 级别：{minorCount} 个
-- Cosmetic 级别：{cosmeticCount} 个
-
-【分级理由】
-{分级理由详细说明}
-
-【详细分析】
-━━━ Critical 级别问题 ━━━
-{列出所有 Critical 问题，每个占一行}
-
-━━━ Major 级别问题 ━━━
-{列出所有 Major 问题，每个占一行}
-
-━━━ Minor 级别问题 ━━━
-{列出所有 Minor 问题，每个占一行}
-
-━━━ Cosmetic 级别问题 ━━━
-{列出所有 Cosmetic 问题，每个占一行}
-
-━━━ 合入建议 ━━━
-{最终合入建议和条件说明}
-
-=== 分级结束 ===
-```
+# tpc_c_cplusplus 适配库检视报告模板
+
+本模板用于生成 tpc_c_cplusplus 适配库检视报告，输出至 `{outputDir}/check-report.md`。
+
+**数据来源说明**：本检视基于 GitCode API 按需获取 PR 变更文件内容，不克隆整个仓库。检视范围仅限于 PR 中实际变更的文件（增量模式）或所有必需文件（全量模式）。
+
+---
+
+```markdown
+# 适配库规范性检视报告：{libName}
+
+**检视时间**: {YYYY-MM-DD HH:mm:ss}
+**检视路径**: `{libPath}`
+**库类型**: {thirdparty / community}
+**构建类型**: {cmake / configure / automake / make / meson}
+**检视模式**: {增量检视 / 全量检视}
+
+---
+
+## 概要信息
+
+| 字段 | 内容 |
+|------|------|
+| **库名** | {libName} |
+| **库类型** | {thirdparty / community} |
+| **路径** | {libPath} |
+| **构建类型** | {cmake / configure / automake / make / meson} |
+| **检视模式** | {增量检视 / 全量检视} |
+
+---
+
+## 问题统计
+
+| 严重程度 | 数量 |
+|----------|------|
+| 严重 (Critical) | N 个 |
+| 重要 (Major) | N 个 |
+| 一般 (Minor) | N 个 |
+| 表面 (Cosmetic) | N 个 |
+| **合计** | N 个 |
+
+> **⚠️ 合入阻断提醒：严重 (Critical) 和重要 (Major) 问题必须在合入前全部修复，否则不予批准合入！当前共有 X 个严重 + Y 个重要 = Z 项阻断性问题待解决。**
+
+---
+
+## 检视范围
+
+**本次检视模式**：{增量检视 / 全量检视}
+
+**增量检视说明**：仅检查 PR 中变更的文件，不对未修改的文件进行合规性检查。预存问题不在增量检视范围内。
+
+**全量检视说明**：对所有必需文件和可选文件进行完整合规性检查。
+
+**实际检查文件清单**：
+
+| 文件 | 是否检查 | 说明 |
+|------|----------|------|
+| HPKBUILD | ✅ / — | {说明} |
+| SHA512SUM | ✅ / — | {说明} |
+| README.OpenSource | ✅ / — | {说明} |
+| README_zh.md | ✅ / — | {说明} |
+| docs/hap_integrate.md | ✅ / — | {说明} |
+| HPKCHECK | ✅ / — | {说明} |
+| OAT.xml | ✅ / — | {说明} |
+
+---
+
+## 变更文件检查
+
+> 增量模式下仅检查变更文件，全量模式下检查所有必需文件。
+
+### HPKBUILD 检查
+
+> 若 HPKBUILD 为变更文件（增量）或全量检视模式，进行详细检查。
+
+#### 字段完整性
+
+| 字段 | 状态 | 说明 |
+|------|------|------|
+| pkgname | ✅ / ❌ | {值} / {问题描述} |
+| pkgver | ✅ / ❌ | {值} / {问题描述} |
+| pkgrel | ✅ / ❌ | {值} / {问题描述} |
+| pkgdesc | ✅ / ❌ | {值} / {问题描述} |
+| url | ✅ / ❌ | {值} / {问题描述} |
+| archs | ✅ / ❌ | {值} / {问题描述} |
+| license | ✅ / ❌ | {值} / {问题描述} |
+| depends | ✅ / ❌ | {值} / {问题描述} |
+| makedepends | ✅ / ❌ | {值} / {问题描述} |
+| source | ✅ / ❌ | {值} / {问题描述} |
+| downloadpackage | ✅ / ❌ | {值} / {问题描述} |
+| autounpack | ✅ / ❌ | {值} / {问题描述} |
+| builddir | ✅ / ❌ | {值} / {问题描述} |
+| packagename | ✅ / ❌ | {值} / {问题描述} |
+
+#### 函数完整性
+
+| 函数 | 状态 | 说明 |
+|------|------|------|
+| prepare() | ✅ / ❌ | {说明} |
+| build() | ✅ / ❌ | {说明} |
+| package() | ✅ / ❌ | {说明} |
+| check() | ✅ / ❌ | {说明} |
+| cleanbuild() | ✅ / ❌ | {说明} |
+
+#### 构建类型检查
+
+**构建类型**：{cmake / configure / automake / make / meson}
+
+| 检查项 | 状态 | 说明 |
+|--------|------|------|
+| {检查项} | ✅ / ❌ | {说明} |
+
+#### 头部检查
+
+| 检查项 | 状态 |
+|--------|------|
+| Apache 2.0 许可证头部 | ✅ / ❌ |
+| Contributor 信息 | ✅ / ❌ |
+| Maintainer 信息 | ✅ / ❌ |
+
+### SHA512SUM 检查
+
+| 检查项 | 状态 | 说明 |
+|--------|------|------|
+| 文件非空 | ✅ / ❌ | {说明} |
+| 格式正确 | ✅ / ❌ | {说明} |
+| 包含源码校验值 | ✅ / ❌ | {说明} |
+
+### README.OpenSource 检查
+
+| 检查项 | 状态 | 说明 |
+|--------|------|------|
+| JSON 格式合法 | ✅ / ❌ | {说明} |
+| 必需字段完整 | ✅ / ❌ | {说明} |
+
+### README_zh.md 检查
+
+| 检查项 | 状态 | 说明 |
+|--------|------|------|
+| 标题格式 | ✅ / ❌ | {说明} |
+| 功能简介章节 | ✅ / ❌ | {说明} |
+| 三方库版本章节 | ✅ / ❌ | {说明} |
+| 已适配功能章节 | ✅ / ❌ | {说明} |
+| 使用约束章节 | ✅ / ❌ | {说明} |
+| 集成方式章节 | ✅ / ❌ | {说明} |
+| 链接路径正确 | ✅ / ❌ | {说明} |
+
+### docs/hap_integrate.md 检查
+
+| 检查项 | 状态 | 说明 |
+|--------|------|------|
+| 标题格式 | ✅ / ❌ | {说明} |
+| 必需章节完整 | ✅ / ❌ | {说明} |
+| 开发环境链接 | ✅ / ❌ | {说明} |
+| 截图引用 | ✅ / ❌ | {说明} |
+
+### 可选文件检查
+
+| 文件 | 状态 | 说明 |
+|------|------|------|
+| HPKCHECK | ✅ / ❌ / — | {说明} |
+| OAT.xml | ✅ / ❌ / — | {说明} |
+
+---
+
+## 问题清单
+
+### ⛔ 严重 (Critical) — N 项 【必须修复后方可合入】
+
+| 编号 | 类别 | 文件 | 问题描述 | 修复建议 |
+|------|------|------|----------|----------|
+| C1 | {类别} | {文件路径} | {问题描述} | {修复建议} |
+
+> 若无 Critical 问题，填写：**无**
+
+### 🚫 重要 (Major) — N 项 【必须修复后方可合入】
+
+| 编号 | 类别 | 文件 | 问题描述 | 修复建议 |
+|------|------|------|----------|----------|
+| M1 | {类别} | {文件路径} | {问题描述} | {修复建议} |
+
+> 若无 Major 问题，填写：**无**
+
+### 💡 一般 (Minor) — N 项
+
+| 编号 | 类别 | 文件 | 问题描述 | 修复建议 |
+|------|------|------|----------|----------|
+| N1 | {类别} | {文件路径} | {问题描述} | {修复建议} |
+
+> 若无 Minor 问题，填写：**无**
+
+### 📝 表面 (Cosmetic) — N 项
+
+| 编号 | 类别 | 文件 | 问题描述 | 修复建议 |
+|------|------|------|----------|----------|
+| S1 | {类别} | {文件路径} | {问题描述} | {修复建议} |
+
+> 若无 Cosmetic 问题，填写：**无**
+
+---
+
+> **🔴 合入阻断提醒：以上 C1~CX（严重）和 M1~MY（重要）共 Z 项问题为合入前置条件，必须在 PR 合入前全部修复。一般和表面级别问题可在后续迭代中改善。**
+
+---
+
+*本报告由 TpcCheckSkill 自动生成，仅供参考，最终合入决策由人工评审确认。*
+```
+
+---
+
+## result.txt 文件生成规范
+
+检视完成后，生成 `{outputDir}/result.txt` 文件供前端展示和数据库存储。
+
+```txt
+=== 合入建议分级报告 ===
+PR 地址：{prUrl}
+仓库：{owner}/{repo}
+PR 编号：#{prNumber}
+生成时间：{YYYY-MM-DD HH:mm:ss}
+
+【合入建议】：{等级标识}
+
+【问题统计】
+- Critical 级别：{criticalCount} 个
+- Major 级别：{majorCount} 个
+- Minor 级别：{minorCount} 个
+- Cosmetic 级别：{cosmeticCount} 个
+
+【分级理由】
+{分级理由详细说明}
+
+【详细分析】
+━━━ Critical 级别问题 ━━━
+{列出所有 Critical 问题，每个占一行}
+
+━━━ Major 级别问题 ━━━
+{列出所有 Major 问题，每个占一行}
+
+━━━ Minor 级别问题 ━━━
+{列出所有 Minor 问题，每个占一行}
+
+━━━ Cosmetic 级别问题 ━━━
+{列出所有 Cosmetic 问题，每个占一行}
+
+━━━ 合入建议 ━━━
+{最终合入建议和条件说明}
+
+=== 分级结束 ===
+```