Gemini CLI 持续高频发版（每周一个小版本）。本页收录各版本的重要功能公告，帮助你快速了解每个版本引入了什么新能力。完整 commit 记录见 GitHub Releases。

Gemini CLI 版本发布记录

Gemini CLI 有三个发布渠道：Nightly（每夜构建）、Preview（实验性功能预览）和 Stable（稳定版，大多数用户推荐）。

发布渠道	说明
Nightly	包含最新变更的每夜构建
Preview	实验性功能，适合早期反馈
Stable	稳定版，推荐大多数用户使用

完整 changelog 见 GitHub Releases。

---

v0.38.0 — 2026-04-14

• Chapters 叙事流：根据意图和工具使用情况将代理交互分组为"章节"（Chapters），提供更好的会话结构
• Context 压缩服务：高级上下文管理，高效提炼对话历史
• UI 防闪烁与体验增强：引入"Terminal Buffer"模式解决渲染闪烁，支持选择性章节展开
• 持久化策略批准：实现上下文感知的工具执行持久批准，减少重复确认操作

---

v0.37.0 — 2026-04-08

• 动态沙箱扩展：实现 Linux 和 Windows 的动态沙箱扩展及 Git Worktree 支持
• Chapters 叙事流：引入基于工具的主题分组，提供更好的会话结构
• 增强的浏览器代理能力：持久化会话和动态工具发现

---

v0.36.0 — 2026-04-01

• 多注册表架构与沙箱：引入多注册表架构，实现原生 macOS Seatbelt 和 Windows 沙箱增强子代理安全
• 刷新后的 Composer 界面：全新 Composer 布局体验，提升终端交互稳定性
• Git Worktree 支持：原生支持 Git worktrees，实现隔离并行会话
• 子代理上下文与反馈：增强子代理的 JIT 上下文注入和带上下文反馈的工具拒绝机制

---

v0.35.0 — 2026-03-24

• 可自定义键盘快捷键：支持自定义键盘快捷键，含字面字符绑定和 Kitty 协议扩展
• Vim 模式改进：新增缺失的 Vim 操作（X、~、r、f/F/t/T）和无名寄存器的 yank/paste 支持
• 工具隔离与沙箱：引入 SandboxManager 隔离进程生成工具，新增 Linux bubblewrap/seccomp 沙箱支持
• JIT 上下文发现：实现文件系统工具的即时上下文发现

---

v0.34.0 — 2026-03-17

• Plan Mode 默认启用：Plan Mode 现在默认开启，帮助你分解复杂任务系统性执行
• 沙箱增强：新增原生 gVisor (runsc) 和实验性 LXC 容器沙箱支持

---

v0.33.0 — 2026-03-11

• A2A 远程代理认证：A2A 远程代理支持 HTTP 认证和认证 A2A 代理卡片发现
• Plan Mode 更新：Plan Mode 内置研究子代理、注释反馈支持和新 copy 子命令
• CLI 界面与管理控制：紧凑型 ASCII 图标标题、上下文窗口使用量显示、30 天默认聊天历史保留

---

v0.32.0 — 2026-03-03

• 通用代理：启用通用代理，改进任务委派和路由
• 工作区 Model Steering：直接在工作区支持模型引导
• Plan Mode 增强：支持在外部编辑器中打开和修改计划；多选选项处理复杂任务
• 交互式 Shell 自动补全：引入交互式 Shell 自动补全
• 扩展并行加载：扩展现在并行加载，缩短启动时间

---

v0.31.0 — 2026-02-27

• Gemini 3.1 Pro Preview：Gemini CLI 支持 Gemini 3.1 Pro Preview 模型
• 实验性浏览器代理：引入全新实验性浏览器代理，可与网页交互
• Policy Engine 更新：支持项目级策略、MCP 服务器通配符和工具注解匹配
• Web Fetch 改进：实验性直接 Web Fetch 和速率限制

---

v0.30.0 — 2026-02-25

• SDK 与自定义 Skills：引入初始 SDK 包，支持动态系统指令、SDK 工具调用 SessionContext 和自定义 Skills
• Policy Engine 增强：新增 --policy 标志，严格 seatbelt 配置文件；废弃 --allowed-tools 转用 Policy Engine
• 界面与主题：新增 Solarized 主题、Markdown 表格文字换行、可搜索设置和扩展列表
• Vim 与终端交互：改进 Vim 支持，新增 Ctrl-Z 终端挂起支持

---

v0.29.0 — 2026-02-17

• Plan Mode：全新综合规划能力，提供 /plan、enter_plan_mode 工具和完整文档
• Gemini 3 默认启用：移除预览标志，所有用户默认启用 Gemini 3
• Extension 探索：全新 UI 和设置，更方便地探索和管理扩展
• 管理员控制：管理员现在可以允许列表特定 MCP 服务器配置

---

v0.28.0 — 2026-02-10

• IDE 支持：新增 Positron IDE 支持
• 主题定制：支持在扩展中使用自定义主题；基于终端背景色自动切换主题
• 认证改进：OAuth 新增交互式和非交互式同意；bug 报告中可包含认证方式信息

---

v0.27.0 — 2026-02-03

• 事件驱动架构：新事件驱动调度器执行工具，更响应、更高效
• 用户体验增强：工具确认队列、大文本粘贴可展开
• /rewind 命令：轻松在会话历史中导航
• Linux 剪贴板支持：Linux 用户现可通过 Wayland 和 X11 粘贴图片

---

v0.26.0 — 2026-01-27

• 代理与 Skills：引入 skill-creator Skill；默认启用代理 Skills；新增通用代理改进任务路由
• UI/UX 改进：支持"回退"对话历史（/rewind）
• 核心与调度器重构：核心调度器大幅重构，提升性能和可靠性

