@icen.ai/ui 0.8.0 → 0.9.0

package/dist/behaviors/kb-retrieval.mjs

@@ -0,0 +1,746 @@
+// src/behaviors/ai-core.ts
+var svg = (body) => `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${body}</svg>`;
+var ICON_TERMINAL = svg('<path d="m4 17 6-6-6-6"/><path d="M12 19h8"/>');
+var ICON_FILE = svg(
+  '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/>'
+);
+var ICON_FILE_PEN = svg(
+  '<path d="M12.5 22H6a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8l5 5v3.5"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M19 6.5 16.5 4"/><path d="M21.378 16.626a1 1 0 0 0-3.004-3.004l-4.01 4.012a2 2 0 0 0-.506.854l-.837 2.87a.5.5 0 0 0 .62.62l2.87-.837a2 2 0 0 0 .854-.506z"/>'
+);
+var ICON_FILE_PLUS = svg(
+  '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M9 15h6"/><path d="M12 12v6"/>'
+);
+var ICON_TRASH = svg(
+  '<path d="M3 6h18"/><path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6"/><path d="M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"/><path d="M10 11v6"/><path d="M14 11v6"/>'
+);
+var ICON_SEARCH = svg('<circle cx="11" cy="11" r="8"/><path d="m21 21-4.3-4.3"/>');
+var ICON_FOLDER_SEARCH = svg(
+  '<path d="M11 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v4"/><circle cx="17" cy="17" r="3"/><path d="m21 21-1.9-1.9"/>'
+);
+var ICON_SCAN_SEARCH = svg(
+  '<path d="M3 7V5a2 2 0 0 1 2-2h2"/><path d="M17 3h2a2 2 0 0 1 2 2v2"/><path d="M21 17v2a2 2 0 0 1-2 2h-2"/><path d="M7 21H5a2 2 0 0 1-2-2v-2"/><circle cx="12" cy="12" r="3"/><path d="m16 16-1.9-1.9"/>'
+);
+var ICON_GLOBE = svg(
+  '<circle cx="12" cy="12" r="10"/><path d="M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20"/><path d="M2 12h20"/>'
+);
+var ICON_DOWNLOAD = svg(
+  '<path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><path d="m7 10 5 5 5-5"/><path d="M12 15V3"/>'
+);
+var ICON_BLOCKS = svg(
+  '<rect width="7" height="7" x="4" y="4" rx="1"/><rect width="7" height="7" x="13" y="4" rx="1"/><rect width="7" height="7" x="4" y="13" rx="1"/><rect width="7" height="7" x="13" y="13" rx="1"/>'
+);
+var ICON_ZAP = svg(
+  '<path d="M4 14a1 1 0 0 1-.78-1.63l9.9-10.2a.5.5 0 0 1 .86.46l-1.92 6.02A1 1 0 0 0 13 10h7a1 1 0 0 1 .78 1.63l-9.9 10.2a.5.5 0 0 1-.86-.46l1.92-6.02A1 1 0 0 0 11 14z"/>'
+);
+var ICON_LIST = svg(
+  '<path d="M3 12h.01"/><path d="M3 18h.01"/><path d="M3 6h.01"/><path d="M8 12h13"/><path d="M8 18h13"/><path d="M8 6h13"/>'
+);
+var ICON_LIST_CHECKS = svg(
+  '<path d="m3 17 2 2 4-4"/><path d="m3 7 2 2 4-4"/><path d="M13 6h8"/><path d="M13 12h8"/><path d="M13 18h8"/>'
+);
+var ICON_BOT = svg(
+  '<path d="M12 8V4H8"/><rect width="16" height="12" x="4" y="8" rx="2"/><path d="M2 14h2"/><path d="M20 14h2"/><path d="M15 13v2"/><path d="M9 13v2"/>'
+);
+var ICON_CHART = svg(
+  '<path d="M3 3v18h18"/><path d="M7 15l4-6 3 4 5-8"/>'
+);
+var ICON_FILE_TEXT = svg(
+  '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M10 9H8"/><path d="M16 13H8"/><path d="M16 17H8"/>'
+);
+function isObj(v) {
+  return typeof v === "object" && v !== null;
+}
+function pickStr(input, keys) {
+  if (!isObj(input)) return void 0;
+  for (const k of keys) {
+    const v = input[k];
+    if (typeof v === "string" && v) return v;
+  }
+  return void 0;
+}
+function pickNum(src, keys) {
+  if (!isObj(src)) return void 0;
+  for (const k of keys) {
+    const v = src[k];
+    if (typeof v === "number" && Number.isFinite(v)) return v;
+  }
+  return void 0;
+}
+function firstLine(s, max = 80) {
+  const line = s.split("\n", 1)[0]?.trim() ?? "";
+  return line.length > max ? `${line.slice(0, max)}\u2026` : line;
+}
+function filePathOf(input) {
+  return pickStr(input, ["file_path", "path", "file", "filename"]);
+}
+var summarizePath = (input) => filePathOf(input);
+function summarizeRead(input) {
+  const p = filePathOf(input);
+  if (!p) return void 0;
+  const offset = pickNum(input, ["offset", "start_line"]);
+  if (offset == null) return p;
+  const limit = pickNum(input, ["limit", "end_line"]);
+  return limit != null ? `${p}:${offset}-${offset + limit}` : `${p}:${offset}`;
+}
+function summarizeShell(input) {
+  const cmd = typeof input === "string" ? input : pickStr(input, ["command", "cmd", "script"]);
+  return cmd ? firstLine(cmd) : void 0;
+}
+function summarizeGrep(input) {
+  const pattern = pickStr(input, ["pattern", "regex", "query"]);
+  const p = filePathOf(input);
+  if (pattern) return p ? `${firstLine(pattern, 40)} \xB7 ${p}` : firstLine(pattern);
+  return p;
+}
+var sum = (fn) => {
+  return (input) => fn(input) ?? "";
+};
+var BUILTIN_KINDS = {
+  shell: { label: "\u547D\u4EE4", icon: ICON_TERMINAL, tint: "accent", summarize: sum(summarizeShell) },
+  read: { label: "\u8BFB\u53D6", icon: ICON_FILE, tint: "info", summarize: sum(summarizeRead) },
+  edit: { label: "\u7F16\u8F91", icon: ICON_FILE_PEN, tint: "warning", summarize: sum(summarizePath) },
+  write: { label: "\u5199\u5165", icon: ICON_FILE_PLUS, tint: "warning", summarize: sum(summarizePath) },
+  rm: { label: "\u5220\u9664", icon: ICON_TRASH, tint: "error", summarize: sum(summarizePath) },
+  grep: { label: "\u641C\u7D22", icon: ICON_SEARCH, tint: "info", summarize: sum(summarizeGrep) },
+  glob: { label: "\u5339\u914D", icon: ICON_FOLDER_SEARCH, tint: "info", summarize: sum((i) => pickStr(i, ["pattern", "glob", "path"])) },
+  browser: { label: "\u6D4F\u89C8", icon: ICON_GLOBE, tint: "accent", summarize: sum((i) => pickStr(i, ["url", "uri", "target"])) },
+  search: { label: "\u68C0\u7D22", icon: ICON_SCAN_SEARCH, tint: "accent", summarize: sum((i) => pickStr(i, ["query", "q", "pattern"])) },
+  fetch: { label: "\u8BF7\u6C42", icon: ICON_DOWNLOAD, tint: "info", summarize: sum((i) => pickStr(i, ["url", "uri", "endpoint"])) },
+  mcp: { label: "MCP", icon: ICON_BLOCKS, tint: "muted", summarize: sum((i) => pickStr(i, ["tool", "method", "name"])) },
+  skill: { label: "\u6280\u80FD", icon: ICON_ZAP, tint: "accent", summarize: sum((i) => pickStr(i, ["skill", "name", "command"])) },
+  todo: {
+    label: "\u5F85\u529E",
+    icon: ICON_LIST,
+    tint: "info",
+    summarize: sum((input) => {
+      const items = input && typeof input === "object" && Array.isArray(input.items) ? input.items : Array.isArray(input) ? input : [];
+      const done = items.filter((it) => it?.status === "done").length;
+      return items.length > 0 ? `${done}/${items.length} \u5B8C\u6210` : "";
+    })
+  },
+  plan: { label: "\u8BA1\u5212", icon: ICON_LIST_CHECKS, tint: "info" },
+  subagent: { label: "\u5B50\u4EE3\u7406", icon: ICON_BOT, tint: "accent", summarize: sum((i) => pickStr(i, ["task", "description", "prompt", "message", "subagent_type"])) },
+  note: { label: "\u7B14\u8BB0", icon: ICON_FILE_TEXT, tint: "muted" },
+  chart: { label: "\u56FE\u8868", icon: ICON_CHART, tint: "info", summarize: sum((i) => pickStr(i, ["title", "name"])) }
+};
+var kindRegistry = new Map(Object.entries(BUILTIN_KINDS));
+function h(tag, className, text) {
+  const node = document.createElement(tag);
+  if (className) node.className = className;
+  if (text != null) node.textContent = text;
+  return node;
+}
+function svgIcon(svg2) {
+  if (typeof document === "undefined" || typeof DOMParser === "undefined") return null;
+  let parsed;
+  try {
+    parsed = new DOMParser().parseFromString(svg2, "image/svg+xml");
+  } catch {
+    return null;
+  }
+  const root = parsed.documentElement;
+  if (!root || root.tagName.toLowerCase() !== "svg" || parsed.querySelector("parsererror")) {
+    return null;
+  }
+  const sanitize = (el) => {
+    for (const attr of Array.from(el.attributes)) {
+      const name = attr.name.toLowerCase();
+      if (name.startsWith("on")) el.removeAttribute(attr.name);
+      if ((name === "href" || name === "xlink:href") && attr.value.trim().toLowerCase().startsWith("javascript:")) {
+        el.removeAttribute(attr.name);
+      }
+    }
+    for (const child of Array.from(el.children)) {
+      const tag = child.tagName.toLowerCase();
+      if (tag === "script" || tag === "foreignobject") {
+        child.remove();
+        continue;
+      }
+      sanitize(child);
+    }
+  };
+  sanitize(root);
+  return document.importNode(root, true);
+}
+
+// src/behaviors/kb-core.ts
+var ic = (label, d) => ({ label, icon: `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round">${d}</svg>` });
+var BUILTIN_SOURCE_TYPES = {
+  doc: ic("\u6587\u6863", '<path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><path d="M14 2v6h6"/>'),
+  web: ic("\u7F51\u9875", '<circle cx="12" cy="12" r="10"/><path d="M2 12h20"/><path d="M12 2a15 15 0 0 1 0 20 15 15 0 0 1 0-20z"/>'),
+  wiki: ic("\u77E5\u8BC6\u5E93", '<path d="M4 19.5A2.5 2.5 0 0 1 6.5 17H20"/><path d="M6.5 2H20v20H6.5A2.5 2.5 0 0 1 4 19.5v-15A2.5 2.5 0 0 1 6.5 2z"/>'),
+  sheet: ic("\u8868\u683C", '<rect x="3" y="3" width="18" height="18" rx="2"/><path d="M3 9h18M3 15h18M9 3v18M15 3v18"/>'),
+  db: ic("\u6570\u636E\u5E93", '<ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M3 5v14c0 1.7 4 3 9 3s9-1.3 9-3V5"/><path d="M3 12c0 1.7 4 3 9 3s9-1.3 9-3"/>'),
+  ticket: ic("\u5DE5\u5355", '<path d="M3 9V7a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v2a2 2 0 0 0 0 6v2a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-2a2 2 0 0 0 0-6z"/><path d="M13 5v14"/>'),
+  code: ic("\u4EE3\u7801", '<path d="m16 18 6-6-6-6"/><path d="m8 6-6 6 6 6"/>'),
+  api: ic("\u63A5\u53E3", '<path d="M4 7a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v3a2 2 0 0 0 0 4v3a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-3a2 2 0 0 0 0-4z"/>'),
+  image: ic("\u56FE\u7247", '<rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-4.6-4.6a2 2 0 0 0-2.8 0L3 21"/>'),
+  mail: ic("\u90AE\u4EF6", '<rect x="2" y="4" width="20" height="16" rx="2"/><path d="m22 7-10 7L2 7"/>')
+};
+var sourceTypeRegistry = new Map(Object.entries(BUILTIN_SOURCE_TYPES));
+var LOWER_IS_BETTER = /* @__PURE__ */ new Set(["l2"]);
+function scoreHigherIsBetter(kind) {
+  return kind != null && LOWER_IS_BETTER.has(kind) ? false : true;
+}
+function formatScore(v, digits = 3) {
+  if (v == null || !Number.isFinite(v)) return "\u2014";
+  return v.toFixed(digits).replace(/\.?0+$/, (s) => s.includes(".") ? "" : s);
+}
+function scorePercent(v, kind, max = 1) {
+  if (v == null || !Number.isFinite(v)) return null;
+  const pct = scoreHigherIsBetter(kind) ? v / max * 100 : (1 - v / max) * 100;
+  return Math.max(0, Math.min(100, pct));
+}
+function normalizeHit(raw) {
+  const score = typeof raw.score === "number" && Number.isFinite(raw.score) ? raw.score : null;
+  return {
+    chunkId: String(raw.chunkId ?? raw.id ?? ""),
+    documentId: typeof raw.documentId === "string" ? raw.documentId : void 0,
+    title: typeof raw.title === "string" ? raw.title : void 0,
+    snippet: String(raw.snippet ?? raw.content ?? ""),
+    score,
+    scoreKind: raw.scoreKind,
+    vectorPart: typeof raw.vectorPart === "number" ? raw.vectorPart : void 0,
+    keywordPart: typeof raw.keywordPart === "number" ? raw.keywordPart : void 0,
+    explain: typeof raw.explain === "string" ? raw.explain : void 0,
+    page: typeof raw.page === "number" ? raw.page : void 0,
+    meta: raw.meta && typeof raw.meta === "object" ? raw.meta : void 0
+  };
+}
+function normalizeRetrievalParams(raw) {
+  const r = raw ?? {};
+  return {
+    topK: typeof r.topK === "number" && r.topK > 0 ? Math.floor(r.topK) : 5,
+    mode: r.mode === "vector" || r.mode === "keyword" || r.mode === "hybrid" ? r.mode : "hybrid",
+    alpha: typeof r.alpha === "number" ? Math.max(0, Math.min(1, r.alpha)) : 0.5,
+    rerank: r.rerank === true,
+    rerankModel: typeof r.rerankModel === "string" ? r.rerankModel : void 0,
+    threshold: typeof r.threshold === "number" ? r.threshold : null
+  };
+}
+function kbVisibilityLabel(v) {
+  return v === "hidden" ? "\u4E0D\u53EF\u89C1" : v === "metadata" ? "\u4EC5\u5143\u6570\u636E" : v === "restricted" ? "\u53D7\u9650" : v === "summary" ? "\u4EC5\u6458\u8981" : "\u53EF\u89C1";
+}
+function normalizeIdentity(raw) {
+  const r = raw;
+  return {
+    user: String(r.user ?? ""),
+    groups: Array.isArray(r.groups) ? r.groups.map(String) : [],
+    label: typeof r.label === "string" ? r.label : void 0,
+    note: typeof r.note === "string" ? r.note : void 0
+  };
+}
+
+// src/behaviors/events.ts
+function emitIcen(source, type, detail) {
+  return source.dispatchEvent(
+    new CustomEvent(type, { detail, bubbles: true, composed: true, cancelable: true })
+  );
+}
+
+// src/behaviors/kb-retrieval.ts
+var MODES = [
+  ["vector", "\u5411\u91CF"],
+  ["keyword", "\u5173\u952E\u8BCD"],
+  ["hybrid", "\u6DF7\u5408"]
+];
+var TOP_K_MIN = 1;
+var TOP_K_MAX = 50;
+var HIGHLIGHT_TERM_LIMIT = 6;
+var ICON_RUN = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 4 14 8-14 8z"/></svg>';
+var ICON_COPY = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="9" y="9" width="12" height="12" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>';
+var LAYER_ORDER = ["pre", "post", "none"];
+var LAYER_LABEL = { pre: "pre \u2713", post: "post \u26A0", none: "none \u2715" };
+var LAYER_TITLE = {
+  pre: "pre-filter\uFF1AACL \u5728\u68C0\u7D22\u6267\u884C\u4F53\u5185\u751F\u6548\u2014\u2014\u5B89\u5168\u57FA\u7EBF",
+  post: "post-filter\uFF1A\u5206\u6570\u5DF2\u53EF\u89C2\u5BDF\u2014\u2014\u7F3A\u9677\u5C42\uFF0C\u4EC5\u6F14\u793A",
+  none: "none\uFF1Afail-open\uFF0C\u65E0\u8EAB\u4EFD\u8FC7\u6EE4\u8FD4\u56DE\u5168\u90E8\u2014\u2014\u5371\u9669\uFF0C\u4EC5\u6F14\u793A"
+};
+var stubHandle = () => ({
+  getParams: () => normalizeRetrievalParams(),
+  setParams: () => {
+  },
+  renderHits: () => {
+  },
+  setBusy: () => {
+  },
+  setThreshold: () => {
+  },
+  getFilterLayer: () => "pre",
+  setFilterLayer: () => {
+  },
+  destroy: () => {
+  }
+});
+function escapeRe(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function tokenizeQuery(query) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of query.trim().split(/\s+/)) {
+    const t = raw.trim();
+    if (!t || seen.has(t)) continue;
+    if (t.length < 2 && !/[\u4e00-\u9fff]/.test(t)) continue;
+    seen.add(t);
+    out.push(t);
+    if (out.length >= HIGHLIGHT_TERM_LIMIT) break;
+  }
+  return out;
+}
+function highlightTerms(text, terms) {
+  let nodes = [document.createTextNode(text)];
+  for (let ti = 0; ti < terms.length; ti++) {
+    const re = new RegExp(escapeRe(terms[ti]), "gi");
+    const next = [];
+    for (const node of nodes) {
+      if (!(node instanceof Text)) {
+        next.push(node);
+        continue;
+      }
+      const seg = node.data;
+      let last = 0;
+      let m;
+      re.lastIndex = 0;
+      while ((m = re.exec(seg)) !== null) {
+        if (m[0].length === 0) {
+          re.lastIndex++;
+          continue;
+        }
+        if (m.index > last) next.push(document.createTextNode(seg.slice(last, m.index)));
+        const mark = document.createElement("mark");
+        mark.dataset.hit = String(ti % 3);
+        mark.textContent = m[0];
+        next.push(mark);
+        last = m.index + m[0].length;
+      }
+      if (last < seg.length) next.push(document.createTextNode(seg.slice(last)));
+    }
+    nodes = next;
+  }
+  return nodes;
+}
+function copyText(text) {
+  try {
+    if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
+      void navigator.clipboard.writeText(text);
+      return true;
+    }
+    if (typeof document === "undefined") return false;
+    const ta = document.createElement("textarea");
+    ta.value = text;
+    ta.setAttribute("readonly", "");
+    ta.style.position = "fixed";
+    ta.style.opacity = "0";
+    document.body.appendChild(ta);
+    ta.select();
+    const ok = document.execCommand("copy");
+    ta.remove();
+    return ok;
+  } catch {
+    return false;
+  }
+}
+function createKbRetrieval(el, opts = {}) {
+  if (typeof document === "undefined" || !el) return stubHandle();
+  const marked = el;
+  if (marked.__icenKbRetrieval) return marked.__icenKbRetrieval;
+  const ctrl = new AbortController();
+  const listen = (target, type, fn, options) => {
+    target.addEventListener(type, fn, { ...options, signal: ctrl.signal });
+  };
+  let params = normalizeRetrievalParams(opts.params);
+  const thresholdMax = typeof opts.thresholdMax === "number" && opts.thresholdMax > 0 ? opts.thresholdMax : 1;
+  let hits = [];
+  let busy = false;
+  let destroyed = false;
+  let thresholdValue = params.threshold ?? 0;
+  let copyTimer = null;
+  let layer = opts.layer === "post" || opts.layer === "none" ? opts.layer : "pre";
+  const idnList = (Array.isArray(opts.identities) ? opts.identities : []).map(normalizeIdentity).filter((i) => i.user || i.label);
+  const adminAcl = opts.admin === true && typeof opts.aclOf === "function" ? opts.aclOf : null;
+  el.classList.add("kb-retrieval");
+  el.dataset.kbRetrieval = "";
+  el.textContent = "";
+  const bar = h("div", "kb-retrieval-bar");
+  const queryInput = h("input", "kb-retrieval-query");
+  queryInput.type = "text";
+  queryInput.placeholder = "\u68C0\u7D22\u95EE\u9898\uFF0CEnter \u8FD0\u884C";
+  queryInput.setAttribute("aria-label", "\u68C0\u7D22\u95EE\u9898");
+  const modes = h("div", "kb-modes");
+  modes.role = "radiogroup";
+  modes.setAttribute("aria-label", "\u68C0\u7D22\u6A21\u5F0F");
+  const modeButtons = /* @__PURE__ */ new Map();
+  for (const [mode, label] of MODES) {
+    const btn = h("button", "kb-mode-item", label);
+    btn.type = "button";
+    btn.dataset.mode = mode;
+    btn.role = "radio";
+    modes.appendChild(btn);
+    modeButtons.set(mode, btn);
+  }
+  const topKDown = h("button", "kb-step-btn", "\u2212");
+  topKDown.type = "button";
+  topKDown.dataset.step = "-1";
+  topKDown.setAttribute("aria-label", "\u51CF\u5C11 topK");
+  const topKValue = h("span", "kb-step-value kb-num");
+  const topKUp = h("button", "kb-step-btn", "+");
+  topKUp.type = "button";
+  topKUp.dataset.step = "1";
+  topKUp.setAttribute("aria-label", "\u589E\u52A0 topK");
+  const step = h("div", "kb-step");
+  step.append(topKDown, topKValue, topKUp);
+  const stepLabel = h("span", "kb-step-label kb-meta", "topK");
+  step.setAttribute("aria-label", "topK");
+  const alphaEndL = h("span", "kb-alpha-end", "\u8BED\u4E49");
+  alphaEndL.title = "\u8BED\u4E49\uFF1A\u8DE8\u8BED\u8A00/\u65E0\u7CBE\u786E\u8BCD";
+  const alphaRange = h("input", "kb-range kb-alpha-range");
+  alphaRange.type = "range";
+  alphaRange.min = "0";
+  alphaRange.max = "1";
+  alphaRange.step = "0.05";
+  alphaRange.setAttribute("aria-label", "\u6DF7\u5408\u6743\u91CD\uFF08\u5DE6\u8BED\u4E49\u53F3\u5173\u952E\u8BCD\uFF09");
+  const alphaEndR = h("span", "kb-alpha-end", "\u5173\u952E\u8BCD");
+  alphaEndR.title = "\u5173\u952E\u8BCD\uFF1A\u5927\u5E93\u5FEB\u901F\u7CBE\u786E";
+  const alpha = h("div", "kb-alpha");
+  alpha.append(alphaEndL, alphaRange, alphaEndR);
+  const rerankSwitch = h("button", "kb-switch");
+  rerankSwitch.type = "button";
+  rerankSwitch.role = "switch";
+  rerankSwitch.setAttribute("aria-label", "\u91CD\u6392");
+  const rerankText = h("span", "kb-toggle-label", "\u91CD\u6392");
+  const rerankToggle = h("span", "kb-toggle");
+  rerankToggle.append(rerankSwitch, rerankText);
+  const thresholdRange = h("input", "kb-range kb-threshold-range");
+  thresholdRange.type = "range";
+  thresholdRange.min = "0";
+  thresholdRange.max = "1";
+  thresholdRange.step = "0.05";
+  thresholdRange.setAttribute("aria-label", "\u5206\u6570\u9608\u503C");
+  const thresholdCount = h("span", "kb-threshold-count kb-meta");
+  const threshold = h("div", "kb-threshold");
+  threshold.append(thresholdRange, thresholdCount);
+  const runBtn = h("button", "kb-run", "\u8FD0\u884C");
+  runBtn.type = "button";
+  const runIcon = svgIcon(ICON_RUN);
+  if (runIcon) runBtn.prepend(runIcon);
+  let idnSelect = null;
+  let idnGroup = null;
+  if (idnList.length) {
+    idnSelect = h("select", "kb-retrieval-idn");
+    idnSelect.setAttribute("aria-label", "\u68C0\u7D22\u8EAB\u4EFD");
+    for (const idn of idnList) {
+      const opt = h("option", void 0, idn.label ?? idn.user);
+      opt.value = idn.user;
+      idnSelect.appendChild(opt);
+    }
+    idnGroup = h("span", "kb-retrieval-idn-group");
+    idnGroup.append(h("span", "kb-meta", "\u8EAB\u4EFD"), idnSelect);
+  }
+  const layerChip = h("button", "kb-chip kb-layer-chip");
+  layerChip.type = "button";
+  layerChip.setAttribute("aria-label", "\u8FC7\u6EE4\u5C42");
+  const paintLayer = () => {
+    layerChip.dataset.layer = layer;
+    layerChip.textContent = LAYER_LABEL[layer];
+    layerChip.title = LAYER_TITLE[layer];
+  };
+  paintLayer();
+  const adminBadge = adminAcl ? h("span", "kb-badge kb-badge--admin", "admin") : null;
+  bar.append(queryInput, modes, stepLabel, step, alpha, rerankToggle, threshold);
+  if (idnGroup) bar.appendChild(idnGroup);
+  bar.append(runBtn, layerChip);
+  if (adminBadge) bar.appendChild(adminBadge);
+  const paramsText = h("code", "kb-params-text kb-meta");
+  const paramsCopy = h("button", "kb-params-copy");
+  paramsCopy.type = "button";
+  paramsCopy.title = "\u590D\u5236\u53C2\u6570 JSON";
+  paramsCopy.setAttribute("aria-label", "\u590D\u5236\u53C2\u6570 JSON");
+  const copyIcon = svgIcon(ICON_COPY);
+  if (copyIcon) paramsCopy.appendChild(copyIcon);
+  const paramsRow = h("div", "kb-params");
+  paramsRow.append(paramsCopy, paramsText);
+  const layerNotice = h("div", "kb-notice");
+  layerNotice.hidden = true;
+  const paintLayerNotice = () => {
+    if (layer === "none") {
+      layerNotice.textContent = "fail-open\uFF1A\u5F53\u524D\u67E5\u8BE2\u672A\u643A\u5E26\u8EAB\u4EFD\u8FC7\u6EE4\uFF0C\u5C06\u8FD4\u56DE\u5168\u90E8\u5019\u9009\uFF08\u4EC5\u9650\u8C03\u8BD5\uFF09";
+      layerNotice.hidden = false;
+    } else if (layer === "post") {
+      layerNotice.textContent = "post-filter\uFF1A\u5206\u6570\u5DF2\u5728\u8FC7\u6EE4\u524D\u4EA7\u751F\uFF08\u7F3A\u9677\u5C42\u6F14\u793A\uFF09";
+      layerNotice.hidden = false;
+    } else {
+      layerNotice.textContent = "";
+      layerNotice.hidden = true;
+    }
+  };
+  paintLayerNotice();
+  const hitsBox = h("div", "kb-hits");
+  el.append(bar, layerNotice, paramsRow, hitsBox);
+  function currentQueryText() {
+    return queryInput.value.trim();
+  }
+  function projectThreshold() {
+    return params.rerank && thresholdValue > 0 ? thresholdValue : null;
+  }
+  function buildQueryObject() {
+    const p = { ...params, threshold: projectThreshold() };
+    return { query: currentQueryText(), params: p };
+  }
+  function syncBar() {
+    for (const [mode, btn] of modeButtons) {
+      const active = mode === params.mode;
+      btn.classList.toggle("is-active", active);
+      btn.setAttribute("aria-checked", active ? "true" : "false");
+    }
+    topKValue.textContent = String(params.topK);
+    const alphaOn = params.mode === "hybrid";
+    alphaRange.disabled = !alphaOn;
+    alphaRange.value = String(params.alpha ?? 0.5);
+    alphaEndL.textContent = `\u8BED\u4E49 ${(params.alpha ?? 0.5).toFixed(2)}`;
+    alpha.classList.toggle("is-off", !alphaOn);
+    rerankSwitch.setAttribute("aria-checked", params.rerank ? "true" : "false");
+    thresholdRange.disabled = !params.rerank;
+    thresholdRange.value = String(thresholdValue);
+    threshold.classList.toggle("is-off", !params.rerank);
+  }
+  function updateSurvival() {
+    thresholdCount.title = "\u5206\u6BCD\u672A\u8FC7\u6EE4\u524D\u8BA1\u6570\u5C5E\u6CC4\u9732\uFF0C\u4E0D\u663E\u793A";
+    if (!params.rerank) {
+      thresholdCount.textContent = "\u9608\u503C N/A";
+      return;
+    }
+    const t = thresholdValue;
+    if (!(t > 0)) {
+      thresholdCount.textContent = `\u9608\u503C \u5173 \xB7 \u5B58\u6D3B ${hits.length}`;
+      return;
+    }
+    let alive = 0;
+    for (const hit of hits) {
+      const pct = scorePercent(hit.score, hit.scoreKind, thresholdMax);
+      if (pct != null && pct >= t * 100 - 1e-9) alive++;
+    }
+    thresholdCount.textContent = `\u9608\u503C ${t.toFixed(2)} \xB7 \u5B58\u6D3B ${alive}`;
+  }
+  function updateParamsLine() {
+    const q = buildQueryObject();
+    paramsText.textContent = JSON.stringify(q);
+  }
+  function refreshDerived() {
+    syncBar();
+    updateParamsLine();
+    updateSurvival();
+  }
+  function renderScoreSide(hit, side) {
+    const score = h("span", "kb-score");
+    const pct = scorePercent(hit.score, hit.scoreKind, thresholdMax);
+    if (pct != null) {
+      const barEl = h("span", "kb-score-bar");
+      const fill = h("i");
+      fill.style.width = `${pct.toFixed(1)}%`;
+      barEl.appendChild(fill);
+      score.appendChild(barEl);
+    }
+    const value = h("span", "kb-score-value", formatScore(hit.score));
+    score.appendChild(value);
+    side.appendChild(score);
+    const kind = h("span", "kb-chip kb-chip--kind", hit.scoreKind ?? "\u672A\u6807");
+    side.appendChild(kind);
+    if (hit.vectorPart != null && hit.keywordPart != null) {
+      const dual = h("span", "kb-score-dual");
+      const vec = h("i", "kb-score-dual-vec");
+      const kw = h("i", "kb-score-dual-kw");
+      const sum2 = hit.vectorPart + hit.keywordPart;
+      const vecPct = sum2 > 0 ? hit.vectorPart / sum2 * 100 : 50;
+      vec.style.width = `${Math.max(0, Math.min(100, vecPct)).toFixed(1)}%`;
+      kw.style.flex = "1 1 auto";
+      dual.append(vec, kw);
+      dual.title = `\u5411\u91CF ${vecPct.toFixed(0)}% / \u5173\u952E\u8BCD ${(100 - vecPct).toFixed(0)}%`;
+      side.appendChild(dual);
+    }
+    if (hit.explain) {
+      const fold = h("div", "kb-hit-explain-fold");
+      const toggle = h("button", "kb-hit-explain-toggle", "\u62C6\u89E3");
+      toggle.type = "button";
+      toggle.setAttribute("aria-expanded", "false");
+      const body = h("div", "kb-hit-explain kb-meta", hit.explain);
+      body.hidden = true;
+      fold.append(toggle, body);
+      side.appendChild(fold);
+    }
+  }
+  function renderMetaChips(hit, box) {
+    if (hit.page != null) box.appendChild(h("span", "kb-chip", `\u7B2C ${hit.page} \u9875`));
+    if (hit.documentId) box.appendChild(h("span", "kb-chip", hit.documentId));
+    if (hit.meta) {
+      for (const [k, v] of Object.entries(hit.meta).slice(0, 4)) {
+        box.appendChild(h("span", "kb-chip", `${k}: ${String(v)}`));
+      }
+    }
+  }
+  function renderHitRow(hit, index) {
+    const row = h("div", "kb-hit");
+    const rank = h("div", "kb-hit-rank kb-num", String(index + 1));
+    const main = h("div", "kb-hit-main");
+    const title = h("div", "kb-hit-title", hit.title ?? hit.documentId ?? hit.chunkId);
+    const snippet = h("div", "kb-hit-snippet");
+    for (const node of highlightTerms(hit.snippet ?? "", tokenizeQuery(currentQueryText()))) {
+      snippet.appendChild(node);
+    }
+    const metaBox = h("div", "kb-hit-meta");
+    renderMetaChips(hit, metaBox);
+    main.append(title, snippet, metaBox);
+    const side = h("div", "kb-hit-side");
+    renderScoreSide(hit, side);
+    if (adminAcl) side.appendChild(h("span", "kb-chip", kbVisibilityLabel(adminAcl(hit))));
+    row.append(rank, main, side);
+    return row;
+  }
+  function renderEmpty() {
+    const empty = h("div", "kb-empty", "\u8F93\u5165\u95EE\u9898\u5E76\u8FD0\u884C\uFF0C\u547D\u4E2D\u7ED3\u679C\u5C06\u51FA\u73B0\u5728\u8FD9\u91CC");
+    hitsBox.appendChild(empty);
+  }
+  function run() {
+    if (busy || destroyed) return;
+    const query = buildQueryObject();
+    emitIcen(el, "icen:kb-retrieval-run", { query });
+    opts.onRun?.(query);
+  }
+  listen(queryInput, "input", () => {
+    updateParamsLine();
+  });
+  listen(queryInput, "keydown", (ev) => {
+    const e = ev;
+    if (e.key === "Enter" && !e.isComposing) {
+      e.preventDefault();
+      run();
+    }
+  });
+  listen(modes, "click", (ev) => {
+    const btn = ev.target?.closest?.(".kb-mode-item");
+    if (!(btn instanceof HTMLButtonElement) || btn.disabled) return;
+    const mode = btn.dataset.mode;
+    if (!mode || mode === params.mode) return;
+    params = normalizeRetrievalParams({ ...params, mode });
+    refreshDerived();
+  });
+  listen(step, "click", (ev) => {
+    const btn = ev.target?.closest?.(".kb-step-btn");
+    if (!(btn instanceof HTMLButtonElement) || btn.disabled) return;
+    const dir = Number(btn.dataset.step) || 0;
+    if (!dir) return;
+    const next = Math.max(TOP_K_MIN, Math.min(TOP_K_MAX, params.topK + dir));
+    if (next === params.topK) return;
+    params = normalizeRetrievalParams({ ...params, topK: next });
+    refreshDerived();
+  });
+  listen(alphaRange, "input", () => {
+    params = normalizeRetrievalParams({ ...params, alpha: Number(alphaRange.value) });
+    refreshDerived();
+  });
+  listen(rerankSwitch, "click", () => {
+    params = normalizeRetrievalParams({ ...params, rerank: !params.rerank });
+    refreshDerived();
+  });
+  listen(thresholdRange, "input", () => {
+    thresholdValue = Number(thresholdRange.value);
+    updateSurvival();
+    updateParamsLine();
+  });
+  listen(runBtn, "click", () => run());
+  function applyLayer(next) {
+    if (destroyed || next === layer) return;
+    layer = next;
+    paintLayer();
+    paintLayerNotice();
+    emitIcen(el, "icen:kb-visibility-layer", { layer });
+  }
+  listen(layerChip, "click", () => {
+    const idx = LAYER_ORDER.indexOf(layer);
+    applyLayer(LAYER_ORDER[(idx + 1) % LAYER_ORDER.length]);
+  });
+  if (idnSelect) {
+    const select = idnSelect;
+    listen(select, "change", () => {
+      const identity = idnList.find((i) => i.user === select.value);
+      if (identity) emitIcen(el, "icen:kb-visibility-identity", { identity });
+    });
+  }
+  listen(hitsBox, "click", (ev) => {
+    const btn = ev.target?.closest?.(".kb-hit-explain-toggle");
+    if (!(btn instanceof HTMLButtonElement)) return;
+    const body = btn.parentElement?.querySelector(".kb-hit-explain");
+    if (!body) return;
+    const open = body.hasAttribute("hidden");
+    body.toggleAttribute("hidden", !open);
+    btn.setAttribute("aria-expanded", open ? "true" : "false");
+  });
+  listen(paramsCopy, "click", () => {
+    if (destroyed) return;
+    const ok = copyText(paramsText.textContent ?? "");
+    if (ok) {
+      paramsCopy.classList.add("is-copied");
+      paramsCopy.title = "\u5DF2\u590D\u5236";
+      if (copyTimer) clearTimeout(copyTimer);
+      copyTimer = setTimeout(() => {
+        if (destroyed) return;
+        paramsCopy.classList.remove("is-copied");
+        paramsCopy.title = "\u590D\u5236\u53C2\u6570 JSON";
+      }, 1200);
+    }
+  });
+  const handle = {
+    getParams() {
+      return normalizeRetrievalParams({ ...params, threshold: projectThreshold() });
+    },
+    setParams(patch) {
+      params = normalizeRetrievalParams({ ...params, ...patch });
+      thresholdValue = params.threshold ?? thresholdValue;
+      refreshDerived();
+    },
+    renderHits(next) {
+      hits = next.map((hit) => normalizeHit(hit)).filter((hit) => hit.chunkId || hit.snippet);
+      hitsBox.textContent = "";
+      if (!hits.length) renderEmpty();
+      else for (let i = 0; i < hits.length; i++) hitsBox.appendChild(renderHitRow(hits[i], i));
+      updateSurvival();
+    },
+    setBusy(next) {
+      busy = next && !destroyed;
+      el.classList.toggle("is-busy", busy);
+      runBtn.disabled = busy;
+      runBtn.setAttribute("aria-busy", busy ? "true" : "false");
+      runBtn.textContent = busy ? "\u8FD0\u884C\u4E2D\u2026" : "\u8FD0\u884C";
+      if (!busy) {
+        const icon = svgIcon(ICON_RUN);
+        if (icon) runBtn.prepend(icon);
+      }
+    },
+    setThreshold(next) {
+      thresholdValue = typeof next === "number" && Number.isFinite(next) ? Math.max(0, Math.min(1, next)) : 0;
+      refreshDerived();
+    },
+    getFilterLayer() {
+      return layer;
+    },
+    setFilterLayer(l) {
+      applyLayer(l === "post" || l === "none" ? l : "pre");
+    },
+    destroy() {
+      if (destroyed) return;
+      destroyed = true;
+      ctrl.abort();
+      if (copyTimer) clearTimeout(copyTimer);
+      el.classList.remove("kb-retrieval", "is-busy");
+      delete el.dataset.kbRetrieval;
+      el.textContent = "";
+      delete el.__icenKbRetrieval;
+    }
+  };
+  refreshDerived();
+  marked.__icenKbRetrieval = handle;
+  return handle;
+}
+export {
+  createKbRetrieval
+};