Gemini CLI v0.64.0 转正:文件写入原子化、状态崩溃可恢复、Ctrl+C 紧急中止到位
Gemini CLI v0.64.0 于 2026-10-13 转正:文件写入原子化、状态损坏可从备份恢复、Ctrl+C 紧急中止可达取消处理器,ACP 用量回传与 A2A 设置迁移。
2026-10-14 · Gemini CLI 官方仓库 Release Notes(tag v0.64.0,published 2026-10-13T20:44:46Z,经 GitHub Releases API 逐 tag 一手核对)
发布 2026-10-14核实 2026-10-14要点速览
- v0.64.0 已于 2026-10-13 20:44 UTC 转正为 stable,结束了 v0.63.0 自 10-06 起连续七天的 stable 停滞。
- 这一版没有任何新模型或新能力,官方 Release Notes 从头到尾是 fix / chore / refactor——主线是还债:崩溃、卡死、状态损坏。
- 三条对日常使用最有感的修复:文件工具操作串行化且写入原子化(#29499)、CLI 状态原子持久化且损坏时从备份恢复(#29558)、Ctrl+C 紧急中止能真正抵达取消处理器(#29586)。
- 协议层补齐:ACP 用量回传(#29549,桥接
PromptResponse.usage并发出usage_update通知)、A2A server 的 V1→V2 设置迁移(#29450)。 - headless 模式下的目录信任状态终于会正确传递(#29528)——脚本化调用此前可能拿到与交互模式不一致的信任判定。
通道现状(2026-10-14 逐 tag 核对)
| 通道 | 版本 | 发布时间(UTC) | 说明 |
|---|---|---|---|
| Stable | v0.64.0 | 2026-10-13 20:44 | 生产环境应钉在这一版 |
| Preview | v0.65.0-preview.0 | 2026-10-13 20:27 | 比 stable 早 17 分钟——数字更大但不是稳定版 |
| Nightly | v0.65.0-nightly.20261013.g51617c1bc | 2026-10-13 01:36 | 每日构建,勿用于 CI |
老规矩再强调一次:选版按通道不按数字。 v0.65.0-preview.0 与 nightly 的数字都比 stable 的 v0.64.0 大,但只有 v0.64.0 是生产可用。另外,通过 Releases API 取「第一条 release」会先拿到 alpha / nightly / draft,必须显式过滤 prerelease 与 draft——这次若不过滤,取到的是 v0.65.0-preview.0。
这版修的是什么:三类债
① 崩溃与状态损坏(最该升级的理由)
| PR | 修复内容 | 为什么重要 |
|---|---|---|
| #29499 | fix(core): serialize file tool operations and make writes atomic | 文件工具操作串行化 + 写入原子化。此前并发写同一文件可能留下半截内容 |
| #29558 | fix(cli): persist state atomically and recover from backup on corruption | 状态文件原子写入,损坏时能自动从备份恢复——长会话中断不再直接丢状态 |
| #29568 | fix(core): append-only delta patching and bounded history windowing in ChatRecordingService | 会话记录改为 append-only 增量 + 有界历史窗口,长时间跑不再无限膨胀 |
这三条放在一起看意思很明确:Gemini CLI 之前在「进程被杀 / 磁盘写满 / 会话跑很久」这几种场景下是比较脆的。如果你的用法是长任务 + 后台跑,v0.64.0 是值得立刻升的版本。
② 交互卡死与误吞输入(日常体感最强)
- #29586 ——
ensure Ctrl+C emergency abort reaches cancellation handler during active operations。这是本次最实用的一条:此前在活跃操作中按 Ctrl+C,「紧急中止」未必能真正传到取消处理器,也就是你想停未必停得下来。 - #29581 ——
resolve @file:line references and prevent ghost text wrap hang。@file:line引用解析 + 修掉 ghost text 换行卡死。 - #29557 ——
prevent CPU hang and quote swallowing on @ within code。代码块里的@会吞掉引号并让 CPU 挂住。 - #29520 ——
preserve scroll position and partition pending height budget。滚动位置不再跳。 - #29502 ——
ensure Enter and Spacebar reliably confirm selection list options。选择列表的确认键此前会失灵。
③ 协议与平台(ACP / A2A / Windows)
- #29549 ——
fix(acp): bridge PromptResponse.usage and emit usage_update notifications。ACP 侧的用量现在会回传,对接了 ACP 的 IDE / 客户端终于能显示真实 token 消耗。 - #29580 ——
fix(acp): resolve session by exact id and handle listener cleanup on session failure。按精确 ID 解析会话 + 失败时清理监听器。 - #29450 ——
refactor(a2a-server): implement V1 to V2 settings migration logic。A2A server 设置从 V1 迁到 V2。 - #29528 ——
fix(cli): propagate resolved folder trust state in headless mode。headless 下的目录信任状态正确传递。 - #29560 ——
fix(ui): ensure Windows ConPTY forwards IME cursor position。Windows 终端中文 / 日文输入法候选框位置不再错位。 - #29540 ——
fix(cli): retry directory removal on Windows locking errors during extension updates。Windows 文件锁导致扩展更新失败的问题加重试。
对开发者的影响
① 跑生产 / CI 的:钉 v0.64.0,别动。 这一版是纯修复版,回归风险低于跨功能版本,升级收益(原子写 + 崩溃恢复)大于风险。
② 用 headless 写脚本的:升级后复核一次信任判定。 #29528 修的是「信任状态没传下去」,意味着你之前的脚本可能一直跑在错误的信任状态上——修完之后行为可能变化,尤其是那些依赖目录信任放行工具调用的自动化。
③ 用 ACP 接 IDE 的:用量数字现在才可信。 升级前看到的 token 统计可能不完整(#29549)。
④ 长会话用户:状态损坏终于能自愈。 但别把「能恢复」当「不用备份」——恢复依赖备份文件是否存在,重要会话仍建议自己留 transcript。
⑤ 别急着上 v0.65.0-preview.0。 它比 stable 早 17 分钟发布,且从版本号看是下一个功能周期的开端,preview 通道历来不稳定。
AI 之家 观点
这一版最有趣的不是修了什么,而是它推翻了本站一周前的判断。 我们在 v0.63.0 停滞时写过:「连续多轮没有新稳定版,通常意味着一个较大的改动正在 preview 通道里憋着」。结果 v0.64.0 转正后打开一看——没有新功能,全是 fix。 这条推断错了,值得记下来:
stable 通道停滞 ≠ 大功能在憋。它同样可能是「修一批不好看但必须修的债,修完才敢开新周期」。
工程节奏上这是成熟信号,不是懈怠信号。 一个 agent 工具在跑了一年之后,真正的瓶颈往往不是「还能加什么能力」,而是**「它在你最不想它崩的那一刻会不会崩」**。原子写(#29499)、状态备份恢复(#29558)、Ctrl+C 真正能中断(#29586)——这三条都不是 feature,但它们决定了你敢不敢把 6 小时的重构任务丢给它跑。
第二个观察:可靠性债的偿还顺序很有讲究。 这版把「崩溃/损坏」放在最前,「交互体感」在第二批,「协议与平台」在最后。优先级排序暴露了团队听谁的声音——先修会丢数据的,再修会烦人的,最后修对接方的。对比 Claude Code 近期几个版本把企业管控(模型白名单、策略下发)排在前面,两家团队面对的是完全不同的客户结构:一个在收敛个人开发者的信任,一个在拿下企业 IT 部门。选型时看 changelog 的排序,比看 feature 列表更能判断这个工具未来半年会往哪走。
待核实
- v0.64.0 的厂商公布发布日:Release Notes 页面上的
published_at为 2026-10-13T20:44:46Z(GitHub Releases API 一手数据),但该字段是 tag 发布时间,未必等于官方公告发布日,本站按 API 时间戳记录并在此声明。 - v0.65.0-preview.0 的具体内容:官方 Release Notes 未在本次核对中展开,未获知功能清单。
- Gemini 4 Argon 是否已进入 CLI 模型列表:v0.64.0 的 Release Notes 中未出现任何模型相关条目;Argon 虽已于 2026-10-13 全球开放(见 发布资讯),本站未核对 CLI 侧模型清单,不作为确定事实写入。
- #29450 A2A 设置 V1→V2 迁移的兼容性影响:仅有 PR 标题,未读 PR 正文与迁移文档,升级前建议自测 A2A server 配置。
来源
- Gemini CLI Releases 官方仓库
- Release v0.64.0 Release Notes(tag 页面,2026-10-13T20:44:46Z,一手核对)
- v0.63.0...v0.64.0 Full Changelog 对比页
- 关键 PR:#29499(原子写)、#29558(状态恢复)、#29586(Ctrl+C)、#29549(ACP 用量)、#29528(headless 信任)
- 延伸阅读:Gemini CLI 工具卡、Gemini 4 Argon 发布资讯、Claude Code 工具卡、Codex 工具卡
口径说明:本文版本号、发布时间戳与 PR 编号均经 GitHub Releases API 逐 tag 一手核对(
prerelease与draft已显式过滤)。PR 标题为官方原文,功能描述由标题归纳,其中 #29450 的兼容性影响未读 PR 正文,已列入待核实。凡官方未给出的内容,本站不推断。