企业官网建设流程全解析

grok-build v0.2.87 版本解读：自动订阅升级、/docs 导航与按模型推理强度配置

【免费下载链接】grok-buildSpaceXAI's coding agent harness and TUI. Fullscreen, mouse interactive, extensible.项目地址: https://gitcode.com/gh_mirrors/gr/grok-build

grok-build（SpaceXAI 的 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：五个新能力

订阅升级自动生效，无需重启 CLI

"Subscription 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 中的命令注册）。该命令提供三种使用形态：

这意味着"如何配置某功能"这类问题不再需要离开 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: Vec<ReasoningEffortOption>（可选值列表）等字段；在配置合并时，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_VERBS=false临时覆盖（优先于配置文件）。该模块自带完整单元测试（group_tool_verbs_tests），覆盖了各优先级组合下的取值判定。

Bug Fixes：六处行为修复

--minimal模式始终使用终端自身配色

"--minimal mode now always uses your terminal's 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 修复了该命中区域判定，使点击选项之外的空隙不再进入输入模式，避免误操作。

后台任务在取消阻塞等待后正确唤醒 agent

"Background 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-buildSpaceXAI's coding agent harness and TUI. Fullscreen, mouse interactive, extensible.项目地址: https://gitcode.com/gh_mirrors/gr/grok-build