feat(usable): integrate current dbtool implementation 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-04-02 08:26:18 +00:00
parent a28dab4cd9
commit d5f69462b0
73 changed files with 5895 additions and 322 deletions

View File

@@ -0,0 +1,38 @@
# CMP-48 State Recovery & Keyboard Signoff
- 日期2026-03-27
- 负责人Senior Frontend Engineer
## Goal
收口 `dbtool-tui` 在 usable-v1 下的状态恢复与键盘一致性签收文档,确保 QA 按当前实现而不是旧表述复核。
## Assessment
- `CMP-48` 当前最直接的前端动作不是扩功能,而是把签收口径和现有实现对齐。
- 现有文档仍缺一组显式的恢复/一致性规则,且 `TUI_REGRESSION_CHECKLIST.md` 仍残留 `l` / `e` 这类与当前实现不符的旧快捷键表述。
- `apps/tui/src/main.rs` 当前已把恢复语义收口为 `Esc``r`、按焦点解释的 `Enter`,以及仅在特定焦点下生效的 `[` / `]`
## Scope
1.`apps/tui/README.md` 增加状态恢复与键位一致性说明
2.`TUI_ACCEPTANCE_CHECKLIST.md` 增加 usable-v1 签收关注点和恢复/键盘项
3.`TUI_REGRESSION_CHECKLIST.md` 去除旧快捷键并改成与源码一致的回归步骤
4.`TUI_TEST_STRATEGY.md` 明确恢复路径与键位一致性也是测试层的一部分
## Out of Scope
- 改动 TUI Rust 实现
- 新增 network live 能力
- 扩张到 GUI 或新功能
## Validation
- `git diff --stat -- apps/tui/README.md TUI_ACCEPTANCE_CHECKLIST.md TUI_REGRESSION_CHECKLIST.md TUI_TEST_STRATEGY.md`
- `grep -n "状态恢复与键位一致性\|usable-v1 签收关注点\|usable-v1 状态恢复与键盘一致性\|当前键位一致性说明" apps/tui/README.md TUI_ACCEPTANCE_CHECKLIST.md TUI_REGRESSION_CHECKLIST.md TUI_TEST_STRATEGY.md`
## Result
- QA 文档不再声明当前实现中不存在的 `l` / `e` 快捷键
- `Esc``r``Enter``[` / `]` 的语义被固定为可复核的签收规则
- `CMP-48` 当前文档收口与 `CMP-51` 的 evidence-boundary 收口保持一致