abelien-harness 0.5.0 → 0.6.0

package/skills/abelien-harness/scripts/web/redact.mjs

@@ -0,0 +1,136 @@
+// 响应正文脱敏（P2-13.03 自 hardware 移入内核）：在原文、百分号编码与 JSON 转义的各层里找出密钥，
+// 统一替换为 [redacted]。调用方决定哪些密钥要脱敏；本模块不读环境变量。
+import { createHash } from "node:crypto";
+
+// Four numbers describe a whole unchanged run or one decoded unit:
+// output start/end, original start/end. No object is allocated per character.
+function appendSpan(spans, start, end, originalStart, originalEnd) {
+  if (start === end) return;
+  const last = spans.length - 4;
+  if (last >= 0 && spans[last + 1] === start && spans[last + 3] === originalStart &&
+      spans[last + 1] - spans[last] === spans[last + 3] - spans[last + 2] &&
+      end - start === originalEnd - originalStart) {
+    spans[last + 1] = end; spans[last + 3] = originalEnd; return;
+  }
+  spans.push(start, end, originalStart, originalEnd);
+}
+function spanAt(spans, index) {
+  let low = 0, high = spans.length / 4 - 1;
+  while (low <= high) {
+    const middle = (low + high) >>> 1, offset = middle * 4;
+    if (index < spans[offset]) high = middle - 1;
+    else if (index >= spans[offset + 1]) low = middle + 1;
+    else return offset;
+  }
+  throw new Error("Redaction span missing");
+}
+function originalRange(projection, start, end) {
+  const spans = projection.spans, first = spanAt(spans, start), last = spanAt(spans, end - 1);
+  const from = spans[first + 1] - spans[first] === spans[first + 3] - spans[first + 2]
+    ? spans[first + 2] + start - spans[first] : spans[first + 2];
+  const to = spans[last + 1] - spans[last] === spans[last + 3] - spans[last + 2]
+    ? spans[last + 2] + end - spans[last] : spans[last + 3];
+  return [from, to];
+}
+function copyRange(projection, start, end, spans, output) {
+  if (start === end) return output;
+  const source = projection.spans;
+  for (let offset = spanAt(source, start); start < end; offset += 4) {
+    const stop = Math.min(end, source[offset + 1]);
+    const linear = source[offset + 1] - source[offset] === source[offset + 3] - source[offset + 2];
+    const from = linear ? source[offset + 2] + start - source[offset] : source[offset + 2];
+    const to = linear ? source[offset + 2] + stop - source[offset] : source[offset + 3];
+    appendSpan(spans, output, output + stop - start, from, to);
+    output += stop - start; start = stop;
+  }
+  return output;
+}
+function percentLayer(projection) {
+  const value = projection.value, chunks = [], spans = [];
+  let cursor = 0, output = 0, changed = false;
+  for (let index = value.indexOf("%"); index !== -1; index = value.indexOf("%", index + 1)) {
+    let encoded = "", decoded = null, size = 0;
+    // UTF-8 has at most four bytes per scalar; malformed units stay intact.
+    for (let bytes = 1; bytes <= 4; bytes++) {
+      const part = value.slice(index + (bytes - 1) * 3, index + bytes * 3);
+      if (!/^%[0-9a-f]{2}$/i.test(part)) break;
+      encoded += part;
+      try { decoded = decodeURIComponent(encoded); size = bytes * 3; break; } catch { /* Try this scalar's remaining bytes. */ }
+    }
+    if (decoded === null) continue;
+    chunks.push(value.slice(cursor, index), decoded);
+    output = copyRange(projection, cursor, index, spans, output);
+    const [from, to] = originalRange(projection, index, index + size);
+    appendSpan(spans, output, output + decoded.length, from, to); output += decoded.length;
+    cursor = index + size; index = cursor - 1; changed = true;
+  }
+  if (!changed) return null;
+  chunks.push(value.slice(cursor)); copyRange(projection, cursor, value.length, spans, output);
+  return { value: chunks.join(""), spans };
+}
+function* jsonChildren(projection) {
+  const value = projection.value, tokenPattern = /"(?:\\.|[^"\\])*"/y;
+  let coveredUntil = -1;
+  // Every possible start remains eligible, including a preceding token's closing
+  // quote. Interior escaped starts in a valid decoded child are already covered
+  // by that child's traversal; avoid materializing all of its overlapping suffixes.
+  for (let start = value.indexOf('"'); start !== -1; start = value.indexOf('"', start + 1)) {
+    if (start < coveredUntil) continue;
+    tokenPattern.lastIndex = start;
+    const match = tokenPattern.exec(value); if (!match) continue;
+    const token = match[0], end = start + token.length - 1;
+    // Removing quotes without decoding changes neither matches nor percent units.
+    // The parent already covers that identity projection.
+    if (!token.includes("\\")) continue;
+    let decoded; try { decoded = JSON.parse(token); } catch { continue; }
+    coveredUntil = end;
+    const spans = []; let cursor = start + 1, output = 0;
+    for (let escape = value.indexOf("\\", cursor); escape !== -1 && escape < end; escape = value.indexOf("\\", cursor)) {
+      output = copyRange(projection, cursor, escape, spans, output);
+      const size = value[escape + 1] === "u" ? 6 : 2;
+      const unit = JSON.parse('"' + value.slice(escape, escape + size) + '"');
+      const [from, to] = originalRange(projection, escape, escape + size);
+      appendSpan(spans, output, output + unit.length, from, to); output += unit.length;
+      cursor = escape + size;
+    }
+    copyRange(projection, cursor, end, spans, output);
+    if (decoded.length) yield { value: decoded, spans };
+  }
+}
+function identity(projection) {
+  // Fixed-size memo entries, with UTF-16 preserving even lone-surrogate spelling.
+  const spans = Float64Array.from(projection.spans);
+  return createHash("sha256").update(String(projection.value.length) + ":").update(Buffer.from(projection.value, "utf16le"))
+    .update(Buffer.from(spans.buffer)).digest("hex");
+}
+export function redact(raw, input) {
+  // Callers may pass keys in any order or include empties: a shorter key redacted first would leave a longer key's tail
+  // visible, and an empty key matches everywhere. Dedupe, drop empties and go longest first (stable, so sorted callers are unchanged).
+  const keys = [...new Set(input.filter(key => typeof key === "string" && key.length > 0))].sort((a, b) => b.length - a.length);
+  if (!keys.length) return raw;
+  if (!raw.includes("%") && !raw.includes("\\")) return keys.reduce((value, key) => value.split(key).join("[redacted]"), raw);
+  const ranges = [], seen = new Set(), stack = [{ projection: { value: raw, spans: raw.length ? [0, raw.length, 0, raw.length] : [] } }];
+  while (stack.length) {
+    const frame = stack[stack.length - 1], projection = frame.projection;
+    if (!frame.children) {
+      const memo = identity(projection); if (seen.has(memo)) { stack.pop(); continue; } seen.add(memo);
+      for (const key of keys) for (let index = projection.value.indexOf(key); index !== -1; index = projection.value.indexOf(key, index + 1)) {
+        const [start, end] = originalRange(projection, index, index + key.length); ranges.push({ start, end });
+      }
+      frame.children = jsonChildren(projection);
+    }
+    const next = frame.children.next();
+    if (!next.done) { stack.push({ projection: next.value }); continue; }
+    // A percent layer is a tail transition, releasing its finished parent instead
+    // of retaining an eager queue of full bodies. JSON children are visited lazily.
+    const percent = percentLayer(projection); stack.pop(); if (percent) stack.push({ projection: percent });
+  }
+  let result = "", start = 0, end = 0;
+  for (const range of ranges.sort((a, b) => a.start - b.start || b.end - a.end)) {
+    if (range.start < end) { end = Math.max(end, range.end); continue; }
+    if (end > start) { result += "[redacted]"; start = end; }
+    result += raw.slice(start, range.start); start = range.start; end = range.end;
+  }
+  if (end > start) { result += "[redacted]"; start = end; }
+  return result + raw.slice(start);
+}

