Gemini CLI v0.38.2 是截至 2026-04-17 的最新稳定版。主要亮点：Chapters 叙事流（按主题分组会话交互）、Context 压缩服务（自动压缩对话历史）、Terminal Buffer 防闪烁、持久化策略批准（不再每次手动确认），以及后台进程监控工具。

Gemini CLI v0.38.2 — 最新稳定版发布说明

发布日期：2026-04-17

安装最新稳定版：

npm install -g @google/gemini-cli

---

主要亮点

Chapters 叙事流

基于意图和工具使用情况将代理交互分组为"章节"（Chapters），为长时间运行的任务提供更好的会话结构和叙事连续性。

Context 压缩服务

全新专用 Context 压缩服务，高效提炼对话历史，减少 token 消耗并保持上下文聚焦。对话越长，节省效果越明显。

UI 稳定性与体验增强

• 引入"Terminal Buffer"模式，解决渲染闪烁问题
• 支持选择性主题展开（点击展开/折叠 Chapter）
• 改进工具确认布局，更清晰显示待批准操作

持久化上下文感知工具批准

用户现在可以授予工具的持久性批准（上下文感知），大幅减少在可信工作流中的手动确认次数。

后台进程监控

新增工具用于监控和检查后台 Shell 进程，提供异步任务的更好可见性。

---

详细变更列表

修复与稳定性

• 修复 /skills reload 后 slash 命令列表未刷新的问题
• 修复 complete_task 工具调用未记录到聊天历史的问题
• 修复 Linux 沙箱 ARG_MAX 崩溃（重构 sandbox 实现）
• 修复 Windows 和 BSD 系统的 shebang 执行问题（移除 -S 标志）
• 修复 Windows 上 vim 编辑器不在 PATH 时的崩溃
• 修复 ACP 流式错误处理
• 修复沙箱批准的持久化和匹配逻辑
• 修复 Windows 沙箱中损坏的 PowerShell 翻译和原生 __write
• 修复 Skill 链接在 Windows 上使用目录连接点

新功能

• plan mode 中 web_fetch 现在显式允许（使用 ask_user 确认）
• 环境变量支持默认值（${VAR_NAME:-default_value} 语法）
• 新增 experimental.adk.agentSessionNoninteractiveEnabled 设置
• ACP 新增 /about 和 /help 命令支持
• /stats 命令中新增按角色的指标分析
• 输入提示现在支持滚动条
• Hooks 系统消息在 UI 中展示

性能优化

• Terminal Serializer 优化
• 自动配置记忆功能（Auto configure memory）
• 背景记忆服务支持 Skill 提取
• 后台进程监控和检查工具

---

完整变更历史

查看完整 commit 历史：v0.38.0...v0.38.2

历史版本公告见 版本发布记录。

---

安装与升级

# 安装最新稳定版
npm install -g @google/gemini-cli

# 安装 preview 版
npm install -g @google/gemini-cli@preview

# 查看当前版本
gemini --version

---

常见问题

Q: 什么是"Chapters 叙事流"，会影响我的日常使用吗？

A: Chapters 是 CLI 自动将你的会话按任务主题分组的功能，类似文章的"段落"。如果你不喜欢，可以在 /settings 中调整。总体上，它让长对话更易于回顾，不需要额外操作。

Q: Context 压缩服务会丢失我的对话内容吗？

A: 不会。压缩是语义层面的无损压缩，保留关键信息并减少 token 占用。你不会感知到压缩过程，只会看到更长的对话不再频繁触碰 token 上限。

Q: 持久化策略批准如何工作？我批准一次后下次还会再问吗？

A: 持久化批准是上下文感知的——在相同上下文（相同目录、相同工具）下，之前批准的操作不会再次弹出确认。不同项目或不同类型的工具调用仍会单独询问。