From 16697df76d7b27ff65d229937b3f3ac4cc0e56a0 Mon Sep 17 00:00:00 2001
From: 云 <2163098428@qq.com>
Date: 星期二, 09 六月 2026 17:27:27 +0800
Subject: [PATCH] docs(knowledge-base): 添加知识库模块传参方式和参数命名规范文档

---
 src/views/collaborativeApproval/knowledgeBase/index.vue |  126 +++++++++++++++++++++++++++++------------
 1 files changed, 89 insertions(+), 37 deletions(-)

diff --git a/src/views/collaborativeApproval/knowledgeBase/index.vue b/src/views/collaborativeApproval/knowledgeBase/index.vue
index 907e51f..0c31e24 100644
--- a/src/views/collaborativeApproval/knowledgeBase/index.vue
+++ b/src/views/collaborativeApproval/knowledgeBase/index.vue
@@ -244,6 +244,7 @@
             :on-success="handleUploadSuccess"
             :on-error="handleUploadError"
             :before-upload="beforeUpload"
+            name="files"
             multiple
             :show-file-list="false"
             accept=".txt,.md,.docx,.xlsx,.xls,.pdf"
@@ -379,7 +380,7 @@
   getVectorStatus,
   reprocessVector,
   saveKnowledgeBaseFiles,
-  deleteKnowledgeBaseFiles,
+  deleteKnowledgeBaseFile,
   knowledgeChat
 } from "@/api/collaborativeApproval/knowledgeBase.js";
 import useUserStore from '@/store/modules/user';
@@ -624,21 +625,31 @@
 
 const getList = () => {
   tableLoading.value = true;
-  listKnowledgeBase({...page.value, ...searchForm.value})
+
+  // 鉁� GET璇锋眰浣跨敤params浼犲弬
+  listKnowledgeBase({
+    current: page.value.current,
+    size: page.value.size,
+    title: searchForm.value.title,
+    type: searchForm.value.type
+  })
   .then(res => {
     tableLoading.value = false;
     page.value.total = res.data.total;
-    // 濡傛灉褰撳墠椤垫暟瓒呰繃鎬婚〉鏁帮紝閲嶇疆鍒扮1椤靛苟閲嶆柊鏌ヨ
+
+    // 濡傛灉褰撳墠椤垫暟瓒呰繃鎬婚〉鏁�,閲嶇疆鍒扮1椤靛苟閲嶆柊鏌ヨ
     const maxPage = Math.ceil(res.data.total / page.value.size) || 1;
     if (page.value.current > maxPage && maxPage > 0) {
       page.value.current = 1;
-      // 閲嶆柊鏌ヨ绗�1椤垫暟鎹�
       return getList();
     }
+
     tableData.value = res.data.records;
-  }).catch(err => {
-    tableLoading.value = false;
   })
+  .catch(err => {
+    tableLoading.value = false;
+    console.error("鏌ヨ鐭ヨ瘑搴撳垪琛ㄥけ璐�:", err);
+  });
 };
 
 // 鍒嗛〉澶勭悊
