Gemini CLI v0.69.0 更新速览:性能修复与终端体验优化详解

Gemini CLI v0.69.0 更新速览:性能修复与终端体验优化详解

v0.69.0 核心变更概览

Google 于 11 月 19 日推送了 gemini-cli 的 v0.69.0 版本。此次更新主要聚焦于修复核心逻辑错误、提升 CLI 交互稳定性,并引入了一些新的小功能。针对开发者和日常使用者最关心的部分,新版本解决了一系列导致程序挂起、内存泄漏或显示异常的问题,同时扩展了自定义配置的能力。

关键修复与功能增强

  • 模板变量处理优化:修复了核心模块和 CLI 在替换模板占位符时保留字面量 $ 字符的问题,避免意外转义或解析错误(#30136)。
  • 新增统计热力图:在 CLI 中增加了 /stats heatmap 子命令,用于展示每日 token 使用量的热力分布,方便用户监控用量(#30135)。
  • 环境变量冲突解决:防止 GCLI_EXPAND_TARGET 在展开环境变量时发生碰撞,提升脚本执行的可靠性(#30138)。
  • ANSI 输出序列化:在 ACP 工具调用更新中,将 AnsiOutput 正确序列化为文本内容,解决终端渲染乱码或格式丢失问题(#30141)。
  • Windows PowerShell 兼容性:修复了 PowerShell 替换过程中的误报和策略处理逻辑错误(#30110)。
  • 多模态数据管理:限制多部分工具输出的大小,并清理旧的多模态 inlineData,防止内存无限增长(#30180)。
  • 网络超时控制:允许在所有认证模式下覆盖默认的 60 秒 API 请求头超时时间,用户可通过 model.requestTimeoutMs 或 GEMINI_API_HEADERS_TIMEOUT_MS 自定义(#30183)。
  • macOS 沙箱适配:在 macOS 宽松沙箱中允许 FSEvents,并解决了文件夹信任判断进入沙箱前的时序问题(#30143, #30164)。
  • 进程与信号处理:在 headless 中止时正确杀死子进程、记录取消的工具并保留信号退出码;修复了 macOS PTY 生成时泄漏的孤立 /dev/ptmx 文件描述符(#30204, #30184)。
  • 交互逻辑修正:防止在 shell 模式下递归启动交互式 gemini 会话;在编辑器选择中退出时保留待确认的工具状态(#30185, #30147)。

底层架构与稳定性提升

除用户可见的功能外,本次更新在底层架构上做了大量加固。开发团队重点处理了网络故障导致的长时间静默加载挂起问题,确保在请求失败时能快速响应而非无限等待(#30182, #30186)。同时,修复了恢复会话时终端模型轮次出现的 400 错误,和主线程 JSONL 冻结的问题,提升了长会话的稳定性。

内存管理方面,新版针对 PDF inlineData 和遥测缓冲区做了优化,防止内存保留过高(#30217)。另外,MessageBus 的 request 方法现在会在发布失败时立即拒绝,避免无效等待(#30189)。对于 SSH 客户端识别,系统现在能正确识别 TortoiseGitPlink 为 PuTTY 家族成员(#30214),完善了外部工具集成体验。

代码库瘦身与扩展性

在 VSCode 扩展端,团队消除了 barrel import 带来的打包体积膨胀,并移除了冗余的 setContext 调用(#30181)。ACP 协议层面,处理了流中间的重试机制,防止文本拼接错误(#30165)。配额重试方面,增加了多小时配额重试的保护机制,并在重试时通知 ACP 客户端(#30187)。这些改动旨在让 CLI 在复杂网络环境和资源受限场景下表现得更加健壮。

版本贡献与资源

本次更新由 file, diegogodinezr 等共 11 位贡献者协作完成。完整变更日志涵盖了从 v0.68.0 到 v0.69.0 的所有细微调整,包括版本号的自动提升(#30140)和之前版本 v0.67.0 和 v0.68.0-preview.0 的 changelog 归档(#30145, #30146)。开发者可以通过 Assets 链接下载对应的安装包,或直接通过 npm 获取最新版。

发表评论