人工智能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 Shell本仓库 xai-grok-shell 及其上层 pager在 0.2.118 版本中带来 3 项新特性与 9 项修复覆盖会话生命周期管理、快捷键学习、tmux 环境诊断、/btw临时过载重试、后台任务状态同步与 compaction 上下文长度错误处理等核心体验。本文以官方 changelog 为骨架结合仓库源码与测试逐一拆解每个改动背后的实现机制与使用姿势帮助你升级后快速上手并理解这些细节为何重要。一、特性会话可永久删除Dashboard CtrlX ×2 / 欢迎页 dy0.2.118 最大的交互变化是会话Sessions现在可以从界面中永久删除不再是只能归档/隐藏在Dashboard仪表盘中将光标停在一条空闲idle会话行上按CtrlX两次即可永久删除第一次按下的作用是武装arm删除第二次才是确认执行避免误触。在欢迎页welcome list中按d然后y两步完成删除d delete 意图y yes 确认。从 dashboard/render.rs 的源码看删除入口的实现细节行尾部会渲染一个[✗]ballot-x删除标记只有allows_delete()的行才会显示——工作working状态的行不允许删除测试 render_tests.rs 专门断言了hover 到 settled 行显示 [✗]hover 到 busy 行不显示。删除确认存在一个CONFIRM_WINDOW超时窗口武装后若超时下一次CtrlX会直接执行删除因此底栏提示会区分press again与直接执行两种文案见 render.rs 的相关测试。底栏ShortcutsBar会实时提示当前行的可用操作正在运行的行CtrlX显示为stop停止空闲行则显示为delete删除——同一次按键在不同行状态下语义不同界面会明确标注render.rs。⚠️ 注意删除是永久性操作执行后会话数据不可恢复请确认会话内容已不需要再使用。二、特性快捷键帮助Ctrl.新增提示历史与对话搜索指引Ctrl.打开键盘快捷键帮助面板views/shortcuts_help.rs0.2.118 起该面板增加了两块新内容如何浏览 Prompt 历史prompt history即上下翻看之前输入过的提示词。如何搜索对话search the conversation在会话内定位之前的内容。实现上pager 侧的prompt.history_search状态与帮助面板联动见 views/agent.rs相关场景测试覆盖在 tests/scenarios/shortcuts_help_detail.yaml 与 scripted_scenarios.rs。这是典型的功能已经存在但入口不显眼问题这次通过帮助面板让用户可发现discoverable。三、特性grok doctor 检测 tmux 降级颜色并可修复在 tmux 中运行 Grok Shell 时24-bit TrueColor 可能被 tmux 静默降级为客户端 terminfo 调色板导致界面颜色发灰、主题失真。0.2.118 的grok doctor新增检测当检测到 tmux 在降低颜色深度时给出警告并可直接修复配置。诊断原理pager 的 diagnostics/probes/tmux.rs 定义了TmuxOptionQuerytrait通过查询 tmux 运行时选项来判断show_option(option)查询某个 tmux option 的当前值如set-clipboard、extended-keys、terminal-features。option_support(option)探测 option 是否被当前 tmux 版本支持。control_mode()是否启用了 tmux control mode。client_features()获取附加客户端解析后的终端特性这决定了 tmux 是转发 24-bit 颜色还是降级到客户端的 terminfo 调色板正是 TrueColor 问题的根源。可修复项与对应命令修复注册表定义在 diagnostics/fix.rs0.2.118 起grok doctor可处理四类 tmux 相关诊断不止颜色还包括剪贴板与按键编码诊断 ID检查的 tmux 选项期望值修复命令terminal.tmux-clipboardset-clipboardon/externalgrok doctor fix terminal.tmux-clipboardterminal.dcs-passthroughallow-passthroughon/allgrok doctor fix terminal.dcs-passthroughterminal.tmux-extended-keysextended-keysongrok doctor fix terminal.tmux-extended-keysterminal.tmux-truecolorterminal-features追加,*:RGBgrok doctor fix terminal.tmux-truecolor对应的配置行由 doctor 写入用户 tmux 配置通常是~/.tmux.conf或 byobu 的~/.byobu/.tmux.confset -g set-clipboard on # 允许 OSC 52 剪贴板透传 set -wg allow-passthrough on # 允许 DCS 透传嵌套会话剪贴板 set -g extended-keys on # 启用扩展按键编码 set -as terminal-features ,*:RGB # 声明终端支持 24-bit RGB 并透传ℹ️ 需要注意grok doctor只会持久化写入配置文件不会修改正在运行的 tmux 服务器。修复后需要执行tmux source-file ~/.tmux.conf或对应配置文件重新加载或重启 tmux server 后生效随后可再次运行grok doctor验证运行时设置是否已变健康见 fix.rs 的修复输出文案与 doctor_format_tests.rs 的测试快照。⚠️ 限制提示Grok 只会检查配置文件中对该选项的直接全局赋值对于 source 引入的其它文件、条件块、插件或脚本生成的 tmux 配置需要自行复查源码中的TMUX_SCANNER_CAVEAT注释已明确这一点。四、修复/btw遇到模型临时过载时自动重试/btw是 Grok Shell 的顺带提问功能不打断当前回合用一次独立模型调用回答一个旁路问题答案记录到btw_history.jsonl会话持久化见 session/acp_session_impl/recap.rs。此前当模型服务出现临时过载transient overload时/btw会直接失败0.2.118 起改为自动重试。实现要点重试策略backon::ExponentialBuilder最多 3 次尝试1 次原始 2 次重试退避 500ms → 1s 并带抖动jitter。策略刻意保持短小避免在服务端容量事件时把旁路问题流量放大成重试风暴recap.rs。重试判定should_retry_side_question复用SamplingError::is_retryable5xx、含 Cloudflare 52x、流/连接故障排除429 限流需要Retry-After量级的等待不适合亚秒级预算以及被显式 veto 的情况如x-should-retry: false、context length 错误recap.rs。请求去重每次重试克隆基础请求并盖上新的x_grok_req_idxai-btw-{uuid}避免重试在日志/追踪中互相冲突recap.rs。每次尝试/最终结果都会写入BtwEntry持久化记录含 attempts 计数失败原因也会保留便于事后排查recap.rs。源码注释提到 SEV-576/btw曾在 Cloudflare 522 错误下挂掉本次重试正是针对这类边缘错误加固。五、修复会话分享暂时禁用Session sharing会话分享在 0.2.118 被临时禁用temporarily disabled。这属于服务端能力开关客户端仍保留相关代码与类型定义如 remote/client.rs、extensions/session_admin.rs但当前版本不可用。升级后若发现分享入口不可用属预期行为等待后续版本恢复即可。六、修复/compact期间[stop]/ CtrlC 真正生效/compact压缩长对话时会阻塞一段时间。此前在压缩过程中按[stop]或CtrlC是no-op无效用户只能干等0.2.118 修复为按下即可取消压缩流程。这属于会话级中断处理session interrupt与压缩流程compaction之间的协作修复相关代码路径可参考 session/compaction 相关实现 与 agent/compaction.rs。七、修复同一回合后自动 recap 不再重复出现Automatic recaps自动摘要此前在同一回合结束后可能出现两次0.2.118 修复了去重问题。recap 的生成、持久化与展示生命周期集中在 session/acp_session_impl/recap.rs并受xai_chat_state的会话状态机驱动xai-chat-state。修复点位于回合完成与 recap 触发之间的状态判定确保每个 turn 只产出一条 recap。八、修复后台任务等待超时的文案与上限对齐客户端配置后台任务background task的等待超时wait timeout此前在提示文案与实际生效上限之间存在不一致——界面上显示的描述和限制与客户端真实配置的 ceiling 对不上。0.2.118 让描述与上限统一以客户端实际配置为准避免界面写 60s、实际 30s这类认知偏差。相关逻辑在 terminal/background_task.rs 与 extensions/task.rs。九、修复快速结束的后台任务不再卡在 Running 状态后台任务如果很快就结束任务面板tasks pane此前可能把它一直显示为Running与实际状态脱节。0.2.118 修复了状态同步竞态——任务完成事件与 UI 刷新之间的时序问题。Dashboard 的任务面板状态管理可见 views/dashboard/state.rs其中对 bg_tasks 的历史留存但状态正确有专门处理避免残留陈旧徽标row.rs。十、修复批准计划后 Plan mode 指示器立即消失Plan mode计划模式指示器此前在批准计划之后还会残留一段时间0.2.118 修复为批准后立即消失界面状态切换更跟手。该指示器属于 agent 视图的渲染状态app/agent_view/render.rs修复确保 plan 状态与 UI 指示同步收敛。十一、修复计划预览中拖拽滚动条正常响应计划预览plan preview中的滚动条拖拽行为此前异常0.2.118 修复为正常响应鼠标拖拽。鼠标交互管线位于 input/mouse.rs其拖拽/手势处理在 pager-pty-harness 的 scroll_matrix/gestures.rs 中有系统性的测试覆盖。十二、修复Compaction 正确处理推理 API 的上下文长度错误压缩Compaction在触发时如果推理 API 返回特定类型的上下文长度context-length错误此前处理不当可能误重试或异常中断0.2.118 修复了该错误分类逻辑——上下文长度错误应走调整后重试/降级路径而非普通瞬态错误路径。这与上面/btw重试判定中的 context length veto 是同一套错误分类体系SamplingError::is_retry_vetoed相关见 recap.rs 与 xai-grok-sampling-types 的错误定义保证了压缩流程在边界条件下仍能正确收敛。小结0.2.118 是一次典型的体验打磨 可靠性加固版本新增能力会话可永久删除DashboardCtrlX×2 / 欢迎页dy、快捷键帮助补全Ctrl.查看历史浏览与对话搜索指引、grok doctor可诊断并修复 tmux 颜色降级连同剪贴板/扩展按键共 4 个修复项。可靠性修复/btw临时过载自动重试、/compact可中断、recap 去重、后台任务状态同步与超时文案对齐、计划模式指示器与滚动条修复、compaction 上下文长度错误正确处理。升级建议升级后先跑一次grok doctor若在 tmux 下使用且界面颜色发灰直接执行grok doctor fix terminal.tmux-truecolor并 reload tmux 配置即可恢复 24-bit TrueColor 渲染。赞分享人工智能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.115 版本技术解读会话删除、认证修复、诊断稳定性与提示缓存优化grok build 0.2.115 版本技术解读会话删除、认证修复、诊断稳定性与提示缓存优化 本指南基于 crates/codegen/xai grok s人工智能AI 应用AI Agent代码智能体开发工具CLIMCP ClientsWindows快捷键冲突一键修复三步诊断与永久解决方案Windows快捷键冲突一键修复三步诊断与永久解决方案 你是否曾经遇到过这样的困扰按下CtrlC复制文本时毫无反应使用AltTab切换窗口却弹出意外程桌面应用OpenProject 7.0.3 发布解析会话安全修复与七项关键 Bug 修复的源码级解读OpenProject 7.0.3 发布解析会话安全修复与七项关键 Bug 修复的源码级解读 OpenProject 7.0.3 是 2017 年 6 月 2后端前端项目管理企业应用协同办公上一篇Xinference 可观测性体系Supervisor 与 Worker 双端 Prometheus 指标导出器实战下一篇autocannon性能测试的标准化建立企业级测试规范创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考