Gemini CLI 0.68：33 条变更，只有 1 条新功能

title: Gemini CLI 0.68：33 条变更，只有 1 条新功能 desc: Gemini CLI v0.68.0 一共 33 条变更，面向终端用户的新功能只有一条，其余全在补边界：提示词模板转义、流式响应末尾丢事件、Windows 路径判断。这是一次典型的运行时质量版本。 seo_title: Gemini CLI 0.68 更新解读：33 条变更与三个正确性隐患 seo_description: 逐条拆解 Gemini CLI v0.68.0 的 33 条变更：唯一的新功能为何是扩展校验命令、提示词模板的美元符号转义与 SSE 末尾丢事件会怎样影响 Agent 行为、Windows 路径相关四条修复，以及升级时需要注意的两处行为变化。 cate: ai tags: Google, Agent工具, 编程, 开源 cover: ../covers/gemini-cli-0.68.0.png source: GitHub Releases origin: https://github.com/google-gemini/gemini-cli/releases/tag/v0.68.0 event_key: google-gemini/gemini-cli@v0.68.0

11 月 11 日，Google 发布 Gemini CLI v0.68.0。33 条变更里，面向终端用户的新功能只有一条，其余全是 fix、refactor 与文档修补。

对每天在终端里跑 Agent 的人来说，这比一次功能堆叠更值得读——它暴露了项目当前认为最痛的地方。

一、变更构成：修的地方几乎都在运行时的内部机制

按 commit 前缀统计，和内核相关的有 15 条，终端交互 10 条，UI、hooks、沙箱、IDE 插件合计 4 条，文档与 CI 4 条。唯一的新功能是 feat(cli): add extension validation command。

发布节奏也印证了这个判断：同一天还发了 v0.69.0-preview.0。preview 轨道收新东西，stable 轨道只收修复，典型的双轨策略。

二、三条真正影响正确性的修复

提示词里的美元符号被当成了变量

fix(core): prevent $-pattern corruption in LLM prompt templates 修的是模板占位符替换时，把用户输入里的字面 $ 吃掉。

这类问题最麻烦的地方在于静默：不报错、不崩溃，只是发给模型的提示词被改写了。输出偏差要过很久才能归因。

流式响应的最后一批事件可能丢

fix(core): flush pending SSE event buffer at stream EOF 指向 CodeAssistServer 在流结束时没有冲刷缓冲区。

长任务里最后一批事件往往是工具调用的结果，可能在 EOF 处被丢掉。表现出来就是「步骤显示成功，文件却没改」。

符号链接没有规范化

fix(core): resolve symlinked paths canonically in GlobTool 修完后，同一文件不会被重复计入，经由软链指向工作区外的目标也不会被意外读进来。

三条的共同点是不产生崩溃，只产生难以复现的错误结果。对 Agent 来说，这比崩溃更难处理。

三、平台、状态与扩展生态

Windows 相关的四条

• isWithinRoot 改为大小写不敏感（#29999）。Windows 路径本身不区分大小写，旧逻辑会把合法路径判成越界，工具调用直接被拒。
• IDE 进程查找加了 PowerShell CIM 回退（#30006）。新系统上 wmic 已退场，旧路径查不到进程。
• 处理 libuv 在无设备机器上报告 0 设备的情况，避免安全读取文件时误判。
• UI 截断按 surrogate pair 处理（#29993），emoji 与部分扩展区汉字不再被截成半个字符。

模型与会话状态的五条

临时降级、取消、rewind 之后仍保持所选模型（#30059）；动态模型配置开启且关闭 preview 权限时，/model 里仍列出 Auto（#29998）；显式指定的 gemini-2.5-flash 不会被动态解析覆盖（#30057）。

supportsMultimodalFunctionResponse 能识别带点号的 Gemini 3 模型名（#29982）；ACP 的 session/load 先等历史回放完成再响应（#30112）。

单看每一条都很细，组合起来就是「我明明选了 A 模型，跑着跑着变成 B」。终端、IDE 插件、ACP 客户端三条入口共用一套会话状态，任何一处没对齐都会放大成不可解释的行为差异。同类问题在 DeepSeek Harness 的插件化运行时 里也有，只是那边选择用架构隔离来规避。

扩展生态开始立规矩

扩展是这类工具增长最快的部分，也是事故最多的部分。这一版给了三条约束：新增扩展校验命令与评测测试，安装前可先验证结构；并发安装按扩展粒度加锁（#30039），避免两个进程同写一个目录；扩展发布包下载流失败时不再算作安装成功（#30100）。

配套还有两条：VS Code 伴生插件把所有 disposable 注册进 context.subscriptions（#29994），解决卸载后监听器残留；hooks 支持 SubagentStop 事件映射并合并多份定义（#30111）。

四、升级建议与一点判断

没有破坏性变更，建议直接升级，Windows 用户收益最大。

两处行为变化需要留意：hooks 的同名定义现在会合并而不是覆盖，依赖旧覆盖行为的配置要复核；shadow repo 开始遵守 .git/info/exclude 与 core.excludesFile（#30034），被忽略的文件不再进入检查点。

沙箱用户还有一条，rootless podman 补上了 --userns=keep-id（#30118）。

回到开头：0.68 是一次「降低方差」的发布，不增加能力，只减少失败路径。Agent 类工具的竞争点正在从功能清单转向失败率，一次会话里少一次静默错误，比多一个命令更有价值。

用同一把尺子看同行，TRAE 在拼入口的双形态、Qoder CN 在拼改名后的补位，而 Gemini CLI 这一版选的是把地基夯实。