package/skills/abelien-harness/scripts/web/volc.mjs

@@ -0,0 +1,49 @@
+// Volc 联网搜索客户端（P2-13.03 自 hardware 移入内核）：凭据只取受信宿主环境变量 WEB_SEARCH_API_KEY，
+// 原文先脱敏再保存、计算摘要，失败按「确定拒绝 / 结果未知」区分。错误码与脱敏函数由调用方绑定。
+import { failure, text, timed, sha256, digest } from "./common.mjs";
+
+// The receipt request_id rule; hardware verification imports this so writer and verifier cannot drift.
+export const volcRequestId = response => { const id = response?.ResponseMetadata?.RequestId; return text(id) ? id : null; };
+export const validVolcResult = response => text(response?.ResponseMetadata?.RequestId) && !response.ResponseMetadata.Error && response.success !== false && Array.isArray(response.Result?.WebResults);
+
+/**
+ * codes：capability / config / provider / auth / rateLimit / response / transport / timeout；
+ * ownsError(error) 判断错误是否已是本域的码（是则原样抛出，否则记为 transport 结果未知）；
+ * redact(raw, env) 在保存前去掉凭据；timeoutMessage 为超时错误的文本。
+ */
+export function createVolcSearch({ codes, ownsError, redact, timeoutMessage }) {
+  for (const key of ["capability", "config", "provider", "auth", "rateLimit", "response", "transport", "timeout"]) if (typeof codes?.[key] !== "string" || !codes[key]) throw new Error(`volc search code ${key} required`);
+  if (typeof ownsError !== "function" || typeof redact !== "function") throw new Error("volc search ownsError and redact required");
+  // Plans cap count at 5 (P2-05.02). Evidence saved by <=0.4.0 used the old default of 10;
+  // receipt validation still accepts that frozen shape.
+  const volcMaxCount = 5;
+  const volcBody = (item, count) => ({ Query: item.query, SearchType: "web", Count: count, Filter: { NeedUrl: true, NeedContent: false }, ContentFormats: "markdown", QueryControl: { QueryRewrite: false } });
+  const volcQueryRequest = item => volcBody(item, item.count ?? volcMaxCount);
+  const legacyVolcQueryRequest = item => volcBody(item, item.count ?? 10);
+  function validateVolcCapability(body) {
+    if (!text(body.Query) || !Number.isSafeInteger(body.Count) || body.Count < 1 || body.Count > 50) throw failure(codes.capability, "Volc Query must be nonempty and Count 1–50; original input is retained without truncation");
+  }
+  async function volcWebSearch(body, { env, fetchImpl = fetch, timeoutMs }) {
+    validateVolcCapability(body);
+    const key = env.WEB_SEARCH_API_KEY;
+    if (!text(key) || /[\r\n\0]/.test(key)) throw failure(codes.config, "WEB_SEARCH_API_KEY is required from the trusted host");
+    try {
+      return await timed(async signal => {
+        const response = await fetchImpl("https://open.feedcoopapi.com/search_api/web_search", { method: "POST", redirect: "error", signal, headers: { Authorization: `Bearer ${key}`, "Content-Type": "application/json" }, body: JSON.stringify(body) });
+        const raw = redact(await response.text(), env), saved = { raw, raw_sha256: sha256(raw), response: null, response_sha256: null, request_id: null, http_status: response.status, received_at: new Date().toISOString() };
+        try {
+          saved.response = JSON.parse(raw); saved.response_sha256 = digest(saved.response);
+          saved.request_id = volcRequestId(saved.response);
+        } catch { /* Keep full received text. */ }
+        const reject = (code, message, unknown = false) => { const error = failure(code, message, { http_status: response.status }); Object.defineProperties(error, { providerEvidence: { value: saved }, ambiguous: { value: unknown } }); throw error; };
+        if (response.status >= 500) reject(codes.provider, "Volc server outcome is unknown", true);
+        if (response.status < 200 || response.status >= 300) reject([401, 403].includes(response.status) ? codes.auth : response.status === 429 ? codes.rateLimit : codes.provider, "Volc HTTP request rejected");
+        const error = saved.response?.ResponseMetadata?.Error;
+        if (error) reject(codes.provider, "Volc reported an explicit error", !/^(104\d\d|700429)$/.test(String(error.Code ?? error.CodeN)));
+        if (!validVolcResult(saved.response)) reject(codes.response, "Volc result is malformed or ambiguous", true);
+        return saved;
+      }, timeoutMs, codes.timeout, timeoutMessage);
+    } catch (error) { if (ownsError(error)) throw error; throw failure(codes.transport, "Volc transport outcome is unknown"); }
+  }
+  return { volcMaxCount, volcQueryRequest, legacyVolcQueryRequest, validateVolcCapability, volcWebSearch };
+}

