ci: add release candidate workflow and upgrade coverage

Author: Wangnov

.github/workflows/ci.yml

@@ -60,8 +60,9 @@ jobs:
         run: cargo llvm-cov --all-features --lcov --output-path lcov.info
 
       - name: Upload to Codecov
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v6
         with:
+          disable_search: true
           files: lcov.info
           fail_ci_if_error: false
 

.github/workflows/release-candidate.yml

@@ -0,0 +1,44 @@
+name: Release Candidate
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  candidate:
+    name: Candidate (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - ubuntu-latest
+          - macos-latest
+          - windows-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache Cargo
+        uses: Swatinem/rust-cache@v2
+
+      - name: Cargo test (all features)
+        run: cargo test --all-features --all-targets
+
+      - name: Verify rust-genai-types package
+        run: cargo package -p rust-genai-types
+
+      - name: Verify rust-genai package
+        run: cargo package -p rust-genai
+
+      - name: Verify rust-genai-macros package
+        run: cargo package -p rust-genai-macros

docs/release.md

@@ -1,26 +1,46 @@
-# 发布流程（tag 驱动）
+# 发布流程（两阶段，tag 驱动）
 
-本仓库当前使用 `cargo release` + GitHub Actions 的 tag 驱动流程发布 crates。
+本仓库当前使用 `cargo release` + GitHub Actions 的两阶段发布流程发布 crates。
 
 ## 关键事实
 
 - 版本号来源：workspace 根 `Cargo.toml` 的 `[workspace.package].version`
+- 候选门禁：手动运行 `.github/workflows/release-candidate.yml`
 - 发布触发：推送 tag `vX.Y.Z`（也兼容 `rust-genai-vX.Y.Z`）会触发 `.github/workflows/release.yml`
 - 当前 `release.yml` 为手写发布流，不是 `cargo dist init` 生成（仓库内也没有 `dist-workspace.toml`）
 
 ## 推荐操作（minor 为例）
 
 ```bash
-# 1) 先预览（不落盘）
-cargo release minor --workspace --no-publish
+# 1) 先预览版本提升
+cargo release minor --workspace --no-publish --no-tag --no-push
 
-# 2) 执行版本更新 + 提交 + 打 tag + 推送
-cargo release minor --workspace --no-publish --execute
+# 2) 写入版本号、同步文档版本，并生成 release commit
+cargo release minor --workspace --no-publish --no-tag --no-push --execute
+
+# 3) 推送 main，让候选工作流有固定提交可检验
+git push origin main
+```
+
+然后在 GitHub Actions 里手动运行 `Release Candidate`，等待 `ubuntu-latest`、`macos-latest`、`windows-latest` 三个平台全部通过。
+
+候选通过后再推送正式 tag：
+
+```bash
+git tag vX.Y.Z
+git push origin vX.Y.Z
 ```
 
 ## 发布工作流会做什么
 
-`release.yml` 会按顺序执行：
+`release-candidate.yml` 会在三个平台上执行：
+
+1. `cargo test --all-features --all-targets`
+2. `cargo package -p rust-genai-types`
+3. `cargo package -p rust-genai`
+4. `cargo package -p rust-genai-macros`
+
+`release.yml` 会在收到 tag 后按顺序执行：
 
 1. `cargo package/publish -p rust-genai-types`
 2. `cargo package/publish -p rust-genai`
@@ -30,6 +50,7 @@ cargo release minor --workspace --no-publish --execute
 ## 发版前检查
 
 - `main` 分支 CI 全绿
+- `Release Candidate` 三个平台全绿
 - `CRATES_IO_TOKEN` 已配置到 GitHub 仓库 Secret
 - 文档中的依赖示例版本与将发布的版本一致