@icen.ai/ui 0.8.1 → 0.9.0

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

@@ -0,0 +1,23 @@
+import { KbAuditEntry, KbHygieneIssue } from './kb-core.js';
+import './ai-core.js';
+
+/** renderKbAudit 入参（宽进：契约对象或素对象皆可，内部 normalize） */
+interface KbAuditOptions {
+    /** 审计事件（原样渲染；排序与读取去重归数据侧，见文件头纪律说明） */
+    entries: Array<KbAuditEntry | Record<string, unknown>>;
+    /** 权限异味节（传入才渲染该节） */
+    hygiene?: Array<KbHygieneIssue | Record<string, unknown>>;
+}
+/**
+ * 渲染权限审计时间线（快照式：重复调用整段重建 el 内容），返回挂载元素 el。
+ * 结构：通道过滤 bar + 导出钮 → 权限异味节（opts.hygiene 传入才渲染）→ 事件时间线。
+ */
+declare function renderKbAudit(el: HTMLElement, opts: KbAuditOptions): HTMLElement;
+/**
+ * 初始化审计交互（root 级委托，缺省 document；幂等标记 + 返回销毁函数，销毁后可重新 init）：
+ * 通道过滤（JS 直控行显隐 + aria-pressed + 容器 data-active-channel）/ 导出 / 异味处置。
+ * SSR 返回 no-op。
+ */
+declare function initKbAudit(root?: ParentNode): () => void;
+
+export { type KbAuditOptions, initKbAudit, renderKbAudit };

package/dist/behaviors/kb-audit.mjs

