@ohos-cpf/3rdloop 0.0.2 → 0.0.4

package/vendor/Server/Skills/arkts-library-documentation-quality-check/assets/REPORT_TEMPLATE.md

@@ -1,103 +1,103 @@
-# 文档质量检视报告模板（输出产物）
-
-> 生成 `文档质量检视报告.md` 时使用的标准模板。所有 `{占位符}` 替换为实际检视结果。
-
----
-
-## 报告结构
-
-```markdown
-# {repoName} 文档质量检视报告
-
-## 一、检视概览
-
-| 字段 | 内容 |
-|------|------|
-| **仓库名称** | {repoName} |
-| **检视类型** | ArkTS 文档质量检视 |
-| **检视时间** | {timestamp} |
-| **扫描文档数** | {docCount} |
-| **扫描源码文件数** | {sourceFileCount} |
-
-## 二、综合评分
-
-**综合评分：{score}/100**
-
-> 评分等级：{grade}（{gradeDescription}）
-
-## 三、维度评分明细
-
-| 维度 | 子评分 | 权重 | 加权贡献 | Critical数 | Major数 | Minor数 |
-|------|--------|------|----------|-----------|---------|---------|
-| 文档完整性 | {完整性子评分}/100 | 30% | {完整性贡献} | {c1} | {m1} | {n1} |
-| 文档准确性 | {准确性子评分}/100 | 25% | {准确性贡献} | {c2} | {m2} | {n2} |
-| 文档易读性 | {易读性子评分}/100 | 15% | {易读性贡献} | {c3} | {m3} | {n3} |
-| 代码级文档质量 | {代码级子评分}/100 | 10% | {代码级贡献} | {c4} | {m4} | {n4} |
-| 鸿蒙化文档专项 | {鸿蒙化子评分}/100 | 20% | {鸿蒙化贡献} | {c5} | {m5} | {n5} |
-
-## 四、检视维度详情
-
-### 4.1 文档完整性（权重 30%）
-
-| 检查项 | 严重度 | 发现数量 | 详情 |
-|--------|--------|----------|------|
-
-> 完整性子评分：{完整性子评分}/100
-
-### 4.2 文档准确性（权重 25%）
-
-> 准确性子评分：{准确性子评分}/100
-
-### 4.3 文档易读性（权重 15%）
-
-> 易读性子评分：{易读性子评分}/100
-
-### 4.4 代码级文档质量（权重 10%）
-
-> 代码级文档子评分：{代码级子评分}/100
-
-### 4.5 鸿蒙化文档专项（权重 20%）
-
-> 鸿蒙化专项子评分：{鸿蒙化子评分}/100
-
-## 五、问题清单
-
-| # | 文档/文件 | 严重度 | 维度 | 描述 | 修复建议 |
-|---|-----------|--------|------|------|----------|
-
-## 六、改进建议
-
-……
-
----
-
-**报告生成时间**：{timestamp}
-```
-
----
-
-## 关键格式要求
-
-> ⚠️ 以下格式要求必须严格遵守，后端 `_parseArktsLibraryScore` 依赖自动解析。
-
-1. **综合评分行格式**：`**综合评分：数字/100**`
-   - 数字为 0-100 的整数
-   - 冒号使用**中文全角冒号** `：`
-   - 必须出现在"二、综合评分"章节的首行
-
-2. **维度评分明细表**：必须在综合评分之后紧邻展示
-
-3. **各维度子评分标注**：每个维度详情末尾必须标注 `> {维度}子评分：{分数}/100`
-
----
-
-## 评分等级参考
-
-| 评分区间 | 等级 | 含义 |
-|----------|------|------|
-| 90-100 | 优秀 | 文档完善、准确、易读，鸿蒙化说明充分 |
-| 80-89 | 良好 | 存在少量 Minor 问题，不影响使用 |
-| 70-79 | 一般 | 存在 Major 级别文档缺失，需补充 |
-| 60-69 | 较差 | 关键文档缺失或不准确，严重影响使用 |
-| 50-59 | 不合格 | Critical 级别文档缺失，用户无法正常使用 |
+# 文档质量检视报告模板（输出产物）
+
+> 生成 `文档质量检视报告.md` 时使用的标准模板。所有 `{占位符}` 替换为实际检视结果。
+
+---
+
+## 报告结构
+
+```markdown
+# {repoName} 文档质量检视报告
+
+## 一、检视概览
+
+| 字段 | 内容 |
+|------|------|
+| **仓库名称** | {repoName} |
+| **检视类型** | ArkTS 文档质量检视 |
+| **检视时间** | {timestamp} |
+| **扫描文档数** | {docCount} |
+| **扫描源码文件数** | {sourceFileCount} |
+
+## 二、综合评分
+
+**综合评分：{score}/100**
+
+> 评分等级：{grade}（{gradeDescription}）
+
+## 三、维度评分明细
+
+| 维度 | 子评分 | 权重 | 加权贡献 | Critical数 | Major数 | Minor数 |
+|------|--------|------|----------|-----------|---------|---------|
+| 文档完整性 | {完整性子评分}/100 | 30% | {完整性贡献} | {c1} | {m1} | {n1} |
+| 文档准确性 | {准确性子评分}/100 | 25% | {准确性贡献} | {c2} | {m2} | {n2} |
+| 文档易读性 | {易读性子评分}/100 | 15% | {易读性贡献} | {c3} | {m3} | {n3} |
+| 代码级文档质量 | {代码级子评分}/100 | 10% | {代码级贡献} | {c4} | {m4} | {n4} |
+| 鸿蒙化文档专项 | {鸿蒙化子评分}/100 | 20% | {鸿蒙化贡献} | {c5} | {m5} | {n5} |
+
+## 四、检视维度详情
+
+### 4.1 文档完整性（权重 30%）
+
+| 检查项 | 严重度 | 发现数量 | 详情 |
+|--------|--------|----------|------|
+
+> 完整性子评分：{完整性子评分}/100
+
+### 4.2 文档准确性（权重 25%）
+
+> 准确性子评分：{准确性子评分}/100
+
+### 4.3 文档易读性（权重 15%）
+
+> 易读性子评分：{易读性子评分}/100
+
+### 4.4 代码级文档质量（权重 10%）
+
+> 代码级文档子评分：{代码级子评分}/100
+
+### 4.5 鸿蒙化文档专项（权重 20%）
+
+> 鸿蒙化专项子评分：{鸿蒙化子评分}/100
+
+## 五、问题清单
+
+| # | 文档/文件 | 严重度 | 维度 | 描述 | 修复建议 |
+|---|-----------|--------|------|------|----------|
+
+## 六、改进建议
+
+……
+
+---
+
+**报告生成时间**：{timestamp}
+```
+
+---
+
+## 关键格式要求
+
+> ⚠️ 以下格式要求必须严格遵守，后端 `_parseArktsLibraryScore` 依赖自动解析。
+
+1. **综合评分行格式**：`**综合评分：数字/100**`
+   - 数字为 0-100 的整数
+   - 冒号使用**中文全角冒号** `：`
+   - 必须出现在"二、综合评分"章节的首行
+
+2. **维度评分明细表**：必须在综合评分之后紧邻展示
+
+3. **各维度子评分标注**：每个维度详情末尾必须标注 `> {维度}子评分：{分数}/100`
+
+---
+
+## 评分等级参考
+
+| 评分区间 | 等级 | 含义 |
+|----------|------|------|
+| 90-100 | 优秀 | 文档完善、准确、易读，鸿蒙化说明充分 |
+| 80-89 | 良好 | 存在少量 Minor 问题，不影响使用 |
+| 70-79 | 一般 | 存在 Major 级别文档缺失，需补充 |
+| 60-69 | 较差 | 关键文档缺失或不准确，严重影响使用 |
+| 50-59 | 不合格 | Critical 级别文档缺失，用户无法正常使用 |
 | <50 | 严重不足 | 多维度 Critical 问题，文档基本不可用 |

