TUI 使用 gitsave tui 启动。进入前请确保目标目录已执行 gitsave init。
- 顶部标题栏：显示当前保存路径、所在路线、刷新间隔（Autosave 状态为占位）。执行耗时操作时会显示旋转指示，并切换终端光标形状提示繁忙状态。
- 左侧 Routes 面板（约 40% 宽度）：列出所有路线，
*表示当前路线。Autosave 卡片仅为占位信息，自动保存暂不实现。 - 右侧 History 面板（约 60% 宽度）：上半部分列出当前路线存档；当在 Routes 中浏览其他路线时，仅预览该路线最新提交，不显示选中光标，回滚操作会被锁定。下半部分 Status 卡片展示当前提交、选中提交及工作区脏文件详情。
- 底部 Notifications：滚动显示最近 4 条系统消息/错误。
- 中央弹窗：用于确认与输入（创建路线、切换路线、回滚存档、保存描述等）。
- Recovery 模式弹窗：按
R进入，列出“丢弃快照”恢复列表，选择后输入新路线名并切换。
| 按键 | 说明 |
|---|---|
q |
退出 TUI |
r |
手动刷新（同步 CLI 侧变更） |
Tab |
Routes 与 History 之间切换焦点（选择非当前路线时会锁定） |
↑/↓ 或 j/k |
移动当前焦点的光标 |
PgUp/PgDn |
History 中快速翻页 |
Enter |
Routes 中切换路线 / History 中回滚选中存档（仅当前路线可回滚；需确认并输入新路线名；脏工作区提示保存/丢弃/取消） |
s |
稳定保存（执行存档稳定性检测；会提示输入描述） |
S |
强制保存（跳过稳定性检测；会提示输入描述） |
m |
修改最新存档描述（仅 HEAD；工作区需干净） |
l |
回滚选中存档（仅当前路线可回滚；需输入新路线名；脏工作区提示保存/丢弃/取消） |
L |
强制回滚（仅当前路线可回滚；需输入新路线名；确认后丢弃更改） |
c |
创建新路线（脏工作区提示保存/丢弃/取消） |
C |
创建并切换路线（脏工作区提示保存/丢弃/取消） |
n |
重命名选中路线 |
x |
切换路线（脏工作区提示保存/丢弃/取消） |
X |
强制切换路线（确认后丢弃更改） |
R |
进入恢复模式（仅显示“丢弃快照”列表） |
d |
丢弃当前未保存更改（硬重置 + 清理未跟踪文件，需确认，并创建恢复快照） |
- 切换路线/回滚前若存在未保存更改，会提示“保存/丢弃/取消”，请谨慎选择。
- 回滚会在目标存档上创建并切换到新路线，原路线历史不受影响。
- 在 Routes 中浏览非当前路线时，History 仅显示该路线最新提交且不显示选中光标，Status 会提示“非当前路线”；Tab 与回滚操作会被锁定。
- 脏工作区默认弹出“保存/丢弃/取消”确认，避免误丢最新存档。
- 工作区干净时按
s不会创建新提交，会提示无需保存。 - 大型存档在保存/回滚时可能有短暂停顿，请等待繁忙指示结束。
- 如果需要高性能终端体验，建议使用 Windows Terminal。
- 常见场景：若游戏失败导致坏结局/存档被破坏，可在 History 中选择上一条可用存档并按
Enter回滚，输入新路线名后继续。确认提示会说明“未保存更改将被丢弃”。这是推荐的快速恢复方式。 - 若误丢存档，可按
R进入恢复模式，从“丢弃快照”中恢复并重命名路线。