用途:pty-bridge 是一个命令行工具,用于管理带完整 PTY 支持的交互式终端会话。当标准 Bash 工具无法处理交互式程序时使用,例如 SSH、REPL(python、node、irb、psql、mysql 等)、需要输入密码或确认的程序、TUI 应用(htop、vim、less 等),以及任何会挂起或行为异常的命令。
安装:npm i -g github:briqt/pty-bridge。需要 Node.js 18+ 和 C++ 构建工具链(Debian/Ubuntu 上执行 apt install build-essential python3)。
主要能力:start 启动 PTY 会话;read 读取新输出(默认增量,--full 读取全部,--buffer 可选 normal/alternate/active);write 发送输入(可用 --stdin 管道传入);exec 执行命令并返回新输出(默认等待 200ms,支持 --wait 与 --wait-for-idle);sendkey 发送特殊键;wait-for 阻塞直到出现指定模式(默认 30s);snapshot 捕获当前可见屏幕;list 列出活动会话;kill 终止会话;resize 调整终端尺寸;status 查看守护进程状态。
使用方式:SSH 会话可加 --keepalive 30 防止超时;密码等敏感信息建议用 echo -n "password" | pty-bridge write <id> --stdin 再 sendkey enter;优先用 exec 代替 write + sendkey enter,它合并写入、回车、等待和读取;长操作使用 wait-for 而非 sleep;完成后用 kill 释放资源。终端默认 120x40,TUI 应用可用 resize 调整。客户端套接字超时可通过 PTY_BRIDGE_TIMEOUT 环境变量配置(毫秒,默认 30000)。
限制:无活动会话时守护进程 5 分钟后自动退出;资料未提供更多平台、收费或效果信息。