工作原理

从内部看内核:谁参与、一项任务如何走完、内核保存什么,以及常见术语在这里的含义。内核用 Rust 编写,本身不调用任何模型;任何模型驱动的智能体都可以作为 MCP 客户端接入。

谁参与

智能体(读者)

swarm 角色

任何模型都可以作为 MCP 客户端接入。每个智能体有自己的令牌,只能看到自己角色的工具:audit_acquire、audit_submit、audit_renew、audit_release。它一次只处理一个租给它的任务,任务之间不保留任何东西:指令就是它拿到的全部。

所有者

owner 角色

负责运行语料的人。持有所有者令牌时可用的工具包括:audit_status、audit_record、audit_fallen、audit_coverage、audit_revoke、audit_withdraw_text、audit_terminal_receipt、audit_close。只有所有者能撤回、读取记录和关闭一次运行。

内核

sbgk audit-serve

把工作切成任务、租出任务、核对智能体提交的每一行、保存日志,并找出撤回影响了哪些内容。它不调用任何模型:模型在智能体一侧。

代码中还有一个实验性、默认关闭的图构建器,有自己的角色(builder)。它不在 0.1 的默认配置中,本页也不依赖它。

一项任务的生命周期

从一个智能体的角度看。

  1. 内核把工作切成任务

    语料被切成任务,例如“阅读这份文档的这一段”。每个任务带有一份指令:读什么、研究问题、哪些内容已经记录。

  2. 一个智能体租下任务

    智能体调用 audit_acquire,任务就租给它,同一时间不会租给别人。租约到期,内核会收回任务并交给另一个智能体。智能体也可以续租或归还租约(audit_renew、audit_release)。

  3. 智能体用记录作答

    它阅读分配给它的那一段,用 JSON 行作答:observe(精确引用)、claim(带 based_on)、relation、hypothesis、question、done。它发送的是引用的文本,而不是偏移量。

  4. 内核核对每一行

    通过 audit_submit 提交的每一行在记录之前都会被核对:引用必须逐字节出现在租给该智能体的那一段中,否则被拒绝,不存储任何内容;结论只能依据有效的记录;编号和大小都有上限。

  5. 通过核对的内容被写下来

    每次被接受的提交成为日志中的一帧,每条记录都有回执。用同一个提交编号重试,返回的是原来的回执,而不会提交两次。运行完成时,所有者关闭这次运行(audit_close),再来要任务的智能体会收到 DONE。

在检查页面上逐帧观看一次录制的运行

内核内部

审计层

任务与租约、记录的核对、依据,以及撤回的级联。它通过 TCP 提供 MCP 风格的 JSON-RPC 2.0(initialize、tools/list、tools/call),令牌的角色决定智能体能看到哪些工具。审计服务默认只监听本机回环地址,没有 TLS;跨机器使用时请通过安全隧道或 TLS 代理,并妥善保管智能体令牌。sbgk mcp-bridge 让以 stdio 子进程方式启动服务的客户端(例如 Claude Code)加入,并把令牌留在模型的提示词之外。

底层的引擎

引擎把证据绑定到按内容切块的文档版本的精确字节范围,保存事实和规则推导,撤回那些依据已被撤回的结论,同时重新推导那些还有另一条有效推导的结论,并把状态存为带哈希链日志和 Merkle 根的 .sbgk 容器。在其上的审计服务(sbgk audit-serve)中,结论之间不构成推导链,且一条结论在 based_on 中列出的每条引用都是必需的:只要其中一条被撤回,该条结论记录即失去依据;建立在其他引用上的独立记录则保持不变。

日志

所有被接受的内容都写入同一份只追加的日志。每一帧有版本、序号、前一帧的哈希和规范化 JSON 的内容。第一帧保存起始状态的快照,连同文档的文本。下面逐条说明这些术语。

术语逐条说明

确定性这样任何人都可以重新核验并得到同样的答案,而不必信任模型。

