👉 繁體中文版說明文件 (Traditional Chinese README)

支持系统：Windows & macOS (均已内置一键脚本)
匹配版本：Antigravity v2.0.11
核心引擎：Node.js (无需安装 Python，零依赖，极速极稳)
汉化范围：包括软件界面、顶部系统菜单、任务栏右键菜单、加载动画、设置面板、新手引导及登录页。
注入原理：通过 ASAR 还原与重包，安全注入 preload.js 动态翻译机制，绝不修改核心二进制，一键安装与完美还原。

以下是部分功能板块的实际汉化效果展示，涵盖登录引导页、主编辑器界面与详细设置面板：

• 双击安装中文汉化.bat / .command：Windows / macOS 一键汉化执行入口。
• 双击卸载还原官方英文.bat / .command：Windows / macOS 一键完美恢复原版入口。
• localization_engine.js：核心汉化逻辑，负责 app.asar 的解包、代码注入、重新打包以及 macOS 下的自动深度重签名。
• dicts/：汉化字典文件夹，内含按模块分类的 JSON 对照翻译字典。

• 方法 A：直接下载 ZIP 压缩包（最便捷 📦）

  1. 点击页面右上角绿色的 Code 按钮。
  2. 在下拉菜单中选择 Download ZIP 并下载。
  3. 将下载好的压缩包解压到您电脑本地的任意目录（例如您的 Downloads 文件夹）。

• 方法 B：通过 Git 命令行克隆（开发者推荐 💻） 如果您本地安装了 Git，可以直接在终端运行克隆命令：

  # 如果您在国内，推荐使用下方代理加速克隆地址：
  git clone https://mirror.ghproxy.com/https://github.com/qqxpee/antigravity2-cn.git
  
  # 如果您配置了全局代理，可直接使用官方地址：
  git clone https://github.com/qqxpee/antigravity2-cn.git

1. 完全退出 Antigravity 编程软件。
2. 进入您解压或克隆出来的 antigravity2-cn 文件夹：
   • Windows：双击运行 双击安装中文汉化.bat。
   • macOS：双击运行 双击安装中文汉化.command。
3. 按提示选择左上角品牌显示方式：
   • 显示英文 Antigravity（默认推荐）：保留官方品牌名，避免左上角显示过长。
   • 不显示品牌名：隐藏左上角的品牌文字。
   • 显示中文品牌名：保持原汉化效果，显示“反重力智能编程”。
4. 运行完成后，重新启动 Antigravity 软件，即可畅享全中文界面！

如果您通过命令行运行 localization_engine.js，可使用 --brand-title 控制左上角品牌名：

# 默认推荐：左上角显示 Antigravity
node localization_engine.js --brand-title english

# 隐藏左上角品牌名
node localization_engine.js --brand-title hidden

# 显示中文品牌名
node localization_engine.js --brand-title translated

1. 完全退出 Antigravity 编程软件。
2. 在当前文件夹下：
   • Windows：双击运行 双击卸载还原官方英文.bat。
   • macOS：双击运行 双击卸载还原官方英文.command。
3. 运行完成后，软件将自动清除所有汉化注入，无痕恢复至官方原版英文状态。

本引擎采用 ASAR 包注入模式，专为 Antigravity 2.0+ 的 Electron 架构量身定制：

1. 自动释放锁：脚本运行前会自动探测并安全关闭 Antigravity 进程，防止文件占用锁定。
2. 安全备份：首次运行时，会在软件目录自动创建原始 app.asar.bak 文件，确保随时可无损还原。
3. 精准注入：
   • 注入 preload.js：采用 WeakSet 记录与 Shadow DOM 穿透，启动高效的 MutationObserver 引擎，动态监测并将渲染层文本翻译为中文。
   • 注入 menu.js：深度补丁系统级标题栏菜单。
   • 注入 tray.js：汉化托盘与右键通知状态菜单。
   • 注入 loadingOverlay.js：注入极具极客风格的趣味加载语：“反重力引擎已启动，正在摆脱地心引力...”。

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

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

“帮我把这张截图里所有未汉化的英文选项和面板内容补全到中文词典中。” (AI 会自动通过视觉识别截图中的全部英文，并精准写入字典。)

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

“帮我把漏译的英文 'Allow agent to view and edit files outside of the current workspace automatically' 汉化为 '允许智能体自动查看并编辑当前工作区之外的文件'。” (AI 会立即找到对应的词典并精准修改或追加该词条。)

1. 命令 AI 更新：在对话中通过截图或文字告诉 AI 您的汉化需求，AI 会自动更新 dicts/ 下的字典文件。
2. 退出软件：完全退出您的 Antigravity 软件。
3. 重新注入：在当前文件夹中再次双击运行 双击安装中文汉化.bat / .command 重新部署汉化。
4. 重启软件：重新打开 Antigravity，您的改动即可完美生效！

如果您想手动修改翻译，可以直接打开 dicts/ 目录下的 JSON 文件：

• common.json：公共基础词汇、侧边栏概览、登录页、常用按钮等。
• page_settings.json：包含极其丰富的详细设置面板、权限二级菜单对照。
• menu_nav.json：系统及菜单栏翻译。

在 JSON 中新增一行，格式如下即可（注意英文逗号）：

"Original English Text": "您的中文翻译"

保存后，双击运行 双击安装中文汉化.bat / .command 重新部署汉化即可。

• 原因：汉化引擎依赖 Node.js 进行 ASAR 包的解析。
• 解决：由于 Antigravity 本身就是一个基于 Node.js/Electron 的程序，您的电脑一般都已自带环境。如果极少数情况下报错，只需在电脑安装 Node.js（LTS 版本即可）并重启脚本。

• 解决：
  • Windows：请右键点击 双击安装中文汉化.bat，选择 “以管理员身份运行”。
  • macOS：若双击运行 .command 提示无法打开或没有执行权限，可在终端中执行 chmod +x *.command 来授权。如果是系统安全拦截，请在“系统设置 -> 隐私与安全性”中点击“仍要打开”。本汉化包已内置自动重签名机制，修改后会重新进行 Ad-hoc 签名以防止 macOS 提示应用损坏。

• 软件升级时，官方会覆盖 app.asar 文件。您无需担心，直接完全退出软件，重新双击运行 双击安装中文汉化.bat 重新注入一次即可完美恢复中文。

感谢所有参与测试与反馈的贡献者！