@@ -0,0 +1,375 @@
+// 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_AUDIT_ACTIONS = [
+  "read",
+  "preview",
+  "permission_change",
+  "grant",
+  "revoke",
+  "request",
+  "approve",
+  "deny",
+  "delegation",
+  "break_glass",
+  "sync"
+];
+function kbAuditActionLabel(a) {
+  return {
+    read: "\u8BFB\u53D6",
+    preview: "\u9884\u89C8",
+    permission_change: "\u6743\u9650\u53D8\u66F4",
+    grant: "\u6388\u4E88",
+    revoke: "\u6536\u56DE",
+    request: "\u7533\u8BF7",
+    approve: "\u6279\u51C6",
+    deny: "\u62D2\u7EDD",
+    delegation: "\u59D4\u6D3E",
+    break_glass: "\u5E94\u6025\u8BBF\u95EE",
+    sync: "\u6743\u9650\u540C\u6B65"
+  }[a] ?? a;
+}
+function auditChannelOf(a) {
+  if (a === "read" || a === "preview") return "read";
+  if (a === "permission_change" || a === "grant" || a === "revoke" || a === "delegation" || a === "sync") return "permission";
+  if (a === "request" || a === "approve" || a === "deny") return "request";
+  return "system";
+}
+function normalizeAuditEntry(raw) {
+  const r = raw;
+  const actor = r.actor ?? {};
+  const kind = actor.kind === "app" || actor.kind === "system" ? actor.kind : "human";
+  return {
+    id: String(r.id ?? ""),
+    at: String(r.at ?? ""),
+    actor: { kind, name: String(actor.name ?? "\u672A\u77E5") },
+    action: KB_AUDIT_ACTIONS.includes(r.action) ? r.action : "read",
+    resource: typeof r.resource === "string" && r.resource ? r.resource : void 0,
+    detail: String(r.detail ?? ""),
+    breakGlass: r.breakGlass === true
+  };
+}
+var KB_HYGIENE_KINDS = [
+  "org_wide_link",
+  "broad_group",
+  "sensitive_mismatch",
+  "broken_inheritance",
+  "orphaned_owner",
+  "overexposed"
+];
+function kbHygieneLabel(k) {
+  return {
+    org_wide_link: "\u7EC4\u7EC7\u7EA7\u94FE\u63A5",
+    broad_group: "\u8FC7\u5BBD\u7EC4\u6388\u6743",
+    sensitive_mismatch: "\u654F\u611F\u5EA6\u9519\u914D",
+    broken_inheritance: "\u65AD\u7EE7\u627F",
+    orphaned_owner: "\u8D1F\u8D23\u4EBA\u7F3A\u4F4D",
+    overexposed: "\u8FC7\u5EA6\u66B4\u9732"
+  }[k] ?? k;
+}
+function normalizeHygieneIssue(raw) {
+  const r = raw;
+  const severity = r.severity === "high" || r.severity === "medium" || r.severity === "low" ? r.severity : "medium";
+  return {
+    id: String(r.id ?? ""),
+    kind: KB_HYGIENE_KINDS.includes(r.kind) ? r.kind : "overexposed",
+    resource: String(r.resource ?? ""),
+    metric: String(r.metric ?? ""),
+    hint: String(r.hint ?? ""),
+    severity
+  };
+}
+
+// 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-audit.ts
+var CHANNEL_CHIPS = [
+  ["all", "\u5168\u90E8"],
+  ["read", "\u8BFB\u53D6"],
+  ["permission", "\u6743\u9650\u53D8\u66F4"],
+  ["request", "\u7533\u8BF7"],
+  ["system", "\u7CFB\u7EDF"]
+];
+function fmtStamp(at) {
+  const t = Date.parse(at);
+  if (!Number.isFinite(t)) return at || "\u2014";
+  const d = new Date(t);
+  const p = (n) => String(n).padStart(2, "0");
+  return `${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`;
+}
+var hygieneIssueMap = /* @__PURE__ */ new WeakMap();
+function renderKbAudit(el, opts) {
+  if (typeof document === "undefined") return el;
+  const entries = (Array.isArray(opts.entries) ? opts.entries : []).map(normalizeAuditEntry);
+  const hygiene = Array.isArray(opts.hygiene) ? opts.hygiene.map(normalizeHygieneIssue) : void 0;
+  el.textContent = "";
+  const root = h("div", "kb-audit");
+  root.dataset.activeChannel = "all";
+  const bar = h("div", "kb-audit-bar");
+  const channels = h("div", "kb-audit-channels");
+  channels.setAttribute("role", "group");
+  channels.setAttribute("aria-label", "\u5BA1\u8BA1\u901A\u9053\u8FC7\u6EE4");
+  for (const [value, label] of CHANNEL_CHIPS) {
+    const chip = h("button", "kb-chip", label);
+    chip.type = "button";
+    chip.dataset.channel = value;
+    chip.setAttribute("aria-pressed", String(value === "all"));
+    channels.appendChild(chip);
+  }
+  bar.appendChild(channels);
+  const exportBtn = h("button", "kb-audit-export", "\u5BFC\u51FA CSV");
+  exportBtn.type = "button";
+  exportBtn.dataset.auditExport = "";
+  exportBtn.setAttribute("aria-label", "\u5BFC\u51FA\u5F53\u524D\u8FC7\u6EE4\u89C6\u56FE\u4E3A CSV");
+  bar.appendChild(exportBtn);
+  root.appendChild(bar);
+  if (hygiene) {
+    const section = h("div", "kb-audit-hygiene");
+    section.setAttribute("role", "list");
+    section.setAttribute("aria-label", "\u6743\u9650\u5F02\u5473");
+    if (!hygiene.length) {
+      section.appendChild(h("div", "kb-empty", "\u672A\u53D1\u73B0\u6743\u9650\u5F02\u5473"));
+    } else {
+      for (const issue of hygiene) {
+        const row = h("div", `kb-hygiene is-${issue.severity}`);
+        row.setAttribute("role", "listitem");
+        row.dataset.hygieneId = issue.id;
+        hygieneIssueMap.set(row, issue);
+        row.appendChild(h("span", "kb-badge kb-hygiene-kind", kbHygieneLabel(issue.kind)));
+        row.appendChild(h("span", "kb-hygiene-resource", issue.resource));
+        row.appendChild(h("span", "kb-num kb-hygiene-metric", issue.metric));
+        row.appendChild(h("span", "kb-meta kb-hygiene-hint", issue.hint));
+        const act = h("button", "kb-hygiene-act", "\u5904\u7F6E");
+        act.type = "button";
+        act.dataset.hygieneAct = "";
+        act.setAttribute("aria-label", `\u5904\u7F6E\uFF1A${kbHygieneLabel(issue.kind)} \xB7 ${issue.resource}`);
+        row.appendChild(act);
+        section.appendChild(row);
+      }
+    }
+    root.appendChild(section);
+  }
+  const list = h("ol", "kb-audit-list");
+  if (!entries.length) {
+    list.appendChild(h("li", "kb-empty", "\u6682\u65E0\u5BA1\u8BA1\u4E8B\u4EF6"));
+  } else {
+    for (const e of entries) {
+      const breakglass = e.breakGlass || e.action === "break_glass";
+      const row = h("li", `kb-audit-entry${breakglass ? " is-breakglass" : ""}`);
+      row.dataset.channel = auditChannelOf(e.action);
+      row.appendChild(h("span", "kb-audit-at kb-num", fmtStamp(e.at)));
+      const actor = h("span", "kb-audit-actor", e.actor.name);
+      actor.dataset.kind = e.actor.kind;
+      row.appendChild(actor);
+      row.appendChild(h("span", "kb-audit-action kb-chip", kbAuditActionLabel(e.action)));
+      row.appendChild(h("span", "kb-audit-detail", e.resource ? `${e.detail} \xB7 ${e.resource}` : e.detail));
+      if (breakglass) row.appendChild(h("span", "kb-meta kb-audit-alert", "\u5DF2\u5B9E\u65F6\u544A\u8B66\u5B89\u5168\u56E2\u961F"));
+      list.appendChild(row);
+    }
+  }
+  root.appendChild(list);
+  el.appendChild(root);
+  return el;
+}
+var noopDestroy = () => void 0;
+function initKbAudit(root) {
+  if (typeof document === "undefined") return noopDestroy;
+  const scope = root ?? document;
+  const marked = scope;
+  if (marked.__icenKbAuditInit) return noopDestroy;
+  marked.__icenKbAuditInit = true;
+  const target = scope;
+  const applyFilter = (auditRoot, channel) => {
+    auditRoot.dataset.activeChannel = channel;
+    auditRoot.querySelectorAll(".kb-audit-channels .kb-chip").forEach((chip) => {
+      chip.setAttribute("aria-pressed", String(chip.dataset.channel === channel));
+    });
+    auditRoot.querySelectorAll(".kb-audit-entry").forEach((row) => {
+      row.hidden = channel !== "all" && row.dataset.channel !== channel;
+    });
+  };
+  const onClick = (e) => {
+    const t = e.target instanceof Element ? e.target : null;
+    if (!t) return;
+    const actBtn = t.closest("[data-hygiene-act]");
+    if (actBtn) {
+      const row = actBtn.closest(".kb-hygiene");
+      const issue = row ? hygieneIssueMap.get(row) : void 0;
+      if (issue) emitIcen(actBtn, "icen:kb-hygiene-action", { issue });
+      return;
+    }
+    const auditRoot = t.closest(".kb-audit");
+    if (!auditRoot) return;
+    const chip = t.closest(".kb-audit-channels .kb-chip[data-channel]");
+    if (chip) {
+      const channel = chip.dataset.channel ?? "all";
+      applyFilter(auditRoot, channel);
+      emitIcen(chip, "icen:kb-audit-filter", { channel });
+      return;
+    }
+    const exportBtn = t.closest("[data-audit-export]");
+    if (exportBtn) {
+      const channel = auditRoot.dataset.activeChannel ?? "all";
+      emitIcen(exportBtn, "icen:kb-audit-export", { channel });
+    }
+  };
+  target.addEventListener("click", onClick);
+  return () => {
+    target.removeEventListener("click", onClick);
+    marked.__icenKbAuditInit = false;
+  };
+}
+export {
+  initKbAudit,
+  renderKbAudit
+};

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

