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