最新稳定版本：v0.22.0 - v0.22.5

最新稳定版本：v0.22.0 - v0.22.5

发布日期：2025年12月30日

对于大多数用户来说，我们推荐使用最新稳定版本。安装最新稳定版本的命令如下：

npm install -g @google/gemini-cli

亮点

• 全面的配额可见性： 在 /stats 命令中查看所有可用模型的用量统计，即使是在当前会话中尚未使用的模型也可查看。（图片，pr 由 @sehoon38 提交）
• 完善的CLI统计信息： 我们已清理了 /stats 视图，以便优先显示可操作的配额信息，并在 /stats model 中提供了详细的令牌和缓存效率分析（使用Google登录，API密钥，模型统计，pr 由 @jacob314 提交）
• 多文件拖放： 现已支持多文件拖放，并且正确翻译为以 @ 为前缀的命令。（pr 由 @jackwotherspoon 提交）

变更内容

（以下部分未提供英文原文，故不进行翻译）

• 功能(IDE): 如果没有设置 GEMINI_CLI_IDE_AUTH_TOKEN 环境变量，则由 @skeshive 在 https://github.com/google-gemini/gemini-cli/pull/14843 中提出的更改将回退使用。
• 功能: 在 /stats 中显示未使用模型的配额统计，由 @sehoon38 在 https://github.com/google-gemini/gemini-cli/pull/14764 中提出。
• 功能: 确保 codebase 调查员在主代理使用预览模型时也使用，由 @abhipatel12 在 https://github.com/google-gemini/gemini-cli/pull/14412 中提出。
• 任务: 为过时的错误工作流程添加关闭原因，由 @galz10 在 https://github.com/google-gemini/gemini-cli/pull/14861 中提出。
• 发送模型和 CLI 版本随用户代理信息，由 @gundermanc 在 https://github.com/google-gemini/gemini-cli/pull/14865 中提出。
• 重构(会话): 将会话概要生成移动到启动时，由 @jackwotherspoon 在 https://github.com/google-gemini/gemini-cli/pull/14691 中提出。
• 限制路径校正器的搜索深度，由 @scidomino 在 https://github.com/google-gemini/gemini-cli/pull/14869 中提出。
• 修复: 修正代码注释中的拼写错误，由 @kuishou68 在 https://github.com/google-gemini/gemini-cli/pull/14671 中提出。
• 功能(核心): 为模型配置的延迟解析提供管道，由 @joshualitt 在 https://github.com/google-gemini/gemini-cli/pull/14597 中提出。
• 功能: 尝试更多的错误解析，由 @adamfweidman 在 https://github.com/google-gemini/gemini-cli/pull/14899 中提出。
• 添加缺失的 await，由 @gundermanc 在 https://github.com/google-gemini/gemini-cli/pull/14910 中提出。
• 功能(核心): 为 git-ai/Gemini 扩展的钩子添加对 transcript_path 的支持，由 @svarlamov 在 https://github.com/google-gemini/gemini-cli/pull/14663 中提出。
• 重构: 使用可区分的联合实现 DelegateToAgentTool，由 @abhipatel12 在 https://github.com/google-gemini/gemini-cli/pull/14769 中提出。
• 功能: 在 /auth 时重置 availabilityService，由 @adamfweidman 在 https://github.com/google-gemini/gemini-cli/pull/14911 中提出。
• 任务/发布: 将版本升级到 0.21.0-nightly.20251211.8c83e1ea9，由 @gemini-cli-robot 在 https://github.com/google-gemini/gemini-cli/pull/14924 中提出。
• 修复: 正确检测 Model Context Protocol 工具错误，由 @kevin-ramda 提出。

以下是翻译后的简体中文文本：

【术语表】

• CLI: CLI(命令行界面)
• command-line interface: 命令行界面
• Shell: Shell
• Bash: Bash
• API: API
• endpoint: 端点
• token: 令牌
• Model Context Protocol: Model Context Protocol(模型上下文协议)
• MCP: MCP
• Markdown: Markdown
• JSON: JSON
• YAML: YAML
• Mermaid: Mermaid
• npm: npm
• pip: pip
• git: git
• repository: 仓库
• package: 包
• dependency: 依赖
• configuration: 配置
• environment variable: 环境变量
• workspace: 工作空间
• directory: 目录
• file: 文件
• script: 脚本
• plugin: 插件
• extension: 扩展
• integration: 集成
• authentication: 认证
• authorization: 授权
• credential: 凭证
• session: 会话
• context: 上下文
• prompt: 提示词
• completion: 补全
• streaming: 流式
• model: 模型
• provider: 提供商
• service: 服务
• request: 请求
• response: 响应
• header: 头部
• body: 主体
• payload: 负载
• error: 错误
• exception: 异常
• warning: 警告
• debug: 调试
• logging: 日志
• telemetry: 遥测
• analytics: 分析
• monitoring: 监控
• performance: 性能
• latency: 延迟
• throughput: 吞吐量
• concurrency: 并发
• thread: 线程
• process: 进程
• daemon: 守护进程
• background: 背景
• foreground: 前台
• interactive: 交互式
• batch: 批处理
• queue: 队列
• cache: 缓存
• database: 数据库
• storage: 存储
• memory: 内存
• disk: 磁盘
• network: 网络
• protocol: 协议
• HTTP: HTTP
• HTTPS: HTTPS
• WebSocket: WebSocket
• REST: REST
• GraphQL: GraphQL
• RPC: RPC
• SDK: SDK
• library: 库
• framework: 框架
• runtime: 运行时
• build: 构建
• deploy: 部署
• release: 发布
• version: 版本
• changelog: 更新日志
• migration: 迁移
• compatibility: 兼容性
• breaking change: 破坏性变更
• feature: 功能
• bug fix: 错误修复
• improvement: 改进
• enhancement: 增强
• refactor: 重构
• documentation: 文档
• tutorial: 教程
• example: 示例
• demo: 演示
• test: 测试
• unit test: 单元测试

【原文】

• chore(deps): upgrade dependency ss in https://github.com/google-gemini/gemini-cli/pull/14937
• increase labeler timeout by @scidomino in https://github.com/google-gemini/gemini-cli/pull/14922
• tool(cli): 调整前端工具以识别更多来自 CLI 的核心文件 by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/14962
• feat(cli): 优化缓存令牌统计并简化存在配额时的统计显示。 by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/14961
• feat(settings-validation): 为设置架构添加验证 by @lifefloating in https://github.com/google-gemini/gemini-cli/pull/12929
• fix(ide): 更新 IDE 扩展以在环境变量中写入认证令牌 by @skeshive in https://github.com/google-gemini/gemini-cli/pull/14999
• 撤销 “chore(deps): 将 express 从 5.1.0 升级到 5.2.0” by @skeshive in https://github.com/google-gemini/gemini-cli/pull/14998
• feat(a2a): 引入 a2a 服务器 /init 命令 by @cocosheng-g in https://github.com/google-gemini/gemini-cli/pull/13419
• feat

快照用于差异对比。由 @jacob314 在 https://github.com/google-gemini/gemini-cli/pull/14983

• 在 package.json 中添加许可证字段 由 @jb-perez 在 https://github.com/google-gemini/gemini-cli/pull/14473
• 功能：持久化“始终允许”策略，具有细粒度的 Shell 和 MCP 支持 由 @allenhutchison 在 https://github.com/google-gemini/gemini-cli/pull/14737
• 任务/发布：将版本升级至 0.21.0-nightly.20251212.54de67536 由 @gemini-cli-robot 在 https://github.com/google-gemini/gemini-cli/pull/14969
• 修复（核心）：commandPrefix 单词边界和复合命令安全性 由 @allenhutchison 在 https://github.com/google-gemini/gemini-cli/pull/15006
• 任务/文档：在 CONTRIBUTING.md 中添加“仅限维护者”标签信息 由 @jacob314 在 https://github.com/google-gemini/gemini-cli/pull/14914
• 刷新扩展时刷新钩子。由 @scidomino 在 https://github.com/google-gemini/gemini-cli/pull/14918
• 增加错误信息的清晰度 由 @gsehgal 在 https://github.com/google-gemini/gemini-cli/pull/14879
• 任务：移除一个多余的小提示 由 @JayadityaGit 在 https://github.com/google-gemini/gemini-cli/pull/14947
• 任务/发布：将版本升级至 0.21.0-nightly.20251213.977248e09 由 @gemini-cli-robot 在 https://github.com/google-gemini/gemini-cli/pull/15029
• 禁止多余的类型转换。由 @gundermanc 在 https://github.com/google-gemini/gemini-cli/pull/15030
• 修复（认证）：优先使用 GEMINI_API_KEY 环境变量，并跳过不必要的关键… 由 @galz10 在 https://github.com/google-gemini/gemini-cli/pull/14745
• 修复：使用 zod 进行安全检查结果验证 由 @allenhutchison 在 https://github.com/google-gemini/gemini-cli/pull/15026
• 更新（遥测）：将 hashed_extension_name 字段添加到扩展事件中 由 @kiranani 在 https://github.com/google-gemini/gemini-cli/pull/15025
• 修复：类似于策略引擎，在非交互模式下需要工具执行确认时抛出错误 由 @MayV 在 https://github.com/google-gemini/gemini-cli/pull/14702
• C

【译文】 通过 @scidomino 整合测试中清理进程 https://github.com/google-gemini/gemini-cli/pull/15102

• 文档：更新策略引擎入门和默认设置 by @NTaylorMullen https://github.com/google-gemini/gemini-cli/pull/15105
• 通过在 functionResponse 中封装内容修复工具输出碎片化 by @abhipatel12 https://github.com/google-gemini/gemini-cli/pull/13082
• 简化方法签名。 by @scidomino https://github.com/google-gemini/gemini-cli/pull/15114
• 在 JSON 输出中显示原始输入令牌计数。 by @jacob314 https://github.com/google-gemini/gemini-cli/pull/15021
• 修复：将 A2A 请求标记为交互式 by @MayV https://github.com/google-gemini/gemini-cli/pull/15108
• 使用 previewFeatures 确定A2A使用哪个pro模型 by @sehoon38 https://github.com/google-gemini/gemini-cli/pull/15131
• 重构(cli)：修复设置合并，使得使用新 JSON 格式的设置优先于使用旧格式的设置 by @jacob314 https://github.com/google-gemini/gemini-cli/pull/15116
• 修复(patch)：将 a6d1245 拣选到 release/v0.22.0-preview.1-pr-15214 以修补版本 v0.22.0-preview.1 并创建版本 0.22.0-preview.2 by @gemini-cli-robot https://github.com/google-gemini/gemini-cli/pull/15226
• 修复(patch)：将 9e6914d 拣选到 release/v0.22.0-preview.2-pr-15288 以修补版本 v0.22.0-preview.2 并创建版本 0.22.0-preview.3 by @gemini-cli-robot https://github.com/google-gemini/gemini-cli/pull/15294

完整更新日志： https://github.com/google-gemini/gemini-cli/compare/v0.21.3…v0.22.0

完整更新日志： 比较版本 v0.21.3 与 v0.22.0 的更新内容。