SuperAPI AI 工具集

tui-console

测试与质量

查看项目

更新于 10-15 20:31

技能介绍

用途:TUI Console 让任意 dagger 命令把其实时 TUI 通过 HTTP 暴露在无头终端上,而不是附加到真实终端。可用 curl 代替键盘操作真实前端,看到的内容与用户在 tty 上看到的一致,适合手动浏览 TUI 渲染、复现渲染缺陷、展开检查或测试查看详情、逐步导航,且无需 pty。与 tui-qa 互补:后者录制真实 pty 会话用于时序与重绘分析,本工具用于交互式驱动实时界面。

启用:在任意 dagger 命令前加 DAGGER_TUI_CONSOLE=:<port>。以 dagger 源码为例,后台运行开发二进制并等待就绪: env DAGGER_TUI_CONSOLE=:7777 go run ./cmd/dagger call test & for i in $(seq 1 60); do curl -s -o /dev/null -w '%{http_code}' localhost:7777/help | grep -q 200 && break; sleep 2; done 已安装的 dagger 同理:DAGGER_TUI_CONSOLE=:7777 dagger …。

驱动:所有端点返回 text/plain,屏幕默认去除 ANSI(加 ?raw=1 保留颜色)。 curl -s localhost:7777/screen curl -s --data 'right' localhost:7777/key curl -s --data 'down down' localhost:7777/key curl -s --data 'TestFoo' localhost:7777/type curl -s 'localhost:7777/spans?q=TestFoo' curl -s --data '<spanHex>' localhost:7777/zoom curl -s --data '120x12' localhost:7777/resize curl -s localhost:7777/help 状态在请求间累积。屏幕按终端尺寸裁剪,可用 /resize 复现溢出渲染问题;任一维度可为 0 或省略以保持当前值。

按键:←↑↓→ / h j k l 移动,right/l 展开,left/h 折叠,enter 缩放,esc 返回,r 跳到错误来源,L 日志,+/- 调整详细度,/ 搜索,T 测试视图。down*3 表示重复;逗号或空格分隔。搜索:先 POST / 到 /key,再把查询 POST 到 /type(不切分,空格原样输入),最后 POST enter。

典型流程:用 /spans 的 ERROR(自身出错)和 FAIL(因链接导致失败)列定位失败,取首列 span id 后 zoom,再 right 展开查看日志。

限制:属开发调试功能,默认关闭,绑定所给地址(建议 localhost)。不改变命令本身要求,仅作展示层。dagger trace <id> 仍需 Cloud 访问(dagger login 或 DAGGER_CLOUD_URL)。屏幕默认 120x40,详细度由 +/- 控制。用毕停止后台命令,控制台随信号优雅退出。