以下人物、公司与数字均为教学假设,不构成对任何真实产品的评价。
前两节讲的是「给用户看」的溯源与解释。这一节讲「给复核者看」的审计记录。两者经常被混为一谈:产品把解释面板截图存档,就以为有了审计。实际上解释是给人当场理解的,审计是给第三方事后复核的,要求完全不同。
审计记录的可用性可以拆成三个动作:能查、能导、能对上业务单据。能查是检索得到,能导是导得出去且不泄露,能对上业务单据是记录与真实业务对象能一一对应。三个动作缺一个,审计就退化成「有一堆日志」。
审计记录要回答的四个问题
一份可用的审计记录,至少要回答四个问题。回答不了,复核者就得回到系统里重新拼信息,审计成本会转移到人身上。
| 问题 | 对应字段 | 缺失后的表现 |
|---|---|---|
| 哪个任务 | taskId | 记录无法与业务单据对应 |
| 谁在操作 | actor | 无法区分 Agent 与人 |
| 做了什么 | action、ruleId | 只能看到结果,看不到依据 |
| 能不能回滚 | snapshotBefore、snapshotAfter、rollbackHandle | 出错后无法恢复 |
这四个问题之外,还要加两个工程字段:timestamp 用于排序和时限判断,businessDocId 用于对上业务单据。九个字段合起来,才构成一条最小可用记录。
注意「谁在操作」不只记录账号。Agent 执行时要记录是哪个 Agent、哪条规则、哪次运行;人复核时要记录是谁复核、什么时候复核。把两者混成一个 actor 字段,事后无法判断责任边界。
九个必需字段
| 字段 | 作用 | 常见错误 |
|---|---|---|
| taskId | 关联任务 | 只记录内部自增 id,业务侧查不到 |
| actor | 执行者 | 只写系统账号,不区分 Agent 与人 |
| action | 动作类型 | 写「处理完成」,不写具体动作 |
| ruleId | 依据规则 | 只写规则描述,不写可检索的 id |
| snapshotBefore | 执行前状态 | 只存差异,不存完整前后值 |
| snapshotAfter | 执行后状态 | 与 before 字段口径不一致 |
| timestamp | 时间 | 用本地时间且不带时区 |
| rollbackHandle | 回滚句柄 | 记录「可回滚」,但没有句柄 |
| businessDocId | 业务单据 | 只存展示名,不存可查询的编号 |
字段清单的价值不在于多,而在于每个字段都能被机器校验。只要有一个字段是自由文本,导出时就会遇到格式不一致,复核者仍然要人工整理。
字段还要保持口径稳定。snapshotBefore 和 snapshotAfter 必须用同一种结构描述,否则差异比较没有意义。比如一个存 JSON、一个存自然语言,复核者无法判断到底改了什么。
能查:记录要能被业务人员读懂
审计记录的第一读者通常不是工程师,而是业务复核者、合规人员或客服主管。他们不熟悉内部表结构,需要的是能直接读懂的动作描述和能点开的业务对象。
因此记录里要同时保留两类信息:机器可检索的 id,和人能读懂的摘要。只有 id,业务人员无法快速判断;只有摘要,系统无法精确检索。两者都写,代价不大,收益很大。
检索维度也要提前设计。常见检索是「按任务」「按时间」「按动作类型」「按规则」。如果 taskId 不是索引字段,或者 timestamp 没有时区,检索结果会不可信。审计界面上的筛选器,背后必须有对应索引,而不是把全量记录拉到前端过滤。
能导:默认脱敏,授权才带身份
导出是审计可用性的分水岭。很多系统能看不能导,或者导出的格式无法被审计工具消费。可用的导出至少要满足:字段完整、格式稳定、身份信息可控。
| 导出模式 | 包含内容 | 适用场景 |
|---|---|---|
| 默认脱敏 | 九个必需字段,不含客户身份 | 日常抽检、内部复盘 |
| 授权完整 | 增加客户名称、联系方式 | 投诉处理、监管问询 |
默认脱敏不是可选项,而是默认值。只有明确授权的场景才带身份字段,并且要记录「谁授权、为什么授权、导出了什么」。否则审计系统本身会成为隐私泄露的通道。
导出格式建议用结构化文本,一行一条记录,字段用固定分隔符。这样既能被人读,也能被脚本处理。不要导出成截图或 PDF,那会失去检索和比对能力。
能对上业务单据
「能对上业务单据」是审计与普通日志的最大区别。日志可以只记录系统内部发生了什么,审计必须回答「这条记录对应哪张订单、哪个工单、哪次客户沟通」。
对应关系要双向可查:从审计记录能跳到业务单据,从业务单据也能查到相关审计记录。只有单向,复核者仍然要在两个系统之间手工搬运。
C Runner(Kettle 的电商运营任务执行 Agent)的每个动作都指向规则与快照,动作之后 30 分钟内可撤销。审计记录里的 businessDocId 就是那个「30 分钟内能找回哪张单据」的锚点。没有它,回滚句柄再完整也不知道该回滚到哪。
C Runner 的抽检账
C 的审计抽检比例是 8%,单次复核 12 分钟,折合每个任务 0.96 分钟。月任务量 13,200 个,审计人工是 211.2 小时,按月人工成本 30 美元/小时算是 6,336 美元。
这个数字经常被误用。0.96 分钟只是审计摊销,不是 C 的全部人工。C 还有 22% 的任务转人工,平均 14 分钟,折合 3.08 分钟/任务。两部分相加才是 4.04 分钟/任务,月人工 888.8 小时,26,664 美元。
| 口径 | 分钟/任务 | 月人工小时 | 月人工成本 |
|---|---|---|---|
| 只算审计 | 0.96 | 211.2 | 6,336 |
| 审计 + 转人工 | 4.04 | 888.8 | 26,664 |
如果只算审计,C 的月总成本会变成 10,886.4 美元,节省率从 73.7% 夸大成 90.8%。这不是小数点问题,而是把「人还要接手 22% 的任务」这件事从账上抹掉了。审计记录再完整,也不能替代转人工。
这笔账对产品设计的含义是:审计界面的效率直接影响 0.96 分钟这一项。如果复核者要在三个系统之间跳转才能判断一个动作,12 分钟的单次复核就守不住,抽检比例会被迫下降,错误发现率也会跟着下降。
审计与隐私的张力
审计要求「记得全」,隐私要求「记得少」。两者的平衡点不是二选一,而是分层:执行必需的信息完整保留,身份信息默认脱敏,访问和导出都留痕。
具体做法可以分三层:
- 执行层保留完整前后值与规则 id,用于回滚和责任判断。
- 展示层默认隐藏客户身份,只显示业务单据编号。
- 导出层按授权决定是否带身份字段,并记录导出行为本身。
张力最大的地方是「已发出的客户通知」。C 的动作里 86% 可回滚,14% 是已发出通知类动作,不可回滚。对这类动作,审计记录要保留通知内容、发送对象和发送时间,否则补偿动作无从设计;但这些内容又恰恰包含最多客户信息。解决办法是保留内容摘要和发送凭证,完整内容留在受控的通知系统里,审计记录只存引用。
把可用性写成导出函数
下面这个模型把九个字段、业务单据关联、默认脱敏和抽检成本写在一起。导出前先校验字段完整性,再决定是否带身份信息,最后返回可读的一行记录。
// file: src/trust/05-3-audit-trail-ux.ts
// tier: L2
// verify: node --test test/trust/05-3-audit-trail-ux.test.ts
// 审计记录要能查、能导、能对上业务单据。
// C 的抽检口径:8% × 12 分钟 = 0.96 分钟/任务(事实表 4.3);
// 0.96 只是审计摊销,不含转人工的 3.08 分钟。
import { type Cents } from "../core/money.ts";
import { FULL } from "../core/rate.ts";
import { type Result, fail, ok } from "../core/result.ts";
import { HOUR_CENTS, RUNNER } from "../cases.ts";
export type AuditField =
| "taskId"
| "actor"
| "action"
| "ruleId"
| "snapshotBefore"
| "snapshotAfter"
| "timestamp"
| "rollbackHandle"
| "businessDocId";
export const REQUIRED_FIELDS: readonly AuditField[] = [
"taskId",
"actor",
"action",
"ruleId",
"snapshotBefore",
"snapshotAfter",
"timestamp",
"rollbackHandle",
"businessDocId",
];
export type AuditRecord = {
readonly [K in AuditField]?: string;
} & {
readonly customerName?: string;
readonly contact?: string;
};
export function missingFields(record: AuditRecord): AuditField[] {
return REQUIRED_FIELDS.filter((field) => {
const value = record[field];
return value === undefined || value.trim().length === 0;
});
}
// 能对上业务单据 = 任务号与业务单据号同时存在且可读。
export function matchesBusinessDoc(record: AuditRecord): boolean {
const taskId = record.taskId?.trim() ?? "";
const docId = record.businessDocId?.trim() ?? "";
return taskId.length > 0 && docId.length > 0;
}
export type AuditExport = {
readonly lines: string;
readonly redacted: boolean;
};
// 导出默认脱敏;只有明确授权才带客户身份字段。
export function exportAudit(
record: AuditRecord,
includePii: boolean,
): Result<AuditExport> {
const missing = missingFields(record);
if (missing.length > 0) {
return fail(`missing fields: ${missing.join(", ")}`);
}
if (!matchesBusinessDoc(record)) {
return fail("business document link is not readable");
}
const parts = REQUIRED_FIELDS.map(
(field) => `${field}=${record[field] ?? ""}`,
);
if (includePii) {
parts.push(`customerName=${record.customerName ?? ""}`);
parts.push(`contact=${record.contact ?? ""}`);
}
return ok({ lines: parts.join(" | "), redacted: !includePii });
}
export const RUNNER_AUDIT = {
sampleRateBps: 800,
reviewMinutes: 12,
} as const;
export function samplingMinutesPerTask(): number {
return (RUNNER_AUDIT.reviewMinutes * RUNNER_AUDIT.sampleRateBps) / FULL;
}
export function monthlySamplingHours(): number {
return (samplingMinutesPerTask() * RUNNER.monthlyTasks) / 60;
}
export function monthlySamplingCents(): Cents {
return Math.round((monthlySamplingHours() * HOUR_CENTS));
}
missingFields 把「记录完整」变成可枚举的字段列表,错误信息能直接告诉复核者缺什么。exportAudit 先校验,再按授权决定是否拼入身份字段,返回结构里带 redacted 标记,界面可以据此显示导出范围。抽检成本用基点表示 8%,避免浮点百分比在配置里漂移。
把 C 的记录代入:九个字段齐全,导出默认脱敏,返回的一行里能看到 taskId、ruleId、前后快照和 businessDocId;只有授权导出才追加客户名称和联系方式。抽检成本 0.96 分钟、月 211.2 小时、6,336 美元,与事实表一致。
审计记录不是日志
日志回答「系统发生了什么」,审计回答「这个决定是怎么做出的、谁负责、能不能回滚」。前者可以滚动删除,后者必须按保留期归档。把日志直接当审计,最常见的后果是:出事时发现关键字段没记,或者记了但无法与业务单据对应。
另一个区别是写入时机。日志可以异步批量写,审计记录必须在动作生效前落盘,至少要先写「意图」,再写「结果」。否则动作失败时,记录里只有结果,没有意图,无法判断是没执行还是执行了没记录。
小结
- 审计记录的可用性是三个动作:能查、能导、能对上业务单据。
- 最小记录包含九个字段:任务、执行者、动作、规则、前后快照、时间、回滚句柄、业务单据。
- 字段必须机器可校验,自由文本会让导出格式失控。
- 导出默认脱敏,只有明确授权才带客户身份,并且导出行为本身要留痕。
- 业务单据关联要双向可查,只有单向等于没有关联。
- C 的抽检是 8% × 12 分钟 = 0.96 分钟/任务,月 211.2 小时、6,336 美元。
- 0.96 不是 C 的全部人工;加上 22% 转人工的 3.08 分钟,才是 4.04 分钟、888.8 小时、26,664 美元。
- 只算审计会把 C 的月总成本算成 10,886.4 美元,节省率从 73.7% 夸大成 90.8%。
阅读导航:上一节:5.2 解释的三个层次 · 下一节:6.1 六种失败各自该长什么样 。
常见错误与边界
- 把日志当审计。 日志回答系统发生了什么,审计回答决定怎么做出、谁负责、能否回滚;两者保留期和写入时机都不同。
- 只记录结果不记录意图。 动作失败时只有结果无法判断是没执行还是执行了没记录;审计要先写意图再写结果。
- 字段用自由文本。 导出时格式不一致,复核者仍要人工整理;每个字段都应可机器校验。
- 默认导出带身份信息。 审计系统会变成隐私泄露通道;默认脱敏,授权导出并留痕。
- 只算审计不算转人工。 C 的 0.96 分钟只是审计摊销,漏掉 3.08 分钟转人工会把节省率从 73.7% 夸大成 90.8%。
- 只做单向关联。 从审计能跳到单据、从单据查不到审计,复核者仍要在两个系统之间搬运。
这一节把「信任」落到可复核的记录上。下一章换一个方向:当 Agent 出错、超时、被策略拦截时,界面应该长什么样。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。