dsh-plugin-ops-bundle 0.1.2 → 0.3.0

package/lib/client.js

@@ -66,6 +66,20 @@ var DICTS = {
     chatSend: "发送",
     chatThinking: "思考中…",
     chatNoChannel: "未找到可用模型通道（dsh 未提供 llm 服务且未配置 API key）",
+    ragToggle: "增强检索（知识库）",
+    btnDeposit: "沉淀为知识",
+    depositOk: "已沉淀为知识条目",
+    depositFail: "沉淀失败：",
+    depositNoChat: "先进行一轮对话再沉淀",
+    knowledge: "知识库（插件排障经验）",
+    knowledgeHint: "bug 与修复经验沉淀为 md；开关开启时诊断对话自动检索命中条目",
+    knowledgePlaceholder: "搜索：错误信息 / 包名 / 规则…",
+    search: "搜索",
+    showAll: "全部",
+    knowledgeEmpty: "暂无知识条目（修复成功或对话沉淀后自动积累）",
+    knowledgeSearchEmpty: "无命中条目",
+    delete: "删除",
+    times: "出现 {n} 次",
     loadFail: "加载失败：",
     profile: "Profile",
     home: "DSH_HOME"
@@ -104,6 +118,20 @@ var DICTS = {
     chatSend: "Send",
     chatThinking: "Thinking…",
     chatNoChannel: "No model channel available (dsh exposes no llm service and no API key is configured)",
+    ragToggle: "Enhanced retrieval (knowledge base)",
+    btnDeposit: "Deposit as knowledge",
+    depositOk: "Deposited as a knowledge entry",
+    depositFail: "Deposit failed: ",
+    depositNoChat: "Chat once before depositing",
+    knowledge: "Knowledge base (plugin troubleshooting)",
+    knowledgeHint: "Bugs and fixes deposit as Markdown; the toggle retrieves matching entries for the chat",
+    knowledgePlaceholder: "Search: error text / package / rule…",
+    search: "Search",
+    showAll: "All",
+    knowledgeEmpty: "No entries yet (fixes and deposits accumulate here)",
+    knowledgeSearchEmpty: "No matches",
+    delete: "Delete",
+    times: "seen {n}×",
     loadFail: "Load failed: ",
     profile: "Profile",
     home: "DSH_HOME"
@@ -200,6 +228,9 @@ function HealthSection() {
   const [chat, setChat] = (0, import_react.useState)([]);
   const [chatInput, setChatInput] = (0, import_react.useState)("");
   const [chatState, setChatState] = (0, import_react.useState)("");
+  const [rag, setRag] = (0, import_react.useState)(false);
+  const [knowledge, setKnowledge] = (0, import_react.useState)([]);
+  const [knowledgeQuery, setKnowledgeQuery] = (0, import_react.useState)("");
   const [busy, setBusy] = (0, import_react.useState)("");
   const [error, setError] = (0, import_react.useState)("");
   const load = (0, import_react.useCallback)(async (name, scanOnly = false) => {
@@ -223,6 +254,17 @@ function HealthSection() {
       setBusy("");
     }
   }, []);
+  const loadKnowledge = (0, import_react.useCallback)(async () => {
+    try {
+      const res = await api("/api/knowledge");
+      setKnowledge(res.entries);
+    } catch (e) {
+      setError(e instanceof Error ? e.message : String(e));
+    }
+  }, []);
+  (0, import_react.useEffect)(() => {
+    if (typeof localStorage !== "undefined" && localStorage.getItem("dshops-rag") === "1") setRag(true);
+  }, []);
   (0, import_react.useEffect)(() => {
     let cancelled = false;
     void (async () => {
@@ -233,6 +275,7 @@ function HealthSection() {
         const initial = infoRes.defaultProfile ?? infoRes.profiles[0]?.name ?? "web";
         setProfile(initial);
         await load(initial);
+        await loadKnowledge();
       } catch (e) {
         if (!cancelled) setError(e instanceof Error ? e.message : String(e));
       }
@@ -240,7 +283,7 @@ function HealthSection() {
     return () => {
       cancelled = true;
     };
-  }, [load]);
+  }, [load, loadKnowledge]);
   const changeProfile = (name) => {
     setProfile(name);
     setPage(0);
@@ -290,7 +333,7 @@ function HealthSection() {
     try {
       const res = await api("/api/chat", {
         method: "POST",
-        body: JSON.stringify({ profile, lang, messages: next })
+        body: JSON.stringify({ profile, lang, rag, messages: next })
       });
       if (res.ok) {
         setChat([...next, { role: "assistant", content: res.reply }]);
@@ -304,6 +347,56 @@ function HealthSection() {
       setChatState((state) => state === t.chatThinking ? "" : state);
     }
   };
+  const toggleRag = (next) => {
+    setRag(next);
+    if (typeof localStorage !== "undefined") localStorage.setItem("dshops-rag", next ? "1" : "0");
+  };
+  const searchKnowledge = async () => {
+    const query = knowledgeQuery.trim();
+    if (query === "") {
+      await loadKnowledge();
+      return;
+    }
+    setError("");
+    try {
+      const res = await api(`/api/knowledge?q=${encodeURIComponent(query)}&limit=10`);
+      setKnowledge(res.hits);
+    } catch (e) {
+      setError(e instanceof Error ? e.message : String(e));
+    }
+  };
+  const removeKnowledge = async (id) => {
+    try {
+      await api("/api/knowledge/delete", { method: "POST", body: JSON.stringify({ id }) });
+      await loadKnowledge();
+    } catch (e) {
+      setError(e instanceof Error ? e.message : String(e));
+    }
+  };
+  const deposit = async () => {
+    if (chat.length === 0) {
+      setChatState(t.depositNoChat);
+      return;
+    }
+    setBusy("deposit");
+    setChatState("");
+    try {
+      const res = await api("/api/knowledge/deposit", {
+        method: "POST",
+        body: JSON.stringify({ lang, messages: chat })
+      });
+      if (res.ok) {
+        setChatState(t.depositOk);
+        await loadKnowledge();
+      } else {
+        setChatState(res.error ?? t.depositFail);
+      }
+    } catch (e) {
+      setChatState(`${t.depositFail}${e instanceof Error ? e.message : String(e)}`);
+    } finally {
+      setBusy("");
+    }
+  };
   const visibleRows = rows.filter((row) => filter === "all" || severityOf(row, scan) === filter);
   const totalPages = Math.max(1, Math.ceil(visibleRows.length / PAGE_SIZE));
   const pageRows = visibleRows.slice(page * PAGE_SIZE, (page + 1) * PAGE_SIZE);
@@ -403,6 +496,57 @@ function HealthSection() {
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { className: "dshops-btn", disabled: page + 1 >= totalPages, onClick: () => setPage((p) => p + 1), children: t.next })
       ] })
     ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "dshops-card", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("h3", { children: [
+        t.knowledge,
+        " ",
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "dshops-dim", children: t.knowledgeHint })
+      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "dshops-chatbar", style: { marginTop: 0, marginBottom: 8 }, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          "input",
+          {
+            className: "dshops-input",
+            value: knowledgeQuery,
+            placeholder: t.knowledgePlaceholder,
+            onChange: (e) => setKnowledgeQuery(e.target.value),
+            onKeyDown: (e) => {
+              if (e.key === "Enter") void searchKnowledge();
+            }
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { className: "dshops-btn", onClick: () => void searchKnowledge(), children: t.search }),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          "button",
+          {
+            className: "dshops-btn",
+            onClick: () => {
+              setKnowledgeQuery("");
+              void loadKnowledge();
+            },
+            children: t.showAll
+          }
+        )
+      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "dshops-list", children: [
+        knowledge.map((item) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "dshops-item", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { display: "flex", alignItems: "center", gap: 8 }, children: [
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("strong", { style: { fontSize: 12 }, children: item.title }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "dshops-dim", style: { fontSize: 11 }, children: [
+              item.occurrences === void 0 ? "" : format(t.times, { n: item.occurrences }),
+              item.score === void 0 ? "" : `${t.search}: ${item.score}`,
+              item.source ?? "",
+              item.createdAt === void 0 ? "" : item.createdAt.slice(0, 10)
+            ].filter((text) => text !== "").join(" · ") }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { className: "dshops-btn", style: { marginLeft: "auto" }, onClick: () => void removeKnowledge(item.id), children: t.delete })
+          ] }),
+          item.tags !== void 0 && item.tags.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "dshops-dim", style: { fontSize: 11 }, children: item.tags.join(", ") }),
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { fontSize: 12, whiteSpace: "pre-wrap" }, children: (item.symptom ?? "") + (item.fix !== void 0 && item.fix !== "" ? `
+→ ${item.fix}` : "") })
+        ] }, item.id)),
+        knowledge.length === 0 && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "dshops-dim", children: t.knowledgeEmpty })
+      ] })
+    ] }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "dshops-card", children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h3", { children: t.timeline }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "dshops-list", children: [
@@ -426,6 +570,13 @@ function HealthSection() {
         " ",
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "dshops-dim", children: t.chatHint })
       ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "dshops-head", style: { marginBottom: 8 }, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("label", { className: "dshops-dim", style: { display: "flex", alignItems: "center", gap: 6, fontSize: 12, cursor: "pointer" }, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("input", { type: "checkbox", checked: rag, onChange: (e) => toggleRag(e.target.checked) }),
+          t.ragToggle
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { className: "dshops-btn", style: { marginLeft: "auto" }, disabled: busy !== "", onClick: () => void deposit(), children: busy === "deposit" ? t.chatThinking : t.btnDeposit })
+      ] }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "dshops-chat", children: [
         chat.length === 0 && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "dshops-msg dshops-msg-assistant dshops-dim", children: t.chatWelcome }),
         chat.map((message, index) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: `dshops-msg dshops-msg-${message.role}`, children: message.content }, index))

