用途:为 Sidecar 提供交互式 shell/TTY 集成,让用户在 TUI 内直接向 tmux 会话输入,tmux 作为 PTY 后端,控制模式字节经共享 tty.Model 渲染。
主要能力:按键经 MapKeyToTmux 转为 tmux send-keys;控制模式有序输出经会话池化 actor 与 screenmodel 适配器发布;控制不可用时使用有界 capture 轮询回退;支持光标定位、原生光标、滚动(基于捕获缓冲,不进入 tmux copy-mode)、复制粘贴(alt+c/alt+v,支持 bracketed paste)、URL/路径检测、内联编辑(vim/nano/emacs)与宽度同步。
使用方式:工作区中在预览面板聚焦输出标签时按 enter/E 进入,Ctrl+\ 或双击 Escape 退出,Ctrl+] 仅在 tmux_full_attach 开启时附加;文件浏览器中对文件按 e 或 Enter 进入内联编辑。功能开关包括 tmux_interactive_input、tmux_inline_edit、tmux_full_attach、workspace_terminal_panel。配置项含 interactiveExitKey、interactiveAttachKey、interactiveCopyKey、interactivePasteKey、tmuxCaptureMaxBytes、copyOnSelect。
限制:回退轮询仅在首个模型帧前及控制失败后使用;滚动历史受共享 10,000 行 tmux 策略约束;诊断需 SIDECAR_PPROF 与 SIDECAR_TERMINAL_PERF=1,追踪需 SIDECAR_TERMINAL_TRACE=1,且仅限隔离环境。