CI 管道

CI 在每次推送到 main 和每个拉取请求时运行。它使用智能范围来跳过昂贵的作业，当只有文档或原生代码发生变化时。

作业概述

作业目的运行时机
docs-scope检测仅文档更改始终
changed-scope检测哪些区域发生了变化（node/macos/android）非文档 PR
checkTypeScript 类型、lint、格式化非文档更改
check-docsMarkdown lint + 损坏链接检查文档已更改
code-analysis代码行数阈值检查（1000 行）仅 PR
secrets检测泄露的密钥始终
build-artifacts构建 dist 一次，与其他作业共享非文档，node 更改
release-check验证 npm pack 内容构建后
checksNode/Bun 测试 + 协议检查非文档，node 更改
checks-windowsWindows 特定测试非文档，node 更改
macosSwift lint/构建/测试 + TS 测试有 macos 更改的 PR
androidGradle 构建 + 测试非文档，android 更改

快速失败顺序

作业排序使得廉价检查在昂贵的作业运行之前失败：

  1. docs-scope + code-analysis + check（并行，约 1-2 分钟）
  2. build-artifacts（在上述作业完成后）
  3. checks、checks-windows、macos、android（在构建完成后）

运行器

运行器作业
blacksmith-16vcpu-ubuntu-2404大多数 Linux 作业，包括范围检测
blacksmith-16vcpu-windows-2025checks-windows
macos-latestmacos、ios

本地等效命令

bash
pnpm check          # 类型 + lint + 格式化
pnpm test           # vitest 测试
pnpm check:docs     # 文档格式化 + lint + 损坏链接
pnpm release:check  # 验证 npm pack