返回日报条目

资料节译

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

阅读原文

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

预约没了。那条消息进了陌生人的收件箱。这两种状态,我都无法恢复。对于别人已经读过的消息,没有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项测试能让演示系统变成可实际运行的系统。我用过的大多数撤销按钮都只测试了顺利执行的情况,因此那些有意思的状态——撤销了一半、补偿失败、依赖项成为孤儿——恰恰是从来没人见过的状态。

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

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

六项指标,成本都很低:

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

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

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

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