grok 0.2.108 版本实战解读会话跨机续传、外部编辑器起草 Prompt 与 grok doctor 环境体检【免费下载链接】grok-buildSpaceXAIs coding agent harness and TUI. Fullscreen, mouse interactive, extensible.项目地址: https://gitcode.com/gh_mirrors/gr/grok-build本篇文章围绕 GitHub 加速计划 / gr / grok-build 仓库中 grokxAI coding agent 的 TUI 前端0.2.108 版本的变更日志展开逐一拆解该版本引入的四项关键改进会话在更换工作目录或切换机器后的恢复能力、minimal 模式下用外部编辑器编辑 Prompt 草稿CtrlG、无需进入 TUI 即可完成环境自检的grok doctor命令以及 headless 远端下grok wrap图片粘贴的修复。读完本文你将掌握这些功能的实际操作方式、底层实现原理与对应的源码位置可直接在自己的环境中验证与使用。一、版本背景与总体概览0.2.108 是 grok 的一个功能与修复并重的增量版本发布于 2026-07-21对应的变更记录位于 0.2.108.md。grok 是一个全屏、支持鼠标交互、可扩展的编码 agent 交互终端TUI底层由xai-grok-pagerTUI 主程序与xai-grok-shell会话与存储逻辑等 crate 组成。本次版本的核心变化可概括为类别内容FeaturesSessions 可在移动工作目录或切换机器后恢复Featuresminimal 模式下 CtrlG 打开外部编辑器编辑当前 Prompt 草稿不发送fullscreen 模式保留任务面板tasks paneFeaturesgrok doctor在不打开 TUI 的情况下检查终端、tmux、剪贴板与键盘配置Bug Fixes通过grok wrap的图片粘贴在 headless 远端上恢复可用下文按此顺序展开每个小节同时给出可复现的操作路径与源码级佐证。二、Sessions移动工作目录或切换机器后恢复2.1 功能说明0.2.108 之前会话与启动时的目录、机器环境强绑定一旦工作目录被移动或换到另一台机器之前的会话可能无法继续。本次更新后会话可以在工作目录被移动、或切换到另一台机器后恢复。2.2 底层实现会话数据的可搬运拷贝会话恢复能力的关键在于会话存储层支持搬运式拷贝。在 copy.rs 中copy_session_data_sync提供同步实现的会话数据拷贝入口其核心细节包括cwd 重写transform_conversation_cwd当源会话的cwd与目标会话的cwd不一致且未跳过 cwd 转换时会话对话中的路径会被重写到新目录见 copy.rs。这正是移动工作目录后恢复的直接支撑历史消息里记录的旧路径会被转换为新路径避免恢复后路径失效。增量 updates 的流式拷贝copy_updates_streaming将源会话的 updates 文件逐行拷贝到目标期间对撕裂行torn line做跳过处理copy.rs保证拷贝出的会话数据完整可用。checkpoint 与 sidecar 文件的迁移copy_referenced_checkpoints与copy_sidecar_file负责把会话引用的检查点与附属文件一并搬移copy.rs确保恢复后会话仍然自洽。从源码结构看切换机器场景走的是同一套数据迁移路径会话数据chat 文件与 updates 文件本质上是一组可整体搬移的 JSONL 文件配合 cwd 转换后即可在新机器上以新路径恢复。2.3 实际操作建议如果你只是把项目目录挪了位置恢复会话时会话内的对话路径会自动映射到新位置无需手工编辑会话文件。跨机器恢复时将 grok 的会话数据目录包含 chat 与 updates 文件整体同步到新机器即可之后在相同或映射后的路径下重新打开 grok会话应可继续。相关测试可在 session_resume_close_tests.rs 与 replay_tests.rs 中找到可据此了解会话恢复与关闭语义的预期行为。三、CtrlGminimal 模式外部编辑器编辑 Promptfullscreen 保留任务面板3.1 功能说明minimal 模式按下CtrlG会把当前 Prompt 草稿prompt draft交给外部编辑器编辑编辑完成后不会自动发送而是把编辑器里的内容回填到输入框由你确认后再发送。fullscreen 模式CtrlG 仍然打开任务面板tasks pane用于查看、跟踪与恢复后台任务行为保持不变。3.2 任务面板的既有语义在 fullscreen 模式下CtrlG 打开任务面板的用途在 defaults.rs 中有明确描述它用于把正在前台运行的 Execute 任务分离到后台继续运行同时你可以阅读、排队 Prompt 或启动其他任务并从任务面板CtrlG跟踪和恢复它。同时links.rs 中还有一次性提示Tip: CtrlG toggles the tasks pane帮助新用户发现该快捷键。3.3 外部编辑器实现的源码细节外部编辑器编辑 Prompt 的核心实现在 external_editor.rs关键设计如下编辑器解析顺序依次读取$VISUAL、$EDITOR两者皆为空或无效时回退到vi命令字符串使用shlex::split解析为 argvexternal_editor.rs。例如VISUALcode --wait会被拆成[code, --wait]。临时草稿文件草稿被物化到系统临时目录下的grok-prompt-{uuid}.mdUnix 下权限为0o600仅属主可读写并在Drop时自动删除external_editor.rs避免草稿内容残留。大小与编码保护编辑结果超过 4 MiBPROMPT_EDITOR_MAX_BYTES会被拒绝非 UTF-8 内容同样被拒绝并提示原始草稿已保留external_editor.rs。竞态保护编辑器打开期间如果草稿被其他输入面如语音、粘贴、附件占用或修改会放弃编辑器结果并提示相应原因VOICE_MESSAGE、PASTE_MESSAGE、ATTACHMENT_MESSAGE、OWNERSHIP_MESSAGE等见 external_editor.rs。结尾换行处理编辑器保存时通常会在文件末尾追加一个换行符实现会在草稿原本没有结尾换行时剥离这一个编辑器添加的换行保留草稿自带的结尾换行相关行为有专门测试覆盖见 external_editor.rs。3.4 实际使用# 推荐配置示例用 VS Code 等待模式作为外部编辑器 export VISUALcode --wait # 或使用 nvim export VISUALnvim在 minimal 模式下编辑好 Prompt 后返回 grok 界面输入框内容即为你保存的草稿——注意它不会自动发送需要你再次确认。若只是希望复用任务面板能力fullscreen 模式下的 CtrlG 语义不变。四、grok doctor不进 TUI 的环境体检4.1 功能说明0.2.108 新增grok doctor命令在不打开 TUI的前提下直接检查终端terminal、tmux、剪贴板clipboard与键盘keyboard配置并输出诊断报告。它适合在 shell 脚本、CI 或排障时快速确认 grok 运行环境是否就绪。4.2 命令用法grok doctor的实现位于 doctor_cmd/mod.rs通过 clap 定义子命令与参数grok doctor输出人类可读的诊断报告。grok doctor --json以 JSON 格式输出诊断报告DoctorArgs.json便于程序化解析报告带SCHEMA_VERSION 1版本号doctor_cmd/mod.rs。grok doctor fix列出可用的自动修复项不传 id 时。grok doctor fix id应用指定修复需要交互确认非交互终端需加--yesFixArgs.yes且依赖id见 doctor_cmd/mod.rs。# 基础体检 grok doctor # 输出 JSON 报告 grok doctor --json # 查看可自动修复的问题 grok doctor fix # 非交互式应用指定修复 grok doctor fix id --yes注意run_fix需要交互式终端来确认修复非交互场景下必须显式加--yes否则会报错doctor_cmd/mod.rs。4.3 诊断覆盖范围源码级人类可读报告由 doctor_cmd/human.rs 格式化其字段直接对应探测项terminal终端类型与版本terminal version通过 xtversion 探测。multiplexer是否运行在 tmux 等多路复用器内以及 byobu 信息。ssh是否处于 SSH 会话。color / themes颜色级别color level与可用主题数量n/total: 主题列表。keyboard键盘修饰键投递方式modifier deliverymacOS 上显示 OS rescue active其他平台提示 OS rescue unavailable on this platform。newline换行行为探测结果。clipboard剪贴板可用性区分local (tool)、remote (tool)、container (tool)、unavailable、off等状态doctor_cmd/human.rs。探测数据由diagnostics::probes::collect_standalone在独立进程中采集doctor_cmd/mod.rs因此无需启动完整 TUI。另外报告末尾会出现提示Some checks only run in Grok. Start Grok and run /doctor.说明还有一部分检查项只在 TUI 内的/doctor斜杠命令中执行doctor_cmd/human.rs。4.4 修复机制grok doctor fix的修复流程为采集带修复上下文的快照collect_standalone_fix→ 解析修复 idresolve_fix_id→ 根据环境构造FixRequest→ 生成修复计划plan_fix→ 预览并等待确认 → 执行apply_fix随后重新探测验证问题是否消除或校验持久化配置doctor_cmd/mod.rs。这一修复后再验证的闭环确保修复结果可被确认而非盲目写入配置。五、Bug Fixgrok wrap 图片粘贴在 headless 远端恢复可用5.1 问题与修复0.2.108 修复了通过grok wrap进行图片粘贴image paste在 headless 远端如无显示器的 SSH 会话上失效的问题。修复前headless 远端上粘贴图片可能静默失败或表现为无图片。5.2 实现机制核心实现在 wrap_clipboard_image.rs当远端在完整粘贴缺失无图片、无文本、无文件 URL且 wrap 已激活 OSC 52 sinkosc52_sink_active()通过GROK_OSC52_SINK/LC_GROK_OSC52_SINK环境变量标记时远端会在 stderr 上写出一条私有 OSC 请求序列ESC ] 999;GrokWrapClipboardImage? BELREQUEST_BODY见 wrap_clipboard_image.rs。wrap 收到该请求后从宿主机剪贴板读取图片并通过bracketed-paste 帧注入 PTY stdin从而走回正常的粘贴 chip路径把图片作为附件送入会话。数据帧格式为GROK_WRAP_IMG\nmime\nbase64MAGIC_IMG宿主机无图片时返回GROK_WRAP_NONEwrap_clipboard_image.rs。图片大小上限为20 MiBMAX_WRAP_IMAGE_BYTES超过 4 MiB 的视网膜截图不再被静默当作无图片处理超预算时宿主机一侧可 JPEG 重压缩后再注入wrap_clipboard_image.rs。值得说明的是该路径的信任模型任何能向 PTY 写入的进程都能借 wrap 请求宿主机粘贴板内容但这是有意为之——用户主动在自己的主机上启用了 wrap应答仅留在会话内且仅在 OSC 52 sink 激活时才响应因此不应将该模式推广到不受信任的多路复用器wrap_clipboard_image.rs。5.3 验证方式在 headless 远端SSH 且无显示服务器通过grok wrap连接后直接粘贴一张截图图片应作为附件进入会话相关回归测试可参考 task_result.rs 中关于 headless-SSHgrok wrapimage-paste fix 的测试注释。六、小结0.2.108 是一个实用价值明显的版本会话恢复工作目录移动或换机后仍可继续会话数据迁移层通过 cwd 重写、updates 流式拷贝与 checkpoint 迁移保证会话自洽copy.rs。外部编辑器编辑 Promptminimal 模式下 CtrlG 调起$VISUAL/$EDITOR/vi 编辑草稿且不自动发送并带大小、编码、竞态保护external_editor.rs。grok doctor无需进入 TUI 即可体检终端、tmux、剪贴板、键盘支持 JSON 输出与自动化修复doctor_cmd/mod.rs。wrap 图片粘贴headless 远端通过私有 OSC 协议 bracketed-paste 注入恢复图片粘贴能力wrap_clipboard_image.rs。如需更完整的版本演进脉络可继续浏览 xai-grok-shell changelogs 目录 下的其他版本记录涉及会话恢复与任务面板的端到端行为还可结合 session_resume_close_tests.rs 与 doctor_early_dispatch.rs 等测试深入理解。【免费下载链接】grok-buildSpaceXAIs coding agent harness and TUI. Fullscreen, mouse interactive, extensible.项目地址: https://gitcode.com/gh_mirrors/gr/grok-build创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
grok 0.2.108 版本实战解读：会话跨机续传、外部编辑器起草 Prompt 与 grok doctor 环境体检
grok 0.2.108 版本实战解读会话跨机续传、外部编辑器起草 Prompt 与 grok doctor 环境体检【免费下载链接】grok-buildSpaceXAIs coding agent harness and TUI. Fullscreen, mouse interactive, extensible.项目地址: https://gitcode.com/gh_mirrors/gr/grok-build本篇文章围绕 GitHub 加速计划 / gr / grok-build 仓库中 grokxAI coding agent 的 TUI 前端0.2.108 版本的变更日志展开逐一拆解该版本引入的四项关键改进会话在更换工作目录或切换机器后的恢复能力、minimal 模式下用外部编辑器编辑 Prompt 草稿CtrlG、无需进入 TUI 即可完成环境自检的grok doctor命令以及 headless 远端下grok wrap图片粘贴的修复。读完本文你将掌握这些功能的实际操作方式、底层实现原理与对应的源码位置可直接在自己的环境中验证与使用。一、版本背景与总体概览0.2.108 是 grok 的一个功能与修复并重的增量版本发布于 2026-07-21对应的变更记录位于 0.2.108.md。grok 是一个全屏、支持鼠标交互、可扩展的编码 agent 交互终端TUI底层由xai-grok-pagerTUI 主程序与xai-grok-shell会话与存储逻辑等 crate 组成。本次版本的核心变化可概括为类别内容FeaturesSessions 可在移动工作目录或切换机器后恢复Featuresminimal 模式下 CtrlG 打开外部编辑器编辑当前 Prompt 草稿不发送fullscreen 模式保留任务面板tasks paneFeaturesgrok doctor在不打开 TUI 的情况下检查终端、tmux、剪贴板与键盘配置Bug Fixes通过grok wrap的图片粘贴在 headless 远端上恢复可用下文按此顺序展开每个小节同时给出可复现的操作路径与源码级佐证。二、Sessions移动工作目录或切换机器后恢复2.1 功能说明0.2.108 之前会话与启动时的目录、机器环境强绑定一旦工作目录被移动或换到另一台机器之前的会话可能无法继续。本次更新后会话可以在工作目录被移动、或切换到另一台机器后恢复。2.2 底层实现会话数据的可搬运拷贝会话恢复能力的关键在于会话存储层支持搬运式拷贝。在 copy.rs 中copy_session_data_sync提供同步实现的会话数据拷贝入口其核心细节包括cwd 重写transform_conversation_cwd当源会话的cwd与目标会话的cwd不一致且未跳过 cwd 转换时会话对话中的路径会被重写到新目录见 copy.rs。这正是移动工作目录后恢复的直接支撑历史消息里记录的旧路径会被转换为新路径避免恢复后路径失效。增量 updates 的流式拷贝copy_updates_streaming将源会话的 updates 文件逐行拷贝到目标期间对撕裂行torn line做跳过处理copy.rs保证拷贝出的会话数据完整可用。checkpoint 与 sidecar 文件的迁移copy_referenced_checkpoints与copy_sidecar_file负责把会话引用的检查点与附属文件一并搬移copy.rs确保恢复后会话仍然自洽。从源码结构看切换机器场景走的是同一套数据迁移路径会话数据chat 文件与 updates 文件本质上是一组可整体搬移的 JSONL 文件配合 cwd 转换后即可在新机器上以新路径恢复。2.3 实际操作建议如果你只是把项目目录挪了位置恢复会话时会话内的对话路径会自动映射到新位置无需手工编辑会话文件。跨机器恢复时将 grok 的会话数据目录包含 chat 与 updates 文件整体同步到新机器即可之后在相同或映射后的路径下重新打开 grok会话应可继续。相关测试可在 session_resume_close_tests.rs 与 replay_tests.rs 中找到可据此了解会话恢复与关闭语义的预期行为。三、CtrlGminimal 模式外部编辑器编辑 Promptfullscreen 保留任务面板3.1 功能说明minimal 模式按下CtrlG会把当前 Prompt 草稿prompt draft交给外部编辑器编辑编辑完成后不会自动发送而是把编辑器里的内容回填到输入框由你确认后再发送。fullscreen 模式CtrlG 仍然打开任务面板tasks pane用于查看、跟踪与恢复后台任务行为保持不变。3.2 任务面板的既有语义在 fullscreen 模式下CtrlG 打开任务面板的用途在 defaults.rs 中有明确描述它用于把正在前台运行的 Execute 任务分离到后台继续运行同时你可以阅读、排队 Prompt 或启动其他任务并从任务面板CtrlG跟踪和恢复它。同时links.rs 中还有一次性提示Tip: CtrlG toggles the tasks pane帮助新用户发现该快捷键。3.3 外部编辑器实现的源码细节外部编辑器编辑 Prompt 的核心实现在 external_editor.rs关键设计如下编辑器解析顺序依次读取$VISUAL、$EDITOR两者皆为空或无效时回退到vi命令字符串使用shlex::split解析为 argvexternal_editor.rs。例如VISUALcode --wait会被拆成[code, --wait]。临时草稿文件草稿被物化到系统临时目录下的grok-prompt-{uuid}.mdUnix 下权限为0o600仅属主可读写并在Drop时自动删除external_editor.rs避免草稿内容残留。大小与编码保护编辑结果超过 4 MiBPROMPT_EDITOR_MAX_BYTES会被拒绝非 UTF-8 内容同样被拒绝并提示原始草稿已保留external_editor.rs。竞态保护编辑器打开期间如果草稿被其他输入面如语音、粘贴、附件占用或修改会放弃编辑器结果并提示相应原因VOICE_MESSAGE、PASTE_MESSAGE、ATTACHMENT_MESSAGE、OWNERSHIP_MESSAGE等见 external_editor.rs。结尾换行处理编辑器保存时通常会在文件末尾追加一个换行符实现会在草稿原本没有结尾换行时剥离这一个编辑器添加的换行保留草稿自带的结尾换行相关行为有专门测试覆盖见 external_editor.rs。3.4 实际使用# 推荐配置示例用 VS Code 等待模式作为外部编辑器 export VISUALcode --wait # 或使用 nvim export VISUALnvim在 minimal 模式下编辑好 Prompt 后返回 grok 界面输入框内容即为你保存的草稿——注意它不会自动发送需要你再次确认。若只是希望复用任务面板能力fullscreen 模式下的 CtrlG 语义不变。四、grok doctor不进 TUI 的环境体检4.1 功能说明0.2.108 新增grok doctor命令在不打开 TUI的前提下直接检查终端terminal、tmux、剪贴板clipboard与键盘keyboard配置并输出诊断报告。它适合在 shell 脚本、CI 或排障时快速确认 grok 运行环境是否就绪。4.2 命令用法grok doctor的实现位于 doctor_cmd/mod.rs通过 clap 定义子命令与参数grok doctor输出人类可读的诊断报告。grok doctor --json以 JSON 格式输出诊断报告DoctorArgs.json便于程序化解析报告带SCHEMA_VERSION 1版本号doctor_cmd/mod.rs。grok doctor fix列出可用的自动修复项不传 id 时。grok doctor fix id应用指定修复需要交互确认非交互终端需加--yesFixArgs.yes且依赖id见 doctor_cmd/mod.rs。# 基础体检 grok doctor # 输出 JSON 报告 grok doctor --json # 查看可自动修复的问题 grok doctor fix # 非交互式应用指定修复 grok doctor fix id --yes注意run_fix需要交互式终端来确认修复非交互场景下必须显式加--yes否则会报错doctor_cmd/mod.rs。4.3 诊断覆盖范围源码级人类可读报告由 doctor_cmd/human.rs 格式化其字段直接对应探测项terminal终端类型与版本terminal version通过 xtversion 探测。multiplexer是否运行在 tmux 等多路复用器内以及 byobu 信息。ssh是否处于 SSH 会话。color / themes颜色级别color level与可用主题数量n/total: 主题列表。keyboard键盘修饰键投递方式modifier deliverymacOS 上显示 OS rescue active其他平台提示 OS rescue unavailable on this platform。newline换行行为探测结果。clipboard剪贴板可用性区分local (tool)、remote (tool)、container (tool)、unavailable、off等状态doctor_cmd/human.rs。探测数据由diagnostics::probes::collect_standalone在独立进程中采集doctor_cmd/mod.rs因此无需启动完整 TUI。另外报告末尾会出现提示Some checks only run in Grok. Start Grok and run /doctor.说明还有一部分检查项只在 TUI 内的/doctor斜杠命令中执行doctor_cmd/human.rs。4.4 修复机制grok doctor fix的修复流程为采集带修复上下文的快照collect_standalone_fix→ 解析修复 idresolve_fix_id→ 根据环境构造FixRequest→ 生成修复计划plan_fix→ 预览并等待确认 → 执行apply_fix随后重新探测验证问题是否消除或校验持久化配置doctor_cmd/mod.rs。这一修复后再验证的闭环确保修复结果可被确认而非盲目写入配置。五、Bug Fixgrok wrap 图片粘贴在 headless 远端恢复可用5.1 问题与修复0.2.108 修复了通过grok wrap进行图片粘贴image paste在 headless 远端如无显示器的 SSH 会话上失效的问题。修复前headless 远端上粘贴图片可能静默失败或表现为无图片。5.2 实现机制核心实现在 wrap_clipboard_image.rs当远端在完整粘贴缺失无图片、无文本、无文件 URL且 wrap 已激活 OSC 52 sinkosc52_sink_active()通过GROK_OSC52_SINK/LC_GROK_OSC52_SINK环境变量标记时远端会在 stderr 上写出一条私有 OSC 请求序列ESC ] 999;GrokWrapClipboardImage? BELREQUEST_BODY见 wrap_clipboard_image.rs。wrap 收到该请求后从宿主机剪贴板读取图片并通过bracketed-paste 帧注入 PTY stdin从而走回正常的粘贴 chip路径把图片作为附件送入会话。数据帧格式为GROK_WRAP_IMG\nmime\nbase64MAGIC_IMG宿主机无图片时返回GROK_WRAP_NONEwrap_clipboard_image.rs。图片大小上限为20 MiBMAX_WRAP_IMAGE_BYTES超过 4 MiB 的视网膜截图不再被静默当作无图片处理超预算时宿主机一侧可 JPEG 重压缩后再注入wrap_clipboard_image.rs。值得说明的是该路径的信任模型任何能向 PTY 写入的进程都能借 wrap 请求宿主机粘贴板内容但这是有意为之——用户主动在自己的主机上启用了 wrap应答仅留在会话内且仅在 OSC 52 sink 激活时才响应因此不应将该模式推广到不受信任的多路复用器wrap_clipboard_image.rs。5.3 验证方式在 headless 远端SSH 且无显示服务器通过grok wrap连接后直接粘贴一张截图图片应作为附件进入会话相关回归测试可参考 task_result.rs 中关于 headless-SSHgrok wrapimage-paste fix 的测试注释。六、小结0.2.108 是一个实用价值明显的版本会话恢复工作目录移动或换机后仍可继续会话数据迁移层通过 cwd 重写、updates 流式拷贝与 checkpoint 迁移保证会话自洽copy.rs。外部编辑器编辑 Promptminimal 模式下 CtrlG 调起$VISUAL/$EDITOR/vi 编辑草稿且不自动发送并带大小、编码、竞态保护external_editor.rs。grok doctor无需进入 TUI 即可体检终端、tmux、剪贴板、键盘支持 JSON 输出与自动化修复doctor_cmd/mod.rs。wrap 图片粘贴headless 远端通过私有 OSC 协议 bracketed-paste 注入恢复图片粘贴能力wrap_clipboard_image.rs。如需更完整的版本演进脉络可继续浏览 xai-grok-shell changelogs 目录 下的其他版本记录涉及会话恢复与任务面板的端到端行为还可结合 session_resume_close_tests.rs 与 doctor_early_dispatch.rs 等测试深入理解。【免费下载链接】grok-buildSpaceXAIs coding agent harness and TUI. Fullscreen, mouse interactive, extensible.项目地址: https://gitcode.com/gh_mirrors/gr/grok-build创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考