SuperAPI AI 工具集

tmux

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

用途:该技能用 tmux 作为可编程终端复用器,远程控制交互式命令行程序(如 python、gdb、lldb,以及 ipdb、psql、mysql、node、bash 等 TTY 应用),并管理长时间运行或后台进程。Linux 和 macOS 上使用原生 tmux,通过私有 socket 避免受自定义配置影响。

主要能力:新建、发送按键、捕获面板输出、列出会话与面板、等待文本、结束会话。目标格式为 {session}:{window}.{pane},省略时默认 :0.0。用 -S "$SOCKET" 固定私有 socket 路径;用 -f /dev/null 获得干净配置,需要用户配置时去掉该参数。

使用方式(命令保持原样): SOCKET_DIR=${TMPDIR:-/tmp}/pi-tmux-sockets mkdir -p "$SOCKET_DIR" SOCKET="$SOCKET_DIR/pi.sock" SESSION=pi-python tmux -S "$SOCKET" new -d -s "$SESSION" -n shell tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- 'python3 -q' Enter tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200 tmux -S "$SOCKET" kill-session -t "$SESSION"

启动会话后应打印监控命令,例如 tmux -S "$SOCKET" attach -t pi-lldb,或一次性捕获 tmux -S "$SOCKET" capture-pane -p -J -t pi-lldb:0.0 -S -200。发送输入优先用 -l 字面量避免 shell 拆分;发送控制键如 C-c、C-d、C-z、Escape。等待提示符用 ./scripts/wait-for-text.sh -t "$SESSION":0.0 -p '^>>>' -T 15 -l 4000。查找会话可用 ./scripts/find-sessions.sh -S "$SOCKET" 或 --all。

限制与规则:socket 须放在 PI_TMUX_SOCKET_DIR(默认 ${TMPDIR:-/tmp}/pi-tmux-sockets);调试默认用 lldb;启动 Python 交互式 shell 须设 PYTHON_BASIC_REPL=1,否则非 basic 控制台会干扰 send-keys;gdb 需先 set pagination off。tmux wait-for 不监视面板输出,连续监控应轮询。清理可 kill-session、按 socket 批量 kill 或 kill-server。