package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/CHECK_DIMENSIONS.md

@@ -1,89 +1,89 @@
-# 文档质量检视检查维度
-
-本文件定义文档质量检视的五个维度、检查项和严重度判定标准。
-
----
-
-## 维度一：文档完整性（权重 30%）
-
-| 检查项 | 严重度 | 说明 |
-|--------|--------|------|
-| README 缺失 | Critical | 无 README 或 README 为空，用户无法了解库的基本信息 |
-| 鸿蒙化说明缺失 | Critical | 缺少鸿蒙化适配说明文档（ohos/README 或等价文档） |
-| API 文档缺失 | Major | 公开接口无文档说明（对照接口规格说明.md） |
-| 安装指南缺失 | Major | 缺少鸿蒙化库的安装/引入说明（ohpm install 等） |
-| 使用示例缺失 | Major | 缺少使用示例代码或 Demo 工程 |
-| 中文文档缺失 | Major | 鸿蒙化库面向中文生态，缺少中文文档（README_zh.md 等） |
-| 导出声明文档缺失 | Major | index.ets 导出接口无文档说明 |
-| 版本说明缺失 | Minor | 无 CHANGELOG 或版本记录 |
-| oh-package.json5 说明缺失 | Minor | 依赖配置文件缺少注释/说明 |
-| Demo/示例工程缺失 | Minor | 无完整可运行的示例工程 |
-
----
-
-## 维度二：文档准确性（权重 25%）
-
-| 检查项 | 严重度 | 说明 |
-|--------|--------|------|
-| 错误示例代码 | Critical | 示例代码无法运行或有明显错误（导入路径错、API 不存在等） |
-| API 签名不一致 | Major | 文档描述与实际代码接口签名不匹配（参数名、类型、返回值） |
-| 导出声明与文档不匹配 | Major | index.ets 导出的接口与文档描述不一致 |
-| 废弃 API 未标注 | Major | 文档中仍引用已废弃的 API 或已移除的鸿蒙 API |
-| 鸿蒙 API 说明与代码不一致 | Major | 文档声称使用某 @ohos.* API 但代码实际使用了不同 API |
-| 代码注释与文档矛盾 | Major | JSDoc 注释描述与 README/API 文档描述互相矛盾 |
-| 版本号不一致 | Minor | 文档版本号与 oh-package.json5 版本不匹配 |
-| 依赖说明与实际不匹配 | Minor | 文档描述的依赖与 oh-package.json5 不匹配 |
-| 链接失效 | Minor | 文档中的外部链接无法访问（404 等） |
-
----
-
-## 维度三：文档易读性（权重 15%）
-
-| 检查项 | 严重度 | 说明 |
-|--------|--------|------|
-| 结构混乱 | Major | 文档缺少章节划分，内容杂乱无层次 |
-| 缺少目录导航 | Minor | 长文档（>500 行）无目录索引 |
-| 语言不通顺 | Minor | 表述模糊、语法错误或逻辑不连贯 |
-| 缺少图表 | Minor | 复杂流程/架构未用图表说明 |
-| 格式不规范 | Minor | Markdown 格式错误（未闭合标签、错误链接语法等） |
-| 中英文混杂无规范 | Minor | 同一文档中中英文混杂，未遵循统一语言规范 |
-| 术语不一致 | Minor | 同一概念在不同文档中使用不同术语 |
-
----
-
-## 维度四：代码级文档质量（权重 10%）
-
-| 检查项 | 严重度 | 说明 |
-|--------|--------|------|
-| 公开接口无 JSDoc | Major | 导出的函数/类/接口缺少 JSDoc/TSDoc 注释 |
-| JSDoc 参数描述缺失 | Major | 函数注释中缺少参数说明或返回值说明 |
-| 鸿蒙特有 API 未注释 | Major | @ohos.* 调用缺少权限/版本等必要注释 |
-| 注释过时 | Minor | 代码变更后注释未同步更新 |
-| 注释格式不规范 | Minor | JSDoc 格式不符合 ArkTS 编程规范 |
-
----
-
-## 维度五：鸿蒙化文档专项（权重 20%）
-
-| 检查项 | 严重度 | 说明 |
-|--------|--------|------|
-| 权限说明缺失 | Critical | 使用系统 API（如 sensor、network、geolocation）但未说明所需权限 |
-| 鸿蒙化构建配置说明缺失 | Major | build-profile.json5 / hvigorfile.ts 中的鸿蒙特有配置未说明 |
-| 鸿蒙特性行为说明缺失 | Major | 缺少鸿蒙平台特有行为/限制说明（如线程模型差异） |
-| 差异对比文档缺失 | Major | 缺少鸿蒙化与原库的差异说明（行为差异、接口差异） |
-| 鸿蒙化迁移指南缺失 | Major | 缺少从原库迁移到鸿蒙化版本的指南 |
-| 兼容性说明缺失 | Major | 缺少支持的鸿蒙版本/API 版本范围说明 |
-| 鸿蒙化已知限制说明缺失 | Major | 鸿蒙化后存在的已知功能限制未文档化 |
-| 性能限制说明缺失 | Minor | 缺少鸿蒙化后的性能差异/瓶颈说明 |
-| 鸿蒙化第三方依赖说明缺失 | Minor | oh-package.json5 中的鸿蒙特有依赖未说明用途 |
-| 鸿蒙化测试说明缺失 | Minor | 缺少鸿蒙化特有测试方法/环境说明 |
-
----
-
-## 严重度判定标准
-
-| 严重度 | 扣分 | 判定依据 |
-|--------|------|----------|
-| Critical | -15 分/项 | 导致用户完全无法使用或严重误解库的功能 |
-| Major | -8 分/项 | 关键信息缺失或错误，显著影响用户使用体验 |
-| Minor | -3 分/项 | 描述不精确但不影响核心使用 |
+# 文档质量检视检查维度
+
+本文件定义文档质量检视的五个维度、检查项和严重度判定标准。
+
+---
+
+## 维度一：文档完整性（权重 30%）
+
+| 检查项 | 严重度 | 说明 |
+|--------|--------|------|
+| README 缺失 | Critical | 无 README 或 README 为空，用户无法了解库的基本信息 |
+| 鸿蒙化说明缺失 | Critical | 缺少鸿蒙化适配说明文档（ohos/README 或等价文档） |
+| API 文档缺失 | Major | 公开接口无文档说明（对照接口规格说明.md） |
+| 安装指南缺失 | Major | 缺少鸿蒙化库的安装/引入说明（ohpm install 等） |
+| 使用示例缺失 | Major | 缺少使用示例代码或 Demo 工程 |
+| 中文文档缺失 | Major | 鸿蒙化库面向中文生态，缺少中文文档（README_zh.md 等） |
+| 导出声明文档缺失 | Major | index.ets 导出接口无文档说明 |
+| 版本说明缺失 | Minor | 无 CHANGELOG 或版本记录 |
+| oh-package.json5 说明缺失 | Minor | 依赖配置文件缺少注释/说明 |
+| Demo/示例工程缺失 | Minor | 无完整可运行的示例工程 |
+
+---
+
+## 维度二：文档准确性（权重 25%）
+
+| 检查项 | 严重度 | 说明 |
+|--------|--------|------|
+| 错误示例代码 | Critical | 示例代码无法运行或有明显错误（导入路径错、API 不存在等） |
+| API 签名不一致 | Major | 文档描述与实际代码接口签名不匹配（参数名、类型、返回值） |
+| 导出声明与文档不匹配 | Major | index.ets 导出的接口与文档描述不一致 |
+| 废弃 API 未标注 | Major | 文档中仍引用已废弃的 API 或已移除的鸿蒙 API |
+| 鸿蒙 API 说明与代码不一致 | Major | 文档声称使用某 @ohos.* API 但代码实际使用了不同 API |
+| 代码注释与文档矛盾 | Major | JSDoc 注释描述与 README/API 文档描述互相矛盾 |
+| 版本号不一致 | Minor | 文档版本号与 oh-package.json5 版本不匹配 |
+| 依赖说明与实际不匹配 | Minor | 文档描述的依赖与 oh-package.json5 不匹配 |
+| 链接失效 | Minor | 文档中的外部链接无法访问（404 等） |
+
+---
+
+## 维度三：文档易读性（权重 15%）
+
+| 检查项 | 严重度 | 说明 |
+|--------|--------|------|
+| 结构混乱 | Major | 文档缺少章节划分，内容杂乱无层次 |
+| 缺少目录导航 | Minor | 长文档（>500 行）无目录索引 |
+| 语言不通顺 | Minor | 表述模糊、语法错误或逻辑不连贯 |
+| 缺少图表 | Minor | 复杂流程/架构未用图表说明 |
+| 格式不规范 | Minor | Markdown 格式错误（未闭合标签、错误链接语法等） |
+| 中英文混杂无规范 | Minor | 同一文档中中英文混杂，未遵循统一语言规范 |
+| 术语不一致 | Minor | 同一概念在不同文档中使用不同术语 |
+
+---
+
+## 维度四：代码级文档质量（权重 10%）
+
+| 检查项 | 严重度 | 说明 |
+|--------|--------|------|
+| 公开接口无 JSDoc | Major | 导出的函数/类/接口缺少 JSDoc/TSDoc 注释 |
+| JSDoc 参数描述缺失 | Major | 函数注释中缺少参数说明或返回值说明 |
+| 鸿蒙特有 API 未注释 | Major | @ohos.* 调用缺少权限/版本等必要注释 |
+| 注释过时 | Minor | 代码变更后注释未同步更新 |
+| 注释格式不规范 | Minor | JSDoc 格式不符合 ArkTS 编程规范 |
+
+---
+
+## 维度五：鸿蒙化文档专项（权重 20%）
+
+| 检查项 | 严重度 | 说明 |
+|--------|--------|------|
+| 权限说明缺失 | Critical | 使用系统 API（如 sensor、network、geolocation）但未说明所需权限 |
+| 鸿蒙化构建配置说明缺失 | Major | build-profile.json5 / hvigorfile.ts 中的鸿蒙特有配置未说明 |
+| 鸿蒙特性行为说明缺失 | Major | 缺少鸿蒙平台特有行为/限制说明（如线程模型差异） |
+| 差异对比文档缺失 | Major | 缺少鸿蒙化与原库的差异说明（行为差异、接口差异） |
+| 鸿蒙化迁移指南缺失 | Major | 缺少从原库迁移到鸿蒙化版本的指南 |
+| 兼容性说明缺失 | Major | 缺少支持的鸿蒙版本/API 版本范围说明 |
+| 鸿蒙化已知限制说明缺失 | Major | 鸿蒙化后存在的已知功能限制未文档化 |
+| 性能限制说明缺失 | Minor | 缺少鸿蒙化后的性能差异/瓶颈说明 |
+| 鸿蒙化第三方依赖说明缺失 | Minor | oh-package.json5 中的鸿蒙特有依赖未说明用途 |
+| 鸿蒙化测试说明缺失 | Minor | 缺少鸿蒙化特有测试方法/环境说明 |
+
+---
+
+## 严重度判定标准
+
+| 严重度 | 扣分 | 判定依据 |
+|--------|------|----------|
+| Critical | -15 分/项 | 导致用户完全无法使用或严重误解库的功能 |
+| Major | -8 分/项 | 关键信息缺失或错误，显著影响用户使用体验 |
+| Minor | -3 分/项 | 描述不精确但不影响核心使用 |

