@icen.ai/ui 0.8.0 → 0.9.0

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

@@ -0,0 +1,44 @@
+import { KbReviewTask, KbScoreConfig } from './kb-core.js';
+import './ai-core.js';
+
+/** onAction 回调的动作信封（与 icen:kb-review-* 事件双通道；select 无对应事件，仅回调） */
+interface KbReviewActionDetail {
+    type: 'select' | 'score' | 'submit' | 'assign';
+    taskId: string;
+    /** score：配置名 */
+    name?: string;
+    /** score：选项/数值；assign：分配人 */
+    value?: string | number;
+}
+/** createKbReview 入参 */
+interface KbReviewOpts {
+    /** 审查队列（内部持有副本，不打脏调用方数据） */
+    queue: KbReviewTask[];
+    /** rubric 配置（categorical / numeric） */
+    configs: KbScoreConfig[];
+    /** 动作回调（与事件双通道） */
+    onAction?: (action: KbReviewActionDetail) => void;
+    /** 分配人名单（提供时审查卡显示分配下拉） */
+    assignees?: string[];
+}
+/** createKbReview 句柄（函数名冻结于 spec §5.20） */
+interface KbReviewHandle {
+    el: HTMLElement;
+    /** 当前（可见列表中的）任务；空返回 null */
+    current(): KbReviewTask | null;
+    /** 下一条（循环）；返回新当前任务 */
+    next(): KbReviewTask | null;
+    /** 上一条（循环） */
+    prev(): KbReviewTask | null;
+    /** 完成当前任务（置 done + 派发 submit + 自动 next） */
+    submit(): void;
+    /** 解绑键盘监听并清空 DOM（幂等） */
+    destroy(): void;
+}
+/**
+ * 创建标注/审查队列（左右结构：队列列表 + 审查卡），返回带导航/提交/销毁的句柄。
+ * 键盘处理挂在组件容器上、仅当焦点位于审查卡内才生效；destroy 解绑。
+ */
+declare function createKbReview(el: HTMLElement, opts: KbReviewOpts): KbReviewHandle;
+
+export { type KbReviewActionDetail, type KbReviewHandle, type KbReviewOpts, createKbReview };

package/dist/behaviors/kb-review.mjs