package/skills/abelien-reference/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: abelien-reference
+description: Abelien 参考研究：为「还原现成产品」「创造新产品」「基于现成产品修改」三种意图收集并核验参考证据——识别产品型号、取得逆向资料（规格、拆解）、检索相似产品，抓取页面主图并测量用户原图的轮廓比例，产出可直接展示在画布网格的 reference-evidence。用于意图判定之后、外观与选型之前；不做选型、外观编辑或结构建模。
+license: MIT
+compatibility:
+  - claude-code
+  - hermes
+  - pi
+---
+
+# Abelien Reference
+
+本包把「这是什么产品、有哪些可借鉴的东西」变成有来源、可核验的证据。收集由确定性代码完成，判断由 Agent 完成，判断再经确定性检查核验后才生效。意图的语义由 clarify 判定，调度由 guide 负责；本包不维护作品状态，结果交回 workspace，由宿主展示。
+
+## 何时调用
+
+- **还原现成产品（restore）与基于现成产品修改（modify）**：在需求登记之后、首张外观图之前调用，先识别产品，再取得规格与拆解资料。
+- **创造新产品（create）**：在概念图之前调用，检索相似产品，作为尺寸、结构、器件和实现方式的参考。
+- 首版之前不向用户提问：识别不确定时，按最可能的候选继续，同时保留其他候选；用户切换候选视为一次需求修订。
+
+## 流程
+
+1. **制定检索计划**：依据用户原话和 clarify 的意图判定，写出最多 6 条英文或中文检索，每条注明用途：`identify` 识别、`teardown` 逆向资料、`similar` 相似产品。用户给了链接时，链接优先读取。
+2. **收集**：调用 `reference.research`。它执行 Volc 检索（每条最多 5 个结果）、对公开 HTTPS 页面做安全直读、抓取页面主图、测量用户原图（PNG）的轮廓高宽比，然后把证据保存为 `reference-evidence`（status=collected）。同一请求重复调用直接返回已有结果，不会重复产生检索费用。
+3. **阅读证据并判断**：用 `ab resource get` 读取收集结果，用页面摘录（`excerpt`）和正文判断：哪个候选最可能是用户要的产品、它的尺寸是多少；哪些相似产品可以借用、借用什么、为什么、哪些不照搬；哪些条目应排除。
+4. **核验**：调用 `reference.finalize` 提交判断，生成 status=final 的结果：
+   - 引用必须逐字出现在已保存的页面正文中；
+   - 尺寸数字必须出现在引用里；
+   - 比例判定由测量值和规格计算得出，不能由 Agent 自填。
+   
+   所选候选比例不符时，结果会写明冲突，不会被隐藏。
+5. **交回**：final 结果的 `items` 就是画布网格的格子，`unknowns` 是需要如实展示的缺口。宿主展示的是证据，不是作品已确认。
+
+## 调用
+
+```bash
+AB=<仓库根>/skills/abelien-harness/scripts/ab.mjs
+node "$AB" --workdir <作品目录> capability run reference.research --input-file research-input.json
+node "$AB" --workdir <作品目录> resource get reference-evidence:<id>
+node "$AB" --workdir <作品目录> capability run reference.finalize --input-file judgement.json
+```
+
+参考图（base64 PNG）会超过命令行长度限制，所以输入用 `--input-file` 传入，文件必须放在作品目录内。宿主负责把 JPEG、WebP 等格式先转成 PNG，本包只解码 PNG。字段、上限、错误码和判定规则见[参考研究契约](references/research-contract.md)；数据格式见 `schemas/reference-evidence.v1.json`，样例见 `fixtures/`。
+
+## 边界
+
+- **不编造**：读不到的页面、打不开的链接、测量不了的图片，一律记为不可用或未知，并写入 `unknowns`；其他检索照常继续。
+- **第三方图片只作参考**：保存时附带来源和哈希，不进入图鉴、不进入公开分享，也不当作作品资产。
+- **找不到完整的相似产品时**，按声学、供电、交互等子系统分别参考，不硬凑数量。
+- **来源产品的功能不等于本次要实现的功能**：还原时，功能按目标深度由 clarify 写入候选需求。
+- **职责分界**：选型、外观编辑与结构建模分别由 hardware、appearance、structure 负责。来源 BOM 研究可以消费本包的证据，但 hardware 负责原件与候选件的对照。

