TUI 交互说明

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`	丢弃当前未保存更改（硬重置 + 清理未跟踪文件，需确认，并创建恢复快照）

对于快速回退到上一个存档点，请按d使用discard即可。
对于即将存在分支的游戏情况，可以按c创建分支，进入新分支后再进行游戏操作。
切换路线/回滚前若存在未保存更改，会提示"保存/丢弃/取消"，请谨慎选择。
回滚会在目标存档上创建并切换到新路线，原路线历史不受影响。
在 Routes 中浏览非当前路线时，History 仅显示该路线最新提交且不显示选中光标，Status 会提示"非当前路线"；Tab 与回滚操作会被锁定。
脏工作区默认弹出"保存/丢弃/取消"确认，避免误丢最新存档。
工作区干净时按 s 不会创建新提交，会提示无需保存。
大型存档在保存/回滚时可能有短暂停顿，请等待繁忙指示结束。
如果需要高性能终端体验，建议使用 Windows Terminal。
常见场景：若游戏失败导致坏结局/存档被破坏，可在 History 中选择上一条可用存档并按 Enter 回滚，输入新路线名后继续。确认提示会说明"未保存更改将被丢弃"。这是推荐的快速恢复方式。
若误丢存档，可按 R 进入恢复模式，从"丢弃快照"中恢复并重命名路线。