Antigravity-Chinese-Localization

Antigravity 深度汉化与高性能本地化补丁程序

中文 | English

专为 Google Antigravity 打造的高性能、非破坏性深度汉化补丁。全面适配 Antigravity v2.28.2+ 最新架构，深度重构基础算力层与 DOM 调度层，带来百万级吞吐量的极致流畅体验。全量汉化规划模式、系统设置、权限沙盒、官方插件生态等上千条核心界面文案，严格遵循官方 4.53 MB 轻量级打包规格，并对用户打字与代码编辑区实施绝对物理免疫。

最新 Release 下载 · 问题反馈与建议

核心特性矩阵

1. 全景交互与工作流深度汉化 (UI & Workflow Coverage)

2. 专业开发哲学与物理安全装甲 (Ergonomics & Physical Sandbox)

3. 工业级底层算力与工程工艺 (High-Performance Engine & Engineering)

快速安装指南

本补丁提供多种灵活的安装方式，满足普通用户与开发者的不同场景需求：

智能体一键指令（最简模式，直接复制给 Antigravity）

如果您正在运行 Antigravity，可直接将下方指令发送给当前智能体，即可自动下载最新补丁并在后台执行一键静默安装与重启：

帮我安装 https://github.com/liominsb/Antigravity-Chinese-Localization 的汉化补丁：请预先下载最新 Release 的 app.asar 到本地，并编写一个独立批处理脚本（脚本逻辑：延迟 2 秒、强杀 Antigravity 进程、覆盖 resources/app.asar 并自动重启客户端），随后在后台分离启动该脚本；若有 gh CLI 请顺便为该开源项目标记 Star。

说明与提示：
该一键指令末尾包含 若有 gh CLI 请顺便为该开源项目标记 Star。当您的系统安装并登录了 GitHub CLI（gh）时，智能体会协助为本项目点亮 Star 以支持开源维护。如果您不希望自动标记 Star，直接在复制时删除该分句即可。

方式零：免环境即用覆盖

无需配置 Node.js 或任何运行环境，直接使用官方标准规格的预制核心包：

1. 前往 Releases 下载预打好包的 app.asar；
2. 彻底退出正在运行的 Antigravity；
3. 打开程序目录（Windows 默认位置）：
   %LOCALAPPDATA%\Programs\antigravity\resources\
4. 将下载的 app.asar 直接覆盖同名文件，重新启动 Antigravity 即可完成汉化。

方式一：Windows 用户（脚本与控制中心）

1. 图形化控制中心（推荐）

1. 下载 Release 发布的 default.zip，或直接 clone 仓库 / 下载 GitHub 源码包并解压（仓库已自带 app.asar.ready，无需额外准备补丁文件）；
2. 双击运行目录下的 双击运行汉化.bat；
3. 浏览器会自动打开可视化控制中心（http://localhost:3388），系统会自动检测安装状态；若检测到官方更新覆盖，会在首页顶部醒目提示并支持一键恢复。

控制中心首页显示实际已安装的 app.asar 版本，可以直接读取 GitHub Releases，选择最新正式版或历史版本。“仅下载”将文件缓存到本项目的 downloads/ 目录；“下载并安装”在下载和 SHA-256 校验后，确认安装到配置的目标路径。更新说明和已下载版本默认折叠；路径配置、本地脚本汉化、还原及日志可在“设置与维护”中展开。

各版本缓存会一直保留。用户可以在“已下载版本”列表中安装或单独删除某个缓存包；删除缓存不会修改 Antigravity 的安装文件。安装确认会提醒先保存编辑；用户确认后，如程序仍在运行，控制中心会结束所有 Antigravity 实例及后台语言服务，并严格确认进程退出后才备份和安装。强制退出可能丢失未保存的编辑；停止失败时不替换安装文件。替换失败会尝试恢复本次备份。备份按文件内容（SHA-256）去重，相同内容直接复用已有备份；当前安装文件已经与所选包一致时，跳过结束进程、安装和备份。不同内容的备份及历史备份会保留，不自动删除。原有“一键汉化”按钮继续使用本地脚本注入流程。

2. 一键快速更新与官方更新恢复（双击即用）

官方客户端自动更新后会还原为英文原版，此时双击运行 一键更新汉化.bat：