@@ -813,27 +824,47 @@
 const submitForm = async () => {
   try {
     await formRef.value.validate();
+
+    // 鉁� POST璇锋眰浣跨敤data浼犲弬,鏄庣‘鍙傛暟缁撴瀯
+    const formData = {
+      title: form.value.title,
+      type: form.value.type,
+      scenario: form.value.scenario || "",
+      efficiency: form.value.efficiency || "",
+      problem: form.value.problem,
+      solution: form.value.solution,
+      keyPoints: form.value.keyPoints || "",
+      creator: form.value.creator || "",
+      usageCount: form.value.usageCount || 0
+    };
+
     if (dialogType.value === "add") {
       // 鏂板鐭ヨ瘑
-      addKnowledgeBase({...form.value}).then(res => {
+      addKnowledgeBase(formData).then(res => {
         if(res.code == 200){
           ElMessage.success("娣诲姞鎴愬姛");
           closeKnowledgeDialog();
           getList();
         }
       }).catch(err => {
-        ElMessage.error(err.msg);
-      })
+        console.error("娣诲姞鐭ヨ瘑搴撳け璐�:", err);
+        ElMessage.error(err.msg || "娣诲姞澶辫触");
+      });
     } else {
-      updateKnowledgeBase({...form.value}).then(res => {
+      // 鏇存柊鐭ヨ瘑 - 娣诲姞id鍙傛暟
+      updateKnowledgeBase({
+        id: form.value.id,
+        ...formData
+      }).then(res => {
         if(res.code == 200){
           ElMessage.success("鏇存柊鎴愬姛");
           closeKnowledgeDialog();
           getList();
         }
       }).catch(err => {
-        ElMessage.error(err.msg);
-      })
+        console.error("鏇存柊鐭ヨ瘑搴撳け璐�:", err);
+        ElMessage.error(err.msg || "鏇存柊澶辫触");
+      });
     }
   } catch (error) {
     console.error("琛ㄥ崟楠岃瘉澶辫触:", error);
@@ -847,19 +878,22 @@
     return;
   }
 
-  ElMessageBox.confirm("閫変腑鐨勫唴瀹瑰皢琚垹闄わ紝鏄惁纭鍒犻櫎锛�", "鍒犻櫎", {
+  ElMessageBox.confirm("閫変腑鐨勫唴瀹瑰皢琚垹闄�,鏄惁纭鍒犻櫎?", "鍒犻櫎", {
     confirmButtonText: "纭",
     cancelButtonText: "鍙栨秷",
     type: "warning",
   }).then(() => {
-    // console.log(selectedIds.value);
+    // 鉁� DELETE璇锋眰浣跨敤data浼犻�扞D鏁扮粍
     delKnowledgeBase(selectedIds.value).then(res => {
       if(res.code == 200){
         ElMessage.success("鍒犻櫎鎴愬姛");
         selectedIds.value = [];
         getList();
       }
-    })
+    }).catch(err => {
+      console.error("鍒犻櫎鐭ヨ瘑搴撳け璐�:", err);
+      ElMessage.error(err.msg || "鍒犻櫎澶辫触");
+    });
   }).catch(() => {
     // 鐢ㄦ埛鍙栨秷
   });
@@ -963,9 +997,24 @@
 
 // 涓婁紶鎴愬姛
 const handleUploadSuccess = (response, file) => {
+  console.log("涓婁紶鍝嶅簲:", response);  // 璋冭瘯鏃ュ織
+
   if (response.code === 200) {
-    uploadedBlobIds.value.push(response.data.id);
-    ElMessage.success(`鏂囦欢 ${file.name} 涓婁紶鎴愬姛`);
+    // 鉁� 鍚庣杩斿洖鐨勬槸 List<StorageBlobVO>,鎵�浠ata鏄暟缁�
+    if (Array.isArray(response.data) && response.data.length > 0) {
+      // 鍙栨暟缁勭涓�涓厓绱犵殑id
+      const blobId = response.data[0].id;
+      if (blobId) {
+        uploadedBlobIds.value.push(blobId);
+        ElMessage.success(`鏂囦欢 ${file.name} 涓婁紶鎴愬姛`);
+      } else {
+        console.error("涓婁紶鍝嶅簲涓湭鎵惧埌id:", response.data[0]);
+        ElMessage.error("涓婁紶澶辫触: 鏈幏鍙栧埌鏂囦欢ID");
+      }
+    } else {
+      console.error("涓婁紶鍝嶅簲鏍煎紡閿欒:", response);
+      ElMessage.error("涓婁紶澶辫触: 鍝嶅簲鏍煎紡閿欒");
+    }
   } else {
     ElMessage.error(response.msg || "涓婁紶澶辫触");
   }
@@ -978,22 +1027,30 @@
 
 // 淇濆瓨鏂囦欢鍏宠仈
 const saveFiles = async () => {
+  // 鍙傛暟鏍¢獙
+  if (!currentKnowledgeBase.value?.id) {
+    ElMessage.error("鐭ヨ瘑搴撲俊鎭紓甯�");
+    return;
+  }
+
   if (uploadedBlobIds.value.length === 0) {
     ElMessage.warning("璇峰厛涓婁紶鏂囦欢");
     return;
   }
 
   savingFiles.value = true;
+
   try {
+    // 鉁� POST璇锋眰浣跨敤data浼犲弬,鏄庣‘鍙傛暟缁撴瀯
     await saveKnowledgeBaseFiles({
-      knowledgeBaseId: currentKnowledgeBase.value.id,
-      storageBlobIds: uploadedBlobIds.value
+      knowledgeBaseId: currentKnowledgeBase.value.id,  // 鐭ヨ瘑搴揑D
+      storageBlobIds: uploadedBlobIds.value             // 鏂囦欢blob ID鏁扮粍
     });
 
-    ElMessage.success("鏂囦欢鍏宠仈淇濆瓨鎴愬姛锛屾鍦ㄥ悗鍙板鐞嗗悜閲忓寲");
+    ElMessage.success("鏂囦欢鍏宠仈淇濆瓨鎴愬姛,姝e湪鍚庡彴澶勭悊鍚戦噺鍖�");
     uploadedBlobIds.value = [];
 
-    // 寤惰繜鍒锋柊鏂囦欢鍒楄〃锛岀粰鍚庡彴澶勭悊鏃堕棿
+    // 寤惰繜鍒锋柊鏂囦欢鍒楄〃,缁欏悗鍙板鐞嗘椂闂�
     setTimeout(() => {
       loadFileList();
     }, 1000);
@@ -1030,7 +1087,7 @@
 const deleteFile = async (row) => {
   try {
     await ElMessageBox.confirm(
-      "纭畾瑕佸垹闄よ鏂囦欢鍚楋紵鍒犻櫎鍚庡皢鏃犳硶鎭㈠鍚戦噺鏁版嵁",
+      "纭畾瑕佸垹闄よ鏂囦欢鍚�?鍒犻櫎鍚庡皢鏃犳硶鎭㈠鍚戦噺鏁版嵁",
       "鍒犻櫎纭",
       {
         confirmButtonText: "纭畾",
@@ -1039,7 +1096,8 @@
       }
     );
 
-    await deleteKnowledgeBaseFiles([row.id]);
+    // 鉁� DELETE璇锋眰浣跨敤data浼犻�扞D鏁扮粍
+    await deleteKnowledgeBaseFile([row.id]);  // 娉ㄦ剰: row.id鏄悜閲忚褰旾D,涓嶆槸storageBlobId
     ElMessage.success("鍒犻櫎鎴愬姛");
     loadFileList();
   } catch (error) {
@@ -1095,6 +1153,7 @@
 
 // 鍙戦�佹秷鎭�
 const sendMessage = async () => {
+  // 鍙傛暟鏍¢獙
   if (!inputQuestion.value.trim()) {
     ElMessage.warning("璇疯緭鍏ラ棶棰�");
     return;
@@ -1121,18 +1180,11 @@
   scrollToBottom();
 
   try {
-    // 娴佸紡璇锋眰
-    const response = await fetch('/api/ai/knowledge/chat', {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'Authorization': 'Bearer ' + getToken()
-      },
-      body: JSON.stringify({
-        knowledgeBaseId: currentKnowledgeBase.value.id,
-        memoryId: memoryId.value,
-        question: question
-      })
+    // 鉁� 娴佸紡璇锋眰浣跨敤Fetch API
+    const response = await knowledgeChat({
+      knowledgeBaseId: currentKnowledgeBase.value.id,  // 鐭ヨ瘑搴揑D
+      memoryId: memoryId.value,                         // 浼氳瘽ID
+      question: question                                // 鐢ㄦ埛闂
     });
 
     if (!response.ok) {
@@ -1140,7 +1192,7 @@
       throw new Error(errorText || '璇锋眰澶辫触');
     }
 
-    // 澶勭悊SSE娴佸紡鍝嶅簲
+    // 鉁� 鍚庣杩斿洖 text/stream;charset=utf-8
     const reader = response.body.getReader();
     const decoder = new TextDecoder();
     let aiContent = '';
@@ -1151,7 +1203,7 @@
       const { done, value } = await reader.read();
       if (done) break;
 
-      const text = decoder.decode(value);
+      const text = decoder.decode(value, { stream: true });  // 鉁� 娣诲姞stream閫夐」
       aiContent += text;
       messages.value[messages.value.length - 1].content = aiContent;
 

--
Gitblit v1.9.3