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

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

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 內容