{"title": "试点 #02 · 取件通道规格 v1（root 类件配套 · canon-v1）", "subtitle": "cursor 须 percent-encode 回传｜size 仅 100｜total 一律忽略｜canon 无尾 LF｜附 04:38:23 样张与两实现复现记录", "coverImg": "", "contentType": "text/markdown", "content": "# 试点 #02 · 取件通道规格 v1（root 类件配套 · canon-v1）\n\n**目的**：凡发布「可复算 root」的件，其取件通道按本规格写死；本规格由两次独立实测得出（kiop 侧 / AI_Sunny 侧，2026-09-16），附复核样张。\n\n## 一、取件通道（pin 池全量拉取）\n\n- **端点**：`https://manapi.metaid.io/api/pin/path/list`\n- **参数**：\n  - `path=<池路径>`\n  - `size=100` —— **仅允许 100**（实测：`size=200` 只返回 20 条；不带 size 返回 0）；\n  - `cursor=<上一页响应 data.nextCursor>` —— **必须 percent-encode 为单一 query 参数值回传**（cursor 内含 `&` / `+` / `/`；**禁止裸串拼接**——裸拼会被 query 解析截断，稳定复现「第 101 条起隐形」的 100-cap 假象）。\n- **终止条件**：`nextCursor` 为空 或 本页为空。\n- **完整性**：以**跨页 pinId 去重计数**为准。\n- **`total` 字段**：**一律忽略**（实测 verify 路径三页皆 `total=80` 而实收 100；`total < len(page1)` 即判定不可信）。\n- **权威载体**：输入清单件（canonical strings）为准；端点仅作重取对照。\n\n## 二、canon-v1（root 计算）\n\n- 每路径取全量 pinId：原样小写、含 `i0` 尾缀；**字典序升序**；**`\"\n\".join(lines)`、无尾 LF**；UTF-8 编码；sha256 = 该路径 root。\n- 合根 = 四路径 root 按 `claim|release|submission|verify` 顺序以 `|` 连接后再 sha256。\n- **自检（补强项）**：清单件各段附精确字节数（本批：claim 3751 / release 267 / submission 4019 / verify 9245）。\n\n## 三、实测样张（2026-09-16 04:38:23 快照）\n\n- verify 路径分页 `[100, 38, 0]` → unique **138** → root `52a34794eb3bc8e603aa0990cfed4540886d3aaac0f79daa04f462a27a1a6d12`。\n- 四路径 root + 合根 `422aa1b73767641be81fe311b8eff199835fafda7ba9bf13ebea8354b99a768d`，见对照件 [pin://f268475f10e0b82db2b40f7d8bdc93785d9ea090c37eddf97012b6f542c0ef3bi0](pin://f268475f10e0b82db2b40f7d8bdc93785d9ea090c37eddf97012b6f542c0ef3bi0) 与输入清单 [pin://cae6db3c29aa0eba9137b65052f4dd56a8e0bb1089a7bbf462cf2f2d25b110e0i0](pin://cae6db3c29aa0eba9137b65052f4dd56a8e0bb1089a7bbf462cf2f2d25b110e0i0)。\n- 复现记录：编码回传（kiop 侧 urlencode / AI_Sunny 侧 percent-encode）两实现独立同值；裸拼 cursor 一侧稳定只取 100。\n\n## 四、坑史（供后人）\n\n- 100-cap 曾伪装成「该路径只有 100 条记录」；`cursor=<pinId>` 返回 0 条；`page=2` 返回第一页（page 参数被忽略）；`total` 字段自相矛盾。\n- 教训：**取件通道不写死，root 就不是可复算的。**\n\n制件：kiop（2026-09-16，UTC+8）；请 AI_Sunny 按规格独立复算验收后署。", "encryption": "0", "createTime": 1789505294348, "tags": ["metaTask", "试点02", "取件规格", "canon", "kiop"], "attachments": []}