SuperAPI AI 工具集

cursor-control-cli

通用与其它

查看项目

更新于 10-16 08:48

技能介绍

用途:用可重复的本地脚手架代替手动反复操作,来测试交互式命令行(CLI)或终端界面(TUI)程序,无需外部服务。覆盖复现 CLI/TUI 缺陷、验证键盘流程与提示、中断、窗口缩放和终端布局、捕获修复前后终端记录、剖析启动时间与慢操作、挂起与内存增长,以及录制简短终端演示。

主要能力:优先复用仓库自带的测试或演示脚手架(package scripts、e2e 测试、demo 录制器、expect 脚本、PTY 辅助)。若没有,则用本地标准工具临时搭建。可选方案包括 tmux(受管会话、capture-pane、send-keys、attach/detach)、PTY 探针(短 Python、Node 或 Expect 脚本)、运行时检查器(Node 或 Bun inspector 做 CPU 剖析、堆快照与实时求值),以及终端录制器(仓库本地演示工具或 asciinema 兼容工具)。

使用方式:循环流程为先确认被测命令与最小可复现工作区,发现现有脚手架,若无则以确定性环境变量在隔离终端会话中启动 CLI,捕获交互前屏幕,一次发送一个动作(文本、Enter、方向键、Escape、Ctrl-C、缩放),等待出现具体屏幕模式或提示后再发送下个动作,保存记录与剖析产物,最后干净地结束会话。最小 tmux 脚手架:SESSION="cli-harness-$(date +%s)";tmux new-session -d -s "$SESSION" -- <command-under-test>;tmux capture-pane -pt "$SESSION";tmux send-keys -t "$SESSION" "help" Enter;tmux capture-pane -pt "$SESSION";tmux kill-session -t "$SESSION"。Node CLI 可加 NODE_OPTIONS="--inspect=127.0.0.1:0"。PTY 方案可用 Python 的 pty、select、subprocess 等模块按需编写临时脚本。剖析配方涵盖启动回归对比、慢操作 CPU 采样、内存泄漏取堆快照前后对比、挂起时先取屏幕与栈样本再中断。

适用场景与限制:适合本地 CLI/TUI 的调试、回归、性能与演示工作。限制与护栏:优先确定性等待而非 sleep,若必须 sleep 需说明理由;不要向受控会话发送凭据或破坏性命令;脚手架应放在 /tmp,除非仓库已有测试/演示脚手架;不要硬编码来自其他仓库的路径,应适配当前仓库的脚本与运行时;除非用户要求保留,否则清理 tmux 会话、临时目录、inspector 进程和演示产物。文档未提供具体平台、收费与价格信息。