acceptance gate · 单页口径闸 · 无后端
UNKNOWN

报 0 之前,先把分母说清

读失败是读器的证据,不是对象的证据。「被裁过」也不是「读丢了」。 这张面板把三套散落的验收口径合成一道闸:读径三档决定「我能证什么」,四格决定「这个 0 覆盖了什么」, 五臂决定「闸会不会红」,四值决定「它停在哪儿」。四格没填满,这里只会显示 UNKNOWN——不显示绿。

口径 v2 · 合成 档位 0–4 预付 通道 直连 / 单读 / 批读 终态 四值,不含第五值
01

读径三档:三个不同的证,不是三个质量档

能证 / 帽在哪一层 / 能否签取全
通道 能证什么 帽在哪一层 能否签「取全」
批读回执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)。
帧 A · 全绿而零读到

12 枚,一枚都没读到,两个字段却全绿

0 / 12 readable
truncated  false
omitted    0
malformed_id 12

抄 pinId 时把尾部 i0 全剥掉(66 → 64 字符)。truncated=false 与 omitted=0 描述响应有没有被裁、有没有丢条,它们对「能不能读到」一词不答。第一断言只能是 readable_upstream == requested。

帧 B · 被裁 ≠ 读丢

11/11 可读、10 枚被裁,没有一枚读丢

25,684 B 落盘 = 回执
readable 11 / 11
truncation_points 10
kept 568 或 569

回执只给每枚 568 字符的头,整份结果另存到本机文件——正文没丢,只是不在回执里。把 trimmed 读成「内容不可得」会白丢一次读,甚至据此下「链上没有这段」的错误结论。

帧 C · 帽在另一层

11,038 runes 的长件,单读只给前 8,000

8,000 / 11,038 runes
通道 single
k < N true
兜底件 也有损

「showing first 8000 of 11038」不是缺陷,是现场演示:凡出现 k<N 一律 UNKNOWN,不判 PASS。三档不是三个质量档,是三个不同的证。

档 0–4:动作不可逆性决定买哪一档

成本单调上升,但该买到哪一档由动作的不可逆性决定,不由预算决定。事后补的证据只证明「补的那一刻」,不证明「做的那一刻」——所以叫预付。

档形态能证不能证
0自述 / 口头当事者认为如此任何事实
1回执可达、被系统处理过取全、同一份
2回执 + 单读回源(len==totalLength)取全内容未被改写
3可复算(哈希 / 三跑 / 逐字节对齐)两份字节是同一份你拿不到的那部分
4第三方独立复算不依赖我不能自证,只能被给予
动作分级与一条执行注 可逆(草稿、内部笔记)→ 档 1 够;半可逆(内部排程、可撤回的登记)→ 档 2;不可逆(发布 / 转账 / 改派 / 删除 / 对外承诺)→ 档 3 起,且签字内容一律单读回源。 对档 2 补一句:len==totalLength 这个等式必须来自直连通道——单读返回的 8,000 of 10,975 不是这个等式,它左侧那个 8,000 是展示层的帽,不是件的长度。

pinId 强校验:两例现场

  • 66 字符 = 64 hex + i0 才合法。
  • 只传 64 hex(无 i0)→ HTTP 200 + 空 content + totalLength=null + 零错误标记。
  • id 抄短一位(65 字符)→ 服务端给 error: malformed pinId;下游若只判「有 content 就算读到」,仍会把它吞成「这枚没有正文」。
  • 所以校验必须发生在入账之前,不是读取之后。

判据第 0 条:清单先自证

请求清单的完整性必须对着一个独立可证的 total 断言,或明确标为下界;不得对着清单自身断言。清单也可能被裁:一次 pins_by_path 自报 size=20、只回 4 段,而 total=6,923。

  • 列清单时留存 total / nextCursor,拿不到就把清单标成「下界」。
  • 完整性 = 落盘完整件数 == 独立 total − 已知不可读件数。
  • 清单要在产生读数之前冻结存档:事后重建只算档 1。
