@yuku123/z-cognition-kb-component 0.0.0-stage → 0.1.6

package/dist/ComponentDoc-nAcl8jMQ.js

@@ -0,0 +1,735 @@
+import { Routes as Se, Route as U, Navigate as xe } from "react-router-dom";
+import Te, { useState as f, useEffect as G } from "react";
+import { Button as Z, Space as pe, Select as X, Tag as J, Input as Ee, Card as _e, InputNumber as we, Alert as Pe, List as H } from "antd";
+import { ReloadOutlined as me, SearchOutlined as Re } from "@ant-design/icons";
+import { ErrorState as Q, LoadingState as ee, ListTable as he, EmptyState as ce, ComponentDoc as je } from "@yuku123/z-frontend-common/ui";
+var z = { exports: {} }, W = {};
+/**
+ * @license React
+ * react-jsx-runtime.production.js
+ *
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+var ie;
+function Ae() {
+  if (ie) return W;
+  ie = 1;
+  var t = Symbol.for("react.transitional.element"), s = Symbol.for("react.fragment");
+  function r(c, l, d) {
+    var p = null;
+    if (d !== void 0 && (p = "" + d), l.key !== void 0 && (p = "" + l.key), "key" in l) {
+      d = {};
+      for (var y in l)
+        y !== "key" && (d[y] = l[y]);
+    } else d = l;
+    return l = d.ref, {
+      $$typeof: t,
+      type: c,
+      key: p,
+      ref: l !== void 0 ? l : null,
+      props: d
+    };
+  }
+  return W.Fragment = s, W.jsx = r, W.jsxs = r, W;
+}
+var L = {};
+/**
+ * @license React
+ * react-jsx-runtime.development.js
+ *
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+var le;
+function Oe() {
+  return le || (le = 1, process.env.NODE_ENV !== "production" && (function() {
+    function t(e) {
+      if (e == null) return null;
+      if (typeof e == "function")
+        return e.$$typeof === fe ? null : e.displayName || e.name || null;
+      if (typeof e == "string") return e;
+      switch (e) {
+        case u:
+          return "Fragment";
+        case E:
+          return "Profiler";
+        case S:
+          return "StrictMode";
+        case a:
+          return "Suspense";
+        case b:
+          return "SuspenseList";
+        case ke:
+          return "Activity";
+        case ge:
+          return "ViewTransition";
+      }
+      if (typeof e == "object")
+        switch (typeof e.tag == "number" && console.error(
+          "Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."
+        ), e.$$typeof) {
+          case T:
+            return "Portal";
+          case K:
+            return e.displayName || "Context";
+          case I:
+            return (e._context.displayName || "Context") + ".Consumer";
+          case Y:
+            var o = e.render;
+            return e = e.displayName, e || (e = o.displayName || o.name || "", e = e !== "" ? "ForwardRef(" + e + ")" : "ForwardRef"), e;
+          case v:
+            return o = e.displayName || null, o !== null ? o : t(e.type) || "Memo";
+          case F:
+            o = e._payload, e = e._init;
+            try {
+              return t(e(o));
+            } catch {
+            }
+        }
+      return null;
+    }
+    function s(e) {
+      return "" + e;
+    }
+    function r(e) {
+      try {
+        s(e);
+        var o = !1;
+      } catch {
+        o = !0;
+      }
+      if (o) {
+        o = console;
+        var m = o.error, k = typeof Symbol == "function" && Symbol.toStringTag && e[Symbol.toStringTag] || e.constructor.name || "Object";
+        return m.call(
+          o,
+          "The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",
+          k
+        ), s(e);
+      }
+    }
+    function c(e) {
+      if (e === u) return "<>";
+      if (typeof e == "object" && e !== null && e.$$typeof === F)
+        return "<...>";
+      try {
+        var o = t(e);
+        return o ? "<" + o + ">" : "<...>";
+      } catch {
+        return "<...>";
+      }
+    }
+    function l() {
+      var e = B.A;
+      return e === null ? null : e.getOwner();
+    }
+    function d() {
+      return Error("react-stack-top-frame");
+    }
+    function p(e) {
+      if (te.call(e, "key")) {
+        var o = Object.getOwnPropertyDescriptor(e, "key").get;
+        if (o && o.isReactWarning) return !1;
+      }
+      return e.key !== void 0;
+    }
+    function y(e, o) {
+      function m() {
+        ne || (ne = !0, console.error(
+          "%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",
+          o
+        ));
+      }
+      m.isReactWarning = !0, Object.defineProperty(e, "key", {
+        get: m,
+        configurable: !0
+      });
+    }
+    function P() {
+      var e = t(this.type);
+      return se[e] || (se[e] = !0, console.error(
+        "Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release."
+      )), e = this.props.ref, e !== void 0 ? e : null;
+    }
+    function $(e, o, m, k, O, w) {
+      var g = m.ref;
+      return e = {
+        $$typeof: A,
+        type: e,
+        key: o,
+        props: m,
+        _owner: k
+      }, (g !== void 0 ? g : null) !== null ? Object.defineProperty(e, "ref", {
+        enumerable: !1,
+        get: P
+      }) : Object.defineProperty(e, "ref", { enumerable: !1, value: null }), e._store = {}, Object.defineProperty(e._store, "validated", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !0,
+        value: 0
+      }), Object.defineProperty(e, "_debugInfo", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !0,
+        value: null
+      }), Object.defineProperty(e, "_debugStack", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !0,
+        value: O
+      }), Object.defineProperty(e, "_debugTask", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !0,
+        value: w
+      }), Object.freeze && (Object.freeze(e.props), Object.freeze(e)), e;
+    }
+    function h(e, o, m, k, O, w) {
+      var g = o.children;
+      if (g !== void 0)
+        if (k)
+          if (be(g)) {
+            for (k = 0; k < g.length; k++)
+              R(g[k]);
+            Object.freeze && Object.freeze(g);
+          } else
+            console.error(
+              "React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead."
+            );
+        else R(g);
+      if (te.call(o, "key")) {
+        g = t(e);
+        var N = Object.keys(o).filter(function(ye) {
+          return ye !== "key";
+        });
+        k = 0 < N.length ? "{key: someKey, " + N.join(": ..., ") + ": ...}" : "{key: someKey}", ae[g + k] || (N = 0 < N.length ? "{" + N.join(": ..., ") + ": ...}" : "{}", console.error(
+          `A props object containing a "key" prop is being spread into JSX:
+  let props = %s;
+  <%s {...props} />
+React keys must be passed directly to JSX without using spread:
+  let props = %s;
+  <%s key={someKey} {...props} />`,
+          k,
+          g,
+          N,
+          g
+        ), ae[g + k] = !0);
+      }
+      if (g = null, m !== void 0 && (r(m), g = "" + m), p(o) && (r(o.key), g = "" + o.key), "key" in o) {
+        m = {};
+        for (var q in o)
+          q !== "key" && (m[q] = o[q]);
+      } else m = o;
+      return g && y(
+        m,
+        typeof e == "function" ? e.displayName || e.name || "Unknown" : e
+      ), $(
+        e,
+        g,
+        m,
+        l(),
+        O,
+        w
+      );
+    }
+    function R(e) {
+      j(e) ? e._store && (e._store.validated = 1) : typeof e == "object" && e !== null && e.$$typeof === F && (e._payload.status === "fulfilled" ? j(e._payload.value) && e._payload.value._store && (e._payload.value._store.validated = 1) : e._store && (e._store.validated = 1));
+    }
+    function j(e) {
+      return typeof e == "object" && e !== null && e.$$typeof === A;
+    }
+    var _ = Te, A = Symbol.for("react.transitional.element"), T = Symbol.for("react.portal"), u = Symbol.for("react.fragment"), S = Symbol.for("react.strict_mode"), E = Symbol.for("react.profiler"), I = Symbol.for("react.consumer"), K = Symbol.for("react.context"), Y = Symbol.for("react.forward_ref"), a = Symbol.for("react.suspense"), b = Symbol.for("react.suspense_list"), v = Symbol.for("react.memo"), F = Symbol.for("react.lazy"), ke = Symbol.for("react.activity"), ge = Symbol.for("react.view_transition"), fe = Symbol.for("react.client.reference"), B = _.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, te = Object.prototype.hasOwnProperty, be = Array.isArray, M = console.createTask ? console.createTask : function() {
+      return null;
+    };
+    _ = {
+      react_stack_bottom_frame: function(e) {
+        return e();
+      }
+    };
+    var ne, se = {}, re = _.react_stack_bottom_frame.bind(
+      _,
+      d
+    )(), oe = M(c(d)), ae = {};
+    L.Fragment = u, L.jsx = function(e, o, m) {
+      var k = 1e4 > B.recentlyCreatedOwnerStacks++;
+      if (k) {
+        var O = Error.stackTraceLimit;
+        Error.stackTraceLimit = 10;
+        var w = Error("react-stack-top-frame");
+        Error.stackTraceLimit = O;
+      } else w = re;
+      return h(
+        e,
+        o,
+        m,
+        !1,
+        w,
+        k ? M(c(e)) : oe
+      );
+    }, L.jsxs = function(e, o, m) {
+      var k = 1e4 > B.recentlyCreatedOwnerStacks++;
+      if (k) {
+        var O = Error.stackTraceLimit;
+        Error.stackTraceLimit = 10;
+        var w = Error("react-stack-top-frame");
+        Error.stackTraceLimit = O;
+      } else w = re;
+      return h(
+        e,
+        o,
+        m,
+        !0,
+        w,
+        k ? M(c(e)) : oe
+      );
+    };
+  })()), L;
+}
+var ue;
+function Ie() {
+  return ue || (ue = 1, process.env.NODE_ENV === "production" ? z.exports = Ae() : z.exports = Oe()), z.exports;
+}
+var n = Ie();
+const ve = "/api/kb", de = "default";
+async function i(t, s = {}) {
+  const r = await fetch(`${ve}${t}`, {
+    headers: { "Content-Type": "application/json", ...s.headers },
+    ...s
+  });
+  if (!r.ok) {
+    let d = "";
+    try {
+      const p = await r.text();
+      d = p ? ` · ${p.slice(0, 300)}` : "";
+    } catch {
+    }
+    throw new Error(`${r.status} ${r.statusText}${d}`);
+  }
+  if (r.status === 204) return null;
+  const c = await r.text();
+  if (!c) return null;
+  let l;
+  try {
+    l = JSON.parse(c);
+  } catch {
+    return c;
+  }
+  return (l == null ? void 0 : l.data) ?? l;
+}
+function Ce(t) {
+  return t.replace(/([a-z0-9])([A-Z])/g, "$1_$2").toLowerCase();
+}
+const De = /* @__PURE__ */ new Set(["frontmatter", "metadata", "properties", "config"]);
+function x(t, s = 0) {
+  if (Array.isArray(t)) return t.map((c) => x(c, s));
+  if (!t || typeof t != "object" || s > 3) return t;
+  const r = {};
+  for (const [c, l] of Object.entries(t)) {
+    const d = Ce(c), p = De.has(c) ? l : x(l, s + 1);
+    r[c] = p, d !== c && !(d in r) && (r[d] = p);
+  }
+  return r;
+}
+const D = {
+  // ── Workspaces（WorkspaceController，/api/kb/workspaces）────────────────
+  listWorkspaces: () => i("/workspaces"),
+  getWorkspace: (t) => i(`/workspaces/${encodeURIComponent(t)}`),
+  createWorkspace: (t) => i("/workspaces", { method: "POST", body: JSON.stringify(x(t)) }),
+  getWorkspaceStats: (t) => i(`/workspaces/${encodeURIComponent(t)}/statistics`),
+  // ── Documents（DocumentController，/api/kb/documents）──────────────────
+  // 上游是服务端分页 (offset/limit, 默认 0/20)，总数另走 /count
+  listDocuments: (t, s = 0, r = 20) => i(`/documents/${encodeURIComponent(t)}?offset=${s}&limit=${r}`),
+  getDocumentCount: (t) => i(`/documents/${encodeURIComponent(t)}/count`),
+  getDocument: (t, s) => i(`/documents/${encodeURIComponent(t)}/${encodeURIComponent(s)}`),
+  deleteDocument: (t, s) => i(`/documents/${encodeURIComponent(t)}/${encodeURIComponent(s)}`, { method: "DELETE" }),
+  // 建索引：body = {document:{...}, overwrite, extractGraph, workspace}
+  createDocument: (t) => i("/documents", { method: "POST", body: JSON.stringify(x(t)) }),
+  batchCreateDocuments: (t) => i("/documents/batch", { method: "POST", body: JSON.stringify(x(t)) }),
+  importMarkdown: (t) => i("/documents/markdown", { method: "POST", body: JSON.stringify(x(t)) }),
+  reindexDocument: (t, s) => i(`/documents/${encodeURIComponent(t)}/${encodeURIComponent(s)}/reindex`, { method: "POST" }),
+  listDocumentsByTags: (t, s = [], r = 0, c = 20) => {
+    const l = s.map((d) => `tags=${encodeURIComponent(d)}`).join("&");
+    return i(
+      `/documents/${encodeURIComponent(t)}/by-tags?${l}&offset=${r}&limit=${c}`
+    );
+  },
+  // ── Search（SearchController，/api/kb/search）──────────────────────────
+  // body: {query, workspace, mode(FUSION|VECTOR|KEYWORD|GRAPH|HYBRID), topK, ...}
+  search: (t) => i("/search", { method: "POST", body: JSON.stringify(x(t)) }),
+  // ── Chat（ChatController，/api/kb/chat）───────────────────────────────
+  chat: (t) => i("/chat", { method: "POST", body: JSON.stringify(x(t)) }),
+  createSession: (t) => i("/chat/sessions", { method: "POST", body: JSON.stringify(x(t)) }),
+  getSession: (t) => i(`/chat/sessions/${encodeURIComponent(t)}`),
+  listSessions: (t, s, r = 50) => {
+    const c = new URLSearchParams();
+    return t && c.set("workspace", t), s && c.set("userId", s), c.set("limit", String(r)), i(`/chat/sessions?${c.toString()}`);
+  },
+  deleteSession: (t) => i(`/chat/sessions/${encodeURIComponent(t)}`, { method: "DELETE" }),
+  chatInSession: (t, s) => i(`/chat/sessions/${encodeURIComponent(t)}/chat`, { method: "POST", body: JSON.stringify(x(s)) }),
+  // ── Graph（GraphController，/api/kb/graph）─────────────────────────────
+  // 注意：graph 没有裸根路由，第一条就是 /{workspace}/entities
+  listEntities: (t, s = 100) => i(`/graph/${encodeURIComponent(t)}/entities?limit=${s}`),
+  getEntity: (t, s) => i(`/graph/${encodeURIComponent(t)}/entities/${encodeURIComponent(s)}`),
+  getNeighbors: (t, s, r = 2) => i(`/graph/${encodeURIComponent(t)}/entities/${encodeURIComponent(s)}/neighbors?depth=${r}`),
+  // body 是实体名数组（List<String>）
+  getSubgraph: (t, s, r = 2) => i(`/graph/${encodeURIComponent(t)}/subgraph?depth=${r}`, {
+    method: "POST",
+    body: JSON.stringify(s)
+  }),
+  // ── Ingest（IngestController，/api/kb/ingest）──────────────────────────
+  listSources: () => i("/ingest/sources"),
+  getIngestStats: () => i("/ingest/stats"),
+  // 批量拉取可能很久：这里不设超时，交由浏览器/网关口径
+  runIngest: (t, s = {}) => i(`/ingest/run?sourceId=${encodeURIComponent(t)}`, {
+    method: "POST",
+    body: JSON.stringify(s)
+  }),
+  submitIngest: (t) => i("/ingest/submit", { method: "POST", body: JSON.stringify(x(t)) }),
+  // 通用 webhook 入口：body = {title, content, workspace, metadata}
+  webhook: (t, s = {}) => i("/ingest/webhook", {
+    method: "POST",
+    headers: s,
+    body: JSON.stringify(x(t))
+  }),
+  flushWebhook: () => i("/ingest/webhook/flush", { method: "POST" }),
+  // ── Modeling（ModelingController，/api/kb/modeling）────────────────────
+  // modeling 也没有裸根路由：/decompose 与 /cheatsheet
+  decompose: (t = de) => i(`/modeling/decompose?workspace=${encodeURIComponent(t)}`),
+  getCheatsheet: (t = de) => i(`/modeling/cheatsheet?workspace=${encodeURIComponent(t)}`),
+  // POST 版：body = ProductModel（整份模型）
+  createCheatsheet: (t) => i("/modeling/cheatsheet", { method: "POST", body: JSON.stringify(x(t)) })
+};
+function $e() {
+  const [t, s] = f([]), [r, c] = f(!0), [l, d] = f(null), p = async () => {
+    c(!0), d(null);
+    try {
+      const y = await D.listWorkspaces();
+      s(Array.isArray(y) ? y : []);
+    } catch (y) {
+      d(y.message);
+    } finally {
+      c(!1);
+    }
+  };
+  return G(() => {
+    p();
+  }, []), /* @__PURE__ */ n.jsx("div", { children: l ? (
+    // 页面级错误：走共享基座 ErrorState（就近显示原因 + 重试入口），
+    // 不用手写红字 div —— 全仓错误态口径统一。
+    /* @__PURE__ */ n.jsx(
+      Q,
+      {
+        error: l,
+        title: "工作空间列表加载失败",
+        description: "确认 z-kb 后端已启动且 /api/kb/workspaces 可达。",
+        onRetry: p
+      }
+    )
+  ) : r ? /* @__PURE__ */ n.jsx(ee, { variant: "table", rows: 4 }) : /* @__PURE__ */ n.jsx(
+    he,
+    {
+      cardTitle: "知识库工作空间",
+      rows: t,
+      rowKey: "id",
+      columns: [
+        { title: "名称", dataIndex: "name", key: "name" },
+        { title: "描述", dataIndex: "description", key: "description" },
+        // 字段名按实测响应写：z-team-core 的全局 SNAKE_CASE 会把这些 VO 转成下划线键
+        { title: "文档数", dataIndex: "document_count", key: "document_count" },
+        { title: "切片数", dataIndex: "chunk_count", key: "chunk_count" },
+        { title: "实体数", dataIndex: "entity_count", key: "entity_count" },
+        { title: "关系数", dataIndex: "relation_count", key: "relation_count" },
+        {
+          title: "状态",
+          dataIndex: "active",
+          key: "active",
+          render: (y) => y === !1 ? "未启用" : "启用"
+        },
+        { title: "创建时间", dataIndex: "created_at", key: "created_at" }
+      ],
+      searchKeys: "name,description",
+      searchPlaceholder: "按工作空间名 / 描述过滤",
+      emptyTitle: "还没有工作空间",
+      emptyDescription: "接口通了，但一个工作空间也没有。先在「数据接入」里创建或拉取一个工作空间。",
+      cardExtra: /* @__PURE__ */ n.jsx(Z, { icon: /* @__PURE__ */ n.jsx(me, {}), loading: r, onClick: p, children: "刷新" })
+    }
+  ) });
+}
+const V = 20;
+function Ne() {
+  const [t, s] = f([]), [r, c] = f(null), [l, d] = f([]), [p, y] = f(null), [P, $] = f(1), [h, R] = f(0), [j, _] = f(!1), [A, T] = f(null);
+  return G(() => {
+    D.listWorkspaces().then((u) => {
+      const S = Array.isArray(u) ? u : [];
+      s(S), S.length > 0 && c(S[0].name);
+    }).catch((u) => T(u.message));
+  }, []), G(() => {
+    if (!r) return;
+    let u = !1;
+    _(!0), T(null);
+    const S = (P - 1) * V;
+    return Promise.all([
+      D.listDocuments(r, S, V),
+      D.getDocumentCount(r)
+    ]).then(([E, I]) => {
+      u || (d(Array.isArray(E) ? E : []), y(Number(I == null ? void 0 : I.count)));
+    }).catch((E) => {
+      u || T(E.message);
+    }).finally(() => {
+      u || _(!1);
+    }), () => {
+      u = !0;
+    };
+  }, [r, P, h]), /* @__PURE__ */ n.jsxs("div", { children: [
+    /* @__PURE__ */ n.jsx(pe, { style: { marginBottom: 12 }, children: /* @__PURE__ */ n.jsx(
+      X,
+      {
+        value: r,
+        onChange: (u) => {
+          c(u), $(1);
+        },
+        style: { width: 200 },
+        placeholder: "选择工作空间",
+        options: t.map((u) => ({ label: u.name, value: u.name }))
+      }
+    ) }),
+    A ? (
+      // 页面级错误：走共享基座 ErrorState（原因 + 重试入口），不用手写红字 div。
+      /* @__PURE__ */ n.jsx(Q, { error: A, title: "文档列表加载失败", onRetry: () => R((u) => u + 1) })
+    ) : j ? /* @__PURE__ */ n.jsx(ee, { variant: "table", rows: 4 }) : /* @__PURE__ */ n.jsx(
+      he,
+      {
+        cardTitle: `文档管理${p === null ? "" : `（${r} 共 ${p} 篇）`}`,
+        rows: l,
+        rowKey: "id",
+        columns: [
+          { title: "标题", dataIndex: "title", key: "title" },
+          { title: "分类", dataIndex: "category", key: "category" },
+          { title: "状态", dataIndex: "status", key: "status" },
+          { title: "字数", dataIndex: "word_count", key: "word_count" },
+          { title: "切片数", dataIndex: "chunk_count", key: "chunk_count" },
+          {
+            title: "标签",
+            dataIndex: "tags",
+            key: "tags",
+            render: (u) => Array.isArray(u) ? u.map((S) => /* @__PURE__ */ n.jsx(J, { children: S }, S)) : u
+          },
+          { title: "更新时间", dataIndex: "updated_at", key: "updated_at" }
+        ],
+        searchKeys: "title,category,status",
+        searchPlaceholder: "按标题 / 分类 / 状态过滤",
+        emptyTitle: "暂无文档",
+        emptyDescription: r ? `接口通了，${r} 下没有文档` : "请先选择工作空间",
+        cardExtra: /* @__PURE__ */ n.jsx(Z, { icon: /* @__PURE__ */ n.jsx(me, {}), loading: j, onClick: () => R((u) => u + 1), children: "刷新" }),
+        pagination: {
+          current: P,
+          pageSize: V,
+          total: Number.isNaN(p) ? l.length : p,
+          showSizeChanger: !1,
+          onChange: $
+        }
+      }
+    )
+  ] });
+}
+const { TextArea: We } = Ee, Le = [
+  { value: "FUSION", label: "FUSION（向量+关键词+图谱，RRF）" },
+  { value: "HYBRID", label: "HYBRID（向量+关键词）" },
+  { value: "KEYWORD", label: "KEYWORD（仅 BM25）" },
+  { value: "VECTOR", label: "VECTOR（仅向量）" },
+  { value: "GRAPH", label: "GRAPH（仅图谱）" }
+], C = (t) => t == null || t === "" ? null : Number(t), Ue = (t) => t.context_title || (Array.isArray(t.heading_path) && t.heading_path.length ? t.heading_path.join(" > ") : null) || t.document_id;
+function ze() {
+  const [t, s] = f([]), [r, c] = f("default"), [l, d] = f(""), [p, y] = f("FUSION"), [P, $] = f(10), [h, R] = f(null), [j, _] = f(!1), [A, T] = f(null);
+  G(() => {
+    D.listWorkspaces().then((a) => {
+      const b = Array.isArray(a) ? a : [];
+      s(b.map((v) => ({ label: v.name, value: v.name }))), b.length > 0 && c(b[0].name);
+    }).catch((a) => T(a.message));
+  }, []);
+  const u = async () => {
+    const a = l.trim();
+    if (a) {
+      _(!0), T(null);
+      try {
+        const b = await D.search({ query: a, workspace: r, mode: p, top_k: P });
+        R(b && typeof b == "object" ? b : null);
+      } catch (b) {
+        T(b.message), R(null);
+      } finally {
+        _(!1);
+      }
+    }
+  }, S = Array.isArray(h == null ? void 0 : h.hits) ? h.hits : [], E = (h == null ? void 0 : h.stats) || {}, I = Array.isArray(h == null ? void 0 : h.matched_entities) ? h.matched_entities : [], K = ["FUSION", "HYBRID", "VECTOR"].includes(p) && C(E.vector) === 0, Y = () => {
+    T(null), D.listWorkspaces().then((a) => {
+      const b = Array.isArray(a) ? a : [];
+      s(b.map((v) => ({ label: v.name, value: v.name }))), b.length > 0 && c(b[0].name);
+    }).catch((a) => T(a.message)), l.trim() && u();
+  };
+  return /* @__PURE__ */ n.jsxs(_e, { title: "知识库检索", children: [
+    /* @__PURE__ */ n.jsxs("div", { style: { display: "flex", gap: 8, marginBottom: 16, flexWrap: "wrap" }, children: [
+      /* @__PURE__ */ n.jsx(
+        X,
+        {
+          value: r,
+          onChange: c,
+          style: { width: 160 },
+          options: t.length > 0 ? t : [{ label: "default", value: "default" }]
+        }
+      ),
+      /* @__PURE__ */ n.jsx(
+        We,
+        {
+          value: l,
+          onChange: (a) => d(a.target.value),
+          placeholder: "输入搜索关键词...",
+          autoSize: { minRows: 1, maxRows: 3 },
+          style: { flex: 1, minWidth: 240 },
+          onPressEnter: (a) => {
+            a.shiftKey || (a.preventDefault(), u());
+          }
+        }
+      ),
+      /* @__PURE__ */ n.jsx(X, { value: p, onChange: y, style: { width: 260 }, options: Le }),
+      /* @__PURE__ */ n.jsx(
+        we,
+        {
+          value: P,
+          onChange: (a) => $(a ?? 10),
+          min: 1,
+          max: 100,
+          addonBefore: "条数",
+          style: { width: 130 }
+        }
+      ),
+      /* @__PURE__ */ n.jsx(Z, { type: "primary", icon: /* @__PURE__ */ n.jsx(Re, {}), loading: j, onClick: u, children: "搜索" })
+    ] }),
+    A && /* @__PURE__ */ n.jsx(Q, { error: A, title: "检索失败", onRetry: Y, style: { marginBottom: 16 } }),
+    j ? /* @__PURE__ */ n.jsx(ee, { variant: "list", rows: 3 }) : h ? /* @__PURE__ */ n.jsxs(n.Fragment, { children: [
+      /* @__PURE__ */ n.jsxs("div", { style: { marginBottom: 8, color: "#475569", fontSize: 13 }, children: [
+        "命中 ",
+        /* @__PURE__ */ n.jsx("b", { children: C(h.total_hits) ?? S.length }),
+        " 条 · 耗时 ",
+        /* @__PURE__ */ n.jsx("b", { children: C(h.elapsed_millis) }),
+        " ms · 模式 ",
+        /* @__PURE__ */ n.jsx("b", { children: h.mode }),
+        " · 召回分布 向量 ",
+        /* @__PURE__ */ n.jsx("b", { children: C(E.vector) ?? 0 }),
+        "/ 关键词 ",
+        /* @__PURE__ */ n.jsx("b", { children: C(E.keyword) ?? 0 }),
+        " / 图谱 ",
+        /* @__PURE__ */ n.jsx("b", { children: C(E.graph) ?? 0 })
+      ] }),
+      K && /* @__PURE__ */ n.jsx(
+        Pe,
+        {
+          type: "warning",
+          showIcon: !0,
+          style: { marginBottom: 16 },
+          message: "向量召回恒为 0：不是没有向量，而是 L3 读写两侧集合名不一致",
+          description: /* @__PURE__ */ n.jsxs("span", { children: [
+            "collection ",
+            /* @__PURE__ */ n.jsx("code", { children: "kb_default_chunks_chunks" }),
+            " 实测已存 11624 条 512 维向量， 但读侧 ",
+            /* @__PURE__ */ n.jsx("code", { children: "HybridSearcher.java:42" }),
+            " 用 ",
+            /* @__PURE__ */ n.jsx("code", { children: '"kb_chunks"' }),
+            "、 写侧 ",
+            /* @__PURE__ */ n.jsx("code", { children: "DefaultKnowledgeBaseService.java:48" }),
+            " 用 ",
+            /* @__PURE__ */ n.jsx("code", { children: '"chunks"' }),
+            "， 拼出的物理名 ",
+            /* @__PURE__ */ n.jsx("code", { children: "kb_default_chunks_kb_chunks" }),
+            " 不存在 ⇒",
+            /* @__PURE__ */ n.jsx("code", { children: "hasCollection()" }),
+            " 恒 false，向量分支静默返回空。 当前有效召回只有关键词与图谱两路。"
+          ] })
+        }
+      ),
+      S.length === 0 ? /* @__PURE__ */ n.jsx(
+        ce,
+        {
+          title: "没有召回到内容",
+          description: `接口通了，但「${h.query}」在该工作空间无召回（图谱实体 ${I.length} 个）`
+        }
+      ) : /* @__PURE__ */ n.jsx(
+        H,
+        {
+          dataSource: S,
+          renderItem: (a) => {
+            var b;
+            return /* @__PURE__ */ n.jsx(H.Item, { align: "top", children: /* @__PURE__ */ n.jsx(
+              H.Item.Meta,
+              {
+                title: /* @__PURE__ */ n.jsxs("span", { style: { fontSize: 14 }, children: [
+                  Ue(a),
+                  " ",
+                  /* @__PURE__ */ n.jsxs(pe, { size: 4, style: { display: "inline-flex" }, children: [
+                    /* @__PURE__ */ n.jsx(J, { children: a.source }),
+                    /* @__PURE__ */ n.jsxs(J, { color: "blue", children: [
+                      "score ",
+                      (b = C(a.score)) == null ? void 0 : b.toFixed(4)
+                    ] }),
+                    a.ordinal !== null && /* @__PURE__ */ n.jsxs(J, { children: [
+                      "分片 #",
+                      a.ordinal
+                    ] })
+                  ] })
+                ] }),
+                description: /* @__PURE__ */ n.jsxs(n.Fragment, { children: [
+                  /* @__PURE__ */ n.jsx(
+                    "div",
+                    {
+                      style: {
+                        whiteSpace: "pre-wrap",
+                        maxHeight: 180,
+                        overflow: "auto",
+                        fontSize: 13,
+                        color: "#334155",
+                        background: "#f8fafc",
+                        padding: 8,
+                        borderRadius: 4
+                      },
+                      children: a.content || "（该命中无正文：include_content 未开或切片正文为空）"
+                    }
+                  ),
+                  /* @__PURE__ */ n.jsxs("div", { style: { fontSize: 12, color: "#94a3b8", marginTop: 4 }, children: [
+                    "chunk ",
+                    a.chunk_id,
+                    " · doc ",
+                    a.document_id,
+                    Array.isArray(a.heading_path) && a.heading_path.length > 0 ? ` · 路径 ${a.heading_path.join(" / ")}` : "",
+                    Array.isArray(a.matched_entities) && a.matched_entities.length > 0 ? ` · 实体 ${a.matched_entities.join(", ")}` : ""
+                  ] })
+                ] })
+              }
+            ) }, a.chunk_id);
+          }
+        }
+      )
+    ] }) : /* @__PURE__ */ n.jsx(ce, { title: "输入关键词开始搜索", description: "例如「InfluxDB 写入性能优化」，回车即搜。" })
+  ] });
+}
+function Me() {
+  return /* @__PURE__ */ n.jsxs(Se, { children: [
+    /* @__PURE__ */ n.jsx(U, { index: !0, element: /* @__PURE__ */ n.jsx(xe, { to: "workspaces", replace: !0 }) }),
+    /* @__PURE__ */ n.jsx(U, { path: "workspaces", element: /* @__PURE__ */ n.jsx($e, {}) }),
+    /* @__PURE__ */ n.jsx(U, { path: "documents", element: /* @__PURE__ */ n.jsx(Ne, {}) }),
+    /* @__PURE__ */ n.jsx(U, { path: "search", element: /* @__PURE__ */ n.jsx(ze, {}) })
+  ] });
+}
+const Je = "# z-kb-component\n\nz-kb（知识库）跨仓唯一前端面：把「工作区 / 文档 / 数据接入 / 建模 / 检索 / 图谱 / 对话」\n这一组知识库页面收敛成一个可复用的 React 组件包，由 `z-kb-suit` 独立壳、z-team 的\nOpsWorkbench（`/kb/*` 通配挂载）或 z-opc 主壳挂载。\n\n- **npm 包名**：`@yuku123/z-kb-component`\n- **宿主接入**：`@yuku123/z-kb-component/pages`（manifest + 页面组件），主壳可只取 `ComponentDocPage`\n- **后端**：z-kb-web 的 `/api/kb/**`（7 个 controller，真实路由 33 条）\n- **技术栈**：React 19 + antd 6 + react-router-dom 7 + echarts 5 + vite\n  （library mode，双入口 `.` / `./pages`）\n\n---\n\n## 一、能力概览\n\n这个包里有**两套**页面树、**两套**请求层，路由前缀也不同，别混：\n\n### 1.1 manifest 面（`/z-kb/*`，`src/pages-manifest.jsx`）\n\n| 页面 | 路由（相对 `/z-kb/*`） | 源文件 | 能力 |\n|------|--------------------------|--------|------|\n| 首页 | `home` | `pages/HomePage.jsx` | 读 `userInfo` 显示登录人，按 `menuItems` 渲染功能入口卡片 |\n| 总览 | `dashboard` | `kb/pages/Dashboard.tsx` | 工作区统计（文档数 / 分块数 / 实体数…） |\n| 文档 | `documents` | `kb/pages/Documents.tsx` | 文档入库 / 重建索引 / 删除 |\n| 数据接入 | `ingest` | `kb/pages/DataSources.tsx` | 数据源清单 + 批量接入 + webhook |\n| 建模 | `modeling` | `kb/pages/ModelingPage.tsx` | 拆解工作台 + 小抄（cheatsheet） |\n| 检索 | `search` | `kb/pages/SearchPage.tsx` | 混合检索（向量 / 关键词 / 图谱 / 融合） |\n| 图谱 | `graph` | `kb/pages/GraphPage.tsx` | 实体邻域 / 子图（echarts） |\n| 对话 | `chat` | `kb/pages/ChatPage.tsx` | 会话式问答 |\n| 登录 | （不在菜单内） | `pages/LoginPage.jsx` | mock 登录，写 `token` / `userInfo` 后跳 `/z-kb/home` |\n| 组件文档 | `docs` | `pages/ComponentDoc.jsx` | 本文件渲染页（左侧 240px TOC + 右侧正文） |\n\n`manifest` 里这 7 个 kb 页面都套了一层 `withKbWorkspace(...)`（`kb/workspaceHook`），\n由它统一注入当前工作区。\n\n### 1.2 KbApp 面（`/kb/*`，`src/pages/KbApp.jsx`）\n\n`KbApp` 是给 OpsWorkbench 通配挂载用的**子路由集合**，入口重定向到 `workspaces`：\n\n| 子路由 | 源文件 | 能力 |\n|--------|--------|------|\n| `workspaces` | `pages/WorkspaceListPage.jsx` | 工作区清单 + 统计 |\n| `documents` | `pages/DocumentListPage.jsx` | 文档清单（服务端分页）+ 删除 |\n| `search` | `pages/SearchPage.jsx` | 检索（JS 版页面，与 `kb/pages/SearchPage.tsx` **是两个不同文件**） |\n\n### 1.3 两套请求层\n\n| 层 | 文件 | 出口 | 用在哪些页面 |\n|----|------|------|--------------|\n| TS 版（axios） | `src/kb/services/api.ts` | `DocAPI` / `SearchAPI` / `GraphAPI` / `WorkspaceAPI` / `ChatAPI` / `IngestAPI` / `ModelingAPI` | `kb/pages/*.tsx` 全部 7 个页面 |\n| JS 版（fetch） | `src/services/api.js` | `kbApi` | `pages/WorkspaceListPage.jsx` / `pages/DocumentListPage.jsx` / `pages/SearchPage.jsx` |\n\n主入口（`.` 桶）导的是 **JS 版**的 `kbApi`；`./pages` 桶导的是 **TS 版**的\n`DocAPI` / `SearchAPI` / `GraphAPI` / `WorkspaceAPI`。\n\n## 二、导出面\n\n```js\n// 主入口（. 桶）：JS 版请求层 + 域挂载点\nimport {kbApi, toNumber, DEFAULT_WORKSPACE, KbApp} from '@yuku123/z-kb-component'\n\n// 宿主组装面（./pages 桶）：manifest + 页面组件（TS 版请求层也从这里出）\nimport {menuItems, routes, appMeta, HomePage, LoginPage,\n        DocAPI, SearchAPI, GraphAPI, WorkspaceAPI,\n        withKbWorkspace, useKbWorkspace, ComponentDocPage} from '@yuku123/z-kb-component/pages'\n\n// 组件文档页（主壳接线用，名字全仓统一）\nimport {ComponentDocPage} from '@yuku123/z-kb-component'\n```\n\n## 三、API 端点\n\n后端前缀 `/api/kb`。下表路径是 `src/kb/services/api.ts` 与 `src/services/api.js`\n里出现的**实际路径**（两层的路径口径一致，只是实现不同）。\n\n### 3.1 工作区\n\n| 方法 | 路径 | 说明 |\n|---|---|---|\n| GET | `/api/kb/workspaces` | 工作区列表 |\n| POST | `/api/kb/workspaces` | 新建工作区 |\n| GET | `/api/kb/workspaces/{name}` | 单个工作区 |\n| GET | `/api/kb/workspaces/{name}/statistics` | 工作区统计 |\n\n### 3.2 文档\n\n| 方法 | 路径 | 说明 |\n|---|---|---|\n| POST | `/api/kb/documents` | 建索引（body：`{document, overwrite, extractGraph, workspace}`） |\n| POST | `/api/kb/documents/batch` | 批量建索引 |\n| POST | `/api/kb/documents/markdown` | 导入 markdown |\n| GET | `/api/kb/documents/{workspace}` | 文档列表（query：`offset` / `limit`，服务端分页） |\n| GET | `/api/kb/documents/{workspace}/count` | 文档总数 |\n| GET | `/api/kb/documents/{workspace}/by-tags` | 按标签查文档（query：`tags` / `offset` / `limit`） |\n| GET | `/api/kb/documents/{workspace}/{id}` | 单篇文档 |\n| DELETE | `/api/kb/documents/{workspace}/{id}` | 删除文档 |\n| POST | `/api/kb/documents/{workspace}/{id}/reindex` | 重建索引 |\n\n### 3.3 检索 / 对话\n\n| 方法 | 路径 | 说明 |\n|---|---|---|\n| POST | `/api/kb/search` | 检索（body：`{query, workspace, mode, topK, ...}`，`mode` ∈ `FUSION`/`VECTOR`/`KEYWORD`/`GRAPH`/`HYBRID`） |\n| POST | `/api/kb/chat` | 单轮问答 |\n| POST | `/api/kb/chat/sessions` | 建会话 |\n| GET | `/api/kb/chat/sessions` | 会话列表（query：`workspace` / `userId` / `limit`） |\n| GET | `/api/kb/chat/sessions/{id}` | 单个会话 |\n| DELETE | `/api/kb/chat/sessions/{id}` | 删会话 |\n| POST | `/api/kb/chat/sessions/{id}/chat` | 会话内追问 |\n\n### 3.4 图谱\n\n| 方法 | 路径 | 说明 |\n|---|---|---|\n| GET | `/api/kb/graph/{workspace}/entities` | 实体列表（query：`limit`） |\n| GET | `/api/kb/graph/{workspace}/entities/{name}` | 单个实体 |\n| GET | `/api/kb/graph/{workspace}/entities/{name}/neighbors` | 邻域（query：`depth`） |\n| POST | `/api/kb/graph/{workspace}/subgraph?depth=` | 子图（body 是实体名数组） |\n\n### 3.5 数据接入 / 建模\n\n| 方法 | 路径 | 说明 |\n|---|---|---|\n| GET | `/api/kb/ingest/sources` | 数据源清单 + 支持的类型 |\n| GET | `/api/kb/ingest/stats` | 接入统计 |\n| POST | `/api/kb/ingest/run?sourceId=` | 跑一次接入 |\n| POST | `/api/kb/ingest/submit` | 批量提交接入 |\n| POST | `/api/kb/ingest/webhook` | 通用 webhook 入口 |\n| POST | `/api/kb/ingest/webhook/flush` | flush webhook 队列 |\n| GET | `/api/kb/modeling/decompose?workspace=` | 拆解工作台 |\n| GET | `/api/kb/modeling/cheatsheet?workspace=` | 取小抄 |\n| POST | `/api/kb/modeling/cheatsheet` | 写回小抄（body 是整份 ProductModel） |\n\n## 四、页面说明\n\n### 4.1 首页\n\n登录后的着陆页。读 `localStorage.userInfo` 显示欢迎语与角色标签，再把 `menuItems`（去掉首页自身）\n渲染成入口卡片 —— 菜单加一项，首页卡片自动多一张，不用改页面代码。\n\n### 4.2 总览 / 文档 / 数据接入 / 建模 / 检索 / 图谱 / 对话\n\n这 7 个页面在 `src/kb/pages/` 下（`.tsx`），都套 `withKbWorkspace` 注入当前工作区：\n\n- **总览**：工作区统计（文档数 / 分块数 / 实体数 / 命中率等）。\n- **文档**：文档入库（`overwrite` / `extractGraph` 开关）、重建索引、删除。\n- **数据接入**：数据源清单（`sourceId` / 类型 / 启用与否）+ 批量接入 + webhook 入口。\n- **建模**：拆解工作台（慢接口，可能 1–3 分钟）+ 小抄（cheatsheet）读写。\n- **检索**：按 `mode` 切 向量 / 关键词 / 图谱 / 融合检索。\n- **图谱**：实体邻域与子图，用 echarts 画（源码引的是 tree-shaken 子路径）。\n- **对话**：会话式问答。\n\n### 4.3 工作区 / 文档清单 / 检索（KbApp 面）\n\n`src/pages/` 下的三个 JS 页面：**工作区**清单 + 统计、**文档**清单（服务端分页，\n总数另走 `/count`）、**检索**。⚠ `pages/SearchPage.jsx` 与 `kb/pages/SearchPage.tsx`\n**是两个不同的文件**（前者用 `kbApi`，后者用 `SearchAPI`），改一个不会影响另一个。\n\n### 4.4 登录\n\n当前是 **mock 模式**：比对一对写死在 `src/pages/LoginPage.jsx` 里的管理员凭据\n（明文口令不在本文复述，见源码），成功后写 `localStorage.token` 与 `localStorage.userInfo`，\n再 `window.location.href = '/z-kb/home'`。CTC/SSO 尚未接入。\n\n### 4.5 组件文档\n\n本文件。内容以 `?raw` 在编译期内联，零额外请求；左侧 240px TOC 随滚动联动。\n\n## 五、配置\n\n| 配置项 | 默认值 | 说明 |\n|---|---|---|\n| 后端前缀 | `/api/kb` | 两层请求层都用这个前缀 |\n| 默认工作区 | `default` | `DEFAULT_WORKSPACE` |\n| 普通请求超时 | `30000` ms | TS 版 axios 实例 |\n| 慢请求超时 | `300000` ms | TS 版 `slowApi`（建模 / 大批量 ingest 用） |\n| 文档分页 | `offset=0` / `limit=20` | JS 版 `listDocuments` 的默认页长 |\n| 实体列表条数 | `100` | `listEntities` 的默认 `limit` |\n\n## 六、已知限制\n\n- ⚠ **请求体字段两种拼写都发**：宿主（z-opc）全局 Jackson 是 `SNAKE_CASE`，\n  z-kb 单跑则是 camelCase。⇒ JS 版 `wire()` 给每个 camelCase 键**补一个 snake_case 别名**\n  （不删原键），Boot 默认忽略未知属性 ⇒ 两边都收得下。\n  实测宿主里 `top_k` 生效、`topK` 被忽略。\n  `frontmatter` / `metadata` / `properties` / `config` 四个键是**用户自己的 map**，\n  键名任意，不改写。\n- ⚠ **响应字段在宿主里是下划线 + 字符串**：宿主把 long 序列化成字符串\n  （`document_count` / `chunk_count` / `created_at` / `count`）。\n  JS 版请求层**不改响应形状**（改了会连带把 `WorkspaceListPage` / `DocumentListPage` 弄坏），\n  需要数值时用 `toNumber()`。\n- **两套请求层并存**：TS 版走 axios（有超时、有 `slowApi`），JS 版走原生 `fetch`\n  （**没有超时**，慢请求靠浏览器/网关口径）。两层的响应解包口径也不同。\n- **同名不同文件**：`pages/SearchPage.jsx` ≠ `kb/pages/SearchPage.tsx`；\n  `DocumentListPage` / `WorkspaceListPage` 也只在 JS 层存在。\n- `kbApi` 的 `createDocument` / `batchCreateDocuments` / `importMarkdown` / `reindexDocument` /\n  `listDocumentsByTags` / `getDocument` / `deleteDocument` / `getWorkspace` / `createWorkspace` /\n  `getWorkspaceStats` / `chat` / `createSession` / `getSession` / `listSessions` /\n  `deleteSession` / `chatInSession` / `listEntities` / `getEntity` / `getNeighbors` /\n  `getSubgraph` / `listSources` / `getIngestStats` / `runIngest` / `submitIngest` /\n  `webhook` / `flushWebhook` / `decompose` / `getCheatsheet` / `createCheatsheet`\n  在 **JS 层定义了但当前没有页面调用**（这些页面对应的是 TS 版那套）。\n- **graph / ingest / modeling 三个 controller 没有裸根路由**：\n  第一条就是 `/{workspace}/...` 或 `/sources`、`/stats`、`/decompose`。\n- echarts 走 tree-shaken 子路径（`echarts/core`、`echarts/charts`、`echarts-for-react/lib/core`），\n  `vite.config.js` 用函数式 `external` 把 `echarts/` 与 `echarts-for-react/` 前缀整体外置 ——\n  否则本包会多带 800KB+ 的 echarts，且绕开宿主的按需注册能力。\n- z-kb 已被 z-opc 主壳的 `domainRoutes.ts` 与 z-team 的 OpsWorkbench 引用\n  ⇒ `/z-kb/docs` 在平台主壳里**可达**。\n\n## 七、变更记录\n\n| 版本 | 变更 |\n|---|---|\n| 0.1.2 | 新增组件文档页 `ComponentDocPage`（lead 008 §7）：`src/DOC.md` + 基座 `ComponentDoc` 薄包装 |\n| 0.1.2 | 首版：工作区 / 文档 / 接入 / 建模 / 检索 / 图谱 / 对话页面集 + manifest + KbApp 挂载点 |\n";
+function qe() {
+  return /* @__PURE__ */ n.jsx(je, { markdown: Je, title: "组件文档 — z-kb" });
+}
+export {
+  qe as C,
+  Me as K,
+  n as j,
+  D as k
+};