package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/COMPLIANCE_CHECKLIST.md

@@ -1,62 +1,62 @@
-# 文档质量检视合规检查清单
-
-> 检视完成后，对照本清单确认报告完整性与格式合规性，确保后端可自动解析。
-
----
-
-## 1. 检视范围检查
-
-| # | 检查项 | 通过条件 |
-|---|--------|----------|
-| 1.1 | 文档全量扫描 | 已扫描所有 README、.md、.txt、.rst、CHANGELOG、.json5 文件 |
-| 1.2 | 源码扫描 | 已扫描所有 .ets/.ts 文件（排除 node_modules） |
-| 1.3 | 鸿蒙化说明定位 | 已通过三级优先级搜索定位鸿蒙化说明文档 |
-| 1.4 | 接口规格对照 | 已读取 `接口规格说明.md` 并提取公开接口列表 |
-| 1.5 | 文档分类映射 | 已按类别归类（入口/API/鸿蒙化/构建配置/导出声明/示例/代码注释） |
-
----
-
-## 2. 五维度检视检查
-
-| # | 维度 | 通过条件 |
-|---|------|----------|
-| 2.1 | 文档完整性 | 已检查 README、鸿蒙化说明、API 文档、安装指南、使用示例、中文文档 |
-| 2.2 | 文档准确性 | 已核对 API 签名、示例代码可运行性、导出声明一致性、废弃 API |
-| 2.3 | 文档易读性 | 已检查结构、目录导航、语言、图表、格式规范 |
-| 2.4 | 代码级文档质量 | 已检查 JSDoc/TSDoc 覆盖、参数/返回值描述、鸿蒙特有 API 注释 |
-| 2.5 | 鸿蒙化文档专项 | 已检查权限说明、构建配置、差异对比、迁移指南、兼容性说明 |
-
----
-
-## 3. 评分计算检查
-
-| # | 检查项 | 通过条件 |
-|---|--------|----------|
-| 3.1 | 维度子评分 | 每个维度独立计算 `max(0, 100 - Critical×15 - Major×8 - Minor×3)` |
-| 3.2 | 综合评分 | 按权重加权：30/25/15/10/20 |
-| 3.3 | 严苛保障 | ≥3 Critical → 最高60分；≥1 Critical + ≥5 Major → 最高50分 |
-| 3.4 | 等级标注 | 已按 90-100/80-89/70-79/60-69/50-59/<50 标注等级 |
-
----
-
-## 4. 报告格式检查（后端解析依赖）
-
-| # | 检查项 | 通过条件 |
-|---|--------|----------|
-| 4.1 | 综合评分行 | `**综合评分：数字/100**`，中文全角冒号 `：`，位于"二、综合评分"首行 |
-| 4.2 | 维度评分明细表 | 紧随综合评分之后展示 |
-| 4.3 | 维度子评分标注 | 每个维度详情末尾标注 `> {维度}子评分：{分数}/100` |
-| 4.4 | 问题清单 | 包含文档/文件、严重度、维度、描述、修复建议 |
-| 4.5 | 改进建议 | 提供可执行的改进建议 |
-
----
-
-## 5. 常见遗漏检查
-
-| # | 检查项 | 说明 |
-|---|--------|------|
-| 5.1 | 示例代码可运行性 | 导入路径错误是最常见 Critical，务必逐个验证 |
-| 5.2 | 权限说明 | 使用 @ohos.network 等系统 API 必须检查权限说明 |
-| 5.3 | 双 README 同步 | README_zh.md 与 README.md 需双向检查 |
-| 5.4 | 隐含行为文档化 | 生命周期自动 API 调用（如 aboutToDisappear → destroy()） |
-| 5.5 | oh-package.json5 解析 | 允许注释和尾逗号，不能按严格 JSON 解析 |
+# 文档质量检视合规检查清单
+
+> 检视完成后，对照本清单确认报告完整性与格式合规性，确保后端可自动解析。
+
+---
+
+## 1. 检视范围检查
+
+| # | 检查项 | 通过条件 |
+|---|--------|----------|
+| 1.1 | 文档全量扫描 | 已扫描所有 README、.md、.txt、.rst、CHANGELOG、.json5 文件 |
+| 1.2 | 源码扫描 | 已扫描所有 .ets/.ts 文件（排除 node_modules） |
+| 1.3 | 鸿蒙化说明定位 | 已通过三级优先级搜索定位鸿蒙化说明文档 |
+| 1.4 | 接口规格对照 | 已读取 `接口规格说明.md` 并提取公开接口列表 |
+| 1.5 | 文档分类映射 | 已按类别归类（入口/API/鸿蒙化/构建配置/导出声明/示例/代码注释） |
+
+---
+
+## 2. 五维度检视检查
+
+| # | 维度 | 通过条件 |
+|---|------|----------|
+| 2.1 | 文档完整性 | 已检查 README、鸿蒙化说明、API 文档、安装指南、使用示例、中文文档 |
+| 2.2 | 文档准确性 | 已核对 API 签名、示例代码可运行性、导出声明一致性、废弃 API |
+| 2.3 | 文档易读性 | 已检查结构、目录导航、语言、图表、格式规范 |
+| 2.4 | 代码级文档质量 | 已检查 JSDoc/TSDoc 覆盖、参数/返回值描述、鸿蒙特有 API 注释 |
+| 2.5 | 鸿蒙化文档专项 | 已检查权限说明、构建配置、差异对比、迁移指南、兼容性说明 |
+
+---
+
+## 3. 评分计算检查
+
+| # | 检查项 | 通过条件 |
+|---|--------|----------|
+| 3.1 | 维度子评分 | 每个维度独立计算 `max(0, 100 - Critical×15 - Major×8 - Minor×3)` |
+| 3.2 | 综合评分 | 按权重加权：30/25/15/10/20 |
+| 3.3 | 严苛保障 | ≥3 Critical → 最高60分；≥1 Critical + ≥5 Major → 最高50分 |
+| 3.4 | 等级标注 | 已按 90-100/80-89/70-79/60-69/50-59/<50 标注等级 |
+
+---
+
+## 4. 报告格式检查（后端解析依赖）
+
+| # | 检查项 | 通过条件 |
+|---|--------|----------|
+| 4.1 | 综合评分行 | `**综合评分：数字/100**`，中文全角冒号 `：`，位于"二、综合评分"首行 |
+| 4.2 | 维度评分明细表 | 紧随综合评分之后展示 |
+| 4.3 | 维度子评分标注 | 每个维度详情末尾标注 `> {维度}子评分：{分数}/100` |
+| 4.4 | 问题清单 | 包含文档/文件、严重度、维度、描述、修复建议 |
+| 4.5 | 改进建议 | 提供可执行的改进建议 |
+
+---
+
+## 5. 常见遗漏检查
+
+| # | 检查项 | 说明 |
+|---|--------|------|
+| 5.1 | 示例代码可运行性 | 导入路径错误是最常见 Critical，务必逐个验证 |
+| 5.2 | 权限说明 | 使用 @ohos.network 等系统 API 必须检查权限说明 |
+| 5.3 | 双 README 同步 | README_zh.md 与 README.md 需双向检查 |
+| 5.4 | 隐含行为文档化 | 生命周期自动 API 调用（如 aboutToDisappear → destroy()） |
+| 5.5 | oh-package.json5 解析 | 允许注释和尾逗号，不能按严格 JSON 解析 |