Grok 0.2.112 变更解析toolOverrides 搜索工具策略、/tutorial 引导与终端环境修复全面升级【免费下载链接】grok-buildSpaceXAIs coding agent harness and TUI. Fullscreen, mouse interactive, extensible.项目地址: https://gitcode.com/gh_mirrors/gr/grok-build本文基于 grok-build 仓库SpaceXAI 的 coding agent harness 与 TUI全屏、鼠标交互、可扩展的官方变更日志 0.2.112.md 编写并结合仓库源码对核心新特性做了实现级考证。读者将掌握 0.2.112 版本的破坏性变更、新增配置项与命令用法以及这些能力在源码中的落点便于评估升级影响并立即上手使用。版本总览0.2.112 是 2026-07-24 发布的版本共包含 39 项变更1 项 Breaking Change、约 20 项新特性、约 18 项缺陷修复。本版本的重点可以归纳为四条主线CLI 版本策略重构将软性更新建议与硬性启动要求分离属于需要关注的破坏性变更搜索工具可配置化新增tool_overrides/toolOverrides让用户为 Agent 内置搜索工具设置日期截止与域名白名单环境与终端自愈能力集中化终端与环境的诊断修复统一收口到/doctor并新增grok doctor fix的 tmux 修复能力工作流、会话恢复、插件市场的体验补齐覆盖 workflows 实时进度、按标题恢复会话、市场源非 git URL 校验、hooks 迁移到 config.toml 等日常高频场景。Breaking ChangeCLI 版本策略分离软地板/软天花板与硬启动要求升级前必读本版本将 CLI 版本策略拆分为两部分软更新地板/天花板soft update floors/ceilings用于提示建议升级或建议停留在某版本不影响启动硬启动要求hard startup requirements低于该版本将直接拒绝启动。从仓库配置结构看CLI 版本策略通常由远程设置remote settings驱动Agent 初始化时会等待 remote settings 到达后再应用策略参见 acp_agent.rs 中remote_settings_settled相关逻辑。本次拆分的意义在于提示性建议不再阻断工作流只有真正不兼容的版本才被硬性拦截从而减少用户莫名被拒的困惑也让运营方可以独立收紧两个阈值。升级到 0.2.112 后建议先运行grok doctor或直接grok启动确认当前版本是否落在软/硬要求区间内再继续日常使用。新特性详解1./tutorial九大主题的可选 onboarding 导览0.2.112 新增/tutorial斜杠命令提供一个九主题nine-topic的 opt-in 入门导览帮助新用户快速了解 Grok 的核心操作。之所以是opt-in意味着不会在首次启动时强制打断用户可随时主动唤起。在源码层面tutorial已注册进斜杠命令保留名列表与tour、onboarding、welcome等导览类命令并列参见 slash_commands.rs。该保留名机制意味着插件或技能SKILL.md不能抢占tutorial这个名字确保内建导览始终可用。2.tool_overrides/toolOverrides搜索工具的日期截止与域名白名单这是本版本最具技术含金量的新特性。它允许你为 Agent 的内置搜索工具设置两类约束日期截止date cutoffs限制搜索结果的时间范围域名白名单domain allowlists限制搜索结果来自哪些域名。该选项在配置中同时提供 snake_casetool_overrides与 camelCasetoolOverrides两种拼写形式用于对接不同配置/协议层。源码落点能力声明与 meta 传递在 Agent 实现中ToolOverridesCapability结构体明确声明了哪些x_search子工具会执行日期截止策略acp_agent.rs/// Which x_search sub-tools enforce the date cutoff, sent in initialize. /// x_user_search and x_thread_fetch are false: they dont honor it yet. struct ToolOverridesCapability { x_keyword_search: bool, x_semantic_search: bool, x_user_search: bool, x_thread_fetch: bool, } const TOOL_OVERRIDES_CAPABILITY: ToolOverridesCapability ToolOverridesCapability { x_keyword_search: true, x_semantic_search: true, x_user_search: false, x_thread_fetch: false, };即当前版本中搜索子工具是否执行日期截止x_keyword_search✅ 是x_semantic_search✅ 是x_user_search❌ 否暂不支持x_thread_fetch❌ 否暂不支持该能力形状通过 ACPinitialize请求的 meta 发送给服务端并有测试锁定其线上线格式acp_agent.rstool_overrides_capability() { x_keyword_search: true, x_semantic_search: true, x_user_search: false, x_thread_fetch: false, }覆盖项在会话数据模型中的类型为Optionxai_grok_sampling_types::ToolOverrides见 mod.rs最终以 camelCase 形式落到 PromptResponse 的_meta键中。单元测试 prompt_response_meta_tests.rs 验证了如下形状{ toolOverrides: { xSearch: { dateBound: { toDate: 2024-03-15 } } } }测试同时断言未设置覆盖时meta中不出现toolOverrides键webSearch在未配置时也不出现。这意味着该配置是增量生效的不会污染其它元数据。使用建议如果你希望 Agent 搜索只基于某个时间点之前的信息或只信任特定来源域名例如官方文档域可在对应配置文件中设置tool_overrides注意当前只有x_keyword_search与x_semantic_search两个子工具真正执行日期截止。3. 自定义模型 Provider查询参数、环境变量头与 Shell 工具变量控制本版本为自定义模型 Provider 新增两类配置能力为自定义模型 provider 添加查询参数query parameters或环境变量支持的请求头environment-backed headers控制哪些环境变量能够到达 shell 工具。源码层面模型请求头配置在 config.rs 中以extra_headers: IndexMapString, String表达同时支持全局默认与逐模型覆盖两层语义全局[models].extra_headers作为默认值折叠进所有模型而单个[model.id].extra_headers按 key大小写不敏感覆盖全局值参见 config.rs 的apply_global_extra_headers实现。环境变量控制 shell 工具变量的意义在于安全性你可以精确放行哪些环境变量进入 shell 工具的执行环境避免把本机敏感环境变量如密钥、token暴露给工具调用。4./doctor整合终端与环境修复grok doctor fix支持 tmux终端与环境修复整合此前的终端/环境相关零散修复建议现在统一收口到/doctor命令下诊断输出与修复指引更清晰grok doctor fix修复 tmux新增对常见 tmux 剪贴板clipboard与 passthrough 问题的自动修复能力。这对在 tmux 中运行 Grok 的用户非常实用——剪贴板失效、输入透传异常是 tmux 环境下的高频痛点。如果你在 tmux 中遇到复制粘贴失效或按键透传异常升级后可直接运行grok doctor fix尝试自动修复。5. Marketplaceadd 时即拒绝非 git URL插件市场的add操作现在会在添加时就拒绝非 git URL而不是等到后续刷新/拉取时才失败。这属于尽早失败fail fast的体验改进输入错误的源地址立即得到反馈且避免了无效源导致市场刷新卡死的问题。配套地市场源刷新source refresh不再挂起 TUI也不会把用户困在扩展管理弹窗中。6. 斜杠命令支持方括号标签如[new]斜杠命令现在可以展示可选的方括号标签例如[new]用于标记新增/试验性命令。该标签可以通过配置或远程设置remote settings控制方便运营方在命令列表中标注新能力引导用户探索。7. 队列提示支持[edit]鼠标按钮排队中的提示queued prompts除了原有的 Send now立即发送与取消之外新增[edit]鼠标按钮可以直接回到编辑态修改待发送的提示内容不必取消后重新输入。8. 语音快捷键可单独关闭设置中新增Voice shortcut 开关可以仅禁用CtrlSpace/F8语音快捷键而不必完全关闭语音功能。适合那些用不到快捷键、又不想误触发的用户。9. 图片编辑模型可远程配置此前图片编辑使用硬编码的默认模型本版本改为可通过远程配置指定模型 slug。这意味着运营方无需发版即可调整图片编辑所调用的模型。10. Per-provider 认证助手支持 Windows 与可配置工作目录各 Provider 的认证辅助命令现在可在 Windows 上工作可以从可配置的工作目录working directory运行。这解决了此前认证助手在 Windows 下不可用、以及必须在特定目录下执行的问题跨平台体验明显改善。11./resume与grok --resume原生会话优先 按标题恢复/resume现在默认只展示原生 Grok 会话当外部会话如 Claude/Codex 导入的会话被隐藏时会显示提示说明避免用户困惑我的会话去哪了grok --resume除了按会话 ID 恢复外现在也支持按会话标题title恢复命令行恢复会话更加灵活。12. Workflows实时进度与失败恢复Workflows overlay 实时进度叠加层现在展示每个 agent 的实时进度并自动跟随当前活动阶段active phase滚动失败可恢复此前失败的工作流运行现在可以恢复resume不必从头重跑scratch 文件上限提高工作流运行过程中的临时文件scratch files配额也被放大适配更长、更复杂的多 agent 工作流。13. Hooks 可在 config.toml 中定义Hooks钩子此前只能通过 JSON 文件定义现在也可以在 config.toml 中直接定义与其它配置保持一致的声明方式降低配置复杂度。14. 点击 still running 状态打开任务面板工作流或长任务仍在运行时界面上的 still running 状态现在可点击直接打开 tasks 面板查看任务明细减少查找路径。缺陷修复盘点0.2.112 修复的缺陷按主题可归纳为以下六类会话与恢复文件附件file attachments在恢复或回放对话时不再丢失可正确显示从回卷rewound会话 fork 时复制的是正确的活动分支live-branch历史暂停parked的回合不再在转录中刷屏重复的 Worked for 标记。终端与后台任务远程客户端的终端输出现在会被记录read-file提示与监视器monitors因此能正常工作后台 shell 命令现在上报真实的退出码而不是一律显示 -1后台任务托盘正确清理已杀死killed的任务重连后保留任务描述Bash 模式!在 minimal 模式下现在显示黄色前缀与操作标签。账户与认证账户面板Account pane在访问令牌过期后仍能显示姓名与邮箱认证相关流程的体验提升见上文 per-provider 认证助手。MCP 与插件注册或更新托管 MCP 服务后新工具无需重启即可出现插件子代理plugin subagents现在与父会话看到相同的 MCP 工具集。语音Linux 上低于 1.6 的 PipeWire 版本也能正常使用语音听写语音模式下可编辑已听写文本而无需关闭麦克风按 Enter 发送时不再丢失已听写的文本。搜索与稳定性Web 搜索默认模型切换为 grok-4.5修复 Linux 上并发启动或快速重启导致的启动挂起startup hang重复的相同工具调用现在静默结束回合不再弹出停止横幅stop banner复制成功时的确认消息更简短。升级建议与注意事项先读破坏性变更CLI 版本策略新增硬启动要求升级前确认当前二进制版本满足要求避免升级后无法启动善用/doctor与grok doctor fixtmux 剪贴板 / passthrough 问题可先交给grok doctor fix自动处理新用户先跑/tutorial九主题导览是熟悉 Grok 交互的最快路径且完全可选配置搜索约束时注意子工具差异tool_overrides的日期截止目前仅对x_keyword_search与x_semantic_search生效x_user_search与x_thread_fetch暂未支持Marketplace 源请使用合法 git URL0.2.112 在 add 时即校验非 git URL 会被直接拒绝hooks 迁移到 config.toml新配置可逐步从 JSON 文件迁移到 config.toml二者目前均受支持。延伸阅读完整变更记录仓库主 CHANGELOG.md0.2.112 条目位于第 417 行起结构化变更数据0.2.112.json含 category/description/breaking_change 字段tool_overrides能力声明与线上线测试acp_agent.rs、prompt_response_meta_tests.rs斜杠命令保留名列表含tutorial/tour/onboardingslash_commands.rs模型extra_headers配置与全局/逐模型合并逻辑config.rs、config.rs【免费下载链接】grok-buildSpaceXAIs coding agent harness and TUI. Fullscreen, mouse interactive, extensible.项目地址: https://gitcode.com/gh_mirrors/gr/grok-build创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考