feat(usable): package gui-host validation snapshot
Some checks failed
release-smoke / macos-13 / x86_64-apple-darwin (push) Has been cancelled
release-smoke / ubuntu-latest / x86_64-unknown-linux-gnu (push) Has been cancelled
release-smoke / windows-latest / x86_64-pc-windows-msvc (push) Has been cancelled

Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
Paperclip CTO
2026-03-31 10:21:36 +00:00
parent 19aeb7784b
commit a28dab4cd9
47 changed files with 6894 additions and 771 deletions

View File

@@ -11,7 +11,7 @@
## 1. Shell baseline 回归(当前 runner 可执行)
- [ ] `printf 'q' | script -qec 'stty rows 40 cols 120; ./target/debug/dbtool-tui' /tmp/tui-normal.log`
- [ ] `scripts/tui/smoke-tty.sh ./target/debug/dbtool-tui`
- [ ] 确认退出码为 `0`
- [ ] 确认日志包含 `Connections`
- [ ] 确认日志包含 `Schema Browser`
@@ -22,11 +22,11 @@
- [ ] 确认日志包含 `Ready`
- [ ] 确认日志包含 `Execution Idle`
- [ ] 确认日志包含静态连接 / schema / result 示例文本
- [ ] `printf 'q' | script -qec 'stty rows 20 cols 90; ./target/debug/dbtool-tui' /tmp/tui-small.log`
- [ ] `scripts/tui/smoke-tty.sh ./target/debug/dbtool-tui 20 90 /tmp/tui-small.log`
- [ ] 确认退出码为 `0`
- [ ] 确认日志包含 `Terminal Too Small`
- [ ] 确认日志包含 `Resize the terminal`
- [ ] 明确记录:`dbtool-tui --help` 不是有效的非交互 smoke
- [ ] 明确记录:`dbtool-tui --help` 不是有效的非交互 smoke;若已重建源码,应输出 TTY-required 提示
## 2. Shell 交互回归(静态 / 示例数据,不等于 live
@@ -39,12 +39,13 @@
- [ ] `Schema Browser` 焦点下 `Enter`ready schema 展开 / 折叠empty / restricted schema 给出明确反馈
- [ ] `Query Editor` 焦点下 `[` / `]`:切换静态 query 草稿
- [ ] `i`:进入插入模式并可录入字符 / 换行
- [ ] `Enter`触发静态 query 状态轮转或运行占位逻辑
- [ ] `Enter``Query Editor` 焦点下触发查询执行;插入模式下只插入换行
- [ ] 结果区可区分 success / empty / error
- [ ] `Results` 焦点下 `[` / `]`:宽表列分页
- [ ] `Results` 焦点下 `↑` / `↓`:结果行移动
- [ ] `l` / `e` / `r`:状态切换
- [ ] `Esc`:恢复默认工作台
- [ ] `r`:同时清空 query / export feedback并恢复 `Ready`
- [ ] 查询运行中按 `x` / `j`:界面提示等待当前查询完成
- [ ] `Esc`:导航模式下恢复默认工作台;插入模式下退出到 navigate mode
- [ ] `q`:稳定退出并释放 alternate screen
## 3. 第二阶段 live integration 回归(仅在 `[CMP-34](/CMP/issues/CMP-34)`、`[CMP-35](/CMP/issues/CMP-35)`、`[CMP-36](/CMP/issues/CMP-36)` 就绪后执行)
@@ -94,3 +95,8 @@
- [ ] live integration 回归:等待 `[CMP-34](/CMP/issues/CMP-34)``[CMP-35](/CMP/issues/CMP-35)``[CMP-36](/CMP/issues/CMP-36)`
- [ ] CI smoke仓库尚未覆盖 `dbtool-tui`
- [ ] release artifact smoke仓库尚未为 `dbtool-tui` 建立产物路径
## 当前键位一致性说明
- 当前实现不存在 `l` / `e` 的状态切换快捷键;若历史记录出现该表述,应视为旧文档残留而不是当前行为。
- 当前恢复语义固定为:`Esc` 回稳定态、`r` 清反馈、`Enter` 依焦点执行、插入模式下 `Enter` 不执行查询。