INK-Q/agy-fast
开发工具通过合并工具调用和注入启动快照,减少 Antigravity 的 LLM 轮次、token 消耗与延迟。
项目介绍
agy-fast 是 Google Antigravity(CLI、Desktop 2.0 和 IDE)的插件,只使用官方插件接口:本地 Stdio MCP 服务、一个 SessionStart 钩子和路由规则,不改客户端。目标是压缩编码会话的等待时间,核心手段是减少 LLM 往返轮次、把重复工具调用合并到一次 MCP 调用中。
项目分析 55 个真实会话后发现,延迟主要来自每轮首个 token 的等待、同文件重复编辑、用 shell 做只读搜索、会话开头探索仓库,以及上下文增长带来的缓存未命中。agy-fast 针对这些点做了四类复合工具和一份很小的启动快照。
核心组件
batch_search:一次执行最多 20 个 text、regex、glob 和只读 git 查询;安装 ripgrep 时优先使用,否则回退到 Node.js。apply_edits:跨文件批量应用不连续编辑,先整体校验,全部失败则不写入;保留 CRLF、权限和符号链接,支持dryRun和可选verify。read_slices:返回多语言符号大纲和精确行号范围,在字节预算内批量读取。run_checks:有并发上限地并行执行构建、类型检查、lint 和测试命令,支持超时和单行通过摘要。SessionStart钩子注入不超过 1.5 KB 的启动快照,包括 git 分支/状态、两级目录树和检测到的脚本。
快速使用
需要 Node.js 20 或更高版本。仓库自带零依赖的预构建产物,不必先跑 npm install。ripgrep 可选,装了能加快搜索。
- 用一键脚本安装到全局插件目录:macOS/Linux 或 Windows PowerShell;也可以克隆后运行
node scripts/install.mjs install。 - 如果本机有 Antigravity CLI,安装器会校验 manifest、启用插件并做 MCP 与钩子的健康检查。
- 在 Desktop/IDE 中打开 Customizations → Installed,确认
agy-fast已启用,然后新开会话,让SessionStart钩子和 MCP 工具生效。 - 运行
./install.sh doctor(或install.mjs doctor)检查 MCP 握手与启动耗时;不需要时用uninstall删除全局安装。
也支持按仓库安装:node scripts/install.mjs install --project /path/to/repo,文件写入 <repo>/.agents/plugins/agy-fast。
测量效果
项目自带离线基准工具,只读取本机 Antigravity 的 transcript.jsonl,不上传数据:
node dist/benchmark.mjs analyze --local --split-usage
node dist/benchmark.mjs compare --before ./run-before/transcript.jsonl --after ./run-after/transcript.jsonl
作者基于 10 天脱敏转录报告:每 10 个逻辑操作 LLM 轮次约下降 33.7%,估算计费配额下降 31.5%,工具返回上传量下降 39.7%。这些是作者自己会话上的测量结果,实际收益取决于具体工作类型。
使用约束
- 仅支持 macOS、Linux 和 Windows 上的 Antigravity CLI(
agy)、Desktop 2.0 和 IDE,需要 Node.js 20+。 - 插件只调用 Antigravity 文档化的扩展接口,不修改 diff 窗口、修改文件列表、检查点或安全检查;不注册逐步钩子,
SessionStart出错时返回空对象,不阻塞会话。 - 配额节省按给定的 token 权重估算(未缓存输入 1.0×、缓存读取 0.1×、输出 5.0×),最终计费以 Antigravity 自身统计为准。
- 后台自动更新每 12 小时检查一次 GitHub,先暂存新版本并跑 MCP 冒烟测试再替换文件;可切换为
notify或off,也能用环境变量覆盖。手动更新可跟随release或main通道。 - 二次开发需要
npm install,使用严格 TypeScript、esbuild 和项目测试集。许可证为 MIT。
HotRepo 点评
agy-fast 于 2026-11-20 出现在 HotRepo 新项目记录中,在约 1.5 小时的统计窗口里净增 20 Star、2 Fork,之后 Star 总数为 122。这是刚建立的新仓库记录,不是长期榜单表现,全部语言日榜上暂无已记录名次。相比星数,更值得看的是可复核的部分:一份脱敏分析报告、随仓库发布的基准 CLI,以及只依赖 Antigravity 文档化扩展点的插件结构。评估时应先在本机跑 analyze --local --split-usage,而不是只看宣传的百分比。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- QwenLM/qwen-code一个运行在终端里的 AI 编程智能体,可读取、修改、运行和审查代码,并提供编辑器、桌面、网页和聊天入口。
- sksarvesh007/antiglaude把 Anthropic 与 OpenAI 接口请求转换到 Gemini、Cloud Code 后端的本地网关。
- rtk-ai/rtk在 AI 编程 Agent 读取命令输出前做压缩,减少常见开发命令的 token 消耗。
- ATtacK030130/antigrative-dashboard在 Antigravity 模型选择区旁显示吞吐、缓存命中、上下文占用和配额窗口的本地小部件。
- samber/cc-skills-golang一组针对 Go 的 Agent Skills,让编程助手按 Go 惯用法写代码、测试和排错。