这里的“确定性”是指:内核的响应由其输入决定,日志重放后得到相同的根哈希。同一个团队的两次运行仍然不同,差别在时间戳和模型写出的内容。

精确引用这样结论只能依赖原文中真正存在的字句。

指其字节逐字节出现在租给智能体的那一段文档中的文本。智能体发送文本,内核查找字节。不做任何归一化:把直引号写成弯引号、不换行空格,以及任何被改动的字节,都会同样失败。

文档固定

来源文档的身份:仓库、提交、路径和原始字节的 SHA-256;你自己的文件则是它在目录中的路径和其字节的 SHA-256。使用 --docs 运行时,文件在启动时固定;文件一旦改变,就是一次新的运行。

分块

按内容而不是按固定大小切出的文档版本片段(内容定义分块)。引擎把证据绑定到这种版本内的精确字节范围。

快照

引擎在某一时刻的状态,存为 .sbgk 容器:切块的文档、事实、推导、带哈希链的日志和 Merkle 根。三件事要分开:固定是一份文档的身份,精确引用是关于文档内字节的陈述,快照是某一时刻的状态。一次运行日志的第一帧保存起始状态的快照,连同文档的文本。

依据(based_on)这样你能看出每条结论依据什么,以及来源被撤回时哪些结论会失去依据。

指一条结论写明的引用。其中每一条都是必需的:只有它们全部成立,这条结论才有依据。

日志这样对历史的改动在核验时会显现出来,任何人也可以重放它。

指一次运行的只追加记录。每次被接受的提交是一帧:规范化 JSON(RFC 8785),通过 SHA-256 链接到前一帧,先写入并同步到磁盘,再公布新状态。哈希链日志是一种古老而常见的构造(Git 历史和证书透明度日志都在用);这里把它用于 AI 智能体团队的证据。

规范化形式

把同样的数据写成同一种约定的形式,使相同的数据就是相同的字节(JSON 用 RFC 8785)。日志的读取方只接受这种形式:多余的空白、不同的键顺序或重复的字段会被拒绝,而不是被归一化。

根哈希

audit_root 与 engine_root:代表日志某一时刻整个状态的哈希,前者对应记录、来源、本体、链接、回执和检查点,后者对应引擎。根哈希是状态的指纹,而不是状态的快照。wal_head 是最后一帧的哈希:它承诺了整份日志的顺序。

回执这样你可以事后用保存在别处的值来核验一份日志。

每次被接受的提交都有回执;运行完成时还有一份最终回执,写明这次运行的根哈希和链头。请把它保存在日志写入者无法修改的地方。

检查点(签名)这样可以用保存在日志之外的东西核验日志。

服务会不时为日志写出一个检查点:到此为止的帧数、状态的根哈希,以及“什么仍然成立、什么依据什么”的哈希。用签名密钥启动的服务会为它签名(C2SP signed note,Ed25519);sbgk audit-verify --checkpoint 检查签名,以及检查点指明的确实是这份日志的帧。签名只证明密钥的持有者这样声明过:放在日志旁边的密钥文件,防不住运维方自己。

凭证这样可以单独核验一条结论,而不需要日志。

sbgk audit-proof 从日志中切出的一个文件:一条记录及其全部依据(直到引用本身),置于签名检查点之下。sbgk audit-proof-verify 无需日志、无需模型即可单独核验它。它说明这条记录及其依据在该检查点时已在日志中,而不是说它们现在仍然成立。

重放

重新打开日志,会把其中的帧再执行一遍,并检查结果是否是相同的根哈希。停止的运行重放后根哈希相同。

租约与指令

租约是一个智能体在一段时间内处理一个任务的权利,到期的租约会被收回。指令是随任务一起发出的说明。

撤回与级联这样来源被撤回时,你看到的是该重新核对哪些结论,而不是把所有内容重看一遍。

所有者封闭一份文档的某些字节(audit_revoke、audit_withdraw_text)。以它们为必需依据的记录都会失去依据,其余记录保持不变,历史不会被改写。从 0.1.6 起,撤回会封闭这些字节,与之重叠的引用以后也会被拒绝;从 0.1.7 起,内核的修复请求会指明哪些内容失去了依据。在检查页面上可以逐步看到。

