Antigravity 2.0 繁體中文套件
安裝方式選擇:
- v1.0.12:傳統 zip / npm install / 腳本安裝流程。
- v2.0.5:Windows / macOS 安裝器流程,仍需先安裝 Node.js LTS,但不需手動執行 npm install。請參考 v2.0.5 快速安裝說明。
> 可依偏好的安裝方式自行選擇下載。
將 Antigravity 2.0 的介面翻譯為繁體中文(台灣)。本次翻譯字典以 Antigravity 2.0 v2.29.0 介面為基準。支援 Windows 與 macOS,完成 Node.js 與 npm install 後可按兩下腳本安裝與還原。
Antigravity 2.0 Traditional Chinese Localization Toolkit is a source-available 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 quick script-based installation and full restoration after dependencies are installed, 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.
v1.0.12 更新重點
- 翻譯字典基準更新至 Antigravity 2.0 v2.29.0。
- 新增自動化排程與執行紀錄、專案排序、工作樹與連接器、內建瀏覽器、語音模式及無障礙設定等詞彙。
- 改善個人化問候語、確認選項中的「No」,以及跨文字節點的分段文字翻譯。
- 6 個字典檔目前共 1,058 筆翻譯詞彙,較 v1.0.11 增加 75 筆。
- v1.0.12 已於 Windows 與 macOS 完成安裝、還原及 UI 驗證。
簡介
Antigravity 2.0 繁體中文套件是一套公開且免費的介面本地化工具,透過 ASAR 展開與重新打包機制,將 Antigravity 2.0 的英文介面翻譯為繁體中文。
本次翻譯字典以 Antigravity 2.0 v2.29.0 介面為基準,建議安裝本套件最新版。
- 不修改官方核心二進位檔案
- 不散布官方
app.asar或任何官方檔案 - 完成 Node.js 與
npm install後,可按兩下腳本安裝與完整還原 - 所有操作在使用者的電腦執行
使用畫面
主介面
設定頁
下載方式
方式一:GitHub Releases(推薦)
前往本專案的 GitHub Releases 頁面,在 Assets 區下載 antigravity2-zh-hant-v1.0.12.zip。
- 下載
antigravity2-zh-hant-v1.0.12.zip - 解壓縮到任意目錄
- 開啟 Windows 的 命令提示字元(cmd),或 macOS 的 終端機(Terminal)
- 使用
cd切換到剛才解壓縮的套件資料夾 - 再執行:
npm install
Windows 範例:
cd "C:\Users\你的使用者名稱\Downloads\antigravity2-zh-hant-v1.0.12"
npm install
macOS 範例:
cd ~/Downloads/antigravity2-zh-hant-v1.0.12
npm install
補充:Windows 可在資料夾上方路徑列輸入cmd後按 Enter;macOS 可在終端機輸入cd後,把資料夾拖進終端機視窗。
如果資料夾路徑包含空格,請使用雙引號 " 包住完整路徑。
⚠️ 注意:請下載完整的.zip檔案,不要只下載單一的.bat或.command檔案。安裝腳本需要搭配localization_engine.js、dicts/字典目錄與package.json等檔案才能正常運作。
⚠️ 注意:Releases zip 中不包含node_modules/,因此解壓縮後仍需執行npm install安裝依賴套件。
方式二:Git Clone
Windows 請先開啟「命令提示字元(cmd)」或其他可使用 Git 的終端機,macOS 請開啟「終端機(Terminal)」。以下指令需在終端機/命令提示字元中執行:
git clone https://github.com/workkkkkkez00m/antigravity2.0-zh-tw.git
cd antigravity2.0-zh-tw
npm install
功能特色
- 🌐 繁體中文介面:涵蓋主介面、設定頁、Agent 管理、MCP/知識庫頁面等多個區域
- 🖥️ 跨平台支援:同時支援 Windows 與 macOS
- 🔧 快速安裝:完成 Node.js 與
npm install後,按兩下安裝腳本即可執行安裝 - 🔄 完整還原:隨時可還原為官方英文原版
- 🛡️ 安全備份:首次安裝時自動備份官方
app.asar - 📦 離線運作:使用本地
@electron/asar,不依賴npx動態下載 - 🎯 精準翻譯:自動避開程式碼區、終端機(Terminal)、編輯器等不應翻譯的區域
重要提醒:官方軟體更新後須重新安裝
⚠️ 每次 Antigravity 官方釋出更新後,繁體中文介面可能會消失。這是正常現象。
Antigravity 官方更新時,會重新覆蓋 app.asar 檔案,導致先前注入的繁體中文本地化內容被移除。
這是正常情況,並非套件故障。
只要在更新後重新執行安裝腳本,即可恢復繁體中文介面:
- Windows:按兩下
install-win.bat執行 - macOS:按兩下
install-macos.command執行
💡 建議在每次 Antigravity 更新完成後,養成重新執行安裝腳本的習慣。
支援狀態
| 平台 | 安裝 | 還原 | UI 驗證 | 備註 | |------|------|------|---------|------| | macOS | ✅ 已通過 | ✅ 已通過 | ✅ 已通過 | v1.0.12 實機驗證完成 | | Windows | ✅ 已通過 | ✅ 已通過 | ✅ 已通過 | v1.0.12 實機驗證完成 |
翻譯範圍持續補齊中。若在使用過程中發現未翻譯的文字,歡迎回報。
使用前需求
使用本套件前,請確認已安裝以下工具:
| 需求項目 | 說明 | |----------|------| | Antigravity 2.0 | 本套件的翻譯對象,需先安裝 Antigravity | | Node.js LTS | 前往 nodejs.org 下載安裝(安裝時會一併安裝 npm) | | npm | 隨 Node.js 一同安裝,用於安裝本地依賴 |
首次使用前
第一次使用前,請先切換到本套件的資料夾,也就是可以看到 package.json 的那一層目錄。
- Windows:開啟「命令提示字元(cmd)」
- macOS:開啟「終端機(Terminal)」
- 使用
cd切換到解壓縮後的套件資料夾 - 確認目前位於包含以下檔案的資料夾:
package.json
- localization_engine.js
- dicts/
- 再執行:
npm install
此步驟會安裝本地 @electron/asar 套件,用於 ASAR 展開與重新打包。本套件使用本地安裝的 @electron/asar,不依賴 npx 動態下載,確保離線環境也能正常運作。
快速開始
- 開啟終端機:
- 使用
cd切換到解壓縮後的套件資料夾,例如:
# Windows 範例
cd "C:\Users\你的使用者名稱\Downloads\antigravity2-zh-hant-v1.0.12"
macOS 範例
cd ~/Downloads/antigravity2-zh-hant-v1.0.12
- 確認 Node.js 與 npm:
node -v
npm -v
- 第一次使用執行:
npm install
- 完全退出 Antigravity。
- 執行安裝腳本:
install-win.bat
- macOS:按兩下 install-macos.command
- 重新啟動 Antigravity,即可看到繁體中文介面。
Windows 安裝
前置確認
建議開啟 命令提示字元(cmd),確認 Node.js 與 npm 已可使用:
node -v
npm -v
若上述指令能正確輸出版本號,請先使用 cd 切換到解壓縮後的本套件資料夾,再執行:
cd "C:\Users\你的使用者名稱\Downloads\antigravity2-zh-hant-v1.0.12"
npm install
若使用 PowerShell 時被 ExecutionPolicy 擋住,可改用命令提示字元 cmd,或在 PowerShell 中執行:
npm.cmd install
安裝繁體中文
- 完全退出 Antigravity 軟體。
- 在本套件資料夾中,按兩下
install-win.bat執行。 - 執行完成後,重新啟動 Antigravity,即可看到繁體中文介面。
手動指定安裝路徑
若 Antigravity 的安裝位置與預設不同,可使用以下方式手動指定:
node localization_engine.js --install-dir "C:\Users\<你的使用者名稱>\AppData\Local\Programs\antigravity"
Windows 常見問題
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 參數手動指定。
macOS 安裝
前置確認
開啟 終端機(Terminal),確認 Node.js 與 npm 已可使用:
node -v
npm -v
若上述指令能正確輸出版本號,請先使用 cd 切換到解壓縮後的本套件資料夾,再執行:
cd ~/Downloads/antigravity2-zh-hant-v1.0.12
npm install
安裝繁體中文
- 完全退出 Antigravity 軟體(選單列 → Antigravity → Quit,或
Cmd+Q)。 - 在 Finder 中找到本套件資料夾,按兩下
install-macos.command執行。
- 執行完成後,重新啟動 Antigravity,即可看到繁體中文介面。
.command 無法執行
若按兩下 .command 檔案後沒有反應,請先在終端機中授予執行權限:
chmod +x install-macos.command restore-macos.command
手動指定安裝路徑
若 Antigravity 的安裝位置與預設不同,可使用以下方式手動指定:
node localization_engine.js --install-dir "/Applications/Antigravity.app"
macOS EPERM/EACCES 備份說明
首次安裝時,引擎會建立 app.asar.bak 備份檔。在某些 macOS 環境下可能遇到權限問題:
- 引擎會先嘗試
fs.copyFileSync建立備份 - 若遇到 EPERM 或 EACCES 錯誤,會自動改用
/bin/cp -p作為備援方式 - 本套件不會自動執行
sudo
cp "/Applications/Antigravity.app/Contents/Resources/app.asar" \
"/Applications/Antigravity.app/Contents/Resources/app.asar.bak"
還原官方原版
Windows
按兩下 restore-win.bat 執行,或在命令列執行:
node localization_engine.js --restore
macOS
按兩下 restore-macos.command 執行,或在終端機執行:
node localization_engine.js --restore
通用方式
任何平台均可使用以下指令還原:
node localization_engine.js --restore
還原時,引擎會使用首次安裝時建立的 app.asar.bak 回復官方原版。還原完成後,備份檔會被移除。
翻譯範圍
已翻譯區域
| 區域 | 說明 | |------|------| | 主介面文字 | 側邊欄、頂部導覽、一般按鈕與標籤 | | 設定頁 | 完整設定面板、權限控制、子選單 | | Agent / Workspace | Agent 管理頁面、工作區頁面 | | MCP / Knowledge | MCP 伺服器與知識庫管理頁面 | | 系統選單 | 標題列選單(檔案、編輯、檢視、視窗、說明) | | 工作列 / 選單文字 | 工作列右鍵選單、Agent 狀態顯示 | | 啟動畫面文字 | 載入動畫文字 | | 鍵盤快捷鍵頁 | 快捷鍵描述與分類 |
目前 6 個字典檔共 1,058 筆翻譯詞彙(依各字典檔 key 數合計)。
不翻譯區域
以下區域會自動避開翻譯,以確保使用體驗不受影響:
- 程式碼區(Monaco Editor)
- 終端機(Terminal)
- 輸入框(
、、contenteditable) 、區塊- 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。請確認已先切換到本套件的資料夾,也就是可以看到 package.json 的那一層目錄,並執行 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 身分執行腳本。
授權
自 v2.0.0 / v1.0.7 版本起,本專案採用 Apache License 2.0 with Commons Clause 授權,屬於 source-available/原始碼公開授權,並非 OSI 定義的 open source 授權。
你可以一般使用、研究、修改與分享本專案原始碼;但不得販售本軟體本身,或將本軟體主要功能包裝成付費商品或服務。
更早的既有發布版本仍依其發布時的 Apache License 2.0 授權,不因 v2.0.0 / v1.0.7 版本起的授權變更而追溯改變。
免責聲明
- 本專案為非官方社群工具,與 Antigravity 官方無關。
- 本專案不包含、不散布 Antigravity 官方
app.asar或任何官方二進位檔案。 - 使用者應自行承擔修改本機應用程式資源的風險。
- 所有注入操作均在使用者的電腦執行,並提供完整還原機制。
- 本專案自 v2.0.0 / v1.0.7 版本起依據 Apache License 2.0 with Commons Clause 以「現狀」(AS IS)提供,不附帶任何明示或暗示的保證;更早的既有發布版本仍依其發布時的 Apache License 2.0 授權。