@linkmind_claw/openclaw-faq-kb 1.0.0

package/README.md

@@ -0,0 +1,61 @@
+# @linkmind_claw/openclaw-faq-kb
+
+OpenClaw Plugin — FAQ Knowledge Base: one-click document training & intelligent Q&A.
+
+## Installation
+
+```bash
+openclaw plugins install @linkmind_claw/openclaw-faq-kb
+```
+
+Or install from npm directly:
+
+```bash
+npm install @linkmind_claw/openclaw-faq-kb
+```
+
+## Configuration
+
+In your OpenClaw config, set:
+
+```json
+{
+  "faq-knowledge-base": {
+    "apiBaseUrl": "http://67.212.146.21:8999",
+    "apiToken": ""
+  }
+}
+```
+
+| Field | Default | Description |
+|-------|---------|-------------|
+| `apiBaseUrl` | `http://67.212.146.21:8999` | FAQ KB API server address |
+| `apiToken` | (empty = auto-acquire) | Static API token, or leave empty for auto-renewal |
+| `pollIntervalMs` | `8000` | Pipeline progress poll interval (ms) |
+| `pipelineTimeoutMs` | `1200000` | Pipeline timeout (ms), default 20 min |
+
+## Tools Provided
+
+| Tool | Description |
+|------|-------------|
+| `faq_kb_create_and_train` | Create a knowledge base + upload document + full auto-pipeline training |
+| `faq_kb_query` | Ask a question against a trained knowledge base |
+| `faq_kb_manage` | FAQ CRUD: create, update, delete, list, get |
+| `faq_kb_list` | Knowledge base management: list, detail, delete, system status |
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## Publishing
+
+```bash
+npm run build
+npm publish --access public
+# or
+clawhub publish
+```

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * OpenClaw Plugin entry — FAQ Knowledge Base
+ *
+ * Registers four agent tools that wrap the 8999 FAQ KB API into
+ * high-level workflow operations:
+ *
+ *   1. faq_kb_create_and_train  — one-click: create KB + auto-pipeline
+ *   2. faq_kb_query             — intelligent Q&A
+ *   3. faq_kb_manage            — FAQ CRUD
+ *   4. faq_kb_list              — KB inventory & system status
+ */
+interface PluginConfig {
+    apiBaseUrl?: string;
+    apiToken?: string;
+    pollIntervalMs?: number;
+    pipelineTimeoutMs?: number;
+}
+interface ToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}
+interface ToolDef<P> {
+    name: string;
+    label?: string;
+    description: string;
+    parameters: unknown;
+    execute: (toolCallId: string, params: P) => Promise<ToolResult>;
+}
+interface PluginApi {
+    getConfig: () => PluginConfig;
+    registerTool: <P>(def: ToolDef<P>) => void;
+}
+interface PluginEntry {
+    id: string;
+    name: string;
+    description: string;
+    register: (api: PluginApi) => void;
+}
+declare const _default: PluginEntry;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA+BH,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAOD,UAAU,UAAU;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,UAAU,OAAO,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACjE;AAED,UAAU,SAAS;IACjB,SAAS,EAAE,MAAM,YAAY,CAAC;IAC9B,YAAY,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CAC5C;AAED,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC;CACpC;;AAQD,wBAiFG"}

package/dist/index.js