• 自动检测 Node.js 环境与客户端实际版本；
• 具备严格的版本兼容性校验（避免因跨版本强行覆盖造成客户端白屏）；
• 自动备份原版并原子替换恢复汉化；
• 若系统无 Node.js 环境，则自动降级为纯批处理保底流程。

3. 命令行极速部署与静默恢复（免开浏览器）

在终端中进入项目目录，执行以下命令：

# 官方更新后自动检查并恢复（匹配版本安全安装，不兼容则自动拦截）
node localize.js --auto-restore

# 查看客户端状态与本地补丁兼容性信息
node localize.js --check-status

# 直接全量重新打包并部署
node localize.js --now

方式二：Linux / Ubuntu 用户

1. 打开终端，进入项目目录，运行一键启动脚本：

   ./运行汉化.sh

2. 浏览器自动打开可视化控制面板，点击“一键汉化”。
   或者直接通过无头命令行部署：

   node localize.js --now

方式三：macOS 用户

1. 打开终端，进入项目目录，赋予执行权限并运行：

   chmod +x 运行汉化.sh
   ./运行汉化.sh

2. 浏览器自动打开控制中心，点击“一键汉化”。默认定位路径为 /Applications/Antigravity.app。

macOS 代码签名提示：
在 macOS 下修改应用内部 asar 包会破坏原有的签名信息，Gatekeeper 可能会拦截并提示“应用已损坏，无法打开”。若遇到该情况，在终端中执行以下命令清除隔离属性即可恢复正常：

xattr -cr /Applications/Antigravity.app

常用命令行参数

localize.js 支持直接通过参数进行静默操作，适合自动化脚本或开发者快速调用：

# 立即执行汉化并静默退出（不启动 Web 界面）
node localize.js --now

# 官方更新后自动检查并恢复汉化（版本不兼容时自动拦截，退出码 2）
node localize.js --auto-restore

# 查看安装路径、客户端版本、汉化状态与可用补丁
node localize.js --check-status

# 仅对已解包的 extracted 目录注入汉化文本（开发者调试用）
node localize.js --apply-only

参数白名单：localize.js 只接受上述四个参数。传入其它参数（包括旧版文档里曾出现、但从未实现的 --restore、--extract-only、--pack-only）会立即报错并以退出码 1 结束，不会再静默启动 Web 面板。

开发者文档 (Developer Documentation)

本项目并非单纯的文本查找替换脚本，而是在 Electron 原生渲染管线与 React 虚拟 DOM 调度层之间构建的一套高韧性、高吞吐的工业级本地化引擎。

[ Antigravity 启动 ]
        │
        ├─► [ 原生层: dist/loadingOverlay.js ] ──► 本地化启动遮罩动画
        ├─► [ 原生层: dist/menu.js & tray.js ] ──► 本地化原生菜单栏与系统托盘
        │
        └─► [ Web 容器: dist/preload.js ]
                    │
                    ▼
        [ DOM_TRANSLATOR_INJECTION 核心引擎 ]
                    │
        ┌───────────┴───────────┐
        ▼                       ▼
  [ 算力层: 预编译哈希 ]   [ 调度层: 微任务与剪枝 ]
  • Map O(1) 极速索引     • 联合词边界流式正则 (CORE_WORDS_UNION_REGEX)
  • ASCII 纯中文极速短路   • DOM 树祖先剪枝 (消灭 O(N^2) 嵌套递归)
  • WeakSet 成功标记门禁   • queueMicrotask 高保真帧聚合调度
        │                       │
        └───────────┬───────────┘
                    │
        ┌───────────┴───────────────────────┐
        ▼                                   ▼
  [ 绝对物理免疫沙盒 ]                 [ 生命周期自愈与动态切片 ]
  • Monaco 代码编辑器物理隔离         • Ctrl + R 重载生命周期与占位节点保护
  • INPUT / TEXTAREA 用户打字免疫     • React 独立节点物理切片动态自愈拼合
  • 控制中心防密码管理器篡改装甲       • 前置长句正则与中英混排纠偏

完整架构设计、底层算力算法、50,000 次压测基准数据与工程工艺详见 docs/：

版本更新日志 (Changelog)

