xai-grok-shell 0.2.88 版本解读滚动体验、会话搜索、工具调用分组与推理努力记录全面升级【免费下载链接】grok-buildSpaceXAIs coding agent harness and TUI. Fullscreen, mouse interactive, extensible.项目地址: https://gitcode.com/gh_mirrors/gr/grok-buildxai-grok-shell 是 SpaceXAI 开源仓库 grok-build 中承载 Agent 终端 UITUI核心交互体验的 crate。0.2.88 版本发布于 2026-07-06围绕「更顺滑的滚动」、「更精准的会话检索」、「更清爽的转录视图」与「更可靠的会话恢复」四个方向带来了 6 项新特性与 3 项缺陷修复。本文以 0.2.88 变更说明 为骨架结合仓库源码逐一拆解每一项变更的配置方式、底层实现与调用链帮助读者在升级后快速调优并理解其工作原理。版本总览一次以交互体验为核心的迭代0.2.88 共包含 9 项变更结构化清单可参见同目录的 0.2.88.json全部标记为breaking_change: false即无破坏性变更、可平滑升级类别变更内容Features滚动更平滑优化触控板与滚轮处理支持可配置的速度与模式Features会话搜索返回更紧凑的多词结果对文件名与复数形态处理更好Features会话选择器Session picker对 2 个及以上字符的查询始终检索对话内容Features工具调用分组默认开启将连续读取/搜索折叠为单行展示Features插件标签页支持u键更新所选插件并给出非阻塞成功反馈Features会话使用的推理努力reasoning effort记录进 summary.json 与对话历史Fixes会话内容搜索正确索引包含转义序列换行、引号的消息Fixes加粗/斜体/删除线包裹下的格式化链接保持链接颜色Fixes历史文件含中断写入产生的损坏行时恢复会话不再永久失败下面按主题逐一展开。滚动体验优化速度、模式与方向皆可配置「Scrolling feels smoother」背后是滚轮wheel与触控板trackpad两类输入源的差异化处理以及四项新增/调整的滚动配置项。在 settings_writes.rs 中可以确认这些配置的持久化入口[ui].scroll_speed滚动速度经set_scroll_speed(value: i64)写入配置写前会先做 clamp 钳制避免极端值[ui].scroll_mode滚动模式取值为auto|wheel|trackpad由set_scroll_mode(value: String)写入[ui].invert_scroll是否反转滚动方向布尔值[ui].scroll_lines单次滚动行数同样在写入前做钳制。实际使用时在 TUI 配置文件中加入如下片段即可[ui] scroll_mode auto # auto | wheel | trackpad scroll_speed 3 # 越大滚动越快写入前自动 clamp scroll_lines 5 # 单次滚动行数 invert_scroll false # true 时反转滚动方向从配置解析层看这些 UI 布尔开关统一走 resolve/ui.rs 的resolve_ui_bool优先级链requirements 环境变量 [ui] 配置 managed 托管配置 远端Remote配置 默认值。滚动相关的速度与模式配置同样经由update_config统一落盘升级到 0.2.88 后无需迁移旧配置会按默认值平滑兼容。会话搜索与选择器FTS5 全文索引的精准化会话搜索是 xai-grok-shell 检索历史对话的核心能力底层是一条清晰的调用链。在 session_search.rs 的模块注释中明确写明了JSON-RPC - mvp_agent.ext_method() - session_search::handle() - storage::search::execute_search() - search_fts::SessionSearchIndex (SQLite FTS5)即对外暴露为 ACP 扩展方法x.ai/session/search请求支持query、cwd工作区过滤、limit默认 20、offset分页偏移与include_content是否附带内容片段等参数响应中的bootstrapping字段用于标识 FTS5 索引是否仍在初始化中。0.2.88 对这项能力做了三处细化多词查询返回更紧凑的结果多个词条联合命中时不再返回大量宽泛命中的会话而是收敛到更贴合查询意图的结果集文件名与复数形态处理更好对工具调用中出现的文件路径locations[].path以及英文词复数形态有更友好的匹配行为会话选择器规则调整查询长度达到 2 个及以上字符时Session picker 始终检索对话内容而不仅是会话标题/元数据短查询也能直接定位到正文。需要说明的是索引文本的抽取逻辑位于 search_content.rs它会从会话更新文件session update 文件中提取助手文本、用户消息文本与工具调用元数据title locations[].path抽取结果与恢复/回放resume/replay共用的 peek 结构保持同源因此「被索引的内容」与「恢复时回放的内容」不会漂移抽取后的哈希、去重与 SQLite 索引构建则位于xai-grok-session-searchcratecrates/codegen/xai-grok-session-search。工具调用分组默认开启转录视图更清爽Agent 执行任务时经常连续发起多轮文件读取read、搜索search、列出目录list等非破坏性调用0.2.88 之前这些调用会在转录transcript中各自占一行视觉噪音较大。本版本将「工具调用分组」改为默认开启将连续的非破坏性工具调用折叠进同一行展示。该开关在源码中的解析入口为 resolve/ui.rs 的resolve_group_tool_verbs注释明确说明其语义将连续的非破坏性工具调用reads/searches/lists折叠为一条转录行。默认值为true并且支持以下逐级覆盖优先级从高到低层级配置方式说明Requirement远端下发的硬性要求优先级最高环境变量GROK_GROUP_TOOL_VERBS0可一键关闭用户配置[ui] group_tool_verbs false写入 TOML 配置Managed托管配置企业托管场景Remote远端GrowthBook 类开关Some(false)即总开关对应单元测试见同文件group_tool_verbs_tests模块resolve/ui.rs覆盖了「默认开启」「每一层都能关闭」「env 覆盖 config 与 remote」「requirement 高于 env」等关键路径。若升级后希望保留旧的逐行展开样式在配置中写入group_tool_verbs false或设置环境变量GROK_GROUP_TOOL_VERBS0即可。插件标签页u键一键更新插件插件Plugin管理是 TUI 扩展生态的重要入口。0.2.88 为插件标签页新增了u快捷键在标签页中选中某个插件后按下u即可触发更新该插件且更新结果以非阻塞方式给出成功反馈用户无需等待插件更新流程结束即可继续其他操作。在插件更新通知的底层extensions/plugins.rs 提供了 ACP 扩展方法x.ai/plugins/notify-updates其请求体携带updates列表每个元素为(插件名, 旧版本, 新版本)三元组由handle.notify_plugin_updates分发——这与标签页u键触发的更新流程相互衔接。整体插件机制可参考 plugin.rs 与 marketplace 扩展extensions/marketplace.rs。推理努力Reasoning Effort落盘会话可追溯、可恢复0.2.88 将每个会话实际使用的推理努力reasoning effort写入summary.json与对话历史使得会话的「思考强度」可追溯并在恢复会话时原样还原。在会话启动阶段session_setup.rs 会从请求元数据解析 reasoning effortparse_reasoning_effort_meta与当前模型管理器持有的current_reasoning_effort()取其一作为会话初始努力值会话恢复时则读取summary.reasoning_effort兜底恢复同文件 session_setup.rs 的restore_effort initial_reasoning_effort.or(summary.reasoning_effort)。配套测试 storage/jsonl/tests.rs 验证了「模型切换后持久化清理旧 effort」的行为更新当前模型时summary 中的reasoning_effort会被清空避免旧模型的努力级别串用到新模型。解析与类型定义集中在 reasoning_effort.rs模型/采样相关调用方还包括 agent/models.rs 与 mvp_agent/agent_ops.rs 等。对用户而言这意味着跨会话恢复时思考强度设置与模型选择会保持一致不会再出现恢复后推理级别丢失的情况。健壮性修复损坏历史不再阻断恢复内容搜索正确处理转义序列此前包含换行、引号等转义序列的消息可能从搜索索引中静默丢失。根因在于抽取结构体直接以str借用 JSON 字段——serde 无法从含转义的 JSON 字符串中借用str一旦遇到转义就会报错并丢弃整条消息。0.2.88 将文本承载字段改为Cowa, str见 search_content.rs 的注释说明实现零拷贝的按需分配转义消息得以正确进入索引。SEARCH_CONTENT_CHAR_LIMIT常量200,000 字符则限制了单条抽取文本的上限防止超大消息拖垮索引。恢复会话对损坏行「隔离而非失败」中断写入可能让chat_history.jsonl残留半行 JSON。旧版本下读取到损坏行会让会话恢复永久失败0.2.88 改为容错加载首次检测到损坏时把原始文件保留为chat_history.jsonl.corrupt副本见 storage/jsonl/mod.rs并从实时文件中跳过坏行继续加载从而原始数据不丢失——quarantine 副本是坏行现场的唯一证据该转换仅在加载期生效不会回写污染源文件同处注释明确「load-time-only transform」跳过损坏行不会产生孤儿兄弟节点或污染后续解析storage/jsonl/mod.rs。配套测试 storage/jsonl/tests.rs 验证了 quarantine 副本的创建与「首次检测获胜」后续读取不同损坏文件不会重复覆盖副本等行为。同文件还包含list_sessions_recent_skips_corrupt_summary等测试storage/jsonl/tests.rs说明会话列表同样对损坏 summary 免疫。格式化链接保持链接颜色最后一项修复针对样式渲染当链接被加粗bold、斜体italic或删除线strikethrough等样式包裹时链接自身的颜色不再被样式覆盖丢失。这保证了转录与搜索结果中链接的可辨识度。升级与验证建议升级前0.2.88 无破坏性变更breaking_change均为false可直接升级升级后验证滚动在 TUI 中滚动测试触控板/滚轮手感按需通过[ui].scroll_mode/scroll_speed/scroll_lines/invert_scroll调优体验工具分组确认转录视图是否将连续 read/search 折叠为单行若偏好旧样式设置GROK_GROUP_TOOL_VERBS0检索历史会话使用 2 个及以上字符的查询验证会话选择器与内容搜索的命中质量查看变更全集完整变更历史可查阅 CHANGELOG.md 及changelogs/目录下按版本组织的 md/json 配对文件。总体而言0.2.88 是 xai-grok-shell 在「交互顺滑度」与「数据可靠性」上的双重打磨滚动与转录视图让日常操作更顺手FTS5 索引的转义修复与损坏行隔离则让会话检索和恢复在异常数据面前依然稳定而 reasoning effort 落盘补齐了跨会话的模型状态一致性。【免费下载链接】grok-buildSpaceXAIs coding agent harness and TUI. Fullscreen, mouse interactive, extensible.项目地址: https://gitcode.com/gh_mirrors/gr/grok-build创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考