Files
Cyrene_v2/Docs
AskaEth c3339a5d07
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
docs(api): 契约 v0.61 —— 登记 .pdf 文本层与成对嗅探裁决(修 B1 落地后的契约漂移)
- 漂移:B1(f82c76d)把白名单 22→23 项、嗅探改为 (扩展名, 嗅探) 成对裁决,而 Docs 仍写「22 项 / 仅放行 text/plain」。本切片只改 Docs 两个文件把口径改准。

- 登记要点:白名单 23 项(22 文本+ .pdf);成对裁决双向拒(HTML/文本改名 .pdf ⇒ 415;PDF 改名 .txt ⇒ 415);读侧真 PDF 下发 application/pdf 但仍 attachment+nosniff(不可内联);文本层抽正文、扫描件诚实拒绝(unreadable,文案含「需要 OCR,当前未做」)、加密/损坏可区分;安全阀 5000 页 / sidecar 8 MiB;ExtractorVersion documents/v3 ⇒ 旧 sidecar 一次性重抽(客户端可观察 chars/truncated 重算)。三档标注:行为变更(.pdf 从 415 变为可上传可读 + 裁决收紧)+ 纯增量(第 23 项)。

- 未发明任何未实现行为:OCR / PDF 写 / Office 明确写「未做」;v0.59 历史条目里的「22」加注「⚠️ 历史值;v0.61 起为 23 项」。

- 主会话复核:grep 22 项 仅剩历史 changelog 一处且已标注;v0.61 在 api-client 12 处、api-reference 13 处;给出「项 → 文档位置 → 代码证据(文件:行)」对照表逐条核对。

- 子代理如实报告的结构隐患(已登记):api-client 有**两套平行变更记录**(§1.2 末的大块 + §5 列表)易再漂移;api-reference 无自己的版本条目节。
2026-10-04 19:51:12 +08:00
..