@icen.ai/ui 0.8.1 → 0.9.0

package/dist/behaviors/kb-filter.mjs

@@ -0,0 +1,587 @@
+// 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;
+}
+
+// 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 KB_FILTER_OPS = ["eq", "ne", "gt", "gte", "lt", "lte", "in", "contains", "exists"];
+function normalizeFilterNode(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const r = raw;
+  if (r.type === "group") {
+    const children = Array.isArray(r.children) ? r.children.map(normalizeFilterNode).filter((c) => c !== null) : [];
+    return children.length ? { type: "group", op: r.op === "or" ? "or" : "and", children } : null;
+  }
+  if (r.type === "rule") {
+    const field = String(r.field ?? "").trim();
+    const op = KB_FILTER_OPS.includes(r.op) ? r.op : null;
+    if (!field || !op) return null;
+    let value;
+    if (Array.isArray(r.value)) value = r.value.map((v) => typeof v === "number" ? v : String(v));
+    else if (typeof r.value === "number" || typeof r.value === "string" || typeof r.value === "boolean") value = r.value;
+    return { type: "rule", field, op, value };
+  }
+  return null;
+}
+var MONGO_OP = {
+  eq: "$eq",
+  ne: "$ne",
+  gt: "$gt",
+  gte: "$gte",
+  lt: "$lt",
+  lte: "$lte",
+  in: "$in",
+  contains: "$regex",
+  exists: "$exists"
+};
+function filterToMongo(node) {
+  const n = normalizeFilterNode(node);
+  if (!n) return null;
+  if (n.type === "group") {
+    const key = n.op === "or" ? "$or" : "$and";
+    return { [key]: n.children.map((c) => filterToMongo(c) ?? {}) };
+  }
+  if (n.op === "exists") return { [n.field]: { $exists: n.value !== false } };
+  if (n.op === "contains") {
+    const v = Array.isArray(n.value) ? String(n.value[0] ?? "") : String(n.value ?? "");
+    return { [n.field]: { $regex: v.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), $options: "i" } };
+  }
+  const mk = MONGO_OP[n.op];
+  if (!mk) return null;
+  const value = Array.isArray(n.value) ? n.value : n.value ?? "";
+  return { [n.field]: { [mk]: value } };
+}
+function odataQuote(v) {
+  return typeof v === "number" ? String(v) : `'${String(v).replace(/'/g, "''")}'`;
+}
+var ODATA_OP = {
+  eq: "eq",
+  ne: "ne",
+  gt: "gt",
+  gte: "ge",
+  lt: "lt",
+  lte: "le",
+  in: "in",
+  contains: "contains",
+  exists: "exists"
+};
+function filterToOData(node) {
+  const n = normalizeFilterNode(node);
+  if (!n) return "";
+  if (n.type === "group") {
+    const join = n.op === "or" ? " or " : " and ";
+    return n.children.map((c) => `(${filterToOData(c)})`).join(join);
+  }
+  if (n.op === "contains") {
+    const v = Array.isArray(n.value) ? String(n.value[0] ?? "") : String(n.value ?? "");
+    return `contains(${n.field},${odataQuote(v)})`;
+  }
+  if (n.op === "in") {
+    const list = Array.isArray(n.value) ? n.value : [typeof n.value === "number" ? n.value : String(n.value ?? "")];
+    return `${n.field} in (${list.map(odataQuote).join(",")})`;
+  }
+  if (n.op === "exists") return n.value === false ? `${n.field} eq null` : `${n.field} ne null`;
+  const raw = Array.isArray(n.value) ? n.value[0] : n.value;
+  const value = typeof raw === "number" ? raw : String(raw ?? "");
+  return `${n.field} ${ODATA_OP[n.op]} ${odataQuote(value)}`;
+}
+
+// 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-filter.ts
+var MAX_GROUP_DEPTH = 2;
+var OP_LABELS = {
+  eq: "\u7B49\u4E8E",
+  ne: "\u4E0D\u7B49\u4E8E",
+  gt: "\u5927\u4E8E",
+  gte: "\u5927\u4E8E\u7B49\u4E8E",
+  lt: "\u5C0F\u4E8E",
+  lte: "\u5C0F\u4E8E\u7B49\u4E8E",
+  in: "\u5C5E\u4E8E",
+  contains: "\u5305\u542B",
+  exists: "\u5B58\u5728"
+};
+var fieldListSeq = 0;
+function numOrStr(s) {
+  return /^-?\d+(\.\d+)?$/.test(s) ? Number(s) : s;
+}
+function parseValue(raw, op) {
+  if (op === "exists") return true;
+  const t = raw.trim();
+  if (!t) return void 0;
+  if (op === "in") {
+    const list = t.split(/[,，]/).map((s) => s.trim()).filter(Boolean).map(numOrStr);
+    return list.length ? list : void 0;
+  }
+  return numOrStr(t);
+}
+function formatValue(value) {
+  if (Array.isArray(value)) return value.map(String).join(", ");
+  if (value == null) return "";
+  if (typeof value === "boolean") return "";
+  return String(value);
+}
+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 createKbFilter(el, opts = {}) {
+  if (typeof document === "undefined" || !el) {
+    const stub = {
+      get: () => null,
+      set: () => {
+      },
+      serialize: () => "",
+      destroy: () => {
+      }
+    };
+    return stub;
+  }
+  const marked = el;
+  if (marked.__icenKbFilter) return marked.__icenKbFilter;
+  const ctrl = new AbortController();
+  const listen = (type, fn) => {
+    el.addEventListener(type, fn, { signal: ctrl.signal });
+  };
+  let dslKind = "mongo";
+  let destroyed = false;
+  let copyTimer = null;
+  el.classList.add("kb-filter");
+  el.dataset.kbFilter = "";
+  el.textContent = "";
+  const datalistId = `kb-filter-fields-${++fieldListSeq}`;
+  const datalist = h("datalist");
+  datalist.id = datalistId;
+  for (const f of opts.fields ?? []) datalist.appendChild(h("option", void 0, f));
+  const treeBox = h("div", "kb-filter-tree");
+  const dslText = h("code", "kb-filter-dsl-text kb-meta");
+  const tabMongo = h("button", "kb-filter-dsl-tab is-active", "Mongo");
+  tabMongo.type = "button";
+  tabMongo.dataset.dsl = "mongo";
+  const tabOdata = h("button", "kb-filter-dsl-tab", "OData");
+  tabOdata.type = "button";
+  tabOdata.dataset.dsl = "odata";
+  const dslCopy = h("button", "kb-filter-act kb-filter-dsl-copy", "\u590D\u5236");
+  dslCopy.type = "button";
+  dslCopy.title = "\u590D\u5236 DSL";
+  const dslBar = h("div", "kb-filter-dsl-bar");
+  dslBar.append(tabMongo, tabOdata, dslCopy);
+  const dslBox = h("div", "kb-filter-dsl");
+  dslBox.append(dslBar, dslText);
+  el.append(treeBox, dslBox, datalist);
+  function buildRuleRow(rule) {
+    const row = h("div", "kb-filter-rule");
+    const field = h("input", "kb-filter-field");
+    field.type = "text";
+    field.value = rule.field;
+    field.placeholder = "\u5B57\u6BB5";
+    field.setAttribute("list", datalistId);
+    field.setAttribute("aria-label", "\u8FC7\u6EE4\u5B57\u6BB5");
+    const opSel = h("select", "kb-filter-op");
+    opSel.setAttribute("aria-label", "\u64CD\u4F5C\u7B26");
+    for (const op of KB_FILTER_OPS) {
+      const option = h("option", void 0, OP_LABELS[op]);
+      option.value = op;
+      opSel.appendChild(option);
+    }
+    opSel.value = rule.op;
+    const value = h("input", "kb-filter-value");
+    value.type = "text";
+    value.value = formatValue(rule.value);
+    value.placeholder = rule.op === "in" ? "\u503C 1, \u503C 2\uFF08\u9017\u53F7\u5206\u9694\uFF09" : "\u503C";
+    value.setAttribute("aria-label", "\u8FC7\u6EE4\u503C");
+    if (rule.op === "exists") value.disabled = true;
+    const del = h("button", "kb-filter-act is-danger", "\xD7");
+    del.type = "button";
+    del.dataset.act = "del-rule";
+    del.title = "\u5220\u9664\u89C4\u5219";
+    del.setAttribute("aria-label", "\u5220\u9664\u89C4\u5219");
+    row.append(field, opSel, value, del);
+    return row;
+  }
+  function buildGroup(node, depth) {
+    const box = h("div", "kb-filter-group");
+    box.dataset.depth = String(depth);
+    const head = h("div", "kb-filter-head");
+    const opBtn = h("button", "kb-filter-op-toggle", node.op === "or" ? "OR" : "AND");
+    opBtn.type = "button";
+    opBtn.dataset.op = node.op;
+    opBtn.classList.toggle("is-or", node.op === "or");
+    opBtn.title = "\u5207\u6362 AND / OR";
+    opBtn.setAttribute("aria-label", `\u7EC4\u5408\u65B9\u5F0F ${node.op === "or" ? "\u6216" : "\u4E14"}`);
+    const addRule = h("button", "kb-filter-act", "+ \u89C4\u5219");
+    addRule.type = "button";
+    addRule.dataset.act = "add-rule";
+    const addGroup = h("button", "kb-filter-act", "+ \u7EC4");
+    addGroup.type = "button";
+    addGroup.dataset.act = "add-group";
+    if (depth >= MAX_GROUP_DEPTH) addGroup.disabled = true;
+    head.append(opBtn, addRule, addGroup);
+    if (depth > 0) {
+      const delGroup = h("button", "kb-filter-act is-danger", "\u5220\u9664\u7EC4");
+      delGroup.type = "button";
+      delGroup.dataset.act = "del-group";
+      head.appendChild(delGroup);
+    }
+    const body = h("div", "kb-filter-body");
+    for (const child of node.children) {
+      body.appendChild(child.type === "rule" ? buildRuleRow(child) : buildGroup(child, depth + 1));
+    }
+    box.append(head, body);
+    return box;
+  }
+  function readGroup(groupEl) {
+    const opBtn = groupEl.querySelector(":scope > .kb-filter-head > .kb-filter-op-toggle");
+    const op = opBtn instanceof HTMLElement && opBtn.dataset.op === "or" ? "or" : "and";
+    const children = [];
+    const body = groupEl.querySelector(":scope > .kb-filter-body");
+    if (body) {
+      for (const child of Array.from(body.children)) {
+        if (!(child instanceof HTMLElement)) continue;
+        if (child.classList.contains("kb-filter-rule")) {
+          const fieldEl = child.querySelector(":scope > .kb-filter-field");
+          const opEl = child.querySelector(":scope > .kb-filter-op");
+          const valueEl = child.querySelector(":scope > .kb-filter-value");
+          const field = fieldEl instanceof HTMLInputElement ? fieldEl.value.trim() : "";
+          const op2 = opEl instanceof HTMLSelectElement && KB_FILTER_OPS.includes(opEl.value) ? opEl.value : "eq";
+          const rawValue = valueEl instanceof HTMLInputElement ? valueEl.value : "";
+          children.push({ type: "rule", field, op: op2, value: parseValue(rawValue, op2) });
+        } else if (child.classList.contains("kb-filter-group")) {
+          children.push(readGroup(child));
+        }
+      }
+    }
+    return { type: "group", op, children };
+  }
+  function rootNode() {
+    const rootEl = treeBox.querySelector(":scope > .kb-filter-group");
+    return rootEl instanceof HTMLElement ? readGroup(rootEl) : { type: "group", op: "and", children: [] };
+  }
+  function collectFields(node, out) {
+    if (node.type === "rule") {
+      if (!node.field) out.empty = true;
+      return;
+    }
+    for (const c of node.children) collectFields(c, out);
+  }
+  function currentNode() {
+    return normalizeFilterNode(rootNode());
+  }
+  function currentValid(node) {
+    const flag = { empty: false };
+    collectFields(node, flag);
+    return !flag.empty;
+  }
+  function serializeOf(node, kind) {
+    if (kind === "odata") return filterToOData(node);
+    return JSON.stringify(filterToMongo(node));
+  }
+  function syncDsl() {
+    tabMongo.classList.toggle("is-active", dslKind === "mongo");
+    tabOdata.classList.toggle("is-active", dslKind === "odata");
+    dslText.textContent = serializeOf(currentNode(), dslKind) || "\uFF08\u65E0\u8FC7\u6EE4\uFF09";
+  }
+  function notify() {
+    const raw = rootNode();
+    const valid = currentValid(raw);
+    const node = normalizeFilterNode(raw);
+    syncDsl();
+    if (destroyed) return;
+    emitIcen(el, "icen:kb-filter-change", { node, valid });
+    opts.onChange?.(node, valid);
+  }
+  function applyNode(node) {
+    const norm = normalizeFilterNode(node);
+    treeBox.textContent = "";
+    if (!norm) {
+      treeBox.appendChild(buildGroup({ type: "group", op: "and", children: [] }, 0));
+      return;
+    }
+    if (norm.type === "rule") {
+      treeBox.appendChild(buildGroup({ type: "group", op: "and", children: [norm] }, 0));
+      return;
+    }
+    treeBox.appendChild(buildGroup(norm, 0));
+  }
+  applyNode(opts.node ?? null);
+  listen("click", (ev) => {
+    const target = ev.target;
+    if (!(target instanceof Element)) return;
+    const tab = target.closest(".kb-filter-dsl-tab");
+    if (tab instanceof HTMLElement) {
+      const kind = tab.dataset.dsl === "odata" ? "odata" : "mongo";
+      if (kind !== dslKind) {
+        dslKind = kind;
+        syncDsl();
+      }
+      return;
+    }
+    if (target.closest(".kb-filter-dsl-copy")) {
+      if (!destroyed && copyText(dslText.textContent === "\uFF08\u65E0\u8FC7\u6EE4\uFF09" ? "" : dslText.textContent ?? "")) {
+        dslCopy.classList.add("is-copied");
+        dslCopy.textContent = "\u5DF2\u590D\u5236";
+        if (copyTimer) clearTimeout(copyTimer);
+        copyTimer = setTimeout(() => {
+          if (destroyed) return;
+          dslCopy.classList.remove("is-copied");
+          dslCopy.textContent = "\u590D\u5236";
+        }, 1200);
+      }
+      return;
+    }
+    const actBtn = target.closest(".kb-filter-act");
+    if (!(actBtn instanceof HTMLButtonElement) || actBtn.disabled) return;
+    const act = actBtn.dataset.act;
+    if (!act) return;
+    if (act === "add-rule" || act === "add-group") {
+      const groupEl = actBtn.closest(".kb-filter-group");
+      if (!(groupEl instanceof HTMLElement)) return;
+      const body = groupEl.querySelector(":scope > .kb-filter-body");
+      if (!body) return;
+      if (act === "add-rule") {
+        body.appendChild(buildRuleRow({ type: "rule", field: "", op: "eq", value: void 0 }));
+      } else {
+        const depth = Number(groupEl.dataset.depth) || 0;
+        body.appendChild(buildGroup({ type: "group", op: "and", children: [] }, depth + 1));
+      }
+      notify();
+      return;
+    }
+    if (act === "del-rule") {
+      const row = actBtn.closest(".kb-filter-rule");
+      row?.remove();
+      notify();
+      return;
+    }
+    if (act === "del-group") {
+      const groupEl = actBtn.closest(".kb-filter-group");
+      if (groupEl instanceof HTMLElement && (Number(groupEl.dataset.depth) || 0) > 0) {
+        groupEl.remove();
+        notify();
+      }
+      return;
+    }
+  });
+  listen("click", (ev) => {
+    const target = ev.target;
+    if (!(target instanceof Element)) return;
+    const opBtn = target.closest(".kb-filter-op-toggle");
+    if (!(opBtn instanceof HTMLButtonElement)) return;
+    const nowOr = opBtn.dataset.op !== "or";
+    opBtn.dataset.op = nowOr ? "or" : "and";
+    opBtn.textContent = nowOr ? "OR" : "AND";
+    opBtn.classList.toggle("is-or", nowOr);
+    opBtn.setAttribute("aria-label", `\u7EC4\u5408\u65B9\u5F0F ${nowOr ? "\u6216" : "\u4E14"}`);
+    notify();
+  });
+  listen("input", (ev) => {
+    const target = ev.target;
+    if (!(target instanceof HTMLInputElement)) return;
+    if (target.classList.contains("kb-filter-field") || target.classList.contains("kb-filter-value")) {
+      notify();
+    }
+  });
+  listen("change", (ev) => {
+    const target = ev.target;
+    if (!(target instanceof HTMLSelectElement) || !target.classList.contains("kb-filter-op")) return;
+    const row = target.closest(".kb-filter-rule");
+    const valueEl = row?.querySelector(":scope > .kb-filter-value");
+    if (!(valueEl instanceof HTMLInputElement)) return;
+    const op = KB_FILTER_OPS.includes(target.value) ? target.value : "eq";
+    valueEl.disabled = op === "exists";
+    valueEl.placeholder = op === "in" ? "\u503C 1, \u503C 2\uFF08\u9017\u53F7\u5206\u9694\uFF09" : op === "exists" ? "\uFF08\u65E0\u9700\u503C\uFF09" : "\u503C";
+    notify();
+  });
+  syncDsl();
+  const handle = {
+    get() {
+      return currentNode();
+    },
+    set(node) {
+      applyNode(node);
+      notify();
+    },
+    serialize(kind) {
+      return serializeOf(currentNode(), kind);
+    },
+    destroy() {
+      if (destroyed) return;
+      destroyed = true;
+      ctrl.abort();
+      if (copyTimer) clearTimeout(copyTimer);
+      el.classList.remove("kb-filter");
+      delete el.dataset.kbFilter;
+      el.textContent = "";
+      delete el.__icenKbFilter;
+    }
+  };
+  marked.__icenKbFilter = handle;
+  return handle;
+}
+export {
+  createKbFilter
+};