@@ -0,0 +1,91 @@
+/**
+ * OpenClaw Plugin entry — FAQ Knowledge Base
+ *
+ * Registers four agent tools that wrap the 8999 FAQ KB API into
+ * high-level workflow operations:
+ *
+ *   1. faq_kb_create_and_train  — one-click: create KB + auto-pipeline
+ *   2. faq_kb_query             — intelligent Q&A
+ *   3. faq_kb_manage            — FAQ CRUD
+ *   4. faq_kb_list              — KB inventory & system status
+ */
+import { FaqKbApiClient } from "./lib/api-client.js";
+import { CreateAndTrainParams, executeCreateAndTrain, } from "./tools/create-kb-and-train.js";
+import { QueryParams, executeQuery, } from "./tools/query-kb.js";
+import { ManageFaqParams, executeManageFaq, } from "./tools/manage-faq.js";
+import { ListKbParams, executeListKb, } from "./tools/list-kb.js";
+function definePluginEntry(entry) {
+    return entry;
+}
+// ── Export ─────────────────────────────────────────────────────────────
+export default definePluginEntry({
+    id: "faq-knowledge-base",
+    name: "FAQ Knowledge Base",
+    description: "FAQ 知识库插件：一键上传文档训练知识库，智能问答，FAQ 增删改查",
+    register(api) {
+        const cfg = api.getConfig();
+        const baseUrl = cfg.apiBaseUrl || "http://67.212.146.21:8999";
+        const pollInterval = cfg.pollIntervalMs ?? 8_000;
+        const pipelineTimeout = cfg.pipelineTimeoutMs ?? 20 * 60 * 1000;
+        const client = new FaqKbApiClient({
+            baseUrl,
+            staticToken: cfg.apiToken || undefined,
+        });
+        // ── Tool 1: Create & Train ────────────────────────────────────────
+        api.registerTool({
+            name: "faq_kb_create_and_train",
+            label: "创建知识库并训练",
+            description: [
+                "创建一个新的 FAQ 知识库并自动完成全部训练流程。",
+                "内部执行: 创建知识库 → 上传文档 → AI 提取 FAQ → 构建知识树 → 建索引。",
+                "训练完成后知识库即可用于问答（faq_kb_query）。",
+                "支持 PDF / DOCX / DOC / TXT / MD 格式，通过 file_url 传入文件地址。",
+                "训练过程通常需要 2-10 分钟，取决于文档大小。",
+            ].join(" "),
+            parameters: CreateAndTrainParams,
+            execute: (_id, params) => executeCreateAndTrain(client, params, pollInterval, pipelineTimeout),
+        });
+        // ── Tool 2: Query ─────────────────────────────────────────────────
+        api.registerTool({
+            name: "faq_kb_query",
+            label: "知识库问答",
+            description: [
+                "向指定知识库提问并获取 AI 智能回答。",
+                "知识库必须已经训练完成（is_active=true）。",
+                "设置 enable_polish=true 可让 LLM 综合多个 FAQ 生成更自然的回答。",
+                "返回包含答案、置信度、来源引用和日志 ID。",
+            ].join(" "),
+            parameters: QueryParams,
+            execute: (_id, params) => executeQuery(client, params),
+        });
+        // ── Tool 3: Manage FAQ ────────────────────────────────────────────
+        api.registerTool({
+            name: "faq_kb_manage",
+            label: "FAQ 管理",
+            description: [
+                "管理知识库中的 FAQ（问答对）: 创建、更新、删除、列表、详情。",
+                "通过 action 参数指定操作类型。",
+                "create/update 需要 question 和 answer；",
+                "update/delete/get 需要 faq_id；",
+                "list 支持 keyword 搜索和分页。",
+            ].join(" "),
+            parameters: ManageFaqParams,
+            execute: (_id, params) => executeManageFaq(client, params),
+        });
+        // ── Tool 4: List KB ───────────────────────────────────────────────
+        api.registerTool({
+            name: "faq_kb_list",
+            label: "知识库管理",
+            description: [
+                "查询和管理知识库: 列出全部知识库、查看详情、删除知识库、查看系统状态。",
+                "list: 列出所有知识库，支持按名称和标签筛选；",
+                "detail: 查看知识库详情（需要 kb_id）；",
+                "delete: 删除知识库（需要 kb_id）；",
+                "system_status: 查看后端系统状态。",
+            ].join(" "),
+            parameters: ListKbParams,
+            execute: (_id, params) => executeListKb(client, params),
+        });
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/lib/api-client.d.ts

@@ -0,0 +1,34 @@
+/**
+ * HTTP client for the FAQ Knowledge Base API (port 8999).
+ *
+ * Handles automatic token acquisition and renewal so that every
+ * outgoing request carries a valid `X-API-Token` header.
+ */
+export interface ApiClientConfig {
+    baseUrl: string;
+    /** If provided, skip auto-token and use this static token. */
+    staticToken?: string;
+    /** Request timeout in ms (default 30 000). */
+    timeoutMs?: number;
+}
+export declare class FaqKbApiClient {
+    private readonly baseUrl;
+    private readonly staticToken;
+    private readonly timeoutMs;
+    private tokenCache;
+    constructor(cfg: ApiClientConfig);
+    private acquireToken;
+    private getToken;
+    request<T = unknown>(method: string, path: string, body?: unknown): Promise<T>;
+    get<T = unknown>(path: string): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown): Promise<T>;
+    put<T = unknown>(path: string, body?: unknown): Promise<T>;
+    del<T = unknown>(path: string, body?: unknown): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown): Promise<T>;
+}
+export interface ApiResponse<D = Record<string, unknown>> {
+    success: boolean;
+    message: string;
+    data: D;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/lib/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../lib/api-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,UAAU,CAA2B;gBAEjC,GAAG,EAAE,eAAe;YAQlB,YAAY;YAqBZ,QAAQ;IAUhB,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,CAAC,CAAC;IAqCb,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM;IAI7B,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IAI9C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IAI7C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IAI7C,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAGhD;AAID,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,CAAC,CAAC;CACT"}

package/dist/lib/api-client.js

@@ -0,0 +1,91 @@
+/**
+ * HTTP client for the FAQ Knowledge Base API (port 8999).
+ *
+ * Handles automatic token acquisition and renewal so that every
+ * outgoing request carries a valid `X-API-Token` header.
+ */
+export class FaqKbApiClient {
+    baseUrl;
+    staticToken;
+    timeoutMs;
+    tokenCache = null;
+    constructor(cfg) {
+        this.baseUrl = cfg.baseUrl.replace(/\/+$/, "");
+        this.staticToken = cfg.staticToken || undefined;
+        this.timeoutMs = cfg.timeoutMs ?? 30_000;
+    }
+    // ── Token management ────────────────────────────────────────────────
+    async acquireToken() {
+        const res = await fetch(`${this.baseUrl}/api/token`, {
+            method: "POST",
+            signal: AbortSignal.timeout(this.timeoutMs),
+        });
+        if (!res.ok) {
+            throw new Error(`Token acquisition failed: ${res.status} ${res.statusText}`);
+        }
+        const body = (await res.json());
+        // Renew 5 min before actual expiry to avoid edge-case failures
+        const safetyMarginMs = 5 * 60 * 1000;
+        this.tokenCache = {
+            token: body.token,
+            expiresAt: Date.now() + body.expires_in * 1000 - safetyMarginMs,
+        };
+        return body.token;
+    }
+    async getToken() {
+        if (this.staticToken)
+            return this.staticToken;
+        if (this.tokenCache && Date.now() < this.tokenCache.expiresAt) {
+            return this.tokenCache.token;
+        }
+        return this.acquireToken();
+    }
+    // ── Generic request ─────────────────────────────────────────────────
+    async request(method, path, body) {
+        const token = await this.getToken();
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            "X-API-Token": token,
+            Accept: "application/json",
+        };
+        const init = {
+            method,
+            headers,
+            signal: AbortSignal.timeout(this.timeoutMs),
+        };
+        if (body !== undefined) {
+            headers["Content-Type"] = "application/json";
+            init.body = JSON.stringify(body);
+        }
+        const res = await fetch(url, init);
+        if (!res.ok) {
+            let detail;
+            try {
+                const err = await res.json();
+                detail = err.detail ?? JSON.stringify(err);
+            }
+            catch {
+                detail = await res.text();
+            }
+            throw new Error(`API ${method} ${path} → ${res.status}: ${detail}`);
+        }
+        return res.json();
+    }
+    // ── Convenience wrappers ────────────────────────────────────────────
+    get(path) {
+        return this.request("GET", path);
+    }
+    post(path, body) {
+        return this.request("POST", path, body);
+    }
+    put(path, body) {
+        return this.request("PUT", path, body);
+    }
+    del(path, body) {
+        return this.request("DELETE", path, body);
+    }
+    patch(path, body) {
+        return this.request("PATCH", path, body);
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/lib/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../lib/api-client.ts"],"names":[],"mappings":"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"}

package/dist/tools/create-kb-and-train.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Tool 1 — faq_kb_create_and_train
+ *
+ * One-shot workflow: create a knowledge base, upload a document, and run
+ * the full auto-pipeline (AI extract -> build tree -> confirm -> index).
+ * The tool polls progress internally and only returns when the pipeline
+ * completes (or fails / times out).
+ */
+import { type Static } from "@sinclair/typebox";
+import type { FaqKbApiClient } from "../lib/api-client.js";
+export declare const CreateAndTrainParams: import("@sinclair/typebox").TObject<{
+    kb_name: import("@sinclair/typebox").TString;
+    file_url: import("@sinclair/typebox").TString;
+    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    tag_name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type CreateAndTrainInput = Static<typeof CreateAndTrainParams>;
+export declare function executeCreateAndTrain(client: FaqKbApiClient, params: CreateAndTrainInput, pollIntervalMs: number, pipelineTimeoutMs: number): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=create-kb-and-train.d.ts.map

package/dist/tools/create-kb-and-train.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-kb-and-train.d.ts","sourceRoot":"","sources":["../../tools/create-kb-and-train.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,sBAAsB,CAAC;AAIxE,eAAO,MAAM,oBAAoB;;;;;EAW/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAmBtE,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,mBAAmB,EAC3B,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM;;;;;GA0E1B"}

package/dist/tools/create-kb-and-train.js

@@ -0,0 +1,74 @@
+/**
+ * Tool 1 — faq_kb_create_and_train
+ *
+ * One-shot workflow: create a knowledge base, upload a document, and run
+ * the full auto-pipeline (AI extract -> build tree -> confirm -> index).
+ * The tool polls progress internally and only returns when the pipeline
+ * completes (or fails / times out).
+ */
+import { Type } from "@sinclair/typebox";
+// ── Parameter schema ──────────────────────────────────────────────────
+export const CreateAndTrainParams = Type.Object({
+    kb_name: Type.String({ description: "知识库名称" }),
+    file_url: Type.String({
+        description: "文档文件的 URL 地址（支持 PDF / DOCX / DOC / TXT / MD）",
+    }),
+    description: Type.Optional(Type.String({ description: "知识库描述（可选）" })),
+    tag_name: Type.Optional(Type.String({ description: "知识库标签，用于分类（可选）" })),
+});
+// ── Execute ───────────────────────────────────────────────────────────
+export async function executeCreateAndTrain(client, params, pollIntervalMs, pipelineTimeoutMs) {
+    // Step 1 — Create knowledge base
+    const kbRes = await client.post("/knowledge_bases", {
+        name: params.kb_name,
+        description: params.description ?? "",
+        tag_name: params.tag_name ?? null,
+    });
+    const kbId = kbRes.id;
+    // Step 2 — Start auto-pipeline
+    const pipeRes = await client.post(`/knowledge_bases/${kbId}/auto_pipeline`, {
+        name: params.kb_name,
+        description: params.description ?? "",
+        file_path: params.file_url,
+    });
+    if (!pipeRes.success) {
+        return textResult(`[ERROR] 启动全自动管线失败: ${pipeRes.message}（kb_id=${kbId}）`);
+    }
+    const taskId = pipeRes.data.task_id;
+    // Step 3 — Poll until completed / failed / timeout
+    const deadline = Date.now() + pipelineTimeoutMs;
+    let last = null;
+    while (Date.now() < deadline) {
+        await sleep(pollIntervalMs);
+        const prog = await client.get(`/knowledge_bases/${kbId}/auto_pipeline/${taskId}`);
+        if (!prog.success)
+            continue;
+        last = prog.data;
+        if (last.stage === "completed") {
+            return textResult([
+                `知识库创建并训练完成!`,
+                `  kb_id        : ${kbId}`,
+                `  知识库名称   : ${params.kb_name}`,
+                `  FAQ 数量     : ${last.faq_count}`,
+                `  节点数量     : ${last.node_count}`,
+                `  状态         : 就绪，可以使用 faq_kb_query 工具进行问答`,
+            ].join("\n"));
+        }
+        if (last.stage === "failed") {
+            return textResult(`[ERROR] 管线失败: ${last.error ?? "未知错误"}（kb_id=${kbId}, task_id=${taskId}）`);
+        }
+    }
+    // Timeout
+    const stageInfo = last
+        ? `当前阶段=${last.stage_label}, 进度=${last.progress}%`
+        : "无进度信息";
+    return textResult(`[TIMEOUT] 全自动管线超时（${pipelineTimeoutMs / 1000}s）。${stageInfo}。kb_id=${kbId}, task_id=${taskId}`);
+}
+// ── Helpers ───────────────────────────────────────────────────────────
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+//# sourceMappingURL=create-kb-and-train.js.map

package/dist/tools/create-kb-and-train.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-kb-and-train.js","sourceRoot":"","sources":["../../tools/create-kb-and-train.ts"],"names":[],"mappings":"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"}

package/dist/tools/list-kb.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Tool 4 — faq_kb_list
+ *
+ * Query knowledge base inventory: list all, get detail, check training
+ * status, or retrieve system status.
+ */
+import { type Static } from "@sinclair/typebox";
+import type { FaqKbApiClient } from "../lib/api-client.js";
+export declare const ListKbParams: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"detail">, import("@sinclair/typebox").TLiteral<"delete">, import("@sinclair/typebox").TLiteral<"system_status">]>;
+    kb_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    keyword: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    tag_name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    page: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    page_size: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export type ListKbInput = Static<typeof ListKbParams>;
+export declare function executeListKb(client: FaqKbApiClient, params: ListKbInput): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=list-kb.d.ts.map

package/dist/tools/list-kb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-kb.d.ts","sourceRoot":"","sources":["../../tools/list-kb.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,sBAAsB,CAAC;AAExE,eAAO,MAAM,YAAY;;;;;;;EAwBvB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;AAEtD,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,WAAW;;;;;GAcpB"}

package/dist/tools/list-kb.js

@@ -0,0 +1,101 @@
+/**
+ * Tool 4 — faq_kb_list
+ *
+ * Query knowledge base inventory: list all, get detail, check training
+ * status, or retrieve system status.
+ */
+import { Type } from "@sinclair/typebox";
+export const ListKbParams = Type.Object({
+    action: Type.Union([
+        Type.Literal("list"),
+        Type.Literal("detail"),
+        Type.Literal("delete"),
+        Type.Literal("system_status"),
+    ], {
+        description: "操作类型: list=列出所有知识库, detail=知识库详情, delete=删除知识库, system_status=系统状态",
+    }),
+    kb_id: Type.Optional(Type.String({ description: "知识库 ID（detail / delete 时必填）" })),
+    keyword: Type.Optional(Type.String({ description: "按名称搜索（list 时可选）" })),
+    tag_name: Type.Optional(Type.String({ description: "按标签筛选（list 时可选）" })),
+    page: Type.Optional(Type.Number({ description: "页码（默认 1）" })),
+    page_size: Type.Optional(Type.Number({ description: "每页大小（默认 0=全部）" })),
+});
+export async function executeListKb(client, params) {
+    switch (params.action) {
+        case "list":
+            return doList(client, params);
+        case "detail":
+            return doDetail(client, params);
+        case "delete":
+            return doDelete(client, params);
+        case "system_status":
+            return doSystemStatus(client);
+        default:
+            return textResult(`[ERROR] 不支持的 action: ${params.action}`);
+    }
+}
+async function doList(client, p) {
+    const qp = new URLSearchParams();
+    if (p.keyword)
+        qp.set("keyword", p.keyword);
+    if (p.tag_name)
+        qp.set("tag_name", p.tag_name);
+    qp.set("page", String(p.page ?? 1));
+    qp.set("page_size", String(p.page_size ?? 0));
+    const res = await client.get(`/knowledge_bases?${qp.toString()}`);
+    const items = res.items ?? res.data?.items ?? [];
+    const total = res.total ?? items.length;
+    const lines = [`知识库列表（共 ${total} 个）:`];
+    for (const kb of items) {
+        const status = kb.is_active ? "就绪" : "未训练";
+        const tag = kb.tag_name ? ` [${kb.tag_name}]` : "";
+        lines.push(`  ${kb.id}  ${kb.name}${tag}  (${status})`);
+    }
+    if (items.length === 0) {
+        lines.push("  (无知识库)");
+    }
+    return textResult(lines.join("\n"));
+}
+// ── Detail ────────────────────────────────────────────────────────────
+async function doDetail(client, p) {
+    if (!p.kb_id) {
+        return textResult("[ERROR] 查看知识库详情需要提供 kb_id");
+    }
+    const res = await client.get(`/knowledge_bases/${p.kb_id}`);
+    const kb = res;
+    const createdDate = new Date(kb.created_at).toLocaleString("zh-CN");
+    const trainDate = kb.trainover_at
+        ? new Date(kb.trainover_at).toLocaleString("zh-CN")
+        : "未训练";
+    return textResult([
+        `知识库详情:`,
+        `  ID          : ${kb.id}`,
+        `  名称        : ${kb.name}`,
+        `  描述        : ${kb.description ?? "(无)"}`,
+        `  标签        : ${kb.tag_name ?? "(无)"}`,
+        `  状态        : ${kb.is_active ? "就绪（可问答）" : "未训练"}`,
+        `  创建时间    : ${createdDate}`,
+        `  训练完成时间: ${trainDate}`,
+    ].join("\n"));
+}
+// ── Delete ────────────────────────────────────────────────────────────
+async function doDelete(client, p) {
+    if (!p.kb_id) {
+        return textResult("[ERROR] 删除知识库需要提供 kb_id");
+    }
+    const res = await client.del(`/knowledge_bases/${p.kb_id}`);
+    return textResult(`知识库删除成功! kb_id=${p.kb_id}\n${res.message ?? ""}`);
+}
+// ── System status ─────────────────────────────────────────────────────
+async function doSystemStatus(client) {
+    const res = await client.get("/system/status");
+    if (!res.success) {
+        return textResult(`[ERROR] 获取系统状态失败: ${res.message}`);
+    }
+    return textResult(`系统状态:\n${JSON.stringify(res.data, null, 2)}`);
+}
+// ── Helpers ───────────────────────────────────────────────────────────
+function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+//# sourceMappingURL=list-kb.js.map

package/dist/tools/list-kb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-kb.js","sourceRoot":"","sources":["../../tools/list-kb.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAGtD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC;IACtC,MAAM,EAAE,IAAI,CAAC,KAAK,CAChB;QACE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;KAC9B,EACD;QACE,WAAW,EACT,oEAAoE;KACvE,CACF;IACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6BAA6B,EAAE,CAAC,CAC5D;IACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAChD;IACD,QAAQ,EAAE,IAAI,CAAC,QAAQ,CACrB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAChD;IACD,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IAC7D,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,CAAC;CACxE,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAsB,EACtB,MAAmB;IAEnB,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,KAAK,eAAe;YAClB,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC;YACE,OAAO,UAAU,CAAC,wBAAwB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAcD,KAAK,UAAU,MAAM,CAAC,MAAsB,EAAE,CAAc;IAC1D,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;IACjC,IAAI,CAAC,CAAC,OAAO;QAAE,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC,QAAQ;QAAE,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC/C,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC;IAE9C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAC1B,oBAAoB,EAAE,CAAC,QAAQ,EAAE,EAAE,CACpC,CAAC;IAEF,MAAM,KAAK,GAAc,GAAW,CAAC,KAAK,IAAK,GAAW,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;IAC7E,MAAM,KAAK,GAAY,GAAW,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC;IAEzD,MAAM,KAAK,GAAa,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC;IAEjD,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;QAC3C,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,GAAG,MAAM,MAAM,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,yEAAyE;AAEzE,KAAK,UAAU,QAAQ,CAAC,MAAsB,EAAE,CAAc;IAC5D,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,UAAU,CAAC,2BAA2B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAS,oBAAoB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACpE,MAAM,EAAE,GAAG,GAAa,CAAC;IAEzB,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY;QAC/B,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC;QACnD,CAAC,CAAC,KAAK,CAAC;IAEV,OAAO,UAAU,CACf;QACE,QAAQ;QACR,mBAAmB,EAAE,CAAC,EAAE,EAAE;QAC1B,iBAAiB,EAAE,CAAC,IAAI,EAAE;QAC1B,iBAAiB,EAAE,CAAC,WAAW,IAAI,KAAK,EAAE;QAC1C,iBAAiB,EAAE,CAAC,QAAQ,IAAI,KAAK,EAAE;QACvC,iBAAiB,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE;QACnD,eAAe,WAAW,EAAE;QAC5B,aAAa,SAAS,EAAE;KACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC;AAED,yEAAyE;AAEzE,KAAK,UAAU,QAAQ,CAAC,MAAsB,EAAE,CAAc;IAC5D,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,UAAU,CAAC,yBAAyB,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAC1B,oBAAoB,CAAC,CAAC,KAAK,EAAE,CAC9B,CAAC;IAEF,OAAO,UAAU,CACf,kBAAkB,CAAC,CAAC,KAAK,KAAM,GAAW,CAAC,OAAO,IAAI,EAAE,EAAE,CAC3D,CAAC;AACJ,CAAC;AAED,yEAAyE;AAEzE,KAAK,UAAU,cAAc,CAAC,MAAsB;IAClD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAc,gBAAgB,CAAC,CAAC;IAE5D,IAAI,CAAE,GAAW,CAAC,OAAO,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC,qBAAsB,GAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,UAAU,CACf,UAAU,IAAI,CAAC,SAAS,CAAE,GAAW,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CACvD,CAAC;AACJ,CAAC;AAED,yEAAyE;AAEzE,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACxD,CAAC"}

package/dist/tools/manage-faq.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tool 3 — faq_kb_manage
+ *
+ * Unified CRUD tool for FAQ items inside a knowledge base.
+ * The `action` parameter selects the operation to perform.
+ */
+import { type Static } from "@sinclair/typebox";
+import type { FaqKbApiClient } from "../lib/api-client.js";
+export declare const ManageFaqParams: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"create">, import("@sinclair/typebox").TLiteral<"update">, import("@sinclair/typebox").TLiteral<"delete">, import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"get">]>;
+    kb_id: import("@sinclair/typebox").TString;
+    faq_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    question: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    answer: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    node_path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    page: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    page_size: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    keyword: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type ManageFaqInput = Static<typeof ManageFaqParams>;
+export declare function executeManageFaq(client: FaqKbApiClient, params: ManageFaqInput): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=manage-faq.d.ts.map

package/dist/tools/manage-faq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-faq.d.ts","sourceRoot":"","sources":["../../tools/manage-faq.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,sBAAsB,CAAC;AAExE,eAAO,MAAM,eAAe;;;;;;;;;;;EA2C1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AAE5D,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc;;;;;GAgBvB"}

package/dist/tools/manage-faq.js

@@ -0,0 +1,149 @@
+/**
+ * Tool 3 — faq_kb_manage
+ *
+ * Unified CRUD tool for FAQ items inside a knowledge base.
+ * The `action` parameter selects the operation to perform.
+ */
+import { Type } from "@sinclair/typebox";
+export const ManageFaqParams = Type.Object({
+    action: Type.Union([
+        Type.Literal("create"),
+        Type.Literal("update"),
+        Type.Literal("delete"),
+        Type.Literal("list"),
+        Type.Literal("get"),
+    ], {
+        description: "操作类型: create=创建, update=更新, delete=删除, list=列表, get=详情",
+    }),
+    kb_id: Type.String({ description: "知识库 ID" }),
+    faq_id: Type.Optional(Type.String({
+        description: "FAQ ID（update / delete / get 时必填）",
+    })),
+    question: Type.Optional(Type.String({ description: "问题内容（create / update 时填写）" })),
+    answer: Type.Optional(Type.String({ description: "答案内容（create / update 时填写）" })),
+    node_path: Type.Optional(Type.String({ description: "归属节点路径（可选）" })),
+    status: Type.Optional(Type.String({
+        description: "FAQ 状态: active / inactive（可选，默认 active）",
+    })),
+    page: Type.Optional(Type.Number({ description: "页码（list 时使用，默认 1）" })),
+    page_size: Type.Optional(Type.Number({ description: "每页大小（list 时使用，默认 20）" })),
+    keyword: Type.Optional(Type.String({ description: "关键词搜索（list 时使用）" })),
+});
+export async function executeManageFaq(client, params) {
+    switch (params.action) {
+        case "create":
+            return doCreate(client, params);
+        case "update":
+            return doUpdate(client, params);
+        case "delete":
+            return doDelete(client, params);
+        case "list":
+            return doList(client, params);
+        case "get":
+            return doGet(client, params);
+        default:
+            return textResult(`[ERROR] 不支持的 action: ${params.action}`);
+    }
+}
+// ── Create ────────────────────────────────────────────────────────────
+async function doCreate(client, p) {
+    if (!p.question || !p.answer) {
+        return textResult("[ERROR] 创建 FAQ 需要提供 question 和 answer");
+    }
+    const res = await client.post("/faqs", {
+        knowledge_base_id: p.kb_id,
+        question: p.question,
+        answer: p.answer,
+        node_path: p.node_path ?? "",
+        status: p.status ?? "active",
+    });
+    if (!res.success) {
+        return textResult(`[ERROR] 创建 FAQ 失败: ${res.message}`);
+    }
+    const faqId = res.data?.faq_id ?? res.data?.id ?? "unknown";
+    return textResult(`FAQ 创建成功!\n  faq_id: ${faqId}\n  问题: ${p.question}\n  答案: ${p.answer?.slice(0, 80)}...`);
+}
+// ── Update ────────────────────────────────────────────────────────────
+async function doUpdate(client, p) {
+    if (!p.faq_id) {
+        return textResult("[ERROR] 更新 FAQ 需要提供 faq_id");
+    }
+    if (!p.question && !p.answer) {
+        return textResult("[ERROR] 更新 FAQ 至少需要提供 question 或 answer");
+    }
+    const body = {
+        knowledge_base_id: p.kb_id,
+    };
+    if (p.question)
+        body.question = p.question;
+    if (p.answer)
+        body.answer = p.answer;
+    if (p.node_path !== undefined)
+        body.node_path = p.node_path;
+    if (p.status)
+        body.status = p.status;
+    const res = await client.put(`/faqs/${p.faq_id}`, body);
+    if (!res.success) {
+        return textResult(`[ERROR] 更新 FAQ 失败: ${res.message}`);
+    }
+    return textResult(`FAQ 更新成功! faq_id=${p.faq_id}`);
+}
+// ── Delete ────────────────────────────────────────────────────────────
+async function doDelete(client, p) {
+    if (!p.faq_id) {
+        return textResult("[ERROR] 删除 FAQ 需要提供 faq_id");
+    }
+    const res = await client.del(`/faqs/${p.faq_id}?kb_id=${p.kb_id}`);
+    if (!res.success) {
+        return textResult(`[ERROR] 删除 FAQ 失败: ${res.message}`);
+    }
+    return textResult(`FAQ 删除成功! faq_id=${p.faq_id}`);
+}
+async function doList(client, p) {
+    const qp = new URLSearchParams({
+        knowledge_base_id: p.kb_id,
+        page: String(p.page ?? 1),
+        page_size: String(p.page_size ?? 20),
+    });
+    if (p.keyword)
+        qp.set("keyword", p.keyword);
+    if (p.status)
+        qp.set("status", p.status);
+    const res = await client.get(`/faqs?${qp.toString()}`);
+    if (!res.success) {
+        return textResult(`[ERROR] 获取 FAQ 列表失败: ${res.message}`);
+    }
+    const { faqs, pagination } = res.data;
+    const lines = [
+        `FAQ 列表（共 ${pagination.total} 条，第 ${pagination.page}/${pagination.total_pages} 页）:`,
+    ];
+    for (const f of faqs) {
+        const q = f.question.length > 60 ? f.question.slice(0, 57) + "..." : f.question;
+        lines.push(`  [${f.id}] ${q}`);
+    }
+    return textResult(lines.join("\n"));
+}
+// ── Get ───────────────────────────────────────────────────────────────
+async function doGet(client, p) {
+    if (!p.faq_id) {
+        return textResult("[ERROR] 获取 FAQ 详情需要提供 faq_id");
+    }
+    const res = await client.get(`/faqs/${p.faq_id}?kb_id=${p.kb_id}`);
+    if (!res.success) {
+        return textResult(`[ERROR] 获取 FAQ 详情失败: ${res.message}`);
+    }
+    const d = res.data;
+    return textResult([
+        `FAQ 详情:`,
+        `  ID      : ${d.id ?? p.faq_id}`,
+        `  问题    : ${d.question ?? ""}`,
+        `  答案    : ${d.answer ?? ""}`,
+        `  状态    : ${d.status ?? "unknown"}`,
+        `  节点路径: ${d.node_path ?? "(无)"}`,
+    ].join("\n"));
+}
+// ── Helpers ───────────────────────────────────────────────────────────
+function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+//# sourceMappingURL=manage-faq.js.map

package/dist/tools/manage-faq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-faq.js","sourceRoot":"","sources":["../../tools/manage-faq.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAGtD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,IAAI,CAAC,KAAK,CAChB;QACE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;KACpB,EACD;QACE,WAAW,EACT,wDAAwD;KAC3D,CACF;IACD,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IAC7C,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,mCAAmC;KACjD,CAAC,CACH;IACD,QAAQ,EAAE,IAAI,CAAC,QAAQ,CACrB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC,CAC1D;IACD,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC,CAC1D;IACD,SAAS,EAAE,IAAI,CAAC,QAAQ,CACtB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAC3C;IACD,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,yCAAyC;KACvD,CAAC,CACH;IACD,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC,CAClD;IACD,SAAS,EAAE,IAAI,CAAC,QAAQ,CACtB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC,CACrD;IACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAChD;CACF,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAsB,EACtB,MAAsB;IAEtB,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,KAAK,MAAM;YACT,OAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,KAAK,KAAK;YACR,OAAO,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B;YACE,OAAO,UAAU,CAAC,wBAAwB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,yEAAyE;AAEzE,KAAK,UAAU,QAAQ,CAAC,MAAsB,EAAE,CAAiB;IAC/D,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAC,uCAAuC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAc,OAAO,EAAE;QAClD,iBAAiB,EAAE,CAAC,CAAC,KAAK;QAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE;QAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,QAAQ;KAC7B,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,UAAU,CAAC,sBAAsB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,SAAS,CAAC;IAC5D,OAAO,UAAU,CACf,wBAAwB,KAAK,WAAW,CAAC,CAAC,QAAQ,WAAW,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CACzF,CAAC;AACJ,CAAC;AAED,yEAAyE;AAEzE,KAAK,UAAU,QAAQ,CAAC,MAAsB,EAAE,CAAiB;IAC/D,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,UAAU,CAAC,4BAA4B,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAC,yCAAyC,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,IAAI,GAA4B;QACpC,iBAAiB,EAAE,CAAC,CAAC,KAAK;KAC3B,CAAC;IACF,IAAI,CAAC,CAAC,QAAQ;QAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC3C,IAAI,CAAC,CAAC,MAAM;QAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;QAAE,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;IAC5D,IAAI,CAAC,CAAC,MAAM;QAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IAErC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAc,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;IAErE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,UAAU,CAAC,sBAAsB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,yEAAyE;AAEzE,KAAK,UAAU,QAAQ,CAAC,MAAsB,EAAE,CAAiB;IAC/D,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,UAAU,CAAC,4BAA4B,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAC1B,SAAS,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC,KAAK,EAAE,CACrC,CAAC;IAEF,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,UAAU,CAAC,sBAAsB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AACpD,CAAC;AAoBD,KAAK,UAAU,MAAM,CAAC,MAAsB,EAAE,CAAiB;IAC7D,MAAM,EAAE,GAAG,IAAI,eAAe,CAAC;QAC7B,iBAAiB,EAAE,CAAC,CAAC,KAAK;QAC1B,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;KACrC,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,OAAO;QAAE,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC,MAAM;QAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAEzC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAC1B,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,CACzB,CAAC;IAEF,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,UAAU,CAAC,wBAAwB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;IACtC,MAAM,KAAK,GAAa;QACtB,YAAY,UAAU,CAAC,KAAK,QAAQ,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,WAAW,MAAM;KACpF,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,yEAAyE;AAEzE,KAAK,UAAU,KAAK,CAAC,MAAsB,EAAE,CAAiB;IAC5D,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,UAAU,CAAC,8BAA8B,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAC1B,SAAS,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC,KAAK,EAAE,CACrC,CAAC;IAEF,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,UAAU,CAAC,wBAAwB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,CAAC,GAAG,GAAG,CAAC,IAA+B,CAAC;IAC9C,OAAO,UAAU,CACf;QACE,SAAS;QACT,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE;QACjC,aAAa,CAAC,CAAC,QAAQ,IAAI,EAAE,EAAE;QAC/B,aAAa,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE;QAC7B,aAAa,CAAC,CAAC,MAAM,IAAI,SAAS,EAAE;QACpC,WAAW,CAAC,CAAC,SAAS,IAAI,KAAK,EAAE;KAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC;AAED,yEAAyE;AAEzE,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACxD,CAAC"}

package/dist/tools/query-kb.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Tool 2 — faq_kb_query
+ *
+ * Ask a question against a trained knowledge base and get an
+ * AI-generated answer with source references.
+ */
+import { type Static } from "@sinclair/typebox";
+import type { FaqKbApiClient } from "../lib/api-client.js";
+export declare const QueryParams: import("@sinclair/typebox").TObject<{
+    kb_id: import("@sinclair/typebox").TString;
+    question: import("@sinclair/typebox").TString;
+    enable_polish: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    user_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    session_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type QueryInput = Static<typeof QueryParams>;
+export declare function executeQuery(client: FaqKbApiClient, params: QueryInput): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=query-kb.d.ts.map

package/dist/tools/query-kb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-kb.d.ts","sourceRoot":"","sources":["../../tools/query-kb.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,sBAAsB,CAAC;AAExE,eAAO,MAAM,WAAW;;;;;;EAetB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,WAAW,CAAC,CAAC;AAcpD,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,UAAU;;;;;GAsCnB"}

package/dist/tools/query-kb.js

@@ -0,0 +1,48 @@
+/**
+ * Tool 2 — faq_kb_query
+ *
+ * Ask a question against a trained knowledge base and get an
+ * AI-generated answer with source references.
+ */
+import { Type } from "@sinclair/typebox";
+export const QueryParams = Type.Object({
+    kb_id: Type.String({ description: "知识库 ID" }),
+    question: Type.String({ description: "要查询的问题" }),
+    enable_polish: Type.Optional(Type.Boolean({
+        description: "是否启用 LLM 综合分析（多 FAQ 融合生成更自然的答案）。默认 false",
+    })),
+    user_id: Type.Optional(Type.String({ description: "用户 ID（用于权限和画像）" })),
+    session_id: Type.Optional(Type.String({ description: "会话 ID（用于上下文关联）" })),
+});
+export async function executeQuery(client, params) {
+    const res = await client.post(`/knowledge_bases/${params.kb_id}/query`, {
+        question: params.question,
+        enable_polish: params.enable_polish ?? false,
+        user_id: params.user_id ?? null,
+        session_id: params.session_id ?? null,
+    });
+    if (!res.success) {
+        return textResult(`[ERROR] 问答失败: ${res.message}`);
+    }
+    const d = res.data;
+    const lines = [];
+    lines.push(`**答案**: ${d.answer || "(无答案)"}`);
+    if (d.faq_data?.question) {
+        lines.push(`**匹配问题**: ${d.faq_data.question}`);
+    }
+    if (d.source_nodes?.length) {
+        const topScore = d.source_nodes[0]?.score;
+        if (topScore !== undefined) {
+            lines.push(`**置信度**: ${(topScore * 100).toFixed(1)}%`);
+        }
+        lines.push(`**参考来源数**: ${d.source_nodes.length}`);
+    }
+    if (d.log_id) {
+        lines.push(`**日志 ID**: ${d.log_id}（可用于提交反馈）`);
+    }
+    return textResult(lines.join("\n"));
+}
+function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+//# sourceMappingURL=query-kb.js.map

package/dist/tools/query-kb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-kb.js","sourceRoot":"","sources":["../../tools/query-kb.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAGtD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IAC7C,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IAChD,aAAa,EAAE,IAAI,CAAC,QAAQ,CAC1B,IAAI,CAAC,OAAO,CAAC;QACX,WAAW,EACT,0CAA0C;KAC7C,CAAC,CACH;IACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,CAC/C;IACD,UAAU,EAAE,IAAI,CAAC,QAAQ,CACvB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,CAC/C;CACF,CAAC,CAAC;AAgBH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAsB,EACtB,MAAkB;IAElB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAC3B,oBAAoB,MAAM,CAAC,KAAK,QAAQ,EACxC;QACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,KAAK;QAC5C,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;KACtC,CACF,CAAC;IAEF,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,UAAU,CAAC,iBAAiB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;IACnB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;IAE7C,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;QAC1C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACzD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,WAAW,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACxD,CAAC"}

package/openclaw.plugin.json

@@ -0,0 +1,31 @@
+{
+  "id": "faq-knowledge-base",
+  "name": "FAQ Knowledge Base",
+  "description": "FAQ 知识库管理与智能问答 — 一键上传文档、AI 自动提取 FAQ、构建知识树、智能问答",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "apiBaseUrl": {
+        "type": "string",
+        "default": "http://67.212.146.21:8999",
+        "description": "FAQ 知识库 API 服务地址"
+      },
+      "apiToken": {
+        "type": "string",
+        "default": "",
+        "description": "API 访问令牌（留空则自动从 /api/token 获取）"
+      },
+      "pollIntervalMs": {
+        "type": "number",
+        "default": 8000,
+        "description": "全自动管线轮询间隔（毫秒）"
+      },
+      "pipelineTimeoutMs": {
+        "type": "number",
+        "default": 1200000,
+        "description": "全自动管线超时时间（毫秒），默认 20 分钟"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@linkmind_claw/openclaw-faq-kb",
+  "version": "1.0.0",
+  "description": "OpenClaw Plugin - FAQ Knowledge Base: one-click document training & intelligent Q&A",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node --loader ts-node/esm test/smoke.ts"
+  },
+  "openclaw": {
+    "extensions": ["./dist/index.js"]
+  },
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "faq",
+    "knowledge-base",
+    "rag",
+    "qa"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "ts-node": "^10.9.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/skills/faq-kb/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: faq-knowledge-base
+description: FAQ 知识库 — 上传文档自动训练，智能问答，FAQ 增删改查
+---
+
+# FAQ Knowledge Base Skill
+
+You have access to a FAQ Knowledge Base system that lets you:
+
+1. **Create & train** a knowledge base from a document (PDF/DOCX/TXT/MD)
+2. **Ask questions** against a trained knowledge base
+3. **Manage FAQ items** (create, update, delete, list)
+4. **Browse knowledge bases** (list, detail, delete, system status)
+
+## Available Tools
+
+### `faq_kb_create_and_train`
+
+Use this when the user wants to create a new knowledge base from a document.
+
+**When to use:**
+- User says "create a knowledge base from this document"
+- User provides a file URL and wants to set up a Q&A system
+- User wants to "train" or "build" a knowledge base
+
+**Parameters:**
+- `kb_name` (required): Name for the knowledge base
+- `file_url` (required): URL to the document file (PDF/DOCX/DOC/TXT/MD)
+- `description` (optional): Description of the knowledge base
+- `tag_name` (optional): Tag for categorization
+
+**Notes:**
+- This tool runs the full pipeline and may take 2-10 minutes
+- It returns the `kb_id` which you need for subsequent queries
+- The pipeline stages are: upload → AI extract → build tree → confirm → index
+
+**Example:**
+```
+faq_kb_create_and_train({
+  kb_name: "产品手册FAQ",
+  file_url: "https://example.com/product-manual.pdf",
+  description: "产品使用手册的FAQ知识库"
+})
+```
+
+### `faq_kb_query`
+
+Use this when the user wants to ask a question against an existing knowledge base.
+
+**When to use:**
+- User asks a question and you know which knowledge base to query
+- User says "search the knowledge base for..."
+- User wants an answer from a specific FAQ collection
+
+**Parameters:**
+- `kb_id` (required): The knowledge base ID (from create or list)
+- `question` (required): The question to ask
+- `enable_polish` (optional): Set to `true` for LLM-polished answers that synthesize multiple FAQ matches
+- `user_id` (optional): For access control
+- `session_id` (optional): For conversation context tracking
+
+**Notes:**
+- The knowledge base must be trained (is_active=true) before querying
+- The response includes the answer, confidence score, and source references
+- A `log_id` is returned for submitting feedback later
+
+### `faq_kb_manage`
+
+Use this when the user wants to manage individual FAQ items.
+
+**When to use:**
+- User wants to add a new Q&A pair
+- User wants to edit or delete an existing FAQ
+- User wants to browse FAQs in a knowledge base
+
+**Parameters:**
+- `action` (required): One of `create`, `update`, `delete`, `list`, `get`
+- `kb_id` (required): Knowledge base ID
+- `faq_id`: Required for `update`, `delete`, `get`
+- `question`, `answer`: Required for `create`; at least one required for `update`
+- `keyword`, `page`, `page_size`: For `list` filtering
+
+### `faq_kb_list`
+
+Use this when the user wants to see available knowledge bases or system info.
+
+**When to use:**
+- User asks "what knowledge bases do I have?"
+- User wants details about a specific knowledge base
+- User wants to delete a knowledge base
+- User asks about system status
+
+**Parameters:**
+- `action` (required): One of `list`, `detail`, `delete`, `system_status`
+- `kb_id`: Required for `detail` and `delete`
+- `keyword`, `tag_name`: Optional filters for `list`
+
+## Typical Workflows
+
+### Workflow 1: Build a knowledge base from scratch
+```
+1. faq_kb_create_and_train(kb_name="...", file_url="...")  → get kb_id
+2. faq_kb_query(kb_id="...", question="...")               → get answer
+```
+
+### Workflow 2: Query an existing knowledge base
+```
+1. faq_kb_list(action="list")                              → find kb_id
+2. faq_kb_query(kb_id="...", question="...")               → get answer
+```
+
+### Workflow 3: Manually build FAQ content
+```
+1. faq_kb_list(action="list")                              → find kb_id
+2. faq_kb_manage(action="create", kb_id="...", question="...", answer="...")
+3. faq_kb_manage(action="list", kb_id="...")               → verify
+```
+
+## Important Notes
+
+- All knowledge base IDs are UUIDs (e.g., `a1b2c3d4-e5f6-...`)
+- The `faq_kb_create_and_train` tool is long-running (minutes). Be patient.
+- Always check if a knowledge base exists before querying it.
+- The API server is at `67.212.146.21:8999` by default.