將 Antigravity 2.0 的介面翻譯為繁體中文。支援 Windows 與 macOS，提供一鍵安裝與完整還原。
Antigravity 2.0 繁體中文套件是一套開源的介面本地化工具，透過 ASAR 解包與重新打包機制，將 Antigravity 2.0 的英文介面翻譯為繁體中文。
- 不修改官方核心二進位檔案
- 不散布官方
app.asar或任何官方檔案 - 支援一鍵安裝與完整還原
- 所有操作在使用者本機端執行
前往本專案的 GitHub Releases 頁面，下載最新版本的 .zip 壓縮檔。
- 下載
antigravity2-zh-hant-v*.zip - 解壓縮到任意目錄
- 在解壓縮後的目錄中執行：
npm install
⚠️ 注意：請下載完整的.zip檔案，不要只下載單一的.bat或.command檔案。安裝腳本需要搭配localization_engine.js、dicts/字典目錄與package.json等檔案才能正常運作。
⚠️ 注意：Releases zip 中不包含node_modules/，因此解壓縮後仍需執行npm install安裝依賴套件。
git clone https://github.com/<owner>/antigravity2.0-zh-tw.git
cd antigravity2-zh-hant-tw
npm install請將
<owner>替換為實際的 GitHub 帳號名稱。
- 🌐 繁體中文介面：涵蓋主介面、設定頁、Agent 管理、MCP／知識庫頁面等多個區域
- 🖥️ 跨平台支援：同時支援 Windows 與 macOS
- 🔧 一鍵安裝：雙擊腳本即可完成安裝，無需手動操作
- 🔄 完整還原：隨時可還原為官方英文原版
- 🛡️ 安全備份：首次安裝時自動備份官方
app.asar - 📦 離線運作：使用本地
@electron/asar，不依賴npx動態下載 - 🎯 精準翻譯：自動避開程式碼區、Terminal、編輯器等不應翻譯的區域
⚠️ 每次 Antigravity 官方釋出更新後，繁體中文介面可能會消失。這是正常現象。
Antigravity 官方更新時，會重新覆蓋 app.asar 檔案，導致先前注入的繁體中文本地化內容被移除。
這是正常情況，並非套件故障。
只要在更新後重新執行安裝腳本，即可恢復繁體中文介面：
- Windows：雙擊執行
install-win.bat - macOS：雙擊執行
install-macos.command
💡 建議在每次 Antigravity 更新完成後，養成重新執行安裝腳本的習慣。
| 平台 | 安裝 | 還原 | UI 驗證 | 備註 |
|---|---|---|---|---|
| macOS | ✅ 已通過 | ✅ 已通過 | ✅ 已通過 | 實機驗證完成 |
| Windows | ✅ 已通過 | ✅ 已通過 | ✅ 已通過 | 實機驗證完成 |
翻譯範圍持續補齊中。若在使用過程中發現未翻譯的文字，歡迎回報。
使用本套件前，請確認已安裝以下工具：
| 需求項目 | 說明 |
|---|---|
| Antigravity 2.0 | 本套件的翻譯對象，需先安裝 Antigravity |
| Node.js LTS | 前往 nodejs.org 下載安裝（安裝時會一併安裝 npm） |
| npm | 隨 Node.js 一同安裝，用於安裝本地依賴 |
在專案根目錄執行一次：
npm install此步驟會安裝本地 @electron/asar 套件，用於 ASAR 解包與重新打包。本套件使用本地安裝的 @electron/asar，不依賴 npx 動態下載，確保離線環境也能正常運作。
# 1. 確認已安裝 Node.js 與 npm
node -v
npm -v
# 2. 安裝依賴（僅首次需要）
npm install
# 3. 完全退出 Antigravity，然後執行安裝腳本
# Windows：雙擊 install-win.bat
# macOS：雙擊 install-macos.command
# 4. 重新啟動 Antigravity，即可看到繁體中文介面開啟命令提示字元或 PowerShell，確認 Node.js 與 npm 已可使用：
node -v
npm -v若上述指令能正確輸出版本號，接著在專案目錄執行：
npm install- 完全退出 Antigravity 軟體。
- 在本套件資料夾中，雙擊執行
install-win.bat。 - 執行完成後，重新啟動 Antigravity，即可看到繁體中文介面。
若 Antigravity 的安裝位置與預設不同，可使用以下方式手動指定：
node localization_engine.js --install-dir "C:\Users\<你的使用者名稱>\AppData\Local\Programs\antigravity"node.exe 存取被拒（Access Denied）
若執行 node -v 時出現「存取被拒」，通常代表系統 PATH 上的 node.exe 指向異常位置（例如 Windows App 安裝目錄）。解決方式：
- 移除現有 Node.js 安裝
- 從 nodejs.org 重新下載 LTS 版本安裝
- 安裝完成後重新開啟終端機，確認
node -v正常輸出版本號
npm 不存在
npm 隨 Node.js 一併安裝。若 npm -v 無法使用，請重新安裝 Node.js LTS 版本。安裝時確認勾選 npm 相關選項。
Antigravity 安裝路徑不同
引擎預設搜尋 %LOCALAPPDATA%\Programs\antigravity。若你的 Antigravity 安裝在其他位置，請使用 --install-dir 參數手動指定。
開啟 Terminal，確認 Node.js 與 npm 已可使用：
node -v
npm -v若上述指令能正確輸出版本號，接著在專案目錄執行：
npm install- 完全退出 Antigravity 軟體（選單列 → Antigravity → Quit，或
Cmd+Q）。 - 在 Finder 中找到本套件資料夾，雙擊執行
install-macos.command。- 若系統提示「無法驗證開發者」，請在 Finder 中對檔案按右鍵 → 開啟。
- 執行完成後，重新啟動 Antigravity，即可看到繁體中文介面。
若 .command 檔案雙擊無反應，請先在 Terminal 中授予執行權限：
chmod +x install-macos.command restore-macos.command若 Antigravity 的安裝位置與預設不同，可使用以下方式手動指定：
node localization_engine.js --install-dir "/Applications/Antigravity.app"首次安裝時，引擎會建立 app.asar.bak 備份檔。在某些 macOS 環境下可能遇到權限問題：
- 引擎會先嘗試
fs.copyFileSync建立備份 - 若遇到 EPERM 或 EACCES 錯誤，會自動 fallback 到
/bin/cp -p作為備援 - 本套件不會自動執行
sudo
若 fallback 仍失敗，可手動建立備份後再執行安裝：
cp "/Applications/Antigravity.app/Contents/Resources/app.asar" \
"/Applications/Antigravity.app/Contents/Resources/app.asar.bak"雙擊執行 restore-win.bat，或在命令列執行：
node localization_engine.js --restore雙擊執行 restore-macos.command，或在 Terminal 執行：
node localization_engine.js --restore任何平台均可使用以下指令還原：
node localization_engine.js --restore還原時，引擎會使用首次安裝時建立的
app.asar.bak回復官方原版。還原完成後，備份檔會被移除。
| 區域 | 說明 |
|---|---|
| 主介面文字 | 側邊欄、頂部導覽、一般按鈕與標籤 |
| 設定頁 | 完整設定面板、權限控制、子選單 |
| Agent / Workspace | Agent 管理頁面、工作區頁面 |
| MCP / Knowledge | MCP 伺服器與知識庫管理頁面 |
| 系統選單 | 標題列選單（檔案、編輯、檢視、視窗、說明） |
| 工作列 / 選單文字 | 工作列右鍵選單、Agent 狀態顯示 |
| 啟動畫面文字 | 載入動畫文字 |
| 鍵盤快捷鍵頁 | 快捷鍵描述與分類 |
目前共 617 個翻譯詞彙。
以下區域會自動避開翻譯，以確保使用體驗不受影響：
- 程式碼區（Monaco Editor）
- Terminal / 終端機
- 輸入框（
<input>、<textarea>、contenteditable） <code>、<pre>區塊- SVG / Canvas 圖形元素
- Debug Console
- Suggest Widget（自動完成選單）
為什麼需要 npm install？
本套件使用 @electron/asar 進行 ASAR 解包與重新打包。npm install 會將此工具安裝到本地 node_modules/ 目錄，使安裝腳本能夠正常運作。只需在首次使用時執行一次。
沒有 Node.js 可以用嗎？
目前不行。本地化引擎以 Node.js 撰寫，需要 Node.js 執行 ASAR 解包、注入與重新打包。請前往 nodejs.org 安裝 LTS 版本。
npx is not recognized 怎麼辦？
本套件已改用本地 @electron/asar，不再依賴 npx。請確認已在專案根目錄執行 npm install，即可正常運作。
node.exe 存取被拒怎麼辦？
此問題通常出現在 Windows，代表系統 PATH 上的 node.exe 指向異常位置。請移除現有 Node.js，從 nodejs.org 重新下載 LTS 版本安裝，然後重新開啟終端機確認。
Antigravity 更新後翻譯不見了怎麼辦？
Antigravity 官方更新時，會重新覆蓋 app.asar 檔案，導致先前注入的繁體中文本地化內容被移除。這是正常現象，並非套件故障。
解決方式：
- 完全退出 Antigravity
- 重新執行安裝腳本（Windows：
install-win.bat；macOS：install-macos.command） - 重新啟動 Antigravity，即可恢復繁體中文介面
如何還原官方原版？
Windows 執行 restore-win.bat、macOS 執行 restore-macos.command，或使用 node localization_engine.js --restore。還原時會使用 app.asar.bak 回復官方原版。
是否會修改官方 app.asar？
是的，安裝過程會解包 app.asar、注入翻譯程式碼後重新打包。但首次安裝時會自動建立 app.asar.bak 備份，可隨時還原為官方原版。
是否會散布官方 app.asar？
不會。本專案不包含、不散布 Antigravity 官方 app.asar 或任何官方二進位檔案。所有操作均在使用者本機端執行。
為什麼 PROJECT_ID / SIGNATURE 還是 zh-hant-tw？
PROJECT_ID（antigravity2-zh-hant-tw）與 SIGNATURE（ZH-HANT-TW）作為內部技術識別碼，用於套件名稱與注入區塊的清理邏輯。若變更這些識別碼，會導致舊版注入區塊無法被正確清理。因此保留原有識別碼以維持向下相容。
- 請先退出 Antigravity 再操作：執行安裝或還原腳本前，請確認已完全退出 Antigravity，避免檔案被占用。
- Antigravity 更新後需重新套用：官方更新會覆蓋
app.asar，更新後請重新執行安裝腳本。 - macOS Gatekeeper：首次執行
.command檔案時，若系統提示「無法驗證開發者」，請在 Finder 中對檔案按右鍵 → 開啟。 - Windows 權限：若出現「存取被拒」，請對
.bat檔案按右鍵 → 以系統管理員身份執行。 - 不要以 sudo 執行：本套件不會自動使用
sudo，也不建議以 root 身份執行腳本。
本專案採用 Apache License 2.0 授權。
- 本專案為非官方社群工具，與 Antigravity 官方無關。
- 本專案不包含、不散布 Antigravity 官方
app.asar或任何官方二進位檔案。 - 使用者應自行承擔修改本機應用程式資源的風險。
- 所有注入操作均在使用者本機端執行，並提供完整還原機制。
- 本專案依據 Apache License 2.0 以「現狀」（AS IS）提供，不附帶任何明示或暗示的保證。