---

v0.25.0 — 2026-01-20

• Skills 与代理改进：增强 activate_skill 工具；新增 pr-creator Skill；Skills 默认启用；新增 /agents refresh 命令
• UI/UX 细化：Skills 透明反馈；Tab 键切换 Shell 与输入焦点；动态终端标签标题
• 核心功能与性能：内置代理 Skills 支持；忽略实例缓存提升性能；增强重试机制

---

v0.24.0 — 2026-01-14

• 代理 Skills 重大进展：初始文档和教程；远程代理增强支持
• UI/UX 改进：Hooks 执行的视觉指示器；Tab 键切换焦点
• 安全增强：默认文件夹信任改为不受信任；Policy Engine 支持特定模式；Shell 命令细粒度允许列表
• 核心功能：强制 MessageBus 注入；内置 Skills 支持；增强模型路由

---

v0.23.0 — 2026-01-07

• 实验性代理 Skills（预览版）：Gemini CLI 预览构建中支持 Agent Skills
  • 安装预览版：npm install -g @google/gemini-cli@preview
• Gemini CLI wrapped：运行 npx gemini-wrapped 可视化你的使用统计
• Windows 剪贴板图片支持：Windows 用户可通过 Alt+V 直接粘贴剪贴板中的图片
• 终端背景色检测：自动优化主题选择，提供无障碍警告
• 会话登出：新增 /logout 命令，即时清除凭证并重置认证状态

---

v0.22.0 — 2025-12-22

• 免费层 + Gemini 3：所有免费层用户现可使用 Gemini 3 Pro & Flash（在 /settings 中启用"Preview Features"）
• Gemini CLI + Colab：Gemini CLI 现在预安装在 Google Colab 中，可在 Notebook 单元格中无头使用或在内置终端中交互使用
• Gemini CLI Extensions：
  • Conductor：规划增强工具，帮助构建详细计划 gemini extensions install https://github.com/gemini-cli-extensions/conductor
  • Endor Labs：代码分析、漏洞扫描和依赖检查 gemini extensions install https://github.com/endorlabs/gemini-extension

---

v0.21.0 — 2025-12-15

• Gemini 3 Flash：更快更便宜，部分场景优于 3 Pro
  • 付费层和等待列表免费层用户：在 /settings 中启用"Preview Features"
  • 博客文章
• /stats 配额可见性：显示所有可用模型的配额信息（包括当前会话未使用的模型）
• 模糊设置搜索：在设置对话框中使用模糊搜索快速查找设置
• MCP 资源支持：可通过 @ 命令发现、查看和搜索 MCP 资源

---

v0.20.0 — 2025-12-01

• 多文件拖拽：可将多个文件拖拽到终端，CLI 自动为每个有效路径添加 @ 前缀
• 持久化"始终允许"策略：保存工具执行的"始终允许"决策，支持对特定 Shell 命令和多云平台工具进行细粒度控制

---

v0.19.0 — 2025-11-24

• Zed 集成：Zed 中启用"Preview Features"后可使用 Gemini 3
• 交互式 Shell 改进：Click-to-Focus（点击 Shell 输出区域激活焦点）；加载短语指示等待用户输入

---

v0.18.0 — 2025-11-17

• 实验性 Policy Engine：允许用户和管理员为工具调用创建细粒度策略，目前在 flag 后
• Gemini 3 付费支持：所有 API Key、Google AI Pro/Ultra 和 Code Assist Enterprise 用户可通过 /settings 启用 Preview Features 使用 Gemini 3
• 模型显示在历史中：可在 /settings 中切换是否在聊天历史中显示模型信息

---

v0.16.0 — 2025-11-10

• Gemini 3 + Gemini CLI 发布 🚀

---

v0.15.0 — 2025-11-03

• 可滚动 UI 与鼠标支持：全新无闪烁显示、固定标题栏、稳定输入提示、鼠标点击支持
  • 公告博客
• Todo 规划：复杂问题自动分解为可管理并打勾的 Todo 列表

---

v0.12.0 — 2025-10-27

• /model 模型选择：在会话中选择 Gemini 模型
• 模型路由：智能为任务选择最佳模型（简单查询用 Flash，复杂任务用 Pro）
  • 可通过 /model 退出自动路由
• 代码库调查子代理：新内置子代理，探索工作区并解析相关信息以提升整体性能
• API Key 认证：通过新对话框安全输入和存储 Gemini API Key，无需环境变量

---

v0.11.0 — 2025-10-20

• Jules Extension：使用 Gemini CLI 编排 Jules，派生远程工作者、委派任务 gemini extensions install https://github.com/gemini-cli-extensions/jules
• 流式 JSON 输出：--output-format stream-json 在无头模式下实时监控 AI 代理进度

---

v0.9.0 — 2025-10-06

• 交互式 Shell：直接在 Gemini CLI 中运行 vim、rebase -i 等交互式命令
  • 博客公告

---

v0.8.0 — 2025-09-29

• Gemini CLI Extensions 发布 🎉：完全自定义你的 Gemini CLI 体验
  • 安装：gemini extensions install <github url|folder path>
  • 管理：gemini extensions install|uninstall|link|enable|disable|list|update|new
  • 公告博客
• 全新主页与文档：geminicli.com

---

常见问题

Q: 如何查看当前安装的 Gemini CLI 版本？

A: 运行 gemini --version 可查看当前安装的版本号。

Q: stable、preview 和 nightly 有什么区别？

A: stable 是稳定版（大多数用户推荐）；preview 包含实验性新功能，适合希望提前体验的用户；nightly 是每夜构建，包含最新提交，可能不稳定。

Q: 如何安装最新稳定版？

A: 运行 npm install -g @google/gemini-cli 或 npm install -g @google/gemini-cli@latest。