---
title: "为助手的现实操作设计可撤销机制"
canonical: "https://siyuanailab.com/curation/translations/ec96dfa8b3b12ffdd074fbd673d90ff2-836ee2e98e2fb099d3abbd66b4da5d9f0281ba309b048274f3d91cfe3f47a78a/"
dateModified: "2026-11-16"
datePublished: "2026-11-16"
---

[返回日报条目](https://siyuanailab.com/curation/#entry/ec96dfa8b3b12ffdd074fbd673d90ff2)

 

资料节译

 

# 为助手的现实操作设计可撤销机制

 

[阅读原文](https://dev.to/maptosite/ship-it-reversible-designing-the-undo-layer-an-agents-irreversible-actions-need-1mak)

 

现有资料无法确认原文完整，本页只翻译已取得的材料。

 

现有原件无法确认图片是否齐全。

 

操作助手时最糟糕的那一分钟，不是它产生了幻觉，而是它欢快地确认：“完成了——我取消了预约，还给店家发了条说明原因的消息。”

 

预约没了。那条消息进了陌生人的收件箱。这两种状态，我都无法恢复。对于别人已经读过的消息，没有`ctrl+z`；对于店家已经重新把时段租出去的预约，也没有一种“取消”能把时段还回来。

 

我开发的助手会在现实世界里替人跑腿：填表、结账、预约、取消、发邮件。我每次独自做设计评审，最后都会回到同一个问题。真正有意思的问题不是*代理能不能做到*，而是*撤销它要付出什么代价*，以及谁会知道这件事。

 

我们谈论“安全操作”，仿佛安全性存在于 API 调用之中。事实并非如此。同一个`delete`，用于草稿时无关紧要，用于税务文件的唯一副本时却是灾难。决定操作属于哪一类的有四个因素，只有一个在代码里：

 

-

 

**之前的状态是否在某处留有记录？**没有快照的写入就是不可逆的，即使端点只是普通的`PUT` 。 2. **是否有人能看到它？**发件箱里的消息可以编辑；陌生人收件箱里的同一条消息则不行。不可逆通常始于*被看到*，而不是发送。 3. **现在是否有另一方承担了某种承诺？**占了一张桌、授权了一笔扣款、订下了一个时段——店家的日历已经变了。发生变化的不只有你的记录。 4. **是否存在一个本身也能安全执行的逆操作？**退款是扣款的逆操作。“请忽略我上一条消息”并不是已发送邮件的逆操作；它只是又一条更糟的消息。

 

现在，我会在每种效果运行前给它标上四类之一：

 

| 类别 | 含义 | 示例 | 撤销成本 |
| --- | --- | --- | --- |
| **R** | 可原地恢复 | 写入字段并保存旧值 | 毫秒级 |
| **C** | 可补偿 | 扣款、转账、取消 | 产生新效果，且他人可见 |
| **D** | 延迟执行 | 排队发送、定时发布 | 计时器触发前免费 |
| **X** | 一经他人看到便不可逆 | 已发送邮件、已拨出的电话、已发布的帖子 | 无；只能补救信息披露 |

 

这套分类只需十分钟，却会改变架构。代理不再把“完成”当成一个笼统的状态。

 

可逆性不是等着你去发现的东西，而是要靠设计创造出来的。这里有五个调节手段，我会按这个顺序考虑。

 

**1. 延迟。**把效果放进队列并开始倒计时，而不是立即执行。四十秒足以让用户读完确认内容并叫停，而且成本很低，系统中的其他部分甚至不会察觉。只有倒计时清晰可见，而且用户在第39秒仍能撤回项目时，延迟才算诚实。

 

**2. 快照。**进行任何破坏性写入之前，读取当前值并将其与效果记录一同保存——保存的不是新值，而是*旧值*。`prior_state`是一个字段，却能让大多数 R 类错误变得无关紧要；偏偏人人都会忘记它，因为顺利执行的路径从来不会读取它。

 

**3. 暂存。**把操作拆成两个状态：一个没人介意，另一个人人都在意。草稿放在实际发送所用的同一个邮箱中；预览 URL 渲染出的页面要与正式页面完全一致；`status='staged'`行由人工或第二次检查来批准发布。两阶段发布多出一个状态和一次写入，却能把“我发错了内容”变成“我暂存错了内容”。

 

**4. 移入废纸篓，而不是删除。**删除操作会设置`deleted_at`并隐藏该行；夜间任务会在三十天后将其移除。墓碑记录也能正确回答“这条记录曾经存在吗？”——后续步骤需要证明自己操作的是正确记录时，这一点比人们想象的更重要。

 

**5. 补偿。**上述方法都不适用时，就明确规定逆操作，并把它当作一项一等效果：有自己的记录、审批和故障模式。退款不等于没有发生过扣款。

 

大多数真实的跑腿任务需要同时用到其中两三种方法：扣款前保存余额快照，扣款前先等待一段时间，并且在允许扣款之前就定义好退款路径。

 

“撤销”按钮只是某条记录的视图。记录内容太少，按钮就会撒谎。最少要记录这些：

 

```
effect = {
  "effect_id":   "eff_...",          # the thing that happened
  "action":      "cancel_booking",
  "target":      "studio-4821/2026-11-20 14:00",
  "class":       "C",
  "prior_state": {"status": "confirmed", "slot": "2026-11-20 14:00"},
  "inverse":     {"op": "rebook", "params": {"slot": "...", "same_staff": True}},
  "window_until": "2026-11-15T08:40:00Z",   # null when X-class
  "observed_by": [],                        # who could have seen it
  "status":      "applied",                 # applied | undone | expired | superseded
  "supersedes":  None,
}
```

 

其中三个字段真正起到了关键作用。`window_until`让撤销承诺有明确期限，因此可以核查。`observed_by`记录效果不再是私密信息的时刻——这是逆操作含义开始改变的最早时间点。`supersedes`则是一道防线：如果目标状态已经发生变化才执行撤销，那就不是撤销，而是一个新决定。

 

没有`status`，撤销失败看起来就和撤销成功一模一样，下一次尝试只能靠猜。

 

这个发现改变了我设置延迟的方式。技术上的发送是一次写入；人真正经历的事件是*收到*。这两者之间存在一段长度不定的间隔，我可以利用它。

 

实用规则：**等待窗口必须在任何第二方有可能看到效果之前结束。**邮件离开发件服务商后，可能几秒内就会被看到。预约则是在店家日历把时段重新租出去的那一刻。公开帖子是在第一次被爬取或被阅读时。电话则从说出第一个字开始——所以我默认把外拨电话归为 X 类，并要求由人亲自拨出。

 

有两条经验教训，是我犯过错之后才学会的：

 

-

 

## **不可逆不以回执为前提。**你不需要知道消息已被阅读，只要知道它*可能*被阅读即可；消息一到达，就具备这种可能。

 

**如果草稿会被自动转为正式内容，它就不安全。**有一次，我把消息写到邮件服务商一侧的发件箱里，以为这样就是“暂存”了；我忘了还有个定时任务会在09:00发送所有邮件。暂存必须放在流程边界的这一侧，确保没有任何东西能在未经你允许的情况下将它转为正式内容。

 

确认对话框是成本最低的可逆性措施，也是最弱的：它把成本转嫁给用户的注意力，每项操作都如此，而且永无止境。通过降低操作的影响来消除风险，才是结构性的解决办法。我大致会用下面这张表：

 

| 原始操作 | 可逆的做法 | 保住了什么 |
| --- | --- | --- |
| 发送邮件 | 保存为草稿；只有明确发送后才投递 | 收件人看不到错误内容 |
| 预订 / 确认 | 暂时保留时段，窗口结束后再付款并确认 | 避免时段被重复占用 |
| 发布页面 | 暂存并安排发布时间，同时测试取消发布 | 公开 URL 不会显示错误版本 |
| 删除记录 | 移入废纸篓，保留墓碑记录并留存30天 | 可恢复性和审计记录 |
| 转账 | 先冻结资金，再结算；每个步骤各留一条账目 | 结算前可撤回 |
| 取消订阅 | 安排在计费周期结束时取消 | 避免意外失去使用权限 |
| 拨打电话 | 准备通话提纲，由人拨出 | 没有人会被代理代为联系 |
| 提交表单 | 网站支持时先保存草稿；否则逐项读回所有字段再提交 | 在产生效果前发现错误的值 |

 

注意最后一行。网站没有草稿功能时，可逆的替代办法是*读回核对*：提取即将提交的内容，与原本打算提交的内容逐项比较，然后才按下按钮。这不是撤销，但能在错误字段变成 X 类效果之前，拦下大多数此类错误。

 

我见过最自信的错误，大多发生在这里。逆操作本身是一种会带来后果的新效果：

 

- 一个**退款**不会抹掉扣款；它会增加一条用户看得到的新记录，而且有些支付处理商会因此收费。
 
- 一封**道歉邮件**无法撤回第一封邮件。它会让收件箱里的邮件翻倍，通常还会让错误更令人难忘。
 
- 取消后**重新预订**，可能会订到不同时间段，也可能换成不同的服务人员；这与原先的承诺并不相同。
 
-

 

**取消页面发布**无法让搜索引擎取消索引、让人停止分享链接，也无法让已经截屏的人忘掉内容。

 

因此，补偿要遵循与其他 C 类操作相同的关卡要求：明确说明条款，设置时间窗口；凡是陌生人会读到的内容，都要先拟好文本，再由人发布。自动道歉会把一次小失误变成公开事件。

 

逆操作也是一次工具调用，因此会遇到所有工具调用问题：结果未知、重试、重复执行。三项测试几乎能发现所有问题。

 

**执行两次。**撤销必须针对自己的记录实现幂等。`status`会将`applied → undone`只推进一次；第二次调用读取`undone`并返回它，而不是再次执行逆操作。否则，撤销超时后重试，就会重新预订那个已被第一次撤销释放的时段。

 

**过晚。**超过`window_until`后，应拒绝执行逆操作并报告拒绝，而不是悄悄降级处理。无法兑现的承诺比从未许下的承诺更糟；用户正在根据你显示的那句话安排事情。

 

**外部状态已变化。**将目标当前状态与`prior_state`进行比较。如果逆操作所依赖的字段发生了变化——记录被编辑、时段被重新租出、对方已经回复——那么这次撤销就已被*取代*，正确的输出应该是提问，而不是采取行动。这是防止过时后台任务写入的同一道防线，如今用在了逆向操作上。

 

我也会测试*依赖关系*这一情况，这是冲击最大的一种：效果 A 已撤销，但效果 B 是从 A 派生出来的。比如，从已取消预约派生出的日历邀请，或从已退款扣款派生出的收据。我最终确定的规则是：派生效果要带上其原因效果的 ID；撤销原因效果时，应将其依赖项标记为`orphaned`以供检查，而不是删除它们。孤儿清单是一队待处理的问题；悄无声息地级联删除则会引发第二起事故。

 

最值得的几项测试，都是在临时账号上运行的：

 

-

 

**往返测试。**先`apply`，再`undo`，返回的状态摘要应等于`apply`之前记录的摘要。任何不同的字段，要么是逆操作漏掉了某个字段，要么是那个字段确实不该恢复——我想弄清楚是哪一种。 2. **中途强制终止。**在效果写入和逆操作登记之间执行 SIGKILL；重启后确认系统仍能找到该效果并提供撤销选项。如果登记与写入处于同一个事务中，这项测试自然会通过。 3. **撤销两次。**第二次调用返回已记录的结果；目标状态保持不变。 4. **编辑后撤销。**修改目标，然后撤销；预期结果是`superseded`，并列出已变化的字段。 5. **窗口到期。**让时钟超过`window_until`；预期系统拒绝操作并说明期限已过，而不是只给出笼统的失败提示。 6. **观察状态。**强制让`observed_by`变成非空；预期系统拒绝“静默撤销”路径，转而采用包含信息披露的补救路径。 7. **补偿失败。**让逆操作失败（余额不足、时段已被占用）；确认该效果仍处于`applied`，并带有`compensation_failed`，且无需有人手动查询数据库就能看到这种状态。

 

第7项测试能让演示系统变成可实际运行的系统。我用过的大多数撤销按钮都只测试了顺利执行的情况，因此那些有意思的状态——撤销了一半、补偿失败、依赖项成为孤儿——恰恰是从来没人见过的状态。

 

可逆性是在界面上作出的承诺，所以用户作出决定前就必须能看明白：

 

- 操作的类别，用文字说明：*“此操作可在40秒内撤销”*、*“此操作无法撤销”*。
 
- 撤销后仍会留下什么：一条退款记录、一个墓碑记录、一个被重新租出的时段。
 
- 窗口关闭的确切时间，而不是含糊的“很快”。
 
- 窗口关闭后代理做了什么（如果做了什么的话）。

 

而且，代理应该能说出那句令人不安的话：*“我已经完成了无法撤销的部分；这是我仍然能做的事。”*这句话比任何成功提示都更有用，而且只有记录如实说明了`observed_by`，代理才能说出这句话。

 

六项指标，成本都很低：

 

- 每天各类别效果的数量（我们发出的 X 类操作是否超过了监控能力？）
 
- 各类别的撤销率（X 类操作的撤销率上升，说明分类有误，不是用户犯错）
 
- 到期后未经检查的窗口数量（如果没人读确认内容，延迟就只是装饰）
 
- 每周补偿失败次数
 
- 等待检查的孤儿依赖项
 
- 从效果产生到撤销的中位时间和第95百分位数

 

如果 X 类操作的撤销率高于零，就该从上游修正：降低操作等级，让它不再属于 X 类。撤销机制是用来处理残余情况的，不能用来让不可逆操作变得可以接受。

 

- 编写工具前先将每种效果分类为 R / C / D / X，并把类别存进效果记录。
 
- 每次破坏性写入都保存`prior_state`，包括那些看似无关紧要的写入。
 
- 优先降低操作影响，而不是增加确认对话框。
 
- 让延迟清晰可见、有明确期限，并一直可撤回到最后一秒。
 
- 所有陌生人会读到的内容都先暂存，并放在没有调度程序能将其转为正式内容的流程边界一侧。
 
- 允许操作前先定义逆操作；把补偿视为独立的 C 类效果。
 
- 使用`status`、`window_until`以及与`prior_state`的状态比较，为逆操作设立防线。
 
- 撤销时将依赖项标记为`orphaned`，而不是级联处理。
 
- 测试往返、中途强制终止、重复撤销、编辑后撤销、期限到期、已被观察以及补偿失败。
 
- 在用户决定之前，就在界面上说明类别和时间窗口。

 

这些做法不会让代理值得信任。它们会让代理犯错的代价预先明确——也意味着，代理绝不可能悄悄执行那个没人能撤回的操作。

 

如果你想了解这些机制在手机端的对应做法——每日使用限额有什么作用、重置凭证能恢复什么，以及消费级助手的不可逆边界在哪里——我写过两篇公开说明：

 

- 英文指南：[https://pickle-invite-code-en.deed.page/](https://pickle-invite-code-en.deed.page/) — 介绍应用在每日限额、凌晨4点重置和重置凭证方面的行为。
 
- 邀请链接：[https://pickle.com/i/RDKXK77G9ZRT](https://pickle.com/i/RDKXK77G9ZRT)

 

*披露：*我使用 Pickle，一款手机端 AI 助手应用，但我不是该应用的供应商。上面的两个链接由我提供；如果有人通过邀请链接完成注册，双方都会收到重置凭证，任何优惠均以应用自身的通知为准。这不是付费推广。本文所述的可逆性模型，是我在自己的跑腿代理中采用的模型，内容源于我在真实账号上犯过的错误。

 

AI 翻译；具体表述请与原文对照。