你就是内核

这是规则的演示模型,并非内核本身。内核不在浏览器中运行;真实的检查请见真实内核的一次录制运行和 sbgk audit-verify。

同样的场景,以列表呈现

未启用 JavaScript 时,游戏以列表呈现:每个场景给出提交的部分、正确的判断,以及真实内核的回答。

第 1 关

  1. 被改动一个字节的引用

    reader-1 交来一条引用。它是否逐字节出现在文档中?

    • 引用: The initialization phase **MUST** be the forst interaction between client and server.

    正确的判断: 拒绝

    真实的回答: REPAIR_REQUIRED · QUOTE_NOT_FOUND_IN_BYTES: quote has no byte-exact occurrence · Records stored: 0

  2. 两条精确引用,各有一条结论

    读者每次送来一个部分。像录制的运行那样搭起快照:接受引用,再登记每条结论写明的依据。

    1. 引用 1:把它与文档逐字节比对,然后接受或拒绝。

      • 引用 1: The initialization phase **MUST** be the first interaction between client and server.

      正确的判断: 接受

      真实的回答: COMMITTED · t1_o1 → @2100c44776db5bb2

    2. 引用 2:与文档比对,然后接受或拒绝。

      • 引用 2: The client **MUST** initiate this phase by sending an `initialize` request containing:

      正确的判断: 接受

      真实的回答: COMMITTED · t1_o2 → @c8c8ccea139fff44

    3. 结论 1 写明了它的依据:based_on 引用 1。点按这条结论,再点按它所指的、立方体里的引用。

      • 结论 1: Initialization must be the first client-server interaction. · 依据(based_on): 引用 1

      正确的判断: 依据 引用 1

      真实的回答: COMMITTED · t1_c1 → @22308d5ced9c0afc · based_on: @2100c44776db5bb2

    4. 结论 2 写明了它的依据:based_on 引用 2。点按这条结论,再点按它所指的、立方体里的引用。

      • 结论 2: The client starts initialization with an initialize request. · 依据(based_on): 引用 2

      正确的判断: 依据 引用 2

      真实的回答: COMMITTED · t1_c2 → @0c5f4921318d1e9c · based_on: @c8c8ccea139fff44

  3. 所有者撤回第一条引用

    录制的运行中的引用和结论已在日志中。现在所有者撤回引用 1。

    • 引用 1: The initialization phase **MUST** be the first interaction between client and server.
    • 结论 1: Initialization must be the first client-server interaction.
    • 引用 2: The client **MUST** initiate this phase by sending an `initialize` request containing:
    • 结论 2: The client starts initialization with an initialize request.

    正确的判断: 引用 1 (已撤回), 结论 1 (失去依据)

    真实的回答: REVOKED · claim 1: grounded false · claim 2: grounded true

  4. 被改动一个字母的日志副本

    有人在日志的副本里改动了一条结论的一个字母:“must” 变成了 “Must”。它仍然是有效的 JSON。你要打开它吗?

    • Initialization must be the first client-server interaction. → Initialization Must be the first client-server interaction.

    正确的判断: 拒绝打开

    真实的回答: BAD_FIELD: audit WAL frame 5: hash mismatch · sbgk audit-verify: REFUSED, exit 1

这正是内核对智能体提交的每一部分所做的事。它把引用与文档逐字节比对,拒绝原文中不存在的那一条:要么精确引用,要么不收。一条结论只有在它列为依据的每一条引用都成立时才成立;所以撤回一个来源,只会让以它为依据的结论失去依据,其余不受影响。被改动一个字母的日志也会被拒绝,因为日志的每一帧都带有自身内容和前一帧的哈希:这就是哈希链。真实的内核按规则完成这一切,不需要询问模型。