@@ -0,0 +1,451 @@
+// 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));
+
+// 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-review.ts
+var KIND_LABELS = { trace: "\u8F68\u8FF9", message: "\u6D88\u606F", answer: "\u56DE\u7B54" };
+var fmtSlider = (v) => v.toFixed(1).replace(/\.0$/, "");
+function cloneTask(t) {
+  return {
+    ...t,
+    target: { ...t.target },
+    scores: t.scores ? t.scores.map((s) => ({ ...s })) : void 0
+  };
+}
+function distinctAssignees(tasks) {
+  const out = [];
+  for (const t of tasks) if (t.assignee && !out.includes(t.assignee)) out.push(t.assignee);
+  return out;
+}
+function createKbReview(el, opts) {
+  if (typeof document === "undefined") {
+    const noop = () => void 0;
+    return { el, current: () => null, next: () => null, prev: () => null, submit: noop, destroy: noop };
+  }
+  const host = el;
+  host.__icenKbReview?.destroy();
+  const state = {
+    tasks: opts.queue.map(cloneTask),
+    configs: opts.configs,
+    assignees: opts.assignees ?? [],
+    onAction: opts.onAction,
+    filter: "",
+    idx: 0,
+    keysOpen: false
+  };
+  let destroyed = false;
+  const fire = (action) => {
+    state.onAction?.(action);
+  };
+  const visible = () => state.tasks.filter((t) => !state.filter || t.assignee === state.filter);
+  const getScore = (task, name) => task.scores?.find((s) => s.name === name)?.value;
+  const setScore = (task, name, value) => {
+    if (!task.scores) task.scores = [];
+    const entry = task.scores.find((s) => s.name === name);
+    if (entry) entry.value = value;
+    else task.scores.push({ name, value });
+  };
+  const emitScore = (task, name, value) => {
+    emitIcen(host, "icen:kb-review-score", { taskId: task.id, name, value });
+    fire({ type: "score", taskId: task.id, name, value });
+  };
+  const score = (task, name, value) => {
+    setScore(task, name, value);
+    emitScore(task, name, value);
+    render();
+  };
+  const assign = (task, assignee) => {
+    task.assignee = assignee || void 0;
+    emitIcen(host, "icen:kb-review-assign", { taskId: task.id, assignee });
+    fire({ type: "assign", taskId: task.id, value: assignee });
+    render();
+  };
+  const selectIdx = (i) => {
+    const vis = visible();
+    if (!vis.length) {
+      state.idx = 0;
+      render();
+      return null;
+    }
+    const len = vis.length;
+    state.idx = (i % len + len) % len;
+    const task = vis[state.idx];
+    render();
+    fire({ type: "select", taskId: task.id });
+    return task;
+  };
+  const next = () => destroyed ? null : selectIdx(state.idx + 1);
+  const prev = () => destroyed ? null : selectIdx(state.idx - 1);
+  const submit = () => {
+    if (destroyed) return;
+    const task = visible()[state.idx];
+    if (!task) return;
+    task.status = "done";
+    emitIcen(host, "icen:kb-review-submit", { taskId: task.id });
+    fire({ type: "submit", taskId: task.id });
+    next();
+  };
+  const onKeyDown = (e) => {
+    if (destroyed) return;
+    const target = e.target;
+    if (!(target instanceof Element)) return;
+    if (!target.closest(".kb-review-card")) return;
+    if (target instanceof HTMLSelectElement || target instanceof HTMLTextAreaElement) return;
+    const isRange = target instanceof HTMLInputElement && target.type === "range";
+    if (e.key === "ArrowRight" || e.key === "ArrowLeft") {
+      if (isRange) return;
+      e.preventDefault();
+      if (e.key === "ArrowRight") next();
+      else prev();
+      return;
+    }
+    if ((e.metaKey || e.ctrlKey) && e.key === "Enter") {
+      e.preventDefault();
+      submit();
+      return;
+    }
+    if (e.key === "?") {
+      e.preventDefault();
+      state.keysOpen = !state.keysOpen;
+      render();
+      return;
+    }
+    if (e.key === "Escape" && state.keysOpen) {
+      state.keysOpen = false;
+      render();
+      return;
+    }
+    if (!isRange && e.key >= "1" && e.key <= "9") {
+      const n = Number(e.key);
+      const rubricRow = target.closest(".kb-review-rubric");
+      let cfg;
+      if (rubricRow) cfg = state.configs.find((c) => c.name === rubricRow.dataset.configName);
+      cfg ??= state.configs.find((c) => c.type === "categorical");
+      if (!cfg || cfg.type !== "categorical") return;
+      const opt = (cfg.categories ?? [])[n - 1];
+      const task = visible()[state.idx];
+      if (!opt || !task) return;
+      e.preventDefault();
+      score(task, cfg.name, opt);
+    }
+  };
+  host.addEventListener("keydown", onKeyDown);
+  const render = () => {
+    if (destroyed || typeof document === "undefined") return;
+    const doc = host.ownerDocument;
+    const active = doc.activeElement;
+    const hadFocus = active instanceof HTMLElement && host.contains(active);
+    host.className = "kb-review";
+    host.replaceChildren();
+    const queueCol = h("div", "kb-review-queue");
+    const filterWrap = h("div", "kb-review-filter");
+    filterWrap.append(h("span", "kb-review-filter-label", "\u5206\u914D\u4EBA"));
+    const filterSel = h("select", "kb-review-filter-select");
+    const allOpt = h("option", void 0, "\u5168\u90E8");
+    allOpt.value = "";
+    filterSel.append(allOpt);
+    for (const a of distinctAssignees(state.tasks)) {
+      const o = h("option", void 0, a);
+      o.value = a;
+      filterSel.append(o);
+    }
+    filterSel.value = state.filter;
+    filterSel.addEventListener("change", () => {
+      state.filter = filterSel.value;
+      state.idx = 0;
+      render();
+    });
+    filterWrap.append(filterSel);
+    queueCol.append(filterWrap);
+    const vis = visible();
+    const listEl = h("div", "kb-review-list");
+    if (!vis.length) {
+      listEl.append(h("div", "kb-empty", state.filter ? "\u8BE5\u5206\u914D\u4EBA\u4E0B\u6CA1\u6709\u6761\u76EE" : "\u961F\u5217\u4E3A\u7A7A"));
+    } else {
+      vis.forEach((t, i) => {
+        const item = h("button", `kb-review-item${t.status === "done" ? " is-done" : ""}${i === state.idx ? " is-active" : ""}`);
+        item.type = "button";
+        item.dataset.taskId = t.id;
+        const main = h("span", "kb-review-item-main");
+        main.append(h("span", "kb-review-item-title", t.target.label || t.target.id));
+        item.append(
+          h("span", `kb-dot${t.status === "done" ? " is-ok" : ""}`),
+          main,
+          h("span", "kb-review-item-kind", KIND_LABELS[t.target.kind] ?? t.target.kind),
+          h("span", "kb-review-item-assignee", t.assignee ? `@${t.assignee}` : "")
+        );
+        item.addEventListener("click", () => {
+          if (i !== state.idx) selectIdx(i);
+        });
+        listEl.append(item);
+      });
+    }
+    queueCol.append(listEl);
+    const card = h("div", "kb-review-card");
+    card.tabIndex = 0;
+    const task = vis[state.idx];
+    if (!task) {
+      card.append(h("div", "kb-empty", "\u6CA1\u6709\u5F85\u5BA1\u67E5\u6761\u76EE"));
+    } else {
+      const head = h("div", "kb-review-card-head");
+      head.append(
+        h("span", "kb-review-card-kind", KIND_LABELS[task.target.kind] ?? task.target.kind),
+        h("span", "kb-review-card-title", task.target.label || task.target.id)
+      );
+      if (state.assignees.length) {
+        const sel = h("select", "kb-review-assign");
+        const placeholder = h("option", void 0, "\u672A\u5206\u914D");
+        placeholder.value = "";
+        sel.append(placeholder);
+        for (const a of state.assignees) {
+          const o = h("option", void 0, a);
+          o.value = a;
+          sel.append(o);
+        }
+        sel.value = task.assignee ?? "";
+        sel.addEventListener("change", () => assign(task, sel.value));
+        head.append(sel);
+      }
+      card.append(head);
+      const rubrics = h("div", "kb-review-rubrics");
+      for (const cfg of state.configs) {
+        const row = h("div", "kb-review-rubric");
+        row.dataset.configName = cfg.name;
+        const nameEl = h("div", "kb-review-rubric-name", cfg.name);
+        if (cfg.description) nameEl.append(h("span", "kb-review-rubric-desc", cfg.description));
+        row.append(nameEl);
+        if (cfg.type === "categorical") {
+          const chips = h("div", "kb-review-chips");
+          (cfg.categories ?? []).forEach((opt, oi) => {
+            const chip = h("button", `kb-review-chip${getScore(task, cfg.name) === opt ? " is-on" : ""}`);
+            chip.type = "button";
+            chip.dataset.opt = opt;
+            if (oi < 9) chip.append(h("span", "kb-key", String(oi + 1)));
+            chip.append(h("span", "kb-review-chip-label", opt));
+            chip.addEventListener("click", () => score(task, cfg.name, opt));
+            chips.append(chip);
+          });
+          row.append(chips);
+        } else {
+          const cur = typeof getScore(task, cfg.name) === "number" ? getScore(task, cfg.name) : 5;
+          const sliderRow = h("div", "kb-review-slider-row");
+          const input = h("input", "kb-review-slider");
+          input.type = "range";
+          input.min = "0";
+          input.max = "10";
+          input.step = "0.5";
+          input.value = String(cur);
+          input.setAttribute("aria-label", cfg.name);
+          const val = h("span", "kb-num kb-review-slider-value", fmtSlider(cur));
+          input.addEventListener("input", () => {
+            const v = Number(input.value);
+            setScore(task, cfg.name, v);
+            val.textContent = fmtSlider(v);
+          });
+          input.addEventListener("change", () => emitScore(task, cfg.name, Number(input.value)));
+          sliderRow.append(input, val);
+          row.append(sliderRow);
+        }
+        rubrics.append(row);
+      }
+      card.append(rubrics);
+      const foot = h("div", "kb-review-foot");
+      const submitBtn = h("button", "kb-review-submit");
+      submitBtn.type = "button";
+      submitBtn.append(h("span", void 0, "\u5B8C\u6210\u5E76\u4E0B\u4E00\u6761"), h("span", "kb-key", "\u2318\u21B5"));
+      submitBtn.addEventListener("click", () => submit());
+      foot.append(submitBtn, h("span", "kb-review-hint", "? \u5FEB\u6377\u952E"));
+      card.append(foot);
+    }
+    const keys = h("div", "kb-review-keys");
+    keys.hidden = !state.keysOpen;
+    const KEY_ROWS = [
+      ["\u2190/\u2192", "\u5207\u6362\u6761\u76EE"],
+      ["1\u20139", "\u9009\u62E9\u9009\u9879"],
+      ["\u2318/Ctrl \u21B5", "\u5B8C\u6210\u5E76\u4E0B\u4E00\u6761"],
+      ["?", "\u663E\u793A/\u9690\u85CF\u672C\u63D0\u793A"],
+      ["Esc", "\u5173\u95ED\u63D0\u793A"]
+    ];
+    for (const [k, label] of KEY_ROWS) {
+      const r = h("div", "kb-review-keys-row");
+      r.append(h("span", "kb-key", k), h("span", void 0, label));
+      keys.append(r);
+    }
+    card.append(keys);
+    host.append(queueCol, card);
+    if (hadFocus) card.focus();
+  };
+  const destroy = () => {
+    if (destroyed) return;
+    destroyed = true;
+    host.removeEventListener("keydown", onKeyDown);
+    host.replaceChildren();
+    host.classList.remove("kb-review");
+    delete host.__icenKbReview;
+  };
+  host.__icenKbReview = { destroy };
+  render();
+  return {
+    el: host,
+    current: () => destroyed ? null : visible()[state.idx] ?? null,
+    next,
+    prev,
+    submit,
+    destroy
+  };
+}
+export {
+  createKbReview
+};

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

