用途:tui-tester 是 Gemini CLI 的技能,提供使用终端自动化验证 Gemini CLI 行为变更与视觉输出的操作手册,用于确认代码改动产生预期的终端交互、检查 TUI 在不同终端尺寸与状态下的渲染,并通过自动化防止破坏既有交互流程。
主要能力:行为验证、视觉校验、回归测试。
使用方式:第一步必须激活 agent-tui 技能以获取终端自动化所需工具。环境准备(macOS / 并行安全)需确保全局守护进程运行并打开实时预览,资料给出的命令为: if ! agent-tui sessions >/dev/null 2>&1; then tmux kill-session -t agent-tui 2>/dev/null || true agent-tui daemon stop 2>/dev/null || true rm -f /tmp/agent-tui* tmux new-session -d -s agent-tui 'agent-tui daemon start --foreground > /tmp/agent-tui-daemon.log 2>&1' sleep 1 fi agent-tui live start --open
会话管理:始终使用 agent-tui run 返回的 session_id 进行后续交互;每轮只执行一条命令,不做流水线操作;遵循“操作→等待→截图→验证→下一步”的循环。
Gemini CLI 相关要点:测试本地改动前先运行 npm run build 或 npm run build:all;设置 GEMINI_CLI_TRUST_WORKSPACE=true 以避免抢焦点的模态框;使用 GEMINI_CLI_HOME 隔离配置,避免干扰个人设置。
工作流示例: env GEMINI_CLI_TRUST_WORKSPACE=true agent-tui run node packages/cli/dist/index.js agent-tui wait "│" --assert agent-tui type "/help" agent-tui press Enter agent-tui wait "Available Commands" --assert
错误恢复:若 wait 超时,重新截图诊断状态;若出现 os error 61,使用 tmux 方法重启守护进程。
限制:资料未提供该技能的收费、价格、支持平台范围及效果保证等信息。