终端支持

颜色显示异常

在 shell 配置文件中设置 COLORTERM=truecolor。在 tmux 中，还要启用 24 位 RGB：

# ~/.tmux.conf
set -g default-terminal "tmux-256color"
set -as terminal-features ",*:RGB"
set -g set-clipboard on
set -g allow-passthrough on

最后两行还会修复剪贴板和通知透传；使用 tmux source-file ~/.tmux.conf 重新加载配置。

复制内容未写入剪贴板

Grok 会写入操作系统原生剪贴板和 tmux 内的粘贴缓冲区，并针对远程环境（SSH、容器、Linux）发出 OSC 52。两个常见阻碍因素：

• iTerm2 会忽略 OSC 52，直到启用 Settings → General → Selection → “Applications in terminal may access clipboard”。

• Apple Terminal 会完全忽略 OSC 52，因此通过 SSH 复制的内容无法进入本地剪贴板。请改为使用包装远程命令：grok wrap ssh user@host 会在本地 PTY 中运行该命令，拦截 OSC 52 并写入剪贴板。同样适用于 grok wrap docker exec ... 和 grok wrap kubectl exec ...。grok wrap 是实验性功能。

组合键无法使用

• WezTerm：将 config.enable_kitty_keyboard = true 添加到 wezterm.lua，然后重启；这会修复用于立即发送的 Ctrl+Enter 和用于换行的 Shift+Enter。

• VS Code、Cursor、Windsurf 和 Zed 终端无法区分 Shift+Enter 与 Enter；请使用 Alt+Enter 换行。通过 SSH 使用 VS Code 时同样如此。

• Zellij 会拦截许多 Ctrl 组合键。在 Zellij 0.41+ 上，切换到 “Unlock-First (non-colliding)” preset（Ctrl+O → c → Change Mode Behavior）；需要时使用 Ctrl+G 暂时解锁 Zellij。

• Apple Terminal 不支持 Kitty keyboard protocol，因此无法把 Ctrl+Enter 或 Ctrl+I 作为独立按键发送。有关立即发送的组合键，参见终端差异。

不显示全屏，或鼠标滚动失效

Grok 在 Zellij 和 tmux control mode（tmux -CC）下会有意以内联模式运行；设置 alt_screen = "always" 可强制全屏，该设置位于 [terminal] 下的 ~/.grok/pager.toml；也可以在任意位置使用 --no-alt-screen 禁用全屏。

如果终端原生滚动条接管滚动，说明鼠标报告功能已关闭：Apple Terminal 可通过 View → Allow Mouse Reporting（Cmd+R）重新启用；iTerm2 可通过 Settings → Profiles → Terminal → “Enable mouse reporting” 启用。

仍然遇到问题？运行 /feedback。