🚀
快速强大
查询和编辑超出 Gemini 1M token 上下文窗口的大型代码库
Gemini CLIAI 驱动的命令行工具
连接您的工具，理解您的代码，加速您的工作流程
Skip to content
🔄 上游最新更新
版本状态
- 当前版本: v0.1.22
- 分支状态: 已同步至最新 ✅
- 文档: 完全同步，支持中英双语
最近同步 (2025-08-19)
从上游合并了 104 个新提交 (8月14-19日)，带来消息队列、会话记录和 Zed 集成：
🚀 重大功能更新
- 🎉 发布 v0.1.22: 包含消息队列、会话记录服务和 Zed 集成
- 🎉 发布 v0.1.21: 包含工具架构升级和遥测增强
- 📝 消息队列实现: 在流式响应期间实现消息队列功能
- 💾 自动会话记录: 引入核心聊天记录服务实现自动对话保存
- 🏢 Zed 编辑器集成: 通过 Zed 读写文件，支持多文件夹工作空间
- 🔧 工具架构现代化: 大规模迁移工具到声明式模式
🔧 新功能和改进
- 🛡️ 隐私设置钩子: 添加隐私设置钩子和测试
- 📊 文件变更跟踪: 为会话指标添加文件变更跟踪
- 🔒 安全字符处理: 处理文件路径中的特殊字符
- 🌐 OAuth 增强: 支持 GitHub OAuth 和资源参数
- ⚡ 非递归文件搜索: 引入非递归文件搜索策略
- 🔧 终端设置命令: 为 Shift+Enter 和 Ctrl+Enter 支持添加终端设置
- 📱 文件夹信任管理: 支持 trustedFolders.json 配置文件
- 🎨 UI 改进: 修复主题行为、输入处理和差异显示
🔧 工具和改进
- 📦 Google/genai v1.9.0: 更新到最新版本并支持 parametersJsonSchema
- 🎯 工具摘要: 集中化 shell 工具摘要和字母排序
- ⌨️ 快捷键: CTRL+C 清除输入缓冲区功能
- 🔧 MCP 增强: 支持服务器白名单/黑名单配置
🌟 分支增强功能
此分支通过以下方式提供附加价值：
- 完整的中文翻译 覆盖所有文档
- 双语README 支持便捷的语言切换
- 实时同步 上游更改
- 详细的更新日志 追踪所有上游修改
📋 完整的上游更新日志
本文档总结了从我们的分叉开始到最新上游主分支的所有更改。
更新历史
2025-08-19 更新
- 提交范围: 0215811c..ec0d9f4f
- 新增提交数: 18
- 版本: v0.1.22
2025-08-18 更新
- 提交范围: 2998f27f..065eb789
- 新增提交数: 4
- 版本: v0.1.22-dev
2025-08-17 更新
- 提交范围: 5aadb02a..ec1fa954
- 新增提交数: 3
- 版本: v0.1.22-dev
2025-08-16 更新
- 提交范围: ab1c483c..bc60257e
- 新增提交数: 16
- 版本: v0.1.22-dev
2025-08-15 更新
- 提交范围: 8bebaeda..72195d55
- 新增提交数: 33
- 版本: v0.1.21
2025-08-14 更新
- 提交范围: f81ccd8d..d6403c67
- 新增提交数: 26
- 版本: v0.1.21-dev
2025-08-13 更新
- 提交范围: 9d023be1..4074e8e6
- 新增提交数: 1
- 版本: v0.1.20
2025-08-12 更新
- 提交范围: d219f901..b655d8f0
- 新增提交数: 25
- 版本: v0.1.19
2025-08-11 更新
- 提交范围: 2865a527..214800cf
- 新增提交数: 18
- 版本: v0.1.18
2025-08-10 更新
- 提交范围: b8084ba8..0157eae3
- 新增提交数: 7
- 版本: v0.1.18
2025-08-09 更新
- 提交范围: 34434cd4..c632ec8b
- 新增提交数: 3
- 版本: v0.1.18
2025-08-08 更新
- 提交范围: 191cc01b..6b19c8bd
- 新增提交数: 17
- 版本: v0.1.18
2025-08-07 更新
- 提交范围: 60362e03..c184ec32
- 新增提交数: 25
- 版本: v0.1.18
2025-08-06 更新
- 提交范围: 487818df..f35921a7
- 新增提交数: 18
- 版本: v0.1.18
2025-08-05 更新
- 提交范围: d0cda58f..aab85066
- 新增提交数: 38
- 版本: v0.1.17
2025-08-04 更新
- 提交范围: 072d8ba2..c7a1de49
- 新增提交数: 20
- 版本: v0.1.17
2025-08-03 更新
- 提交范围: bedcbb9f..70478b92
- 新增提交数: 4
- 版本: v0.1.16
2025-08-02 更新
- 提交范围: 15a1f1af..820169ba
- 新增提交数: 2
- 版本: v0.1.16
2025-08-01 更新
- 提交范围: 6f7beb41..15a1f1af
- 新增提交数: 14
- 版本: v0.1.16
2025-07-31 更新
- 提交范围: a3a432e3..6f7beb41
- 新增提交数: 13
- 版本: v0.1.15
2025-07-30 更新
- 提交范围: 4dcf3c1b..a3a432e3
- 新增提交数: 12
- 版本: v0.1.15
2025-07-29 更新
- 提交范围: a5dc1e84..4dcf3c1b
- 新增提交数: 10
- 版本: v0.1.15
2025-07-28 更新
- 提交范围: 0c46c9f3..a5dc1e84
- 新增提交数: 15
- 版本: v0.1.15
2025-07-27 更新
- 提交范围: 9e61b351..0c46c9f3
- 新增提交数: 10
- 版本: v0.1.14
2025-07-26 更新
- 提交范围: 3e81359c..9e61b351
- 新增提交数: 1
- 版本: v0.1.14
2025-07-25 更新
- 提交范围: 1d3ad9d0..3e81359c
- 新增提交数: 30
- 版本: v0.1.14
2025-07-24 更新
- 提交范围: 52980510..5d4b02ca
- 新增提交数: 12
- 版本: v0.1.14
2025-07-23 更新
- 提交范围: 1de24623..0ef9c0b7
- 新增提交数: 14
- 版本: v0.1.14
2025-07-22 更新
- 提交范围: 258c8489..7c3a8407
- 新增提交数: 9
- 版本: v0.1.14
2025-07-21 更新
- 提交范围: 9ab44ea9..e4ed1aab
- 新增提交数: 60
- 版本: v0.1.13
2025-07-20 更新
- 提交范围: ac8e9851..0d64355b
- 新增提交数: 6
- 版本: v0.1.13
2025-07-19 更新
- 提交范围: 2f5eecfc..ac8e9851
- 新增提交数: 11
- 版本: v0.1.13
2025-07-18 更新
- 提交范围: ca07b5b0..2f5eecfc
- 新增提交数: 18
- 版本: v0.1.13
2025-07-17 更新
- 提交范围: e4ed1aab..ca07b5b0
- 新增提交数: 16
- 版本: v0.1.13
之前的更新 2025-07-17
- 提交范围: b3cbde5c..9ab44ea9
- 新增提交数: 66
- 版本: v0.1.12
2025-07-16 更新
- 提交范围: ddcac420..34c1b581
- 新增提交数: 22
- 版本: v0.1.12
2025-07-15 更新
- 提交范围: b09bc665..fadc4770
- 新增提交数: 18
- 版本: v0.1.12
2025-07-14 更新
- 提交范围: e9d680e8..ef8ec984
- 新增提交数: 8
- 版本: v0.1.12
2025-07-13 更新
- 提交范围: b018e2d3..890982a8
- 新增提交数: 8
- 版本: v0.1.12
2025-07-12 更新
- 提交范围: 8f12e8a1..b3cbde5c
- 新增提交数: 15
- 版本: v0.1.11
2025-07-11 更新
- 提交范围: cdbe2fff..bf508bfd
- 新增提交数: 15
- 版本: v0.1.10
2025-07-10 更新
- 提交范围: 5ecc1372..b7f8e136
- 新增提交数: 4
- 版本: v0.1.10
2025-07-09 更新
- 提交范围: 9273e8dd..da50a1ee
- 新增提交数: 24
- 版本: v0.1.9
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-08-19）
🚀 重大版本发布
- #fde5511c - 🎉 发布 v0.1.22 - 消息队列、会话记录服务和 Zed 集成
- #发布21相关 - 🎉 发布 v0.1.21 - 工具架构升级和遥测增强
- #fb3ceb0d - 🏢 Zed 编辑器集成 - 通过 Zed 读写文件，支持多文件夹工作空间
💾 会话和数据管理
- #36ea986c - 💾 自动会话记录 - 引入核心 ChatRecordingService 实现自动对话保存
- #fde5511c - 📝 消息队列实现 - 在流式响应期间实现消息队列功能
- #8f8082fe - 📊 文件变更跟踪 - 为会话指标添加文件变更跟踪
🛡️ 隐私和安全增强
- #ec0d9f4f - 🛡️ 隐私设置钩子 - 添加隐私设置钩子和测试
- #6fc68ff8 - 🔒 特殊字符处理 - 处理 glob 和 read_many_files 文件路径中的特殊字符
- #da396bd5 - 🎨 主题行为修复 - 确保本地和 CI 测试运行的一致主题行为
📊 遥测和监控改进
- #58c29256 - 📊 遥测增强 - 添加 tool_type 作为维度
- #91cd0db2 - 📈 会话事件记录 - 通过遥测记录器记录会话开始事件
- #71f706cf - 🗜️ 压缩遥测 - 压缩聊天上下文时记录遥测
⚙️ 设置和配置管理
- #e290a61a - ⚙️ 设置优化 - 禁用对话框中的统计显示
- #92bb4624 - 🔧 设置管理 - 增强通用设置器和显示助手
- #465ac9f5 - ⚡ 非递归文件搜索 - 引入非递归文件搜索策略
🔧 工具验证和架构改进
- #d66ddcd8 - 🛠️ 工具验证优化 - 在非交互式工具执行器中不抛出验证错误
- #3960ccf7 - 📡 MCP 增强 - 添加 MCP Root 变更通知
- #4394b6ab - 📝 文档更新 - 更新身份验证文档以反映可用选项
- #5fe4e023 - 🔐 GCA 凭据 - 修复 GCA 凭据加载顺序
🏢 IDE 集成和开发工具
- #5856 - 🌟 MCP Roots 支持 - 添加 MCP Roots 支持
- #5858 - 🚫 减少 UI 闪烁 - 使用斜杠命令而不是上下文抽屉显示编辑器中的打开文件
- #5792 - 🔒 IDE 模式差异关闭 - 当 CLI 关闭时关闭所有打开的差异
- #5804 - 🌍 IDE 模式环境变量 - 将环境变量连接到沙箱
- #5618 - 📝 IDE 内差异渲染 - 支持使用编辑工具在 IDE 内渲染差异
🧠 内存和路径处理改进
- #5175 - 🔧 改进内存发现中的错误处理和路径处理 - 提升内存发现功能的稳定性
🛠️ MCP 命令管理
- #5481 - ⚡ MCP 命令 - 添加
gemini mcp命令用于add、remove和listMCP 服务器
🎯 GitHub 集成改进
- #5653 - ⚙️ GitHub 设置命令增强 - 启用 /setup-github 始终运行并适当处理错误
- #5649 - 📚 GitHub 集成文档 - 在 README 中添加 GitHub 集成部分
- #5644 - 📝 设置后续步骤 - 告知用户运行斜杠命令后的后续步骤
- #5643 - 🔧 使用官方 GitHub Action - 重构以使用
google-github-actions/run-gemini-cliaction
🚀 高性能文件搜索
🔧 文件类型和工具修复
- #5492 - 📄 修复 .mts 文件识别 - 将 .mts 文件识别为 TypeScript 模块而不是视频文件
- #5656 - 🛠️ 修复工作流设置中缺失的 coreTool - 修复新工作流设置中缺失的核心工具
🔍 循环检测和错误处理
- #5609 - 🔍 循环工具引用检测 - 当遇到架构深度错误时检测并警告循环工具引用
🎨 UI 和用户体验改进
- #5641 - 🎭 更新风趣短语 - 更新一些风趣的加载短语
- #5639 - 🧪 @ 自动补全重置测试 - 为 useAtCompletion 重置逻辑添加测试
- #5638 - 🔗 URL 路径更改 - 从 heads 切换到 tags 在 URL 路径中
- #5635 - 🐛 修复自动补全重置 - 修复离开补全建议后不重置的问题
- #5631 - 🎭 移除一些风趣短语 - 移除一些风趣的加载短语
- #5624 - 📤 非交互式输出路由 - 将非交互式输出路由到 stderr
🔧 Vim 模式改进
- #5567 - ⌨️ 修复 Vim 模式下的 shell 模式 - 修复 Vim 模式下的 shell 模式
🏗️ IDE 模式和状态管理
- #5591 - 🏢 重构 IDE 客户端状态管理 - 改进用户错误信息并添加连接事件日志
- #5531 - 🧹 ide-mode 标志清理 - 清理 IDE 模式标志
- #5522 - 💬 改进 IDE 模式错误信息 - 改进 IDE 模式的用户错误信息
- #4519 - 📝 IDE MCP 服务器 openDiff 工具 - 为 IDE MCP 服务器添加 openDiff 工具
🔧 性能和并行处理
- #4763 - ⚡ 并行文件处理 - 实现并行文件处理以提升 74% 性能
📋 MCP 功能增强
- #5616 - 🔍 MCP 提示功能检查 - 在从 MCP 服务器列出提示之前检查提示功能
- #5385 - 🔄 清除提示注册表 - 刷新时清除提示注册表以防止重复
- #5290 - 🔌 仅提示服务器连接 - 更新 MCP 客户端以连接到仅有提示的服务器
- #5265 - 🔐 MCP OAuth2 audience 支持 - 为 OAuth2 添加 audience 支持
- #5529 - 📸 多模态 MCP 工具响应 - 解析多模态 MCP 工具响应
- #5545 - 🔗 授权 URL 验证 - 确保包含查询参数的授权 URL 有效
🏢 多目录工作空间支持
- #5354 - 📁 多目录工作空间配置 - 多目录工作空间支持(第3部分：settings.json 中的配置)
🔧 配置和设置改进
📄 文档和修复
- #5521 - 📚 修复文档代码块 - 修复 commands.md 中的代码块分隔符
- #2734 - 🛠️ 改进故障排除文档 - 修复并改进 Gemini CLI troubleshooting.md 文档
- #5408 - 📝 添加 /chat delete 命令文档 - 在 commands.md 中添加 /chat delete 命令
- #5593 - 🔧 修复 ROADMAP 拼写错误 - 修复 ROADMAP.md 中的小拼写错误
- #5584 - 📚 更新 commands.md 拼写错误 - 更新 commands.md 中的拼写错误
- #5363 - 📋 自动化和分类文档 - 为自动化和分类创建新文档
🧪 测试和质量改进
- #5540 - 🧪 修复不稳定测试 - 使用 waitFor 修复不稳定测试
- #5622 - 🔧 修复工作流格式 - 修复 .github/workflows/weekly-velocity-report.yml 的格式
🛡️ 安全和认证
🔧 其他改进和修复
- #5552 - 📋 移除本地修改字符串 - 从 bug 和 about 报告中移除"本地修改"字符串
- #5548 - 🔧 修复构建脚本自引用 - 修复构建脚本中的自引用
- #5367 - 🌐 防止冗余浏览器标签 - 当配置零个 MCP 服务器时防止冗余地打开浏览器标签
- #5532 - 🔄 重命名斜杠补全 - 将 useSlashCompletion 重命名为 useCommandCompletion
- #5524 - 🔗 使用新 URL 下载工作流 - 使用新的 URL 下载工作流
- #5526 - 🧹 移除不必要检查 - 移除 WriteFileChecks.getDescription 中的不必要检查
- #5475 - ⌨️ @ 补全尾随空格 - 补全 @ 补全建议时添加尾随空格
- #5482 - 📝 @ 命令标点处理 - 在 @ 命令解析中处理标点符号
- #3611 - 🛠️ 修复 /help 闪烁 - 移除 /help 闪烁并尊重清除快捷键(ctrl+l)
- #5315 - 🔧 防止 vim 编辑后 UI 偏移 - 防止 vim 编辑后的 UI 偏移
- #5329 - 🧮 修复截断计算 - 修复
contentRangeTruncated计算 - #5310 - 📄 生成 NOTICES.TXT - 生成 NOTICES.TXT 并通过命令显示
- #4793 - 🔍 shell 命令反向搜索 - 为 shell 命令添加反向搜索功能
- #5289 - 🔒 排除调试环境变量 - 默认从项目 .env 文件中排除 DEBUG 和 DEBUG_MODE
- #5449 - ⚙️ 禁用版本更新提醒 - 添加禁用版本更新提醒消息的设置
📚 新增文档
- issue-and-pr-automation.md - 🤖 自动化和分类流程文档 - 详细说明问题和 PR 的自动化管理流程
之前的更改（2025-07-27）
🚀 Vim 模式和自定义命令增强
- #3936 - ⌨️ Vim 模式 - 完整的 Vim 编辑器支持，包括 NORMAL/INSERT 模式切换
- #4917 - 🐚 自定义命令 Shell 执行 - 添加自定义命令中的 Shell 命令执行功能
- #4907 - 🔗 自定义命令符号链接支持 - 修复自定义命令跟随符号链接
🏗️ 核心架构改进
- #4823 - 🔧 Shell 逻辑中心化 - 将 shell 逻辑集中到 ShellExecutionService
- #4831 - 🔒 基于哈希的循环检测 - 实现基于哈希的循环检测机制
- #4795 - 🛡️ 更安全的 Shell 命令执行 - 改进 Shell 命令执行的安全性
🪟 Windows 兼容性大幅改进
- #4672 - 🪟 Windows 预提交测试 - 在 Windows 上运行预提交测试
- #4889 - 🐛 修复 grep.test 在 Windows 上工作
- #4891 - 🐛 使 glob.test.ts 兼容 Windows
- #4892 - 🐛 使 fileDiscoveryService.test.ts 兼容 Windows
- #4895 - 🐛 使 oauth2 测试兼容 Windows
- #4873 - 🐛 使 restoreCommand 测试兼容 Windows
- #4868 - 🐛 修复 userStartupWarnings 兼容 Windows
- #4858 - 🐛 使 shell.test.ts 兼容 Windows
- #4766 - 🐛 使 useCompletion.test.ts 兼容 Windows
- #4856 - 🐛 使 errorReporting 测试兼容 Windows
- #4864 - 🐛 修复 read-file.test.ts 兼容 Windows
- #4684 - 🐛 修复 atCommandProcessor.ts 中的 Windows 错误
🔧 MCP 服务器提示和 IDE 增强
- #4828 - 📝 MCP 服务器提示作为斜杠命令 - 加载并使用 MCP 服务器提示作为 CLI 中的斜杠命令
- #4797 - 🏢 IDE 管理器类 - 创建 IDE 管理器类来处理连接和暴露 IDE 服务器方法
- #4902 - 🔧 IDE 连接清理 - 修复 IDE 连接失败时清理传输
- #4761 - 🔧 VS Code 扩展重构 - VS Code 伴侣扩展代码的小幅重构
- #4729 - 📚 扩展文档优化 - 发布前优化伴侣扩展 README 和 package.json
🎨 用户体验改进
- #4733 - 🕐 聊天列表时间戳 - 在 /chat list 中显示时间戳
- #3990 - 🧹 启动屏幕清理 - 从启动屏幕移除多余的空白
- #4417 - 🛡️ 更优雅的错误处理 - 更优雅地处理未处理的拒绝
- #4757 - 🎨 旧版主题兼容 - 修复旧版自定义主题仍能加载
🔧 认证和工具改进
- #4811 - 🔐 非交互式 GCP 认证增强 - 增强非交互式 GCP 认证
- #4887 - 🐛 拖放文件修复 - 修复破坏文件拖放的错误
- #4575 - 🔧 partUtils 模块 - 添加带单元测试的 partUtils 模块
📚 文档更新
- #4950 - 📝 添加 --prompt-interactive 文档 - 添加缺失的 --prompt-interactive/-i 标志文档
- #2004 - 📝 认证文档更新 - 在 authentication.md 中添加 API 密钥和 .gemini/.env 的说明
🔍 日志和监控改进
- #4700 - 📊 Flash 继续日志 - 记录 flash 继续
- #4698 - 📊 Flash 模型决定日志 - 当 flash 模型决定继续时记录
- #4765 - 🆔 循环检测提示 ID - 检测到循环时记录提示 ID
🚀 版本发布
- #3a224d49 - 🎉 发布 v0.1.14 - 包含 Vim 模式、Windows 兼容性改进和众多增强功能
之前的更改（2025-07-21）
🚀 重大功能发布
- #4515 - 🎉 发布 v0.1.13 - 包含 IDE 集成、后台代理、自定义主题等重要功能
- #4407 - ✨ 后台命令支持 - 添加 /background 命令（需要配置后台代理）
- #4409 - 🎬 后台代理演示 - 展示后台代理功能
🔧 IDE 模式和文件管理增强
- #4463 - 📁 IDE 模式文件追踪 - 跟踪最近打开的文件并发送给 CLI
- #4470 - 🎯 IDE 文件显示优化 - 在输入框上方的上下文区域显示 IDE 打开文件
- #4329 - 📡 IDE 连接保持 - IDE 模式每 30 秒发送 ping 防止客户端关闭连接
- #4312 - 📝 活动文件集成 - 将活动文件添加到用户模型请求中
🔧 核心架构和性能改进
- #4511 - 🏗️ 命令服务重构 - 为可扩展命令进行命令服务预重构
- #4337 - 🤖 AI 循环检测 - 使用 LLM 实现循环检测
- #3288 - ⚡ 异步文件检测 - 使文件类型检测和二进制检查异步化
🎨 用户体验和 UI 改进
- #2639 - 🎨 自定义主题逻辑 - 功能完整的自定义主题逻辑
- #4012 - 👁️ 光标隐藏 - 终端失焦时隐藏光标
- #4462 - 🎯 命令补全改进 - 基于光标位置改进命令补全触发逻辑
- #4396 - ☀️ 浅色主题改进 - 浅色主题色彩改进
🔧 新命令和工具
- #3706 - 📋 复制命令 - 使用新命令服务方法添加 /copy 命令用于复制输出到剪贴板
- #3727 - 🚫 .geminiignore 支持 - 在设置和相应工具调用中完整实现 .geminiignore
- #4419 - 🐕 迁移 /corgi - 将 /corgi 命令迁移到新架构
- #4388 - 🔄 迁移恢复命令 - 迁移恢复命令到新架构
🛠️ 开发者工具和集成
- #4266 - 🟢 Zed 集成 - 添加 Zed 编辑器集成支持
- #3680 - 📝 Zed 编辑器检测 - 如果未找到 zed 二进制文件则检查 zeditor
- #4542 - ⚠️ 根目录警告 - 在根目录调用 gemini-cli 时添加警告
- #2526 - 🌐 显式代理选项 - 在 CLI 中添加显式代理选项
🐛 修复和改进
- #4479 - ⏪ 回滚后台代理提交 - 回滚后台代理相关提交
- #4475 - 🔄 非交互环境检测 - 自动检测非交互环境并回退到手动基于代码的认证流程
- #4440 - 📊 显示拒绝的确认代码差异 - 显示被拒绝的确认代码差异
- #4469 - 🐚 Shell 输出一致性 - 使 shell 输出保持一致
- #4377 - ⬆️⬇️ 历史记录导航修复 - 修复仅有一个建议时允许上下箭头切换历史记录
- #4374 - 🛠️ 退出快捷键回归修复 - 修复命令迁移导致的退出快捷键回归
🔐 认证和安全改进
- #4316 - 🔐 MCP OAuth 基础架构 - MCP OAuth 第一部分 - OAuth 基础架构
- #3532 - 🐳 Docker OAuth 支持 - 增强 OAuth 回调以实现强大的 Docker 支持
- #4052 - 📦 本地运行更新检测 - 本地运行 gemini-cli 时不显示更新可用消息
🔧 MCP 和扩展改进
- #4514 - ⏱️ MCP 服务器超时扩展 - 扩展 mcp-server 超时时间
- #4508 - 💬 简化 MCP 连接错误 - 简化 MCP 连接错误消息
- #4459 - 🛠️ MCP 工具名称简化 - 尽可能使用简单的 MCP 工具名称
- #3977 - 📊 启动摘要 - 启动时总结扩展和 MCP 服务器
- #3409 - 📝 MCP 工具文档 - 为 mcp excludeTools 和 includeTools 添加文档
🔧 构建和发布改进
- #4428 - 🛠️ 修复发布和 e2e 工作流 - 修复损坏的发布和 e2e 工作流
- #3501 - 📦 依赖完整性 - 为所有依赖项添加缺失的
resolved和integrity - #4287 - 🧪 测试/添加 loadcodeassist 模拟 - 测试中添加 loadcodeassist 模拟
- #4296 - 📋 ESLint 更新 - 更新 ESLint 和相关包到最新版本
🐛 Bug 修复
- #3550 - 🔤 修复拼写错误 - 修复各种文件中的拼写错误
- #3417 - 🛠️ 防止 GitIgnoreParser 错误 - 防止根路径的 GitIgnoreParser 中的 RangeError
- #3999 - 💥 修复 ANSI 转义崩溃 - 修复文本缓冲区中的 ANSI 转义崩溃
- #4382 - ⚠️ companionPort 警告 - 将 companionPort 不存在更新为警告，以便用户仍可继续运行 /ide install
- #4362 - 📊 记录表面字段 - 在 start_session_event 中记录表面字段以及会话信息
- #4162 - 🔄 上下文百分比更新 - 运行 /clear 命令时更新上下文百分比
- #4348 - 🔄 修复循环计数重置 - 修复每隔一个事件重置循环计数的问题
- #4304 - 📖 修复检查点文档链接 - 修复
--checkpointing的检查点文档链接 - #4176 - 🔄 更新 google/genai - 更新 google/genai 到 v1.9.0 并切换到 parametersJsonSchema 用于 MCP 相关工具
- #4289 - 🗑️ 移除 gaxios 依赖 - 移除直接的 gaxios 依赖
- #4320 - 🔢 选择列表添加数字 - 为选择列表添加数字
- #4397 - 🎯 完美匹配命令执行 - 允许在完美匹配时执行命令
之前的更改（2025-07-17）
🔧 斜杠命令架构重构
- #4259 - 🔧 将
/quit更新到新的斜杠命令架构 - #4246 - 🔧 将
/bug更新到新的斜杠命令架构 - #4153 - 🔧 将
/editor更新到新的斜杠命令架构 - #4236 - 🔧 将
/tools更新到新的斜杠命令架构 - #4133 - 🔧 将
/docs更新到新的斜杠命令架构 - #3678 - 🔧 将 MCP 斜杠命令迁移到新系统
- #4271 - 🔧 迁移 compress 命令
- #4229 - 🔧 将
/extensions更新到新的斜杠命令架构 - #4146 - 🔧 将
/stats更新到新的斜杠命令架构 - #4207 - 🔧 迁移 /about
- #4202 - 🔧 将 /privacy 迁移到新架构
- #3797 - 🔧 将 '/auth' 更新到新的斜杠命令架构
🔧 IDE 集成和扩展支持
- #4331 - 🔧 IDE 伴侣服务器的小幅重构
- #4265 - ✨ 添加 /ide status 和 /ide install 命令来管理 IDE 集成
- #4311 - 🎨 IDE 模式的小幅 UX 更新
- #4254 - 📦 在构建/发布中包含配套 VS Code 扩展 VSIX
- #4308 - ⏪ 撤销 "[ide-mode] 将活动文件通过系统提示"
- #4264 - 🔧 [ide-mode] 将活动文件通过系统提示
- #4255 - 🔧 在 VSCode 扩展中动态设置端口并从中读取
- #4241 - 📦 上传配套 VS Code 扩展的 VSIX
- #4147 - 🔧 [ide-mode] 当活动文件更改时流式通知
- #4154 - 🎨 将用户在 IDE 中的活动文件添加到页脚
- #3927 - 🚩 为 IDE 集成添加功能标志
- #3917 - ✨ 引入 VSCode 伴侣扩展
🔧 模型和性能改进
- #4176 - 🔧 更新 google/genai 到 v1.9.0 并切换到 parametersJsonSchema 用于 MCP 相关工具
- #4256 - 🚀 在后台运行模型可用性检查以加速启动
- #4016 - 🐛 修复不使用 flash 进行下一个说话者检查
- #4009 - 🔧 [工具]: 集中化 shell 工具摘要
- #3095 - 🔧 [工具]: 按字母顺序排序工具列表以获得确定性输出
🎯 用户体验和 UI 改进
- #1729 - 🔧 [cli]: 在不执行命令时，CTRL+C 清除输入缓冲区
- #2857 - 🔧 重构：优化 "/chat list" 和 "/chat resume" 的显示信息
- #4227 - 🔧 改进斜杠命令中的 altName 完成行为
- #2233 - 🔧 更新 MaxSizedBox.tsx
- #4006 - 🔧 功能: 在 RadioButtonSelect 中反转滚动箭头默认值
- #4002 - 🔧 功能: 添加 GEMINI_DEFAULT_AUTH_TYPE 支持
- #2803 - 🔧 [cli]: 添加 hideBanner 设置以禁用启动横幅
🔧 工具和功能增强
- #4135 - 🔧 在设置中添加对允许/排除 MCP 服务器名称的支持
- #4140 - 🔧 仅在 settings.json 中明确设置时启用工具摘要
- #4158 - 🔧 使 @ 命令排序文件时不带扩展名
- #4193 - 🔧 记录 2 种类型的循环检测
- #3919 - 🔧 引入循环检测服务以打破简单循环
- #4064 - 🔧 重新添加对用 \ 字符转义换行的支持
🐛 修复和改进
- #4144 - 🐛 [检查点]: 防止静默失败并为非 Git 项目启用
- #4141 - 🐛 不要用函数响应开始未压缩历史记录
- #4150 - 🐛 修复 telemetry 日志记录中的循环引用 JSON 序列化
- #4163 - 🔧 纯重构：合并 isWithinRoot() 函数调用
- #4049 - 🔧 在调试模式下显示 mcp 服务器的 stderr 输出
- #4240 - 🔧 在 header 中包含 api key 而不是在 URL 中
📝 文档和发布改进
- #4178 - 📋 路线图发布
- #4051 - 📝 为 /extensions 命令添加文档
- #3381 - 🐛 修复 markdown 标题级别问题
- #3781 - 🐛 [docs]: 在 readme 中澄清全局安装
- #2763 - 🐛 修复：在 README 中标准化 "Troubleshooting Guide" 的大小写
- #4249 - 🔧 chore: 更新 release-docker.yaml 中的编号
- #4025 - 🐛 修复 docker release yaml 使用正确的命令
- #4023 - 🔧 chore(release): v0.1.12
🔧 其他改进
- #4252 - ⏪ 撤销 "更新到 yargs v18 (#3759)"
- #4244 - ⏪ 撤销 Node <20 警告
- #3371 - 🔧 功能: 如果用户使用 node -v <20 则添加警告 #2930
- #3759 - 🔧 更新到 yargs v18
- #3880 - 🔧 重构 MCP 代码以供重用和测试
- #3885 - 🐛 [core]: 使注释掉的测试可工作
- #3985 - 🐛 [auth]: 移除无头认证的尖锐边缘
之前的更改（2025-07-16）
🔧 斜杠命令迁移继续
- #4133 - 🔧 将
/docs更新到新的斜杠命令架构 - #3678 - 🔧 将 MCP 斜杠命令迁移到新系统
- #4271 - 🔧 迁移 compress 命令
- #4229 - 🔧 将
/extensions更新到新的斜杠命令架构 - #4146 - 🔧 将
/stats更新到新的斜杠命令架构
🎯 性能和用户体验改进
- #4256 - 🚀 在后台运行模型可用性检查以加速启动
- #1729 - 🔧 在不执行命令时，CTRL+C 清除输入缓冲区
- #2857 - 🔧 重构：优化 "/chat list" 和 "/chat resume" 的显示信息
- #4227 - 🔧 改进斜杠命令中的 altName 完成行为
🔧 IDE 和工具改进
- #4264 - 🔧 [ide-mode] 将活动文件通过系统提示
- #4255 - 🔧 在 VSCode 扩展中动态设置端口并从中读取
- #4135 - 🔧 在设置中添加对允许/排除 MCP 服务器名称的支持
- #3095 - 🔧 按字母顺序排序工具列表以获得确定性输出
- #4140 - 🔧 仅在 settings.json 中明确设置时启用工具摘要
🔧 发布和修复
- #4249 - 🔧 更新 release-docker.yaml 中的编号
- #4241 - 📦 上传配套 VS Code 扩展的 VSIX
- #4252 - ⏪ 撤销 "更新到 yargs v18"
- #4244 - ⏪ 撤销 Node <20 警告
- #4240 - 🔧 在 header 中包含 api key 而不是在 URL 中
之前的更改（2025-07-15）
🚀 重要功能发布
🔧 斜杠命令和架构改进
- #4207 - 🔧 迁移 /about
- #4202 - 🔧 将 /privacy 迁移到新架构
- #3797 - 🔧 将 '/auth' 更新到新的斜杠命令架构
- #4163 - 🔧 纯重构：合并 isWithinRoot() 函数调用
🔧 工具和修复改进
- #4154 - 🎨 将用户在 IDE 中的活动文件添加到页脚
- #4158 - 🔧 使 @ 命令排序文件时不带扩展名
- #4150 - 🐛 修复 telemetry 日志记录中的循环引用 JSON 序列化
- #4144 - 🐛 防止检查点静默失败并为非 Git 项目启用
- #4141 - 🐛 不要用函数响应开始未压缩历史记录
📝 文档改进
🔧 依赖和版本管理
之前的更改（2025-07-14）
✨ 新功能和扩展
📝 文档和帮助改进
🔧 调试和开发改进
之前的更改（2025-07-13）
🚀 版本发布和核心改进
🎯 用户体验增强
🐛 修复和清理
之前的更改（2025-07-11）
🔧 错误处理和日志改进
⚙️ 新功能和配置
- #3507 - 🔧 添加通过设置配置指定 maxSessionTurns 的支持
- #3713 - 🔧 添加 NO_BROWSER 环境变量以触发离线 oauth 流程
- #2476 - 🔧 为 node < 20 添加括号粘贴支持的解决方案
📝 文档更新
- #3852 - 📝 修正 CONTRIBUTING.md 中的拼写错误
- #3042 - 📝 更新认证文档显示如何在 GCP 中使用 API 密钥
- #3380 - 📝 在多文件工具文档中包含视频和音频
- #3348 - 🐛 修复认证文档中的拼写错误
🔧 依赖管理和 CLI 改进
- #3834 - 🔧 将 @google/genai 固定到 1.8.0 版本
- #2388 - 🔧 移除未使用的 ink-text-input 依赖
- #3703 - 🔧 在帮助输出中缩进子命令
- #3741 - 🧹 清理：移除重复的指南提示
🚀 发布改进
- #3749 - 🔧 chore(release): v0.1.10
之前的更改（2025-07-10）
🐛 修复和改进
- #3672 - 🐛 修复无效的 docker 命令和 mcpServers 示例中的无效 JSON
- #3747 - 🐛 修复 grep.test.ts 的补丁
- #3744 - ⏪ 撤销 "fix: Use Email for Clearcut Logging and Refactor User Info Fetching"
- #3620 - 🐛 修复：使用 Email 进行 Clearcut 日志记录并重构用户信息获取
之前的更改（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 或更高版本
- 更新任何依赖于旧认证流程的代码
- 查看新的隐私政策文档了解数据使用政策