
人工智能AI 应用AI Agent代码智能体开发工具CLIMCP Clients【免费下载链接】grok-buildSpaceXAIs coding agent harness and TUI. Fullscreen, mouse interactive, extensible.项目地址https://gitcode.com/gh_mirrors/gr/grok-build点击查看免费下载导读本文基于 grok-build 开源仓库的 0.2.61 版本变更记录发布于 2026-06-22系统梳理该版本在配置体系、终端交互、剪贴板与 SSH 场景下的全部功能增强与缺陷修复。读完本文你将掌握如何在config.toml中通过[features]与[goal]两个表完整配置 Goal 模式、理解/usage额度面板与 Wayland 剪贴板链路的变化并能快速判断升级 0.2.61 时需要注意的行为变更。一、版本概览一次以「配置化」与「SSH/剪贴板可靠性」为主题的迭代grok-build 0.2.61 于 2026-06-22 发布整体变更集中在三个方向配置能力前移Goal 模式/goal的总开关、限制项与角色模型首次完整下沉到config.toml开发者无需在会话内逐个敲命令即可在配置文件中统一治理账户与剪贴板体验/usage命令新增预付额度prepaid credits余额与自动充值状态展示Wayland 剪贴板复制链路加入wl-copy兜底SSH 场景可靠性修复了 Focus 报告跨 SSH 读取被拆分时的文本泄漏与事件丢失问题并针对 VS Code over SSH 的剪贴板复制增加非 ASCII 乱码警告。配套的机器可读变更清单见 0.2.61.json其中逐条标注了类别features / fixes与是否破坏性变更breaking_change——值得注意的是「关闭运行中进程的终端 tab 不再弹确认对话框」被标记为breaking_change: true这是本版本唯一的一条破坏性变更升级时需重点留意详见下文第七节。二、新特性一终端 Tab 关闭确认对话框——引入与回退的完整循环0.2.61 的 Features 部分先引入了Closing a terminal tabwith a running process now shows a confirmation dialog instead of killing it immediately.即当关闭一个仍有进程在运行的终端 tab 时不再立即杀死进程而是先弹出确认对话框避免误操作导致进程被直接终止。然而在同版本的 Bug Fixes 列表中出现了看似矛盾的一条Closing a terminal tabwith a running process no longer shows a confirmation dialog.对应 0.2.61.json 中这条记录被明确标记为breaking change。这说明该确认对话框在本版本迭代过程中被引入后又因故回退最终 0.2.61 的行为是「关闭带运行进程的终端 tab 不再显示确认对话框」。从源码结构看Tab 关闭与确认相关逻辑集中在 leader/mod.rs 与 prompt_suggest.rs 附近的会话提示链路中。升级建议如果你依赖「关闭 tab 前有二次确认」来保护长任务进程需要在 0.2.61 中改用其他保护手段如显式暂停任务、使用 Session 持久化。三、新特性二/usage 命令新增预付额度与自动充值状态/usage命令在本版本开始展示两类账户信息预付额度余额prepaid credits balance自动充值状态auto top-up status。这意味着用户无需离开终端去网页端核对账户即可在会话内直接查看计费与充值配置。相关实现位于 extensions/billing.rs该模块负责账单/额度数据的获取与展示同时被 mvp_agent/acp_agent.rs 中的 Agent 链路引用说明/usage的数据同样服务于 Agent 场景下的额度感知。四、新特性三Wayland 剪贴板新增 wl-copy 兜底与按通道诊断日志Wayland 环境下此前剪贴板复制可能因为依赖单一工具而失败。0.2.61 的改进是Clipboard copyon Wayland now also tries wl-copy; per-leg outcomes are now logged for diagnostics.即复制操作会依次尝试多个通道leg在原有通道之外追加wl-copy作为兜底同时每个通道的尝试结果都会单独写入日志便于排查「到底哪条复制链路失败」。这一改动让 Wayland 桌面用户如 GNOME/KDE Wayland 会话的复制可靠性显著提升也让诊断信息从「复制失败」这种黑盒反馈变成了可逐通道追踪的明细日志。五、新特性四Goal 模式全面配置化——[features] 与 [goal] 两张配置表这是 0.2.61 最核心的工程变更共两条Goal mode toggles and limitscan now be set in config.toml under the [features] table.All /goal options(toggles, limits, role models) are now configurable together in a [goal] table.5.1 [goal] 表Goal 模式的一站式配置在 0.2.61 之前/goal的各种开关、限制与角色模型只能通过会话内命令逐项设置现在它们全部可以在config.toml的[goal]表下统一配置。对照源码 config.rs 中的GoalConfig结构体完整的可用键如下配置键类型语义enabledboolGoal 模式总开关classifier_enabledbool分类器classifier是否启用planner_enabledbool规划器planner是否启用summary_enabledbool总结器summary是否启用use_current_model_onlybool所有 Goal 角色是否强制继承当前模型不单独路由模型verifier_countu32验证器verifier数量classifier_max_runsu32每个 Goal 的分类器最大运行次数下限受GOAL_CLASSIFIER_MAX_RUNS_MIN约束strategist_everyu32每 N 次分类器运行触发一次策略师strategistreverify_afteru32经过多少轮后重新验证planner_modelstring规划器角色使用的模型strategist_modelstring策略师角色使用的模型skeptic_modelsstring[]怀疑者skeptic角色模型池可配置多个源码中的de_tolerant_goal_role_model/de_tolerant_goal_role_models反序列化器表明模型字段采用容错解析——即使填写的模型名格式不完全规范也会被尽量兼容接收不会因单个字段格式问题导致整个配置加载失败。示例配置[goal] enabled true classifier_enabled true planner_enabled true summary_enabled true use_current_model_only false verifier_count 3 classifier_max_runs 5 strategist_every 2 reverify_after 3 planner_model grok-4 strategist_model grok-4 skeptic_models [grok-4-mini, grok-4-fast]5.2 解析优先级config env remote 内置默认从 config.rs 的resolve_goal()与resolve_goal_u32()等解析函数可以确认Goal 各项配置遵循分层覆盖的解析模型本地[goal]配置优先其次是环境变量层如use_current_model_only场景下环境层对部分字段有豁免再其次是远程设置remote settings例如goal_enabled、goal_classifier_enabled、goal_planner_enabled、goal_verifier_count、goal_classifier_max_runs等远端开关最后是内置默认值。resolve_goal()的注释还揭示了一个重要设计Goal 模式主开关默认开启Default ON同时远程设置的goal_enabled标志位可以整体关停该能力——这样做的原因是默认值不能架空远程部署的管控能力。而分类器/规划器/总结器的默认值都跟随 Goal 主开关本身/goal开启时它们默认开启除非配置/环境/远程设置单独关闭。5.3 [features] 表Goal 开关与更多功能开关的汇聚点[features]表在 0.2.61 中新增了对 Goal 模式开关与限制的支持。对照源码 config.rs 的Features结构体该表实际是一个功能开关的汇聚点除 Goal 相关键外还包括配置键类型默认/语义support_permissionbool是否允许 Agent 请求工具执行权限telemetryenum遥测模式None时回退远程设置/默认关codebase_indexingbool / string[]代码库图索引go-to-definition/references默认开启可传 glob 数组含!负向排除non_git_warningbool在非 Git 仓库启动时是否弹阻塞警告默认 falsemanaged_configbool托管配置拉取managed_config.toml requirements.toml默认 truetitle_refreshbool会话早期自动标题刷新image_genbool/imagine图像生成工具默认 truevideo_genbool/imagine-video视频工具默认 trueimage_gen_model_overridestring图像生成模型覆盖默认grok-imagine-image-qualityimage_edit_model_overridestring图像编辑模型覆盖compaction_modestringsummary默认|transcript|segments可被 CLI /GROK_COMPACTION_MODE覆盖compaction_detailstringnone|minimal|balanced|verbose默认compaction_tool_choicestring压缩时的工具选择策略mcp_liveness_watchersboolMCP 客户端存活轮询器 状态分发器默认 truemcp_auto_restartboolstdio MCP 服务器崩溃自动重启最多 3 次退避 1s/4s/16s默认开启mcp_push_server_statusboolPager 端订阅 MCP 服务器状态推送默认 true示例配置[features] goal_enabled true image_gen true video_gen false codebase_indexing true compaction_mode transcript mcp_auto_restart true注意mcp_liveness_watchers、mcp_auto_restart、mcp_push_server_status这几个键的注释明确说明它们会被util::config::resolve::mcp绕过结构体、直接从原始 TOML 重新读取结构体中的字段声明是为了避免serde_ignored将合法键误报为未识别键。其中mcp_push_server_status的 Pager 侧开关仅通过环境变量OnceLock缓存生效因此在config.toml里关闭该键并不会影响已启动进程的订阅行为——这类「声明键」与「生效路径」的差异是排查配置不生效时最容易被忽略的坑。六、新特性五VS Code over SSH 剪贴板乱码预警Clipboard copiesfrom VS Code over SSH now warn when non-ASCII text may be garbled.当用户通过 VS Code Remote-SSH 使用 grok-build 并复制包含非 ASCII 字符如中文、日文、Emoji的文本时由于 SSH 会话的编码链路可能对文本进行转码0.2.61 会给出乱码预警提示用户复制结果可能与源文本不一致。这是对「远程开发 剪贴板」这一高频场景的体验补齐与其让用户在粘贴后发现乱码不如在复制时提前告知风险。七、破坏性变更Tab 关闭确认的行为回退升级必读如第二节所述本版本唯一的breaking_change: true记录是Closing a terminal tabwith a running process no longer shows a confirmation dialog.即 0.2.61 最终交付的行为是关闭带有运行进程的终端 tab 时不再弹出确认对话框直接关闭。这恢复了此前的快捷关闭体验但代价是失去了一道误操作防线。若你的工作流依赖该确认升级后请改用其他方式保护长任务例如先CtrlZ挂起任务或使用独立的持久化会话。八、Bug 修复详解SSH、Agent 与并发场景的可靠性加固8.1 Focus 报告在 SSH 场景下的两项修复Focus reportsno longer leak as literal text when split across reads over SSH.Focus eventsnow fire correctly for SSH-split focus reports.远程开发中终端输出会被 SSH 链路拆分为多次读取read分片传输。此前若 Focus 报告恰好在分片边界被切断可能导致报告内容以字面文本的形式泄漏到终端界面上而不是作为结构化 Focus 事件被消费Focus 事件因分片不完整而无法正确触发。0.2.61 对跨分片的 Focus 报告做了重组修复同时保证「既不以字面文本泄漏又能正确触发 Focus 事件」。8.2 --disable-web-search 在无头与 Agent 模式真正生效--disable-web-searchnow honored in grok -p and grok agent; auxiliary model routing respects catalog overrides.此前--disable-web-search可能只在 TUI 交互模式下生效而在grok -p管道/一次性提示模式与grok agentAgent 模式下被忽略。0.2.61 修复了该参数在这两种模式下的生效问题并同时修复了辅助模型auxiliary model路由对 catalog 覆盖的遵循——即分类器、总结器等辅助角色的模型路由在 catalog 中配置了覆盖时应以覆盖为准而不是沿用默认路由。该参数的实现分散于 agent/config.rs、session/acp_session_impl/spawn.rs、agent/subagent 等模块的 spawn 链路中。8.3 布尔工具 Flag 支持字符串与数字Boolean tool flagsnow accept true/false/yes/no/1/0 strings and numbers in addition to native booleans.这是对工具参数解析的兼容性增强布尔型工具参数此前只接受原生true/false现在额外接受字符串true、false、yes、no数字1、0既包括1/0字符串也包括真正的数字类型。这意味着调用工具时无需再纠结参数格式无论 JSON 里传true、yes还是1都能被正确解析为布尔值显著降低了 Agent 与第三方客户端生成参数的出错率。8.4 会话并发写入下的状态回退修复Session last-active timestampsand message counts no longer regress under concurrent writers.多写者并发更新同一会话时旧的「最后活跃时间戳」和「消息计数」可能因写入顺序问题覆盖新值造成状态回退regress。0.2.61 修复了该竞争条件确保并发写入下这两个指标单调更新、不回退。8.5 iTerm2 图像显示回退 OSC 1337iTerm2now always uses text/metadata image fallback instead of broken OSC 1337 overlays.此前在 iTerm2 终端中图像可能通过 OSC 1337 控制序列以 overlay 方式渲染但该路径在部分场景下损坏。0.2.61 起iTerm2 一律改用text/metadata 图像回退方案即通过文本/元数据方式渲染行内图片保证图像展示的确定性。8.6 模型切换后提示队列卡死修复Model switchesno longer leave the prompt queue stuck after a reconnect.在会话重连后切换模型可能导致提示队列prompt queue卡死、后续输入无响应。0.2.61 修复了重连与模型切换交错时的队列状态机问题保证切换模型后队列能继续正常消费。8.7 自定义 Agent Profile 的 Harness 一致性Custom agent profilesnow correctly use the harness required by their pinned model.Subagentsunder custom profiles now adopt the correct harness from the parents model.自定义 Agent profile 可以固定pin特定模型而不同模型可能要求不同的 harness运行容器/执行环境。0.2.61 修复了两处关联问题自定义 profile 自身启动时应使用其固定模型所要求的 harness此前可能误用默认 harnessprofile 下的子代理subagent子代理应继承父级模型的 harness而不是各自采用错误/默认的 harness。这两项修复保证了「自定义 profile 子代理」场景下执行环境与模型要求的严格一致避免模型与容器能力不匹配导致的运行失败。8.8 Changelog 与 Release-notes 模态框滚动Changelog and release-notesmodals now scroll with the mouse wheel and arrow keys./changelog与 release-notes 弹窗此前只能通过拖拽滚动条查看0.2.61 起支持鼠标滚轮与方向键↑/↓滚动长变更记录的可浏览性大幅提升。九、版本文件与配套清单变更记录正文changelogs/0.2.61.md机器可读清单含 breaking_change 标记changelogs/0.2.61.jsonGoal 配置结构体GoalConfigsrc/agent/config.rs功能开关结构体Featuressrc/agent/config.rsGoal 开关解析优先级resolve_goalsrc/agent/config.rs/usage账单实现src/extensions/billing.rsTab 关闭相关会话逻辑src/leader/mod.rs十、升级建议小结行为变更0.2.61 中「关闭带运行进程的终端 tab」不再弹确认框属破坏性变更请评估对既有操作习惯的影响配置迁移若此前通过会话命令维护/goal各项设置可迁移到config.toml的[goal]表统一管理[features]表是功能总开关的推荐落点远程开发用户SSH 场景的 Focus 报告、剪贴板乱码预警、--disable-web-search生效等修复值得第一时间验证升级Wayland 用户剪贴板已具备wl-copy兜底若复制仍失败可查看按通道记录的诊断日志定位具体链路。赞分享人工智能AI 应用AI Agent代码智能体开发工具CLIMCP Clients【免费下载链接】grok-buildSpaceXAIs coding agent harness and TUI. Fullscreen, mouse interactive, extensible.项目地址https://gitcode.com/gh_mirrors/gr/grok-build点击查看免费下载相关推荐Arduino-ESP32 快速上手从点亮开发板到联网上传的完整教程Arduino ESP32 快速上手从点亮开发板到联网上传的完整教程 用一块几十元的 ESP32 开发板和一套免费的开发环境约 10 分钟就能把第一个联网程人工智能AI 应用AI Agent代码智能体开发工具CLIMCP ClientsAPNG Studio 深度指南在 GitHub Copilot 画布中构建动画 PNGAPNG Studio 深度指南在 GitHub Copilot 画布中构建动画 PNG 本指南基于 awesome copilot https://link文档知识库AI 技能/插件如何在Laravel项目中快速集成Intervention Validation5分钟上手教程如何在Laravel项目中快速集成Intervention Validation5分钟上手教程 Intervention Validation是一个为Lara人工智能AI 应用AI Agent代码智能体开发工具CLIMCP Clients上一篇512字节LISP的极限挑战从引导扇区到元循环求值器的实战解决方案下一篇Swow 项目常见问题解决方案创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考