antigravity-chinese-community-pack

# Google Antigravity（反重力）社区全平台中文深度汉化与智能体辅助包 <p align="center"> <b>非官方社区自研 · 全界面深度汉化补丁 + 智能体中文交互规则库</b><br> <i>专为 Google Antigravity（反重力）2.18.1+ 最新版设计的全平台双模式中文本地化解决方案</i> </p> <p align="center"> <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a> <a href="https://github.com/ATopos-svg/antigravity-chinese-community-pack/releases"><img src="https://img.shields.io/badge/Release-v2.18.1-brightgreen.svg" alt="Latest Release"></a> <a href="#"><img src="https://img.shields.io/badge/Compatibility-Antigravity%202.18.1%2B-orange.svg" alt="Compatibility"></a> <a href="#"><img src="https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-blue.svg" alt="Platform"></a> <a href="#"><img src="https://img.shields.io/badge/Pure%20Architecture-No%20Deadlock-success.svg" alt="Pure Architecture"></a> </p> --- > ⚠️ **重要声明与免责条款 (Disclaimer)** > > 1. **非官方自创项目**：本项目为**开源社区开发者个人自发创建与维护**，与 Google LLC、Antigravity 团队或 VS Code 均无官方隶属、授权、赞助或背书关系。 > 2. **创作初衷**：由于当前 Antigravity 官方客户端尚未内置中文语言包选项，本项目旨在为广大华语开发者提供地道、专业、无障碍的中文开发与智能体协作体验。 > 3. **安全承诺**：本项目完全开源，不收集、不记录、不上传任何用户代码、Token 或个人隐私，所有补丁逻辑均透明可见。 ## 📸 实际汉化效果预览 (Screenshots) ### 1. 快捷命令面板 (`Ctrl+Shift+P`) 全中文指令  ### 2. 全局常规设置与智能体执行权限中心  ### 3. 全量 126 项官方技能卡片及详细适用场景深度汉化  --- ## 💡 关于 Antigravity 2.10.0+ 适配与老版本避坑说明 许多开发者升级到 Antigravity 2.10.0+ 后，经常遇到网上的老汉化包失效甚至程序崩溃的问题。这里说明一下 2.10.0+ 的核心变动及本项目的针对性优化： 1. **为什么老补丁在 2.10.0 上会卡在 Loading 白屏？** - 官方在 2.10.0 版本重构了窗口创建与加载动画 (`loadingOverlay.js`) 的生命周期销毁机制； - 网上早期（针对 2.8.x / 2.9.x）的旧补丁大都通过直接修改加载动画来注入文字，这在新版中直接截断了官方的回调握手，导致窗口卡死在转圈界面； - 本项目**坚决不动任何官方底层文件**，采用独立的 `preload.js` 沙箱延迟挂载技术，实测秒开、不转圈、零死锁。 2. **完整支持 2.10.0 新推出的 110 项官方插件技能（全量 125 技能）**： - 2.10.0 正式上线了 Google Developer Plugins 插件生态； - 老补丁只有早期的十几个技能，导致设置里大面积英文；本项目已完整覆盖 BigQuery、Firebase、Flutter、Science、HyperFrames 等全量 125 项技能及其详细适用场景说明。 3. **对齐新版改版功能**： - 深度对齐了 2.10.0 改版后的快捷命令面板（`Commands ⌵`）、多设备协作扫码（`Remote Control`）以及新加入的 `One Light` / `Solarized Light` 等主题预设。 --- ## 📜 版本迭代历史与对应下载 (Changelog & Releases) 为了方便不同更新周期的开发者使用，项目完整保留了各个版本的安装包： | 版本标签 | 适配官方版本 | 发布时间 | 核心更新说明 | 预打包下载 (Releases) | | :--- | :--- | :--- | :--- | :--- | | **🚀 v2.18.1 (最新版)** | Google Antigravity **v2.18.1** | 2026-09-30 | • 深度适配 Google 2026.09 最新推送的 2.18.1 正式版（内部版本 2.18.1.0）<br>• 重磅支持：官方全新系统托盘（System Tray）集成与托盘活动智能体计数（`没有正在运行的智能体` / `x 个智能体正在运行`）全汉化<br>• 全面汉化原生退出二次确认弹窗（Confirm Quit，防止误关闭后台执行中的智能体）<br>• 持续完善 WSL 2 原生集成、独立 Splash 配置窗与「Antigravity IDE」向导精译<br>• 完整对接 11 大核心 API 架构及 ConnectRPC 通信栈，引入 `shell-env` 环境无损挂载<br>• 全量覆盖 45+ 款 MCP 服务市场卡片、126 项官方技能卡片与智能体权限安全策略<br>• 严格遵循 `--unpack-dir` 规范防白屏打包（~4.8MB），经 120 项全量自动化测试验证 100% 通过<br>• 支持 Windows / macOS / Linux 全平台一键无损安装与一键秒级还原 | [📥 下载 v2.18.1 全平台补丁包](https://github.com/ATopos-svg/antigravity-chinese-community-pack/releases/tag/v2.18.1) | | **⭐ v2.17.0 (稳定版)** | Google Antigravity **v2.17.0** | 2026-09-25 | • 深度适配 Google 2026.09 最新推送的 2.17.0 重大更新（跳过 2.16.x 跨代跃迁，内部版本 2.17.0.0）<br>• 重磅支持：官方全新 WSL 原生集成（`wslAPI`）与菜单项（连接到 WSL、在本地重新打开）全汉化<br>• 全面汉化新增的独立 WSL 环境配置启动窗口 (`provisionSplash.js`)<br>• 全景汉化独立「Antigravity IDE」欢迎向导与环境初始化 (`wizardHtml.js`)<br>• 完整对齐 11 大核心 API 架构及 ConnectRPC 通信栈，无损零冲突挂载<br>• 全量覆盖 45+ 款 MCP 服务市场卡片、126 项官方技能卡片与智能体权限安全策略<br>• 严格遵循 `--unpack-dir` 规范防白屏打包（~4.8MB），经 120 项全量自动化测试验证 100% 通过<br>• 支持 Windows / macOS / Linux 全平台一键无损安装与一键秒级还原 | [📥 下载 v2.17.0 全平台补丁包](https://github.com/ATopos-svg/antigravity-chinese-community-pack/releases/tag/v2.17.0) | | **⭐ v2.15.1 (稳定版)** | Google Antigravity **v2.15.1** | 2026-09-22 | • 深度适配 Google 2026.09 最新推送的 2.15.1 正式版（内部版本 2.15.1.0）<br>• 全量汉化独立「Antigravity IDE」欢迎向导、环境初始化与下载提示<br>• 保持 2.15.1 原生 10 大 API 架构及 ConnectRPC 通信栈零冲突挂载<br>• 全量覆盖 45+ 款官方与社区 MCP 服务市场卡片及搜索栏<br>• 全量 126 项官方技能卡片与智能体权限安全策略深度汉化<br>• 经 120 项自动化测试全量 100% 验证通过<br>• 支持 Windows / macOS / Linux 全平台一键无损安装与一键秒级还原 | [📥 下载 v2.15.1 全平台补丁包](https://github.com/ATopos-svg/antigravity-chinese-community-pack/releases/tag/v2.15.1) | | **⭐ v2.15.0 (稳定版)** | Google Antigravity **v2.15.0** | 2026-09-19 | • 深度适配 Google 2026.09 推送的 2.15.0 正式版（内部版本 2.15.0.0）<br>• 重磅新增：全量 45+ 款官方与社区 MCP 服务市场卡片（GKE、AlloyDB、PostHog、Mobbin、Figma 等）及搜索栏深度汉化<br>• 全面汉化官方独立「Antigravity IDE」欢迎向导与错误提示横幅<br>• 汉化分屏菜单（Split Right/Down）、沙箱模式（Sandbox Mode）及删除会话弹窗<br>• 保持 2.15.0 原生 `ideAPI` 完整对接与 ConnectRPC 通信栈零冲突挂载<br>• 全量 126 项官方技能卡片与智能体权限安全策略深度汉化<br>• 支持 Windows / macOS / Linux 全平台一键无损安装与一键还原 | [📥 下载 v2.15.0 全平台补丁包](https://github.com/ATopos-svg/antigravity-chinese-community-pack/releases/tag/v2.15.0) | | **⭐ v2.14.0 (稳定版)** | Google Antigravity **v2.14.0** | 2026-09-16 | • 深度适配 Google 2026.09 推送的 2.14.0 正式版（内部版本 2.14.0.0）<br>• 升级官方独立「Antigravity IDE」欢迎向导为全简体中文<br>• 保持 2.14.0 原生 `ideAPI` 完整对接与 ConnectRPC 通信栈零冲突挂载<br>• 全量 126 项官方技能卡片与智能体权限安全策略深度汉化<br>• 支持 Windows / macOS / Linux 全平台一键无损安装与一键还原 | [📥 下载 v2.14.0 全平台补丁包](https://github.com/ATopos-svg/antigravity-chinese-community-pack/releases/tag/v2.14.0) | | **⭐ v2.12.2 (稳定版)** | Google Antigravity **v2.12.2** | 2026-09-05 | • 极速适配 Google 2026.09 推送的 2.12.2 正式版（内部版本 2.12.2.0）<br>• 适配官方重磅「Antigravity IDE」分拆与引导向导，提供完整中文提示<br>• 保留 2.12.2 原生 `ideAPI` 接口，零冲突稳定挂载<br>• 汉化全新防休眠硬件设置（Keep Computer Awake）与 `permissioned-github` 新技能<br>• 支持 Windows / macOS / Linux 全平台一键安装 | [📥 下载 v2.12.2 全平台补丁包](https://github.com/ATopos-svg/antigravity-chinese-community-pack/releases/tag/v2.12.2) | | **⭐ v2.11.0 (里程碑)** | Google Antigravity **v2.11.0** | 2026-08-27 | • 跟进 2.11.0 正式版，率先实现全平台 Windows / macOS / Linux 交付闭环<br>• 汉化高级设置中“自动检查更新”开关与长句描述<br>• 命令权限确认弹窗动态正则全汉化 | [📥 下载 v2.11.0 全平台补丁包](https://github.com/ATopos-svg/antigravity-chinese-community-pack/releases/tag/v2.11.0) | | **⭐ v4.2.0 (经典版)** | Google Antigravity **v2.10.0** | 2026-08-26 | • 首次攻克老补丁在 2.10.0 上的“卡死在 Loading 白屏”死锁问题<br>• 首创 Preload 单点沙箱隔离与 1 秒温和延迟技术<br>• 全量地毯式汉化 125 项官方技能说明 | [📥 下载 v2.10.0 补丁包](https://github.com/ATopos-svg/antigravity-chinese-community-pack/releases/tag/v4.2.0) | --- ## 🌟 方案总览：双模式自由选择 本项目提供两种灵活的中文本地化方式，开发者可按需选用： | 模式 | 核心能力 | 适用场景 | 侵入性 | | :--- | :--- | :--- | :--- | | **🚀 模式 A：客户端 UI 完整汉化补丁（推荐）** | **整个客户端界面 100% 汉化**：涵盖菜单栏、快捷命令面板 (`Ctrl+Shift+P`)、全部 125 个官方技能卡片、设置中心、主题预设等。 | 想要彻底告别纯英文界面，获得母语级 IDE 体验的开发者。 | **低**（仅注入 `preload.js` 安全沙箱，不改官方主进程，可一键无损还原） | | **💬 模式 B：智能体中文 Prompt & 规则包** | **规范智能体的交流语言与产物**：引导 AI 默认使用简体中文对话，并输出中文实施计划 (`implementation_plan.md`) 与回顾文档。 | 仅希望智能体说中文，不想触碰任何客户端文件的开发者。 | **零侵入**（纯 Markdown 提示词与技能指南配置） | --- ## ⚡ 模式 A：客户端 UI 极速安装（Windows / macOS / Linux 全平台支持） 由于核心基于 Electron Preload 沙箱拦截机制，补丁核心文件 `app.asar.chinese` 在 **Windows、macOS 和 Linux 三大操作系统上完全通用**！安装包内已为各系统内置了一键安装与还原脚本： ### 📥 1. 获取预打包文件 1. 前往本仓库的 **[Releases 发布页面](https://github.com/ATopos-svg/antigravity-chinese-community-pack/releases)**； 2. 下载最新版通用压缩包 **`Antigravity-Chinese-Pack-v2.18.1.zip`** 并解压。 --- ### 💻 2. 各操作系统一键安装与还原指南 #### 🪟 Windows 用户： * **一键安装**：直接双击运行 **《一键安装汉化.bat》**； * **一键还原**：随时双击运行 **《一键恢复官方英文.bat》** 秒级还原。 #### 🍎 macOS (苹果电脑) 用户： * **一键安装**：解压后直接在访达 (Finder) 中双击运行 **《一键安装汉化-macOS.command》**； > 💡 *脚本已内置自动解除 Gatekeeper 隔离属性（`xattr -cr`）并执行本地重签名（`codesign`），彻底杜绝 macOS 弹窗提示“应用已损坏，无法打开”！* * **一键还原**：直接双击运行 **《一键恢复官方英文-macOS.command》**； * **命令行备用方式**： ```bash chmod +x 一键安装汉化-macOS.command && ./一键安装汉化-macOS.command ``` #### 🐧 Linux 用户： * **一键安装**：在解压目录下打开终端执行： ```bash bash 一键安装汉化-Linux.sh ``` * **一键还原**：在终端执行： ```bash bash 一键恢复官方英文-Linux.sh ``` --- ## 🔬 核心技术原理与架构剖析 (Technical Architecture) 为了让更多开发者理解该方案的可靠性，我们对底层技术做全面公开拆解。 ### 1. 为什么不能直接修改官方源码？（前车之鉴） Antigravity 2.10.0+ 采用了深度定制的 Electron 架构。早期很多汉化补丁在最新版上会导致**永久卡死在“Loading...”白屏界面**，根本原因是： - 官方在 2.10.0 重构了加载遮罩层（Loading Overlay）与主窗口创建的 Promise 握手时序； - 若盲目篡改 `loadingOverlay.js`、`utils.js` 或主进程入口，会直接截断官方的关闭信号，引发**水合死锁**。 ### 2. 我们的改良架构：Preload 单点隔离沙箱 ```mermaid flowchart TD A[启动 Antigravity.exe] --> B[加载 app.asar / 官方底层 100% 原装] B --> C[React UI 完整水合加载完成 / 避开死锁风险] C --> D[1秒后激活 Preload 中文本地化引擎] D --> E[DOM 智能过滤与双向遍历] D --> F[MutationObserver 动态监听新元素] F -->|用户呼出命令面板/打开设置/滚动技能列表| E E --> G[渲染纯正简体中文界面] ``` #### 关键技术突破： 1. **单点安全注入，零破坏性**： - 官方全部核心文件（`main.js`、`utils.js`、`loadingOverlay.js`）**100% 保持官方原版未动**； - 汉化逻辑完全收敛在 Electron 官方设计的安全隔离区 `preload.js` 中。 2. **温和延迟挂载（Gentle Delayed Sweep）**： - 挂载在 `window.addEventListener('load')` 之后 1 秒执行，先让 React 状态树平稳渲染，彻底告别加载界面死锁与白屏。 3. **精准代码避让（Code Block Shielding）**： - 汉化引擎严格隔离 `<code>`、`<pre>`、`<textarea>` 以及 Monaco 编辑器核心区（`monaco-editor`、`token`、`hljs`），**绝对不会误翻译任何代码、终端输出或变量名**。 4. **长词优先倒序排序（Longest-Match Priority）**： - 词库在初始化时按英文字符长度降序排列（`PHRASES.sort((a, b) => b[0].length - a[0].length)`），确保像 `Open Keyboard Shortcuts` 这样的复合短语被整体翻译为“打开快捷键指南”，杜绝 `Open Keyboard 快捷键` 等半中半英的截断瑕疵。 5. **Shadow DOM 穿透与 MutationObserver 毫秒级监听**： - 无论何时按下 `Ctrl+Shift+P` 呼出命令面板、打开多层折叠设置、或者动态滚动 125 项技能卡片，监听器均能毫秒级捕获并无缝渲染为中文。 --- ## 📋 深度汉化覆盖清单 - **🛠️ 快捷命令面板 (Command Palette)**： - `Ctrl+Shift+P` 唤出的所有高频系统指令全中文对齐（折叠/展开文件夹、新建终端、拆分终端、切换侧边栏、打开快捷键等）。 - **🧭 顶部系统主菜单栏 (Menu Bar)**： - 【文件】（新建项目、命令面板、新建窗口等）、【视图】（放大、缩小、重置缩放）、【窗口】（最小化、最大化、关闭）。 - **🧩 全量 125 项官方与插件技能卡片 (Skills & Customizations)**： - 覆盖 Android CLI、Chrome DevTools 调试套件、BigQuery 数据工程套件、Firebase 全栈、Flutter/Dart 开发套件、Gemini API、Google Maps、科学计算套件 (Science) 以及 HyperFrames 动效引擎。 - 连同卡片内部的所有详细使用场景说明（`Use when...`、`STOP AND VERIFY` 防误删说明）全盘地毯式精译。 - **🔌 MCP 服务市场与扩展管理 (MCP Server Marketplace)**： - 搜索栏（`按名称搜索 MCP 服务`）、已配置/可用/已安装服务列表。 - 全量 45+ 款核心 MCP 插件卡片与使用场景深度汉化（涵盖 Cloud Audit Manager、Mobbin、GitLab Orbit、Wiz、GKE、Firebase、BigQuery、AlloyDB、Spanner、Oracle、Figma Dev Mode、GitHub、PostHog、Stripe、Notion、Linear、Airweave、SonarQube、Netlify、Sequential Thinking、ArizeTracing 等）。 - **⚙️ 全局设置中心 (Settings)**： - 常规设置、应用偏好、主题外观（预设浅色/深色/Solarized/One 风格）、模型配置、浏览器子代理权限与沙箱外命令执行规则。 --- ## 💬 模式 B：智能体中文规则与指南扩展 若您只希望规范 Agent 的提示词与回复语言，可在本地工作区按以下结构引入： ```text .agents/plugins/antigravity-chinese-community-pack/ ├── plugin.json # 插件元数据 ├── rules/ # 中文行为与模版规则 │ ├── chinese-interaction.md # 对话语言原则与官方中文术语对照表 │ └── chinese-artifacts.md # 中文 implementation_plan.md 与 walkthrough.md 规范 └── skills/ # 中文指南技能 └── antigravity-zh-guide/ # 界面功能、快捷键与常用斜杠命令指南 ``` --- ## 🤝 参与贡献与致谢 本项目由社区开发者共同发起与打磨。如果您在使用过程中发现了遗漏的英文界面，欢迎通过以下方式参与： 1. 提交 **[Issues](https://github.com/ATopos-svg/antigravity-chinese-community-pack/issues)** 并附带截图； 2. 提交 **Pull Request** 补充更地道的专业术语； 3. 给项目点一个 ⭐️ **Star**，让更多使用 Antigravity 的华语开发者受益！ --- ## 📄 开源许可证 本项目基于 [MIT License](LICENSE) 许可协议开源。