以下人物、公司与数字均为教学假设,不构成对任何真实产品的评价。
打断和纠偏处理的是「还没发生」和「正在发生」,撤销处理的是「已经发生」。这三个词在产品界面上经常被塞进同一个按钮,实际含义完全不同。撤销不是让时间倒流,而是一组明确的承诺:能撤什么、撤到哪、多长时间内可撤、撤不了怎么办。
只回答前两个问题,撤销会在事故里失效;四个都回答,产品才敢把动作交给机器执行。这一节把撤销拆成三要素,再用 C Runner 的改价与发通知说明:不可撤销的动作,必须在发生之前拦截。
撤销的三要素
| 要素 | 回答的问题 | 缺失后的后果 |
|---|---|---|
| 范围 | 撤销对象是什么:建议、版本还是动作 | 用户不知道撤销会影响到哪一层 |
| 时间窗 | 从什么时候到什么时候可以撤 | 用户以为能撤,实际已经过期 |
| 补偿动作 | 撤不了时用什么弥补 | 不可撤动作发生后没有任何后手 |
范围决定撤销的粒度。建议没有落库,撤销就是不采纳;版本可以回退到上一版;动作需要反向执行,或者用补偿动作抵消影响。三者不是能力高低,而是对象不同。把建议的撤销做成「删除记录」,或把动作的撤销做成「隐藏界面」,都是范围错位。
时间窗决定承诺的边界。B 的报告在发布前可以无限次回退,发布后不能撤回;C 的动作在执行后 30 分钟内可以反向执行,超过 30 分钟或已经传播到客户侧,就只能补偿。时间窗必须写在界面上,不能只写在内部文档里。
补偿动作决定最坏情况下的责任。撤销模型如果不写补偿,等于假设所有动作都能撤回。C 的事实表直接打破这个假设:错误中 86% 可回滚,14% 不可回滚,不可回滚错误率是 1.7% × 14% = 0.238%。这 0.238% 就是补偿动作存在的理由。
三种撤销对象
建议的撤销是不采纳。 A Relay 的建议不落库,用户点「不采纳」或直接改队列,建议就失效了。它没有版本,也没有外部副作用,所以撤销时间窗是「无」——不是零秒,而是不需要窗口。给 A 设计「30 分钟内可撤销」没有意义,因为 30 分钟后这条建议本来就不存在了。
版本的撤销是回退。 B Quill 的产出是报告草稿,发布前可以回退到上一版,发布时间不限。发布后不能撤回已经发到客户手里的报告,只能补发更正说明。这里的边界不是时间,而是「是否已经离开系统」:文件还在编辑器里,回退是内部操作;文件已经进入客户渠道,回退就变成了对外沟通。
动作的撤销是反向执行。 C Runner 改价、改库存、下架,都可以用相反的动作抵消:改回原价、恢复库存、重新上架。反向执行有前提:原值还在、下游还没消费这个变化、时间窗还没过。三个前提缺一个,反向执行就不再等价于撤销。
三种对象对应三种界面。建议的撤销是一个「不采纳」按钮;版本的撤销是版本历史;动作的撤销是带回滚句柄的审计日志。把它们统一成一个「撤销」按钮,用户无法判断按下之后到底发生了什么。
评审时可以用一句话检验:用户按下撤销后,能不能说出被撤销的对象、时间窗和影响范围。说不出来,说明撤销模型还没有设计完。
C Runner 的改价:什么时候还能撤
改价是 C 最典型的动作。它外部可见、直接影响成交,但在 30 分钟内通常可以改回原价。产品需要区分三种状态:
| 状态 | 判定 | 可用操作 |
|---|---|---|
| 已改价,未传播 | 30 分钟内,下游未读取新价格 | 反向执行,改回原价 |
| 已改价,已传播 | 客户已看到新价格,或超过 30 分钟 | 补偿:说明、恢复原价、必要时人工回访 |
| 准备改价,但没有回滚能力 | 系统没有原值快照或没有反向接口 | 执行前拦截,不允许自动改价 |
第三种状态最容易被忽略。很多团队在设计时假设「改错了再改回来」,却没有检查系统是否保存了原价、是否有反向接口、下游是否会缓存新价格。没有这些条件,改价在事实上就是不可撤销的,只是团队不知道。产品评审时应该直接问:这个动作的原值在哪里、反向接口是谁、30 分钟内下游会不会读到。
发通知比改价更严格。通知一旦发出,无法从客户那里收回。C 的 14% 不可回滚动作主要就是这类已发出的通知,所以它必须在发送前停,而不是发送后想办法。发通知前的拦截不是审批的同义词:它可以是自动检查收件人、检查内容、检查是否重复发送,只有检查不通过才转人工。
时间窗不能拍脑袋定,用三个问题校准:
- 下游多久会读到这个变化? 下游是分钟级缓存还是小时级同步,决定窗口的上限。
- 反向接口是否存在且幂等? 没有反向接口,时间窗再长也只是界面承诺。
- 超过窗口后谁来做补偿? 补偿责任人、补偿渠道和补偿话术要在上线前确定,而不是出事时再找。
三个问题答不上来,说明这个动作在当前系统里事实上不可撤销,应该按不可撤动作处理:执行前拦截,而不是执行后承诺。
补偿不是撤销
补偿动作经常被写成「一键回滚」的兜底,但它和撤销有本质区别:撤销让动作像没发生过,补偿是承认动作已经发生,再用另一个动作降低影响。
B 的补偿是补发更正说明。报告已经发给客户,错误已经进入客户的决策材料,补发说明不能删除客户已经读到的内容,只能修正记录。C 的补偿是补发说明加人工回访,因为价格或库存变化可能已经影响客户下单。补偿比撤销贵,而且补偿本身也需要被记录、被审阅。
这也是 C 的人工账里最容易被低估的一块。事实表给出的 4.04 分钟,是 0.96 分钟审计加 3.08 分钟转人工;它计算的是常规审计与接管,不包含不可回滚错误发生后的补偿动作。补偿是低频高成本事件,不能用平均值摊掉。产品做预算时应该把补偿单列,而不是假设它会被日常人工吸收。
把撤销模型写成判定
下面的模型把范围、时间窗、补偿写进同一张表,并给出两个判定:当前请求能不能撤,以及某类动作是否必须在执行前拦截。
// file: src/trust/03-3-undo-model.ts
// tier: L2
// verify: node --test test/trust/03-3-undo-model.test.ts
// 撤销模型:范围、时间窗、补偿动作三件齐全才算可撤销。
// C 的 30 分钟窗口与 86% 可回滚比例来自事实表;14% 是已发出通知类动作。
import { FULL } from "../core/rate.ts";
export type UndoScope = "none" | "suggestion" | "version" | "action";
export type Compensation =
| "none"
| "corrective-notice"
| "corrective-notice-and-callback";
export type WindowKind = "none" | "before-publish" | "after-action";
export type UndoModel = {
readonly key: "A" | "B" | "C";
readonly scope: UndoScope;
readonly windowKind: WindowKind;
readonly windowMinutes: number | null;
readonly compensation: Compensation;
};
export const UNDO_MODELS: Record<"A" | "B" | "C", UndoModel> = {
A: {
key: "A",
scope: "suggestion",
windowKind: "none",
windowMinutes: null,
compensation: "none",
},
B: {
key: "B",
scope: "version",
windowKind: "before-publish",
windowMinutes: null,
compensation: "corrective-notice",
},
C: {
key: "C",
scope: "action",
windowKind: "after-action",
windowMinutes: 30,
compensation: "corrective-notice-and-callback",
},
};
export type Action =
| "suggestion"
| "publish"
| "price-change"
| "delist"
| "send-notice";
export type UndoRequest = {
readonly action: Action;
readonly executed: boolean;
readonly elapsedMinutes: number;
readonly published?: boolean;
readonly propagated?: boolean;
};
export type UndoDecision = {
readonly mode: "noop" | "undo" | "compensate" | "block";
readonly reason: string;
};
export function decideUndo(
model: UndoModel,
request: UndoRequest,
): UndoDecision {
if (model.scope === "suggestion" || request.action === "suggestion") {
return { mode: "noop", reason: "建议未落库,撤销就是不采纳" };
}
if (request.action === "publish") {
if (request.published !== true) {
return { mode: "undo", reason: "未发布,回退上一版即可" };
}
return { mode: "compensate", reason: "已发布,只能补发更正说明" };
}
if (request.action === "send-notice") {
if (!request.executed) {
return { mode: "block", reason: "通知不可撤,必须在发出前拦截" };
}
return { mode: "compensate", reason: "已发出,补发说明并人工回访" };
}
if (!request.executed) {
return { mode: "block", reason: "动作尚未执行,先判断是否需要拦截" };
}
if (
model.windowMinutes !== null &&
request.elapsedMinutes <= model.windowMinutes &&
request.propagated !== true
) {
return { mode: "undo", reason: "在时间窗内,反向执行动作" };
}
return { mode: "compensate", reason: "超出时间窗或已传播,转补偿" };
}
// C 的改价、下架只有在 30 分钟窗口内才可反向执行;
// 发通知不可撤,必须在执行前拦截。
export function preflightRequired(model: UndoModel, action: Action): boolean {
if (action === "suggestion" || action === "publish") return false;
if (action === "send-notice") return true;
if (action === "price-change" || action === "delist") {
return model.windowMinutes === null;
}
return true;
}
export const AUDIT_ERROR_BPS = 170;
export const NON_ROLLBACK_BPS = 1400;
// 1.7% × 14% = 0.238%(不可回滚错误率)
export function irreversibleErrorPercent(): number {
return (AUDIT_ERROR_BPS * NON_ROLLBACK_BPS) / FULL / 100;
}
// 1 − 14% = 86%(错误中可回滚比例)
export function rollbackShare(): number {
return (FULL - NON_ROLLBACK_BPS) / FULL;
}
UNDO_MODELS 对应三种撤销对象:A 是建议,B 是版本,C 是动作。decideUndo 先看对象,再看状态:B 未发布可回退,已发布只能补偿;C 的改价在 30 分钟内且未传播可反向执行,超出窗口或已传播则转补偿;发通知无论何时都不可撤,未执行时直接拦截。
preflightRequired 回答的是另一个问题:这个动作在当前产品能力下是否可撤。C 有 30 分钟窗口,改价与下架不需要额外拦截;B 没有动作级窗口,如果它试图改价,就必须在执行前拦截。irreversibleErrorPercent 把 1.7% 与 14% 乘出 0.238%,rollbackShare 把 86% 还原出来,两个数一起看,才知道补偿路径覆盖的是哪一段。
撤销设计的检查清单
- 先写撤销对象:建议、版本还是动作,三者不能混用。
- 每个对象写清时间窗:发布前、30 分钟内,还是无窗口。
- 写清不可撤动作清单,并为每个动作配补偿动作。
- 检查反向执行的前提:原值、反向接口、下游是否已消费。
- 不可撤销且没有补偿的动作,必须在执行前拦截。
- 补偿动作要单列成本,不能摊进日常人工。
小结
- 撤销不是 Ctrl+Z,而是范围、时间窗、补偿动作三件齐全的承诺。
- A 的撤销是不采纳,因为建议没有落库,不需要时间窗。
- B 的撤销是版本回退,发布前不限次数,发布后只能补发更正。
- C 的撤销是反向执行,窗口是动作后 30 分钟。
- C 的错误中 86% 可回滚,14% 不可回滚,不可回滚错误率是 0.238%。
- 改价只有在原值、反向接口、下游未消费三个条件都满足时才真的可撤。
- 发通知不可撤,必须在发送前拦截;发送后只能补发说明并人工回访。
- 补偿不是撤销,它承认动作已经发生,成本更高,必须单独预算。
阅读导航:上一节:3.2 运行中纠偏 · 下一节:4.1 什么时候停下来问 。
常见错误与边界
- 把撤销当成删除记录。 删除界面记录不会反向执行外部动作,用户以为撤了,价格和库存仍然停在新值。
- 不写时间窗。 用户超出窗口后要求撤销,团队只能临时承诺;时间窗必须提前写进界面与协议。
- 假设所有动作都能反向执行。 没有原值快照、没有反向接口、下游已缓存新值时,反向执行并不等价于撤销。
- 用补偿代替拦截。 发通知不可撤,补偿只能降低影响;正确顺序是先拦截,再补偿。
- 把补偿成本摊进平均值。 补偿是低频高成本事件,摊进日常人工会让预算看起来正常,出事时没有资源。
- 三种撤销对象共用一个按钮。 建议、版本、动作的撤销语义不同,统一按钮会让用户无法判断后果。
下一节进入审批:撤销处理已经发生的动作,审批处理还没发生的动作;什么时候应该停下来问人,什么情况下停下来问反而有害。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。