@ohos-cpf/3rdloop 0.0.2 → 0.0.4

package/vendor/Server/Skills/rn-library-known-issue-check/references/SOURCE_PREP_GUIDE.md

@@ -1,75 +1,75 @@
-# 源码准备指南
-
-> 本文档说明检视前如何准备源码目录，确保 Phase 1-3 的输入完整且正确。
-
----
-
-## 1. 源码目录结构
-
-检视前，`{outputDir}` 下应包含以下结构：
-
-```
-{outputDir}/
-├── 接口规格说明.md                    # 前置 SKILL 产出（必需）
-├── source/
-│   ├── ohos/                          # 鸿蒙化实现代码（必需）
-│   │   ├── harmony/                   # 常见目录
-│   │   ├── src/main/cpp/              # C++ TurboModule 实现
-│   │   ├── oh-package.json5           # 鸿蒙依赖声明
-│   │   ├── package.json               # 补充依赖声明
-│   │   └── ...
-│   └── RN/                            # 上游原库代码（可选，用于对比）
-│       └── ...
-```
-
----
-
-## 2. 获取源码
-
-### 2.1 克隆鸿蒙化仓库
-
-```bash
-git clone --depth=1 {ohosRepoUrl} {outputDir}/source/ohos/
-```
-
-### 2.2 克隆上游原库（可选）
-
-```bash
-git clone --depth=1 {upstreamRepoUrl} {outputDir}/source/RN/
-```
-
-> 上游原库用于对比：判断某问题是鸿蒙化引入的，还是上游遗留问题。
-
----
-
-## 3. 源码目录检查
-
-### 3.1 必需文件检查
-
-| 文件 | 用途 | 缺失处理 |
-|------|------|----------|
-| `oh-package.json5` | 依赖特征预筛 | 跳过依赖维度预筛，使用 `package.json` 替代 |
-| `package.json` | 依赖特征预筛 | 跳过依赖维度预筛 |
-| 至少一个 `.ets`/`.ts` 文件 | 鸿蒙化实现 | 判定为「未实现鸿蒙化」，检视跳过 |
-| 至少一个 `.cpp`/`.h` 文件 | 可能含 C++ 层实现 | 跳过 C++ 相关规则（R-07/R-12） |
-
-### 3.2 文件命名约定
-
-检视 Agent 应识别以下常见鸿蒙化目录布局：
-
-| 目录 | 说明 |
-|------|------|
-| `harmony/` | 标准鸿蒙化目录（首选） |
-| `ohos/` | 早期鸿蒙化目录 |
-| `src/main/cpp/` | C++ TurboModule 实现 |
-| `src/main/ets/` | ArkTS 实现 |
-| `harmony/entry/src/main/ets/` | 鸿蒙工程入口 |
-
-### 3.3 排除规则
-
-以下目录/文件不纳入检视范围：
-- `example/` — 示例工程代码
-- `node_modules/` — 依赖包
-- `build/`、`builds/` — 构建产物
-- `.git/` — Git 元数据
+# 源码准备指南
+
+> 本文档说明检视前如何准备源码目录，确保 Phase 1-3 的输入完整且正确。
+
+---
+
+## 1. 源码目录结构
+
+检视前，`{outputDir}` 下应包含以下结构：
+
+```
+{outputDir}/
+├── 接口规格说明.md                    # 前置 SKILL 产出（必需）
+├── source/
+│   ├── ohos/                          # 鸿蒙化实现代码（必需）
+│   │   ├── harmony/                   # 常见目录
+│   │   ├── src/main/cpp/              # C++ TurboModule 实现
+│   │   ├── oh-package.json5           # 鸿蒙依赖声明
+│   │   ├── package.json               # 补充依赖声明
+│   │   └── ...
+│   └── RN/                            # 上游原库代码（可选，用于对比）
+│       └── ...
+```
+
+---
+
+## 2. 获取源码
+
+### 2.1 克隆鸿蒙化仓库
+
+```bash
+git clone --depth=1 {ohosRepoUrl} {outputDir}/source/ohos/
+```
+
+### 2.2 克隆上游原库（可选）
+
+```bash
+git clone --depth=1 {upstreamRepoUrl} {outputDir}/source/RN/
+```
+
+> 上游原库用于对比：判断某问题是鸿蒙化引入的，还是上游遗留问题。
+
+---
+
+## 3. 源码目录检查
+
+### 3.1 必需文件检查
+
+| 文件 | 用途 | 缺失处理 |
+|------|------|----------|
+| `oh-package.json5` | 依赖特征预筛 | 跳过依赖维度预筛，使用 `package.json` 替代 |
+| `package.json` | 依赖特征预筛 | 跳过依赖维度预筛 |
+| 至少一个 `.ets`/`.ts` 文件 | 鸿蒙化实现 | 判定为「未实现鸿蒙化」，检视跳过 |
+| 至少一个 `.cpp`/`.h` 文件 | 可能含 C++ 层实现 | 跳过 C++ 相关规则（R-07/R-12） |
+
+### 3.2 文件命名约定
+
+检视 Agent 应识别以下常见鸿蒙化目录布局：
+
+| 目录 | 说明 |
+|------|------|
+| `harmony/` | 标准鸿蒙化目录（首选） |
+| `ohos/` | 早期鸿蒙化目录 |
+| `src/main/cpp/` | C++ TurboModule 实现 |
+| `src/main/ets/` | ArkTS 实现 |
+| `harmony/entry/src/main/ets/` | 鸿蒙工程入口 |
+
+### 3.3 排除规则
+
+以下目录/文件不纳入检视范围：
+- `example/` — 示例工程代码
+- `node_modules/` — 依赖包
+- `build/`、`builds/` — 构建产物
+- `.git/` — Git 元数据
 - `oh_modules/` — 鸿蒙依赖

