面向 macOS 的 Antigravity 2.0 中文本地化补丁工具。

这个项目通过脚本和翻译表辅助汉化：

• /Applications/Antigravity.app
• /Applications/Antigravity IDE.app

本项目不是 Google 或 Antigravity 官方项目。它只发布补丁脚本和翻译表，不发布修改后的应用程序。

• 探测本机 Antigravity / Antigravity IDE 安装路径和关键资源。
• 为 Antigravity.app 生成中文 app.asar 补丁。
• 为主应用 Settings 页面注入 DOM 文案翻译。
• 为 Antigravity IDE.app 配置 VS Code 中文语言包机制。
• 为 Antigravity IDE Settings 窗口和首选项菜单补充中文补丁。
• 自动备份原始资源，支持恢复。
• 提供一键安装脚本，安装前会退出相关进程。

当前验证环境：

• macOS
• Antigravity 2.0.6
• Antigravity IDE 2.0.3
• Node.js >=20

其他版本可能可以使用，但更新后资源结构可能变化。建议每次 Antigravity 更新后先运行探测和验证。

git clone https://github.com/Layrow/antigravity-zh-patcher.git
cd antigravity-zh-patcher
npm install
npm run validate

查看安装状态：

npm run preflight

安装主应用汉化：

npm run app:install

安装 IDE 汉化：

npm run ide:zh
npm run ide:install-settings

脚本写入 /Applications 时可能要求输入 macOS 管理员密码。

也可以使用项目自带入口脚本，之后在任何目录都能通过绝对路径或软链执行：

./antigravity-zh.sh install
./antigravity-zh.sh app
./antigravity-zh.sh ide
./antigravity-zh.sh restore

如需做成全局命令：

chmod +x /Users/fyh/game/antigravity-zh-patcher/antigravity-zh.sh
sudo ln -sf /Users/fyh/game/antigravity-zh-patcher/antigravity-zh.sh /usr/local/bin/antigravity-zh

之后可以在任意目录运行：

antigravity-zh install

入口脚本命令：

如果在使用过程中，您发现了漏译的英文，或者觉得某些中文翻译不够准确，您可以直接在聊天窗口中命令您的 AI 编码助手（即 Antigravity）来帮您更新词库！无论是直接发截图还是描述文字，AI 都会自动帮您把对照词条写进 JSON 字典中。

如果您不方便打字，可以直接将未汉化干净的界面截图粘贴发送给 AI，并附带以下指令：

“帮我把这张截图里所有未汉化的英文选项和面板内容补全到 translations 目录下的中文词典中。”

如果您只想修改或增加某一个特定词汇，可以直接发送文字描述：

“帮我把漏译的英文 'Allow agent to view and edit files outside of the current workspace' 汉化为 '允许智能体自动查看并编辑当前工作区之外的文件'，并更新到对应的 JSON 字典里。”

1. 命令 AI 更新：让 AI 自动更新 translations/ 下的字典文件。
2. 退出软件：完全退出您的 Antigravity 和 Antigravity IDE。
3. 重新部署：在终端中运行 ./antigravity-zh.sh install（或分别运行 npm run app:install 等命令）重新生成并部署汉化补丁。
4. 重启软件：重新打开 Antigravity，您的改动即可完美生效！

主应用处理两类内容：

• Electron 壳层文案，例如菜单、托盘、加载提示和部分错误提示。
• Settings 页面 DOM 文案，例如权限、模型、浏览器、外观、应用等设置项。

脚本会生成：

dist/antigravity-app.zh-CN.asar

如果系统拦截自动安装，可以在完全退出 Antigravity 后手动安装：

sudo cp "dist/antigravity-app.zh-CN.asar" "/Applications/Antigravity.app/Contents/Resources/app.asar"

IDE 处理三层内容：

• 安装并启用 MS-CEINTL.vscode-language-pack-zh-hans。
• 生成 ~/.antigravity-ide/languagepacks.json 和 NLS 缓存。
• 对 Antigravity 自定义 Settings 窗口注入 DOM 翻译。
• 同步更新 product.json 中被修改文件的 checksum，避免 IDE 完整性检查误报安装损坏。

如果 Settings 补丁无法直接写入 /Applications，脚本会生成：

dist/ide-settings/

之后运行：

npm run ide:install-settings

如果已经手动复制过 jetskiAgent/main.js，但启动时看到 Your Antigravity IDE installation appears to be corrupt. Please reinstall.，通常是 product.json 的 checksum 还没有同步。重新运行：

npm run ide:patch-settings
sudo cp "dist/ide-settings/product.json" "/Applications/Antigravity IDE.app/Contents/Resources/app/product.json"

Antigravity 官方更新很可能覆盖应用内资源。推荐流程：

1. 更新 Antigravity。
2. 打开官方新版，确认未打补丁时能正常启动。
3. 完全退出 Antigravity 和 Antigravity IDE。
4. 在项目目录运行：

npm run app:install
npm run ide:zh
npm run ide:install-settings

5. 重新打开应用，重点检查 Settings 页面和首选项菜单。

脚本会把原始资源备份到：

backups/

自动恢复：

npm run restore

如果恢复脚本被 macOS 权限拦截，可以从 backups/ 中选择对应备份文件手动复制回原路径。

• 修改 .app 内部资源会破坏原始代码签名。
• IDE 会根据 product.json 中的 checksum 检查部分资源；手动安装 IDE Settings 补丁时必须同时安装生成的 product.json。
• 不要在应用运行时覆盖 app.asar 或 IDE bundle，否则可能出现白屏或资源状态不一致。
• 官方更新后旧补丁可能失效，需要重新生成。
• DOM 文案替换方式比硬改二进制更容易恢复，但可能漏掉动态文案。
• language_server 是二进制文件，本项目当前不直接修改它。

.
├── scripts/          # 探测、补丁、安装、恢复和校验脚本
├── translations/     # 中文翻译表
├── docs/             # 维护文档
├── backups/          # 本地备份，已忽略
├── dist/             # 生成补丁，已忽略
└── README.md

欢迎提交翻译补充、版本适配和恢复流程改进。请先阅读 CONTRIBUTING.md。

如果发现安全风险或可能导致数据损坏的问题，请阅读 SECURITY.md。

本项目使用 MIT License。