🚀
快速强大
查询和编辑超出 Gemini 1M token 上下文窗口的大型代码库
Gemini CLIAI 驱动的命令行工具
连接您的工具，理解您的代码，加速您的工作流程
Skip to content
🔄 上游最新更新
版本状态
- 当前版本: v0.1.9
- 分支状态: 已同步至最新 ✅
- 文档: 完全同步，支持中英双语
最近同步 (2025-07-04)
从上游合并了 11 个新提交，包含发布自动化和重要修复：
🎉 重大功能更新
- 🚀 发布自动化: 添加 GitHub Actions 和标签发布流程 (#2852)
- 🔧 JSDoc改进: 为核心工具方法添加和改进 JSDoc 注释 (#3128)
- 🧮 Reducer重构: 重构文本缓冲区使用 reducer 模式 (#2652)
- 📝 文档新增: 添加 NPM 工作区和发布指南
🐛 技术修复
- 🎨 主题修复: 修复 ANSI 主题中的蓝色显示 (#3100)
- 🆔 用户ID修复: 修复 Google 用户 ID 传递给 Clearcut (#3147)
- ⚙️ 配置修复: 修复客户端在 flashFallbackHandler 中获取模型配置 (#2118)
- 🎯 快捷键: 显示 Ctrl+S 快捷键展开调试控制台 (#2491)
- 🔧 代码清理: 移除不必要的空白字符和修复拼写错误
🌟 分支增强功能
此分支通过以下方式提供附加价值：
- 完整的中文翻译 覆盖所有文档
- 双语README 支持便捷的语言切换
- 实时同步 上游更改
- 详细的更新日志 追踪所有上游修改
📋 完整的上游更新日志
本文档总结了从我们的分叉开始到最新上游主分支的所有更改。
更新历史
2025-07-12 更新
主要更改
- 剪贴板支持: 为 macOS 添加剪贴板图片粘贴支持
- UI 改进: 主题对话框添加滚动功能，修复 Markdown 渲染中的额外空白
- 路径修复: 修复 Gemini 尝试在需要绝对路径的地方使用相对路径的问题
- 新功能: 添加 --prompt-interactive/-i 标志支持
- 日志增强: 添加 Flash 回退日志和 clearcut 日志记录
- OAuth 改进: 添加 OAuth 测试，修复未定义 authType 的错误
- 视觉提示: 为夜间版本添加视觉提示
- 斜杠命令: 将 /theme 更新到新的斜杠命令架构
- MCP 支持: 为 SSE 传输 MCP 服务器添加 headers 支持
- 文档修复: 修复 README.md 中关于 Vertex AI API 密钥的拼写错误
- 系统指令: 确保系统指令也使用 <state_snapshot>
2025-07-09 更新
主要更改
- 系统管理: 新增系统级设置配置支持，允许管理员在企业环境中控制 Gemini CLI 设置
- API 增强: 工具调用和 API 响应中添加 TurnId 以改善错误日志
- MCP 服务器: 使用 yargs 数组类型处理 allowedMcpServerNames 标志
- 错误处理: 改进配额和资源相关的 429 错误处理，支持 Code Assist 客户等级
- 依赖管理: 更新多个依赖包，包括 google-auth-library、dotenv、ws 等
- 终端优化: 在 --help 命令中使用完整终端宽度显示
- 服务条款: 更新服务条款和隐私声明以提高清晰度
- 调试功能: 修复 MCP 服务器的调试标志问题
- 配额管理: 在 Flash 模型发生 429/配额故障切换时移除自动执行功能
2025-07-08 更新
- 提交范围: a4097ae6..9273e8dd
- 新增提交数: 17
- 版本: v0.1.9
2025-07-07 更新
- 提交范围: 39d4095a..a4097ae6
- 新增提交数: 22
- 版本: v0.1.9
2025-07-06 更新
- 提交范围: 8adc5869..39d4095a
- 新增提交数: 9
- 版本: v0.1.9
2025-07-05 更新
- 提交范围: ef736f0d..8adc5869
- 新增提交数: 11
- 版本: v0.1.9
2025-07-04 更新
- 提交范围: 85a1d814..ef736f0d
- 新增提交数: 11
- 版本: v0.1.9
2025-07-03 更新
- 提交范围: 08ce78a1..85a1d814
- 新增提交数: 5
- 版本: v0.1.9
2025-07-02 更新
- 提交范围: 58b14b7c..cd069fd4
- 新增提交数: 13
- 版本: v0.1.7 → v0.1.9
2025-07-01 更新
- 提交范围: 5c4c833d..58b14b7c
- 新增提交数: 17
- 版本: v0.1.7
2025-06-30 更新
- 提交范围: 4e8a6400..5c4c833d
- 新增提交数: 22
- 版本: v0.1.7
2025-06-29 更新
- 提交范围: ad7839ea..fc21d1ca
- 新增提交数: 15
- 版本: v0.1.7
2025-06-28 更新
- 提交范围: 6742a1b7..ad7839ea
- 新增提交数: 19
- 版本: v0.1.5 → v0.1.7
2025-06-27 更新
- 提交范围: c55b15f7..6742a1b7
- 新增提交数: 5
2025-06-26 初次同步
- 版本: 0.1.1 → 0.1.5
- 提交范围: 05b9b9ab..c55b15f7
- 总提交数: 30
最新更改（2025-07-08）
🔧 依赖管理和质量提升
- #3557 - 🔧 修复 shell-quote 版本
- #2972 - 🤖 添加 Dependabot 配置
- #2992 - 🔐 添加 CodeQL 分析
- #3511 - 🐛 修复夜间发布
- #3500 - 📝 添加通用使用信息到 --help 消息
- #3093 - 🚀 在分叉仓库中禁用计划任务
🔧 CLI 改进和标准化
- #3541 - 🔧 标志标准化: 统一所有标志使用连字符（弃用下划线标志）
- #3191 - 🔧 添加命令行选项以启用和列出扩展
- #3560 - 🔧 遵守 DEBUG 和 CLI_TITLE 环境变量
- #3545 - 🐛 不强制前导斜杠，因为这在 Windows 上不成立
- #3506 - 🐛 修复 Windows 上 start.js 的无限循环
🔐 认证和验证改进
- #3235 - 🔐 认证修复: 不盲目默认使用 API 密钥认证
- #3568 - 🐛 修复模型检查中的错误请求
- #1381 - 🔧 改进认证环境变量验证逻辑和消息
- #2881 - 🔧 改进函数调用参数验证和类型定义
🎯 性能和体验优化
🔧 MCP 改进和认证增强（2025-07-07）
- #3489 - 📦 发布和打包清理
- #3070 - 🔐 Cloud Shell 支持: 让 Gemini CLI 在 Cloud Shell 中重用用户认证
- #3060 - 📝 更新 README 显示 Vertex 的 API 密钥使用
- #3483 - 🚀 在启动时初始化 MCP 工具，而非每次认证时
- #3469 - 🔧 重命名 allowed_mcp_server_names 为 allowed-mcp-server-names
- #3464 - 🔧 添加 --allowed_mcp_server_names 标志
- #2976 - 🔧 为 mcpServers 配置添加 excludeTools 和 includeTools
- #3175 - 💫 斜杠命令重构: 重构斜杠命令 + 未来愿景
🐛 修复和改进
- #3493 - 🐛 修复认证对话框中的双 "esc" 错误
- #3491 - 📝 修复拼写错误并添加认证验证测试
- #2919 - 🔧 防止 Tab 自动执行不完整的斜杠命令
- #3043 - 🐛 修复 EditTool 可能覆盖同一文件的人工编辑
- #3360 - 🔧 重新启用 shell 工具中的反引号使用
- #3229 - 🎨 添加 .svg 支持
- #3387 - 🐛 @file 不遵守 config respectGitIgnore=false
- #3362 - 🐛 修复表格标题和行的嵌套 markdown 渲染
- #3416 - 🔧 在 settings.json 变量替换中遵守 .env 的环境变量
- #3349 - 📝 改进 isCommandAllowed 中的错误消息
🎯 新功能和重要修复（2025-07-06）
- #3367 - 🚀 YOLO模式: 在 /help 中显示 YOLO 模式快捷键
- #3056 - ⚠️ 添加用户启动警告和主目录检查
- #3339 - 📦 更新 @google/genai 到 1.8.0
- #2883 - 🔧 处理工具调度器中的内联内容修改
- #2932 - 🐛 修复 #2922: 防止在 shell 模式中 @ 连接到有效路径
- #3300 - 🔧 清理工具参数以修复 400 API 错误
- #3335 - 🧹 清理发布提示
- #3321 - 📦 发布：清理和精简
- #3333 - 🐛 分组取消的工具调用响应以防止 API 错误
🚀 Node.js 20 升级和发布改进（2025-07-05）
- #3277 - 📦 重要: 更新最低 Node.js 版本要求到 20
- #3247 - 📝 更新 README 要求 Node.js 20+
- #3264 - 🔏 签名夜间发布提交
- #3254 - 🔏 签名标签
- #3206 - 📦 夜间发布标签格式化
- #3285 - 🔧 添加 nohup 支持
- #3183 - 📝 修复小拼写错误
- #3284 - 📝 修复多个文件中的拼写错误
- #3203 - 📝 修复拼写错误
- #2862 - 📝 修复 deployment.md 中的命令使用问题
- #3167 - 🔧 更新问题模板使用 GitHub alert
🚀 发布自动化和技术改进（2025-07-04）
- #3204 - 📦 新增夜间发布标签格式化
- #3202 - 🔧 修复夜间发布标签
- #2852 - 🚀 添加发布自动化流程和GitHub Actions
- #2652 - 🧮 重构文本缓冲区使用reducer模式
- #3128 - 📝 为核心工具方法添加和改进JSDoc注释
- #3147 - 🆔 修复Google用户ID传递给Clearcut
- #2118 - ⚙️ 修复客户端在flashFallbackHandler中获取模型配置
- #2491 - 🎯 显示Ctrl+S快捷键展开调试控制台
- #3100 - 🎨 修复ANSI主题蓝色显示
- #2781 - 🧹 移除不必要的空白字符
- #2722 - 📝 修复CONTRIBUTING.md中的拼写错误
🎯 UI和工作流改进（2025-07-03）
🎉 版本发布 v0.1.9（2025-07-02）
重大功能更新
- #2556 - 🎵 多媒体支持: 为 read_file 添加音频和视频支持
- #2793 - 🔄 无限循环保护: 为客户端添加无限循环保护机制
- #2886 - 🆔 会话支持: 在 API 调用中添加 session_id 支持
- #2853 - 🛠️ 扩展增强: 为扩展添加 excludedTools 功能
用户体验改进
Bug 修复
文档更新
其他改进
之前的更改（2025-07-01）
新功能和改进
身份验证和认证改进
Bug 修复
- #2794 - 🐛 修复 Ink6 + React19 迁移导致的 MaxSizedBox 无效子元素日志问题
- #1990 - 🔧 使清理脚本跨平台兼容
- #2762 - 🔗 在文档中使用 HTTPS 并修复故障排除指南格式错误
- #2712 - 🔧 修复 CODE_ASSIST_ENDPOINT 环境变量
工作流和自动化改进
- #2778 - 🤖 改进自动化问题分类工作流
- #2759 - 🔧 在分类工作流中使用预览版本的 gemini-cli
- #2749 - 📋 向自动分类工作流添加问题列表命令
- #2746 - 🔄 将问题分类分离为两个工作流
代码清理和优化
之前的更改（2025-06-30）
主要功能更新
- #2709 - 🔐 修复 OAuth 凭证缓存问题
- #2653 - 🛠️ 为 shell 命令启用前缀匹配以实现灵活的命令验证
- #2615 - 📊 改进 /stats 命令显示更详细的统计信息
- #2477 - 🌐 添加对远程 MCP 服务器自定义 HTTP 头的支持
- #1524 - 💡 添加 hideTips 设置选项
用户界面改进
安全与配置
文档更新
- #1985 - 📖 添加卸载说明到 README
- #1448 - 🎨 添加 Neovim 编辑器支持
- #2495 - 📝 澄清 .gemini/config.yaml 是用于 PR 审查机器人（非 CLI）
- #2592 - 🔧 修复认证设置文档标题问题
Bug 修复与优化
- #2463 - 🔧 修复 EditTool 中出现次数的复数形式
- #1875 - 🛠️ 修复 clearcut-logger.ts 中的事件名称
- #2574 - 🔄 重构：移除不必要的 "await"
- #2579 - 🔄 重构：移除不必要的断言
- #1846 - 🔄 重构：移除重复导入
- #1840 - 🔄 重构：使用 for...of 循环替代传统 for 循环
之前的更改（2025-06-29）
新功能和增强
Bug 修复和改进
- #2030 - 🛠️ 移除：删除不可操作但数量众多的调试日志
- #2478 - 🔧 修复："修改流程"临时文件的文件扩展名
- #2306 - 🔧 修复：编辑重新触发
- #2344 - 🔧 chore：为 grep 工具中的匹配添加适当的复数处理
文档更新
- #2459 - 📝 文档：修复拼写错误和语法错误
- #1790 - 📝 文档：删除 file-system.md 中的重复工具描述
- #2229 - 📝 添加：关于 CI 环境变量的故障排除说明
- #1487 - 📝 修复：纠正 create_alias.sh 中的启动脚本引用
开发和工作流改进
- #2496 - 🔧 chore(gha)：将问题分类工作流固定到特定提交
- #2254 - 🔄 重新启用：Gemini Code Assist PR 审查机器人
- #1709 - 🔧 内联：在源代码中内联 shell 工具的描述和架构
之前的更改（2025-06-28）
主要版本更新
重大技术升级
- #2096 - 重大更改: 升级至 Ink 6 和 React 19
- 这是一个重大技术栈升级，可能影响性能和兼容性
新功能
- #2059 - 添加隐私声明斜杠命令
- #1972 - 处理输入提示的 stdin，使用 readline 进行转义字符解析
- #2130 - 更新认证标签以包含 AI Studio
- #2112 - 在 about 消息中添加当前认证方法和 GCP 项目配置
- #2310 - 使用 Gemini CLI 添加问题分类
- #1152 - 为保存的检查点文件使用 2 空格缩进 (#1977)
Bug 修复和改进
- #2304 - 在工具调用不正确的情况下更新错误处理
- #2302 - 修复：添加缺失的 gaxios 依赖
- #2246 - 修复循环依赖
- #1961 - 优化回退消息，提供更多选项
- #2029 - 进一步明确需要项目 ID 的情况
- #2239 - 静默 dotenv 日志消息
版本更新
文档和修复
之前的更改（2025-06-27）
2025-06-26（新增）
功能更新
Bug 修复
- #1983 - 回滚: 撤销 "feat: Add model selection logic (#1678)"
- 撤销了之前的模型自动选择功能
开发改进
初次同步时的更改记录（2025-06-26）
2025-06-25
功能更新
- #1527 - 改进模型回退消息，使其更准确反映实际情况
- #1574 - 重大更改: 将 "Login with Google Workspace" 合并到 "Login with Google"
- #1595 - 提示用户在创建新问题前搜索现有问题
- #1608 - 使用 YAML 表单简化问题提交流程
- #1653 - 修复检查点恢复时的历史记录问题
Bug 修复
- #1405 - 修复不稳定的测试
- #1579 - OAuth 用户的 429 错误重试次数从 3 次减少到 2 次
- #1668 - 修复 429 错误处理机制
- #1688 - 修复认证对话框中的文档链接
- #1752 - 添加 Node.js 版本检查（要求 18.0.0+）
文档更新
- #1501 - 在 bug 报告模板中添加登录方法信息
- #1534 - 修复检查点文档中的配置说明
- #1571 - 新增: 服务条款和隐私政策文档
- #1625 - 更新文档并添加 FAQ 部分
- #1632 - 更新 README.md
- #1636 - 更新使用统计文档
- #1664 - 更新 LICENSE 文件
其他更改
- #1578 - 对提示进行小的样式调整
2025-06-26
功能更新
Bug 修复
- #1451 - 添加登录问题的故障排除说明
- #1488 - 修复 npx 命令中的 GitHub 仓库 URL
- #1557 - 修复 ClearcutLogger 中的 Promise 拒绝处理
- #1739 - 移除测试中不必要的 mock
- #1780 - 修复主题文档中的断链
文档更新
其他更改
重要更改总结
最新更新（2025-06-27）
- 模型选择功能已回滚 - 之前添加的自动模型切换功能被撤销
- 改进用户体验 - 添加了更清晰的错误消息和产品名称提示
- 开发流程改进 - 添加了发布前检查和 repository 字段
初次同步时的更改（2025-06-26）
1. 破坏性更改
- 认证流程简化：移除了单独的 "Login with Google Workspace" 选项
2. 新功能
智能模型选择：自动在 Gemini Pro 和 Flash 之间切换（已在 2025-06-27 回滚）- 服务条款和隐私政策文档
- YAML 格式的问题提交表单
3. 性能和稳定性改进
- 优化 429 错误处理
- 改进错误消息和用户引导
- 修复多个测试稳定性问题
4. 开发者体验
- 强制 Node.js 18.0.0+ 要求
- 改进的文档和故障排除指南
- 更好的错误处理和日志记录
迁移指南
对于使用 Google Workspace 账户的用户
- 不再需要选择单独的 "Login with Google Workspace" 选项
- 直接使用 "Login with Google" 登录
- 通过设置
GOOGLE_CLOUD_PROJECT环境变量来指定项目
对于开发者
- 确保使用 Node.js 18.0.0 或更高版本
- 更新任何依赖于旧认证流程的代码
- 查看新的隐私政策文档了解数据使用政策