package/dist/behaviors/kb-gap.d.mts

@@ -0,0 +1,27 @@
+import { KbGapQuery } from './kb-core.js';
+import './ai-core.js';
+
+/** 趋势单点（label 如 '10-01'，value 为当日未命中次数） */
+interface KbGapTrendPoint {
+    label: string;
+    value: number;
+}
+/** renderKbGap 入参模型 */
+interface KbGapModel {
+    queries: KbGapQuery[];
+    trend?: KbGapTrendPoint[];
+}
+/**
+ * 渲染无答案分析视图（快照：整体替换 el 内容）。返回挂载容器 el。
+ * queries 为空时渲染空态「没有未命中查询——覆盖良好」（无死路：覆盖良好也是一等状态）。
+ */
+declare function renderKbGap(el: HTMLElement, model: KbGapModel): HTMLElement;
+/**
+ * 初始化无答案分析交互：document 级 click 委托 → 行内行动钮派发
+ * icen:kb-gap-action { query, action }。幂等（重复调用安全）；返回销毁函数
+ * （解绑委托并复位幂等标记，销毁后可重新 init）。委托挂 document 级：动态插入的
+ * .kb-gap 自动接管（root 参数仅保持 kb 族 API 对称）。SSR 下 no-op。
+ */
+declare function initKbGap(root?: ParentNode): () => void;
+
+export { type KbGapModel, type KbGapTrendPoint, initKbGap, renderKbGap };