package/skills/abelien-reference/domain.json

@@ -0,0 +1,92 @@
+{
+  "name": "abelien-reference",
+  "version": "0.1.0",
+  "description": "参考研究域包：按 Agent 的检索计划收集产品识别、逆向资料与相似产品证据（检索、公开页面、主图、用户原图测量），再核验 Agent 的判断，产出 reference-evidence v1；判定码来自确定性检查",
+  "requires": [
+    "abelien-harness"
+  ],
+  "resources": [
+    "reference-evidence"
+  ],
+  "capabilities": {
+    "reference.research": {
+      "description": "执行检索计划并保存证据：Volc 检索（每次最多 5 条）、公开 HTTPS 页面安全直读、页面主图抓取、用户原图轮廓测量；同一请求重复运行直接返回已有结果",
+      "adapter": {
+        "type": "module",
+        "path": "scripts/research.mjs",
+        "export": "researchReference"
+      },
+      "input": {
+        "from": "input"
+      },
+      "resultContract": {
+        "nonEmptyStrings": [
+          "id",
+          "status",
+          "schema",
+          "request_digest"
+        ],
+        "arrays": [
+          "searches",
+          "pages",
+          "images",
+          "items",
+          "unknowns"
+        ],
+        "statusValues": [
+          "collected"
+        ]
+      },
+      "produces": "reference-evidence",
+      "checkpoint": true,
+      "checkpointContract": {
+        "nonEmptyStrings": [
+          "id",
+          "status",
+          "schema",
+          "request_digest"
+        ],
+        "arrays": [
+          "searches",
+          "pages",
+          "images",
+          "items",
+          "unknowns"
+        ],
+        "statusValues": [
+          "collected"
+        ]
+      }
+    },
+    "reference.finalize": {
+      "description": "核验 Agent 对已收集证据的识别、相似产品与排除判断：引用须逐字出现在已保存页面，尺寸数字须在引用中，比例判定由测量确定性计算",
+      "adapter": {
+        "type": "module",
+        "path": "scripts/finalize.mjs",
+        "export": "finalizeReference"
+      },
+      "input": {
+        "from": "input"
+      },
+      "resultContract": {
+        "nonEmptyStrings": [
+          "id",
+          "status",
+          "schema",
+          "collected_id"
+        ],
+        "arrays": [
+          "items",
+          "similar",
+          "unknowns"
+        ],
+        "statusValues": [
+          "final"
+        ]
+      },
+      "produces": "reference-evidence"
+    }
+  },
+  "machines": {},
+  "adapters": {}
+}