@@ -0,0 +1,33 @@
+import { KbSandboxMessage } from './kb-core.js';
+import './ai-core.js';
+
+interface KbSandboxOptions {
+    /** 通信观测双通道（与 icen:kb-sandbox-message 事件同 payload） */
+    onMessage?: (msg: {
+        channel: 'in' | 'out';
+        payload: KbSandboxMessage;
+    }) => void;
+    /** 入站 origin 白名单（不传 = 只校验 event.source；沙箱帧 origin 恒为 'null'） */
+    allowedOrigins?: string[];
+    /** 单次 call() 超时（默认 8000ms） */
+    timeoutMs?: number;
+    /** 'ui://' 声明式资源解析器：返回 html 字符串（同步或 Promise）；null/undefined/抛错 = 拒绝 */
+    resolve?: (uri: string) => string | null | Promise<string | null>;
+}
+interface KbSandboxHandle {
+    /** 载入应用：'ui://' 声明式资源 / html 片段 / URL（opts.srcDoc 强制按 html 处理） */
+    load: (uriOrHtml: string, opts?: {
+        srcDoc?: boolean;
+    }) => void;
+    /** 调用子帧方法（JSON-RPC 请求→响应）；超时 / destroy / 重载时 reject */
+    call: (name: string, args?: unknown) => Promise<unknown>;
+    /** 摘监听、清 pending、移除 iframe；可重复调用 */
+    destroy: () => void;
+}
+/**
+ * 创建 MCP App 沙箱容器：iframe sandbox="allow-scripts" + JSON-RPC 2.0 双向桥。
+ * 三态样式（idle/loading/ready/error）由 data-state 驱动（纯 CSS，见 kb-agent.css）。
+ */
+declare function createKbSandbox(el: HTMLElement, opts?: KbSandboxOptions): KbSandboxHandle;
+
+export { type KbSandboxHandle, type KbSandboxOptions, createKbSandbox };