From d2c89cbfbb8c9d7691a8315157cd977a21429134 Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Mon, 16 Mar 2026 11:16:38 +0800
Subject: [PATCH 01/15] fix: add validation rules for knowledge base name input

---
 frontend/src/i18n/locales/en/common.json                 | 2 ++
 frontend/src/i18n/locales/zh/common.json                 | 2 ++
 .../KnowledgeBase/components/CreateKnowledgeBase.tsx     | 9 ++++++++-
 frontend/vite.config.ts                                  | 4 ++--
 4 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/frontend/src/i18n/locales/en/common.json b/frontend/src/i18n/locales/en/common.json
index 0010260c..01ec80f5 100644
--- a/frontend/src/i18n/locales/en/common.json
+++ b/frontend/src/i18n/locales/en/common.json
@@ -1731,6 +1731,8 @@
         "nameLabel": "Knowledge Base Name",
         "namePlaceholder": "Please enter knowledge base name",
         "nameRequired": "Please enter knowledge base name",
+        "nameMaxLength": "Knowledge base name cannot exceed 255 characters",
+        "namePattern": "Knowledge base name must start with a letter and can only contain letters, numbers, and underscores",
         "descriptionLabel": "Description",
         "descriptionPlaceholder": "Please enter knowledge base description (optional)",
         "embeddingModelLabel": "Embedding Model",
diff --git a/frontend/src/i18n/locales/zh/common.json b/frontend/src/i18n/locales/zh/common.json
index b9826e63..d51b54be 100644
--- a/frontend/src/i18n/locales/zh/common.json
+++ b/frontend/src/i18n/locales/zh/common.json
@@ -1731,6 +1731,8 @@
         "nameLabel": "知识库名称",
         "namePlaceholder": "请输入知识库名称",
         "nameRequired": "请输入知识库名称",
+        "nameMaxLength": "知识库名称长度不能超过255个字符",
+        "namePattern": "知识库名称必须以字母开头，只能包含字母、数字和下划线",
         "descriptionLabel": "描述",
         "descriptionPlaceholder": "请输入知识库描述（可选）",
         "embeddingModelLabel": "索引模型",
