Merge pull request 'fix(setup-antigravity): 修正安裝後 agy 無法被後續 step 取用' (#3) from develop into master

Reviewed-on: #3
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>

.gitea/workflows/ci.yaml

@@ -1,7 +1,7 @@
 # ============================================================================
-# 用途：本 CI workflow 於對 master 或 develop 發出 Pull Request（開啟或更新）時觸發，
+# 用途：本 CI workflow 於對 develop 發出 Pull Request（開啟或更新）時觸發，
 #       checkout 原始碼後以本 repo 的 composite action 安裝工具，並取得工具版本號驗證安裝。
-# 更新時間：2026/07/17 12:38:20
+# 更新時間：2026/07/17 17:02:15
 # ============================================================================
 # workflow 名稱，顯示於 Gitea Actions 介面
 name: CI
@@ -10,18 +10,12 @@ name: CI
 on:
   # 針對 Pull Request 事件觸發
   pull_request:
-    # 僅當 PR 目標分支為下列分支時觸發
+    # 僅當 PR 目標分支為 develop 時觸發
     branches:
-    - master
     - develop
     # 僅在 PR 開啟（opened）或有新 commit 更新（synchronize）時觸發
     types: [opened, synchronize]
 
-# 全域環境變數，供各 job／step 引用
-env:
-  # 是否為 beta：當 PR 目標分支為 develop 時為 true
-  IS_BETA: ${{ gitea.base_ref == 'develop' }}
-
 # 工作（job）定義區塊
 jobs:
   # test job：驗證本 composite action 能正確安裝工具

action.yml

@@ -1,6 +1,6 @@
 # ============================================================================
 # 用途：安裝 Antigravity CLI，並將 base64 編碼的 OAuth 憑證解碼寫入設定檔的 Gitea Composite Action。
-# 更新時間：2026/07/17 11:54:39
+# 更新時間：2026/07/20 15:55:12
 # ============================================================================
 # action 名稱，會顯示在 Gitea Actions 介面與被引用時的識別
 name: 'Setup Antigravity'
@@ -31,14 +31,22 @@ runs:
       echo "================================================"
       echo "Action  : Setup Antigravity"
       echo "用途    : 安裝 Antigravity CLI 並還原 OAuth 憑證"
-      echo "更新時間: 2026/07/17 11:54:39"
+      echo "更新時間: 2026/07/20 15:55:12"
       echo "================================================"
-  # 安裝 Antigravity CLI（以官方安裝腳本，單行指令；binary 安裝至 ~/.local/bin）
+  # 安裝 Antigravity CLI（以官方安裝腳本，binary 安裝至 ~/.local/bin/agy）
   - name: 安裝 Antigravity CLI
     # 使用 bash 執行 run 內容
     shell: bash
-    # 以官方 install.sh 腳本安裝 Antigravity CLI（agy）
-    run: curl -fsSL https://antigravity.google/cli/install.sh | bash
+    # 步驟說明：
+    #   1. 以官方 install.sh 腳本安裝 Antigravity CLI（安裝出的 binary 名為 agy）。
+    #   2. 將 ~/.local/bin 寫入 $GITHUB_PATH，使後續 step 能在 PATH 中找到 agy
+    #      （install.sh 只改 shell profile，不會影響 runner 後續 step 的 PATH）。
+    #   3. 建立 antigravity → agy 的 symlink，提供以工具名稱呼叫的慣用指令
+    #      （呼叫端以 antigravity 偵測／執行時可直接命中）。
+    run: |
+      curl -fsSL https://antigravity.google/cli/install.sh | bash
+      echo "$HOME/.local/bin" >> "$GITHUB_PATH"
+      ln -sf "$HOME/.local/bin/agy" "$HOME/.local/bin/antigravity"
   # 將 base64 OAuth 憑證解碼並寫入 Antigravity 憑證檔（單行：建目錄 → 解碼寫檔 → 限縮權限；不輸出憑證內容）
   - name: 寫入 OAuth 憑證
     # 使用 bash 執行 run 內容