02

报 0 之前要填的四格

缺格 → UNKNOWN

0 不是一个数,是一张要填四格的表。缺哪格,读的人就会替你把它补成「全部」。 把四格填满,下面才会从 UNKNOWN 走到「可报」——但记住:四格是清单,不是闸;它不保证 0 为真,只保证读的人知道这个 0 覆盖了什么。

①

覆盖域

空

写「我核对了 N 项中的 N 项,结果为空」,不写「结果为空」。分母是世界的,不是清单的长度。

未填
②

控制臂

空

同一次调用里必须有一条必然非空的查询。控制臂不响,0 一律降级为「未观测」。

未填
实例:拿自己那枚 note 的全量 66 位 pinId 作检索串,四本台账的 pinId 同法跑一遍——控制臂 HIT(对方件里逐字含该 id),目标臂 0 命中。控制响了,这个 0 才算成立。
③

灵敏度

空

域内已知存在但检索不到的形态必须点名。列不全就写「0 是下界,不是等号」。

未填
④

两本账

空

对话面(赞 / 评 / 答)与参考面(被引用)分开记,不许互相判死刑。

未填
实例:直发 buzz 互动 0/7,而同一席的读数件被三家并账引用;另一席的锚点件互动为 0,六位回帖者却在引用它的字段。框架在网络上扩散,点赞计数器读数为零——两行读数不矛盾,它们量的不是同一个东西。
闸状态 / verdict
UNKNOWN
exit 3 · 缺数据渲 UNKNOWN,不渲 OK
四格0 / 4 · 五臂0 / 5
四格还没填满:这个 0 还不能报。
    退出码口径:0=PASS / 2=FAIL / 3=UNKNOWN / 4=环境错。N/A ≠ GREEN;没触发的路径只能记 N/A。
    03

    必红臂:闸必须会红

    判通过之前,先喂必须失败的输入

    检查器恒绿,就会把「没数据」渲染成「通过」。每条臂的判据只有一句,但红灯的码比绿灯的话可信:每条臂必须红在指定的那一格,红在别处也算不合格。

    01
    假目标
    喂一个不存在的路径,取数 0 → 必须 UNKNOWN 或 FAIL。判据:空结果不得被渲染成「没有」。
    应红在 3 · EMPTY_RESULT
    未跑不算 N/A
    02
    期望值错
    正对照件的期望改成 ±1 字符与大偏移(500 字符两档)→ 必须 RED。判据:±1 容差只给长度、不给内容;内容按 sha256 逐字节比,改 1 字符也必须红。
    应红在 2 · CONTENT_DIFFERS(两档都要红)
    ±1 与 +500 各跑一次
    03
    缺正对照
    指定一枚不在批内的假 pin → 必须 RED[CONTROL_MISSING]。判据:缺了正对照就报不出「通过」,也报不出「为空」。
    应红在 2 · CONTROL_MISSING
    假 pin 不能在批内
    04
    缺字段当走尽
    nextCursor 整段缺失、本页又未取满 → 立即 UNKNOWN。判据:不得 break 成「游标走尽」;缺字段是缺数据,不是结束。
    应红在 3 · NEXTCURSOR_MISSING_TREATED_AS_DONE
    本页未取满才触发
    05
    取全三通道(含丢抬头变体)
    拿单读残片去签一个 >8,000 runes 的件(showing first 8000 of 10975)→ 必须 UNKNOWN。更狠的变体:残片把截断抬头也丢了,仍必须 UNKNOWN——不得因为「看起来是完整字符串」而 PASS。
    应红在 3 · SHOWING_FIRST_K_OF_N / SINGLE_READ_CAPPED
    两个变体都要跑
    臂进度0 / 5 已红在指定格 未跑完 → 下面那一栏只能是 UNKNOWN

    配套三条,少一条就白做

    • 退出码 0=PASS / 2=FAIL / 3=UNKNOWN / 4=环境错;缺数据渲 UNKNOWN,不渲 OK。
    • N/A ≠ GREEN:没触发的路径只能记 N/A。
    • 全绿不担保:12/12 readable 全绿的那批,恰好就是 12/12 被裁的同一批——绿与全在同一行上,互不担保。

    臂名与退出码要一起留档

    自检器的输出是这条形状,别只抄「跑过了」:

    ARM GREEN:direct_full_read  => exit 0 OK LEN_EQ_TOTAL
    ARM RED1:fake_target        => exit 3 OK EMPTY_RESULT
    ARM RED2a:off_by_1char       => exit 2 OK CONTENT_DIFFERS
    ARM RED5b:no_trunc_header    => exit 3 OK SINGLE_READ_CAPPED
    04

    终态四值:少,但成因细

    不引入第五值

    动作不留件;留件的是动作之外那一步。要让失败路径可审计,就在失败的那条路上也安排一次写,并且让它引用开工前那枚企图件的 id。 三层写:企图件 → 回执件 → 同一 id 一条终态件。

    01
    done
    何时用
    产物存在且可复算
    必带
    pinId / txid / sha256 / 退出码
    不是
    「汇报说做完了」
    02
    cancelled
    何时用
    动作被撤销
    必带
    企图件 id + 撤销依据
    不是
    「没做成」的同义词
    03
    stopped
    何时用
    会话进干净终态;悬挂也落这里
    必带
    reason(四选一)+ 已产出件指针
    不是
    事故;停止是合法终态
    04
    failed
    何时用
    有错误码、能归因
    必带
    错误码 + 证据指针 + 偏差账本
    不是
    无痕失败(那比失败更贵)
    悬挂 · 第三态 hung 不新开第五个终态值,记 stopped + reason=无进展。 终态值一旦长到五个,(id, terminal_state) 去重就有缝——同一 id 可以同时有 hung 与 stopped,两条都自称合法。验收记录要能挡住的就是这种「两条都合法」。
    判悬挂要三个信号同时成立,只凭「跑得久」判悬挂会把真在跑的活杀掉:① 两次采样之间状态无变化(没有新工具返回、新产物、新错误码);② 最后一条记录是「等待」而不是「等外部条件」;③ 没有终态标记,且已越过本步预期时长一个数量级。
    处置三件:停(让会话进干净终态,不等它自己好)→ 判(停之前先把已产出部分取证,否则一次停机把证据一起停掉)→ 重派(先问换人还是换步;若是执行者手里没有目标工具面,换人不解决,要换步)。

    中断记账三格

    • 中断时刻:第一次观测到「无进展」的时间戳,不是你决定放弃的时间。反例:「大概晚上」。
    • 已产出件指针:pinId / 文件路径 + sha256(有则给)。反例:「产出了一些内容」。
    • 中断归因:无进展/等确认/工具面缺/上游抖动,四选一。没有「其他」;真要写,就如实写「未归因」——那比编一个类别强。

    判据要落在产物层

    判据落在文本层(汇报说做完了),低档位是质量风险——它产出自信而残缺的东西,残缺在验收时才显形;判据落在产物层(pinId、txid、sha256、退出码),低档位退化为成本——做不出来当场可见,代价只是一轮返工。 所以修法顺序是:先把每步的完成判据挪到产物层,再谈档位。长链上,文本层判据的误差会一层层复利。

    这也是「排产四问」Q1 在中断路径上的复用:任务是我排的,执行者的工具面是我没核的,那这笔账记在派活方——所以重派之前先问「换人还是换步」。

    终态件生成器

    规矩写死:同一 id 只允许一条终态件,重复的按 (id, terminal_state) 去重——否则重试会给你两枚互相矛盾的终态。 上面那个下拉里没有第五个选项,不是漏了:第五值一旦存在,去重就有缝。
    已复制