哈囉！各位熱血開發者！這兩天打開你的 Google Antigravity，是不是也瞬間傻眼了？那個熟悉、好用的 push 按鈕和 Source Control 介面怎麼不見了？Projects 清單怎麼多了一堆重複的項目？別慌！這不是你的系統壞掉，而是 Antigravity 2.0 迎來了劃時代的「Agentic 任務特工」轉型。本文將帶你一步步拆解這次大改版，教你如何綁定 GitHub MCP、安全清理重複專案，甚至是優雅回退舊版本，讓你輕鬆掌握這股開發新引力！
1. 時代變了！從傳統 IDE 跨入「Agent 任務控制中心」的新思維
以前我們用 AI 輔助開發，最習慣的模式就是「人在 IDE 裡面敲程式碼，AI 在旁邊當副駕駛（Copilot）」。你需要按 Tab 自動補完、需要在右側邊欄叫出 Chat 問問題，然後手動複製貼上。但這一次，Google 徹底顛覆了這個遊戲規則。
這也解釋了為什麼許多剛更新 2.0 的朋友會大喊「找不到熟悉的 Source Control 介面了！」。因為在 Google 的新藍圖中，你不再需要頻繁地手動 commit、push，這些機械式的 Git 動作，未來都是要直接委託給 Agent 去執行的。如果你一開始覺得不習慣、覺得多繞了好幾步路，這是完全正常的！因為你正在經歷一場從「打字工」升級到「架構審查員」的思維轉變。
2. 關鍵時間軸：Antigravity 2.0 到底什麼時候更新？
這次改版來得又快又急，許多部落客與開發社群在第一時間掀起討論。以下為大家整理最精準的改版時間軸，方便你核對本機的版本狀態：
| 發布版本 | 發布時間 (UTC+8) | 定位與產品變更 | 使用者痛點 / 有感功能 |
|---|---|---|---|
| Antigravity 1.23.2 | 2026/04/16 | 經典 IDE 工作流的最後穩定版 | 傳統 Source Control、直覺的終端機與 push 按鈕 |
| Antigravity 2.0.0 | 2026/05/19 | 大改版！正式更名為獨立桌面 App | 導入多 Agent 併行、CLI 腳本、SDK 整合。但爆出專案重複匯入 Bug |
| Antigravity 2.0.1 | 2026/05/19 稍晚 | 緊急熱修復 (Hotfix) 版本 | 修正 1.0 升級時產生的 Project 衝突，但部分使用者仍有快取殘留問題 |
由於 Google 的更新推送採用「分批漸進式（Phased Rollout）」策略，因此有些人可能在 5/19 晚上就自動升級，有些朋友則是到了 5/20 或 5/21 打開軟體時才驚覺被強迫升級了。如果你的介面已經變成具有「Agent Manager」和「Artifacts」的分頁，那麼恭喜你，你已經站在 2.x 的新世界了！
3. 程式碼 push 不見了？三大防禦性應對工作流
「天啊！我改好程式碼了，但 Source Control 分頁縮水，我找不到 push 的按鈕怎麼辦？」這大概是社群裡哀嚎聲最大的一點。在新版 Agentic 哲學下，Google 刻意淡化了這些傳統 Git 按鈕。為了防禦跑版和資安防護，站長在這裡為大家整理了三條最穩健、最安全的代碼提交路徑：
🛡️ 防禦路徑 A：回歸最純粹的 Terminal 終端機（最推薦）
不管前端介面怎麼改、AI 怎麼變，底層的 Git 是永遠不會背叛你的。你可以直接在 Antigravity 2.0 下方的內建終端機（Terminal）或本機的終端機中，手動輸入標準 Git 指令。這能保證 100% 的精準度，絕不會被 AI 誤刪程式碼：
# 1. 先確認當前的分支與檔案變動狀態 git status # 2. 將修改的檔案加入暫存區 git add . # 3. 提交變更，寫下清楚的 Commit Message git commit -m "feat: 調整登入驗證邏輯並整合 Antigravity 2.0" # 4. 安全地推送到 GitHub 遠端庫 git push origin main
🛡️ 防禦路徑 B：使用外部 GUI 工具進行視覺化託管
如果你非常依賴「點擊按鈕」來確認每行程式碼的 diff，強烈建議你下載並搭配 GitHub Desktop 或者是使用 VS Code 的 Git 內建外掛。讓 Antigravity 專注扮演你的「AI 研發大腦」，而程式碼的提交、推送、衝突解決，則交給專業的 Git 託管工具。這種「雙劍合璧」的工作流，是目前許多資深開發者最推崇的作法。
🛡️ 防禦路徑 C：調用內建 Editor View（編輯器視圖）
在新版介面的右上角，尋找一個類似「視窗切換」或寫著 Editor View 的小圖示。點擊切換後，系統會將操作面板還原成比較接近 1.x 時代的配置。在這裡，你依然可以找到簡化版的 Source Control 面板，進行基礎的 commit 與 sync 操作。
4. 實戰教學：透過 GitHub MCP Server 綁定你的 AI 特工
既然 2.0 是為了「Agent-first」而生，那它最強大的地方莫過於能透過 Model Context Protocol (MCP)，讓 AI 特工直接連通你的 GitHub！串接成功後，你可以直接用語音或文字命令 AI 特工：「幫我查一下這個 repo 目前有什麼 issue，並開一個 bug-fix 分支解決它！」
🛠️ 第一步：前往 GitHub 申請專用 Token
- 登入 GitHub，點擊右上角大頭貼 -> 進入 Settings。
- 拉到最下方，點擊 Developer settings -> 展開 Personal Access Tokens -> 選擇 Fine-grained tokens。
- 點擊 Generate new token。
- **Token Name：** 輸入
antigravity-agent-token-2026（方便辨識）。 - **Repository access：** 強烈建議點選 Only select repositories，並只勾選你目前需要 AI 幫忙開發的專案。千萬不要選 All repositories！
- **Permissions（權限勾選）：** 根據下表進行精確設定：
| 權限項目 (Repository Permissions) | 建議設定等級 | 為什麼要這樣設定？ |
|---|---|---|
| Contents | Read and write | 允許 Agent 讀取你的原始碼，並在修改後能產生 commit。 |
| Pull Requests | Read and write | 允許 Agent 自動幫你發起 Pull Request (PR) 供你審查。 |
| Issues | Read and write | 允許 Agent 讀取 Bug 回報與任務卡片，並自動關閉已解決的 Issue。 |
| Metadata | Read-only (自動帶入) | GitHub 基礎 API 呼叫，為系統預設強制唯讀。 |
設定完成後，點擊 Generate token。**請務必複製這串以 github_pat_ 開頭的長字串，並妥善保管！** 因為這組序號只會出現一次，關閉網頁後就再也看不到了。
🛠️ 第二步：在 Antigravity 2.0 中設定 MCP Server
現在，請打開你的 Antigravity 2.0 控制台，進入設定頁面（Settings），尋找 Agent Connectors 或 MCP Servers 設定區。點擊新增 GitHub MCP，在 Token 或環境變數欄位中，填入剛才申請的 Fine-grained Token，並重新啟動 Agent。一旦綠燈亮起，代表你的 AI 特工已經正式取得了與 GitHub 溝通的超能力！
5. 終極自救指南：重複或雜亂的 Projects 一次安全清理乾淨
更新到 2.0 或 2.0.1 之後，許多開發者遇到最頭痛的 Bug 就是「重複的 Projects」。這主要是因為舊版的 Workspace 目錄格式，在轉換為 2.0 全新 Project UUID 時，因為快取與路徑不相容，導致同一個資料夾重複生成了 3 到 4 次，搞得專案清單亂七八糟。如果你也有這種「專案強迫症」，請跟著以下步驟，手動進行安全而徹底的重置！
🍎 MacOS 與 Linux 使用者的快取重置步驟
請先徹底關閉 Antigravity 應用程式（建議使用 Command + Q 強制結束）。打開你的 Terminal，並依序貼上以下指令：
# Step 1. 將整套舊有 Gemini 設定檔與快取完整備份至暫存資料夾（預防萬一） cp -a ~/.gemini ~/.gemini_backup_$(date +%Y%m%d_%H%M%S) # Step 2. 移動並改名專案配置資料夾，這能瞬間清空重複的 Projects 快取 mv ~/.gemini/config/projects ~/.gemini/config/projects_old_corrupted # Step 3. 建立一個全新、乾淨、無污染的 projects 資料夾 mkdir -p ~/.gemini/config/projects
🪟 Windows 使用者的 PowerShell 快取重置步驟
請先確認 Antigravity 已關閉（可至工作管理員檢查）。在開始功能表搜尋 PowerShell，並以系統管理員身分執行，接著貼上以下指令：
# Step 1. 強制關閉所有可能在背景殘留的 Antigravity 行程 Stop-Process -Name "Antigravity" -Force -ErrorAction SilentlyContinue # Step 2. 獲取當前時間戳記 $stamp = Get-Date -Format "yyyyMMdd_HHmmss" # Step 3. 完整備份舊的設定與快取 Copy-Item "$env:USERPROFILE\.gemini" "$env:USERPROFILE\.gemini_backup_$stamp" -Recurse # Step 4. 將有 Bug 的 projects 資料夾重新命名 Rename-Item "$env:USERPROFILE\.gemini\config\projects" "projects_deleted_$stamp" # Step 5. 重新建立全新的乾淨 projects 目錄 New-Item -ItemType Directory -Path "$env:USERPROFILE\.gemini\config\projects" -Force
執行完畢後，重新開啟 Antigravity 2.0。你會發現整個 Projects 列表就像剛灌好新電腦一樣，變得無比乾淨！這時候，你只需要點選「Open Folder」，重新將你真正需要的專案資料夾拉進來，就不會再出現重複與打架的問題囉！
6. 回退 1.23.2 舊版的完美落地步驟
「站長，我真的用不習慣 2.0，專案火燒屁股了，我可以換回舊版嗎？」沒問題！如果你目前的專案進度非常緊湊，確實沒有時間適應新的 Agent 邏輯，那麼暫時「回退舊版」是一個非常理性的短暫防禦策略。
要完美回退至最穩定的 1.23.2 版本，請務必按照以下步驟執行，否則系統可能會因為快取衝突而狂吐 Error：
- 完整卸載： 請先將本機的 Antigravity 2.0 / 2.0.1 進行完整移除（Mac 拖進垃圾桶並清理 Application Support；Windows 使用控制台解除安裝）。
- 清理殘留： 請參照上方第 5 點的教學，將
~/.gemini目錄底下的暫存快取移走或改名，避免舊版程式去讀取到新版 2.0 的設定檔。 - 取得安裝檔： 前往官方 Antigravity Releases 頁面，下載 2026/04/16 發布的
1.23.2對應作業系統安裝包，並重新安裝。 - 關閉自動更新（關鍵）： 重新安裝並打開後，立刻按下
Ctrl + ,(Windows) 或Cmd + ,(Mac) 開啟設定，搜尋 Update Mode，並將其調整為 manual 或 none。否則，只要你一下線，軟體在半夜又會自動幫你升級到最新的 2.x 版喔！
7. 常見問題全解答 (Q&A)
針對這次大改版，站長在各大社群、論壇與 GitHub Issue 中整理了大家最常遇到的疑惑，並邀請資深開發大佬為大家精準解答：
Q1：Antigravity 2.0 的官方具體更新時間是什麼時候？
A：根據 Google I/O 2026 官方開發者大會公告，Antigravity 2.0 與熱修復 2.0.1 版本皆是在 2026 年 5 月 19 日 正式發布。部分使用者可能因為地區或分批推送機制的關係，在 5/20 或 5/21 才陸續接收到更新通知。
Q2：為什麼 Source Control 介面跟以前大不相同？我要怎麼 push 代碼？
A：這是因為 2.0 的核心理念是「Agentic Workflow」。官方期望未來所有的 Git 提交與發布都由 Agent 代理執行。若不習慣，你依然可以直接在軟體內建的 Terminal 使用標準的 git push 指令，或者使用 GitHub Desktop 等外部 GUI 工具進行操作，這也是目前最安全的作法。
Q3：GitHub MCP Server 相比以前的 token 串接，優勢在哪裡？
A：傳統 token 串接只是為了讀寫檔案。而 GitHub MCP (Model Context Protocol) 是一個標準協定，它能讓 AI Agent 具備「思考與決策」能力，例如它可以主動去讀取 issue 列表、交叉比對 PR、執行 workflow 自動化測試，不再只是個單純的程式碼產生器，而是真正的「虛擬 AI 工程特工」。
Q4：我的 GitHub Access Token 權限，需要開到最滿嗎？
A：絕對不要！請遵循「最小權限原則」。在 GitHub 申請 Fine-grained PAT 時，限定只給予特定 Repository 的存取權。權限部分僅需勾選 Contents (Read/Write)、Pull Requests (Read/Write) 與 Issues (Read/Write)。千萬不要開啟不必要的權限，以防資安外洩風險。
Q5：Projects 清單裡出現一堆重複的專案，可以直接在 UI 上刪除嗎？
A：有些重複項目是快取打架導致的，在 UI 上有時會點擊無效或刪除後重啟又出現。最一勞永逸且安全的作法，是完全關閉軟體後，手動將 ~/.gemini/config/projects 設定檔資料夾改名或備份移走，重新開起軟體後即可完美重置清單。
Q6：清空 projects 歷史設定，會不小心把我本機的程式碼檔案刪掉嗎？
A：完全不會！.gemini/config/projects 裡面儲存的僅是「專案的路徑紀錄與 UUID 指標」，你的原始碼依然安全地躺在你的硬碟資料夾中。但為了安全防禦，在進行任何系統底層設定修改前，養成隨手備份或 push 到 GitHub 的好習慣是程式設計師的必修課！
Q7：我可以下指令叫 Agent 幫我刪除本機的多餘專案嗎？
A：非常不推薦！雖然 Agent 具備 Terminal 操作能力，但 AI 有時會誤解人類對於「刪除」的定義與範疇。如果語句不夠精確，Agent 有可能在執行 rm -rf 等指令時誤刪你珍貴的原始碼檔案。所有涉及「刪除」與「重置」的操作，請務必由人類工程師親自動手操作！
~/.gemini 系統設定、申請 Fine-grained Token 權限、使用終端機指令等行為）均為開發社群技術交流與實務經驗分享。由於 Antigravity 2.x 仍處於快速迭代階段，後續版本更新可能會再度變更功能路徑或介面設計。在執行任何快取清理、刪除、系統回退或 Git 提交操作前，使用者應自行評估風險，並對其專案原始碼進行完整之本機與雲端備份。作者與平台不對任何因操作不當導致之程式碼遺失、資安外洩或系統故障承擔任何直接或間接之法律責任。