package/skills/abelien-reference/fixtures/create.final.json

@@ -0,0 +1,102 @@
+{
+  "budget": {
+    "images": 0,
+    "pages": 1,
+    "queries": 1
+  },
+  "changeable": [
+    "外形",
+    "尺寸"
+  ],
+  "depth": null,
+  "id": "ref-c26edd6284aed5b5-f89f84f29",
+  "images": [],
+  "intent": "create",
+  "items": [
+    {
+      "id": "u1",
+      "image": null,
+      "kind": "user_input",
+      "query": null,
+      "role": "做一个放在床头、能讲睡前故事的小音箱",
+      "source": null,
+      "status": "ready",
+      "title": "你的输入",
+      "verdict": null
+    },
+    {
+      "id": "p1",
+      "image": null,
+      "kind": "similar",
+      "query": "bedside story speaker teardown",
+      "role": "相似产品",
+      "source": {
+        "site": "shop.example.com",
+        "url": "https://shop.example.com/story-a"
+      },
+      "status": "ready",
+      "title": "床头故事机 A",
+      "verdict": {
+        "code": "borrowed",
+        "basis": "借用：300 mL 声腔与 40 mm 全频喇叭；原因：体积与床头摆放相近；不照搬：外观与按键布局"
+      }
+    }
+  ],
+  "keep": [],
+  "pages": [
+    {
+      "excerpt": "床头故事机 A 腔体容积 300 mL，40 mm 全频喇叭，电池 2000 mAh。",
+      "final_url": "https://shop.example.com/story-a",
+      "id": "p1",
+      "image_url": null,
+      "purpose": "similar",
+      "raw_sha256": "db701b787482d7ae3c2967323df3013d93df7c7e628a801ab091218f55a1b87d",
+      "reason": null,
+      "search_id": "s1",
+      "status": "read",
+      "text_blob_ref": "sha256:a871926ca4bf9606ff9abc75f7b5da5a99a41c7535f03e9572095b1a272b32bc",
+      "text_sha256": "58a51339bbda6d0a69d726e2768faf47752f8529630a4705e5fe81552e187dff",
+      "title": "床头故事机 A",
+      "url": "https://shop.example.com/story-a"
+    }
+  ],
+  "request_digest": "c26edd6284aed5b521396a1093bc0aeb9ff60d24f2c68d6bcf98a6529bd9c325",
+  "schema": "abelien.reference-evidence.v1",
+  "searches": [
+    {
+      "count": 3,
+      "error_code": null,
+      "id": "s1",
+      "purpose": "similar",
+      "query": "bedside story speaker teardown",
+      "receipt_sha256": "b4f07afb377bbf9556aef08b61cebb2bf0264df8924f91b712227186cd7157bc",
+      "request_id": "req-[redacted]",
+      "results": [
+        {
+          "rank": 1,
+          "snippet": "",
+          "title": "Story box A",
+          "url": "https://shop.example.com/story-a"
+        }
+      ],
+      "status": "completed"
+    }
+  ],
+  "status": "final",
+  "text": "做一个放在床头、能讲睡前故事的小音箱",
+  "unknowns": [],
+  "user_image": null,
+  "collected_id": "ref-c26edd6284aed5b5",
+  "judgement_digest": "89f84f293a6781fed8f80ea7f03d57da892c67f70bfdd836003421f88b2b0730",
+  "identity": null,
+  "similar": [
+    {
+      "item_id": "p1",
+      "decision": "borrow",
+      "borrowed": "300 mL 声腔与 40 mm 全频喇叭",
+      "why": "体积与床头摆放相近",
+      "not_copied": "外观与按键布局"
+    }
+  ],
+  "spec_quotes": []
+}

