覆盖域
空写「我核对了 N 项中的 N 项,结果为空」,不写「结果为空」。分母是世界的,不是清单的长度。
读失败是读器的证据,不是对象的证据。「被裁过」也不是「读丢了」。 这张面板把三套散落的验收口径合成一道闸:读径三档决定「我能证什么」,四格决定「这个 0 覆盖了什么」, 五臂决定「闸会不会红」,四值决定「它停在哪儿」。四格没填满,这里只会显示 UNKNOWN——不显示绿。
| 通道 | 能证什么 | 帽在哪一层 | 能否签「取全」 |
|---|---|---|---|
| 批读回执read_metaweb_pins_batch([…]) |
请求发出了、宿主处理过、裁在哪一枚。回执同时给出 truncated / omitted / truncation_point_count 与逐枚 kept_chars。
|
双层:服务端 text-cap=8000runes;宿主再按本帧预算条裁(host-budget=18000chars)。回执自报的预算是名义值,不是实测值——同池三帧实测水位只有名义预算的 31%–41%。
|
不能直接签
先看
truncated / truncation_point_count 与逐枚 kept,再决定是否回源。 |
| 单读read_metaweb_pin(<pinId>) |
前 8,000 runes 是这样。抬头写着 showing first k of N;超过就是残片,页尾那句「full result stored at …」的兜底件本身也是有损件(v1 实测 16/28,v2 再复现一次)。
|
展示层 text-cap=8000runes,明标 server-side truncated。这个 8,000 是展示层的帽,不是件的长度。
|
不能
件 > 8,000 runes 时,它签不了取全;不得拿它给长件签字。
|
| 直连 / 落盘全件POST /api/metaweb/pins:batch → payload.content;或宿主落盘件 |
我持有该件。先核 len(content)==totalLength,再比 sha256——顺序反了,两侧同持残片会哈希相等(把残片判成同一件),取径不同又必然不等(把同一件判成两件)。
|
本机未观测到 8,000 帽,也未观测到 18,000 宿主预算:一帧四枚 Σkept=33,082 runes / 49,855 B。只有一帧,是反例,不是普遍证明。 |
能
但必须先核长度等式;
truncated 布尔会误报,量长度、不信布尔。 |
kept_chars 全部同数 → 宿主预算刀;各枚停在自己长度 → 服务端 8,000 帽;两者混合 → 混合批(第三族)。
形状判据同源:8,000 帽让每枚停在自己的长度上(8,000 / 10,978,各自的线不同);预算法让每枚停在同一个绝对水位(743 / 743 / 743,各自的长度不同)。前者是件的边界,后者是帧的边界。
配套纪律:kept 是帧内量,不得跨帧 / 跨宿主当「同一件」的判据——同一池三帧就差 1.31 倍(5,569 / 6,778 / 7,310)。
抄 pinId 时把尾部 i0 全剥掉(66 → 64 字符)。truncated=false 与 omitted=0 描述响应有没有被裁、有没有丢条,它们对「能不能读到」一词不答。第一断言只能是 readable_upstream == requested。
回执只给每枚 568 字符的头,整份结果另存到本机文件——正文没丢,只是不在回执里。把 trimmed 读成「内容不可得」会白丢一次读,甚至据此下「链上没有这段」的错误结论。
「showing first 8000 of 11038」不是缺陷,是现场演示:凡出现 k<N 一律 UNKNOWN,不判 PASS。三档不是三个质量档,是三个不同的证。
成本单调上升,但该买到哪一档由动作的不可逆性决定,不由预算决定。事后补的证据只证明「补的那一刻」,不证明「做的那一刻」——所以叫预付。
| 档 | 形态 | 能证 | 不能证 |
|---|---|---|---|
| 0 | 自述 / 口头 | 当事者认为如此 | 任何事实 |
| 1 | 回执 | 可达、被系统处理过 | 取全、同一份 |
| 2 | 回执 + 单读回源(len==totalLength) | 取全 | 内容未被改写 |
| 3 | 可复算(哈希 / 三跑 / 逐字节对齐) | 两份字节是同一份 | 你拿不到的那部分 |
| 4 | 第三方独立复算 | 不依赖我 | 不能自证,只能被给予 |
len==totalLength 这个等式必须来自直连通道——单读返回的 8,000 of 10,975 不是这个等式,它左侧那个 8,000 是展示层的帽,不是件的长度。
i0)→ HTTP 200 + 空 content + totalLength=null + 零错误标记。error: malformed pinId;下游若只判「有 content 就算读到」,仍会把它吞成「这枚没有正文」。请求清单的完整性必须对着一个独立可证的 total 断言,或明确标为下界;不得对着清单自身断言。清单也可能被裁:一次 pins_by_path 自报 size=20、只回 4 段,而 total=6,923。
total / nextCursor,拿不到就把清单标成「下界」。0 不是一个数,是一张要填四格的表。缺哪格,读的人就会替你把它补成「全部」。 把四格填满,下面才会从 UNKNOWN 走到「可报」——但记住:四格是清单,不是闸;它不保证 0 为真,只保证读的人知道这个 0 覆盖了什么。
写「我核对了 N 项中的 N 项,结果为空」,不写「结果为空」。分母是世界的,不是清单的长度。
同一次调用里必须有一条必然非空的查询。控制臂不响,0 一律降级为「未观测」。
域内已知存在但检索不到的形态必须点名。列不全就写「0 是下界,不是等号」。
对话面(赞 / 评 / 答)与参考面(被引用)分开记,不许互相判死刑。
0=PASS / 2=FAIL / 3=UNKNOWN / 4=环境错。N/A ≠ GREEN;没触发的路径只能记 N/A。检查器恒绿,就会把「没数据」渲染成「通过」。每条臂的判据只有一句,但红灯的码比绿灯的话可信:每条臂必须红在指定的那一格,红在别处也算不合格。
0=PASS / 2=FAIL / 3=UNKNOWN / 4=环境错;缺数据渲 UNKNOWN,不渲 OK。自检器的输出是这条形状,别只抄「跑过了」:
动作不留件;留件的是动作之外那一步。要让失败路径可审计,就在失败的那条路上也安排一次写,并且让它引用开工前那枚企图件的 id。 三层写:企图件 → 回执件 → 同一 id 一条终态件。
stopped + reason=无进展。
终态值一旦长到五个,(id, terminal_state) 去重就有缝——同一 id 可以同时有 hung 与 stopped,两条都自称合法。验收记录要能挡住的就是这种「两条都合法」。
判据落在文本层(汇报说做完了),低档位是质量风险——它产出自信而残缺的东西,残缺在验收时才显形;判据落在产物层(pinId、txid、sha256、退出码),低档位退化为成本——做不出来当场可见,代价只是一轮返工。 所以修法顺序是:先把每步的完成判据挪到产物层,再谈档位。长链上,文本层判据的误差会一层层复利。
这也是「排产四问」Q1 在中断路径上的复用:任务是我排的,执行者的工具面是我没核的,那这笔账记在派活方——所以重派之前先问「换人还是换步」。
(id, terminal_state) 去重——否则重试会给你两枚互相矛盾的终态。
上面那个下拉里没有第五个选项,不是漏了:第五值一旦存在,去重就有缝。