@@ -0,0 +1,44 @@
+import { KbCanvasVersion } from './kb-core.js';
+import { renderAiDiff } from './ai-diff.js';
+import './ai-core.js';
+
+interface KbCanvasOptions {
+    /** 左栏最小占比（同时约束右栏 1-minRatio）；默认 0.2，钳制到 [0.05, 0.5] */
+    minRatio?: number;
+    /** icen:kb-canvas-ai 的 handle 通道（与事件双轨） */
+    onAI?: (detail: {
+        instruction: string;
+        selection?: {
+            text: string;
+        };
+    }) => void;
+    /** icen:kb-canvas-version 的 handle 通道（与事件双轨） */
+    onVersion?: (detail: {
+        versionId: string;
+    }) => void;
+}
+interface KbCanvasSelectionTool {
+    label: string;
+    instruction: string;
+}
+interface KbCanvasHandle {
+    /** 挂左栏（对话流）：Node 经 appendChild 接收（宿主保留所有权）；字符串按纯文本写入 */
+    setChat: (content?: Node | string | null) => void;
+    /** 挂右栏（文档）：同 setChat 语义 */
+    setDoc: (content?: Node | string | null) => void;
+    /** 右栏追加内联 diff（宿主传入已解析的 AiDiffFile[]，渲染复用 ai-diff） */
+    addDiff: (files: Parameters<typeof renderAiDiff>[1]['files']) => void;
+    /** 版本时间轴追加节点；current=true 时抢占高亮（其余去 current） */
+    addVersion: (v: KbCanvasVersion) => void;
+    /** 注入划词工具条工具（label + instruction）；空数组 = 关闭划词功能 */
+    setSelectionTools: (tools: KbCanvasSelectionTool[]) => void;
+    /** 摘监听/定时器并清空注入结构；可重复调用 */
+    destroy: () => void;
+}
+/**
+ * 创建双栏工作台画布句柄：左对话/右文档 + 比例拖拽 + 内联 diff 挂载 + 版本时间轴 +
+ * 划词 AI 工具条。事件：icen:kb-canvas-ai / icen:kb-canvas-version（均自画布根冒泡）。
+ */
+declare function createKbCanvas(el: HTMLElement, opts?: KbCanvasOptions): KbCanvasHandle;
+
+export { type KbCanvasHandle, type KbCanvasOptions, type KbCanvasSelectionTool, createKbCanvas };