mirror of https://github.com/LHY0125/PathEditor.git synced 2026-05-10 02:09:46 +08:00

Files

T

Serendipity 06e4c15b5c docs: 添加撤销/重做 UI 集成设计文档

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-01 22:39:39 +08:00

2.1 KiB

Raw Blame History

撤销/重做 UI 集成 — 设计文档

背景

撤销/重做后端（src/core/undo_redo.c）已完整实现，支持 7 种操作类型的记录与回滚。所有 UI 操作（新建/编辑/删除/上移/下移/清理）均已调用 push_undo_record() 写入历史。但 undo() 和 redo() 函数未被任何 UI 代码调用——用户无法触发撤销或重做。

目标

在界面上添加撤销/重做按钮，并绑定 Ctrl+Z / Ctrl+Y 快捷键，让用户可以回退和恢复操作。

改动文件

文件	改动内容
`include/utils/ui_constants.h`	新增 `CTRL_BTN_UNDO`、`CTRL_BTN_REDO` 常量
`src/ui/main_window.c`	创建撤销/重做按钮，绑定回调，调整布局
`src/controller/callbacks_nav.c`	新增 `btn_undo_cb`、`btn_redo_cb`，`list_k_any_cb` 增加 Ctrl+Z/Y 检测
`lua/config.lua`	新增 `button.undo`、`button.redo` 配置项
`locale/` 翻译文件	同步新增按钮的中英文翻译

核心逻辑

btn_undo_cb(dlg):
    ctx = get_app_context_from_dlg(dlg)
    if !can_undo(ctx->undo_redo_mgr): return
    undo(ctx->undo_redo_mgr, &ctx->sys_paths, &ctx->user_paths)
    sync both lists to UI
    update undo/redo button enabled state

btn_redo_cb(dlg):
    同上，调用 redo()

list_k_any_cb:
    新增分支:
      if c == K_cZ → btn_undo_cb
      if c == K_cY → btn_redo_cb

按钮布局

撤销/重做按钮放在上移/下移按钮下方：

  [新建]      [编辑]
  [浏览]      [删除]
     (分隔)
  [一键清理]
     (分隔)
  [导入]      [导出]
  [上移]      [下移]
  [撤销]      [重做]    ← 新增

按钮状态

can_undo() == false → 撤销按钮 ACTIVE=NO
can_redo() == false → 重做按钮 ACTIVE=NO
每次 undo/redo 执行后刷新按钮状态

不做的事

不修改 undo_redo.c 后端代码（已完备）
不添加操作历史面板（保持简洁，通过按钮状态反馈即可）
不在保存后清空历史（当前设计由 clear_undo_redo_history 决定，保持现有行为）

2.1 KiB Raw Blame History Unescape Escape