企业官网建设流程全解析

Palmier Pro撤销系统深度解析：EditorUndo如何让AI Agent一键撤销编辑历史

【免费下载链接】palmier-promacOS video editor built for AI项目地址: https://gitcode.com/GitHub_Trending/pa/palmier-pro

Palmier Pro 是一款专为 AI 打造的 macOS 视频编辑器，其撤销系统（Undo System）是它最精妙的工程设计之一。传统视频编辑器里，撤销只服务于人类用户；而 Palmier Pro 的 AI Agent 也能直接调用编辑工具改时间线，这就带来一个难题：人和 AI 的编辑如何共享同一条撤销历史？答案是 EditorUndo.swift —— 一个不到 80 行的轻量封装，却统一了人类与 Agent 的编辑历史，让 Cmd+Z 和 AI 工具调用共用同一条时间线。

为什么AI视频编辑器需要特殊的撤销系统

在 Palmier Pro 中，编辑操作来自两类"作者"：

• 🖱️人类用户：拖动剪辑、裁剪片段、调整音量，通过 macOS 原生的 Cmd+Z / Cmd+Shift+Z 撤销重做
• 🤖AI Agent：通过 MCP 工具（如split_clips、ripple_delete_ranges、set_clip_properties）直接修改时间线

如果两者各记各的账本，用户就无法"一键撤销 AI 刚才做的那一刀"。Palmier Pro 的解法是：只有一条 UndoManager 历史栈，人和 Agent 都往里写。

EditorUndo 内部机制：三个核心能力

EditorUndo.swift 对 AppKit 的UndoManager做了三层封装，每个方法都直击一个具体痛点：

1. perform：把一次操作打包成"一个"撤销步骤

一次"移动剪辑"在底层可能是位置、时间码、关联轨道的多处修改。perform方法（EditorUndo.swift）用一个事务包裹整个动作块，配合beginUndoGrouping把零散的变更注册合并为一个可撤销的原子操作——用户按一次 Cmd+Z，整组改动一起回退。

它还处理了一个隐蔽的坑：Foundation 默认按"事件"自动分组，会和外层事务互相干扰。代码在第 22 行临时关闭groupsByEvent，结束后恢复，并用assert校验分组层级归零，杜绝历史栈泄漏。

2. register：智能延迟注册，并发修改互不干扰

register方法（第 41-56 行）是"惰性开启分组"的关键：只有真正产生第一条注册时，才打开事务分组。这保证了多个 Agent 工具并发执行时，每个工具的修改仍是独立的撤销步骤——测试用例concurrentAgentEditsRemainSeparateUndoSteps就专门验证了这一点。

3. withTimelineSwap：整条时间线的双向快照交换

视频时间线是复杂的树状结构（轨道→剪辑→关键帧→词级时间戳）。逐字段回滚容易遗漏，Palmier Pro 采用了更简单粗暴但极可靠的策略：

• 修改前拍一张快照（before）
• 修改在withoutRegistration屏蔽下执行（内部细节不进历史栈）
• 修改后再拍一张快照（after）
• 只注册一次"before ↔ after 互换"的撤销动作

实现见 EditorViewModel+ClipMutations.swift 中的registerTimelineSwap与withTimelineSwap。撤销时交换成旧快照，重做时再换回来——双向都只存一次，内存友好。

人与Agent共享同一条历史栈

这是整个设计最精彩的部分。EditorViewModel持有唯一的EditorUndo实例（EditorViewModel.swift），人类操作和 Agent 工具共用它：

Agent 侧通过undo工具调用EditorUndo.undoLatest()（ToolExecutor.swift），执行后返回"Undid the latest action."——注意回执刻意不暴露本地化的动作名，避免 MCP 客户端因语言差异解析失败（测试MCPReceiptDoesNotExposeLocalizedUndoName专门守护了这条契约）。

更妙的是，每次事务提交都会触发onActionCommitted回调（EditorViewModel.swift）上报编辑遥测——人的一次 Cmd+Z 和 AI 的一次工具调用，在埋点层面也是同等待遇。

测试如何证明"统一"是真的

UndoToolTests.swift 用 8 个用例把这套契约钉死了：

• ✅undoRevertsOnlyTheMostRecentToolCall：撤销只回退最近一次工具调用，早前的剪辑切分安然无恙
• ✅nativeUndoConsumesAgentTransaction：用户在界面按 Cmd+Z，直接消费掉 Agent 的修改——人撤销 AI，零摩擦
• ✅undoRevertsLatestUserEdit：反过来，Agent 调用undo撤销用户手动做的修剪
• ✅undoUsesSharedHistoryAcrossExecutors：两个独立的 Agent 执行器之间历史也互通
• ✅reportsNothingToUndoAfterRead：只读操作（如get_timeline）不产生撤销步骤

总结：一个80行文件的架构启示

Palmier Pro 的撤销系统给"AI + 传统 GUI"混合交互的产品提供了一个范本：

1. 单一历史栈：不为 AI 单独建账本，人和 Agent 天然互撤
2. 原子事务：一次工具调用 = 一个撤销步骤，心智模型与人类操作一致
3. 快照交换：复杂数据结构用双向快照代替逐字段回滚，正确性优先
4. 契约测试：跨主体撤销行为全部有自动化用例守护

想要完整了解 Palmier Pro 的 AI 编辑能力，可以查看 README.md，Agent 工具的实现代码集中在 Agent/Tools/ 目录，撤销相关的单元测试在 UndoToolTests.swift。对于任何想让 AI"放心动手、随时反悔"的编辑器来说，这都值得借鉴。

【免费下载链接】palmier-promacOS video editor built for AI项目地址: https://gitcode.com/GitHub_Trending/pa/palmier-pro