Antigravity 中文汉化引擎（Windows / macOS / Linux）
支持系统：Windows / macOS / Linux（含 Ubuntu 等常见发行版）
> 语言支持：简体中文
> 汉化版本：v2.28.2
> 匹配版本：Antigravity v2.28.2
> 最近更新：2026-10-30
> 核心运行环境： Node.js
> 汉化范围：当前 v2.28.2 词典面向 Antigravity v2.28.2，覆盖主界面、顶部系统菜单与任务栏菜单、加载页、设置面板、新手引导与登录流程、对话及自动化/计划任务管理、个性化定制与插件市场、MCP 服务器列表，以及各类动态状态、提示和操作反馈。少量内容可能因客户端异步渲染、第三方嵌入或官方后续新增界面而暂未覆盖。
> 注入原理：通过 ASAR 还原与重包，安全注入 preload.js 动态翻译机制，macOS 端自动完成隔离属性清除与由内而外应用自签名，绝不修改核心二进制，一键安装与完美还原。
[!IMPORTANT]
内容隔离与匹配机制说明（开发者必读）：
> - 全方位内容禁区隔离：
- 会话与思考流隔离：默认跳过用户消息（data-testid="user-input-step"，仅放行Commented on:等固定 UI 标签）、模型思考正文（Thought 流式块）、散文段落及工具活动折叠块（如Explored/Edited X files、Ran X commands），状态区仅翻译顶层进度与耗时（如工作中、正在压缩、工作了 XX 分钟）。
- 文件树、路径与代码/图标隔离：通过WeakMap缓存与整树剪枝（零子树递归），直接跳过工作区文件树（role="tree"/treeitem）、辅助面板路径面包屑（File path breadcrumbs）、动态文件/目录标签页、变更文件列表路径、Monaco 编辑器、终端及图标字体节点（.google-symbols/.codicon等），确保原文件名、目录路径与图标绝不被误译。
- 自定义禁区：任意容器添加 data-ag-localization-skip 属性即可显式禁用其子树翻译。
- 核心匹配与性能机制：
- 1:1 匹配与独立控件守卫：文本归一化后与词典 1:1 匹配；短词与单字词条受独立控件守卫（isIsolatedUiControlLabel）约束，仅在独立按钮、菜单、表头或表单控件上生效；长度 > 20 的具体长句支持带单词边界保护的子串替换。
- 零阻塞遍历：全链路采用有界文本提取（getBoundedTextContent），仅作用于受控 UI 渲染节点，绝不改写底层存储或请求数据；界面结构更新时请按AGENTS.md核对边界。
📸 汉化效果展示
以下是部分功能板块的实际汉化效果展示，涵盖登录引导页、主编辑器界面与详细设置面板：
1. 欢迎页与登录新手引导
2. 主编辑器界面与菜单
3. 详细参数设置面板
📂 项目文件结构
双击安装中文汉化.bat：Windows 一键汉化执行入口。双击卸载还原官方英文.bat：Windows 使用备份还原官方英文入口。双击安装中文汉化.command：macOS Finder 双击一键汉化执行入口。双击卸载还原官方英文.command：macOS Finder 双击还原官方英文入口。install.sh：macOS / Linux 一键汉化终端执行入口。uninstall.sh：macOS / Linux 使用备份还原官方英文终端执行入口。localization_engine.js：核心汉化逻辑，跨平台自动适配，负责 app.asar 的解包、代码注入、macOS 隔离修复与自签名及重新打包。dicts/：汉化字典文件夹，内含按模块分类的 JSON 对照翻译字典；当前版本的核心词典为dicts/v2.28.2.json。.agents/skills/sync-marketplace-plugins/：官方插件市场同步与审计技能，内置直连官方云端实时元数据与内存零落盘技术的全自动比对审计工具。AGENTS.md：项目通用规则。支持AGENTS.md的 AI 会将其作为项目上下文，按其中的汉化边界与动态文案处理要求工作。.gitattributes：Git 属性规则。它会保护 Windows.bat文件的 GBK/CRLF 字节内容与 macOS.command文件的 LF 换行符，避免 Git 的自动文本转换破坏安装或卸载脚本。
🚀 极速使用指南
1. 获取汉化包代码（二选一）
- 方法 A：直接下载 ZIP 压缩包（最便捷 📦）
Code 按钮。
2. 在下拉菜单中选择 Download ZIP 并下载。
3. 将下载好的压缩包解压到您电脑本地的任意目录（例如您的 Downloads 文件夹）。
- 方法 B：通过 Git 命令行克隆（开发者推荐 💻）
git clone https://github.com/Silas-02/antigravity-desktop-cn.git
cd antigravity-desktop-cn2. 一键安装汉化
进入解压或克隆的文件夹，按您的操作系统运行对应脚本（脚本会自动关闭正在运行的软件并注入汉化）：
| 平台 | 安装入口 | 权限与提示 |
| :--- | :--- | :--- |
| Windows | 双击运行 双击安装中文汉化.bat | 仅在权限受限时右键选择“以管理员身份运行” |
| macOS | 双击 双击安装中文汉化.command 或终端运行 ./install.sh | 仅在权限不足时使用 sudo（首次拦截详见 FAQ 3） |
| Linux | 终端运行 ./install.sh | 用户目录免提权；系统目录会自动请求提权或直接加 sudo |
- 品牌显示：运行中可按提示选择左上角品牌显示方式（默认显示英文
Antigravity或不显示）。 - 指定路径：如自动定位失败，可手动指定路径：
./install.sh --install-dir "/path/to/Antigravity"。 - 运行完成后，重新启动 Antigravity 即可使用汉化界面。
3. 一键卸载还原
如需恢复官方原版英文，在当前文件夹运行对应的卸载脚本即可无痕秒级还原：
| 平台 | 卸载入口 | 说明 |
| :--- | :--- | :--- |
| Windows | 双击运行 双击卸载还原官方英文.bat | 权限不足时右键“以管理员身份运行” |
| macOS | 双击 双击卸载还原官方英文.command 或终端运行 ./uninstall.sh | 支持追加 --install-dir 手动路径 |
| Linux | 终端运行 ./uninstall.sh | 系统目录直接使用 sudo ./uninstall.sh |
🛠️ 汉化原理说明
本引擎采用 原生 ASAR 内存原生注入模式，深度适配 Antigravity 2.0+ 的 Electron 架构：
- 自动释放锁：脚本运行前会自动探测并安全关闭 Antigravity 进程，防止文件占用锁定。
- 安全备份：首次运行时，会在软件目录自动创建原始
app.asar.bak文件，确保随时可无损还原。 - 原生注入定向修补：
npm 或 npx；
- 完整继承并保留官方 --unpack 属性，杜绝将外部 MCP/二进制依赖塞回 ASAR，包体积始终维持在官方原本的轻量水准。
- 精确目标注入：
preload.js：采用 WeakMap 记录与 Shadow DOM 穿透，启动高效的 MutationObserver 引擎，动态监测并将渲染层文本翻译为中文。
- 注入 menu.js：在确认的插入点补充系统级标题栏与原生菜单（含 macOS 专有菜单）译文。
- 注入 tray.js：汉化托盘与右键通知状态菜单。
- 注入 updater.js：汉化固定的更新检查结果弹窗。
- 注入 wsl.js / provisionSplash.js / main.js：汉化 WSL 引导遮罩与错误弹窗。
- macOS 隔离修复与自签名：还原与注入后，自动递归清除
com.apple.quarantine隔离属性，并采用 Inside-Out 模式对框架与 App 执行 ad-hoc 自签名。
💡 如何通过 AI 助手自动补充或修改汉化？
若在使用中遇到漏译的文案，直接发送截图或文字描述即可让 AI 助手协助更新词库：
[!TIP]
- 推荐做法：在 Antigravity 中点击 “打开文件夹” 将本汉化包目录作为工作区打开后与 AI 对话，AI 会自动读取 AGENTS.md 规范并精准定位词典。
- 免开项目：若在其他项目工作区中提问，请在提示词中附带汉化包路径，例如：“我的汉化包在~/Downloads/antigravity-desktop-cn，请先阅读其AGENTS.md再根据截图补充词典。”
📋 常用提示词（Prompt）模板
1. 方式一：直接在聊天中发送截图（推荐 📸）
如果您不方便打字，可以直接将未汉化干净的界面截图粘贴发送给 AI，并附带以下指令：
"请先阅读项目中的 AGENTS.md，识别截图中属于 Antigravity 固定界面的漏译文本，并按项目规则补充到词典或引擎中；不要翻译用户内容、路径、命令或诊断正文。"
(AI 应先确认英文来源和界面语境，再选择固定词条或动态规则。)
2. 方式二：直接在聊天中发送文字描述（极速 ✍️）
如果您只想修改或增加某一个特定词汇，可以直接发送文字描述给 AI：
"帮我把漏译的英文 'Allow agent to view and edit files outside of the current workspace automatically' 汉化为 '允许智能体自动查看并编辑当前工作区之外的文件'。"
(AI 仍应先搜索现有词典并确认该文本是固定界面词条，再决定修改位置。)
3. 方式三：一键同步与审计官方插件市场（Marketplace 🧩）
当 Antigravity 客户端更新版本后，官方插件市场可能会新增插件、更新建议提示词或下架旧插件。您可以直接向 AI 发送指令进行全自动比对审计：
"请使用 sync-marketplace-plugins 技能比对官方插件市场元数据，检查是否有新上架的插件、文案变动或下架插件，并输出比对报告。"
AI 会自动激活内置技能并调用原生 Node.js 工具，以官方权威云端插件数据为基准比对 dicts/marketplace_plugins.json，并采用流式内存零落盘技术精准提取技能详情，呈现结构化清单并征求您的确认后再执行汉化或清理。
📝 自定义与高级开发指南 (供极客使用)
点击展开查看高级开发与词库维护指南
根据界面文案的呈现机制，汉化分为静态固定文本与动态/原生规则两类维护途径：
1. 静态固定词条（修改 dicts/*.json）
对于界面上不含变量的固定标签、按钮文字、弹窗标题等，直接维护 dicts/ 下的 JSON 文件：
v2.28.2.json：当前版本 v2.28.2 专用词典，适配官方版本迭代的独有界面。common.json：通用基础词汇、侧边栏概览、登录与引导流程、通用按钮与权限弹窗。menu_nav.json：系统菜单、顶部导航与状态栏菜单。page_agents.json：智能体、任务及会话管理相关页面。page_mcp_knowledge.json：MCP 服务器、知识库与扩展配置页面。marketplace_plugins.json：官方插件市场、插件详情与建议提示词。page_settings.json：详细参数设置面板与二级权限菜单。page_workspaces.json：工作区与项目管理相关页面。
"Original English Text": "您的中文翻译"2. 动态文案与复杂 DOM 规则（修改 localization_engine.js）
如果界面文案包含动态数字、时间、路径、分支，或者属于React 碎片化分拆与原生层组件，修改词典将无法生效，须在 localization_engine.js 中编写代码规则：
- 动态变量正则捕获：
5m ago、Push 2 commits to origin 等）。
- 实现：在引擎对应的动态转换函数（如 getRelativeTimeTranslation、getVersionControlUiTranslation、getDynamicProductUiTranslation 等）中添加具有严格锚定（^...$）和捕获组的正则表达式，返回带参数插值的翻译字符串。
- 属性与结构化 DOM 拦截：
placeholder）、悬停提示（title）、无障碍标签（aria-label）或跨子节点渲染的复合文本。
- 实现：在引擎属性监听列表或特化节点处理逻辑中注册，禁止破坏节点原有的 React 事件挂载与 DOM 结构。
- 原生层与独立窗口：
menu.js）、系统托盘（tray.js）及更新检查（updater.js）。
- 实现：修改引擎中对应的原生代码注入模板。
3. 插件市场（Marketplace）自动审计与同步
项目内置了直连官方云端权威接口与流式内存零落盘技术的全自动比对审计工具：
# 1. 运行官方插件市场元数据与字典比对（默认并发直连官方云端双专区权威接口，流式内存零落盘审计）
node .agents/skills/sync-marketplace-plugins/scripts/diff_marketplace_plugins.js
2. 离线环境或本地构建测试时，指定读取本地缓存
node .agents/skills/sync-marketplace-plugins/scripts/diff_marketplace_plugins.js --local
3. 以 JSON 格式输出分析结果
node .agents/skills/sync-marketplace-plugins/scripts/diff_marketplace_plugins.js --json- 权威数据源与零落盘设计：
SKILL.md 与 README.md，全程零磁盘落盘、零临时文件，保障与官方最新发布版本绝对一致。
常见问题解答 (FAQ)
1）提示“未检测到 Node.js 环境”
- 原因：汉化引擎基于 Node.js 运行。
- 说明：引擎为纯原生标准库实现，仅需系统具备最基础的
node运行时即可。 - 解决：安装 Node.js（LTS 版本即可）：
# Windows
# 可直接访问 https://nodejs.org 下载安装包，或通过 winget 安装：
winget install OpenJS.NodeJS.LTS
# macOS (使用 Homebrew)
brew install node
# Ubuntu/Debian
sudo apt update && sudo apt install -y nodejs
# 或使用 NodeSource 安装最新 LTS
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs
2）提示"权限不足"或"找不到命令"
- 解决：
.bat 文件；只有出现权限不足时，才右键选择 “以管理员身份运行”。
- macOS：直接双击对应 .command 或运行 ./install.sh / ./uninstall.sh；只有安装在系统目录（如 /Applications/）且提示权限不足时，才使用 sudo ./install.sh 或 sudo ./uninstall.sh。
- Linux：
- 权限智能自适应：用户目录安装直接运行 ./install.sh 或 ./uninstall.sh，完全无需管理员权限；若目标位于系统目录，脚本会在执行前自动检测并请求 sudo 提权，亦可直接以 sudo ./install.sh 或 sudo ./uninstall.sh 一步运行，无需反复切换执行方式。
- 脚本执行权限自愈与环境保留：仓库脚本已默认固化可执行权限（chmod +x）；若因解压或环境原因丢失执行位，脚本会在运行时自动修复并固化权限，杜绝因权限不足而必须手动键入 bash ./install.sh；同时在提权时会自动保留并向下传递 NVM/FNM 等用户级 Node.js 运行时路径。
3）macOS 双击 .command 提示“Apple无法验证...”或“移到废纸篓”？
- 原因排查：
com.apple.quarantine（网络隔离标记）。
2. 脚本未公证：.command 本质是 Bash Shell 脚本，并非经过 Apple 官方付费开发者证书签名和公证（Notarized）的二进制程序。macOS 安全机制（Gatekeeper）在检测到带有网络隔离标记且没有官方公证凭证的脚本被双击时，会默认拦截并弹出提示：“Apple无法验证‘双击安装中文汉化.command’是否包含可能危害Mac安全或泄漏隐私的恶意软件”，且默认弹窗中只提供“完成”和“移到废纸篓”。
- 解决方案（任选其一即可）：
双击安装中文汉化.command（或卸载还原脚本）。
2. 按住键盘上的 Control 键不放，点击该文件（或直接鼠标右键点击）。
3. 在弹出的右键菜单中，点击 “打开”。
4. 此时系统弹出的提示框中，除了“完成”和“废纸篓”，还会多出一个 “打开” 按钮。
5. 点击 “打开” 即可正常启动终端执行，系统之后也会记住该操作，不再重复拦截。
- 方案 2：在系统设置中允许放行
1. 打开 macOS 的 “系统设置”（System Settings）。
2. 进入 “隐私与安全性”（Privacy & Security），向下滚动找到“安全性”区域。
3. 找到提示：“已阻止使用‘双击安装中文汉化.command’，因为来自身份不明的开发者”，点击旁边的 “仍要打开” 即可。
- 方案 3：终端一键清除隔离属性并赋予权限（彻底解决）
打开 Mac 的“终端（Terminal）”，进入解压后的汉化包文件夹，执行以下命令彻底清除网络隔离标记：
# 1. 切换到解压目录 (或者直接在终端输入 cd 后，将 Finder 中的该文件夹拖入终端)
cd /path/to/antigravity-desktop-cn
# 2. 递归移除当前目录下所有文件的隔离标记
xattr -d -r com.apple.quarantine .
# 3. 确保脚本拥有可执行权限
chmod +x .command .sh
双击安装中文汉化.command 运行。
- 方案 4：直接使用终端运行 install.sh（项目官方支持方式）
打开终端进入解压目录后，直接在终端中运行：
./install.shsudo ./install.sh）。
4）软件官方更新后，汉化失效了怎么办？
- 软件升级时，官方会覆盖
app.asar文件。重新运行一次安装脚本注入即可（Windows 双击双击安装中文汉化.bat，macOS 双击双击安装中文汉化.command或运行./install.sh，Linux 运行./install.sh）。
🤝 致谢与项目关系
本项目 Fork 自 qqxpee/antigravity2-cn，衷心感谢原作者 qqxpee 的开源贡献与开拓性工作！
在此基础上，为了提升汉化长期维护性、系统兼容性与渲染安全边界，本项目进行了深度的工程化重构与迭代，主要特性包括：
- 跨平台原生支持与脚本体验重构：
install.sh / .bat / .command）与无损还原（uninstall.sh / .bat / .command）方案。
- 引入编码保护（GBK/CRLF 隔离）、macOS 隔离属性修复与由内而外应用自签名、以及权限自适应机制，杜绝 Windows 控制台乱码、macOS 签名失效闪退与 Linux 权限异常。
- 严格的内容隔离与高安全渲染保护边界：
data-testid="user-input-step"、data-ag-localization-skip、模型思考正文（Thought 流）及会话工具活动折叠区禁区机制，坚决不翻译、不篡改用户提示词正文、模型思考过程、代码块与终端输出，防止误译与数据污染。
- 分级精准匹配与零阻塞遍历：结合独立 UI 控件边界守卫（isIsolatedUiControlLabel）、带单词边界保护的长句替换规则，以及 WeakMap 祖先缓存与 Monaco/代码行整树剪枝，杜绝短词误伤非界面文本并保障大型设置面板与代码预览流畅无卡顿。
- 原生极速注入架构（零网络依赖与秒级注入）：
npx -y @electron/asar 联网下载并全量解包的方式，内置轻量原生 ASAR 读写协议，100% 离线运行，免装 npm。
- 零临时文件与无感部署：仅对目标脚本进行内存流式修补，无磁盘小碎文件生成，从根源上消除 Windows Defender 等安全软件的拦截与卡顿。
- 严格体积守恒：精准继承官方 --unpack 机制，防止将外部二进制及 MCP 工具重复打包进 ASAR，避免体积膨胀。
- 官方插件市场与技能体系自动化同步与审计：
dicts/marketplace_plugins.json，全量覆盖 Google 官方专区与官方合作伙伴专区插件。
- 云端直连与内存零落盘比对架构：默认直连官方云端权威接口实时拉取最新插件清单，针对 Google专区插件采用流式内存零落盘解压技术。
- 技能选择器安全有界绑定：在斜杠命令与技能选择器中提供中文友好展示，防止底层路径或技术标识符被意外汉化污染。