搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

INK-Q/agy-fast

开发工具

通过合并工具调用和注入启动快照,减少 Antigravity 的 LLM 轮次、token 消耗与延迟。

142
12
TypeScript
MIT
创建于 1 天前

项目介绍

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 可选,装了能加快搜索。

  1. 用一键脚本安装到全局插件目录:macOS/Linux 或 Windows PowerShell;也可以克隆后运行 node scripts/install.mjs install。
  2. 如果本机有 Antigravity CLI,安装器会校验 manifest、启用插件并做 MCP 与钩子的健康检查。
  3. 在 Desktop/IDE 中打开 Customizations → Installed,确认 agy-fast 已启用,然后新开会话,让 SessionStart 钩子和 MCP 工具生效。
  4. 运行 ./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 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. QwenLM/qwen-code一个运行在终端里的 AI 编程智能体,可读取、修改、运行和审查代码,并提供编辑器、桌面、网页和聊天入口。TypeScript28,828
  2. sksarvesh007/antiglaude把 Anthropic 与 OpenAI 接口请求转换到 Gemini、Cloud Code 后端的本地网关。Python105
  3. rtk-ai/rtk在 AI 编程 Agent 读取命令输出前做压缩,减少常见开发命令的 token 消耗。Rust86,426
  4. ATtacK030130/antigrative-dashboard在 Antigravity 模型选择区旁显示吞吐、缓存命中、上下文占用和配额窗口的本地小部件。JavaScript106
  5. samber/cc-skills-golang一组针对 Go 的 Agent Skills,让编程助手按 Go 惯用法写代码、测试和排错。Go3,688