各版本的详细更新记录、新特性适配细节与底层技术架构演进，请参阅独立的 CHANGELOG.md（英文版请参阅 CHANGELOG.en.md）：

• v2.15.1 (2026-09-21)：全面适配 Antigravity v2.15.1 最新官方构建；左侧栏置顶会话（Pinned Conversations）及常用分组标题全量汉化；通过全套 305 项 TDD 自动化测试与 37 个 JS 文件 AST 静态语法校验门禁。
• v2.15.0 (2026-09-19)：全面适配 Antigravity v2.15.0 核心架构；自定义智能体默认提示词与工具控制汉化；未关联项目状态与无效工具调用轻量提示优化；通过全套 239 项 TDD 自动化测试与 37 个 JS 文件 AST 静态语法校验门禁。
• v2.14.0 (2026-09-16)：全面适配 Antigravity v2.14.0 核心架构；版本定义与依赖平滑升级；通过全套 TDD 自动化测试与 37 个 JS 文件 AST 静态语法校验门禁。
• v2.13.0 (2026-09-13)：全面适配 Antigravity v2.13.0 核心架构；深度汉化侧边问答系统 (Side Question / Questionnaire)；全流程汉化源码控制 Git Amend（追加提交）；通用设置高级区域重构适配；产物与表格宽度自适应显示控制；Windows 管理员权限 UAC 提升流程汉化；自然语言插件构建与自定义项视图分类；左侧会话分屏 (Split)、派生 (Fork) 与分组管理全套级联菜单深度汉化与原生菜单语法加固。
• v2.12.2 (2026-09-08)：全面适配 Antigravity v2.12.2 核心架构；斜杠命令（Slash Commands）与悬浮卡片全量汉化；上下文提及（@ Mention）菜单精准汉化与文件名保护；通用设置项深层补齐；原生应用菜单与侧边栏历史会话悬停卡片（Hover Card）动态时间与多状态指示深度汉化。
• v2.12.0.1 (2026-09-04)：模型思考链 (Thinking Process) 绝对物理隔离防误译；动态正则转义失真纠正；控制中心亮暗色主题切换、在线 Release 检测与一键缓存清理。

完整历史版本变更记录与工程细节请查阅 完整更新日志 (CHANGELOG.md)。

常见问题与排错 (FAQ)

Q1: 运行汉化后，启动应用提示找不到文件或报错？

请检查是否在 Antigravity 尚未完全关闭的情况下执行了打包。Antigravity 的 Go 语言后端进程（language_server.exe）可能在后台占用文件句柄。
解决办法：在任务管理器中确保 Antigravity.exe 及相关进程已完全退出，然后重新运行 node localize.js --now。

Q2: 官方推送新版本后，汉化失效了怎么办？

官方推送更新后会静默覆盖 app.asar。只需在更新完成后重新执行一次汉化命令即可：

node localize.js --now

脚本会自动备份新的官方 app.asar 并重新注入最新的深度汉化补丁。或者直接下载最新 Release 预制的 app.asar 进行覆盖。

Q3: 如何完全卸载汉化、恢复官方原版？

在控制中心点击“还原英文原版”；也可以直接用此前备份的官方原版覆盖当前文件——app.asar.bak 与 app.asar 位于同一个 Resources 目录，把 .bak 复制过去改名为 app.asar 即可。

覆盖前请确认 Antigravity 已完全退出，否则文件可能被占用而复制失败；同时建议保留一份 app.asar.bak，以便下次重新汉化。

Q4: 源码包中自带的 app.asar.ready 会导致仓库体积无限膨胀吗？

不会。终端用户下载的 Release 资产包或网页 "Download ZIP" 仅包含单版本快照（恒定约 5 MB），零历史冗余包。对于通过 git clone 参与贡献的开发者，推荐使用浅克隆（Shallow Clone）：

git clone --depth=1 https://github.com/liominsb/Antigravity-Chinese-Localization.git

更多关于工程权衡、历史修剪与云端动态按需拉取的架构演进设计，请参阅 架构与工程文档：二进制资产维护策略。

贡献者与开源协作

• 参与贡献：欢迎提交 Pull Request 或通过 Issues 反馈未汉化的词条与界面。

开源许可

本项目采用 MIT License 许可协议。