package/skills/abelien-reference/fixtures/restore.collected.json

@@ -0,0 +1,189 @@
+{
+  "id": "ref-40ece5312c4ecbf6",
+  "schema": "abelien.reference-evidence.v1",
+  "status": "collected",
+  "request_digest": "40ece5312c4ecbf6f5548d36589de25734706b8a333d22e1a3c32adeb75e09f5",
+  "intent": "restore",
+  "keep": [
+    "外形尺寸与比例"
+  ],
+  "changeable": [],
+  "depth": "assembly",
+  "text": "帮我根据图片还原小爱音箱",
+  "user_image": {
+    "blob_ref": "sha256:e2273b5b355a38441b20796072e08921b9ab30c4f37bb92070a53307af34a6f6",
+    "sha256": "da0fadd6fd3ab5ccfbac94ca4e3f2b48e440987eee6834f1c30f04c02abd5d11",
+    "media_type": "image/png",
+    "measurement": {
+      "status": "measured",
+      "method": "silhouette-v1",
+      "image": {
+        "width": 400,
+        "height": 600
+      },
+      "bbox": {
+        "x": 62,
+        "y": 49,
+        "width": 276,
+        "height": 502
+      },
+      "aspect_h_over_w": 1.8188,
+      "background": {
+        "mode": "color",
+        "rgb": [
+          255,
+          255,
+          255
+        ]
+      }
+    }
+  },
+  "searches": [
+    {
+      "id": "s1",
+      "purpose": "identify",
+      "query": "Xiaomi XiaoAI speaker Pro dimensions",
+      "count": 5,
+      "status": "completed",
+      "error_code": null,
+      "request_id": "req-[redacted]",
+      "receipt_sha256": "099206543e4389fde6c4838d3fc0b125dce0fb98cd57384db3062e1abcede7a8",
+      "results": [
+        {
+          "rank": 1,
+          "url": "https://www.mi.example.com/pro/specs",
+          "title": "XiaoAI Speaker Pro",
+          "snippet": ""
+        },
+        {
+          "rank": 2,
+          "url": "https://www.mi.example.com/gen1/specs",
+          "title": "Mi AI Speaker",
+          "snippet": ""
+        }
+      ]
+    }
+  ],
+  "pages": [
+    {
+      "id": "p1",
+      "url": "https://www.mi.example.com/pro/specs",
+      "purpose": "identify",
+      "search_id": "s1",
+      "status": "read",
+      "reason": null,
+      "final_url": "https://www.mi.example.com/pro/specs",
+      "title": "小爱音箱 Pro 参数",
+      "raw_sha256": "109cbac90dd51ef3dddfd21c4a97168a25f097b4211b2146d21669281d06e3b8",
+      "text_blob_ref": "sha256:a9d6a6d8668de3346efe1d94c1afd76e71faf37bee5a6e55d3a82f9bc60b9bf0",
+      "text_sha256": "bae09c2d8ac69290d90e7cf69d7809858b1149a391400d40030037db41896415",
+      "excerpt": "小爱音箱 Pro 参数 产品尺寸：118 × 118 × 215 mm，重量 1187 g。",
+      "image_url": "https://img.example.com/pro.png"
+    },
+    {
+      "id": "p2",
+      "url": "https://www.mi.example.com/gen1/specs",
+      "purpose": "identify",
+      "search_id": "s1",
+      "status": "read",
+      "reason": null,
+      "final_url": "https://www.mi.example.com/gen1/specs",
+      "title": "小米AI音箱 规格",
+      "raw_sha256": "c139f165c41dc34c2cd30a816a80d7cbef9ecbda49e7496d46163c8692da33c7",
+      "text_blob_ref": "sha256:3dd43ad1e906a2e95af747cc8f8386c00b43df981af8b8bafe45bb2d173e7e3c",
+      "text_sha256": "2de9e3c9406bd62a2e9eef887fd42008382616377ac49fb751cd5a109f1e9a00",
+      "excerpt": "小米AI音箱 规格 尺寸 88 mm × 88 mm × 211.6 mm",
+      "image_url": null
+    }
+  ],
+  "images": [
+    {
+      "id": "i1",
+      "url": "https://img.example.com/pro.png",
+      "page_id": "p1",
+      "status": "read",
+      "reason": null,
+      "blob_ref": "sha256:e2273b5b355a38441b20796072e08921b9ab30c4f37bb92070a53307af34a6f6",
+      "sha256": "da0fadd6fd3ab5ccfbac94ca4e3f2b48e440987eee6834f1c30f04c02abd5d11",
+      "media_type": "image/png",
+      "measurement": {
+        "status": "measured",
+        "method": "silhouette-v1",
+        "image": {
+          "width": 400,
+          "height": 600
+        },
+        "bbox": {
+          "x": 62,
+          "y": 49,
+          "width": 276,
+          "height": 502
+        },
+        "aspect_h_over_w": 1.8188,
+        "background": {
+          "mode": "color",
+          "rgb": [
+            255,
+            255,
+            255
+          ]
+        }
+      }
+    }
+  ],
+  "items": [
+    {
+      "id": "u1",
+      "kind": "user_input",
+      "title": "你的输入",
+      "role": "帮我根据图片还原小爱音箱",
+      "source": null,
+      "image": {
+        "blob_ref": "sha256:e2273b5b355a38441b20796072e08921b9ab30c4f37bb92070a53307af34a6f6",
+        "sha256": "da0fadd6fd3ab5ccfbac94ca4e3f2b48e440987eee6834f1c30f04c02abd5d11",
+        "media_type": "image/png"
+      },
+      "verdict": null,
+      "status": "ready",
+      "query": null
+    },
+    {
+      "id": "p1",
+      "kind": "candidate",
+      "title": "小爱音箱 Pro 参数",
+      "role": "候选产品",
+      "source": {
+        "url": "https://www.mi.example.com/pro/specs",
+        "site": "www.mi.example.com"
+      },
+      "image": {
+        "blob_ref": "sha256:e2273b5b355a38441b20796072e08921b9ab30c4f37bb92070a53307af34a6f6",
+        "sha256": "da0fadd6fd3ab5ccfbac94ca4e3f2b48e440987eee6834f1c30f04c02abd5d11",
+        "media_type": "image/png"
+      },
+      "verdict": null,
+      "status": "ready",
+      "query": "Xiaomi XiaoAI speaker Pro dimensions"
+    },
+    {
+      "id": "p2",
+      "kind": "candidate",
+      "title": "小米AI音箱 规格",
+      "role": "候选产品",
+      "source": {
+        "url": "https://www.mi.example.com/gen1/specs",
+        "site": "www.mi.example.com"
+      },
+      "image": null,
+      "verdict": null,
+      "status": "ready",
+      "query": "Xiaomi XiaoAI speaker Pro dimensions"
+    }
+  ],
+  "unknowns": [],
+  "budget": {
+    "queries": 1,
+    "pages": 2,
+    "images": 1
+  }
+}