用途:用可重复的本地 harness 驱动交互式 CLI/TUI,避免手动反复操作。适合复现 CLI/TUI bug、验证键盘流程与终端布局、记录修复前后对比、分析启动耗时/慢操作/卡死/内存增长、录制简短终端演示。
主要能力与循环:先确认被测命令和最小可复现工作区;优先查找仓库自带的测试/演示 harness(package scripts、e2e 测试、demo 录制器、expect 脚本或 PTY 辅助);若无则用标准本地工具搭建临时 harness。流程为:在隔离终端会话中以确定性环境变量启动 CLI,捕获当前屏幕,每次只发送一个动作(文本、Enter、方向键、Escape、Ctrl-C、resize),等待具体屏幕模式或提示后再进行下一步,保存记录与 profile 产物,最后干净地终止会话。
Harness 选项:仓库原生 harness 优先;tmux 用于管理会话、capture-pane、send-keys、attach/detach;tmux 不可用时用 Python/Node/Expect 写短 PTY 探针;Node 或 Bun inspector 做 CPU profile、堆快照和实时求值;需要演示时用仓库本地 demo 工具或 asciinema 兼容工具。资料给出了 tmux 最小示例(new-session、capture-pane、send-keys、kill-session)和 Node CLI 的 NODE_OPTIONS="--inspect=127.0.0.1:0" 用法,以及 PTY 脚本片段。
限制与注意事项:优先确定性等待而非 sleep,必须 sleep 时需说明原因;不要向受控会话发送凭据或破坏性命令;除仓库已有 harness 外,临时 harness 放在 /tmp;不要硬编码其他仓库的路径,应适配当前仓库脚本与运行时;结束后清理 tmux 会话、临时目录、inspector 进程和演示产物。价格、平台和具体分发方式暂未提供。