chore: import upstream snapshot with attribution

2026-07-13 12:32:26 +08:00
commit 1443d3fdf9
732 changed files with 196602 additions and 0 deletions
@@ -0,0 +1,157 @@
+# GitHub Actions workflow for Ruff code formatting and linting
+# 自动运行 Ruff 格式检查和修复
+#
+# 触发条件：
+# 1. Push 到 main 分支时：自动格式化并提交
+
+name: Ruff Format Check
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'backend/**/*.py'
+      - 'backend/pyproject.toml'
+      - 'Makefile'
+      - '.github/workflows/ruff.yml'
+
+# 设置写入权限，允许自动提交格式化代码
+permissions:
+  contents: write
+
+jobs:
+  ruff:
+    name: Ruff Format & Lint
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: backend
+
+    steps:
+      # 1. 检出代码
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      # 2. 安装 uv（项目使用 uv 作为包管理器）
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "0.7.2"
+
+      # 3. 设置 Python 环境
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      # 4. 安装 ruff 依赖（根据项目配置，ruff 在 dev 依赖组中）
+      - name: Install dependencies
+        run: |
+          uv sync --group dev
+
+      # 5. 运行 Ruff 格式检查（与项目的 make lint 命令一致）
+      - name: Run Ruff format check
+        id: ruff-format
+        run: |
+          set +e  # 不立即退出失败
+
+          echo "Running ruff check (uv run python -m ruff check package)..."
+          uv run python -m ruff check package
+          ruff_check_result=$?
+
+          echo "Running ruff format diff check (uv run python -m ruff format package --diff)..."
+          uv run python -m ruff format package --diff
+          ruff_format_result=$?
+
+          echo "Running import sorting check (uv run python -m ruff check --select I package)..."
+          uv run python -m ruff check --select I package
+          ruff_import_result=$?
+
+          # 检查是否有任何错误
+          if [ $ruff_check_result -eq 0 ] && [ $ruff_format_result -eq 0 ] && [ $ruff_import_result -eq 0 ]; then
+            echo "ruff_format_passed=true" >> $GITHUB_OUTPUT
+            echo "✅ Ruff format check passed"
+          else
+            echo "ruff_format_passed=false" >> $GITHUB_OUTPUT
+            echo "❌ Ruff format check failed"
+            echo "::warning::Ruff format check found issues that should be addressed"
+
+            # 汇总错误信息
+            echo "## Ruff Format Issues Summary" > $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "The following formatting issues were found:" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+
+            # 运行 ruff check 以获取详细错误信息
+            echo "### Detailed Issues:" >> $GITHUB_STEP_SUMMARY
+            uv run python -m ruff check package --output-format=github >> $GITHUB_STEP_SUMMARY 2>&1 || true
+
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "To fix these issues locally, run:" >> $GITHUB_STEP_SUMMARY
+            echo "\`\`\`bash" >> $GITHUB_STEP_SUMMARY
+            echo "make format" >> $GITHUB_STEP_SUMMARY
+            echo "\`\`\`" >> $GITHUB_STEP_SUMMARY
+          fi
+
+      # 6. 针对不同事件类型执行不同操作
+      - name: Process Ruff Results
+        if: ${{ github.event_name == 'push' }}
+        env:
+          GIT_AUTHOR_NAME: "GitHub Actions"
+          GIT_AUTHOR_EMAIL: "actions@github.com"
+          GIT_COMMITTER_NAME: "GitHub Actions"
+          GIT_COMMITTER_EMAIL: "actions@github.com"
+        run: |
+          echo "Processing push event to main branch..."
+
+          # 检查当前是否有未提交的修改
+          if ! git diff --exit-code --quiet; then
+            echo "⚠️  Warning: There are uncommitted changes before formatting"
+            echo "The formatting process might need to handle this specially."
+          fi
+
+          # 先检查是否有格式问题
+          echo "Checking for formatting issues..."
+          set +e
+          uv run python -m ruff check package --quiet
+          has_ruff_issues=$?
+          set -e
+
+          if [ $has_ruff_issues -eq 0 ]; then
+            echo "✅ No formatting issues found"
+            exit 0
+          fi
+
+          echo "Formatting issues detected, running automatic fixes..."
+
+          # 自动应用格式修复（与项目的 make format 命令一致）
+          echo "Running uv run ruff format package"
+          uv run ruff format package
+
+          echo "Running uv run ruff check package --fix"
+          uv run ruff check package --fix
+
+          echo "Running uv run python -m ruff check --select I package --fix"
+          uv run python -m ruff check --select I package --fix
+
+          # 检查是否有格式变更
+          echo "Checking for formatting changes..."
+          if git diff --exit-code --quiet; then
+            echo "✅ No formatting changes needed"
+          else
+            echo "📝 Formatting changes detected"
+            echo "Changed files:"
+            git diff --name-only
+
+            # 添加所有变更并提交
+            git add .
+            git commit -m "style: auto-format with ruff [skip ci]"
+
+            echo "📤 Pushing formatting changes..."
+            git push
+            echo "✅ Formatting changes committed and pushed"
+          fi