第 2 关

  1. 来自发出范围之外的引用

    reader-1 拿到的是这一页的一个范围,而不是整页。下面这条引用确实是这一页上的句子。它在这个范围之内吗?

    • 引用: Implementations **SHOULD** be prepared to handle these error cases:
    • 发给智能体的范围:第 0 到 5932 字节
    • 引用从第 6098 字节开始,文档共 6663 字节

    正确的判断: 拒绝

    真实的回答: REPAIR_REQUIRED · BAD_FIELD: quote is outside the issued byte ranges · Records stored: 0

  2. 依据一条从未存入的引用的结论

    先前,reader-1 那条被改动一个字节的引用被拒绝了,所以 t1_o1 之下没有存入任何东西。现在这位读者交来一条结论,它的依据写的是 t1_o1。

    • 结论: Initialization must be the first client-server interaction.
    • 依据(based_on): t1_o1
    • 这条记录从未存入:它所在的那一行被拒绝了。

    正确的判断: 拒绝

    真实的回答: REPAIR_REQUIRED · UNKNOWN_LOCAL_ID: expected an issued local id or @hash · Records stored: 0

  3. 停止服务器,再重新启动

    服务器在同一份日志上停止后又重新启动。回执是在停止之前保存的。请把重启后的值与回执中的值比较。

    • 回执中的值(audit_root): 30aff21361ebed46be969841d43d42063b58789fec8525d93f5fd9509b9d7a2a
    • 重启后的值(audit_root): 30aff21361ebed46be969841d43d42063b58789fec8525d93f5fd9509b9d7a2a

    正确的判断: 状态相同

    真实的回答: resumed: true · audit_root: 30aff213…9b9d7a2a = 30aff213…9b9d7a2a

  4. 尾部被截掉的日志

    日志的一份副本丢掉了最后一帧。用 sbgk audit-verify 检查两次:第一次不用回执,第二次用保存在日志之外的回执。

    1. 不用回执:检查会怎么说?

      • 日志的副本:12 帧,最后一帧被截掉
      • 检查: sbgk audit-verify --wal <journal>

      正确的判断: 检查说:完整

      真实的回答: status: VERIFIED · exit 0 · entries: 12

    2. 用保存在日志之外的回执:检查会怎么说?

      • 日志的副本:12 帧,最后一帧被截掉
      • 保存在日志之外的回执: wal_head 6db85444…88d6c627
      • 回执中保存的是第 13 条记录之后的状态
      • 检查: sbgk audit-verify --wal <journal> --expect <receipt> --at-end

      正确的判断: 检查显示:被截断

      真实的回答: status: MISMATCH · exit 1 · found_after_entries: null

日志不是什么

能发现篡改,但不能防止篡改:能重写整份日志的人也能重写它的哈希链,所以请把回执保存在日志写入者无法修改的地方。sbgk audit-verify --expect receipt.json --at-end 能发现被截掉的尾部。用签名密钥启动的服务会为检查点签名,但签名只证明密钥的持有者这样声明过:放在日志旁边的密钥文件,或保存在运维方自己仓库里的检查点,都防不住运维方自己。放在写入者够不到之处的锚点才可以,而这个版本没有第三方见证服务。

三种使用方式

单独使用

在你的语料上运行 sbgk audit-serve(语料可以是一个文本文件目录,或按提交和 SHA-256 固定的来源清单),让你的智能体用各自的令牌,从任何语言或通过 Python 客户端调用它的 MCP 工具。

配合你运行的团队

基准测试运行器(benchmarks/run_pilot_ac.py)让一组读者和一个核对者通过内核工作,并让同一组智能体在不接入内核的情况下运行,用于对比。

配合你已有的工具

MCP 客户端通过桥接作为一个智能体加入。对一个文件夹上的一个智能体,yuce mcp 就是客户端配置中的一项。Python 客户端在代码中调用同样的工具,编排器在自己的步骤中调用同样的 MCP 工具。目前还没有的是面向编排器(例如 Temporal 或 LangGraph)的专门适配器。

依据: README.md, LIMITATIONS.md, SECURITY.md