diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index d769e900..53d5fa08 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -15,6 +15,10 @@ jobs:
         working-directory: openless-all/app
     steps:
       - uses: actions/checkout@v4
+        with:
+          # vendor/qwen-asr 是 macOS 上 build.rs 必须的 git submodule。Windows
+          # checkout 也拉一份保持与 release-tauri.yml 一致，开销几秒可以忽略。
+          submodules: recursive
 
       - uses: actions/setup-node@v4
         with:
diff --git a/.github/workflows/release-tauri.yml b/.github/workflows/release-tauri.yml
index 8412712e..858bdba9 100644
--- a/.github/workflows/release-tauri.yml
+++ b/.github/workflows/release-tauri.yml
@@ -50,6 +50,10 @@ jobs:
       TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
     steps:
       - uses: actions/checkout@v4
+        with:
+          # vendor/qwen-asr 是 macOS 上 build.rs 必须的 git submodule（cc-rs 编译
+          # antirez/qwen-asr 的 C 源），不拉就会在 mac 端 cargo build 阶段挂掉。
+          submodules: recursive
 
       - uses: actions/setup-node@v4
         with: