Gemini CLI v0.22.0 - 更新日志

## 更新内容 * **功能(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 提交 * **功能**：确保当主代理使用预览模型时，代码库调查器也使用预览模型，由 @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 提交 * **修复**：正确检测 MCP 工具错误，由 @kevin-ramdass 在 https://github.com/google-gemini/gemini-cli/pull/14937 提交 * 增加标签器超时时间，由 @scidomino 在 https://github.com/google-gemini/gemini-cli/pull/14922 提交 * **工具(CLI)**：调整前端工具以识别更多来自 CLI 的核心文件，由 @jacob314 在 https://github.com/google-gemini/gemini-cli/pull/14962 提交 * **功能(CLI)**：优化缓存令牌统计信息，并在存在配额时简化统计信息显示，由 @jacob314 在 https://github.com/google-gemini/gemini-cli/pull/14961 提交 * **功能(设置验证)**：为设置模式添加验证，由 @lifefloating 在 https://github.com/google-gemini/gemini-cli/pull/12929 提交 * **修复(IDE)**：更新 IDE 扩展以在环境变量中写入认证令牌，由 @skeshive 在 https://github.com/google-gemini/gemini-cli/pull/14999 提交 * 撤销 "chore(deps): bump express from 5.1.0 to 5.2.0"，由 @skeshive 在 https://github.com/google-gemini/gemini-cli/pull/14998 提交 * **功能(A2A)**：为 A2A 服务器引入 /init 命令，由 @cocosheng-g 在 https://github.com/google-gemini/gemini-cli/pull/13419 提交 * **功能**：支持多文件图像拖放，由 @jackwotherspoon 在 https://github.com/google-gemini/gemini-cli/pull/14832 提交 * **修复(策略)**：在只读策略中默认允许 codebase_investigator，由 @abhipatel12 在 https://github.com/google-gemini/gemini-cli/pull/15000 提交 * **重构(IDE 扩展)**：更新端口文件名 + 将字符索引切换为基于 1 + 移除截断文本，由 @skeshive 在 https://github.com/google-gemini/gemini-cli/pull/10501 提交 * **修复(vscode-ide-companion)**：为工作区依赖项修正许可证生成，由 @skeshive 在 https://github.com/google-gemini/gemini-cli/pull/15004 提交 * **修复**：在子代理委托功能合并到稳定版之前的临时修复，用于子代理调用，由 @abhipatel12 在 https://github.com/google-gemini/gemini-cli/pull/15007 提交 * **测试**：更新 IDE 检测测试，使其在 IDE 中运行时更健壮，由 @kevin-ramdass 在 https://github.com/google-gemini/gemini-cli/pull/15008 提交 * 从统计信息显示中移除 flex。查看快照以了解差异，由 @jacob314 在 https://github.com/google-gemini/gemini-cli/pull/14983 提交 * 在 package.json 中添加 license 字段，由 @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 提交 * 在集成测试中清理进程，由 @scidomino 在 https://github.com/google-gemini/gemini-cli/pull/15102 提交 * **文档**：更新策略引擎入门指南和默认设置，由 @NTaylorMullen 在 https://github.com/google-gemini/gemini-cli/pull/15105 提交 * 通过将内容封装在 functionResponse 中来修复工具输出碎片化问题，由 @abhipatel12 在 https://github.com/google-gemini/gemini-cli/pull/13082 提交 * 简化方法签名，由 @scidomino 在 https://github.com/google-gemini/gemini-cli/pull/15114 提交 * 在 JSON 输出中显示原始输入令牌计数，由 @jacob314 在 https://github.com/google-gemini/gemini-cli/pull/15021 提交 * **修复**：将 A2A 请求标记为交互式，由 @MayV 在 https://github.com/google-gemini/gemini-cli/pull/15108 提交 * 使用 previewFeatures 确定 A2A 使用哪个专业模型，由 @sehoon38 在 https://github.com/google-gemini/gemini-cli/pull/15131 提交 * **重构(CLI)**：修复设置合并，使使用新 JSON 格式的设置优先于使用旧格式的设置，由 @jacob314 在 https://github.com/google-gemini/gemini-cli/pull/15116 提交 * **修复(补丁)**：将 a6d1245 拣选到 release/v0.22.0-preview.1-pr-15214 以修补版本 v0.22.0-preview.1 并创建版本 0.22.0-preview.2，由 @gemini-cli-robot 在 https://github.com/google-gemini/gemini-cli/pull/15226 提交 * **修复(补丁)**：将 9e6914d 拣选到 release/v0.22.0-preview.2-pr-15288 以修补版本 v0.22.0-preview.2 并创建版本 0.22.0-preview.3，由 @gemini-cli-robot 在 https://github.com/google-gemini/gemini-cli/pull/15294 提交 ## 新贡献者 * @kuishou68 在 https://github.com/google-gemini/gemini-cli/pull/14671 首次贡献 * @svarlamov 在 https://github.com/google-gemini/gemini-cli/pull/14663 首次贡献 * @jb-perez 在 https://github.com/google-gemini/gemini-cli/pull/14473 首次贡献 **完整更新日志**：https://github.com/google-gemini/gemini-cli/compare/v0.21.3...v0.22.0

## What's Changed * feat(ide): fallback to GEMINI_CLI_IDE_AUTH_TOKEN env var by @skeshive in https://github.com/google-gemini/gemini-cli/pull/14843 * feat: display quota stats for unused models in /stats by @sehoon38 in https://github.com/google-gemini/gemini-cli/pull/14764 * feat: ensure codebase investigator uses preview model when main agent does by @abhipatel12 in https://github.com/google-gemini/gemini-cli/pull/14412 * chore: add closing reason to stale bug workflow by @galz10 in https://github.com/google-gemini/gemini-cli/pull/14861 * Send the model and CLI version with the user agent by @gundermanc in https://github.com/google-gemini/gemini-cli/pull/14865 * refactor(sessions): move session summary generation to startup by @jackwotherspoon in https://github.com/google-gemini/gemini-cli/pull/14691 * Limit search depth in path corrector by @scidomino in https://github.com/google-gemini/gemini-cli/pull/14869 * Fix: Correct typo in code comment by @kuishou68 in https://github.com/google-gemini/gemini-cli/pull/14671 * feat(core): Plumbing for late resolution of model configs. by @joshualitt in https://github.com/google-gemini/gemini-cli/pull/14597 * feat: attempt more error parsing by @adamfweidman in https://github.com/google-gemini/gemini-cli/pull/14899 * Add missing await. by @gundermanc in https://github.com/google-gemini/gemini-cli/pull/14910 * feat(core): Add support for transcript_path in hooks for git-ai/Gemini extension by @svarlamov in https://github.com/google-gemini/gemini-cli/pull/14663 * refactor: implement DelegateToAgentTool with discriminated union by @abhipatel12 in https://github.com/google-gemini/gemini-cli/pull/14769 * feat: reset availabilityService on /auth by @adamfweidman in https://github.com/google-gemini/gemini-cli/pull/14911 * chore/release: bump version to 0.21.0-nightly.20251211.8c83e1ea9 by @gemini-cli-robot in https://github.com/google-gemini/gemini-cli/pull/14924 * Fix: Correctly detect MCP tool errors by @kevin-ramdass 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): tweak the frontend tool to be aware of more core files from the cli by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/14962 * feat(cli): polish cached token stats and simplify stats display when quota is present. by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/14961 * feat(settings-validation): add validation for settings schema by @lifefloating in https://github.com/google-gemini/gemini-cli/pull/12929 * fix(ide): Update IDE extension to write auth token in env var by @skeshive in https://github.com/google-gemini/gemini-cli/pull/14999 * Revert "chore(deps): bump express from 5.1.0 to 5.2.0" by @skeshive in https://github.com/google-gemini/gemini-cli/pull/14998 * feat(a2a): Introduce /init command for a2a server by @cocosheng-g in https://github.com/google-gemini/gemini-cli/pull/13419 * feat: support multi-file drag and drop of images by @jackwotherspoon in https://github.com/google-gemini/gemini-cli/pull/14832 * fix(policy): allow codebase_investigator by default in read-only policy by @abhipatel12 in https://github.com/google-gemini/gemini-cli/pull/15000 * refactor(ide ext): Update port file name + switch to 1-based index for characters + remove truncation text by @skeshive in https://github.com/google-gemini/gemini-cli/pull/10501 * fix(vscode-ide-companion): correct license generation for workspace dependencies by @skeshive in https://github.com/google-gemini/gemini-cli/pull/15004 * fix: temp fix for subagent invocation until subagent delegation is merged to stable by @abhipatel12 in https://github.com/google-gemini/gemini-cli/pull/15007 * test: update ide detection tests to make them more robust when run in an ide by @kevin-ramdass in https://github.com/google-gemini/gemini-cli/pull/15008 * Remove flex from stats display. See snapshots for diffs. by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/14983 * Add license field into package.json by @jb-perez in https://github.com/google-gemini/gemini-cli/pull/14473 * feat: Persistent "Always Allow" policies with granular shell & MCP support by @allenhutchison in https://github.com/google-gemini/gemini-cli/pull/14737 * chore/release: bump version to 0.21.0-nightly.20251212.54de67536 by @gemini-cli-robot in https://github.com/google-gemini/gemini-cli/pull/14969 * fix(core): commandPrefix word boundary and compound command safety by @allenhutchison in https://github.com/google-gemini/gemini-cli/pull/15006 * chore(docs): add 'Maintainers only' label info to CONTRIBUTING.md by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/14914 * Refresh hooks when refreshing extensions. by @scidomino in https://github.com/google-gemini/gemini-cli/pull/14918 * Add clarity to error messages by @gsehgal in https://github.com/google-gemini/gemini-cli/pull/14879 * chore : remove a redundant tip by @JayadityaGit in https://github.com/google-gemini/gemini-cli/pull/14947 * chore/release: bump version to 0.21.0-nightly.20251213.977248e09 by @gemini-cli-robot in https://github.com/google-gemini/gemini-cli/pull/15029 * Disallow redundant typecasts. by @gundermanc in https://github.com/google-gemini/gemini-cli/pull/15030 * fix(auth): prioritize GEMINI_API_KEY env var and skip unnecessary key… by @galz10 in https://github.com/google-gemini/gemini-cli/pull/14745 * fix: use zod for safety check result validation by @allenhutchison in https://github.com/google-gemini/gemini-cli/pull/15026 * update(telemetry): add hashed_extension_name to field to extension events by @kiranani in https://github.com/google-gemini/gemini-cli/pull/15025 * fix: similar to policy-engine, throw error in case of requiring tool execution confirmation for non-interactive mode by @MayV in https://github.com/google-gemini/gemini-cli/pull/14702 * Clean up processes in integration tests by @scidomino in https://github.com/google-gemini/gemini-cli/pull/15102 * docs: update policy engine getting started and defaults by @NTaylorMullen in https://github.com/google-gemini/gemini-cli/pull/15105 * Fix tool output fragmentation by encapsulating content in functionResponse by @abhipatel12 in https://github.com/google-gemini/gemini-cli/pull/13082 * Simplify method signature. by @scidomino in https://github.com/google-gemini/gemini-cli/pull/15114 * Show raw input token counts in json output. by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/15021 * fix: Mark A2A requests as interactive by @MayV in https://github.com/google-gemini/gemini-cli/pull/15108 * use previewFeatures to determine which pro model to use for A2A by @sehoon38 in https://github.com/google-gemini/gemini-cli/pull/15131 * refactor(cli): fix settings merging so that settings using the new json format take priority over ones using the old format by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/15116 * fix(patch): cherry-pick a6d1245 to release/v0.22.0-preview.1-pr-15214 to patch version v0.22.0-preview.1 and create version 0.22.0-preview.2 by @gemini-cli-robot in https://github.com/google-gemini/gemini-cli/pull/15226 * fix(patch): cherry-pick 9e6914d to release/v0.22.0-preview.2-pr-15288 to patch version v0.22.0-preview.2 and create version 0.22.0-preview.3 by @gemini-cli-robot in https://github.com/google-gemini/gemini-cli/pull/15294 ## New Contributors * @kuishou68 made their first contribution in https://github.com/google-gemini/gemini-cli/pull/14671 * @svarlamov made their first contribution in https://github.com/google-gemini/gemini-cli/pull/14663 * @jb-perez made their first contribution in https://github.com/google-gemini/gemini-cli/pull/14473 **Full Changelog**: https://github.com/google-gemini/gemini-cli/compare/v0.21.3...v0.22.0