pr-check.yml

name: PR Quality Check

on:
  pull_request:
    branches: [main, dev]
  push:
    branches: [dev]

jobs:
  # ===========================================================================
  # 路径变更检测 —— 决定哪些子项目需要执行检查
  # ===========================================================================
  changes:
    runs-on: ubuntu-latest
    timeout-minutes: 10
    permissions:
      contents: read
      pull-requests: read
    outputs:
      app-frontend: ${{ steps.filter.outputs.app-frontend }}
      app-rust: ${{ steps.filter.outputs.app-rust }}
      docs: ${{ steps.filter.outputs.docs }}
      website: ${{ steps.filter.outputs.website }}
    steps:
      - uses: actions/checkout@v4
      - uses: dorny/paths-filter@v3
        id: filter
        with:
          filters: |
            app-frontend:
              - 'app/src/**'
              - 'app/package.json'
              - 'app/package-lock.json'
              - 'app/index.html'
              - 'app/vite.config.ts'
              - 'app/tsconfig*.json'
            app-rust:
              - 'app/src-tauri/**'
              - 'app/src-tauri/Cargo.lock'
            docs:
              - 'docs/**'
              - 'scripts/docs-check.mjs'
              - '.docscheckignore'
            website:
              - 'website/**'

  # ===========================================================================
  # App 前端 —— React + Vite + TypeScript
  # ===========================================================================
  app-frontend:
    needs: changes
    if: needs.changes.outputs.app-frontend == 'true'
    runs-on: ubuntu-latest
    timeout-minutes: 15
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: 'npm'
          cache-dependency-path: app/package-lock.json
      - run: cd app && npm ci
      - name: Typecheck
        run: cd app && npx tsc --noEmit
      - name: Build
        run: cd app && npm run build
      # 批 8 T17（G2 分档）：包体闸的**输入是前端构建产物** ⇒ 与产出它的 job 同域。`app/dist` 刚由
      # 上一 step 生成（同一条 `npm run build`：app/package.json = `tsc && vite build`，vite 默认
      # outDir=dist）⇒ `--no-build` 判的正是**本次构建**的产物（去掉它 = 同一条命令再构建一次）。
      # 🔴 挂在无条件 job 会**恒红**（那 job 不构建、`dist` 不入库）：批 8 T17 导出树实测 exit 2。
      - name: First-screen bundle budget (no-build; lazy side NOT judged — first screen only)
        run: node scripts/check-bundle-budget.mjs --no-build

  # ===========================================================================
  # App Rust 后端 —— Tauri 主进程（含单测与 lint）
  # ===========================================================================
  app-rust:
    needs: changes
    if: needs.changes.outputs.app-rust == 'true'
    # 项目含 Windows 专用模块（audio_route_probe/device_probe/gdi_capture 等未做 Linux cfg 隔离），
    # 测试必须在 Windows runner 执行；Linux 编译会因 E0433 失败
    runs-on: windows-latest
    timeout-minutes: 60
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
        with:
          components: clippy
          targets: x86_64-pc-windows-msvc
      # sherpa-onnx 等 crate 编译耗时较长，启用 sccache 加速重复构建
      - name: Cache cargo registry
        uses: Swatinem/rust-cache@v2
        with:
          workspaces: app/src-tauri
      # models/ 不入库（AGENTS.md 铁律），build.rs 的 bundle.resources glob 需要空目录占位
      - name: Prepare models placeholder
        shell: bash
        run: mkdir -p app/src-tauri/models
      # .cargo/config.toml 注入的是本机 Windows 预编译库绝对路径（sherpa-archive/、ort/），
      # ort-sys/sherpa-onnx-sys 只要见到 ORT_LIB_LOCATION/SHERPA_ONNX_ARCHIVE_DIR 存在即跳过下载——
      # CI 无法 unset env，直接移除 config 使注入消失，两库回退在线下载（CI 网络可达）
      - name: Remove local cargo config (CI online download)
        shell: bash
        run: rm -f app/src-tauri/.cargo/config.toml
      # oar-ocr 未启用 ort-sys 的 download-binaries feature（本地靠 ORT_LIB_LOCATION 链接），
      # CI 必须手动提供 ONNX Runtime 库，与本地 ORT_LIB_LOCATION 同机制（CPU 包即可，测试不初始化 CUDA）
      - name: Prepare ONNX Runtime for CI
        shell: bash
        run: |
          mkdir -p app/src-tauri/ort/ci
          curl -sL https://github.com/microsoft/onnxruntime/releases/download/v1.28.0/onnxruntime-win-x64-1.28.0.zip -o /tmp/ort.zip
          unzip -q /tmp/ort.zip -d /tmp/ortx
          cp /tmp/ortx/onnxruntime-win-x64-1.28.0/lib/onnxruntime.* app/src-tauri/ort/ci/
      # sherpa-onnx-sys 自带的在线下载在 CI 上不稳定（曾出现解压残缺导致 LNK1181），
      # 改用官方 SHERPA_ONNX_ARCHIVE_DIR 机制（与本地 config 一致）：curl 预下载 tar 包
      - name: Prepare sherpa-onnx archive for CI
        shell: bash
        run: |
          mkdir -p app/src-tauri/sherpa-archive
          curl -sL "https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.13.5/sherpa-onnx-v1.13.5-win-x64-shared-MT-Release-lib.tar.bz2" \
            -o app/src-tauri/sherpa-archive/sherpa-onnx-v1.13.5-win-x64-shared-MT-Release-lib.tar.bz2
      - name: Test
        # ORT_PREFER_DYNAMIC_LINK=1：与本地一致走动态链接，规避 static MT 与项目 MD 运行时的 LNK2038 冲突
        shell: bash
        env:
          ORT_LIB_LOCATION: ${{ github.workspace }}/app/src-tauri/ort/ci
          ORT_PREFER_DYNAMIC_LINK: "1"
          SHERPA_ONNX_ARCHIVE_DIR: ${{ github.workspace }}/app/src-tauri/sherpa-archive
        # 跳过 3 个预存基线失败（CHANGELOG 已登记，与本版无关）：
        #   ai_client 默认 Provider 断言 / note_filter 两条黄金用例——待后续版本修复
        run: |
          cd app/src-tauri
          # rust-cache 恢复的 target/sherpa-onnx-prebuilt 可能不完整（历史 LNK1181），强制重新下载
          rm -rf target/sherpa-onnx-prebuilt
          cargo test -- --skip ai_client::tests::from_settings_resolves_default_provider_when_set --skip note_filter::golden_tests::session29_live_ui_excluded_from_points --skip note_filter::tests::ocr_points_exclude_watermark_junk_and_dupes
      - name: Lint (clippy)
        shell: bash
        env:
          ORT_LIB_LOCATION: ${{ github.workspace }}/app/src-tauri/ort/ci
          ORT_PREFER_DYNAMIC_LINK: "1"
        run: |
          cd app/src-tauri
          rm -rf target/sherpa-onnx-prebuilt
          cargo clippy -- -D warnings

  # ===========================================================================
  # 官网 —— Next.js 静态站（构建验证，部署走 deploy-website.yml）
  # ===========================================================================
  website:
    needs: changes
    if: needs.changes.outputs.website == 'true'
    runs-on: ubuntu-latest
    timeout-minutes: 15
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: 'npm'
          cache-dependency-path: website/package-lock.json
      - run: cd website && npm ci
      - name: Build
        run: cd website && npm run build

  # ===========================================================================
  # Docs —— 文档体系一致性检查（链接/索引/命名）
  # ===========================================================================
  docs:
    needs: changes
    if: needs.changes.outputs.docs == 'true'
    runs-on: ubuntu-latest
    timeout-minutes: 10
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - name: Docs check
        run: node scripts/docs-check.mjs

  # ===========================================================================
  # 行数红线 — AGENTS.md §3（全部行数口径；>600 棘轮只减不增）
  # ===========================================================================
  line-limits:
    runs-on: ubuntu-latest
    timeout-minutes: 10
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      # --full：CI 在结构之外额外守 (e)「登记值 == 实测值」，与**本地完全同口径**。
      # 本地提交门禁（.husky/pre-commit）自 2026-09-11 起直跑
      # `node scripts/line-limits.mjs --full && node scripts/docs-check.mjs`（不经 lint-staged），
      # 故这条 job 是**第二道**网、不再是唯一守 (e) 的地方。--full 只读、不重写登记表
      # （写表只走 --write），因此本地跑它不会逼迫任何人重新生成表。
      - name: Line limits
        run: node scripts/line-limits.mjs --full
      # 批 0-C3 Task 1：IPC 命令注册一致性（`#[tauri::command]` 定义 ↔ app_commands.rs 注册清单，
      # 三向检查漏/多/重名）。注册清单拆分后漏一条是**唯一会静默失败**的改动面（编译通过、单测全绿，
      # 只有真机点到才报 `command … not found`）⇒ 与 line-limits 同 job（同为纯文本全树只读扫描）。
      - name: Command registry consistency
        run: node scripts/check-command-registry.mjs

      # 批 8 T17（G2 · 脚本域门禁的执行者缺口）：`on:` 无 `paths`，其余四个 job 都带
      # `needs: changes` + `if:`，只有本 job 无条件 ⇒ **不需要构建产物**的脚本域门禁挂在这里，
      # 才每次 PR/push 都跑。不补 `scripts/**` glob —— glob 属 paths-filter 域，补它只覆盖
      # 「新增路径」，且会漏掉「改了 `scripts/**` 却被 filter 判为无变更」这一二次缺口（§2 G2）。
      # 批 8 T17（G6）：豁免表散文数字对拍探针**单列转正**为 CI step，**不并入八闸集合**
      # （八闸集合是批次间对账基线；散文数字天然易漂 ⇒ 硬合并会让逐字对账漂移、频繁假红）。
      - name: Exemption table prose check
        run: node scripts/check-exemption-prose.mjs