Google Antigravity 中文汉化 (简体中文)

为 VS Code / Cursor / Windsurf 扩展 Google Antigravity 提供全方位深度简体中文汉化。

🌟 特性与汉化覆盖范围

本项目内置 800+ 条精准汉化规则与动态正则转换，全面覆盖 Antigravity 的各个交互界面：

模块	汉化覆盖内容	汉化机制
扩展外壳	命令面板标题、侧边栏视图名、工件/设置查看器名、加载页文案	静态字符串替换（修改前自动 `.bak` 备份）
对话交互	聊天输入框占位符、操作按钮（接受/拒绝/运行/停止/派生/撤销）、思考步骤与工件展示、上下文菜单（`@提及` / `操作` / `屏幕录制` / `媒体`）	本地反向代理拦截注入运行时脚本与实时 DOM 替换
设置中心	常规设置：会话历史、知识库、自动打开已编辑文件、自动修复 Lint 报错、提示音、防止休眠等外观设置：主题切换、字体系列、字号、窗口宽度（窄/宽/默认）、配色方案模型与用量：方案展示（Pro/Ultra）、AI 积分使用策略、Gemini / Claude / GPT 模型额度、每周/5小时额度刷新倒计时正则匹配、Token 用量百分比浏览器设置：浏览器子代理调用说明、JavaScript 执行审批策略自定义扩展：全局技能、规则库、MCP 扩展服务器、自定义子代理、生命周期钩子	运行时 SPA 深度多节点匹配与正则动态转换
安全与权限	安全预设模式（请求评审 / 默认 / 审查模式 / 极速模式 / 整机访问）、沙箱隔离策略、终端命令与沙箱外命令执行规则、非工作区文件读写、URL 访问规则、GitHub 访问策略	预设选择器与权限规则字典
项目与工作区	项目管理、文件夹列表、工作树 (Worktree) 状态检测、工作区不匹配切换提示、对话排序（最近更新/添加日期/字母排序）与分组、危险区域项目删除	项目管理视图与多分支状态
登录与引导	身份验证拦截提示、欢迎向导、登录方式（Google 账号 / Google Cloud / 企业账号 / 高级 SSO）、向导步骤导航（上一步 / 下一步）	认证全流程交互视图

🚀 安装指南

方式一：从 VSIX 离线包安装（推荐）

在 GitHub Releases 页面下载最新的 google-antigravity-zh-cn-1.1.1.vsix；
打开 VS Code / Cursor / Windsurf，按快捷键 Ctrl+Shift+P（macOS 为 Cmd+Shift+P）；
输入并选择 Extensions: Install from VSIX...（从 VSIX 安装...），选中下载的 .vsix 文件；

也可以直接在终端执行：

code --install-extension google-antigravity-zh-cn-1.1.1.vsix

方式二：从源码构建与安装

git clone https://github.com/naruse-love/antigravity-zh-cn.git
cd antigravity-zh-cn
# 构建 VSIX 包
python3 build_vsix.py   # 或使用 vsce package
code --install-extension google-antigravity-zh-cn-1.1.1.vsix

💡 使用说明

安装扩展后，按 Ctrl+Shift+P 打开命令面板，执行 Antigravity 汉化: 应用汉化；
按 Ctrl+Shift+P 执行 Developer: Reload Window（重新加载窗口）；
打开 Antigravity 侧边栏，界面即呈现完整简体中文！

可用命令

命令名称	命令 ID	说明
Antigravity 汉化: 应用汉化	`antigravityZhCn.apply`	对 Antigravity 扩展打补丁并启动汉化代理
Antigravity 汉化: 还原原版	`antigravityZhCn.restore`	从 `.bak` 备份恢复原始英文文件
Antigravity 汉化: 重新加载汉化	`antigravityZhCn.reapply`	重新载入词典并重启代理服务
Antigravity 汉化: 打开设置	`antigravityZhCn.openConfig`	调整汉化插件的各项配置参数

🛠️ 技术实现原理

Google Antigravity 界面由本地独立进程（agy --hub --hub-port=<port>）提供 HTTP Web 服务，前端内嵌于 VS Code Webview 的 iframe 中。

本插件采用四层无损增强架构实现汉化：

┌─ VS Code Webview ────────────────────────────────────────┐
│  <iframe src="http://127.0.0.1:27912/?__agzh_hub=N">     │
│      │                                                    │
│      ▼  (Patcher 动态改写 fullUrlString，将 Hub 端口作为参数) │
│  本地反向代理服务 (:27912)                                  │
│      │  剥离参数 → 透明转发至 127.0.0.1:N (agy hub)          │
│      │  拦截 HTML 响应并在 </body> 前注入 inject.js         │
│      ▼                                                    │
│  inject.js (MutationObserver + panel.json 词典动态替换 DOM)│
└──────────────────────────────────────────────────────────┘

外壳补丁（Patcher）：安全备份并替换扩展 extension.js 和 package.json 中的命令与展示字符串；
端口路由（Routing）：将 iframe 请求无缝定向至本地代理，同时保留原通信参数；
反向代理（Proxy）：支持 WebSocket、SSE 流式数据透传，动态注入汉化脚本与最新词典；
运行时翻译（DOM Observer）：通过高性能防抖与 MutationObserver 监听 DOM 树变动，支持精确匹配、多子节点拼合与复杂正则规则替换。

⚙️ 自定义翻译词典

外壳文案：位于 translations/built-in.json
界面词典：位于 translations/panel.json

词典规则支持精确匹配与正则表达式：

{ "original": "Settings", "chinese": "设置" }
{ "original": "^Updated (\\d+) hours? ago$", "chinese": "更新于 $1 小时前", "regex": true, "flags": "" }

修改词典保存后，在命令面板执行 Antigravity 汉化: 重新加载汉化 即可即时热更新生效。

❓ 常见问题排查

现象	原因与解决办法
界面部分文字未汉化	执行 `Developer: Reload Window` 重新加载窗口；若有遗漏词条，欢迎提 Issue 补充
面板提示连接失败或 404	执行 `Antigravity 汉化: 应用汉化` 重新打补丁并确保 Antigravity 服务正常运行
端口冲突	在设置中修改 `antigravityZhCn.proxyPort`（默认 27912），重新应用后重载窗口
Antigravity 扩展更新后汉化失效	插件内置自动检测机制，会在启动时自动重新打补丁，亦可手动执行 `应用汉化`

📄 开源许可证

本项目基于 GPL-3.0 License 开源。