grok-build v0.2.87 版本解读自动订阅升级、/docs 导航与按模型推理强度配置【免费下载链接】grok-buildSpaceXAIs coding agent harness and TUI. Fullscreen, mouse interactive, extensible.项目地址: https://gitcode.com/gh_mirrors/gr/grok-buildgrok-buildSpaceXAI 的 coding agent harness 与全屏 TUI在 2026-07-05 发布的 0.2.87 版本中围绕权限管控、文档导航、模型配置与终端渲染四个方向集中更新订阅升级不再需要重启 CLI、Bash 权限弹窗新增可持久化的Never allow选项、新增/docs斜杠命令、推理强度reasoning effort菜单支持按模型由服务端与 config.toml 独立配置同时修复了--minimal配色、[model.*]配置容错、后台任务唤醒等 6 处问题。阅读本文后你将掌握 0.2.87 全部新增能力的使用方式与配置项并能从源码层理解这些行为背后的实现机制。本版本变更的原始记录见 changelogs/0.2.87.md对应的结构化数据见 changelogs/0.2.87.json历史累计变更可查阅 CHANGELOG.md。Features五个新能力订阅升级自动生效无需重启 CLISubscription upgrades are now detected automatically without restarting the CLI.此前用户变更订阅如从免费档升级到 Pro/Team后需要完全重启 CLI 才能让新的模型访问权限、速率配额生效。0.2.87 起CLI 会在运行期间自动探测订阅状态变化并即时应用消除了升级后忘记重启导致的权限滞后体验。对于长时间挂起的 TUI 会话这项改动直接减少了中断工作流如会话状态、滚动缓冲、未完成任务的代价。Bash 权限弹窗新增 Never allow拒绝规则持久化Bash permission prompts now offer a Never allow choice that persists the deny rule.当 agent 请求执行 Bash 命令时权限弹窗原有的允许一次 / 本次会话允许 / 拒绝选项之外新增了Never allow选项。选择后该拒绝规则会被持久化后续同类请求不再反复弹窗打扰。从代码结构看grok-build 的权限决策分散在会话层与 agent 层如 session/acp_session_impl/tool_calls.rs、agent/mvp_agent/agent_ops.rs 等涉及 permission prompt 的模块Never allow对应的持久化写入走 settings_writes.rs 的配置更新通道与现有允许规则的持久化逻辑保持同构。该能力对自动化程度高、频繁触发工具调用的工作流尤其重要——一次误判即可根治而不是每次执行前都面对弹窗。新增/docs斜杠命令三种文档入口New/docsslash command opens How-to Guides picker, browses web docs, or jumps directly to a guide by title.0.2.87 在斜杠命令注册表中新增了docs命令见 src/session/slash_commands.rs 中的命令注册。该命令提供三种使用形态用法行为/docs打开 How-to Guides 选择器picker从本地文档列表中挑选指南/docs browse浏览 Web 版文档目录/docs 指南标题按标题直接跳转到对应指南这意味着如何配置某功能这类问题不再需要离开 TUI 手动查文档直接在命令行输入/docs即可检索。grok-build 的本地文档体系以~/.grok/docs下的 user-guide 为主TUI 内建指令也会在上下文注入时引用该路径/docs命令相当于给这个文档体系开了一扇可搜索、可跳转的入口。按模型的推理强度reasoning effort菜单服务端与 config.toml 双通道配置Per-model reasoning effort menus are now configurable from the server and config.toml without a client release.推理强度如 low / medium / high过去由客户端版本硬编码调整菜单需要随客户端发版。0.2.87 将其解耦为可独立配置的数据config.toml 通道在[model.*]配置块内声明该模型的推理强度元数据无需等待客户端发布即可增减菜单项服务端通道远端模型元数据reasoning effort 支持标记与可用选项可直接下发并生效实现服务端驱动的配置下发。源码层证据集中在 agent/config.rs模型条目包含default_reasoning_effort默认推理强度、supports_reasoning_effort是否支持与reasoning_efforts: VecReasoningEffortOption可选值列表等字段在配置合并时reasoning_efforts等字段采用非空即合并的语义reasoning_effortsmerge only when non-empty使得客户端默认值、本地 config.toml 与服务端元数据可以叠加生效。另外reasoning_effort_override作为 CLI 层覆盖项存在优先级语义与原有配置层级保持一致。这项改动让模型运营团队可以随时调整推理档位而终端用户只需在 TUI 的模型菜单中看到更新后的选项。完成的思考块折叠进分组的工具调用行Finished thinking blocks now fold into grouped tool-call rows when group_tool_verbs is enabled.grok-build 的 TUI 支持将连续的只读/搜索/列表类工具调用折叠为一行转录记录grouped tool-call rows由group_tool_verbs开关控制。0.2.87 之前模型思考thinking块完成后的内容仍单独展开显示导致转录流冗长现在思考块完成后会折叠进对应的分组工具调用行让界面保持紧凑、聚焦于实际动作。该开关的解析逻辑位于 src/util/config/resolve/ui.rs 的resolve_group_tool_verbs其优先级链为requirements 环境变量 GROK_GROUP_TOOL_VERBS [ui] group_tool_verbs managed 配置 远端设置 默认 true其中远端设置显式下发false可当作一键关闭kill switch。在本地持久化侧settings_writes.rs 提供set_group_tool_verbs(value)通过update_config写入[ui].group_tool_verbs。如果你想保持思考过程的完整可见性可在 config.toml 中设置[ui] group_tool_verbs false # true 为默认值折叠连续只读工具调用或用环境变量GROK_GROUP_TOOL_VERBSfalse临时覆盖优先于配置文件。该模块自带完整单元测试group_tool_verbs_tests覆盖了各优先级组合下的取值判定。Bug Fixes六处行为修复--minimal模式始终使用终端自身配色--minimal mode now always uses your terminals own colors so text stays readable on any background.--minimal是无 TUI 依赖的降级启动模式相关入口见 xai-grok-pager-minimal 系列。此前该模式可能套用 TUI 主题色在深色/浅色终端背景差异下出现前景色与背景色撞色、文本不可读的问题0.2.87 起--minimal强制回退到终端自身的默认配色确保任何背景下文字清晰可读。[model.*]配置中的非法字段不再导致模型消失Invalid fields in [model.*] config blocks no longer cause the whole model to disappear from the picker.模型选择器picker依赖[model.*]配置块生成条目。此前若某个配置块含有一个非法/未知字段整个模型的解析会失败并从选择器中消失连带它的合法配置一并丢失。0.2.87 改为对字段级容错非法字段被忽略或告警而模型的其余合法配置照常生效模型仍保留在 picker 中。这与 agent/config.rs 中模型条目字段的非空合并、逐字段校验语义一致——单个字段的问题不应拖垮整条模型配置。文件工具不再处理带字面量尾随换行/空白的路径File tools no longer target paths with literal trailing newlines or whitespace from model output.模型输出中偶尔会在文件路径后附带换行或空白字符如path/to/file\n此前文件工具会原样拼接这些字符导致目标路径错误找不到文件、误创建带异常字符的文件。0.2.87 在文件工具处理前对来自模型输出的路径做清洗剥离字面量尾随空白与换行后再执行读写从源头消除了这类路径污染。无自由输入问题弹窗的交互修复Fixed interactions in no-freeform question modals so clicks below the last option no longer enter input mode.某些权限/提问弹窗是不带自由输入框的no-freeform question modals只能点选预设选项。此前点击最后一个选项下方的空白区域会意外触发输入模式进入文本输入状态0.2.87 修复了该命中区域判定使点击选项之外的空隙不再进入输入模式避免误操作。后台任务在取消阻塞等待后正确唤醒 agentBackground tasks now correctly wake the agent after a cancelled blocking wait instead of staying idle.当后台任务因阻塞等待被取消时此前 agent 可能停留在 idle 状态不继续推进0.2.87 确保取消后立刻唤醒 agent 重新调度避免取消后卡死的假死现象。这一修复对依赖后台任务的并行工具调用、长任务编排场景很关键。复制引用文本不再带上引用栏前缀Copying quoted text from rendered responses no longer includes the quote bar prefix in pretty mode.在 pretty 渲染模式下响应中的引用块会带引用栏样式。此前从渲染结果直接复制引用文本时会把样式前缀一并复制进剪贴板0.2.87 在复制路径上剥离前缀复制出的内容是与原文一致的纯文本方便直接粘贴到编辑器或提交信息中。版本信息与升级建议版本号0.2.87发布日期2026-07-05全部 11 条变更5 Features 6 Bug Fixes均标注为非破坏性breaking_change: false见 changelogs/0.2.87.json升级无需迁移配置关注点建议启用group_tool_verbs折叠思考块的团队可先小范围验证界面紧凑度[model.*]容错生效后模型 picker 不再因单字段错误整体丢失模型排查配置问题时可结合字段级告警逐项检查。整体来看0.2.87 是一次体验平滑化版本权限拒绝可持久化降低了自动化场景的打扰频率/docs与推理强度配置解耦把文档导航和模型运营从客户端发版周期中解放出来而 6 处修复则集中消除了配色、路径清洗、弹窗交互、任务唤醒与复制行为上的边角问题让长会话场景下的 TUI 使用更加稳定顺滑。【免费下载链接】grok-buildSpaceXAIs coding agent harness and TUI. Fullscreen, mouse interactive, extensible.项目地址: https://gitcode.com/gh_mirrors/gr/grok-build创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考