工作原理
从内部看内核:谁参与、一项任务如何走完、内核保存什么,以及常见术语在这里的含义。内核用 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 的默认配置中,本页也不依赖它。
一项任务的生命周期
从一个智能体的角度看。
内核把工作切成任务
语料被切成任务,例如“阅读这份文档的这一段”。每个任务带有一份指令:读什么、研究问题、哪些内容已经记录。
一个智能体租下任务
智能体调用
audit_acquire,任务就租给它,同一时间不会租给别人。租约到期,内核会收回任务并交给另一个智能体。智能体也可以续租或归还租约(audit_renew、audit_release)。智能体用记录作答
它阅读分配给它的那一段,用 JSON 行作答:
observe(精确引用)、claim(带based_on)、relation、hypothesis、question、done。它发送的是引用的文本,而不是偏移量。内核核对每一行
通过
audit_submit提交的每一行在记录之前都会被核对:引用必须逐字节出现在租给该智能体的那一段中,否则被拒绝,不存储任何内容;结论只能依据有效的记录;编号和大小都有上限。通过核对的内容被写下来
每次被接受的提交成为日志中的一帧,每条记录都有回执。用同一个提交编号重试,返回的是原来的回执,而不会提交两次。运行完成时,所有者关闭这次运行(
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 关
被改动一个字节的引用
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两条精确引用,各有一条结论
读者每次送来一个部分。像录制的运行那样搭起快照:接受引用,再登记每条结论写明的依据。
引用 1:把它与文档逐字节比对,然后接受或拒绝。
- 引用 1: The initialization phase **MUST** be the first interaction between client and server.
正确的判断: 接受
真实的回答:
COMMITTED · t1_o1 → @2100c44776db5bb2引用 2:与文档比对,然后接受或拒绝。
- 引用 2: The client **MUST** initiate this phase by sending an `initialize` request containing:
正确的判断: 接受
真实的回答:
COMMITTED · t1_o2 → @c8c8ccea139fff44结论 1 写明了它的依据:based_on 引用 1。点按这条结论,再点按它所指的、立方体里的引用。
- 结论 1: Initialization must be the first client-server interaction. · 依据(based_on): 引用 1
正确的判断: 依据 引用 1
真实的回答:
COMMITTED · t1_c1 → @22308d5ced9c0afc · based_on: @2100c44776db5bb2结论 2 写明了它的依据:based_on 引用 2。点按这条结论,再点按它所指的、立方体里的引用。
- 结论 2: The client starts initialization with an initialize request. · 依据(based_on): 引用 2
正确的判断: 依据 引用 2
真实的回答:
COMMITTED · t1_c2 → @0c5f4921318d1e9c · based_on: @c8c8ccea139fff44
所有者撤回第一条引用
录制的运行中的引用和结论已在日志中。现在所有者撤回引用 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被改动一个字母的日志副本
有人在日志的副本里改动了一条结论的一个字母:“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 关
来自发出范围之外的引用
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依据一条从未存入的引用的结论
先前,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停止服务器,再重新启动
服务器在同一份日志上停止后又重新启动。回执是在停止之前保存的。请把重启后的值与回执中的值比较。
- 回执中的值(audit_root): 30aff21361ebed46be969841d43d42063b58789fec8525d93f5fd9509b9d7a2a
- 重启后的值(audit_root): 30aff21361ebed46be969841d43d42063b58789fec8525d93f5fd9509b9d7a2a
正确的判断: 状态相同
真实的回答:
resumed: true · audit_root: 30aff213…9b9d7a2a = 30aff213…9b9d7a2a尾部被截掉的日志
日志的一份副本丢掉了最后一帧。用 sbgk audit-verify 检查两次:第一次不用回执,第二次用保存在日志之外的回执。
不用回执:检查会怎么说?
- 日志的副本:12 帧,最后一帧被截掉
- 检查: sbgk audit-verify --wal <journal>
正确的判断: 检查说:完整
真实的回答:
status: VERIFIED · exit 0 · entries: 12用保存在日志之外的回执:检查会怎么说?
- 日志的副本: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)的专门适配器。
