mcpField
T
tui-tester

tui-tester

github.com/google-gemini测试与质量108.6k129 次安装今天更新
代码仓库

关于 tui-tester

用于通过终端自动化测试 Gemini CLI 行为和界面渲染的技能，规定了环境设置、会话操作与故障恢复流程，便于重复执行 TUI 检查。

主要功能

  1. 01自动检查终端交互
  2. 02验证不同尺寸和状态下的渲染
  3. 03回归测试交互流程
  4. 04规范会话与故障恢复步骤

适用场景

  1. 01合并前检查 Gemini CLI 改动
  2. 02发现不同终端尺寸下的布局问题
  3. 03复现交互工作流故障

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/google-gemini/gemini-cli --skill tui-tester

安装后在 Claude Code 中输入/tui-tester确认已加载。

详细介绍

TUI 测试器技能

此技能提供操作手册，指导如何使用终端自动化验证 Gemini CLI 的行为变更和视觉输出。

核心职责

  • 验证行为：确认代码变更会产生预期的终端交互。
  • 视觉验证：确保 TUI 在不同终端尺寸和状态下都能正确渲染。
  • 回归测试：使用自动化防止现有交互式工作流被破坏。

关键协议

进行 TUI 测试时，必须遵守以下严格规则：

1. 初始化

你的首要操作必须是： 激活 agent-tui 技能。这会提供终端自动化所需的底层工具。

2. 环境设置（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
3. 会话管理
  • 会话 ID：后续交互始终使用 agent-tui run 返回的 session_id。
  • 原子化执行：每轮恰好执行一条命令。不要通过管道串联操作。
  • 循环流程：操作 -> 等待 -> 截图 -> 验证 -> 下一步操作。
4. Gemini CLI 特定要求
  • 先构建：测试本地变更前，始终运行 npm run build 或 npm run build:all。
  • 绕过信任检查：设置 GEMINI_CLI_TRUST_WORKSPACE=true，以避免弹出窃取焦点的模态窗口。
  • 隔离配置：使用 GEMINI_CLI_HOME，避免个人设置受到干扰。

工作流示例

# Start the CLI
env GEMINI_CLI_TRUST_WORKSPACE=true agent-tui run node packages/cli/dist/index.js

# Wait for the prompt
agent-tui wait "│" --assert

# Send a command
agent-tui type "/help"
agent-tui press Enter

# Verify output
agent-tui wait "Available Commands" --assert

错误恢复

如果等待超时，请重新截图以诊断当前状态。如果看到 os error 61，请使用 tmux 方法重启守护进程。

评论

支持 Markdown