feat：添加自动审核PR

Author: hao65103940

.github/scripts/validate_pr.py

@@ -0,0 +1,134 @@
+import sys
+import os
+import yaml
+import re
+
+VALID_PREFIXES = ['tool_', 'app_', 'db_', 'kbwf_']
+REQUIRED_FILES = ['data.yaml', 'logo.png', 'README.md']
+REQUIRED_YAML_FIELDS = ['name', 'tags', 'title', 'description']
+VERSION_RE = re.compile(r'^\d+\.\d+\.\d+$')
+
+errors = []
+warnings = []
+
+def check(cond, msg, is_warn=False):
+    if not cond:
+        (warnings if is_warn else errors).append(msg)
+
+def get_valid_tags(root_yaml_path='data.yaml'):
+    if not os.path.isfile(root_yaml_path):
+        print(f"⚠️  未找到根配置文件 {root_yaml_path}，跳过 tags 校验")
+        return set()
+    try:
+        with open(root_yaml_path, encoding='utf-8') as f:
+            data = yaml.safe_load(f)
+        tags = data.get('additionalProperties', {}).get('tags', [])
+        return {tag['name'] for tag in tags if 'name' in tag}
+    except yaml.YAMLError as e:
+        print(f"⚠️  根配置文件解析失败: {e}")
+        return set()
+
+def get_changed_tool_dirs(changed_files_path):
+    dirs = set()
+    with open(changed_files_path) as f:
+        for line in f:
+            parts = line.strip().split('/')
+            if len(parts) >= 2 and parts[0] == 'tools':
+                tool_dir = parts[1]
+                if any(tool_dir.startswith(p) for p in VALID_PREFIXES):
+                    dirs.add(os.path.join('tools', tool_dir))
+    return dirs
+
+def validate_tool_dir(tool_path, valid_tags):
+    tool_name = os.path.basename(tool_path)
+    print(f"\n🔍 校验: {tool_path}")
+
+    # 1. 目录前缀
+    check(
+        any(tool_name.startswith(p) for p in VALID_PREFIXES),
+        f"[{tool_name}] 目录名前缀无效，必须以 {VALID_PREFIXES} 之一开头"
+    )
+
+    # 2. 必要文件
+    for fname in REQUIRED_FILES:
+        check(
+            os.path.isfile(os.path.join(tool_path, fname)),
+            f"[{tool_name}] 缺少必要文件: {fname}"
+        )
+
+    # 3. 至少一个版本目录
+    version_dirs = [
+        d for d in os.listdir(tool_path)
+        if os.path.isdir(os.path.join(tool_path, d)) and VERSION_RE.match(d)
+    ] if os.path.isdir(tool_path) else []
+    check(len(version_dirs) > 0, f"[{tool_name}] 缺少版本目录（如 1.0.0）")
+
+    # 4. data.yaml 内容校验
+    yaml_path = os.path.join(tool_path, 'data.yaml')
+    if os.path.isfile(yaml_path):
+        try:
+            with open(yaml_path, encoding='utf-8') as f:
+                data = yaml.safe_load(f)
+            for field in REQUIRED_YAML_FIELDS:
+                check(
+                    field in data and data[field],
+                    f"[{tool_name}] data.yaml 缺少字段或为空: {field}"
+                )
+            if valid_tags and 'tags' in data and isinstance(data['tags'], list):
+                for tag in data['tags']:
+                    check(
+                        tag in valid_tags,
+                        f"[{tool_name}] data.yaml 中 tag '{tag}' 不合法，可选值: {sorted(valid_tags)}"
+                    )
+        except yaml.YAMLError as e:
+            errors.append(f"[{tool_name}] data.yaml 解析失败: {e}")
+
+    # 5. README.md 非空
+    readme_path = os.path.join(tool_path, 'README.md')
+    if os.path.isfile(readme_path):
+        content = open(readme_path, encoding='utf-8').read().strip()
+        check(len(content) > 50, f"[{tool_name}] README.md 内容过少，请补充工具说明")
+        if tool_name.startswith('tool_'):
+            check(
+                '参数' in content or 'parameter' in content.lower(),
+                f"[{tool_name}] 工具类 README.md 建议包含参数说明",
+                is_warn=True
+            )
+
+    # 6. logo.png 大小
+    logo_path = os.path.join(tool_path, 'logo.png')
+    if os.path.isfile(logo_path):
+        size_kb = os.path.getsize(logo_path) / 1024
+        check(size_kb <= 500, f"[{tool_name}] logo.png 文件过大 ({size_kb:.1f}KB)，建议不超过 500KB", is_warn=True)
+
+def main():
+    changed_files_path = sys.argv[1]
+    valid_tags = get_valid_tags('data.yaml')
+    tool_dirs = get_changed_tool_dirs(changed_files_path)
+
+    if not tool_dirs:
+        print("ℹ️  本次 PR 未涉及 tools/ 目录下的工具，跳过校验。")
+        sys.exit(0)
+
+    print(f"本次 PR 涉及 {len(tool_dirs)} 个工具目录：")
+    for d in tool_dirs:
+        validate_tool_dir(d, valid_tags)
+
+    print("\n" + "=" * 50)
+    if warnings:
+        print(f"⚠️  警告 ({len(warnings)} 条):")
+        for w in warnings:
+            print(f"  - {w}")
+
+    if errors:
+        print(f"\n❌ 错误 ({len(errors)} 条):")
+        for e in errors:
+            print(f"  - {e}")
+        print("\n请修复以上问题后重新提交 PR。")
+        sys.exit(1)
+    else:
+        print("✅ 所有校验通过！")
+        sys.exit(0)
+
+if __name__ == '__main__':
+    main()

.github/workflows/pr-validate.yml

@@ -0,0 +1,59 @@
+name: PR Validation
+
+on:
+  pull_request:
+    branches: [main]
+    paths:
+      - 'tools/**'
+  workflow_dispatch:
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+      contents: read
+
+    steps:
+      - name: Checkout PR
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Get changed files
+        run: git diff --name-only origin/main...HEAD > changed_files.txt
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: pip install pyyaml
+
+      - name: Run validation
+        id: validate
+        run: |
+          python .github/scripts/validate_pr.py changed_files.txt > result.txt 2>&1
+          echo "exit_code=$?" >> $GITHUB_OUTPUT
+          cat result.txt
+
+      - name: Comment on PR
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            const result = fs.readFileSync('result.txt', 'utf8');
+            const exitCode = '${{ steps.validate.outputs.exit_code }}';
+            const icon = exitCode === '0' ? '✅' : '❌';
+            const status = exitCode === '0' ? '校验通过' : '校验失败，请修复后重新提交';
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `## ${icon} PR 自动校验结果\n\n**状态**: ${status}\n\n\`\`\`\n${result}\n\`\`\``
+            });
+
+      - name: Fail if validation failed
+        if: steps.validate.outputs.exit_code != '0'
+        run: exit 1