README

Antigravity 汉化工具 (Antigravity-Hans)

专为 Google Antigravity 及 Antigravity IDE 开发的中文汉化工具。

 适配版本：Antigravity 2.31.0 与 Antigravity IDE 2.6.0。
 普通版的 Swarm 面板，以及 IDE 的智能体和独立设置页面，需要动态监视器；本次适配的验证范围和限制见更新记录。

---

 效果预览




---

 快速使用

前往 Releases 下载对应平台的单文件即可运行；

未测试的最新构建可从 GitHub Actions Artifacts 下载。

- Windows：双击 antigravity-hans-windows-amd64.exe，在交互菜单中选择对应模式。
- macOS：
  bash
  chmod +x antigravity-hans-macos-
  ./antigravity-hans-macos-arm64   Apple Silicon
  ./antigravity-hans-macos-amd64   Intel
  

text
Antigravity-Hans 启动器
----------------------------------------
1. 启动 Antigravity (动态汉化)
2. 启动 Antigravity IDE (动态汉化)
3. 静态补丁管理 (仅支持 IDE)
4. 生成桌面快捷启动方式
0. 退出
----------------------------------------


 提示：首次使用 IDE 时，工具会自动检测并提示安装官方中文语言包 (Chinese (Simplified) Language Pack)，确保菜单栏与底层编辑器完整汉化。

---

 命令行参数

bash
 直接启动汉化
antigravity-hans --app          动态汉化 Antigravity
antigravity-hans --ide          动态汉化 Antigravity IDE
antigravity-hans --patch        静态补丁管理 (仅支持 IDE)
antigravity-hans --app --attach-only   仅连接已有调试端口，不启动或重启应用
antigravity-hans --ide --attach-only   仅连接 IDE 已有调试端口

 生成一键汉化快捷方式
antigravity-hans --shortcut         为两者生成快捷方式
antigravity-hans --shortcut --app   仅 Antigravity
antigravity-hans --shortcut --ide   仅 Antigravity IDE

 维护
antigravity-hans --stop                     结束由本工具启动的汉化监视器
antigravity-hans --trust-external-overlay   显式信任同目录外部汉化脚本（类型与大小限制仍生效）
antigravity-hans --app --trust-custom-translations   显式信任同目录自定义翻译名单


---

 汉化模式

1. 动态汉化（推荐）：
   - 支持 Antigravity 及 Antigravity IDE。
   - 通过 CDP 动态翻译界面，保留应用安装资源；注入状态随应用页面关闭而消失。
   - 普通版 Swarm 面板和 IDE 2.6.0 的智能体及独立设置页面需要动态监视器；静态补丁不会覆盖这些内嵌页面。
   - 可通过 --shortcut 参数一键生成桌面快捷方式，日常双击即可自动启动汉化。
2. 静态补丁（仅支持 Antigravity IDE）：
   - 直接修改本地 IDE 安装包资源并修复校验和，一劳永逸，支持随时一键还原。

 中英切换按钮

汉化生效后，窗口右下角会出现一个半透明的小圆按钮，可随时在中文与英文之间无缝切换（无需刷新或重启）：

- 按钮显示 EN：单击切换为英文；显示 中：单击切回中文。
- 双击或右键按钮：打开选项菜单，可选择语言，以及勾选「选项名保留英文」。
- 调整位置：按住按钮拖动到任意位置后松开即可，位置会自动记住（窗口尺寸变化时会自动保持在可见区域内）。
- 语言、位置与选项会被记住；多个窗口之间会自动同步。
- 也支持键盘操作（聚焦按钮后按回车或空格切换语言）。

 选项名保留英文（内置预设，默认关闭）

部分用户觉得「Claude Opus 5.5 高」这类中英拼接读起来别扭。勾选后，中文状态下以下选项名保留英文，说明文字仍为中文：

| 位置 | 默认（全中文） | 勾选后 |
| --- | --- | --- |
| 对话权限菜单 | 当前对话 / 请求审核 / 默认 / 自动 / 极速 | This Conversation / Request Review / Default / Auto / Turbo |
| 模型推理强度 | 高 / 中 / 低 | High / Medium / Low |

预设内容内置在程序中，随版本更新自动同步，无需额外文件。

 自定义翻译名单

除了内置预设，进阶用户还可以按需微调个别译法：在程序同目录放一个 custom-translations.txt（参考 custom-translations.example.txt），一行一条（个人名单优先于内置预设）：

text
 只写英文：保留英文，不翻译
Request Review
 英文 = 译文：使用自己的译法
Turbo = 快速模式


-  只在行首时表示注释（不支持行尾注释）。
- 界面文字与原文整段一致（不区分大小写）时生效，名单外的内容照常汉化；默认没有名单，即全部汉化。
- 名单可以改变权限等界面文字，请只使用可信的名单。macOS 默认检查名单和所在目录的所有者及写权限；Windows 无法通过该检查验证 ACL，需显式传入 --trust-custom-translations 才会加载。文件类型和大小限制始终生效。
- Windows 用户如需通过中文快捷方式加载可信名单，可运行 antigravity-hans --shortcut --trust-custom-translations 重新生成快捷方式；这个选项会保留在新快捷方式中。直接启动或安装静态补丁时，也需分别附带该选项。
- 修改或删除名单后，动态模式先运行 antigravity-hans --stop 结束旧监视器，再启动汉化，无需重启应用；静态模式则需先关闭 IDE，重新运行工具并选择“注入静态汉化”，以更新已安装的脚本。
- 名单仅作为数据注入（JSON 编码），译文只写入文本，不会被当作脚本或 HTML 执行；删除文件并按上述步骤更新后恢复默认汉化。

-

Latest release

Antigravity-Hans v0.4.10

 下载

| 平台 | 文件 |
|------|------|
| Windows x64 | antigravity-hans-windows-amd64.exe |
| macOS Apple Silicon | antigravity-hans-macos-arm64 |
| macOS Intel | antigravity-hans-macos-amd64 |

 macOS 使用说明

bash
chmod +x antigravity-hans-macos-arm64
./antigravity-hans-macos-arm64


 若提示"无法验证开发者"，请前往「系统设置 → 隐私与安全性」点击「仍要打开」。