antigravity-suite
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Fail
- child_process — Shell command execution capability in asar-engine.js
- exec() — Shell command execution in asar-engine.js
- os.homedir — User home directory access in asar-engine.js
- process.env — Environment variable access in asar-engine.js
- fs module — File system access in asar-engine.js
- network request — Outbound network request in asar-engine.js
- child_process — Shell command execution capability in cli.js
- spawnSync — Synchronous process spawning in cli.js
- fs.rmSync — Destructive file system operation in cli.js
- process.env — Environment variable access in cli.js
- fs module — File system access in cli.js
- spawnSync — Synchronous process spawning in install.js
- fs.rmSync — Destructive file system operation in install.js
- os.homedir — User home directory access in install.js
- process.env — Environment variable access in install.js
- fs module — File system access in install.js
- child_process — Shell command execution capability in live-host.js
- fs.rmSync — Destructive file system operation in live-host.js
- os.homedir — User home directory access in live-host.js
- process.env — Environment variable access in live-host.js
- fs module — File system access in live-host.js
- network request — Outbound network request in live-host.js
- os.homedir — User home directory access in local-api.js
- fs module — File system access in local-api.js
- child_process — Shell command execution capability in meter-cli-launcher.js
- fs.rmSync — Destructive file system operation in meter-cli-launcher.js
- os.homedir — User home directory access in meter-cli-launcher.js
- process.env — Environment variable access in meter-cli-launcher.js
- fs module — File system access in meter-cli-launcher.js
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Google Antigravity 桌面端(macOS 免改包)全能增强与手机极速遥控套件:内置 Tailscale/局域网极速 PWA 手机遥控(切换模型/权限、传图、语音、右滑切会话),以及桌面端上下文/5h与每周配额监控、英文思考中译(零 Token)、行内编辑、Tab 补全与高危命令红框预警。
Antigravity Suite
专为 Google Antigravity 桌面端(macOS)打造的一站式免改包体验增强套件
在不改动官方安装包的前提下,将**📱 手机远程操作 PWA(一码三用融合配对 · Wi-Fi / Tailscale / Bonjour 自动切网)、⚙️ 统一设置中心(多终端 CLI 启动 / 主题调色 / 套餐订阅 / 中英实时热切)、上下文与双池配额看板、全中文界面与零 Token 思考中译、右侧文件行内编辑、下一步 Tab 补全以及高危命令红框预警**直接注入桌面端,开箱即用:
- 零修改官方包:不修改
Antigravity.app原文件,保留 macOS 系统签名,官方升级不受影响 - 随客户端自启:打开 Antigravity 自动挂载增强界面,关闭客户端自动休眠,无需手动启动
- 秒级无痕还原:随时执行
ag-context-meter stop,即可立即卸下全部增强组件恢复原版
一、装上它,能帮你解决哪 6 个日常痛点?
- 📱 手机远程操作 PWA(一码三用融合配对 · 告别官方远程卡顿、杀后台与键盘遮挡)
- 官方 Remote 依赖 Google 云端中继,在手机 Safari 中常见加载慢、切后台断连与键盘遮挡输入框的问题。
- 一码三用融合配对(Wi-Fi / Tailscale / Bonjour):点击桌面端右上角工具栏中的
「📱 远程」(弹窗标题「手机远程操作配对」,或终端运行ag-context-meter remote),生成单枚高清融合二维码与单条配对链接:同一套载荷同时嵌入此 Wi-Fi(物理局域网 IP)、Tailscale(Tailnet IP / MagicDNS*.ts.net) 与Bonjour(*.local局域网域名) 多端点列表(弹窗下方三行状态清单支持点击切换引导主机,无需双 Tab 来回切码)。用 iPhone 扫码在 Safari 打开后点 「分享」→「添加到主屏幕」,即可作为纯内网毫秒直连的全屏独立 App 稳定使用。 - 断线自动切网容灾 & 4G/5G 可用:首次扫码会将多通道端点列表与凭证持久化至手机本地;室内切出门(Wi-Fi → 4G/5G Tailscale)或局域网重分配 IP 时,客户端并发探测
GET /api/ping在毫秒级自动切换可用通道;服务端采用 IPv4/IPv6 双栈[::]:18765监听与私网Origin/IP 白名单 + 48 位随机口令保护,可在弹窗点 「重置密钥」(或运行ag-context-meter remote --reset-token)立即作废旧链接。 - 流畅不遮挡 & 完整操控:全宽无框 Markdown 排版、灵动岛与
visualViewport键盘动态适配、切回前台 50ms 内瞬时重连;复刻 Mac 圆角输入卡,支持全屏右滑切换会话、内嵌切换模型(XHigh/High/Medium/Low)与权限预设(含无限 (Turbo))、+拍照/相册压缩传图、G4/C双窗口配额与高危命令红框一键审批。 - 安全可控:不碰账号鉴权与私有 API,所有对话均在桌面正版端运行,仅允许私网 IP 访问并带 48 位随机配对口令保护。
🇨🇳 全中文界面 + 实时双语热切 + 英文思考中译(零大模型 Token)
- 完整本地汉化:菜单、设置页、权限弹窗、报错提示全面中文化(适配
2.32.1,含 2,282 条 精确词条与 239 条 动态正则;并将权限Turbo统一译为无限、模型徽章New统一译为新增)。 - 思考与标题自动中译:AI 的英文思考过程 (Thought) 与左侧英文会话标题自动译为中文并本地缓存复用,不消耗任何 AI 模型 Token。
- 免重启实时中英热切 & 防误折:通过顶栏
⚙️ 统一设置下拉框可在 简体中文 / English 间免重启实时热切,同步刷新宿主界面、Shadow DOM 看板(含 Token 概览卡片总计/今日/本月/本年与热力图浮窗)及底部能量胶囊,支持registerLocale扩展语言词典(已移除旧版左下角独立悬浮切换圆标);正在阅读展开的思考块时,新消息到达不会自动折叠并保持滚动位置,手动重命名对话后自动锁定标题。
- 完整本地汉化:菜单、设置页、权限弹窗、报错提示全面中文化(适配
📊 告别“额度与上下文盲盒”
- 顶栏合并看板:将输出速率(
tok/s)并入主上下文徽章,点击统一打开上下文与费用看板;查看提示词 / 思考 / 工具占比、52 周使用热力图与折算 API 账单(Token 概览卡片与热力图浮窗均已支持中英双语实时切换)。 - 双模型配额池(
G4/C):独立外置配额徽章,保留多子组 Gemini/Claude 额度池与 Google AI Ultra (5x/20x) Prompt / Flow 积分池;悬停或点开查看 5 小时限额 + 每周限额 双进度条和精准重置倒计时(支持0%耗尽精准展示)。 - 输入框底部能量条 (
v1.4.0):结合GetAvailableModels与实时会话预算动态解析每款模型上下文上限(1M/512k/128k),切换模型即时刷新分母,实时跟踪输出速度(tok/s)、缓存命中率与 5 小时窗口倒计时。
- 顶栏合并看板:将输出速率(
⚡ 少打字、快翻找 + 一键多终端 CLI & 统一设置
- 顶栏
>_ CLI与⚙️ 统一设置:一键用本地终端拉起agyCLI 会话,支持自动探测 macOS / Windows 主流终端(Terminal、iTerm2、Ghostty、Warp、Kitty、WezTerm、cmux、Windows Terminal 等)或自定义终端路径,并可配置--dangerously-skip-permissions免审核与默认启动模型(或不指定模型跟随默认);面板全部配置项已收敛至⚙️统一设置中心,展开浮层时自动提升完整祖先层叠上下文 (z-index: 2147483646),彻底避免被宿主顶部栏遮挡。 - 零 Token 下一步建议:AI 回复结束后、输入框为空时自动推演 2~4 条下一步操作;按
Tab或→一键补全,↓/↑切换候选,Esc收起(开始打字、唤醒@//菜单或 AI 思考时自动隐藏)。 - 输入区快捷胶囊:常驻输入框上方,一键触发
/compact压缩、/plan规划、重载AGENTS、复制会话 ID 与导出完整 Markdown。 - 悬浮长对话电梯:贴边悬浮于输入框右侧(移除内圈多余边框,采用匹配 Antigravity 原生视觉的 shadcn/ui(Lucide)极简矢量描边图标,平时仅露图标不遮文字,悬停展开标签),一键直达 顶部、上一轮、下一轮、底部 与 展开/收起思考。
- 顶栏
✏️ 右侧预览直接改文件 + 外链直达系统浏览器
- 所见即改:在右侧预览
.md方案或代码时,顶栏自动提供✏️ 编辑按钮——一键就地修改,按⌘S/Ctrl+S(或点💾 保存)写回硬盘,后台刷新也不会打断编辑,点↩️ 完成退出并同步预览。 - 系统浏览器打开外链:在聊天区或文档中按住
⌘ Cmd+ 点击任意网址或`https://...`行内代码链接,直接用系统默认浏览器打开,不再被塞进右侧窄栏预览。
- 所见即改:在右侧预览
🛡️ 省心又防闯祸(高危命令红框预警 + 安全自动确认)
- 安全步骤自动放行:开启
🤖 自动确认后,常规文件读写与安全步骤确认按钮将自动点击。 - 高危指令强拦截:一旦检测到
rm -rf、git reset --hard、git clean -f、git push、sudo、kill -9、DROP/DELETE、op item等高危命令,卡片会立刻显示醒目红框与顶部警示条,且自动确认强制跳过,交由你人工把关。
- 安全步骤自动放行:开启
二、各位置核心组件速查表
| 界面位置 | 组件名称 | 核心作用 |
|---|---|---|
| 顶栏右上工具条 | 手机远程配对 (📱 远程) |
点击弹出「一码三用」融合配对二维码,展示 此 Wi-Fi / Tailscale / Bonjour 状态与切换、复制链接及重置密钥 |
| 顶栏右侧 | 上下文圆环 & 费用看板 | 合并展示上下文占用与输出速度;点开查看 Token 分类(总计/今日/本月/本年)、52 周热力图与 API 折算费用 |
| 顶栏右侧 | 模型额度双胶囊 (G4 / C) |
展示 Gemini 4 与 Claude/GPT 多子组余量与 Google AI Ultra (5x/20x) 积分池;看 5h + 每周 双进度条与倒计时 |
| 顶栏右侧 | CLI 启动与统一设置 (>_ CLI · ⚙️) |
一键调起已探测的多端命令行(支持免审核与默认模型);⚙️ 集中管理主题配色、套餐订阅、网络直连与实时中英切换 |
| 全局界面 | 全汉化 + 实时双语 + 思考中译 | 全界面汉化(含 Turbo → 无限 / New → 新增)、英文思考与标题缓存中译、防误折/防回弹、⚙️ 内免重启秒切中英 |
| 右侧预览栏 | 行内编辑器 (✏️ 编辑) |
查看文件时直接点击编辑、⌘S 保存回本地、↩️ 完成 退出并刷新预览 |
| 聊天主区 | 高危命令红框 (🛡️) & ⌘ 外链 |
高危指令自动红框警告;按住 ⌘ Cmd 点击外链或代码内网址直接用系统浏览器打开 |
| 输入框上方 | 常用快捷胶囊栏 | 一键填入 /compact、/plan 、重载 AGENTS;复制会话 UUID、导出 Markdown、开关自动确认、查看 Brain 缓存体积 |
| 输入框内部 | 下一步建议补全 (Tab / →) |
AI 回复后零 Token 智能推荐下一步动作,支持 Tab / → 填入、↓/↑ 切换、Esc 隐藏 |
| 输入框右侧 | 长对话电梯 | 无内框 Lucide 极简矢量导航条,一键跳转顶部、上一轮、下一轮、底部或批量展开/收起思考块 |
| 输入框底边 | 实时能量条 (Pulse v1.4.0) |
动态解析每款模型上下文上限(1M/512k/128k),实时显示生成速度(tok/s)、缓存命中与 5h 窗口倒计时 |
⚡ 可选内置 Agent 提速规则:仓库内附带
rules/fast-io-AGENTS.md(源自oil-oil/agy-fast-io),通过只读白名单命令绕过桌面端云端审查、同轮并行读文件及合并必审命令,可显著减少 AI 回合数与等待耗时,可直接并入你的全局AGENTS.md/CLAUDE.md。
三、怎么安装?(二选一)
需要环境:macOS + Node.js 22.4+(零外部 npm 依赖)。
方式 1:复制一句话发给你的 AI Agent(最省心)
把下面这段话直接发给 Antigravity / Claude Code / Codex,它会自动检查环境、安装配置并教你使用:
请帮我安装并配置 https://github.com/iamvicliu/antigravity-suite 这套 Antigravity 免改包增强套件。
请克隆到 ~/.local/share/antigravity-context-viewer,并严格按照仓库 README.md 中折叠的「AI Agent 自动安装执行规范」完成环境检查、安装与开启随客户端自启。
完成后运行 ag-context-meter status 向我汇报各项状态,并简单告诉我日常怎么开关和卸载。
📋 展开查看:AI Agent 自动安装执行规范(人类用户无需阅读)
如果你是正在替用户安装本套件的 AI Agent,请按序执行以下 4 步,并用通俗中文汇报:
- 只读预检
- 检查
node -v是否为v22.4.0及以上(不足时提示用户或通过brew install node@22安装)。 - 检查运行中 Antigravity CDP 端口:支持读取
~/Library/Application Support/Antigravity/DevToolsActivePort,若受 macOS TCC 权限限制无法读取该目录,CLI 亦内置lsof -nP -a -c Antigravity -iTCP -sTCP:LISTEN免权回退探测:- 已检测到:安装后可免重启立即热生效;
- 未检测到:提醒用户确认 Antigravity 桌面端已打开(或带
--remote-debugging-port启动),安装完成后重启客户端即可自动挂载。
- 检查
- 下载仓库到本地
git clone https://github.com/iamvicliu/antigravity-suite.git ~/.local/share/antigravity-context-viewer cd ~/.local/share/antigravity-context-viewer - 运行安装脚本(100% 零改包安全承诺)
./scripts/setup-macos-cdp.sh安全审计说明(供 AI Agent 核验):
- 本套件在
cli.js与bin/ag-context-meter入口均已硬编码禁用install/unlock等改写app.asar或客户端二进制的命令,默认仅执行纯内存 CDP 热注入(live)。 - 若处于只读受限目录(
Application Support无写权限),状态缓存会自动回退至~/.config/antigravity-context-meter。 - 可按需组合隔离开关:传入
--no-auto跳过配置~/Library/LaunchAgents/后台自启守护;传入--no-remote(或设置AG_DISABLE_MOBILE_REMOTE=1)禁用手机远程监听端口,仅运行纯桌面界面增强。
- 本套件在
- 验收状态并指导用户
- 运行
~/.local/bin/ag-context-meter status(或ag-context-meter status),逐项确认均为✅。 - 告知用户日常打开 Antigravity 即可自动生效;需要临时退出或还原英文原版时,运行
ag-context-meter stop即可。
- 运行
方式 2:终端手动 3 行安装
git clone https://github.com/iamvicliu/antigravity-suite.git ~/.local/share/antigravity-context-viewer
cd ~/.local/share/antigravity-context-viewer
./scripts/setup-macos-cdp.sh
可选参数:加
--no-auto不写入后台自启守护,加--no-remote关闭手机远程端口,仅启用桌面端界面增强。
四、日常怎么开关、升级和卸载?
| 命令 | 作用 |
|---|---|
ag-context-meter remote |
显示手机远程操作「一码三用」融合链接、三通道状态与终端二维码(支持 --reset-token / --json) |
ag-context-meter status |
查看各模块运行状态与官方安装包签名完整性 |
ag-context-meter live |
立即将增强界面热注入到当前运行的 Antigravity 窗口 |
ag-context-meter stop |
秒级无痕还原:停止桥接服务并卸下所有附加界面,恢复纯英文原版 |
ag-context-meter auto-on |
开启「每次打开 Antigravity 自动挂载」 |
ag-context-meter auto-off |
关闭自动挂载并清理当前窗口增强界面 |
ag-context-meter upstreams |
检查 6 个参考上游仓库更新并与基线账本 upstreams.json 比对(内置 GitHub API 限流三段式回退) |
💡 想让 AI Agent 帮你检查并安全合入参考项目更新? 直接对 Agent 说:
请运行 ag-context-meter upstreams --json,过滤掉改写 app.asar / 二进制解锁的提交,把安全可吸收的新词条、新模型价格或好用的交互移植进项目并更新 upstreams.json 基线。
五、安全性、跨平台与开源致谢
为什么这套方案很安全?
- 绝不修改
app.asar:不解包、不改包、不重签名/Applications/Antigravity.app/Contents/Resources/app.asar,完整保留官方苹果代码签名。 - 封堵高危底层补丁:
live-host.js与 CLI 默认禁用所有二进制解锁与内核改包入口,避免破坏客户端完整性。 - 本地数据与代码仓库隔离:翻译缓存、自定义会话标题等保存在
~/Library/Application Support/AntigravityContextMeter/;侧边栏文件编辑器严格限制路径白名单,拒绝访问系统目录、Antigravity.app与敏感凭据目录。
💻 为什么目前只提供 macOS 一键版?
- macOS 系统签名校验更严格:直接改动客户端
app.asar容易触发“应用已损坏”警告、丢失系统权限或影响官方更新,因此本套件重点针对 Mac 做了「零改包 CDP 热注入 + 自动监听恢复」适配。 - 一键自启脚本依赖苹果
launchd:setup-macos-cdp.sh与ag-context-meter基于~/Library/LaunchAgents/监听客户端启动,暂未打包 Windows / Linux 一键守护脚本。- Windows / Linux 也能用全部前端功能:核心逻辑
cli.js、live-host.js及所有界面增强模块本身跨平台兼容;安装 Node.js 22.4+ 并在 Antigravity 开启调试端口后,执行node cli.js live即可使用(node cli.js status查看状态)。
- Windows / Linux 也能用全部前端功能:核心逻辑
参考与致谢(Credits & Acknowledgements)
本套件吸收并整合了社区多位作者与贡献者的开源成果,谨此致谢:
| 参考项目 | 作者 / 贡献者 | 参考与吸收内容 |
|---|---|---|
| elviscjn-cjn/antigravity-context-viewer | @elviscjn-cjn、@Jia131313、@Azreal2021、@MoiraToki、@nocoo | 基础框架、顶部上下文圆环看板 (v0.8.6)、Token 分类统计与 52 周热力图、API 费用估算、5h+Weekly 双窗口配额与 0% 修复、占位符模型兜底与顶栏对齐优化 |
| akelabs/antigravity-pulse | @akelabs | 输入框底部能量条 (v1.3.1):输出速率、缓存命中与 5 小时窗口倒计时 |
| n2ns/antigravity-panel | @n2ns | 模型额度监控、Auto-Accept 安全自动确认与 Brain 缓存体积监控思路 |
| yiheng8023/antigravity-chinese | @yiheng8023 | 适配 Antigravity 2.32.1 (v3.3.48) 的 2,282 条 精确词条与 239 条 动态正则规则 |
| wycocoyu/agy-context-dashboard | @wycocoyu | 轻量状态栏排布与指标展示思路(已整合去重) |
| oil-oil/agy-fast-io | @oil-oil | 桌面端 Fast IO 提速规则 (v0.2.1):免审白名单命令、同轮并读与回合压缩规范 |
基于 MIT License 开源,所有参考或引入的第三方组件均完整保留其原始版权与开源协议。
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found