將 Antigravity 2.0 的介面翻譯為繁體中文。支援 Windows 與 macOS，提供一鍵安裝與完整還原。
Antigravity 2.0 Traditional Chinese Localization Toolkit is an open-source project that translates the Antigravity 2.0 interface into Traditional Chinese. It works by unpacking and repacking the local Electron ASAR file, without modifying official core binaries or redistributing any official Antigravity files. The toolkit supports both Windows and macOS, provides one-click installation and full restoration, automatically creates backups, runs entirely on the user’s local machine, and carefully avoids translating code editors, terminals, input fields, debug consoles, and other areas where localization could interfere with development workflows.
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）提供，不附帶任何明示或暗示的保證。