Google Antigravity(Agentic IDE)Windows / macOS 一键汉化工具 19956 翻译单元 · 双击即用 · 全程本地执行(首次取打包工具会联网一次,之后离线)· 永久免费
Antigravity 是 Google 出品的智能体编程 IDE,界面默认英文。 本工具把它完整变成简体中文——不需要懂命令行,不需要会编程:
- 双击
一键汉化.bat(Windows)/一键汉化.command(macOS),按数字选功能 - 官方更新后界面变回英文?再双击一次,重新汉化就好
- 想换回英文原版?一键还原,还原结果与官方原版字节级一致
| 你的系统 | 用哪个 | 启动方式 |
|---|---|---|
| Windows | 仓库根目录的 一键汉化.bat |
双击即用 |
| macOS | mac/ 目录 |
右键 一键汉化.command → 选择「打开」 |
两个平台共用同一套引擎与词典(词条量、覆盖范围、备份策略完全一致),
localize.py 会自动识别当前系统走对应分支。
macOS 用户请看 mac/README.md,里面讲清了代码签名这件事, 以及遇到「应用已损坏」怎么办。
| 优势 | 说明 |
|---|---|
| 词条量天花板 | 19956 翻译单元(主词典 19605 + 前缀规则 86 + 核心词 117 + 动态正则 74 + 菜单映射 74),规模远超目前市面上的同类汉化方案 |
| 覆盖最全面 | 不只翻网页界面——原生菜单栏、系统托盘、系统弹窗、安装向导、权限确认弹窗、输入框提示、IDE 面板词条,全都翻 |
| 双平台 | Windows 与 macOS 同一套脚本自动适配;macOS 版自动完成代码签名重签(Apple 官方推荐的分层方式) |
| 真·一键 | 双击 → 数字菜单 → 完成。杀进程、备份、注入、校验、部署全自动,不需要敲任何命令 |
| 官方更新不怕 | 独创"备份防降级"设计:官方更新后重汉化,备份自动升级为新版官方原版——还原永远不会把你退回旧版本 |
| 安全干净 | 汉化全程本地操作,零数据上传、零遥测;不碰注册表/启动项/你的项目代码。联网只有两处且都透明:① 首次运行若走 npx 会从 npm 源取一次官方 asar 工具(约 3 MB,之后走本地缓存;npm 不可用时自动改用内置打包器,全程不联网)② 你主动点菜单 5 检查更新。写入前语法门禁、部署后二次复检,任何一步不对就中止回滚 |
| 原子替换 | 部署用"临时文件 + 原子替换",中途断电、强杀进程都不会留下半成品损坏安装 |
| 不误伤 | 身份守卫:装错目标(--path 指向其他软件)直接拒绝执行;杀进程按路径过滤,其他软件的同名进程不受影响 |
| AI 回复也中文 | 界面汉化管不到 AI 生成的内容,本工具内置"AI 中文回复"规则开关(菜单 4),一键让 AI 用中文回答 |
| 可自己改词典 | 词典是明文 JSON 文件,想补充或修改词条,编辑 zh_data.json 后重跑即可 |
Windows:
- Windows + 已安装 Antigravity(默认安装路径自动识别,装在别处可用
--path指定) - Python 3.8+(安装时勾选 Add Python to PATH)
- Node.js 18+(
node用于改完 JS 后的语法门禁,是硬要求;npx只用于官方 asar 工具——npm 缓存写不进去时会自动改用内置打包器,不影响汉化)
macOS(详见 mac/README.md):
- macOS 12+ + 已安装 Antigravity
- Python 3.8+(
brew install python) - Node.js 18+(
brew install node) - Xcode 命令行工具(
xcode-select --install)——提供codesign/xattr, 没有它汉化后 App 会打不开,主程序会在汉化前明确报错
Windows 双击 一键汉化.bat,macOS 右键 一键汉化.command →「打开」:
| 选项 | 功能 |
|---|---|
1 一键汉化 |
自动关进程 → 备份原版 → 注入汉化 → 校验 → 部署(macOS 追加自动重签名) |
2 恢复官方英文原版 |
用备份一键还原,字节级与官方一致 |
3 查看状态 |
当前是否已汉化、备份是否完好(macOS 追加签名健康度) |
4 AI 回复中文化 |
写入一条全局规则,让 AI 自己用中文回答(思考过程仍英文,可随时关闭) |
5 检查更新 |
查 GitHub 上有没有新版本;可选下载到桌面,不会自动替换你现有的文件 |
也可以命令行调用:python localize.py apply / restore / status / chinese-output / update(macOS 用 python3)
- 默认不联网:只有你主动选
5(或运行update)时才会发一次请求, 其余所有功能(汉化、还原、查看状态、AI 中文化)全程零网络行为。 - 只查不换:请求的是 GitHub Release 元数据(版本号、更新说明、下载链接), 不下载执行任何远端代码。就算你选了下载,也只是把 zip 存到桌面, 解压和替换由你自己决定,本工具绝不动你现有的文件。
- 下不动有退路:可以选「只要下载链接」,自己用浏览器或下载工具下。
- 查不到不影响使用:网络不通、被限流时只会提示一句,不会报错卡住。
- 带 SHA256 校验:若该版本的 Release 附带了
SHA256SUMS.txt,下载后会自动比对, 不一致会明确告警,让你知道文件可能不完整或被掉包。
想让 AI 的回复也是中文? 选
4。界面汉化管不了 AI 生成的内容, 正确做法是加一条"用简体中文回复"的全局规则(脚本已内置该功能)。
Antigravity 官方更新后界面会变回英文——这是正常现象,不是坏了。
再运行一次选项 1 重新汉化即可,备份会自动升级为新版官方原版。
可以连续操作:每个操作做完会停一下让你看结果,按回车就回到主菜单,接着选下一项即可
(比如先「查看状态」再「一键汉化」,或者「汉化 → 恢复英文 → 再汉化」)。
窗口不会自己关掉;要关闭请点右上角的 ×,或者选 0 退出。
(macOS 上重签名也会一并重新完成)
- 网页界面:侧边栏、对话流、设置全部子页、模型与用量、MCP 管理、权限沙盒、插件中心、远程控制、会话历史、IDE 面板(VS Code 侧词条)等
- 原生菜单:顶部菜单栏(文件/编辑/视图/分屏/WSL 等 74 条)
- 系统托盘:右键菜单、智能体运行计数
- 系统弹窗:退出确认、更新检查、工作区选择、WSL 提示等
- 安装向导:欢迎页文案
- 权限确认弹窗:一直允许 / 仅允许一次 / 拒绝 / 跳过 等全套按钮
- 输入框提示:placeholder / aria-label 提示文案(不触碰输入内容本身)
上表中 WSL 相关的 3 处弹窗是 Windows 专属,macOS 版本没有 WSL, 因此那几处在 Mac 上不会命中(脚本会明确说明"属正常现象",不会报错)。 其余词条两平台通用。详见 mac/README.md。
当前深度适配 Antigravity v2.28.2(Windows 真机验证)。
| 版本 | 状态 |
|---|---|
| v2.28.2 | ✅ 当前基线,深度适配:35 处锚点全部命中(32 处定点文案 + 3 个挂钩点),注入 10 个文件语法门禁通过; 与 2.28.1 相比界面文案零新增(逐串比对确认),v1.10.1 补上了 Passkey / 跨设备登录相关的 11 条原生层文案 |
| v2.28.1 | ✅ 上一基线,深度适配:24 处静态锚点全部命中,注入 10 个文件语法门禁通过; 连同 2.28.0 一起补齐 97 条文案(内置浏览器、PDF 查看器、任意类型附件、快捷键管理、云端项目与 GitHub 集成、对话导航器); v1.10 又补 145 条(提示卡碎片、扩展市场全量文案、模型公告与配额动态文案) |
| v2.27.0 | ✅ 上一基线,24 处静态锚点全部命中,真机实测通过; 收录该版新增 231 条文案(云端工作区、实时语音通话、应用连接、账号切换、远程控制实例等) |
| v2.25.0 | ✅ 上一基线,20 处静态锚点 + 3 处挂钩点全部命中,真机实测通过; 收录该版新增 31 条 + 中英混杂修复 13 条 + 存量公开文案补全 136 条 |
| v2.24.0 | ✅ 深度适配通过(上一基线,20 处锚点 + 3 处挂钩全部命中);收录该版新增 97 条 + 历史补漏 1 条 |
| v2.23.1 | ✅ 深度适配通过(更早基线,20 处锚点 + 3 处挂钩全部命中) |
| v2.22.0 / v2.23.0 | ✅ 实测通过(已同步收录两版新增的 UI 词条) |
| v2.21.1 | ✅ 深度适配通过(更早基线,词典向后兼容) |
| v2.18.1 及更早 | ✅ 实测通过(词典向后兼容) |
| 更高版本 | 官方改名的新功能可能需要更新词典,跑一次选项 1 即可自动补上已收录的部分 |
界面翻译采用运行时 DOM 文本匹配,不修改官方界面文件本身。 因此官方更新不会破坏已有汉化,只可能新增少量未收录的新文案。
v1.11(2026-11-02):这一版不碰词典,修的是装不上/跑不完的两处硬伤。
起因是有人反馈汉化卡在「正在重新打包 app.asar」,报 npm error errno: 'EPERM':
- 打包不再依赖 npx:原来解包有内置降级、打包却只有
npx @electron/asar一条路, 所以那台机器(npm 缓存目录没有写权限)跑到最后一步必死,而且前面所有步骤都白跑。 现在补了纯 Python 的 asar 打包器,产物与官方工具逐字节一致 (2.28.2 实测:8,236,626 字节 sha256 完全相同;中文名 / emoji / 特殊字符 / 空文件 / 空目录 / 大文件分块等边界样本同样一致)。打包后还会把新包读回来逐文件比对 sha256,对不上就中止,绝不部署没核对过的包。 - 开工前先探 npm 缓存:缓存目录不可写就直接打印中文修复办法
(
npm config set cache "%LOCALAPPDATA%\npm-cache"),并把本次全程切到内置工具链, 不再让 npx 甩一屏英文栈、也不再把失败藏到最后一步。 node仍是硬要求(改完 JS 要做语法门禁),npx降为可选。- 另外把 README 里「零联网」的说法改准了:走
npx时首次会取一次官方打包工具(约 3 MB), 走内置打包器则完全本地。之前那句话不够准确,这次一并纠正。
v1.10.1(2026-10-30):适配 Antigravity 2.28.2。这一版官方只动了后端—— 把前端包 30725 条字符串逐条比对,只差 7 处压缩变量重名,界面文案零新增,所以词典没加新词。 补的是原生层一直漏着的两处:
- Passkey / 跨设备登录:
Choose a Passkey选择框(系统对话框)、跨设备扫码窗口 (Passkeys/Use your phone or tablet/ 扫描提示 / 连接中 / 请验证),共 11 处。 这两类界面一个是 Electron 原生对话框、一个是data:text/html且没有 preload, 翻译引擎碰不到,只能改源码字符串——之前一直没人注意到。 - 统计口径修正:原来报的「注入 10 个文件」其实是写盘次数(menu.js 被写 4 次、tray.js 被写 2 次), 真实文件数是 8。现在去重了,报的就是文件数;加上 Passkey 两个文件,2.28.2 上正好 10 个。
v1.10 补漏(2026-10-30):上一版发出去后,把界面逐页扫了一遍(不是只扫打包文件, 而是把运行中的应用当审计对象,逐页读 DOM),补掉三类漏翻和两类引擎隐患:
- 被图标切断的句子碎片:提示卡里的
in the top left./menu)这类片段, 因为中间夹着图标,整句永远匹配不上,于是永远显示英文(或半中半英)。 这次按「前半句 + 图标 + 后半句」的实际渲染顺序分别给译文,拼起来才是通顺中文。 - 扩展市场的分类与服务端文案:7 个分类名与说明、11 张内置卡片说明、 50 个合作方插件的完整介绍、页脚免责声明,全部补齐。 插件名称保持英文原样(Browserbase、Stripe 这类产品名硬翻反而找不到东西), 「See 18 more」改成「再显示 18 个」。
- 模型选择器的公告:
Notice/Unavailable徽章,以及悬停后的整段公告 (含starting on November 2, 2026这种带日期的句子)——这类文案是服务端下发的, 每次上线都可能变,所以走动态规则而不是死记硬背。
引擎这一轮补了两件事:
- 日期与时长归一:译文里残留的
November 2, 2026会变成2026年11月2日, 配额提示里的Resets in 3h54m47s会变成3小时54分47秒后重置。 - 多词串的链接保护:原来只保护「单个词 + 技术符号」,实测
See [go/jetski-agent-sidecars#trusted-locations](…)这种两段式串会把链接里的jetski-agent替成jetski-智能体,点开会 404。现在整串含 URL / 文件名 / 锚点时一律原样返回。
另外顺手修掉两个坑:
- 从 Electron 系终端启动会「假失败」:VS Code / WorkBuddy 这类终端会给子进程带上
ELECTRON_RUN_AS_NODE=1,Antigravity 继承后会被当成 Node 解释器——不弹窗、立刻退出 0。 以前只在日志里报「启动失败」,现在启动前会主动剔除这个变量。 - 两条会把整段塞进短词的前缀规则:它们让技能说明变成 「中文半句 + 英文整段」的拼接怪,已删除,改用完整精确词条覆盖。
覆盖率(同一套 2466 条候选口径):2123 条 → 2164 条,86.1% → 87.8%。 剩下 291 条全英文的都是内部开关名、代码常量、错误信息这类不该翻的内容。
v2.28.1 新增内容的处理:这次跨了两个版本(2.27.0 → 2.28.0 → 2.28.1),共补 97 条文案:
- 内置浏览器(2.28.0 的头号功能):
Built-in Browser/External Browser/Side Panel/Side Panel Preview、Open Links In/Open in/Open in Side Panel、地址栏安全指示Not secure/Your connection to this site is not secure、 证书面板Certificate details/Certificate is valid/Issued by/The certificate has been revoked.、View site information,以及设置页的两段说明文字。 - PDF 查看器与附件:
File size exceeds 20MB limit/Failed to attach file。 - 快捷键管理:
Add Shortcut/Edit Shortcut/Remove Shortcut/Reset All to Defaults、Search shortcuts.../Press keys.../No keyboard shortcuts found matching your filter.、Middle Click、浏览器标签页占用快捷键的提示。 - 对话导航与标签页:
Move Conversation Up/Move Conversation Down/Open Conversation in New Tab/Reopen Closed Tab。 - 云端项目与 GitHub 集成:
Cloud Projects/Cloud only/Local only/Local Checkout、Connect GitHub…/Loading repositories…/No repositories found/Requires a GitHub repository、Worktree Branches/View Branches/Not cloned locally。 - 数据删除:
Remote Agents Data/Delete All Data/Delete All Remote Agents Data?及整段说明。 - 插件与市场:
More Plugins/Permission Details/Website/Sign in needed、Explore other marketplace customizations。 - 主题与字体:
Enable New Themes及两项实验性外观设置说明。 - 对话状态:
Waiting for your approval。
主词典由 19363 条增至 19460 条(词典版本 1.9.0)。本次一起做了四件事:
- 修掉一个会让汉化直接失败的官方包问题:2.28.1 的
app.asar索引里声明node_modules/chrome-devtools-mcp/.../selectElementAccessibility…Descendant.md是外部文件(unpacked), 但app.asar.unpacked目录下实际没有这个文件——官方打包漏了一个(1085 个条目里坏 1 个)。 标准 asar 工具遇到「索引里有、文件却没有」的条目会整体报错退出,汉化在解包阶段就中止。 现在工具内置了一个容错解包器:官方工具失败时自动接管,逐条处理、跳过缺失项并明确提示。 跳过的文件本来就读不到,跳过不改变运行行为。 打包后的完整性守卫也同步排除这 1 个条目——否则**「再跑一次汉化」会误报中止** (参照官方备份时发现缺这一项)。这个坑是实测踩到才发现的,两条入口都验证过: 从官方原版跑、从已汉化状态重跑,产物字节完全一致。 - 修掉 22 条中英混杂:核心词表会把没被精确收录的新词逐词硬替换,产出
删除 All Data、添加 Shortcut、Cloud 项目、Empty 日志这类半截货,比纯英文更难受。 这批全部补了精确词条,实测中英混杂从 49 条降到 9 条(剩下的是 GitHub / Google Sans / Chrome 这类专有名词保留,属正常译法)。 - 引擎加了技术串保护(
engine.js的核心词分词环节):原来\b词边界在/.-:旁边也算边界, 会把https://policies.google.com/privacy里的词、show-more这类连字符标识符一起替换掉, 产出坏 URL 和坏标识符——这比不翻更危险。现在「无空格且含技术符号」的串直接原样返回。 用 25006 条样本做新旧引擎对照:误伤 0 条,39 条译文由混杂变干净,51 条从不翻变成翻。 - 旧词条一律保留,不删:还在用旧版本的用户不受影响。
v2.27.0 新增内容的处理(上一版):这一版跨度较大,界面新增了一整批功能,对应文案全部补齐(231 条):
- 云端工作区:项目文件和对话附件存在 Google 服务器、挂载到云端沙箱、连接 Google Drive / GitHub 资源、
数据留存与删除说明、
Resume environment/Resuming environment…/This chat's environment is paused。 - 实时语音通话(Live Chat):开始 / 结束、麦克风静音、语音音量、上一个 / 下一个声音、输入消息、拖放附件。
- 应用连接:
Connected apps/On this computer两个标签页、只登录一次即可跨设备使用、应用市场里连接应用。 - 插件替换:
Currently installed/Replace with/Replacing...及替换确认正文。 - 多账号:账号标签页、切换失败、
Add label/Used for:/ 设为默认的引导句。 - 远程控制:
Remote Control Instances/No instances yet./Get started with Remote Control。 - 浏览器右键菜单:在新标签页打开链接 / 在外部浏览器打开 / 复制链接地址 / 打开图片 / 复制图片地址。
- 过滤与状态:
Only Archived/Only Automations/Only Scheduled、Toggle Status Bar、Fit Mode。 - 连接状态:
Connecting…/Still connecting…/Reconnecting…/reconnecting。
上一版主词典由 19137 条增至 19363 条(词典版本 1.8.0)。同一批还做了四件事:
- 修复启动方式(用户实测报的问题):以前选
Y立即启动,Antigravity 会和本工具共用同一个控制台—— 它的日志(DevTools 端口、wsl.exe报错、自动更新)直接刷满窗口,关窗口时还会顺手把 Antigravity 一起关掉, 工具退出后窗口也不关,看起来像"输 0 没反应"。现在改成独立进程启动(DETACHED_PROCESS+ 三路流转 NUL), 日志不再串台,关工具窗口不影响 Antigravity。 - 退出提示不再骗人:操作结束处的提示写着"输入 0 可退出",实际代码只把输入丢掉、照样回主菜单。 现在真按提示执行。
- 旧词条一律保留,不删:2.27.0 有一批旧文案不再出现在前端包里
(例如
Start voice/End voice被 Live Chat 系列取代)。 这些老词条留在词典里既不会误翻、也不占运行时开销,保留是为了向后兼容旧版本, 方便还在用 2.24 / 2.25 的用户。 - 修掉 5 条历史错译(这轮深度审计挖出来的):
ID曾被译成"标题"、URL译成"文件"、PID译成"内存(MB)"、For译成"适用源"、uv译成"UV 包管理器", 都是早期合并上游词典时串行的。这几个是界面表头/状态字段,译错会让用户看到错误信息。 缩写类(ID / URL / PID / uv)直接删条目保持英文——中文界面本来也写 ID、URL;App则从"应用设置"改正为"应用"。
这一版的覆盖率是怎么算的(可以自己复核):把 2.28.2 的真实界面包逐条提取(与 2.28.1 候选完全一致),
得到 2466 条候选文案,用内置引擎实跑一遍:2123 条已翻译(86.1%)(v1.10 补漏后为 2164 条 / 87.8%)。
剩下 343 条的构成是——产品名与厂商名(GitHub、Windows、Linux、macOS、Drive、Google3、Gemini Enterprise)、
模型名(Flash Lite / Flash / Pro)、内部日志前缀([AppState]、[TrajectorySummaries]、
[McpServerStates] 等)、示例占位值(Workspace_1、http://localhost:8080、my-gcp-project)、
命令标识符(run_command / view_file)、LaTeX 渲染命令(\fbox / \angl),
另有 17 条路径与内部短链、5 条枚举常量、字体名与按键名各 1 条。
这些刻意不翻:翻协议错误串会破坏 MCP 通信,翻示例占位符会误导用户填错值,
翻模型名会让人认不出是哪个模型,翻 ID/URL 反而让人看不懂。它们不是"漏掉",是"不该动"。
v2.25.0 新增内容的处理:这一版是小版本,主打插件侧边栏徽标、窗口快捷键与可靠性修复,
界面文案增量不大,但有两块是全新的:语音模式(语音模式开关、语音引擎与地址配置、
开始语音 / 结束语音 / 静音麦克风 / 取消静音、语音已开启、语音已断开、
麦克风被阻止、语音启动失败等提示)和插件与账户管理
(启用插件后才能登录、启用后才能管理账号、添加多账号时 MCP 服务器使用标记为默认的那个、
无需登录、重新登录、设为默认、显示或隐藏插件、在侧边栏中显示、打开插件页 / 技能页),
另外补上状态栏的语言服务器渠道与版本提示、磁盘已满搜索受限提示、Checking… / Custom… 等状态文案,
共 31 条新文案。
同批还修掉了 13 条中英混杂的老问题——这些词条此前没有精确译文,被核心词表逐词替换成了 「执行 Identity」「打开 plugin page」「显示 in Sidebar」这类半截输出。现已全部补齐整句译文, 主词典由 18957 条增至 19001 条。
随后又做了一轮存量补全:把此前版本一直没收录的 136 条公开界面文案一次补齐 (插件包管理、账号与登录、工件预览、终端、GitHub 策略、轨迹统计、引导页等), v1.7 发布时主词典为 19137 条(v1.8 增至 19363 条、v1.9 增至 19460 条、v1.10 增至 19605 条,见上)。
v1.7 里的一个安全修复:审计时发现 Antigravity 会把 aria-label 当作稳定标识使用
(例如某个输入框失焦时用 aria-label === "Cancel" 判断是否点了「取消」)。
此前引擎会翻译 aria-label,一旦译成「取消」,该判断失效——点取消反而会提交内容。
现已把 aria-label 移出翻译范围:它是给读屏软件的标识,不是可见文案,不翻不影响界面观感。
v1.7 里的另外三处修复(都是这轮深度审计挖出来的):
- macOS「检查更新」菜单项点击失效:官方代码用
updateActions[menuItem.label]查动作表, 键是英文;标签被翻成「检查更新」后查不到,点击静默无反应。现在保留英文原值用于查表, 显示仍用译文;更新状态变化时也不会再变回英文。 - 17 条词条错位:英文讲的是 A,中文写的却是完全无关的 B
(例如
Model: {0}被写成「选择模型」、Jetski Update Available被机翻成「摩托艇更新可用」)。 这些是早期从上游词典合并时串行的历史遗留,本版逐条改正,并新增占位符一致性门禁防复发。 (补充说明:经全安装目录比对,这些词条在 2.25.0 界面中并未被引用,属当前版本用不到的历史条目; 本次修正属词典准确性维护,不会改变可见界面。) - 相同译文重复、
${...}占位符被改错等情况一并纳入发布前自动检查。
此前的 v2.24.0 重做了侧边栏并加入概览面板,新增 /compact 对话压缩、自动化任务可选模型、
侧边栏「自动置顶」、项目 / 工作区独立排序、登录过期提示、按对话关闭遥测、
「每次响应的 Harness」与成本统计、时间轴缩放提示、三类权限标签等 97 条文案;
v2.22.0 / v2.23.0 加入的侧边栏拖拽整理、UI 扩展、消息框权限预设选择器、
全屏媒体查看器、.zip 附件、MCP「让智能体修复」、参谋长(Chief of Staff)等词条同样保留,向后兼容。
官方更新后想补充新词条:打开 zh_data.json,在 exact 段加一行
"英文原文": "中文翻译",重新运行汉化即可。
| 内容 | 原因 |
|---|---|
| AI 思考过程(Thinking) | 流式推理内容不适合词典翻译,强行翻会夹生卡顿;正文/总结/计划是中文 |
| 模型名(Gemini、Claude 等) | 产品名,翻译会造成识别混乱 |
| 个别受控下拉选项 | 翻译会导致组件状态失配、界面卡死,以"能用"优先 |
| 代码与代码块 | 程序代码不该被翻译 |
| 你输入的内容 | 输入区物理隔离,永远不会动你打的字 |
所有词条都在 zh_data.json 一个文件里(明文 JSON)。想补充词条、改译法,直接编辑后重跑启动器即可,脚本会剥离旧翻译重新注入,不怕重复。
| 文件 | 作用 |
|---|---|
一键汉化.bat |
Windows 双击入口(自动找 Python) |
localize.py |
主程序:备份/注入/语法门禁/打包/部署/恢复/防并发/(macOS)代码签名重签 全流水线 |
engine.js |
界面翻译引擎(注入到 Antigravity 内部运行) |
zh_data.json |
词典数据(19956 翻译单元,想补充词条改这个文件后重跑即可) |
mac/一键汉化.command |
macOS 双击入口(自动找 Python3 / Node.js / codesign) |
mac/README.md |
macOS 专属说明与故障排查 |
赞赏码.jpg |
打赏码(自愿打赏,不影响任何功能) |
- 杀毒软件可能误报:修改其他程序的文件属于敏感行为,部分杀软会提示。本工具源码全部公开、可自行审查,添加信任/放行即可。
- 运行前会自动关闭 Antigravity:汉化和还原都需要先关闭应用,脚本会自动处理,不用手动关。
- 备份文件别手动删:安装目录里的
app.asar.bak是还原用的官方原版备份,脚本会自动维护它。 - 官方大版本更新后:个别词条可能暂时失效(脚本会安全跳过,不报错不损坏),界面主体翻译不受影响;等本工具适配更新即可。
- 支持 Windows 与 macOS;Linux 暂不适用(脚本已预留分支,未做真机适配)。
- macOS 额外说明:Mac 会对
.app做代码签名,改包必然导致签名失效, 本工具已在汉化/还原后自动重新签名(并保留 Electron 运行必需的 entitlements)。 若弹出管理员密码框属正常流程;万一提示"应用已损坏",见 mac/README.md 的一键修复命令。 - 本工具属于非官方第三方魔改:介意"改动软件本体"的用户请勿使用;使用即表示了解并接受这一点。
- 认准唯一下载渠道:请只从本仓库 Release 页下载,其他渠道的打包可能被动手脚。
- 解压路径别太深:Windows 传统路径上限约 260 个字符,
若把工具解压到类似
D:\工作资料\编程工具\汉化\...这样的深层目录, 可能因路径过长无法启动。建议解压到D:\汉化工具\或桌面等较浅的位置。 这是 Windows 系统的限制,与本工具无关。 - 双击
一键汉化.bat满屏"不是内部或外部命令":这是批处理文件被存成了 Unix 换行(LF)导致的,cmd 解析不了。v1.8 已把.bat改成 Windows 换行(CRLF), 并把所有多行if (...)块改成单行goto,以后再被编辑器存成 LF 也不会整段崩掉。 如果你手上是旧版文件,重下 v1.8 即可。
Q:双击 一键汉化.bat 窗口一闪就没了?
说明启动脚本本身出错了。在文件夹空白处按住 Shift 右键 →「在此处打开 PowerShell 窗口」,
然后执行 python localize.py,能看到完整报错。最常见的原因是没装 Python 或没勾 "Add Python to PATH"。
Q:双击报 'xxx' 不是内部或外部命令?
批处理文件被换行搞坏了(见「注意事项」第 10 条)。用 v1.8 的包,别用第三方编辑器改过的 bat。
Q:汉化完了界面还是英文?
先跑选项 3 看状态是不是"已汉化",再确认完全退出 Antigravity(含托盘图标)后重新打开。
运行时 DOM 翻译依赖界面加载完成,第一次打开稍等 1~2 秒。
Q:卡在「正在重新打包 app.asar」并报 npm error errno: 'EPERM'?
不是工具坏了,是那台机器的 npm 缓存目录写不进去。npx 在下载工具之前要先往缓存里
落临时文件,目录没权限就直接 EPERM 退出,还会甩一屏 npm 内部栈(典型现场:缓存被设到
C:\某目录\node_cache,而这个目录是管理员装的、或整个从别的账户拷过来的)。
工具现在会在开工前先探测一次缓存目录:写不进去就打印修复办法,并自动改用内置打包器
(带逐文件字节校验)把汉化做完,不再卡死。想让 npx 也恢复正常,在 cmd 里执行一次
(不需要管理员权限,缓存会搬回 npm 的默认位置):
npm config set cache "%LOCALAPPDATA%\npm-cache"%LOCALAPPDATA% 不会展开,会存成一个无效路径。
本工具可以接触你的 Antigravity 安装目录,安全底线如下(源码全部公开,欢迎自行审查):
- 联网只有两处,都摆在明面上:① 首次运行若走
npx,会从 npm 源取一次官方 asar 工具 (约 3 MB,之后走本地缓存;npm 环境不可用时自动改用内置打包器,这一步完全本地); ② 菜单5「检查更新」,只有你主动点它才会触发一次 (只查版本号和下载链接,详见「关于『检查更新』」一节)。 除此之外,汉化、还原、查看状态、AI 中文化全程无任何网络请求,不连任何服务器, 无数据上报、无遥测、无"偷偷下载"。 - 只动该动的:仅读写 Antigravity 安装目录内的文件;不碰注册表、系统服务、启动项、驱动,不碰你的项目代码和 Antigravity 用户数据
- 可完全还原:一键还原到官方原版,字节级一致;备份永不降级(官方更新后自动升级备份)
- 坏不了:写入前语法门禁校验,部署后二次解包复检,任一环节失败立即中止并回滚;部署采用原子替换,不存在"改到一半"的状态
- 不误伤别的软件:身份守卫校验目标确实是 Antigravity 才动手;杀进程只杀 Antigravity 安装目录下的进程(macOS 按完整可执行路径精确匹配,绝不误杀同名程序)
- macOS 签名如实告知:改包会破坏 Apple 代码签名,本工具自动重签并校验; 重签用的是临时签名而非 Google 官方签名,不影响官方更新(更新后重跑一次即可)
- 输入内容绝对安全:输入框、代码区、思考链物理隔离,词典翻译永远触碰不到你输入和生成的内容
- 本工具为独立第三方工具,与 Google、Antigravity 官方没有任何关联,也未经官方认可。
- 本工具按"现状"提供,不附带任何明示或默示的担保。因使用或无法使用本工具导致的任何问题(包括但不限于软件异常、数据丢失、需要重装软件、账号或服务受限等后果),均由使用者自行承担。
- 是否使用由你决定——修改软件本体属于个人学习研究行为,请自行评估风险并遵守当地法律法规及软件服务条款。
- 请通过本仓库官方 Release 页获取本工具,从其他渠道获取的副本安全性与本作者无关。
本工具永久免费。如果它确实帮到了你,欢迎扫码打赏,金额随意。
打赏完全是自愿的——不打赏也能正常使用全部功能,没有任何区别, 不会弹窗、不会提示、不会限制任何功能。
本工具永久免费,不设付费版、不设会员,打赏为自愿行为而非使用条件。
任何收费售卖本工具的行为都是倒卖,请拒绝并向平台举报;不幸付费购买的,可向售卖者要求退款。
Copyright (c) 2026 青鸟(QingniaoDawn)· 详见 LICENSE
- 允许个人学习、自用,以及在完整保留本声明和作者署名的前提下免费分享原包
- 禁止商用、倒卖、收费分发,禁止去除署名或冒充原创
