Gemini CLI 官方扩展

这个 pack 装了什么

这个 pack 还原 Google 在 google-gemini/gemini-cli GitHub 仓库上发布的 10 个官方扩展。每一个都是 Google 第一方发布 —— 没有社区 fork，没有半维护的镜像。Google 上游废弃哪个，我们一个发布周期内跟。

为什么 Gemini CLI 扩展重要

Gemini CLI 的杀手特性是 1M token 上下文 —— 但裸上下文没有可调的 typed 接口就没用。扩展就是 Gemini CLI 拿到 类型 的方式：每个扩展声明自己的工具、schema、凭证路径，agent 不用瞎猜怎么调你的仓库或你的 Figma。它们是 Google 对 Claude Code subagent 层 + MCP server 层的一次合并回答：比 MCP 更紧（带 Gemini 专属 UX），比 subagent 更轻（不用单独写 prompt）。

团队真在每天用的五个核心扩展：

• Stitch 是这套里最常 demo 的。丢一个 Figma URL 或截图，Gemini 直出生产级 React/Vue/Tailwind。出的是真 PR，不是 Storybook 道具
• Workspace 让你在终端里生成 doc、填 sheet、改幻灯片。状态报告和会议准备很顺
• Code Review 跑结构化审查 pass，针对 diff 或分支 —— 评论按严重度分组，带文件 / 行锚点
• Postgres 起连接池，默认只读，让 agent 在写 SQL 之前先反射 schema
• Vertex AI 当你不能把代码或数据送到公开 Gemini 端点时就靠它。通过 Vertex 路由，所有请求留在你的 GCP 项目、IAM、审计日志里

一条命令装齐

# 装整个 pack
tokrepo install pack/gemini-cli-extensions

# 或只装单个
tokrepo install gemini-stitch
tokrepo install gemini-vertex-ai

TokRepo CLI 会把正确条目写进 ~/.gemini/extensions.json 并注册每个扩展的 manifest。不用手改 JSON，不用从博客文章里翻顺序。卸载就 tokrepo uninstall <slug>。

常见踩坑

• Auth 范围漂移。Workspace 和 Vertex AI 要不同的 OAuth scope。同一会话先 gcloud auth login --update-adc 再装，否则后装的会悄悄继承先装的 scope，第一次调用就报 401
• Stitch Figma 限流。免费 Figma 套餐有每分钟 API 调用上限。大页面要分批，否则会出半成品组件，重试很烦
• Postgres 扩展默认只读。变更要显式加 --allow-write。这是特性不是 bug，挡住误操作 DROP TABLE。按会话开，绝不全局开
• Vertex AI 账单意外。一旦走 Vertex 路由，每次 Gemini 调用都按 GCP 项目计费，即使你之前在公开端点有免费额度。装前先设预算告警
• Search Grounding 区域锁。少数扩展在 EU 区域因为同意标志返回空 grounding 块。涉合规流之前先看上游仓库的扩展支持矩阵

跟其他 pack 的关系

这个 pack 是三件套故事的 Gemini CLI 那一侧：本 pack（Gemini CLI 扩展）+ claude-code-subagents（Claude Code 子代理）+ mcp-server-stack（跨工具 MCP 服务器）。常驻 Gemini CLI 就装这个；每周换工具就装 MCP server，那一层穿越工具切换。