dbtool-cli-v1/plans/20260327-201350-cmp48-state-recovery-keyboard-signoff.md

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 收口保持一致