package/vendor/Server/Skills/rn-library-known-issue-check/scripts/validate-known-issue-report.py

@@ -1,164 +1,164 @@
-#!/usr/bin/env python3
-# @tool validate-known-issue-report
-# @description 校验已知问题检视报告是否完整，检查报告结构、评分公式、证据完整性（跨平台：Windows/macOS/Linux）
-# @param reportDir: string - 检视报告所在目录绝对路径
-
-import json
-import os
-import re
-import sys
-
-
-def parse_args():
-    """解析命令行参数：支持 JSON 字符串（MCP Gateway 约定）或直接传目录路径"""
-    if len(sys.argv) > 1:
-        raw = sys.argv[1]
-        # 尝试解析为 JSON（MCP Gateway 传参方式）
-        try:
-            return json.loads(raw).get("reportDir", "")
-        except json.JSONDecodeError:
-            # 非 JSON，视为直接传入的目录路径
-            return raw.strip()
-    return ""
-
-
-def main():
-    report_dir = parse_args()
-
-    if not report_dir:
-        print("Usage: validate-known-issue-report.py <reportDir>")
-        print("Error: reportDir parameter is required")
-        return 1
-
-    if not os.path.isdir(report_dir):
-        print(f"Error: Directory does not exist: {report_dir}")
-        return 1
-
-    report_file = os.path.join(report_dir, "已知问题检视报告.md")
-    if not os.path.isfile(report_file):
-        print(f"Error: Report file not found: {report_file}")
-        return 1
-
-    # 读取报告内容（UTF-8，兼容中文）
-    with open(report_file, "r", encoding="utf-8") as f:
-        content = f.read()
-
-    passed = 0
-    failed = 0
-    warnings = 0
-
-    def check_pass(msg):
-        nonlocal passed
-        print(f"  ✅ {msg}")
-        passed += 1
-
-    def check_fail(msg):
-        nonlocal failed
-        print(f"  ❌ {msg}")
-        failed += 1
-
-    def check_warn(msg):
-        nonlocal warnings
-        print(f"  ⚠️  {msg}")
-        warnings += 1
-
-    print("=== 已知问题检视报告校验 ===")
-    print(f"目录: {report_dir}")
-    print("")
-
-    # ─── 1. 报告结构检查 ───
-    print("--- 1. 报告结构检查 ---")
-    for section in ["检视概览", "规则命中清单", "命中问题详情", "检视结论"]:
-        if section in content:
-            check_pass(f"包含「{section}」章节")
-        else:
-            check_fail(f"缺少「{section}」章节")
-
-    # ─── 2. 评分检查 ───
-    print("")
-    print("--- 2. 评分检查 ---")
-
-    # 提取评分（兼容 **评分** | {score}/100 或 **评分**：{score}/100 等格式）
-    score_match = re.search(r"\*\*评分\*\*[^\d]*(\d+)\s*/\s*100", content)
-    if score_match:
-        score = int(score_match.group(1))
-        if 0 <= score <= 100:
-            check_pass(f"评分在有效范围 (0-100): {score}")
-        else:
-            check_fail(f"评分超出有效范围: {score}")
-    else:
-        check_fail("未找到评分字段")
-
-    # 检查评分公式
-    if re.search(r"100\s*[−\-]\s*30", content):
-        check_pass("评分公式正确 (100 - 30×命中数)")
-    else:
-        check_warn("未找到评分公式说明")
-
-    # ─── 3. 命中规则检查 ───
-    print("")
-    print("--- 3. 命中规则检查 ---")
-
-    hit_rules = len(re.findall(r"\*\*命中\*\*", content))
-    if hit_rules > 0:
-        check_pass(f"包含 {hit_rules} 条命中规则")
-        # 检查是否有案例引用
-        if re.search(r"KI-\d+", content):
-            check_pass("命中规则引用了案例 (KI-XXX)")
-        else:
-            check_warn("命中规则未引用案例")
-        # 检查是否有修复指引
-        if re.search(r"修复指引|修复方案|正确特征", content):
-            check_pass("命中规则包含修复指引")
-        else:
-            check_warn("命中规则缺少修复指引")
-    else:
-        check_warn("无命中规则")
-
-    # ─── 4. 不适用规则清单 ───
-    print("")
-    print("--- 4. 不适用规则检查 ---")
-
-    if re.search(r"不适用规则清单|不适用规则", content):
-        check_pass("包含不适用规则清单")
-        # 检查是否有跳过原因
-        if re.search(r"不适用原因|预筛未命中", content):
-            check_pass("不适用规则记录了跳过原因")
-        else:
-            check_warn("不适用规则缺少跳过原因")
-    else:
-        check_warn("无不适用规则清单")
-
-    # ─── 5. 证据完整性 ───
-    print("")
-    print("--- 5. 证据完整性检查 ---")
-
-    if re.search(r"```(cpp|typescript|arkts|ts|java)", content):
-        check_pass("命中规则包含代码片段证据")
-    else:
-        check_warn("命中规则缺少代码片段证据")
-
-    # 检查文件路径引用
-    if re.search(r"\.(cpp|h|ets|ts|java):\d+", content):
-        check_pass("证据包含文件路径+行号")
-    else:
-        check_warn("证据未包含文件路径+行号")
-
-    # ─── 总结 ───
-    print("")
-    print("=== 校验总结 ===")
-    print(f"  ✅ 通过: {passed}")
-    print(f"  ❌ 失败: {failed}")
-    print(f"  ⚠️  警告: {warnings}")
-    print("")
-
-    if failed == 0:
-        print("ALL CHECKS PASSED")
-        return 0
-    else:
-        print(f"VALIDATION FAILED: {failed} 个必须修复的问题")
-        return 1
-
-
-if __name__ == "__main__":
-    sys.exit(main())
+#!/usr/bin/env python3
+# @tool validate-known-issue-report
+# @description 校验已知问题检视报告是否完整，检查报告结构、评分公式、证据完整性（跨平台：Windows/macOS/Linux）
+# @param reportDir: string - 检视报告所在目录绝对路径
+
+import json
+import os
+import re
+import sys
+
+
+def parse_args():
+    """解析命令行参数：支持 JSON 字符串（MCP Gateway 约定）或直接传目录路径"""
+    if len(sys.argv) > 1:
+        raw = sys.argv[1]
+        # 尝试解析为 JSON（MCP Gateway 传参方式）
+        try:
+            return json.loads(raw).get("reportDir", "")
+        except json.JSONDecodeError:
+            # 非 JSON，视为直接传入的目录路径
+            return raw.strip()
+    return ""
+
+
+def main():
+    report_dir = parse_args()
+
+    if not report_dir:
+        print("Usage: validate-known-issue-report.py <reportDir>")
+        print("Error: reportDir parameter is required")
+        return 1
+
+    if not os.path.isdir(report_dir):
+        print(f"Error: Directory does not exist: {report_dir}")
+        return 1
+
+    report_file = os.path.join(report_dir, "已知问题检视报告.md")
+    if not os.path.isfile(report_file):
+        print(f"Error: Report file not found: {report_file}")
+        return 1
+
+    # 读取报告内容（UTF-8，兼容中文）
+    with open(report_file, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    passed = 0
+    failed = 0
+    warnings = 0
+
+    def check_pass(msg):
+        nonlocal passed
+        print(f"  ✅ {msg}")
+        passed += 1
+
+    def check_fail(msg):
+        nonlocal failed
+        print(f"  ❌ {msg}")
+        failed += 1
+
+    def check_warn(msg):
+        nonlocal warnings
+        print(f"  ⚠️  {msg}")
+        warnings += 1
+
+    print("=== 已知问题检视报告校验 ===")
+    print(f"目录: {report_dir}")
+    print("")
+
+    # ─── 1. 报告结构检查 ───
+    print("--- 1. 报告结构检查 ---")
+    for section in ["检视概览", "规则命中清单", "命中问题详情", "检视结论"]:
+        if section in content:
+            check_pass(f"包含「{section}」章节")
+        else:
+            check_fail(f"缺少「{section}」章节")
+
+    # ─── 2. 评分检查 ───
+    print("")
+    print("--- 2. 评分检查 ---")
+
+    # 提取评分（兼容 **评分** | {score}/100 或 **评分**：{score}/100 等格式）
+    score_match = re.search(r"\*\*评分\*\*[^\d]*(\d+)\s*/\s*100", content)
+    if score_match:
+        score = int(score_match.group(1))
+        if 0 <= score <= 100:
+            check_pass(f"评分在有效范围 (0-100): {score}")
+        else:
+            check_fail(f"评分超出有效范围: {score}")
+    else:
+        check_fail("未找到评分字段")
+
+    # 检查评分公式
+    if re.search(r"100\s*[−\-]\s*30", content):
+        check_pass("评分公式正确 (100 - 30×命中数)")
+    else:
+        check_warn("未找到评分公式说明")
+
+    # ─── 3. 命中规则检查 ───
+    print("")
+    print("--- 3. 命中规则检查 ---")
+
+    hit_rules = len(re.findall(r"\*\*命中\*\*", content))
+    if hit_rules > 0:
+        check_pass(f"包含 {hit_rules} 条命中规则")
+        # 检查是否有案例引用
+        if re.search(r"KI-\d+", content):
+            check_pass("命中规则引用了案例 (KI-XXX)")
+        else:
+            check_warn("命中规则未引用案例")
+        # 检查是否有修复指引
+        if re.search(r"修复指引|修复方案|正确特征", content):
+            check_pass("命中规则包含修复指引")
+        else:
+            check_warn("命中规则缺少修复指引")
+    else:
+        check_warn("无命中规则")
+
+    # ─── 4. 不适用规则清单 ───
+    print("")
+    print("--- 4. 不适用规则检查 ---")
+
+    if re.search(r"不适用规则清单|不适用规则", content):
+        check_pass("包含不适用规则清单")
+        # 检查是否有跳过原因
+        if re.search(r"不适用原因|预筛未命中", content):
+            check_pass("不适用规则记录了跳过原因")
+        else:
+            check_warn("不适用规则缺少跳过原因")
+    else:
+        check_warn("无不适用规则清单")
+
+    # ─── 5. 证据完整性 ───
+    print("")
+    print("--- 5. 证据完整性检查 ---")
+
+    if re.search(r"```(cpp|typescript|arkts|ts|java)", content):
+        check_pass("命中规则包含代码片段证据")
+    else:
+        check_warn("命中规则缺少代码片段证据")
+
+    # 检查文件路径引用
+    if re.search(r"\.(cpp|h|ets|ts|java):\d+", content):
+        check_pass("证据包含文件路径+行号")
+    else:
+        check_warn("证据未包含文件路径+行号")
+
+    # ─── 总结 ───
+    print("")
+    print("=== 校验总结 ===")
+    print(f"  ✅ 通过: {passed}")
+    print(f"  ❌ 失败: {failed}")
+    print(f"  ⚠️  警告: {warnings}")
+    print("")
+
+    if failed == 0:
+        print("ALL CHECKS PASSED")
+        return 0
+    else:
+        print(f"VALIDATION FAILED: {failed} 个必须修复的问题")
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())