diff --git a/frontend/src/pages/KnowledgeBase/components/CreateKnowledgeBase.tsx b/frontend/src/pages/KnowledgeBase/components/CreateKnowledgeBase.tsx
index 035fecf0..c476cec2 100644
--- a/frontend/src/pages/KnowledgeBase/components/CreateKnowledgeBase.tsx
+++ b/frontend/src/pages/KnowledgeBase/components/CreateKnowledgeBase.tsx
@@ -177,7 +177,14 @@ export default function CreateKnowledgeBase({
           <Form.Item
             label={t("knowledgeBase.create.form.nameLabel")}
             name="name"
-            rules={[{ required: true, message: t("knowledgeBase.create.form.nameRequired") }]}
+            rules={[
+              { required: true, message: t("knowledgeBase.create.form.nameRequired") },
+              { max: 255, message: t("knowledgeBase.create.form.nameMaxLength") },
+              {
+                pattern: /^[a-zA-Z][a-zA-Z0-9_]*$/,
+                message: t("knowledgeBase.create.form.namePattern"),
+              },
+            ]}
           >
             <Input placeholder={t("knowledgeBase.create.form.namePlaceholder")} />
           </Form.Item>
diff --git a/frontend/vite.config.ts b/frontend/vite.config.ts
index 4ff0c64f..1c69395c 100644
--- a/frontend/vite.config.ts
+++ b/frontend/vite.config.ts
@@ -49,9 +49,9 @@ export default defineConfig({
       };
 
       // Python 服务: rag, synthesis, annotation, evaluation, models
-      const pythonPaths = ["rag", "operators", "categories", "synthesis", "annotation", "knowledge-base", "data-collection", "evaluation", "models"];
+      const pythonPaths = ["rag", "cleaning", "operators", "categories", "synthesis", "annotation", "knowledge-base", "data-collection", "evaluation", "models", "sys-param"];
       // Java 服务: data-management, knowledge-base
-      const javaPaths = ["data-management", "sys-param"];
+      const javaPaths = ["data-management"];
 
       const proxy: Record<string, object> = {};
       // SSE 端点需要禁用缓冲

From 7daece4531ad98be8c88e715ee3055ea6c041a3b Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Mon, 16 Mar 2026 11:37:10 +0800
Subject: [PATCH 02/15] fix: adjust pagination settings and clean up unused
 components in KnowledgeBaseFileDetail

---
 .../FileDetail/KnowledgeBaseFileDetail.tsx        | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
index 0e47fa82..00ef0712 100644
--- a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
+++ b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
@@ -1,5 +1,5 @@
 import React, { useEffect, useState } from "react";
-import {Eye, Edit, Trash2, FileText, Download, FileType2, FileBox} from "lucide-react";
+import {Eye, Edit, Trash2, FileBox} from "lucide-react";
 import { Card, Button, Badge, Input, Tabs, Modal, Breadcrumb, Tag, Spin, Empty, Alert } from "antd";
 import { queryKnowledgeBaseFileDetailUsingGet } from "@/pages/KnowledgeBase/knowledge-base.api";
 import { Link, useParams } from "react-router";
@@ -39,7 +39,7 @@ const KnowledgeBaseFileDetail: React.FC = () => {
   const [chunkDetailModal, setChunkDetailModal] = useState<string | null>(null);
   const [showSliceTraceDialog, setShowSliceTraceDialog] = useState<string | null>(null);
 
-  const pageSize = 20;
+  const pageSize = 10;
   const [currentPage, setCurrentPage] = useState(1);
 
   const safeParse = (meta: unknown): unknown => {
@@ -117,10 +117,10 @@ const KnowledgeBaseFileDetail: React.FC = () => {
     <div className="space-y-4">
       {error && <Alert type="error" message={error} showIcon />}
       <div className="flex items-center justify-between">
-        <div className="text-sm text-gray-600">
-          {t("knowledgeBase.fileDetail.messages.chunkCount", { count: totalElements })}，第 {totalElements === 0 ? 0 : (currentPage - 1) * pageSize + 1}-
-          {Math.min(currentPage * pageSize, totalElements)} 个
-        </div>
+<div className="text-sm text-gray-600">
+  {t("knowledgeBase.fileDetail.messages.chunkCount", { count: totalElements })}，第 {totalElements === 0 ? 0 : (currentPage - 1) * pageSize + 1}-
+  {totalElements === 0 ? 0 : Math.min(currentPage * pageSize, totalElements)} 个
+</div>
         <div className="flex items-center gap-2">
           <Button
             size="small"
@@ -244,14 +244,13 @@ const KnowledgeBaseFileDetail: React.FC = () => {
           id: ragFileId,
           icon: <FileBox className="w-full h-full" />,
           iconColor: "#a27e7e",
-          status: { label: t("knowledgeBase.fileDetail.messages.ready"), color: "default" },
           name: fileName || `文件 ${ragFileId}`,
           description: `${totalElements} ${t("knowledgeBase.fileDetail.messages.chunkCount", { count: 0 })}`,
           createdAt: "",
           lastUpdated: "",
         }}
         statistics={[]}
-        operations={[{ key: "download", label: t("knowledgeBase.fileDetail.actions.download"), icon: <Download className="w-4 h-4" />, onClick: () => {} }]}
+        operations={[]}
       />
       <Card>
         {loading ? <div className="flex items-center justify-center py-8"><Spin /></div> : renderChunks()}

From 5265c0425c21f449839f233180129a1ed00472dd Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Mon, 16 Mar 2026 11:45:10 +0800
Subject: [PATCH 03/15] fix: improve pagination controls and enhance chunk
 display in KnowledgeBaseFileDetail

---
 .../FileDetail/KnowledgeBaseFileDetail.tsx    | 165 ++++++++----------
 1 file changed, 76 insertions(+), 89 deletions(-)

diff --git a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
index 00ef0712..c7fd8c25 100644
--- a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
+++ b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
@@ -1,5 +1,5 @@
 import React, { useEffect, useState } from "react";
-import {Eye, Edit, Trash2, FileBox} from "lucide-react";
+import {Eye, Edit, Trash2, FileBox, ChevronLeft, ChevronRight} from "lucide-react";
 import { Card, Button, Badge, Input, Tabs, Modal, Breadcrumb, Tag, Spin, Empty, Alert } from "antd";
 import { queryKnowledgeBaseFileDetailUsingGet } from "@/pages/KnowledgeBase/knowledge-base.api";
 import { Link, useParams } from "react-router";
@@ -117,113 +117,100 @@ const KnowledgeBaseFileDetail: React.FC = () => {
     <div className="space-y-4">
       {error && <Alert type="error" message={error} showIcon />}
       <div className="flex items-center justify-between">
-<div className="text-sm text-gray-600">
-  {t("knowledgeBase.fileDetail.messages.chunkCount", { count: totalElements })}，第 {totalElements === 0 ? 0 : (currentPage - 1) * pageSize + 1}-
-  {totalElements === 0 ? 0 : Math.min(currentPage * pageSize, totalElements)} 个
-</div>
+        <div className="text-sm text-gray-600">
+          共 {totalElements} 个分块，当前显示第 {totalElements === 0 ? 0 : (currentPage - 1) * pageSize + 1}-
+          {totalElements === 0 ? 0 : Math.min(currentPage * pageSize, totalElements)} 个
+        </div>
         <div className="flex items-center gap-2">
           <Button
             size="small"
+            icon={<ChevronLeft className="w-4 h-4" />}
             onClick={() => setCurrentPage(Math.max(1, currentPage - 1))}
             disabled={currentPage <= 1}
-          >
-            {t("knowledgeBase.fileDetail.messages.previousPage")}
-          </Button>
+          />
           <span className="text-sm text-gray-600">
             {totalPages === 0 ? 0 : currentPage} / {totalPages}
           </span>
           <Button
             size="small"
-            onClick={() => setCurrentPage(Math.min(totalPages ||1, currentPage + 1))}
+            icon={<ChevronRight className="w-4 h-4" />}
+            onClick={() => setCurrentPage(Math.min(totalPages || 1, currentPage + 1))}
             disabled={currentPage >= (totalPages || 1)}
-          >
-            {t("knowledgeBase.fileDetail.messages.nextPage")}
-          </Button>
+          />
         </div>
       </div>
-      <div className="space-y-4">
+      <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
         {currentChunks.map((chunk) => (
-          <Card key={chunk.id} className="p-4">
-            <div className="flex items-start justify-between">
-              <div className="flex-1">
-                <div className="flex items-center gap-2 mb-2">
-                  <div className="flex-1 flex items-center gap-2">
-                    <h4 className="text-sm font-semibold">{t("knowledgeBase.fileDetail.messages.chunkLabel")} {chunk.id}</h4>
-                    {/* 算子名：从 metadata.sliceOperator 显示 */}
-                    {chunk.metadata?.sliceOperator && (
-                      <Tag className="text-xs">
-                        {chunk.metadata.sliceOperator}
-                      </Tag>
-                    )}
-                  </div>
-                  <div className="flex items-center gap-2 ml-4">
-                    {editingChunk === chunk.id ? (
-                      <>
-                        <Button
-                          type="primary"
-                          size="small"
-                          onClick={() => handleSaveChunk(chunk.id)}
-                        >
-                          {t("knowledgeBase.fileDetail.actions.save")}
-                        </Button>
-                        <Button
-                          size="small"
-                          onClick={() => {
-                            setEditingChunk(null);
-                            setEditChunkContent("");
-                          }}
-                        >
-                          {t("knowledgeBase.fileDetail.actions.cancel")}
-                        </Button>
-                      </>
-                    ) : (
-                      <>
-                        <Button size="small" onClick={() => handleViewChunkDetail(chunk.id)}>
-                          <Eye className="w-4 h-4" />
-                        </Button>
-                        <Button size="small" onClick={() => handleEditChunk(chunk.id, chunk.text)}>
-                          <Edit className="w-4 h-4" />
-                        </Button>
-                        <Button size="small" danger onClick={() => handleDeleteChunk(chunk.id)}>
-                          <Trash2 className="w-4 h-4" />
-                        </Button>
-                      </>
-                    )}
-                  </div>
-                </div>
-                <div className="text-sm leading-relaxed text-gray-700">
-                  {editingChunk === chunk.id ? (
-                    <Input.TextArea
-                      value={editChunkContent}
-                      onChange={(e) => setEditChunkContent(e.target.value)}
-                      rows={3}
-                    />
-                  ) : (
-                    chunk.text
-                  )}
-                </div>
-                {/* 元数据展示，保持和召回结果风格一致 */}
-                <div className="mt-2 text-xs text-gray-600">
-                  <div className="font-medium">{t("knowledgeBase.fileDetail.modal.metadata")}:</div>
-                  <pre className="whitespace-pre-wrap break-all m-0">
-                    {typeof chunk.metadata === "string"
-                      ? chunk.metadata
-                      : JSON.stringify(chunk.metadata ?? {}, null, 2)}
-                  </pre>
-                </div>
-                {/* 结构化元数据的快捷标签（若可用） */}
-                <div className="flex items-center gap-4 mt-2 text-xs text-gray-500">
-                  {chunk?.metadata?.position && <span>{t("knowledgeBase.fileDetail.columns.position")}: {chunk.metadata.position}</span>}
-                  {chunk?.metadata?.tokens && <span>Token: {chunk.metadata.tokens}</span>}
-                  {chunk?.metadata?.page && <span>{t("knowledgeBase.fileDetail.columns.page")}: {chunk.metadata.page}</span>}
-                  {chunk?.metadata?.section && <span>{t("knowledgeBase.fileDetail.columns.section")}: {chunk.metadata.section}</span>}
-                </div>
+          <Card
+            key={chunk.id}
+            title={
+              <div className="flex items-center gap-2">
+                <span>{t("knowledgeBase.fileDetail.messages.chunkLabel")} {chunk.id}</span>
+                {chunk.metadata?.sliceOperator && (
+                  <Tag className="text-xs">
+                    {chunk.metadata.sliceOperator}
+                  </Tag>
+                )}
+              </div>
+            }
+            extra={
+              <div className="flex items-center gap-1">
+                {editingChunk === chunk.id ? (
+                  <>
+                    <Button
+                      type="primary"
+                      size="small"
+                      onClick={() => handleSaveChunk(chunk.id)}
+                    >
+                      {t("knowledgeBase.fileDetail.actions.save")}
+                    </Button>
+                    <Button
+                      size="small"
+                      onClick={() => {
+                        setEditingChunk(null);
+                        setEditChunkContent("");
+                      }}
+                    >
+                      {t("knowledgeBase.fileDetail.actions.cancel")}
+                    </Button>
+                  </>
+                ) : (
+                  <>
+                    <Button size="small" type="text" onClick={() => handleViewChunkDetail(chunk.id)}>
+                      <Eye className="w-4 h-4" />
+                    </Button>
+                    <Button size="small" type="text" onClick={() => handleEditChunk(chunk.id, chunk.text)}>
+                      <Edit className="w-4 h-4" />
+                    </Button>
+                    <Button size="small" type="text" danger onClick={() => handleDeleteChunk(chunk.id)}>
+                      <Trash2 className="w-4 h-4" />
+                    </Button>
+                  </>
+                )}
               </div>
+            }
+            style={{ wordBreak: "break-all" }}
+          >
+            <div style={{ marginBottom: 8, fontWeight: 500 }}>
+              {editingChunk === chunk.id ? (
+                <Input.TextArea
+                  value={editChunkContent}
+                  onChange={(e) => setEditChunkContent(e.target.value)}
+                  rows={3}
+                />
+              ) : (
+                chunk.text
+              )}
+            </div>
+            <div style={{ fontSize: 12, color: '#888' }}>
+              metadata <pre style={{ whiteSpace: 'pre-wrap', wordBreak: 'break-all', margin: 0 }}>{typeof chunk.metadata === "string" ? chunk.metadata : JSON.stringify(chunk.metadata ?? {}, null, 2)}</pre>
             </div>
           </Card>
         ))}
         {!loading && currentChunks.length === 0 && (
-          <Empty description={t("knowledgeBase.fileDetail.messages.noChunks")} />
+          <div className="col-span-2">
+            <Empty description={t("knowledgeBase.fileDetail.messages.noChunks")} />
+          </div>
         )}
       </div>
     </div>

From f743c6a89e834d93c2bc19b365413264d4b0d9bf Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Mon, 16 Mar 2026 11:47:09 +0800
Subject: [PATCH 04/15] fix: enhance chunk display messages in
 KnowledgeBaseFileDetail

---
 frontend/src/i18n/locales/en/common.json                       | 2 ++
 frontend/src/i18n/locales/zh/common.json                       | 2 ++
 .../pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx | 3 +--
 3 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/frontend/src/i18n/locales/en/common.json b/frontend/src/i18n/locales/en/common.json
index 01ec80f5..55905895 100644
--- a/frontend/src/i18n/locales/en/common.json
+++ b/frontend/src/i18n/locales/en/common.json
@@ -1694,6 +1694,8 @@
       "messages": {
         "noChunks": "No chunk data",
         "chunkCount": "chunks",
+        "totalChunks": "Total {{count}} chunks",
+        "showingRange": "showing {{start}}-{{end}}",
         "ready": "Ready",
         "previousPage": "Previous Page",
         "nextPage": "Next Page",
diff --git a/frontend/src/i18n/locales/zh/common.json b/frontend/src/i18n/locales/zh/common.json
index d51b54be..b3e9618d 100644
--- a/frontend/src/i18n/locales/zh/common.json
+++ b/frontend/src/i18n/locales/zh/common.json
@@ -1694,6 +1694,8 @@
       "messages": {
         "noChunks": "暂无分块数据",
         "chunkCount": "个分块",
+        "totalChunks": "共 {{count}} 个分块",
+        "showingRange": "当前显示第 {{start}}-{{end}} 个",
         "ready": "就绪",
         "previousPage": "上一页",
         "nextPage": "下一页",
diff --git a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
index c7fd8c25..b5fd4417 100644
--- a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
+++ b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
@@ -118,8 +118,7 @@ const KnowledgeBaseFileDetail: React.FC = () => {
       {error && <Alert type="error" message={error} showIcon />}
       <div className="flex items-center justify-between">
         <div className="text-sm text-gray-600">
-          共 {totalElements} 个分块，当前显示第 {totalElements === 0 ? 0 : (currentPage - 1) * pageSize + 1}-
-          {totalElements === 0 ? 0 : Math.min(currentPage * pageSize, totalElements)} 个
+          {t("knowledgeBase.fileDetail.messages.totalChunks", { count: totalElements })}，{t("knowledgeBase.fileDetail.messages.showingRange", { start: totalElements === 0 ? 0 : (currentPage - 1) * pageSize + 1, end: totalElements === 0 ? 0 : Math.min(currentPage * pageSize, totalElements) })}
         </div>
         <div className="flex items-center gap-2">
           <Button

From a69c3bbe597de23aad335b376bf737d9e70d074e Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Mon, 16 Mar 2026 11:54:52 +0800
Subject: [PATCH 05/15] fix: replace metadata display with syntax highlighter
 in KnowledgeBaseFileDetail

---
 .../FileDetail/KnowledgeBaseFileDetail.tsx    | 38 ++++++++++---------
 1 file changed, 21 insertions(+), 17 deletions(-)

diff --git a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
index b5fd4417..f9a6951a 100644
--- a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
+++ b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
@@ -5,6 +5,8 @@ import { queryKnowledgeBaseFileDetailUsingGet } from "@/pages/KnowledgeBase/know
 import { Link, useParams } from "react-router";
 import DetailHeader from "@/components/DetailHeader";
 import { useTranslation } from "react-i18next";
+import { Prism as SyntaxHighlighter } from "react-syntax-highlighter";
+import { vscDarkPlus } from "react-syntax-highlighter/dist/esm/styles/prism";
 
 interface RagChunk {
   id: string;
@@ -302,23 +304,25 @@ const KnowledgeBaseFileDetail: React.FC = () => {
               key: "metadata",
               label: t("knowledgeBase.fileDetail.modal.metadata"),
               children: (
-                <div className="grid grid-cols-2 gap-4">
-                  <div>
-                    <div className="font-medium mb-1">{t("knowledgeBase.fileDetail.modal.position")}</div>
-                    <Input value={currentChunks.find((c) => c.id === chunkDetailModal)?.metadata?.position || ""} readOnly />
-                  </div>
-                  <div>
-                    <div className="font-medium mb-1">{t("knowledgeBase.fileDetail.modal.tokenCount")}</div>
-                    <Input value={currentChunks.find((c) => c.id === chunkDetailModal)?.metadata?.tokens || ""} readOnly />
-                  </div>
-                  <div>
-                    <div className="font-medium mb-1">{t("knowledgeBase.fileDetail.modal.pageNumber")}</div>
-                    <Input value={currentChunks.find((c) => c.id === chunkDetailModal)?.metadata?.page || ""} readOnly />
-                  </div>
-                  <div>
-                    <div className="font-medium mb-1">{t("knowledgeBase.fileDetail.modal.chapter")}</div>
-                    <Input value={currentChunks.find((c) => c.id === chunkDetailModal)?.metadata?.section || ""} readOnly />
-                  </div>
+                <div>
+                  <SyntaxHighlighter
+                    language="json"
+                    style={vscDarkPlus}
+                    showLineNumbers
+                    customStyle={{
+                      margin: 0,
+                      borderRadius: "0.5rem",
+                      fontSize: "0.875rem",
+                      maxHeight: "400px",
+                      overflow: "auto",
+                    }}
+                  >
+                    {JSON.stringify(
+                      currentChunks.find((c) => c.id === chunkDetailModal)?.metadata || {},
+                      null,
+                      2
+                    ) || "{}"}
+                  </SyntaxHighlighter>
                 </div>
               ),
             },

From cbfad01a2a8adedae3d886badac10990ed01188e Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Mon, 16 Mar 2026 14:59:18 +0800
Subject: [PATCH 06/15] fix: add chunk update and delete functionality with
 user feedback in KnowledgeBaseFileDetail

---
 frontend/src/i18n/locales/en/common.json      |  18 ++-
 frontend/src/i18n/locales/zh/common.json      |  18 ++-
 .../FileDetail/KnowledgeBaseFileDetail.tsx    | 129 +++++++++++++-----
 .../pages/KnowledgeBase/knowledge-base.api.ts |  18 +++
 .../module/rag/infra/vectorstore/__init__.py  |   4 +
 .../app/module/rag/infra/vectorstore/store.py |  84 ++++++++++++
 .../module/rag/interface/knowledge_base.py    |  34 +++++
 .../app/module/rag/schema/request.py          |  18 +++
 .../rag/service/knowledge_base_service.py     |  95 ++++++++++++-
 .../rag/service/strategy/vector_strategy.py   |  75 ++++++++++
 10 files changed, 454 insertions(+), 39 deletions(-)

diff --git a/frontend/src/i18n/locales/en/common.json b/frontend/src/i18n/locales/en/common.json
index 55905895..d6cf23dc 100644
--- a/frontend/src/i18n/locales/en/common.json
+++ b/frontend/src/i18n/locales/en/common.json
@@ -1689,7 +1689,8 @@
       "actions": {
         "download": "Download",
         "save": "Save",
-        "cancel": "Cancel"
+        "cancel": "Cancel",
+        "confirm": "Confirm"
       },
       "messages": {
         "noChunks": "No chunk data",
@@ -1700,7 +1701,16 @@
         "previousPage": "Previous Page",
         "nextPage": "Next Page",
         "chunkLabel": "Chunk",
-        "loadFailed": "Load failed"
+        "loadFailed": "Load failed",
+        "updateSuccess": "Chunk updated successfully",
+        "updateFailed": "Failed to update chunk",
+        "deleteSuccess": "Chunk deleted successfully",
+        "deleteFailed": "Failed to delete chunk",
+        "invalidMetadata": "Invalid metadata JSON format"
+      },
+      "placeholders": {
+        "chunkContent": "Enter chunk content",
+        "metadata": "Enter metadata (JSON format)"
       },
       "modal": {
         "sliceTraceTitle": "Knowledge Slice Trace",
@@ -1715,7 +1725,9 @@
         "position": "Position",
         "tokenCount": "Token Count",
         "pageNumber": "Page Number",
-        "chapter": "Chapter"
+        "chapter": "Chapter",
+        "deleteConfirmTitle": "Confirm Delete Chunk",
+        "deleteConfirmMessage": "Are you sure you want to delete this chunk? This will also delete the vector data in Milvus and cannot be undone."
       },
       "breadcrumb": {
         "kbList": "Knowledge Bases",
diff --git a/frontend/src/i18n/locales/zh/common.json b/frontend/src/i18n/locales/zh/common.json
index b3e9618d..c085c585 100644
--- a/frontend/src/i18n/locales/zh/common.json
+++ b/frontend/src/i18n/locales/zh/common.json
@@ -1689,7 +1689,8 @@
       "actions": {
         "download": "下载",
         "save": "保存",
-        "cancel": "取消"
+        "cancel": "取消",
+        "confirm": "确认"
       },
       "messages": {
         "noChunks": "暂无分块数据",
@@ -1700,7 +1701,16 @@
         "previousPage": "上一页",
         "nextPage": "下一页",
         "chunkLabel": "分块",
-        "loadFailed": "加载失败"
+        "loadFailed": "加载失败",
+        "updateSuccess": "分块更新成功",
+        "updateFailed": "分块更新失败",
+        "deleteSuccess": "分块删除成功",
+        "deleteFailed": "分块删除失败",
+        "invalidMetadata": "元数据JSON格式无效"
+      },
+      "placeholders": {
+        "chunkContent": "请输入分块内容",
+        "metadata": "请输入元数据（JSON格式）"
       },
       "modal": {
         "sliceTraceTitle": "知识切片回溯",
@@ -1715,7 +1725,9 @@
         "position": "位置",
         "tokenCount": "Token数量",
         "pageNumber": "页码",
-        "chapter": "章节"
+        "chapter": "章节",
+        "deleteConfirmTitle": "确认删除分块",
+        "deleteConfirmMessage": "确定要删除这个分块吗？此操作将同时删除Milvus中的向量数据，且无法恢复。"
       },
       "breadcrumb": {
         "kbList": "知识库",
diff --git a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
index f9a6951a..31ef0850 100644
--- a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
+++ b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
@@ -1,7 +1,7 @@
 import React, { useEffect, useState } from "react";
 import {Eye, Edit, Trash2, FileBox, ChevronLeft, ChevronRight} from "lucide-react";
-import { Card, Button, Badge, Input, Tabs, Modal, Breadcrumb, Tag, Spin, Empty, Alert } from "antd";
-import { queryKnowledgeBaseFileDetailUsingGet } from "@/pages/KnowledgeBase/knowledge-base.api";
+import { Card, Button, Badge, Input, Tabs, Modal, Breadcrumb, Tag, Spin, Empty, Alert, message } from "antd";
+import { queryKnowledgeBaseFileDetailUsingGet, updateKnowledgeBaseChunk, deleteKnowledgeBaseChunk } from "@/pages/KnowledgeBase/knowledge-base.api";
 import { Link, useParams } from "react-router";
 import DetailHeader from "@/components/DetailHeader";
 import { useTranslation } from "react-i18next";
@@ -11,20 +11,20 @@ import { vscDarkPlus } from "react-syntax-highlighter/dist/esm/styles/prism";
 interface RagChunk {
   id: string;
   text: string;
-  metadata: unknown; // may be string or object
+  metadata: unknown;
 }
 
+const { TextArea } = Input;
+
 const KnowledgeBaseFileDetail: React.FC = () => {
   const { t } = useTranslation();
   const { id } = useParams();
-  // id 为路由中的 ragFileId，knowledgeBaseId 通过上一级 detail 路由或 query 传入
   const search = new URLSearchParams(window.location.search);
   const knowledgeBaseId = search.get("knowledgeBaseId") || "";
   const fileName = search.get("fileName") || "";
   const ragFileId = id || "";
   const kbLink = knowledgeBaseId ? `/data/knowledge-base/detail/${knowledgeBaseId}` : "/data/knowledge-base";
 
-  // 远程数据状态
   const [paged, setPaged] = useState<{
     page: number;
     size: number;
@@ -35,11 +35,14 @@ const KnowledgeBaseFileDetail: React.FC = () => {
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<string | null>(null);
 
-  // 本地 UI 状态
   const [editingChunk, setEditingChunk] = useState<string | null>(null);
   const [editChunkContent, setEditChunkContent] = useState("");
+  const [editChunkMetadata, setEditChunkMetadata] = useState("");
   const [chunkDetailModal, setChunkDetailModal] = useState<string | null>(null);
   const [showSliceTraceDialog, setShowSliceTraceDialog] = useState<string | null>(null);
+  const [deleteConfirmModal, setDeleteConfirmModal] = useState<string | null>(null);
+  const [saving, setSaving] = useState(false);
+  const [deleting, setDeleting] = useState(false);
 
   const pageSize = 10;
   const [currentPage, setCurrentPage] = useState(1);
@@ -49,7 +52,7 @@ const KnowledgeBaseFileDetail: React.FC = () => {
       try {
         return JSON.parse(meta);
       } catch {
-        return meta; // 保持原样
+        return meta;
       }
     }
     return meta;
@@ -61,7 +64,6 @@ const KnowledgeBaseFileDetail: React.FC = () => {
     setError(null);
     try {
       const res = await queryKnowledgeBaseFileDetailUsingGet(knowledgeBaseId, ragFileId, { page, size: pageSize });
-      // 兼容返回结构 ResponsePagedResponseRagChunk -> { code, message, data }
       const raw = (res?.data ?? res) as {
         page: number;
         size: number;
@@ -87,28 +89,67 @@ const KnowledgeBaseFileDetail: React.FC = () => {
 
   useEffect(() => {
     fetchChunks(currentPage);
-    // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [knowledgeBaseId, ragFileId, currentPage, t]);
 
   const totalElements = paged?.totalElements ?? 0;
   const totalPages = paged?.totalPages ?? 0;
   const currentChunks = paged?.content ?? [];
 
-  const handleEditChunk = (chunkId: string, content: string) => {
+  const handleEditChunk = (chunkId: string, content: string, metadata: unknown) => {
     setEditingChunk(chunkId);
     setEditChunkContent(content);
+    setEditChunkMetadata(JSON.stringify(metadata ?? {}, null, 2));
   };
 
-  const handleSaveChunk = (chunkId: string) => {
-    // TODO: 保存到后端（暂不实现）
-    setEditingChunk(null);
-    setEditChunkContent("");
+  const handleSaveChunk = async (chunkId: string) => {
+    if (!knowledgeBaseId) return;
+    
+    let parsedMetadata = {};
+    try {
+      parsedMetadata = editChunkMetadata ? JSON.parse(editChunkMetadata) : {};
+    } catch {
+      message.error(t("knowledgeBase.fileDetail.messages.invalidMetadata"));
+      return;
+    }
+
+    setSaving(true);
+    try {
+      await updateKnowledgeBaseChunk(knowledgeBaseId, chunkId, {
+        text: editChunkContent,
+        metadata: parsedMetadata,
+      });
+      message.success(t("knowledgeBase.fileDetail.messages.updateSuccess"));
+      setEditingChunk(null);
+      setEditChunkContent("");
+      setEditChunkMetadata("");
+      fetchChunks(currentPage);
+    } catch (err: unknown) {
+      const msg = typeof err === "object" && err !== null && "message" in err 
+        ? String((err as { message?: string }).message) 
+        : t("knowledgeBase.fileDetail.messages.updateFailed");
+      message.error(msg);
+    } finally {
+      setSaving(false);
+    }
   };
 
-  const handleDeleteChunk = (chunkId: string) => {
-    // TODO: 删除后端分块（暂不实现）
-    setEditingChunk(null);
-    setEditChunkContent("");
+  const handleDeleteChunk = async (chunkId: string) => {
+    if (!knowledgeBaseId) return;
+
+    setDeleting(true);
+    try {
+      await deleteKnowledgeBaseChunk(knowledgeBaseId, chunkId);
+      message.success(t("knowledgeBase.fileDetail.messages.deleteSuccess"));
+      setDeleteConfirmModal(null);
+      fetchChunks(currentPage);
+    } catch (err: unknown) {
+      const msg = typeof err === "object" && err !== null && "message" in err 
+        ? String((err as { message?: string }).message) 
+        : t("knowledgeBase.fileDetail.messages.deleteFailed");
+      message.error(msg);
+    } finally {
+      setDeleting(false);
+    }
   };
 
   const handleViewChunkDetail = (chunkId: string) => {
@@ -162,6 +203,7 @@ const KnowledgeBaseFileDetail: React.FC = () => {
                       type="primary"
                       size="small"
                       onClick={() => handleSaveChunk(chunk.id)}
+                      loading={saving}
                     >
                       {t("knowledgeBase.fileDetail.actions.save")}
                     </Button>
@@ -170,6 +212,7 @@ const KnowledgeBaseFileDetail: React.FC = () => {
                       onClick={() => {
                         setEditingChunk(null);
                         setEditChunkContent("");
+                        setEditChunkMetadata("");
                       }}
                     >
                       {t("knowledgeBase.fileDetail.actions.cancel")}
@@ -180,10 +223,10 @@ const KnowledgeBaseFileDetail: React.FC = () => {
                     <Button size="small" type="text" onClick={() => handleViewChunkDetail(chunk.id)}>
                       <Eye className="w-4 h-4" />
                     </Button>
-                    <Button size="small" type="text" onClick={() => handleEditChunk(chunk.id, chunk.text)}>
+                    <Button size="small" type="text" onClick={() => handleEditChunk(chunk.id, chunk.text, chunk.metadata)}>
                       <Edit className="w-4 h-4" />
                     </Button>
-                    <Button size="small" type="text" danger onClick={() => handleDeleteChunk(chunk.id)}>
+                    <Button size="small" type="text" danger onClick={() => setDeleteConfirmModal(chunk.id)}>
                       <Trash2 className="w-4 h-4" />
                     </Button>
                   </>
@@ -194,18 +237,32 @@ const KnowledgeBaseFileDetail: React.FC = () => {
           >
             <div style={{ marginBottom: 8, fontWeight: 500 }}>
               {editingChunk === chunk.id ? (
-                <Input.TextArea
-                  value={editChunkContent}
-                  onChange={(e) => setEditChunkContent(e.target.value)}
-                  rows={3}
-                />
+                <>
+                  <TextArea
+                    value={editChunkContent}
+                    onChange={(e) => setEditChunkContent(e.target.value)}
+                    rows={3}
+                    placeholder={t("knowledgeBase.fileDetail.placeholders.chunkContent")}
+                  />
+                  <div style={{ marginTop: 8 }}>
+                    <div style={{ fontSize: 12, color: '#888', marginBottom: 4 }}>metadata</div>
+                    <TextArea
+                      value={editChunkMetadata}
+                      onChange={(e) => setEditChunkMetadata(e.target.value)}
+                      rows={4}
+                      placeholder={t("knowledgeBase.fileDetail.placeholders.metadata")}
+                    />
+                  </div>
+                </>
               ) : (
                 chunk.text
               )}
             </div>
-            <div style={{ fontSize: 12, color: '#888' }}>
-              metadata <pre style={{ whiteSpace: 'pre-wrap', wordBreak: 'break-all', margin: 0 }}>{typeof chunk.metadata === "string" ? chunk.metadata : JSON.stringify(chunk.metadata ?? {}, null, 2)}</pre>
-            </div>
+            {editingChunk !== chunk.id && (
+              <div style={{ fontSize: 12, color: '#888' }}>
+                metadata <pre style={{ whiteSpace: 'pre-wrap', wordBreak: 'break-all', margin: 0 }}>{typeof chunk.metadata === "string" ? chunk.metadata : JSON.stringify(chunk.metadata ?? {}, null, 2)}</pre>
+              </div>
+            )}
           </Card>
         ))}
         {!loading && currentChunks.length === 0 && (
@@ -226,7 +283,6 @@ const KnowledgeBaseFileDetail: React.FC = () => {
           { title: fileName || `文件 ${ragFileId}` },
         ]}
       />
-      {/* 头部统计使用最简占位，后续可扩展 */}
       <DetailHeader
         data={{
           id: ragFileId,
@@ -244,7 +300,6 @@ const KnowledgeBaseFileDetail: React.FC = () => {
         {loading ? <div className="flex items-center justify-center py-8"><Spin /></div> : renderChunks()}
       </Card>
 
-      {/* Slice Trace Modal */}
       <Modal
         open={!!showSliceTraceDialog}
         onCancel={() => setShowSliceTraceDialog(null)}
@@ -253,7 +308,6 @@ const KnowledgeBaseFileDetail: React.FC = () => {
         width={800}
         destroyOnClose
       >
-        {/* 简化为内容占位，真实数据待后端提供更多字段 */}
         <div className="space-y-4">
           <div className="bg-gray-50 rounded-lg p-4">
             <h4 className="font-medium mb-3">{t("knowledgeBase.fileDetail.modal.sliceProcessTitle")}</h4>
@@ -273,7 +327,6 @@ const KnowledgeBaseFileDetail: React.FC = () => {
         </div>
       </Modal>
 
-      {/* Chunk Detail Modal */}
       <Modal
         open={!!chunkDetailModal}
         onCancel={() => setChunkDetailModal(null)}
@@ -329,6 +382,18 @@ const KnowledgeBaseFileDetail: React.FC = () => {
           ]}
         />
       </Modal>
+
+      <Modal
+        open={!!deleteConfirmModal}
+        onCancel={() => setDeleteConfirmModal(null)}
+        onOk={() => handleDeleteChunk(deleteConfirmModal!)}
+        title={t("knowledgeBase.fileDetail.modal.deleteConfirmTitle")}
+        okText={t("knowledgeBase.fileDetail.actions.confirm")}
+        cancelText={t("knowledgeBase.fileDetail.actions.cancel")}
+        okButtonProps={{ danger: true, loading: deleting }}
+      >
+        <p>{t("knowledgeBase.fileDetail.modal.deleteConfirmMessage")}</p>
+      </Modal>
     </div>
   );
 };
diff --git a/frontend/src/pages/KnowledgeBase/knowledge-base.api.ts b/frontend/src/pages/KnowledgeBase/knowledge-base.api.ts
index 102520c8..1ac85173 100644
--- a/frontend/src/pages/KnowledgeBase/knowledge-base.api.ts
+++ b/frontend/src/pages/KnowledgeBase/knowledge-base.api.ts
@@ -87,3 +87,21 @@ export function queryKnowledgeBase(data: {
 }) {
   return post("/api/knowledge-base/query", data);
 }
+
+export function updateKnowledgeBaseChunk(
+  knowledgeBaseId: string,
+  chunkId: string,
+  data: { text: string; metadata?: Record<string, any> }
+) {
+  return (put as unknown as (url: string, data?: object) => Promise<unknown>)(
+    `/api/knowledge-base/${knowledgeBaseId}/chunks/${chunkId}`,
+    data
+  );
+}
+
+export function deleteKnowledgeBaseChunk(
+  knowledgeBaseId: string,
+  chunkId: string
+) {
+  return del(`/api/knowledge-base/${knowledgeBaseId}/chunks/${chunkId}`);
+}
diff --git a/runtime/datamate-python/app/module/rag/infra/vectorstore/__init__.py b/runtime/datamate-python/app/module/rag/infra/vectorstore/__init__.py
index 289fdb7a..9d410193 100644
--- a/runtime/datamate-python/app/module/rag/infra/vectorstore/__init__.py
+++ b/runtime/datamate-python/app/module/rag/infra/vectorstore/__init__.py
@@ -12,6 +12,8 @@
     drop_collection,
     get_vector_dimension,
     rename_collection,
+    update_chunk_by_id,
+    delete_chunk_by_id,
 )
 
 __all__ = [
@@ -23,4 +25,6 @@
     "get_vector_dimension",
     "delete_chunks_by_rag_file_ids",
     "chunks_to_documents",
+    "update_chunk_by_id",
+    "delete_chunk_by_id",
 ]
diff --git a/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py b/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py
index dd70933e..54e6cf8e 100644
--- a/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py
+++ b/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py
@@ -238,3 +238,87 @@ def chunks_to_documents(
         documents.append(doc)
 
     return documents, ids
+
+
+def update_chunk_by_id(
+    collection_name: str,
+    chunk_id: str,
+    text: str,
+    metadata: Optional[dict] = None,
+    embedding_instance=None,
+) -> None:
+    """更新指定 ID 的分块
+
+    Args:
+        collection_name: 集合名称
+        chunk_id: 分块 ID
+        text: 新的文本内容
+        metadata: 新的元数据（可选）
+        embedding_instance: Embeddings 实例
+    """
+    try:
+        client = get_milvus_client()
+        
+        filter_expr = f'id == "{chunk_id}"'
+        existing = client.query(
+            collection_name=collection_name,
+            filter=filter_expr,
+            output_fields=["metadata"],
+        )
+        
+        if not existing:
+            raise BusinessError(
+                ErrorCodes.RAG_CHUNK_NOT_FOUND,
+                f"Chunk not found: {chunk_id}"
+            )
+        
+        if metadata is None:
+            metadata = existing[0].get("metadata", {})
+        
+        if embedding_instance:
+            embedding = embedding_instance
+        else:
+            from app.module.rag.infra.embeddings import EmbeddingFactory
+            embedding = EmbeddingFactory.create_embeddings()
+        
+        vector = embedding.embed_query(text)
+        
+        client.delete(collection_name=collection_name, filter=filter_expr)
+        
+        client.insert(
+            collection_name=collection_name,
+            data=[{
+                "id": chunk_id,
+                "text": text,
+                "metadata": metadata,
+                "vector": vector,
+            }]
+        )
+        
+        logger.info("成功更新分块: collection=%s chunk_id=%s", collection_name, chunk_id)
+        
+    except BusinessError:
+        raise
+    except Exception as e:
+        logger.error("更新分块失败: %s", e)
+        raise BusinessError(ErrorCodes.RAG_MILVUS_ERROR, f"更新分块失败: {str(e)}") from e
+
+
+def delete_chunk_by_id(collection_name: str, chunk_id: str) -> None:
+    """删除指定 ID 的分块
+
+    Args:
+        collection_name: 集合名称
+        chunk_id: 分块 ID
+    """
+    try:
+        client = get_milvus_client()
+        
+        filter_expr = f'id == "{chunk_id}"'
+        client.delete(collection_name=collection_name, filter=filter_expr)
+        
+        logger.info("成功删除分块: collection=%s chunk_id=%s", collection_name, chunk_id)
+        
+    except Exception as e:
+        logger.error("删除分块失败: %s", e)
+        raise BusinessError(ErrorCodes.RAG_MILVUS_ERROR, f"删除分块失败: {str(e)}") from e
diff --git a/runtime/datamate-python/app/module/rag/interface/knowledge_base.py b/runtime/datamate-python/app/module/rag/interface/knowledge_base.py
index 70f8d4b6..2b212f60 100644
--- a/runtime/datamate-python/app/module/rag/interface/knowledge_base.py
+++ b/runtime/datamate-python/app/module/rag/interface/knowledge_base.py
@@ -21,6 +21,7 @@
     RetrieveReq,
     PagingQuery,
     QueryRequest,
+    ChunkUpdateReq,
 )
 from app.module.rag.service.knowledge_base_service import KnowledgeBaseService
 from app.module.rag.service.unified_retrieval_service import UnifiedRetrievalService
@@ -151,6 +152,39 @@ async def get_file_chunks(
     return SuccessResponse(data=result)
 
 
+@router.put("/{knowledge_base_id}/chunks/{chunk_id}", response_model=SuccessResponse)
+async def update_chunk(
+    knowledge_base_id: str,
+    chunk_id: str,
+    request: ChunkUpdateReq,
+    db: AsyncSession = Depends(get_db),
+):
+    """更新指定分块的文本和元数据"""
+    service = KnowledgeBaseService(db)
+    await service.update_chunk(
+        knowledge_base_id=knowledge_base_id,
+        chunk_id=chunk_id,
+        text=request.text,
+        metadata=request.metadata,
+    )
+    return SuccessResponse(message="分块更新成功")
+
+
+@router.delete("/{knowledge_base_id}/chunks/{chunk_id}", response_model=SuccessResponse)
+async def delete_chunk(
+    knowledge_base_id: str,
+    chunk_id: str,
+    db: AsyncSession = Depends(get_db),
+):
+    """删除指定分块"""
+    service = KnowledgeBaseService(db)
+    await service.delete_chunk(
+        knowledge_base_id=knowledge_base_id,
+        chunk_id=chunk_id,
+    )
+    return SuccessResponse(message="分块删除成功")
+
+
 @router.post("/retrieve", response_model=SuccessResponse)
 async def retrieve_knowledge_base(
     request: RetrieveReq,
diff --git a/runtime/datamate-python/app/module/rag/schema/request.py b/runtime/datamate-python/app/module/rag/schema/request.py
index 262fb785..4463339c 100644
--- a/runtime/datamate-python/app/module/rag/schema/request.py
+++ b/runtime/datamate-python/app/module/rag/schema/request.py
@@ -342,3 +342,21 @@ class Config:
                 "query": "什么是机器学习？"
             }
         }
+
+
+class ChunkUpdateReq(BaseModel):
+    """Chunk更新请求"""
+    text: str = Field(..., min_length=1, description="分块文本内容")
+    metadata: Optional[dict] = Field(default=None, description="元数据")
+
+    class Config:
+        json_schema_extra = {
+            "example": {
+                "text": "这是修改后的分块内容...",
+                "metadata": {
+                    "fileName": "document.pdf",
+                    "chunkIndex": 0,
+                    "customField": "custom value"
+                }
+            }
+        }
diff --git a/runtime/datamate-python/app/module/rag/service/knowledge_base_service.py b/runtime/datamate-python/app/module/rag/service/knowledge_base_service.py
index 41105c89..22f27333 100644
--- a/runtime/datamate-python/app/module/rag/service/knowledge_base_service.py
+++ b/runtime/datamate-python/app/module/rag/service/knowledge_base_service.py
@@ -16,7 +16,14 @@
 from app.db.models.dataset_management import DatasetFiles
 from app.db.models.knowledge_gen import KnowledgeBase, RagFile, FileStatus, RagType
 from app.db.models.models import Models
-from app.module.rag.infra.vectorstore import drop_collection, rename_collection, delete_chunks_by_rag_file_ids
+from app.module.rag.infra.vectorstore import (
+    drop_collection,
+    rename_collection,
+    delete_chunks_by_rag_file_ids,
+    update_chunk_by_id,
+    delete_chunk_by_id,
+)
+from app.module.rag.infra.embeddings import EmbeddingFactory
 from app.module.rag.repository import KnowledgeBaseRepository, RagFileRepository
 from app.module.rag.schema.request import (
     KnowledgeBaseCreateReq,
@@ -388,3 +395,89 @@ async def delete_files(self, knowledge_base_id: str, request: DeleteFilesReq) ->
 
         await self.db.commit()
         logger.info("成功删除 %d 个文件", len(rag_files))
+
+    async def update_chunk(
+        self,
+        knowledge_base_id: str,
+        chunk_id: str,
+        text: str,
+        metadata: dict = None,
+    ) -> None:
+        """更新指定分块的文本和元数据
+        
+        Args:
+            knowledge_base_id: 知识库 ID
+            chunk_id: 分块 ID
+            text: 新的文本内容
+            metadata: 新的元数据（可选）
+        """
+        knowledge_base = await self.kb_repo.get_by_id(knowledge_base_id)
+        if not knowledge_base:
+            raise BusinessError(ErrorCodes.RAG_KNOWLEDGE_BASE_NOT_FOUND)
+        
+        if knowledge_base.type != RagType.DOCUMENT.value:
+            raise BusinessError(
+                ErrorCodes.RAG_INVALID_REQUEST,
+                f"知识库类型 {knowledge_base.type} 不支持分块更新"
+            )
+        
+        from app.module.rag.service.strategy.vector_strategy import VectorKnowledgeBaseStrategy
+        from app.module.system.service.common_service import get_model_by_id
+        import asyncio
+        
+        embedding_entity = await get_model_by_id(self.db, knowledge_base.embedding_model)
+        if not embedding_entity:
+            raise BusinessError(ErrorCodes.RAG_MODEL_NOT_FOUND)
+        
+        embedding = EmbeddingFactory.create_embeddings(
+            model_name=str(embedding_entity.model_name),
+            base_url=getattr(embedding_entity, "base_url", None),
+            api_key=getattr(embedding_entity, "api_key", None),
+        )
+        
+        await asyncio.to_thread(
+            update_chunk_by_id,
+            collection_name=str(knowledge_base.name),
+            chunk_id=chunk_id,
+            text=text,
+            metadata=metadata,
+            embedding_instance=embedding,
+        )
+        
+        logger.info(
+            "成功更新分块: kb=%s chunk_id=%s",
+            knowledge_base_id, chunk_id
+        )
+    
+    async def delete_chunk(
+        self,
+        knowledge_base_id: str,
+        chunk_id: str,
+    ) -> None:
+        """删除指定分块
+        
+        Args:
+            knowledge_base_id: 知识库 ID
+            chunk_id: 分块 ID
+        """
+        knowledge_base = await self.kb_repo.get_by_id(knowledge_base_id)
+        if not knowledge_base:
+            raise BusinessError(ErrorCodes.RAG_KNOWLEDGE_BASE_NOT_FOUND)
+        
+        if knowledge_base.type != RagType.DOCUMENT.value:
+            raise BusinessError(
+                ErrorCodes.RAG_INVALID_REQUEST,
+                f"知识库类型 {knowledge_base.type} 不支持分块删除"
+            )
+        
+        import asyncio
+        await asyncio.to_thread(
+            delete_chunk_by_id,
+            collection_name=str(knowledge_base.name),
+            chunk_id=chunk_id,
+        )
+        
+        logger.info(
+            "成功删除分块: kb=%s chunk_id=%s",
+            knowledge_base_id, chunk_id
+        )
diff --git a/runtime/datamate-python/app/module/rag/service/strategy/vector_strategy.py b/runtime/datamate-python/app/module/rag/service/strategy/vector_strategy.py
index 5570f51a..9db26c2b 100644
--- a/runtime/datamate-python/app/module/rag/service/strategy/vector_strategy.py
+++ b/runtime/datamate-python/app/module/rag/service/strategy/vector_strategy.py
@@ -395,3 +395,78 @@ def _filter_and_clean_chunks(self, chunks: list) -> list:
         
         logger.info("有效分块数量: %d / %d", len(valid_chunks), len(chunks))
         return valid_chunks
+    
+    async def update_chunk(
+        self,
+        knowledge_base_id: str,
+        chunk_id: str,
+        text: str,
+        metadata: Optional[dict] = None,
+    ) -> None:
+        """更新指定分块的文本和元数据
+        
+        Args:
+            knowledge_base_id: 知识库 ID
+            chunk_id: 分块 ID
+            text: 新的文本内容
+            metadata: 新的元数据（可选）
+        """
+        from app.module.rag.infra.vectorstore import update_chunk_by_id
+        
+        kb_repo = KnowledgeBaseRepository(self.db)
+        kb = await kb_repo.get_by_id(knowledge_base_id)
+        if not kb:
+            raise BusinessError(ErrorCodes.RAG_KNOWLEDGE_BASE_NOT_FOUND)
+        
+        embedding_entity = await get_model_by_id(self.db, kb.embedding_model)
+        if not embedding_entity:
+            raise BusinessError(ErrorCodes.RAG_MODEL_NOT_FOUND)
+        
+        embedding = EmbeddingFactory.create_embeddings(
+            model_name=str(embedding_entity.model_name),
+            base_url=getattr(embedding_entity, "base_url", None),
+            api_key=getattr(embedding_entity, "api_key", None),
+        )
+        
+        await asyncio.to_thread(
+            update_chunk_by_id,
+            collection_name=str(kb.name),
+            chunk_id=chunk_id,
+            text=text,
+            metadata=metadata,
+            embedding_instance=embedding,
+        )
+        
+        logger.info(
+            "成功更新分块: kb=%s chunk_id=%s",
+            knowledge_base_id, chunk_id
+        )
+    
+    async def delete_chunk(
+        self,
+        knowledge_base_id: str,
+        chunk_id: str,
+    ) -> None:
+        """删除指定分块
+        
+        Args:
+            knowledge_base_id: 知识库 ID
+            chunk_id: 分块 ID
+        """
+        from app.module.rag.infra.vectorstore import delete_chunk_by_id
+        
+        kb_repo = KnowledgeBaseRepository(self.db)
+        kb = await kb_repo.get_by_id(knowledge_base_id)
+        if not kb:
+            raise BusinessError(ErrorCodes.RAG_KNOWLEDGE_BASE_NOT_FOUND)
+        
+        await asyncio.to_thread(
+            delete_chunk_by_id,
+            collection_name=str(kb.name),
+            chunk_id=chunk_id,
+        )
+        
+        logger.info(
+            "成功删除分块: kb=%s chunk_id=%s",
+            knowledge_base_id, chunk_id
+        )

From c6f2f767ae8bc93a100fa69f3bf3e0a462e99e51 Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Mon, 16 Mar 2026 17:03:25 +0800
Subject: [PATCH 07/15] fix: enhance user feedback and validation messages in
 KnowledgeBaseFileDetail

---
 frontend/src/i18n/locales/en/common.json      |  12 +-
 frontend/src/i18n/locales/zh/common.json      |  31 +++-
 .../FileDetail/KnowledgeBaseFileDetail.tsx    | 134 +++++-------------
 .../app/module/rag/infra/vectorstore/store.py |  10 +-
 4 files changed, 77 insertions(+), 110 deletions(-)

diff --git a/frontend/src/i18n/locales/en/common.json b/frontend/src/i18n/locales/en/common.json
index d6cf23dc..591af393 100644
--- a/frontend/src/i18n/locales/en/common.json
+++ b/frontend/src/i18n/locales/en/common.json
@@ -1690,7 +1690,8 @@
         "download": "Download",
         "save": "Save",
         "cancel": "Cancel",
-        "confirm": "Confirm"
+        "confirm": "Confirm",
+        "formatJson": "Format"
       },
       "messages": {
         "noChunks": "No chunk data",
@@ -1706,7 +1707,11 @@
         "updateFailed": "Failed to update chunk",
         "deleteSuccess": "Chunk deleted successfully",
         "deleteFailed": "Failed to delete chunk",
-        "invalidMetadata": "Invalid metadata JSON format"
+        "invalidMetadata": "Invalid metadata JSON format",
+        "invalidMetadataFormat": "Metadata is not valid JSON format",
+        "textRequired": "Chunk content cannot be empty",
+        "formatSuccess": "JSON formatted successfully",
+        "metadataHint": "Please enter valid JSON format. Click 'Format' button to auto-format."
       },
       "placeholders": {
         "chunkContent": "Enter chunk content",
@@ -1727,7 +1732,8 @@
         "pageNumber": "Page Number",
         "chapter": "Chapter",
         "deleteConfirmTitle": "Confirm Delete Chunk",
-        "deleteConfirmMessage": "Are you sure you want to delete this chunk? This will also delete the vector data in Milvus and cannot be undone."
+        "deleteConfirmMessage": "Are you sure you want to delete this chunk? This will also delete the vector data in Milvus and cannot be undone.",
+        "editChunkTitle": "Edit Chunk"
       },
       "breadcrumb": {
         "kbList": "Knowledge Bases",
diff --git a/frontend/src/i18n/locales/zh/common.json b/frontend/src/i18n/locales/zh/common.json
index c085c585..f0db2ffe 100644
--- a/frontend/src/i18n/locales/zh/common.json
+++ b/frontend/src/i18n/locales/zh/common.json
@@ -1690,7 +1690,8 @@
         "download": "下载",
         "save": "保存",
         "cancel": "取消",
-        "confirm": "确认"
+        "confirm": "确认",
+        "formatJson": "格式化"
       },
       "messages": {
         "noChunks": "暂无分块数据",
@@ -1706,7 +1707,30 @@
         "updateFailed": "分块更新失败",
         "deleteSuccess": "分块删除成功",
         "deleteFailed": "分块删除失败",
-        "invalidMetadata": "元数据JSON格式无效"
+        "invalidMetadata": "元数据JSON格式无效",
+        "invalidMetadataFormat": "元数据不是有效的JSON格式",
+        "textRequired": "分块内容不能为空",
+        "formatSuccess": "JSON格式化成功",
+        "metadataHint": "请输入有效的JSON格式数据，点击\"格式化\"按钮可自动整理格式"
+      },
+      "messages": {
+        "noChunks": "暂无分块数据",
+        "chunkCount": "个分块",
+        "totalChunks": "共 {{count}} 个分块",
+        "showingRange": "当前显示第 {{start}}-{{end}} 个",
+        "ready": "就绪",
+        "previousPage": "上一页",
+        "nextPage": "下一页",
+        "chunkLabel": "分块",
+        "loadFailed": "加载失败",
+        "updateSuccess": "分块更新成功",
+        "updateFailed": "分块更新失败",
+        "deleteSuccess": "分块删除成功",
+        "deleteFailed": "分块删除失败",
+        "invalidMetadata": "元数据JSON格式无效",
+        "textRequired": "分块内容不能为空",
+        "formatSuccess": "JSON格式化成功",
+        "metadataHint": "请输入有效的JSON格式数据，点击\"格式化\"按钮可自动整理格式"
       },
       "placeholders": {
         "chunkContent": "请输入分块内容",
@@ -1727,7 +1751,8 @@
         "pageNumber": "页码",
         "chapter": "章节",
         "deleteConfirmTitle": "确认删除分块",
-        "deleteConfirmMessage": "确定要删除这个分块吗？此操作将同时删除Milvus中的向量数据，且无法恢复。"
+        "deleteConfirmMessage": "确定要删除这个分块吗？此操作将同时删除Milvus中的向量数据，且无法恢复。",
+        "editChunkTitle": "编辑分块"
       },
       "breadcrumb": {
         "kbList": "知识库",
diff --git a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
index 31ef0850..7932f13c 100644
--- a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
+++ b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
@@ -1,12 +1,13 @@
 import React, { useEffect, useState } from "react";
 import {Eye, Edit, Trash2, FileBox, ChevronLeft, ChevronRight} from "lucide-react";
-import { Card, Button, Badge, Input, Tabs, Modal, Breadcrumb, Tag, Spin, Empty, Alert, message } from "antd";
-import { queryKnowledgeBaseFileDetailUsingGet, updateKnowledgeBaseChunk, deleteKnowledgeBaseChunk } from "@/pages/KnowledgeBase/knowledge-base.api";
+import { Card, Button, Tabs, Modal, Breadcrumb, Tag, Spin, Empty, Alert, Badge, Input, message } from "antd";
+import { queryKnowledgeBaseFileDetailUsingGet, deleteKnowledgeBaseChunk } from "@/pages/KnowledgeBase/knowledge-base.api";
 import { Link, useParams } from "react-router";
 import DetailHeader from "@/components/DetailHeader";
 import { useTranslation } from "react-i18next";
 import { Prism as SyntaxHighlighter } from "react-syntax-highlighter";
 import { vscDarkPlus } from "react-syntax-highlighter/dist/esm/styles/prism";
+import EditChunkModal from "./EditChunkModal";
 
 interface RagChunk {
   id: string;
@@ -14,8 +15,6 @@ interface RagChunk {
   metadata: unknown;
 }
 
-const { TextArea } = Input;
-
 const KnowledgeBaseFileDetail: React.FC = () => {
   const { t } = useTranslation();
   const { id } = useParams();
@@ -35,13 +34,10 @@ const KnowledgeBaseFileDetail: React.FC = () => {
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<string | null>(null);
 
-  const [editingChunk, setEditingChunk] = useState<string | null>(null);
-  const [editChunkContent, setEditChunkContent] = useState("");
-  const [editChunkMetadata, setEditChunkMetadata] = useState("");
+  const [editingChunk, setEditingChunk] = useState<RagChunk | null>(null);
   const [chunkDetailModal, setChunkDetailModal] = useState<string | null>(null);
   const [showSliceTraceDialog, setShowSliceTraceDialog] = useState<string | null>(null);
   const [deleteConfirmModal, setDeleteConfirmModal] = useState<string | null>(null);
-  const [saving, setSaving] = useState(false);
   const [deleting, setDeleting] = useState(false);
 
   const pageSize = 10;
@@ -95,42 +91,13 @@ const KnowledgeBaseFileDetail: React.FC = () => {
   const totalPages = paged?.totalPages ?? 0;
   const currentChunks = paged?.content ?? [];
 
-  const handleEditChunk = (chunkId: string, content: string, metadata: unknown) => {
-    setEditingChunk(chunkId);
-    setEditChunkContent(content);
-    setEditChunkMetadata(JSON.stringify(metadata ?? {}, null, 2));
+  const handleEditChunk = (chunk: RagChunk) => {
+    setEditingChunk(chunk);
   };
 
-  const handleSaveChunk = async (chunkId: string) => {
-    if (!knowledgeBaseId) return;
-    
-    let parsedMetadata = {};
-    try {
-      parsedMetadata = editChunkMetadata ? JSON.parse(editChunkMetadata) : {};
-    } catch {
-      message.error(t("knowledgeBase.fileDetail.messages.invalidMetadata"));
-      return;
-    }
-
-    setSaving(true);
-    try {
-      await updateKnowledgeBaseChunk(knowledgeBaseId, chunkId, {
-        text: editChunkContent,
-        metadata: parsedMetadata,
-      });
-      message.success(t("knowledgeBase.fileDetail.messages.updateSuccess"));
-      setEditingChunk(null);
-      setEditChunkContent("");
-      setEditChunkMetadata("");
-      fetchChunks(currentPage);
-    } catch (err: unknown) {
-      const msg = typeof err === "object" && err !== null && "message" in err 
-        ? String((err as { message?: string }).message) 
-        : t("knowledgeBase.fileDetail.messages.updateFailed");
-      message.error(msg);
-    } finally {
-      setSaving(false);
-    }
+  const handleEditSuccess = () => {
+    setEditingChunk(null);
+    fetchChunks(currentPage);
   };
 
   const handleDeleteChunk = async (chunkId: string) => {
@@ -197,72 +164,25 @@ const KnowledgeBaseFileDetail: React.FC = () => {
             }
             extra={
               <div className="flex items-center gap-1">
-                {editingChunk === chunk.id ? (
-                  <>
-                    <Button
-                      type="primary"
-                      size="small"
-                      onClick={() => handleSaveChunk(chunk.id)}
-                      loading={saving}
-                    >
-                      {t("knowledgeBase.fileDetail.actions.save")}
-                    </Button>
-                    <Button
-                      size="small"
-                      onClick={() => {
-                        setEditingChunk(null);
-                        setEditChunkContent("");
-                        setEditChunkMetadata("");
-                      }}
-                    >
-                      {t("knowledgeBase.fileDetail.actions.cancel")}
-                    </Button>
-                  </>
-                ) : (
-                  <>
-                    <Button size="small" type="text" onClick={() => handleViewChunkDetail(chunk.id)}>
-                      <Eye className="w-4 h-4" />
-                    </Button>
-                    <Button size="small" type="text" onClick={() => handleEditChunk(chunk.id, chunk.text, chunk.metadata)}>
-                      <Edit className="w-4 h-4" />
-                    </Button>
-                    <Button size="small" type="text" danger onClick={() => setDeleteConfirmModal(chunk.id)}>
-                      <Trash2 className="w-4 h-4" />
-                    </Button>
-                  </>
-                )}
+                <Button size="small" type="text" onClick={() => handleViewChunkDetail(chunk.id)}>
+                  <Eye className="w-4 h-4" />
+                </Button>
+                <Button size="small" type="text" onClick={() => handleEditChunk(chunk)}>
+                  <Edit className="w-4 h-4" />
+                </Button>
+                <Button size="small" type="text" danger onClick={() => setDeleteConfirmModal(chunk.id)}>
+                  <Trash2 className="w-4 h-4" />
+                </Button>
               </div>
             }
             style={{ wordBreak: "break-all" }}
           >
             <div style={{ marginBottom: 8, fontWeight: 500 }}>
-              {editingChunk === chunk.id ? (
-                <>
-                  <TextArea
-                    value={editChunkContent}
-                    onChange={(e) => setEditChunkContent(e.target.value)}
-                    rows={3}
-                    placeholder={t("knowledgeBase.fileDetail.placeholders.chunkContent")}
-                  />
-                  <div style={{ marginTop: 8 }}>
-                    <div style={{ fontSize: 12, color: '#888', marginBottom: 4 }}>metadata</div>
-                    <TextArea
-                      value={editChunkMetadata}
-                      onChange={(e) => setEditChunkMetadata(e.target.value)}
-                      rows={4}
-                      placeholder={t("knowledgeBase.fileDetail.placeholders.metadata")}
-                    />
-                  </div>
-                </>
-              ) : (
-                chunk.text
-              )}
+              {chunk.text}
+            </div>
+            <div style={{ fontSize: 12, color: '#888' }}>
+              metadata <pre style={{ whiteSpace: 'pre-wrap', wordBreak: 'break-all', margin: 0 }}>{typeof chunk.metadata === "string" ? chunk.metadata : JSON.stringify(chunk.metadata ?? {}, null, 2)}</pre>
             </div>
-            {editingChunk !== chunk.id && (
-              <div style={{ fontSize: 12, color: '#888' }}>
-                metadata <pre style={{ whiteSpace: 'pre-wrap', wordBreak: 'break-all', margin: 0 }}>{typeof chunk.metadata === "string" ? chunk.metadata : JSON.stringify(chunk.metadata ?? {}, null, 2)}</pre>
-              </div>
-            )}
           </Card>
         ))}
         {!loading && currentChunks.length === 0 && (
@@ -394,6 +314,16 @@ const KnowledgeBaseFileDetail: React.FC = () => {
       >
         <p>{t("knowledgeBase.fileDetail.modal.deleteConfirmMessage")}</p>
       </Modal>
+
+      <EditChunkModal
+        open={!!editingChunk}
+        chunkId={editingChunk?.id ?? null}
+        knowledgeBaseId={knowledgeBaseId}
+        initialText={editingChunk?.text ?? ""}
+        initialMetadata={editingChunk?.metadata ?? {}}
+        onCancel={() => setEditingChunk(null)}
+        onSuccess={handleEditSuccess}
+      />
     </div>
   );
 };
diff --git a/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py b/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py
index 54e6cf8e..e0972d61 100644
--- a/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py
+++ b/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py
@@ -271,9 +271,15 @@ def update_chunk_by_id(
                 ErrorCodes.RAG_CHUNK_NOT_FOUND,
                 f"Chunk not found: {chunk_id}"
             )
-        
+
+        existing_metadata = existing[0].get("metadata", {})
+
         if metadata is None:
-            metadata = existing[0].get("metadata", {})
+            metadata = existing_metadata
+        else:
+            # 确保保留原有的 rag_file_id 字段，防止用户修改时丢失
+            if "rag_file_id" in existing_metadata and "rag_file_id" not in metadata:
+                metadata = {**metadata, "rag_file_id": existing_metadata["rag_file_id"]}
         
         if embedding_instance:
             embedding = embedding_instance

From 5df7327be4cb467c610d89ba28ac4d5f982e578a Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Mon, 16 Mar 2026 17:20:06 +0800
Subject: [PATCH 08/15] fix: update breadcrumb and default file name in
 KnowledgeBaseFileDetail

---
 frontend/src/i18n/locales/en/common.json      |  6 +++--
 frontend/src/i18n/locales/zh/common.json      | 22 ++-----------------
 .../FileDetail/KnowledgeBaseFileDetail.tsx    |  4 ++--
 3 files changed, 8 insertions(+), 24 deletions(-)

diff --git a/frontend/src/i18n/locales/en/common.json b/frontend/src/i18n/locales/en/common.json
index 591af393..d0d59f2b 100644
--- a/frontend/src/i18n/locales/en/common.json
+++ b/frontend/src/i18n/locales/en/common.json
@@ -1675,7 +1675,8 @@
         "noProperties": "No properties"
       },
       "breadcrumb": {
-        "kbList": "Knowledge Bases"
+        "kbList": "Knowledge Bases",
+        "kbDetail": "Knowledge Base Detail"
       },
       "searchPlaceholder": "Search file name..."
     },
@@ -1738,7 +1739,8 @@
       "breadcrumb": {
         "kbList": "Knowledge Bases",
         "kbDetail": "Knowledge Base Detail"
-      }
+      },
+      "defaultFileName": "File {{id}}"
     },
     "create": {
       "title": "Create Knowledge Base",
diff --git a/frontend/src/i18n/locales/zh/common.json b/frontend/src/i18n/locales/zh/common.json
index f0db2ffe..4f527e04 100644
--- a/frontend/src/i18n/locales/zh/common.json
+++ b/frontend/src/i18n/locales/zh/common.json
@@ -1713,25 +1713,6 @@
         "formatSuccess": "JSON格式化成功",
         "metadataHint": "请输入有效的JSON格式数据，点击\"格式化\"按钮可自动整理格式"
       },
-      "messages": {
-        "noChunks": "暂无分块数据",
-        "chunkCount": "个分块",
-        "totalChunks": "共 {{count}} 个分块",
-        "showingRange": "当前显示第 {{start}}-{{end}} 个",
-        "ready": "就绪",
-        "previousPage": "上一页",
-        "nextPage": "下一页",
-        "chunkLabel": "分块",
-        "loadFailed": "加载失败",
-        "updateSuccess": "分块更新成功",
-        "updateFailed": "分块更新失败",
-        "deleteSuccess": "分块删除成功",
-        "deleteFailed": "分块删除失败",
-        "invalidMetadata": "元数据JSON格式无效",
-        "textRequired": "分块内容不能为空",
-        "formatSuccess": "JSON格式化成功",
-        "metadataHint": "请输入有效的JSON格式数据，点击\"格式化\"按钮可自动整理格式"
-      },
       "placeholders": {
         "chunkContent": "请输入分块内容",
         "metadata": "请输入元数据（JSON格式）"
@@ -1757,7 +1738,8 @@
       "breadcrumb": {
         "kbList": "知识库",
         "kbDetail": "知识库详情"
-      }
+      },
+      "defaultFileName": "文件 {{id}}"
     },
     "create": {
       "title": "创建知识库",
diff --git a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
index 7932f13c..74b55949 100644
--- a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
+++ b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
@@ -200,7 +200,7 @@ const KnowledgeBaseFileDetail: React.FC = () => {
         items={[
           { title: <Link to="/data/knowledge-base">{t("knowledgeBase.fileDetail.breadcrumb.kbList")}</Link> },
           { title: (<Link to={kbLink}>{t("knowledgeBase.fileDetail.breadcrumb.kbDetail")}</Link>) },
-          { title: fileName || `文件 ${ragFileId}` },
+          { title: fileName || t("knowledgeBase.fileDetail.defaultFileName", { id: ragFileId }) },
         ]}
       />
       <DetailHeader
@@ -208,7 +208,7 @@ const KnowledgeBaseFileDetail: React.FC = () => {
           id: ragFileId,
           icon: <FileBox className="w-full h-full" />,
           iconColor: "#a27e7e",
-          name: fileName || `文件 ${ragFileId}`,
+          name: fileName || t("knowledgeBase.fileDetail.defaultFileName", { id: ragFileId }),
           description: `${totalElements} ${t("knowledgeBase.fileDetail.messages.chunkCount", { count: 0 })}`,
           createdAt: "",
           lastUpdated: "",

From f842cb3a4c50de927b3fbae2f0c5d8256c11a279 Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Mon, 16 Mar 2026 19:24:27 +0800
Subject: [PATCH 09/15] fix: update breadcrumb and default file name in
 KnowledgeBaseFileDetail

---
 .../FileDetail/KnowledgeBaseFileDetail.tsx    | 134 +++++++++++++-----
 1 file changed, 102 insertions(+), 32 deletions(-)

diff --git a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
index 74b55949..465641ed 100644
--- a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
+++ b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
@@ -1,13 +1,12 @@
 import React, { useEffect, useState } from "react";
 import {Eye, Edit, Trash2, FileBox, ChevronLeft, ChevronRight} from "lucide-react";
-import { Card, Button, Tabs, Modal, Breadcrumb, Tag, Spin, Empty, Alert, Badge, Input, message } from "antd";
-import { queryKnowledgeBaseFileDetailUsingGet, deleteKnowledgeBaseChunk } from "@/pages/KnowledgeBase/knowledge-base.api";
+import { Card, Button, Badge, Input, Tabs, Modal, Breadcrumb, Tag, Spin, Empty, Alert, message } from "antd";
+import { queryKnowledgeBaseFileDetailUsingGet, updateKnowledgeBaseChunk, deleteKnowledgeBaseChunk } from "@/pages/KnowledgeBase/knowledge-base.api";
 import { Link, useParams } from "react-router";
 import DetailHeader from "@/components/DetailHeader";
 import { useTranslation } from "react-i18next";
 import { Prism as SyntaxHighlighter } from "react-syntax-highlighter";
 import { vscDarkPlus } from "react-syntax-highlighter/dist/esm/styles/prism";
-import EditChunkModal from "./EditChunkModal";
 
 interface RagChunk {
   id: string;
@@ -15,6 +14,8 @@ interface RagChunk {
   metadata: unknown;
 }
 
+const { TextArea } = Input;
+
 const KnowledgeBaseFileDetail: React.FC = () => {
   const { t } = useTranslation();
   const { id } = useParams();
@@ -34,10 +35,13 @@ const KnowledgeBaseFileDetail: React.FC = () => {
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<string | null>(null);
 
-  const [editingChunk, setEditingChunk] = useState<RagChunk | null>(null);
+  const [editingChunk, setEditingChunk] = useState<string | null>(null);
+  const [editChunkContent, setEditChunkContent] = useState("");
+  const [editChunkMetadata, setEditChunkMetadata] = useState("");
   const [chunkDetailModal, setChunkDetailModal] = useState<string | null>(null);
   const [showSliceTraceDialog, setShowSliceTraceDialog] = useState<string | null>(null);
   const [deleteConfirmModal, setDeleteConfirmModal] = useState<string | null>(null);
+  const [saving, setSaving] = useState(false);
   const [deleting, setDeleting] = useState(false);
 
   const pageSize = 10;
@@ -91,13 +95,42 @@ const KnowledgeBaseFileDetail: React.FC = () => {
   const totalPages = paged?.totalPages ?? 0;
   const currentChunks = paged?.content ?? [];
 
-  const handleEditChunk = (chunk: RagChunk) => {
-    setEditingChunk(chunk);
+  const handleEditChunk = (chunkId: string, content: string, metadata: unknown) => {
+    setEditingChunk(chunkId);
+    setEditChunkContent(content);
+    setEditChunkMetadata(JSON.stringify(metadata ?? {}, null, 2));
   };
 
-  const handleEditSuccess = () => {
-    setEditingChunk(null);
-    fetchChunks(currentPage);
+  const handleSaveChunk = async (chunkId: string) => {
+    if (!knowledgeBaseId) return;
+    
+    let parsedMetadata = {};
+    try {
+      parsedMetadata = editChunkMetadata ? JSON.parse(editChunkMetadata) : {};
+    } catch {
+      message.error(t("knowledgeBase.fileDetail.messages.invalidMetadata"));
+      return;
+    }
+
+    setSaving(true);
+    try {
+      await updateKnowledgeBaseChunk(knowledgeBaseId, chunkId, {
+        text: editChunkContent,
+        metadata: parsedMetadata,
+      });
+      message.success(t("knowledgeBase.fileDetail.messages.updateSuccess"));
+      setEditingChunk(null);
+      setEditChunkContent("");
+      setEditChunkMetadata("");
+      fetchChunks(currentPage);
+    } catch (err: unknown) {
+      const msg = typeof err === "object" && err !== null && "message" in err 
+        ? String((err as { message?: string }).message) 
+        : t("knowledgeBase.fileDetail.messages.updateFailed");
+      message.error(msg);
+    } finally {
+      setSaving(false);
+    }
   };
 
   const handleDeleteChunk = async (chunkId: string) => {
@@ -164,25 +197,72 @@ const KnowledgeBaseFileDetail: React.FC = () => {
             }
             extra={
               <div className="flex items-center gap-1">
-                <Button size="small" type="text" onClick={() => handleViewChunkDetail(chunk.id)}>
-                  <Eye className="w-4 h-4" />
-                </Button>
-                <Button size="small" type="text" onClick={() => handleEditChunk(chunk)}>
-                  <Edit className="w-4 h-4" />
-                </Button>
-                <Button size="small" type="text" danger onClick={() => setDeleteConfirmModal(chunk.id)}>
-                  <Trash2 className="w-4 h-4" />
-                </Button>
+                {editingChunk === chunk.id ? (
+                  <>
+                    <Button
+                      type="primary"
+                      size="small"
+                      onClick={() => handleSaveChunk(chunk.id)}
+                      loading={saving}
+                    >
+                      {t("knowledgeBase.fileDetail.actions.save")}
+                    </Button>
+                    <Button
+                      size="small"
+                      onClick={() => {
+                        setEditingChunk(null);
+                        setEditChunkContent("");
+                        setEditChunkMetadata("");
+                      }}
+                    >
+                      {t("knowledgeBase.fileDetail.actions.cancel")}
+                    </Button>
+                  </>
+                ) : (
+                  <>
+                    <Button size="small" type="text" onClick={() => handleViewChunkDetail(chunk.id)}>
+                      <Eye className="w-4 h-4" />
+                    </Button>
+                    <Button size="small" type="text" onClick={() => handleEditChunk(chunk.id, chunk.text, chunk.metadata)}>
+                      <Edit className="w-4 h-4" />
+                    </Button>
+                    <Button size="small" type="text" danger onClick={() => setDeleteConfirmModal(chunk.id)}>
+                      <Trash2 className="w-4 h-4" />
+                    </Button>
+                  </>
+                )}
               </div>
             }
             style={{ wordBreak: "break-all" }}
           >
             <div style={{ marginBottom: 8, fontWeight: 500 }}>
-              {chunk.text}
-            </div>
-            <div style={{ fontSize: 12, color: '#888' }}>
-              metadata <pre style={{ whiteSpace: 'pre-wrap', wordBreak: 'break-all', margin: 0 }}>{typeof chunk.metadata === "string" ? chunk.metadata : JSON.stringify(chunk.metadata ?? {}, null, 2)}</pre>
+              {editingChunk === chunk.id ? (
+                <>
+                  <TextArea
+                    value={editChunkContent}
+                    onChange={(e) => setEditChunkContent(e.target.value)}
+                    rows={3}
+                    placeholder={t("knowledgeBase.fileDetail.placeholders.chunkContent")}
+                  />
+                  <div style={{ marginTop: 8 }}>
+                    <div style={{ fontSize: 12, color: '#888', marginBottom: 4 }}>metadata</div>
+                    <TextArea
+                      value={editChunkMetadata}
+                      onChange={(e) => setEditChunkMetadata(e.target.value)}
+                      rows={4}
+                      placeholder={t("knowledgeBase.fileDetail.placeholders.metadata")}
+                    />
+                  </div>
+                </>
+              ) : (
+                chunk.text
+              )}
             </div>
+            {editingChunk !== chunk.id && (
+              <div style={{ fontSize: 12, color: '#888' }}>
+                metadata <pre style={{ whiteSpace: 'pre-wrap', wordBreak: 'break-all', margin: 0 }}>{typeof chunk.metadata === "string" ? chunk.metadata : JSON.stringify(chunk.metadata ?? {}, null, 2)}</pre>
+              </div>
+            )}
           </Card>
         ))}
         {!loading && currentChunks.length === 0 && (
@@ -314,16 +394,6 @@ const KnowledgeBaseFileDetail: React.FC = () => {
       >
         <p>{t("knowledgeBase.fileDetail.modal.deleteConfirmMessage")}</p>
       </Modal>
-
-      <EditChunkModal
-        open={!!editingChunk}
-        chunkId={editingChunk?.id ?? null}
-        knowledgeBaseId={knowledgeBaseId}
-        initialText={editingChunk?.text ?? ""}
-        initialMetadata={editingChunk?.metadata ?? {}}
-        onCancel={() => setEditingChunk(null)}
-        onSuccess={handleEditSuccess}
-      />
     </div>
   );
 };

From 36c9337b231e53f1407ff2cab10ab50fbd06e226 Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Mon, 16 Mar 2026 21:38:13 +0800
Subject: [PATCH 10/15] fix: enhance metadata validation and add action buttons
 in KnowledgeBaseFileDetail

---
 frontend/src/i18n/locales/en/common.json      |   9 +-
 frontend/src/i18n/locales/zh/common.json      |   9 +-
 .../FileDetail/KnowledgeBaseFileDetail.tsx    | 259 +++++++++++++-----
 3 files changed, 207 insertions(+), 70 deletions(-)

diff --git a/frontend/src/i18n/locales/en/common.json b/frontend/src/i18n/locales/en/common.json
index d0d59f2b..8189324c 100644
--- a/frontend/src/i18n/locales/en/common.json
+++ b/frontend/src/i18n/locales/en/common.json
@@ -1692,7 +1692,10 @@
         "save": "Save",
         "cancel": "Cancel",
         "confirm": "Confirm",
-        "formatJson": "Format"
+        "formatJson": "Format",
+        "view": "View",
+        "edit": "Edit",
+        "delete": "Delete"
       },
       "messages": {
         "noChunks": "No chunk data",
@@ -1712,7 +1715,9 @@
         "invalidMetadataFormat": "Metadata is not valid JSON format",
         "textRequired": "Chunk content cannot be empty",
         "formatSuccess": "JSON formatted successfully",
-        "metadataHint": "Please enter valid JSON format. Click 'Format' button to auto-format."
+        "metadataHint": "Please enter valid JSON format. Click 'Format' button to auto-format.",
+        "jsonValid": "Valid JSON",
+        "jsonInvalid": "Invalid JSON"
       },
       "placeholders": {
         "chunkContent": "Enter chunk content",
diff --git a/frontend/src/i18n/locales/zh/common.json b/frontend/src/i18n/locales/zh/common.json
index 4f527e04..55e5fe50 100644
--- a/frontend/src/i18n/locales/zh/common.json
+++ b/frontend/src/i18n/locales/zh/common.json
@@ -1691,7 +1691,10 @@
         "save": "保存",
         "cancel": "取消",
         "confirm": "确认",
-        "formatJson": "格式化"
+        "formatJson": "格式化",
+        "view": "查看",
+        "edit": "编辑",
+        "delete": "删除"
       },
       "messages": {
         "noChunks": "暂无分块数据",
@@ -1711,7 +1714,9 @@
         "invalidMetadataFormat": "元数据不是有效的JSON格式",
         "textRequired": "分块内容不能为空",
         "formatSuccess": "JSON格式化成功",
-        "metadataHint": "请输入有效的JSON格式数据，点击\"格式化\"按钮可自动整理格式"
+        "metadataHint": "请输入有效的JSON格式数据，点击\"格式化\"按钮可自动整理格式",
+        "jsonValid": "JSON格式正确",
+        "jsonInvalid": "JSON格式错误"
       },
       "placeholders": {
         "chunkContent": "请输入分块内容",
diff --git a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
index 465641ed..61b9f2a8 100644
--- a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
+++ b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
@@ -1,6 +1,6 @@
-import React, { useEffect, useState } from "react";
-import {Eye, Edit, Trash2, FileBox, ChevronLeft, ChevronRight} from "lucide-react";
-import { Card, Button, Badge, Input, Tabs, Modal, Breadcrumb, Tag, Spin, Empty, Alert, message } from "antd";
+import React, { useEffect, useState, useCallback } from "react";
+import {Eye, Edit, Trash2, FileBox, ChevronLeft, ChevronRight, Code, CheckCircle, AlertCircle, Wand2} from "lucide-react";
+import { Card, Button, Badge, Input, Tabs, Modal, Breadcrumb, Tag, Spin, Empty, Alert, message, Tooltip } from "antd";
 import { queryKnowledgeBaseFileDetailUsingGet, updateKnowledgeBaseChunk, deleteKnowledgeBaseChunk } from "@/pages/KnowledgeBase/knowledge-base.api";
 import { Link, useParams } from "react-router";
 import DetailHeader from "@/components/DetailHeader";
@@ -38,6 +38,8 @@ const KnowledgeBaseFileDetail: React.FC = () => {
   const [editingChunk, setEditingChunk] = useState<string | null>(null);
   const [editChunkContent, setEditChunkContent] = useState("");
   const [editChunkMetadata, setEditChunkMetadata] = useState("");
+  const [metadataValid, setMetadataValid] = useState(true);
+  const [metadataError, setMetadataError] = useState<string | null>(null);
   const [chunkDetailModal, setChunkDetailModal] = useState<string | null>(null);
   const [showSliceTraceDialog, setShowSliceTraceDialog] = useState<string | null>(null);
   const [deleteConfirmModal, setDeleteConfirmModal] = useState<string | null>(null);
@@ -99,11 +101,56 @@ const KnowledgeBaseFileDetail: React.FC = () => {
     setEditingChunk(chunkId);
     setEditChunkContent(content);
     setEditChunkMetadata(JSON.stringify(metadata ?? {}, null, 2));
+    setMetadataValid(true);
+    setMetadataError(null);
   };
 
+  const validateJson = useCallback((value: string): { valid: boolean; error: string | null } => {
+    if (!value || value.trim() === "") {
+      return { valid: true, error: null };
+    }
+    try {
+      JSON.parse(value);
+      return { valid: true, error: null };
+    } catch (e) {
+      const errorMessage = e instanceof Error ? e.message : t("knowledgeBase.fileDetail.messages.invalidMetadataFormat");
+      return { valid: false, error: errorMessage };
+    }
+  }, [t]);
+
+  const handleMetadataChange = useCallback((value: string) => {
+    setEditChunkMetadata(value);
+    const { valid, error } = validateJson(value);
+    setMetadataValid(valid);
+    setMetadataError(error);
+  }, [validateJson]);
+
+  const formatJson = useCallback(() => {
+    try {
+      const parsed = JSON.parse(editChunkMetadata || "{}");
+      const formatted = JSON.stringify(parsed, null, 2);
+      setEditChunkMetadata(formatted);
+      setMetadataValid(true);
+      setMetadataError(null);
+      message.success(t("knowledgeBase.fileDetail.messages.formatSuccess"));
+    } catch {
+      message.error(t("knowledgeBase.fileDetail.messages.invalidMetadataFormat"));
+    }
+  }, [editChunkMetadata, t]);
+
   const handleSaveChunk = async (chunkId: string) => {
     if (!knowledgeBaseId) return;
-    
+
+    if (!editChunkContent.trim()) {
+      message.error(t("knowledgeBase.fileDetail.messages.textRequired"));
+      return;
+    }
+
+    if (!metadataValid) {
+      message.error(t("knowledgeBase.fileDetail.messages.invalidMetadata"));
+      return;
+    }
+
     let parsedMetadata = {};
     try {
       parsedMetadata = editChunkMetadata ? JSON.parse(editChunkMetadata) : {};
@@ -122,10 +169,12 @@ const KnowledgeBaseFileDetail: React.FC = () => {
       setEditingChunk(null);
       setEditChunkContent("");
       setEditChunkMetadata("");
+      setMetadataValid(true);
+      setMetadataError(null);
       fetchChunks(currentPage);
     } catch (err: unknown) {
-      const msg = typeof err === "object" && err !== null && "message" in err 
-        ? String((err as { message?: string }).message) 
+      const msg = typeof err === "object" && err !== null && "message" in err
+        ? String((err as { message?: string }).message)
         : t("knowledgeBase.fileDetail.messages.updateFailed");
       message.error(msg);
     } finally {
@@ -197,72 +246,34 @@ const KnowledgeBaseFileDetail: React.FC = () => {
             }
             extra={
               <div className="flex items-center gap-1">
-                {editingChunk === chunk.id ? (
-                  <>
-                    <Button
-                      type="primary"
-                      size="small"
-                      onClick={() => handleSaveChunk(chunk.id)}
-                      loading={saving}
-                    >
-                      {t("knowledgeBase.fileDetail.actions.save")}
-                    </Button>
-                    <Button
-                      size="small"
-                      onClick={() => {
-                        setEditingChunk(null);
-                        setEditChunkContent("");
-                        setEditChunkMetadata("");
-                      }}
-                    >
-                      {t("knowledgeBase.fileDetail.actions.cancel")}
-                    </Button>
-                  </>
-                ) : (
-                  <>
-                    <Button size="small" type="text" onClick={() => handleViewChunkDetail(chunk.id)}>
-                      <Eye className="w-4 h-4" />
-                    </Button>
-                    <Button size="small" type="text" onClick={() => handleEditChunk(chunk.id, chunk.text, chunk.metadata)}>
-                      <Edit className="w-4 h-4" />
-                    </Button>
-                    <Button size="small" type="text" danger onClick={() => setDeleteConfirmModal(chunk.id)}>
-                      <Trash2 className="w-4 h-4" />
-                    </Button>
-                  </>
-                )}
+                <Tooltip title={t("knowledgeBase.fileDetail.actions.view")}>
+                  <Button size="small" type="text" onClick={() => handleViewChunkDetail(chunk.id)}>
+                    <Eye className="w-4 h-4" />
+                  </Button>
+                </Tooltip>
+                <Tooltip title={t("knowledgeBase.fileDetail.actions.edit")}>
+                  <Button size="small" type="text" onClick={() => handleEditChunk(chunk.id, chunk.text, chunk.metadata)}>
+                    <Edit className="w-4 h-4" />
+                  </Button>
+                </Tooltip>
+                <Tooltip title={t("knowledgeBase.fileDetail.actions.delete")}>
+                  <Button size="small" type="text" danger onClick={() => setDeleteConfirmModal(chunk.id)}>
+                    <Trash2 className="w-4 h-4" />
+                  </Button>
+                </Tooltip>
               </div>
             }
             style={{ wordBreak: "break-all" }}
           >
             <div style={{ marginBottom: 8, fontWeight: 500 }}>
-              {editingChunk === chunk.id ? (
-                <>
-                  <TextArea
-                    value={editChunkContent}
-                    onChange={(e) => setEditChunkContent(e.target.value)}
-                    rows={3}
-                    placeholder={t("knowledgeBase.fileDetail.placeholders.chunkContent")}
-                  />
-                  <div style={{ marginTop: 8 }}>
-                    <div style={{ fontSize: 12, color: '#888', marginBottom: 4 }}>metadata</div>
-                    <TextArea
-                      value={editChunkMetadata}
-                      onChange={(e) => setEditChunkMetadata(e.target.value)}
-                      rows={4}
-                      placeholder={t("knowledgeBase.fileDetail.placeholders.metadata")}
-                    />
-                  </div>
-                </>
-              ) : (
-                chunk.text
-              )}
+              {chunk.text}
+            </div>
+            <div style={{ fontSize: 12, color: '#888' }}>
+              metadata
+              <pre style={{ whiteSpace: 'pre-wrap', wordBreak: 'break-all', margin: 0, marginTop: 4 }}>
+                {typeof chunk.metadata === "string" ? chunk.metadata : JSON.stringify(chunk.metadata ?? {}, null, 2)}
+              </pre>
             </div>
-            {editingChunk !== chunk.id && (
-              <div style={{ fontSize: 12, color: '#888' }}>
-                metadata <pre style={{ whiteSpace: 'pre-wrap', wordBreak: 'break-all', margin: 0 }}>{typeof chunk.metadata === "string" ? chunk.metadata : JSON.stringify(chunk.metadata ?? {}, null, 2)}</pre>
-              </div>
-            )}
           </Card>
         ))}
         {!loading && currentChunks.length === 0 && (
@@ -394,6 +405,122 @@ const KnowledgeBaseFileDetail: React.FC = () => {
       >
         <p>{t("knowledgeBase.fileDetail.modal.deleteConfirmMessage")}</p>
       </Modal>
+
+      <Modal
+        open={!!editingChunk}
+        onCancel={() => {
+          setEditingChunk(null);
+          setEditChunkContent("");
+          setEditChunkMetadata("");
+          setMetadataValid(true);
+          setMetadataError(null);
+        }}
+        footer={null}
+        title={
+          <div className="flex items-center gap-2">
+            <Edit className="w-5 h-5 text-blue-500" />
+            <span>{t("knowledgeBase.fileDetail.modal.editChunkTitle")} - {editingChunk}</span>
+          </div>
+        }
+        width={900}
+        destroyOnClose
+      >
+        <div className="space-y-6">
+          <div>
+            <div className="flex items-center justify-between mb-2">
+              <label className="font-medium text-gray-700">
+                {t("knowledgeBase.fileDetail.modal.chunkContent")}
+              </label>
+            </div>
+            <Input.TextArea
+              value={editChunkContent}
+              onChange={(e) => setEditChunkContent(e.target.value)}
+              rows={6}
+              placeholder={t("knowledgeBase.fileDetail.placeholders.chunkContent")}
+              className="font-mono"
+              style={{
+                fontFamily: 'ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace',
+              }}
+            />
+          </div>
+
+          <div>
+            <div className="flex items-center justify-between mb-2">
+              <label className="font-medium text-gray-700 flex items-center gap-2">
+                <Code className="w-4 h-4" />
+                {t("knowledgeBase.fileDetail.modal.metadata")}
+              </label>
+              <div className="flex items-center gap-2">
+                {metadataValid ? (
+                  <span className="flex items-center gap-1 text-green-600 text-sm">
+                    <CheckCircle className="w-4 h-4" />
+                    {t("knowledgeBase.fileDetail.messages.jsonValid")}
+                  </span>
+                ) : (
+                  <span className="flex items-center gap-1 text-red-500 text-sm">
+                    <AlertCircle className="w-4 h-4" />
+                    {t("knowledgeBase.fileDetail.messages.jsonInvalid")}
+                  </span>
+                )}
+                <Button
+                  size="small"
+                  icon={<Wand2 className="w-4 h-4" />}
+                  onClick={formatJson}
+                  type="default"
+                >
+                  {t("knowledgeBase.fileDetail.actions.formatJson")}
+                </Button>
+              </div>
+            </div>
+            <div className="relative">
+              <Input.TextArea
+                value={editChunkMetadata}
+                onChange={(e) => handleMetadataChange(e.target.value)}
+                rows={10}
+                placeholder={t("knowledgeBase.fileDetail.placeholders.metadata")}
+                className="font-mono"
+                style={{
+                  fontFamily: 'ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace',
+                  borderColor: metadataValid ? '#d9d9d9' : '#ff4d4f',
+                }}
+                status={metadataValid ? undefined : 'error'}
+              />
+              {metadataError && (
+                <div className="mt-2 text-red-500 text-xs flex items-start gap-1">
+                  <AlertCircle className="w-4 h-4 flex-shrink-0 mt-0.5" />
+                  <span className="break-all">{metadataError}</span>
+                </div>
+              )}
+              <div className="mt-2 text-gray-400 text-xs">
+                {t("knowledgeBase.fileDetail.messages.metadataHint")}
+              </div>
+            </div>
+          </div>
+
+          <div className="flex justify-end gap-2 pt-4 border-t border-gray-100">
+            <Button
+              onClick={() => {
+                setEditingChunk(null);
+                setEditChunkContent("");
+                setEditChunkMetadata("");
+                setMetadataValid(true);
+                setMetadataError(null);
+              }}
+            >
+              {t("knowledgeBase.fileDetail.actions.cancel")}
+            </Button>
+            <Button
+              type="primary"
+              onClick={() => editingChunk && handleSaveChunk(editingChunk)}
+              loading={saving}
+              disabled={!metadataValid || !editChunkContent.trim()}
+              icon={<CheckCircle className="w-4 h-4" />}
+            >
+              {t("knowledgeBase.fileDetail.actions.save")}
+            </Button>
+          </div>
+        </div>
+      </Modal>
     </div>
   );
 };

From 39a717e38a23077bd749a16abe11e309af59ab09 Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Mon, 16 Mar 2026 23:54:24 +0800
Subject: [PATCH 11/15] fix: enhance chunk deletion process and return
 rag_file_id in delete_chunk_by_id

---
 .../Detail/KnowledgeBaseDetail.tsx            |  1 +
 .../app/module/rag/infra/vectorstore/store.py | 22 ++++++++++--
 .../rag/service/knowledge_base_service.py     | 35 +++++++++++--------
 3 files changed, 41 insertions(+), 17 deletions(-)

diff --git a/frontend/src/pages/KnowledgeBase/Detail/KnowledgeBaseDetail.tsx b/frontend/src/pages/KnowledgeBase/Detail/KnowledgeBaseDetail.tsx
index 2b7c387a..9812b924 100644
--- a/frontend/src/pages/KnowledgeBase/Detail/KnowledgeBaseDetail.tsx
+++ b/frontend/src/pages/KnowledgeBase/Detail/KnowledgeBaseDetail.tsx
@@ -154,6 +154,7 @@ const KnowledgeBaseDetailPage: React.FC = () => {
       });
       message.success(t("knowledgeBase.detail.messages.fileDeleted"));
       fetchFiles();
+      fetchKnowledgeBaseDetails(knowledgeBase!.id);
     } catch {
       message.error(t("knowledgeBase.detail.messages.fileDeleteFailed"));
     }
diff --git a/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py b/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py
index e0972d61..88fb49c8 100644
--- a/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py
+++ b/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py
@@ -310,20 +310,38 @@ def update_chunk_by_id(
         raise BusinessError(ErrorCodes.RAG_MILVUS_ERROR, f"更新分块失败: {str(e)}") from e
 
 
-def delete_chunk_by_id(collection_name: str, chunk_id: str) -> None:
+def delete_chunk_by_id(collection_name: str, chunk_id: str) -> Optional[str]:
     """删除指定 ID 的分块
 
     Args:
         collection_name: 集合名称
         chunk_id: 分块 ID
+
+    Returns:
+        被删除分块对应的 rag_file_id（如果存在），否则返回 None
     """
     try:
         client = get_milvus_client()
         
         filter_expr = f'id == "{chunk_id}"'
+        
+        # 先查询 chunk 的 metadata 获取 rag_file_id
+        existing = client.query(
+            collection_name=collection_name,
+            filter=filter_expr,
+            output_fields=["metadata"],
+        )
+        
+        rag_file_id = None
+        if existing:
+            metadata = existing[0].get("metadata", {})
+            rag_file_id = metadata.get("rag_file_id")
+        
         client.delete(collection_name=collection_name, filter=filter_expr)
         
-        logger.info("成功删除分块: collection=%s chunk_id=%s", collection_name, chunk_id)
+        logger.info("成功删除分块: collection=%s chunk_id=%s rag_file_id=%s", collection_name, chunk_id, rag_file_id)
+        
+        return rag_file_id
         
     except Exception as e:
         logger.error("删除分块失败: %s", e)
diff --git a/runtime/datamate-python/app/module/rag/service/knowledge_base_service.py b/runtime/datamate-python/app/module/rag/service/knowledge_base_service.py
index 22f27333..99027ce6 100644
--- a/runtime/datamate-python/app/module/rag/service/knowledge_base_service.py
+++ b/runtime/datamate-python/app/module/rag/service/knowledge_base_service.py
@@ -16,6 +16,7 @@
 from app.db.models.dataset_management import DatasetFiles
 from app.db.models.knowledge_gen import KnowledgeBase, RagFile, FileStatus, RagType
 from app.db.models.models import Models
+from app.module.rag.infra.embeddings import EmbeddingFactory
 from app.module.rag.infra.vectorstore import (
     drop_collection,
     rename_collection,
@@ -23,7 +24,6 @@
     update_chunk_by_id,
     delete_chunk_by_id,
 )
-from app.module.rag.infra.embeddings import EmbeddingFactory
 from app.module.rag.repository import KnowledgeBaseRepository, RagFileRepository
 from app.module.rag.schema.request import (
     KnowledgeBaseCreateReq,
@@ -404,7 +404,7 @@ async def update_chunk(
         metadata: dict = None,
     ) -> None:
         """更新指定分块的文本和元数据
-        
+
         Args:
             knowledge_base_id: 知识库 ID
             chunk_id: 分块 ID
@@ -414,27 +414,26 @@ async def update_chunk(
         knowledge_base = await self.kb_repo.get_by_id(knowledge_base_id)
         if not knowledge_base:
             raise BusinessError(ErrorCodes.RAG_KNOWLEDGE_BASE_NOT_FOUND)
-        
+
         if knowledge_base.type != RagType.DOCUMENT.value:
             raise BusinessError(
                 ErrorCodes.RAG_INVALID_REQUEST,
                 f"知识库类型 {knowledge_base.type} 不支持分块更新"
             )
-        
-        from app.module.rag.service.strategy.vector_strategy import VectorKnowledgeBaseStrategy
+
         from app.module.system.service.common_service import get_model_by_id
         import asyncio
-        
+
         embedding_entity = await get_model_by_id(self.db, knowledge_base.embedding_model)
         if not embedding_entity:
             raise BusinessError(ErrorCodes.RAG_MODEL_NOT_FOUND)
-        
+
         embedding = EmbeddingFactory.create_embeddings(
             model_name=str(embedding_entity.model_name),
             base_url=getattr(embedding_entity, "base_url", None),
             api_key=getattr(embedding_entity, "api_key", None),
         )
-        
+
         await asyncio.to_thread(
             update_chunk_by_id,
             collection_name=str(knowledge_base.name),
@@ -443,19 +442,19 @@ async def update_chunk(
             metadata=metadata,
             embedding_instance=embedding,
         )
-        
+
         logger.info(
             "成功更新分块: kb=%s chunk_id=%s",
             knowledge_base_id, chunk_id
         )
-    
+
     async def delete_chunk(
         self,
         knowledge_base_id: str,
         chunk_id: str,
     ) -> None:
         """删除指定分块
-        
+
         Args:
             knowledge_base_id: 知识库 ID
             chunk_id: 分块 ID
@@ -463,20 +462,26 @@ async def delete_chunk(
         knowledge_base = await self.kb_repo.get_by_id(knowledge_base_id)
         if not knowledge_base:
             raise BusinessError(ErrorCodes.RAG_KNOWLEDGE_BASE_NOT_FOUND)
-        
+
         if knowledge_base.type != RagType.DOCUMENT.value:
             raise BusinessError(
                 ErrorCodes.RAG_INVALID_REQUEST,
                 f"知识库类型 {knowledge_base.type} 不支持分块删除"
             )
-        
+
         import asyncio
-        await asyncio.to_thread(
+        rag_file_id = await asyncio.to_thread(
             delete_chunk_by_id,
             collection_name=str(knowledge_base.name),
             chunk_id=chunk_id,
         )
-        
+
+        if rag_file_id:
+            rag_file = await self.file_repo.get_by_id(rag_file_id)
+            if rag_file and rag_file.chunk_count and rag_file.chunk_count > 0:
+                rag_file.chunk_count = rag_file.chunk_count - 1
+                await self.db.commit()
+
         logger.info(
             "成功删除分块: kb=%s chunk_id=%s",
             knowledge_base_id, chunk_id

From dc7745129202ffc0c0561bf0ddaaf54eeb328a14 Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Tue, 17 Mar 2026 00:05:22 +0800
Subject: [PATCH 12/15] fix: implement batched chunk deletion by rag_file_id in
 store.py

---
 .../app/module/rag/infra/vectorstore/store.py | 80 ++++++++++++++-----
 1 file changed, 58 insertions(+), 22 deletions(-)

diff --git a/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py b/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py
index 88fb49c8..58ae56ba 100644
--- a/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py
+++ b/runtime/datamate-python/app/module/rag/infra/vectorstore/store.py
@@ -13,7 +13,6 @@
 """
 from __future__ import annotations
 
-import json
 import logging
 from typing import List, Optional
 
@@ -27,6 +26,47 @@
 
 logger = logging.getLogger(__name__)
 
+BATCH_DELETE_SIZE = 100
+
+
+def _delete_chunks_by_rag_file_id_batched(client, collection_name: str, rag_file_id: str) -> int:
+    """分批删除指定 rag_file_id 的所有 chunks
+
+    Args:
+        client: Milvus 客户端
+        collection_name: 集合名称
+        rag_file_id: RAG 文件 ID
+
+    Returns:
+        删除的总数量
+    """
+    filter_expr = f'metadata["rag_file_id"] == "{rag_file_id}"'
+    total_deleted = 0
+
+    while True:
+        try:
+            results = client.query(
+                collection_name=collection_name,
+                filter=filter_expr,
+                output_fields=["id"],
+                limit=BATCH_DELETE_SIZE,
+            )
+            if not results:
+                break
+
+            chunk_ids = [r["id"] for r in results]
+            id_filter = ' || '.join([f'id == "{cid}"' for cid in chunk_ids])
+            client.delete(collection_name=collection_name, filter=f"({id_filter})")
+            total_deleted += len(chunk_ids)
+
+            if len(chunk_ids) < BATCH_DELETE_SIZE:
+                break
+        except Exception as e:
+            logger.warning("分批删除失败: collection=%s rag_file_id=%s error=%s", collection_name, rag_file_id, e)
+            break
+
+    return total_deleted
+
 
 def drop_collection(collection_name: str) -> None:
     """删除 Milvus 集合
@@ -201,12 +241,8 @@ def delete_chunks_by_rag_file_ids(collection_name: str, rag_file_ids: List[str])
         client = get_milvus_client()
 
         for rid in rag_file_ids:
-            json_value = json.dumps({"rag_file_id": rid})
-            filter_expr = f'JSON_CONTAINS(metadata, \'{json_value}\')'
-            try:
-                client.delete(collection_name=collection_name, filter=filter_expr)
-            except Exception as del_err:
-                logger.warning("删除分块时部分失败: collection=%s rag_file_id=%s: %s", collection_name, rid, del_err)
+            deleted = _delete_chunks_by_rag_file_id_batched(client, collection_name, rid)
+            logger.info("删除文件分块: collection=%s rag_file_id=%s deleted=%d", collection_name, rid, deleted)
 
         logger.info("已按 rag_file_id 删除集合 %s 中的分块: %s", collection_name, rag_file_ids)
 
@@ -258,14 +294,14 @@ def update_chunk_by_id(
     """
     try:
         client = get_milvus_client()
-        
+
         filter_expr = f'id == "{chunk_id}"'
         existing = client.query(
             collection_name=collection_name,
             filter=filter_expr,
             output_fields=["metadata"],
         )
-        
+
         if not existing:
             raise BusinessError(
                 ErrorCodes.RAG_CHUNK_NOT_FOUND,
@@ -280,17 +316,17 @@ def update_chunk_by_id(
             # 确保保留原有的 rag_file_id 字段，防止用户修改时丢失
             if "rag_file_id" in existing_metadata and "rag_file_id" not in metadata:
                 metadata = {**metadata, "rag_file_id": existing_metadata["rag_file_id"]}
-        
+
         if embedding_instance:
             embedding = embedding_instance
         else:
             from app.module.rag.infra.embeddings import EmbeddingFactory
             embedding = EmbeddingFactory.create_embeddings()
-        
+
         vector = embedding.embed_query(text)
-        
+
         client.delete(collection_name=collection_name, filter=filter_expr)
-        
+
         client.insert(
             collection_name=collection_name,
             data=[{
@@ -300,9 +336,9 @@ def update_chunk_by_id(
                 "vector": vector,
             }]
         )
-        
+
         logger.info("成功更新分块: collection=%s chunk_id=%s", collection_name, chunk_id)
-        
+
     except BusinessError:
         raise
     except Exception as e:
@@ -322,27 +358,27 @@ def delete_chunk_by_id(collection_name: str, chunk_id: str) -> Optional[str]:
     """
     try:
         client = get_milvus_client()
-        
+
         filter_expr = f'id == "{chunk_id}"'
-        
+
         # 先查询 chunk 的 metadata 获取 rag_file_id
         existing = client.query(
             collection_name=collection_name,
             filter=filter_expr,
             output_fields=["metadata"],
         )
-        
+
         rag_file_id = None
         if existing:
             metadata = existing[0].get("metadata", {})
             rag_file_id = metadata.get("rag_file_id")
-        
+
         client.delete(collection_name=collection_name, filter=filter_expr)
-        
+
         logger.info("成功删除分块: collection=%s chunk_id=%s rag_file_id=%s", collection_name, chunk_id, rag_file_id)
-        
+
         return rag_file_id
-        
+
     except Exception as e:
         logger.error("删除分块失败: %s", e)
         raise BusinessError(ErrorCodes.RAG_MILVUS_ERROR, f"删除分块失败: {str(e)}") from e

From 99b7e5ef8be0b3a2f47fe67ef6ecea88154ec34c Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Tue, 17 Mar 2026 00:20:37 +0800
Subject: [PATCH 13/15] fix: add confirmation modal for file deletion in
 KnowledgeBase components

---
 frontend/src/i18n/locales/en/common.json          |  2 ++
 frontend/src/i18n/locales/zh/common.json          |  2 ++
 .../KnowledgeBase/Detail/KnowledgeBaseDetail.tsx  | 15 +++++++++++++--
 .../FileDetail/KnowledgeBaseFileDetail.tsx        |  2 ++
 4 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/frontend/src/i18n/locales/en/common.json b/frontend/src/i18n/locales/en/common.json
index 8189324c..3bb4724f 100644
--- a/frontend/src/i18n/locales/en/common.json
+++ b/frontend/src/i18n/locales/en/common.json
@@ -1646,6 +1646,8 @@
       "confirm": {
         "deleteTitle": "Confirm deletion of this knowledge base?",
         "deleteDescription": "It cannot be recovered after deletion. Please operate with caution.",
+        "deleteFileTitle": "Confirm deletion of this file?",
+        "deleteFileDescription": "Are you sure you want to delete \"{{name}}\"? This action cannot be undone.",
         "okText": "Delete",
         "cancelText": "Cancel"
       },
diff --git a/frontend/src/i18n/locales/zh/common.json b/frontend/src/i18n/locales/zh/common.json
index 55e5fe50..a8f592ff 100644
--- a/frontend/src/i18n/locales/zh/common.json
+++ b/frontend/src/i18n/locales/zh/common.json
@@ -1646,6 +1646,8 @@
       "confirm": {
         "deleteTitle": "确认删除该知识库吗？",
         "deleteDescription": "删除后将无法恢复，请谨慎操作。",
+        "deleteFileTitle": "确认删除该文件吗？",
+        "deleteFileDescription": "确定要删除文件「{{name}}」吗？删除后将无法恢复。",
         "okText": "删除",
         "cancelText": "取消"
       },
diff --git a/frontend/src/pages/KnowledgeBase/Detail/KnowledgeBaseDetail.tsx b/frontend/src/pages/KnowledgeBase/Detail/KnowledgeBaseDetail.tsx
index 9812b924..be537f47 100644
--- a/frontend/src/pages/KnowledgeBase/Detail/KnowledgeBaseDetail.tsx
+++ b/frontend/src/pages/KnowledgeBase/Detail/KnowledgeBaseDetail.tsx
@@ -1,6 +1,7 @@
 import type React from "react";
 import { useEffect, useState } from "react";
-import { Table, Badge, Button, Breadcrumb, Tooltip, App, Card, Input, Empty, Spin, Tag } from "antd";
+import { Table, Badge, Button, Breadcrumb, Tooltip, App, Card, Input, Empty, Spin, Tag, Modal } from "antd";
+import { ExclamationCircleOutlined } from "@ant-design/icons";
 import ReactMarkdown from "react-markdown";
 import remarkGfm from "remark-gfm";
 import { Prism as SyntaxHighlighter } from "react-syntax-highlighter";
@@ -264,7 +265,17 @@ const KnowledgeBaseDetailPage: React.FC = () => {
       label: t("knowledgeBase.detail.actions.deleteFile"),
       icon: <DeleteOutlined className="w-4 h-4" />,
       danger: true,
-      onClick: handleDeleteFile,
+      onClick: (file: KBFile) => {
+        Modal.confirm({
+          title: t("knowledgeBase.detail.confirm.deleteFileTitle"),
+          content: t("knowledgeBase.detail.confirm.deleteFileDescription", { name: file.name }),
+          okText: t("knowledgeBase.detail.confirm.okText"),
+          okType: "danger",
+          cancelText: t("knowledgeBase.detail.confirm.cancelText"),
+          centered: true,
+          onOk: () => handleDeleteFile(file),
+        });
+      },
     },
   ];
 
diff --git a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
index 61b9f2a8..5d646dcd 100644
--- a/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
+++ b/frontend/src/pages/KnowledgeBase/FileDetail/KnowledgeBaseFileDetail.tsx
@@ -1,6 +1,7 @@
 import React, { useEffect, useState, useCallback } from "react";
 import {Eye, Edit, Trash2, FileBox, ChevronLeft, ChevronRight, Code, CheckCircle, AlertCircle, Wand2} from "lucide-react";
 import { Card, Button, Badge, Input, Tabs, Modal, Breadcrumb, Tag, Spin, Empty, Alert, message, Tooltip } from "antd";
+import { ExclamationCircleOutlined } from "@ant-design/icons";
 import { queryKnowledgeBaseFileDetailUsingGet, updateKnowledgeBaseChunk, deleteKnowledgeBaseChunk } from "@/pages/KnowledgeBase/knowledge-base.api";
 import { Link, useParams } from "react-router";
 import DetailHeader from "@/components/DetailHeader";
@@ -402,6 +403,7 @@ const KnowledgeBaseFileDetail: React.FC = () => {
         okText={t("knowledgeBase.fileDetail.actions.confirm")}
         cancelText={t("knowledgeBase.fileDetail.actions.cancel")}
         okButtonProps={{ danger: true, loading: deleting }}
+        centered
       >
         <p>{t("knowledgeBase.fileDetail.modal.deleteConfirmMessage")}</p>
       </Modal>

From a8c5e5762be087c426a7cbd3ca5e79dd530f006c Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Tue, 17 Mar 2026 00:31:00 +0800
Subject: [PATCH 14/15] fix: replace Popconfirm with Modal for confirmation in
 DetailHeader actions

---
 .../src/components/DeleteConfirmModal.tsx     |  1 +
 frontend/src/components/DetailHeader.tsx      | 39 +++++++++++--------
 2 files changed, 24 insertions(+), 16 deletions(-)

diff --git a/frontend/src/components/DeleteConfirmModal.tsx b/frontend/src/components/DeleteConfirmModal.tsx
index 87f5438d..1a7a8779 100644
--- a/frontend/src/components/DeleteConfirmModal.tsx
+++ b/frontend/src/components/DeleteConfirmModal.tsx
@@ -57,6 +57,7 @@ export default function DeleteConfirmModal({
       okType="danger"
       okText={t("components.deleteConfirm.confirm")}
       cancelText={t("components.deleteConfirm.cancel")}
+      centered
     >
       <p>{defaultMessage}</p>
     </Modal>
diff --git a/frontend/src/components/DetailHeader.tsx b/frontend/src/components/DetailHeader.tsx
index fcf7480b..cbd33261 100644
--- a/frontend/src/components/DetailHeader.tsx
+++ b/frontend/src/components/DetailHeader.tsx
@@ -1,6 +1,6 @@
 import React, { useLayoutEffect, useEffect, useRef, useState, useCallback, useMemo } from "react";
 import { Database } from "lucide-react";
-import { Card, Button, Tag, Tooltip, Popconfirm, Popover } from "antd";
+import { Card, Button, Tag, Tooltip, Modal } from "antd";
 import type { ItemType } from "antd/es/menu/interface";
 import AddTagPopover from "./AddTagPopover";
 import ActionDropdown from "./ActionDropdown";
@@ -291,23 +291,30 @@ function DetailHeader<T>({
               );
             }
             if (op.confirm) {
+              const showConfirmModal = () => {
+                Modal.confirm({
+                  title: op.confirm?.title,
+                  content: op.confirm?.description,
+                  okText: op.confirm?.okText,
+                  okType: op.danger ? "danger" : "primary",
+                  cancelText: op.confirm?.cancelText,
+                  centered: true,
+                  onOk: () => {
+                    if (op.onClick) {
+                      op.onClick();
+                    } else {
+                      op?.confirm?.onConfirm?.();
+                    }
+                  },
+                });
+              };
               return (
                 <Tooltip key={op.key} title={op.label}>
-                  <Popconfirm
-                    key={op.key}
-                    {...op.confirm}
-                    onConfirm={() => {
-                      if (op.onClick) {
-                        op.onClick()
-                      } else {
-                        op?.confirm?.onConfirm?.();
-                      }
-                    }}
-                    okType={op.danger ? "danger" : "primary"}
-                    overlayStyle={{ zIndex: 9999 }}
-                  >
-                    <Button icon={op.icon} danger={op.danger} />
-                  </Popconfirm>
+                  <Button
+                    icon={op.icon}
+                    danger={op.danger}
+                    onClick={showConfirmModal}
+                  />
                 </Tooltip>
               );
             }

From 187e02506647d5dea3ea0f3d11f5839d0901a7d4 Mon Sep 17 00:00:00 2001
From: Dallas98 <990259227@qq.com>
Date: Tue, 17 Mar 2026 00:39:06 +0800
Subject: [PATCH 15/15] fix: enhance delete confirmation message in
 DatasetDetail with item name

---
 frontend/src/pages/DataManagement/Detail/DatasetDetail.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/src/pages/DataManagement/Detail/DatasetDetail.tsx b/frontend/src/pages/DataManagement/Detail/DatasetDetail.tsx
index 82c89951..6010c206 100644
--- a/frontend/src/pages/DataManagement/Detail/DatasetDetail.tsx
+++ b/frontend/src/pages/DataManagement/Detail/DatasetDetail.tsx
@@ -178,7 +178,7 @@ export default function DatasetDetail() {
       danger: true,
       confirm: {
         title: t("dataManagement.confirm.deleteDatasetTitle"),
-        description: t("dataManagement.confirm.deleteDatasetDesc"),
+        description: t("dataManagement.confirm.deleteDatasetDesc", { itemName: dataset.name }),
         okText: t("dataManagement.confirm.deleteConfirm"),
         cancelText: t("dataManagement.confirm.deleteCancel"),
         okType: "danger",