package/lib/host.js

@@ -1,6 +1,6 @@
 import { basename, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { PanelApiError, ScanError, buildChatContext, buildSystemPrompt, handlePanelApi, resolveDshPaths, } from 'dsh-plugin-ops-core';
+import { PanelApiError, ScanError, buildChatContext, buildDepositPrompt, buildSystemPrompt, formatKnowledgeContext, handlePanelApi, parseDepositReply, resolveDshPaths, retrieveKnowledge, upsertKnowledge, } from 'dsh-plugin-ops-core';
 /** HTTP prefix the bundle owns on the harness Web server. */
 export const ROUTE_PREFIX = '/dsh-ops';
 /**
@@ -74,6 +74,10 @@ export function createHostHandler(options) {
                 await handleChat(res, options, paths, url, body);
                 return;
             }
+            if (req.method === 'POST' && apiPath === '/api/knowledge/deposit') {
+                await handleDeposit(res, options, paths, body);
+                return;
+            }
             const apiUrl = new URL(url);
             apiUrl.pathname = apiPath;
             const result = await handlePanelApi(req.method ?? 'GET', apiUrl, apiOptions, body);
@@ -93,6 +97,7 @@ async function handleChat(res, options, paths, url, body) {
     const parsed = JSON.parse(body ?? '{}');
     const profile = typeof parsed.profile === 'string' && parsed.profile !== '' ? parsed.profile : options.profile;
     const lang = typeof parsed.lang === 'string' ? parsed.lang : 'zh';
+    const rag = parsed.rag === true;
     const messages = Array.isArray(parsed.messages)
         ? parsed.messages
             .filter((m) => typeof m === 'object' && m !== null
@@ -114,6 +119,13 @@ async function handleChat(res, options, paths, url, body) {
         return;
     }
     const context = await buildChatContext(paths, profile, options.config);
+    if (rag) {
+        const lastUser = [...messages].reverse().find((message) => message.role === 'user');
+        const query = `${lastUser?.content ?? ''}\n${context.findingsJson}`;
+        const hits = await retrieveKnowledge(paths, query, 3);
+        if (hits.length > 0)
+            context.knowledge = formatKnowledgeContext(hits);
+    }
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), 60000);
     try {
@@ -124,4 +136,44 @@ async function handleChat(res, options, paths, url, body) {
         clearTimeout(timer);
     }
 }
+/** Summarize the current troubleshooting chat into one knowledge entry. */
+async function handleDeposit(res, options, paths, body) {
+    const parsed = JSON.parse(body ?? '{}');
+    const lang = typeof parsed.lang === 'string' ? parsed.lang : 'zh';
+    const messages = Array.isArray(parsed.messages)
+        ? parsed.messages
+            .filter((m) => typeof m === 'object' && m !== null
+            && (m.role === 'user' || m.role === 'assistant')
+            && typeof m.content === 'string')
+            .slice(-12)
+        : [];
+    if (messages.length === 0) {
+        json(res, 400, { error: 'no messages to deposit' });
+        return;
+    }
+    const channel = options.channel();
+    if (channel === null) {
+        json(res, 200, { ok: false, error: 'no model channel available; configure a model to summarize the conversation' });
+        return;
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 60000);
+    try {
+        const result = await channel.complete(buildDepositPrompt(messages, lang), [], controller.signal);
+        if (!result.ok) {
+            json(res, 502, { ok: false, error: result.error });
+            return;
+        }
+        const draft = parseDepositReply(result.reply);
+        if (draft === null) {
+            json(res, 502, { ok: false, error: 'model reply was not a parsable knowledge entry' });
+            return;
+        }
+        const written = upsertKnowledge(paths, { ...draft, source: 'chat' });
+        json(res, written.ok ? 200 : 500, { ok: written.ok, id: written.id, problem: written.problem });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
 //# sourceMappingURL=host.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-ops-bundle",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "type": "module",
   "description": "Embedded dsh bundle for dsh-plugin-ops: a settings-page health panel (scan, plugin rows, diagnosis chat) over the shared engine",
   "license": "MIT",
@@ -57,7 +57,7 @@
     }
   },
   "dependencies": {
-    "dsh-plugin-ops-core": "0.1.2"
+    "dsh-plugin-ops-core": "0.3.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.0"