From 6b5e5bf417523be86bb4b076659b9db2f340c6b3 Mon Sep 17 00:00:00 2001
From: "xinxin.wu" <xinxin.wu@fit2cloud.com>
Date: Sat, 10 Oct 2026 16:29:53 +0800
Subject: [PATCH] feat: database tags management

---
 ui/src/api/API_README.md                      |  23 ++
 .../api/admin/workspace/knowledge/document.ts |  20 ++
 ui/src/api/admin/workspace/knowledge/tags.ts  |  35 ++-
 ui/src/api/types/knowledge.ts                 |  13 +-
 ui/src/views/VIEW_README.md                   |  43 ++-
 .../library/tags/TagDocumentDrawer.vue        | 214 +++++++++++++++
 .../tags/components/ButtonImportTags.vue      | 144 ++++++++++
 .../library/tags/components/TagFormDialog.vue | 172 ++++++++++++
 .../knowledge-detail/library/tags/index.vue   | 247 +++++++++++++++++-
 9 files changed, 898 insertions(+), 13 deletions(-)
 create mode 100644 ui/src/views/knowledge-detail/library/tags/TagDocumentDrawer.vue
 create mode 100644 ui/src/views/knowledge-detail/library/tags/components/ButtonImportTags.vue
 create mode 100644 ui/src/views/knowledge-detail/library/tags/components/TagFormDialog.vue

diff --git a/ui/src/api/API_README.md b/ui/src/api/API_README.md
index 5585dd2fcc3..9ff16552642 100644
--- a/ui/src/api/API_README.md
+++ b/ui/src/api/API_README.md
@@ -619,6 +619,29 @@ System 接口由资源管理服务提供；本地开源后端没有对应扩展
 文档页传 `resource_type: 'document'`，创建者选项复用 Workspace `common.ts` 的 `getAllUsers`。
 类型从 `@/api/types` 导入，命中处理枚举从 `@/api/enums` 导入。API 不接收 loading，不重复包装响应。
 
+### 知识库标签与文档关联
+
+`workspace/knowledge/tags.ts` 维护标签创建、编辑和删除，前缀为
+`/workspace/<workspaceId>/knowledge/<knowledgeId>/tags`，工作空间由 `getWorkspaceId()` 读取。
+标签查询暂保留在 `workspace/knowledge/knowledge.ts`，`getKnowledgeTags(knowledgeId)` 返回非分页 `KnowledgeTagGroup[]`；
+标签值中的可选 `doc_count` 表示关联文档数量。`postKnowledgeTags` 直接提交
+`KnowledgeTagPayload[]`（`key`、`value`），用于创建标签和新增标签值；
+`putKnowledgeTag` 向 `/<tagId>` 提交 `KnowledgeTagUpdatePayload`（`id`、`key`、`value`），仅用于已有的单项编辑。
+`deleteKnowledgeTag` 按路径末尾 `key` 删除整个标签、`one` 删除单个标签值；
+`putBatchDeleteKnowledgeTags` 使用 PUT `batch_delete`，请求体直接为标签 ID 数组，不包装为 `id_list`。
+标签类型统一维护在 `types/knowledge.ts`。多行编辑等待 V3 新协议，不组合旧接口模拟整组保存，
+也不声明推测的新接口；导入、模板下载尚未接入，三个待接请求入口的页面状态处理已预留。
+
+文档与标签的关联由 `workspace/knowledge/document.ts` 维护，不使用标签删除接口代替取消关联。
+`getDocumentTags` 查询 `document/<documentId>/tags`，返回分组标签；
+`postAddDocumentTags` POST 到 `document/batch_add_tag`，提交 `{ document_ids, tag_ids }`；
+`putDeleteDocumentTags` PUT 到 `document/<documentId>/tags/batch_delete`，直接提交标签 ID 数组。
+`putUnlinkTagDocuments` PUT 到知识库下的 `tag/<tagId>/docs_delete`，提交 `{ id_list: documentIds }`，
+用于取消同一标签与单个或多个文档的关联。
+关联文档列表复用 `getDocumentPage`，传 `resource_type: 'document'`、`tags: [tagId]`，
+未关联列表另传 `tag_exclude: true`；标签数组沿用请求层的 `tags[]` 序列化。
+名称使用 `name`；关联文档抽屉不传 `order_by`，按接口默认顺序展示。
+
 ### 工作空间共享资源查询
 
 `workspace/shared/` 按最终资源文件拆分：`model.ts` 提供 `getModelList`，`tool.ts` 提供
diff --git a/ui/src/api/admin/workspace/knowledge/document.ts b/ui/src/api/admin/workspace/knowledge/document.ts
index 3a637e49633..1dd6d473a15 100644
--- a/ui/src/api/admin/workspace/knowledge/document.ts
+++ b/ui/src/api/admin/workspace/knowledge/document.ts
@@ -16,6 +16,7 @@ import type {
   WebDocumentImportPayload,
   LarkDocumentList,
   LarkDocumentImportPayload,
+  KnowledgeTagGroup,
 } from '@/api/types'
 import { getWorkspaceId } from '@/utils/resource-context'
 
@@ -154,7 +155,26 @@ const postReplaceDocumentSource = (knowledgeId: string, documentId: string, file
   return post(`${getPrefix(knowledgeId)}/${documentId}/replace_source_file`, data)
 }
 
+/** 查询文档当前标签。 */
+const getDocumentTags = (knowledgeId: string, documentId: string) => get<KnowledgeTagGroup[]>(`${getPrefix(knowledgeId)}/${documentId}/tags`)
+
+/** 给指定文档批量添加已有标签。 */
+const postAddDocumentTags = (knowledgeId: string, documentIds: string[], tagIds: string[]) =>
+  post(`${getPrefix(knowledgeId)}/batch_add_tag`, { document_ids: documentIds, tag_ids: tagIds })
+
+/** 从单个文档移除指定标签，不删除标签本身。 */
+const putDeleteDocumentTags = (knowledgeId: string, documentId: string, tagIds: string[]) =>
+  put(`${getPrefix(knowledgeId)}/${documentId}/tags/batch_delete`, tagIds)
+
+/** 取消指定标签与单个或多个文档的关联。 */
+const putUnlinkTagDocuments = (knowledgeId: string, tagId: string, documentIds: string[]) =>
+  put(`/workspace/${getWorkspaceId()}/knowledge/${knowledgeId}/tag/${tagId}/docs_delete`, { id_list: documentIds })
+
 export default {
+  getDocumentTags,
+  postAddDocumentTags,
+  putDeleteDocumentTags,
+  putUnlinkTagDocuments,
   getDocumentPage,
   putBatchCreateDocuments,
   postSplitDocuments,
diff --git a/ui/src/api/admin/workspace/knowledge/tags.ts b/ui/src/api/admin/workspace/knowledge/tags.ts
index 3c159e0fa03..09f426878b4 100644
--- a/ui/src/api/admin/workspace/knowledge/tags.ts
+++ b/ui/src/api/admin/workspace/knowledge/tags.ts
@@ -1,10 +1,29 @@
-/** 查询文档当前标签。 */
-const getDocumentTags = (knowledgeId: string, documentId: string) => get<KnowledgeTagGroup[]>(`${getPrefix(knowledgeId)}/${documentId}/tags`)
+import { del, post, put } from '../../core/request'
+import type { KnowledgeTagPayload, KnowledgeTagUpdatePayload } from '@/api/types'
+import { getWorkspaceId } from '@/utils/resource-context'
 
-/** 批量添加文档标签。 */
-const postAddDocumentTags = (knowledgeId: string, documentIds: string[], tagIds: string[]) =>
-  post(`${getPrefix(knowledgeId)}/batch_add_tag`, { document_ids: documentIds, tag_ids: tagIds })
+const getPrefix = (knowledgeId: string) => `/workspace/${getWorkspaceId()}/knowledge/${knowledgeId}/tags`
 
-/** 移除文档标签关联。 */
-const putDeleteDocumentTags = (knowledgeId: string, documentId: string, tagIds: string[]) =>
-  put(`${getPrefix(knowledgeId)}/${documentId}/tags/batch_delete`, tagIds)
+// TODO：接入标签导入、模板下载、整组／多行编辑接口。
+// 请求路径、参数和响应类型以 V3 接口协议为准。
+
+/** 创建知识库标签或为已有标签新增值。 */
+const postKnowledgeTags = (knowledgeId: string, tags: KnowledgeTagPayload[]) => post<KnowledgeTagPayload[], void>(getPrefix(knowledgeId), tags)
+
+/** 编辑单个知识库标签，不支持多行编辑。 */
+const putKnowledgeTag = (knowledgeId: string, tagId: string, tag: KnowledgeTagUpdatePayload) =>
+  put<KnowledgeTagUpdatePayload, void>(`${getPrefix(knowledgeId)}/${tagId}`, tag)
+
+/** 删除整个标签分组或单个标签值。 */
+const deleteKnowledgeTag = (knowledgeId: string, tagId: string, type: 'key' | 'one') =>
+  del<undefined, void>(`${getPrefix(knowledgeId)}/${tagId}/${type}`)
+
+/** 批量删除所选标签，直接提交标签 ID 数组。 */
+const putBatchDeleteKnowledgeTags = (knowledgeId: string, tagIds: string[]) => put<string[], void>(`${getPrefix(knowledgeId)}/batch_delete`, tagIds)
+
+export default {
+  postKnowledgeTags,
+  putKnowledgeTag,
+  deleteKnowledgeTag,
+  putBatchDeleteKnowledgeTags,
+}
diff --git a/ui/src/api/types/knowledge.ts b/ui/src/api/types/knowledge.ts
index 8e589ee6aa8..0aa4c3c0840 100644
--- a/ui/src/api/types/knowledge.ts
+++ b/ui/src/api/types/knowledge.ts
@@ -55,7 +55,18 @@ export interface KnowledgeDetail extends KnowledgeItem {
 /** 按标签名称分组的知识库标签。 */
 export interface KnowledgeTagGroup {
   key: string
-  values: { id: string; value: string; create_time: string; update_time: string }[]
+  values: { id: string; value: string; doc_count?: number; create_time: string; update_time: string }[]
+}
+
+/** 创建知识库标签的名称和值。 */
+export interface KnowledgeTagPayload {
+  key: string
+  value: string
+}
+
+/** 编辑单个知识库标签，保留现有接口的 ID 字段。 */
+export interface KnowledgeTagUpdatePayload extends KnowledgeTagPayload {
+  id: string
 }
 
 /** 知识库工作流任务状态。 */
diff --git a/ui/src/views/VIEW_README.md b/ui/src/views/VIEW_README.md
index be6d22638f2..3d721637125 100644
--- a/ui/src/views/VIEW_README.md
+++ b/ui/src/views/VIEW_README.md
@@ -474,6 +474,7 @@ Dialog。新增或重命名文件时，应同步更新所有导入和页面功
 | `home/index.vue`                                                       | Workspace 首页                                                       |
 | `knowledge/index.vue`                                                  | 工作空间知识库目录与知识库卡片页面                                   |
 | `knowledge-detail/index.vue`                                           | 知识库详情页面                                                       |
+| `knowledge-detail/library/tags/index.vue`                             | 标签分组查询、创建、单值编辑、删除与关联文档管理                       |
 | `knowledge-detail/setting/base/index.vue`                             | 知识库基本信息、来源配置与上传限制设置                               |
 | `knowledge-detail/setting/document-strategy/index.vue`                | Web 知识库文档处理策略回填、校验与保存                                       |
 | `knowledge-detail/setting/scheduled-sync/index.vue`                   | Web、飞书与工作流知识库定时同步设置与日志                              |
@@ -717,9 +718,9 @@ Workspace API 内部通过 `getWorkspaceId()` 读取当前路由工作空间。
 `ResourceDetailLayout` 生成资料库、工作流、检索优化、授权与集成、设置目录，返回列表时恢复所属文件夹。
 资料库包含文档、图片、标签管理；检索优化包含召回测试、问题、自定义分词；授权与集成包含
 对话用户、外部检索服务。资料库页面统一放在 `knowledge-detail/library/` 下，包含 `document/`、
-`image/`、`tag/`；文档专属组件及 Action 随 `document/` 集中维护。其他页面继续放在
+`image/`、`tags/`；文档专属组件及 Action 随 `document/` 集中维护。其他页面继续放在
 `knowledge-detail/` 下的 `recall-test/`、`question/`、`dictionary/`、`chat-user/`、`external-retrieval/`。
-图片、标签管理及这五个页面暂只展示占位内容。
+图片及这五个页面暂只展示占位内容。
 容器通过 `knowledge-detail/context.ts` 提供只读详情与替换能力；设置页复用已加载详情，保存成功后
 更新容器数据，同步名称等展示。基本信息复用创建流程的 `KnowledgeBaseForm`，类型配置和校验留在
 `setting/base/index.vue` 中，通用知识库标题为“设置”，其他类型为“基础设置”。
@@ -843,6 +844,44 @@ Action 仍通过上层 `action-dropdown/index.ts` 导出，弹窗仅在目录内
 
 文档详情路由暂未启用，System 知识库详情路由暂未注册。
 
+### 资料库标签管理
+
+`knowledge-detail/library/tags/index.vue` 复用详情布局的 `customHeader` 与 Teleport，
+维护搜索、导入入口、创建入口和标签表格，不嵌套页面布局或修改路由。
+通过 `workspace/knowledge/knowledge.ts` 查询全量分组，前端按标签名或值搜索并保留完整命中分组；
+先按标签组分页，再展开各组标签值，分页总数为标签组数。
+`MkTable` 合并选择列和标签名，选择行为与工作空间成员表格一致，不额外联动同组记录；
+批量底栏按实际选中记录数统计，删除确认明确影响所选记录所属标签及其全部值。
+标签名旁提供新增值、编辑标签、删除标签；行末提供编辑值和删除值，
+数量链接打开同目录 `TagDocumentDrawer.vue`。
+
+`library/tags/components/TagFormDialog.vue` 为标签管理和后续文档入口共用的创建、编辑弹窗，
+接收知识库 ID 与完整 Tags API，参考添加成员流程复用 `MkDialog`、`el-form` 和 `MkFormList`。
+创建允许多行标签名与值；新增值锁定标签名；编辑值回填单项并锁定标签名。
+标签名最多 64 字、标签值最多 128 字，校验必填、纯空白和表单内重复组合。
+创建与单个已有标签值编辑使用已确认接口；整组编辑或编辑中增删行走独立请求入口，
+保留编辑前快照、已有 ID 与清理首尾空格后的当前草稿，交由请求入口按 V3 协议映射参数。
+所有分支共用校验、loading、成功关闭和刷新；多行接口未接入时仅提示并保留草稿，
+不即时删除、不拼接多次旧请求、不模拟成功。
+常驻弹窗在 `closed` 清理草稿和校验。
+
+`library/tags/components/ButtonImportTags.vue` 在同一组件内维护导入按钮与弹窗，
+复用 `MkDialog`、`el-form` 和 `MkDragUpload`，不再单独拆分导入 Dialog。
+支持单个 XLS、XLSX 文件的选择、拖拽、更换、删除及必填校验，关闭后清理文件和校验状态。
+接收知识库 ID 与完整 Tags API，页面监听 `refresh` 重新查询标签列表；已预接提交 loading、重复提交保护、
+成功提示和关闭弹窗，失败保留文件。模板下载有独立 loading 和重复点击保护，下载期间禁止提交与关闭，
+结束后恢复状态，不关闭弹窗或刷新列表。导入、模板下载接口尚未确认，真实请求保留 TODO；
+请求占位返回 `undefined` 时仅提示尚未接入，不发送请求、不模拟成功或刷新列表。
+
+`TagDocumentDrawer.vue` 接收知识库 ID 与完整 Document API，通过 `open(tag)` 固定当前标签，
+以“已关联文档／未关联文档”两页签共用表格，提供搜索、启用状态筛选、分页、单个与批量关联／取消关联；创建时间仅展示，不提供排序入口。
+启用状态复用 `MkTableFilter mode="single"`，支持全部、已启用、已禁用；查询传布尔 `is_active`，全部时省略。
+名称或状态筛选后回到第一页并清空选择，切换页签时重置筛选条件。
+文档图标和时间格式沿用文档列表，状态使用 `MkStatusLabel`；批量操作放在顶部，不再显示页面批量底栏。
+搜索、分页和页签切换清空选择，关联变更后重新查询并通知标签页刷新数量，末页为空时回退。
+抽屉在 `closed` 重置标签、筛选、分页和选择，不新增权限判断或共享范围接口。
+文档页原有标签查询继续使用 Knowledge API，共享标签查询保持原接口，不启用尚未接入的文档标签入口。
+
 `KnowledgeWorkflowView` 复用 `ButtonDefaultModelSetting`，从知识库详情读取默认模型配置，
 随工作流保存提交并将配置传入画布；支持应用到所有节点，保存失败回滚至已保存配置。
 
diff --git a/ui/src/views/knowledge-detail/library/tags/TagDocumentDrawer.vue b/ui/src/views/knowledge-detail/library/tags/TagDocumentDrawer.vue
new file mode 100644
index 00000000000..e91262e3d60
--- /dev/null
+++ b/ui/src/views/knowledge-detail/library/tags/TagDocumentDrawer.vue
@@ -0,0 +1,214 @@
+<script setup lang="ts">
+import { computed, ref } from 'vue'
+import { cloneDeep } from 'lodash'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
+import type { Dict, DocumentItem, KnowledgeTagUpdatePayload } from '@/api/types'
+import { getFileIconUrl } from '@/utils/icon'
+import { datetimeFormat } from '@/utils/time'
+import { MsgSuccess } from '@/utils/message'
+
+defineOptions({ name: 'TagDocumentDrawer' })
+
+const props = defineProps<{ knowledgeId: string; api: typeof DocumentApi }>()
+const emit = defineEmits<{ refresh: [] }>()
+
+const visible = ref(false)
+const loading = ref(false)
+const currentTag = ref<KnowledgeTagUpdatePayload>()
+const title = computed(() => (currentTag.value ? `${currentTag.value.key}—${currentTag.value.value}` : '关联文档'))
+const activeTab = ref<'linked' | 'unlinked'>('linked')
+const searchName = ref('')
+const documentActiveOptions = [
+  { label: '已启用', value: true },
+  { label: '已禁用', value: false },
+]
+const selectedDocumentActive = ref<boolean | null>(null)
+const documentData = ref<DocumentItem[]>([])
+const paginationConfig = ref({ currentPage: 1, pageSize: 10, total: 0 })
+const documentTableRef = ref<{ clearSelection: () => void }>()
+const selectedDocuments = ref<DocumentItem[]>([])
+const selectedDocumentIds = computed(() => new Set(selectedDocuments.value.map(({ id }) => id)))
+
+/* 两个页签复用同一文档查询，未关联页通过 tag_exclude 排除当前标签。 */
+function loadDocuments(): Promise<void> {
+  if (!currentTag.value) return Promise.resolve()
+  clearSelection()
+  loading.value = true
+  const query: Dict<unknown> = {
+    resource_type: 'document',
+    tags: [currentTag.value.id],
+    is_active: selectedDocumentActive.value ?? undefined,
+    ...(activeTab.value === 'unlinked' ? { tag_exclude: true } : {}),
+    ...(searchName.value.trim() ? { name: searchName.value.trim() } : {}),
+  }
+  return props.api
+    .getDocumentPage(props.knowledgeId, paginationConfig.value, query)
+    .then((page) => {
+      const lastPage = Math.max(1, Math.ceil(page.total / paginationConfig.value.pageSize))
+      if (paginationConfig.value.currentPage > lastPage) {
+        paginationConfig.value.currentPage = lastPage
+        return loadDocuments()
+      }
+      documentData.value = page.records
+      paginationConfig.value.total = page.total
+    })
+    .catch((error) => {
+      // 查询失败后不保留上一页签的数据，避免按新的关联方向操作旧记录。
+      documentData.value = []
+      paginationConfig.value.total = 0
+      throw error
+    })
+    .finally(() => {
+      loading.value = false
+    })
+}
+
+function open(tag: KnowledgeTagUpdatePayload) {
+  currentTag.value = cloneDeep(tag)
+  visible.value = true
+  return loadDocuments()
+}
+
+function clearSelection() {
+  documentTableRef.value?.clearSelection()
+  selectedDocuments.value = []
+}
+
+function handleSelectionChange(selection: unknown[]) {
+  selectedDocuments.value = selection as DocumentItem[]
+}
+
+function getRowClass({ row }: { row: DocumentItem }) {
+  return selectedDocumentIds.value.has(row.id) ? '[&>td]:bg-primary/10!' : ''
+}
+
+function handleDocumentFilterChange() {
+  if (loading.value) return
+  paginationConfig.value.currentPage = 1
+  return loadDocuments()
+}
+
+function handleComplexSearchChange(query?: Dict<unknown>) {
+  searchName.value = typeof query?.name === 'string' ? query.name : ''
+  return handleDocumentFilterChange()
+}
+
+function handleTabChange() {
+  searchName.value = ''
+  selectedDocumentActive.value = null
+  paginationConfig.value.currentPage = 1
+  return loadDocuments()
+}
+
+/* 单个和批量操作共用现有文档标签关联协议。 */
+function handleLinkDocuments(documentIds: string[]) {
+  if (loading.value || !currentTag.value || !documentIds.length) return
+  const unlink = activeTab.value === 'linked'
+  loading.value = true
+  const request = unlink
+    ? props.api.putUnlinkTagDocuments(props.knowledgeId, currentTag.value.id, documentIds)
+    : props.api.postAddDocumentTags(props.knowledgeId, documentIds, [currentTag.value.id])
+  return request
+    .then(() => {
+      MsgSuccess(unlink ? '取消关联成功' : '关联成功')
+      emit('refresh')
+      return loadDocuments()
+    })
+    .finally(() => {
+      loading.value = false
+    })
+}
+
+function handleBatchLinkDocuments() {
+  return handleLinkDocuments(selectedDocuments.value.map(({ id }) => id))
+}
+
+function handleBeforeClose(done: () => void) {
+  if (!loading.value) done()
+}
+
+function resetData() {
+  currentTag.value = undefined
+  activeTab.value = 'linked'
+  searchName.value = ''
+  selectedDocumentActive.value = null
+  documentData.value = []
+  paginationConfig.value = { currentPage: 1, pageSize: 10, total: 0 }
+  clearSelection()
+  loading.value = false
+}
+
+defineExpose({ open })
+</script>
+
+<template>
+  <MkDrawer v-model="visible" :title="title" :before-close="handleBeforeClose" size="840" @closed="resetData">
+    <div class="flex-column gap-4" :inert="loading">
+      <el-tabs v-model="activeTab" :before-leave="() => !loading" @tab-change="handleTabChange">
+        <el-tab-pane label="已关联文档" name="linked" />
+        <el-tab-pane label="未关联文档" name="unlinked" />
+      </el-tabs>
+      <div class="flex-between gap-3">
+        <!-- 批量关联或取消关联文档 -->
+        <el-button plain :disabled="!selectedDocuments.length || loading" @click="handleBatchLinkDocuments">
+          <MkIcon :name="activeTab === 'linked' ? 'icon_unlink_outlined' : 'icon_link-record_outlined'" />
+          <span>{{ activeTab === 'linked' ? '取消关联' : '关联' }}</span>
+        </el-button>
+        <MkSearchInput v-if="activeTab === 'linked'" v-model="searchName" class="w-60!" @change="handleDocumentFilterChange" />
+        <MkComplexSearch v-else :fields="[{ label: '名称', value: 'name' }]" @change="handleComplexSearchChange" />
+      </div>
+      <!-- 仅遮罩表格，指示器固定在表体靠上位置，避免随记录数量上下跳动。 -->
+      <div v-loading="loading" element-loading-custom-class="[&>.el-loading-spinner]:top-20!" class="relative">
+        <MkTable
+          ref="documentTableRef"
+          v-model:pagination-config="paginationConfig"
+          :data="documentData"
+          :row-class-name="getRowClass"
+          row-key="id"
+          @current-change="loadDocuments"
+          @size-change="loadDocuments"
+          @selection-change="handleSelectionChange"
+        >
+          <el-table-column type="selection" width="40" />
+          <el-table-column prop="name" label="文档名称" min-width="200">
+            <template #default="{ row }: { row: DocumentItem }">
+              <div class="flex-align-center gap-2">
+                <img :src="getFileIconUrl(row.name)" alt="" class="size-5 shrink-0" />
+                <span class="truncate" :title="row.name">{{ row.name }}</span>
+              </div>
+            </template>
+          </el-table-column>
+          <el-table-column prop="is_active" label="启用状态" width="120">
+            <template #header>
+              <MkTableFilter
+                v-model="selectedDocumentActive"
+                mode="single"
+                label="启用状态"
+                :options="documentActiveOptions"
+                @change="handleDocumentFilterChange"
+              />
+            </template>
+            <template #default="{ row }: { row: DocumentItem }">
+              <MkStatusLabel :active="row.is_active" />
+            </template>
+          </el-table-column>
+          <el-table-column prop="create_time" label="创建时间" width="180">
+            <template #default="{ row }: { row: DocumentItem }">{{ datetimeFormat(row.create_time) }}</template>
+          </el-table-column>
+          <el-table-column label="操作" width="70" fixed="right">
+            <template #default="{ row }: { row: DocumentItem }">
+              <!-- 关联或取消关联当前文档 -->
+              <MkAction
+                display="button"
+                :label="activeTab === 'linked' ? '取消关联' : '关联'"
+                :icon="activeTab === 'linked' ? 'icon_unlink_outlined' : 'icon_link-record_outlined'"
+                :disabled="loading"
+                @click="handleLinkDocuments([row.id])"
+              />
+            </template>
+          </el-table-column>
+        </MkTable>
+      </div>
+    </div>
+  </MkDrawer>
+</template>
diff --git a/ui/src/views/knowledge-detail/library/tags/components/ButtonImportTags.vue b/ui/src/views/knowledge-detail/library/tags/components/ButtonImportTags.vue
new file mode 100644
index 00000000000..97436f59c07
--- /dev/null
+++ b/ui/src/views/knowledge-detail/library/tags/components/ButtonImportTags.vue
@@ -0,0 +1,144 @@
+<script setup lang="ts">
+import { nextTick, reactive, ref } from 'vue'
+import type { FormInstance, FormRules, UploadFile, UploadUserFile } from 'element-plus'
+import type TagsApi from '@/api/admin/workspace/knowledge/tags'
+import MkDragUpload from '@/components/mk-drag-upload/index.vue'
+import { MsgSuccess, MsgWarning } from '@/utils/message'
+
+defineOptions({ name: 'ButtonImportTags' })
+
+const props = defineProps<{ knowledgeId: string; api: typeof TagsApi; disabled?: boolean }>()
+const emit = defineEmits<{ refresh: [] }>()
+
+interface ImportTagsForm {
+  files: UploadUserFile[]
+}
+
+const visible = ref(false)
+const loading = ref(false)
+const downloadLoading = ref(false)
+const importFormRef = ref<FormInstance>()
+const dragUploadRef = ref<InstanceType<typeof MkDragUpload>>()
+const importForm = reactive<ImportTagsForm>({ files: [] })
+const rules: FormRules<ImportTagsForm> = {
+  files: [{ required: true, type: 'array', min: 1, message: '请上传文件', trigger: 'change' }],
+}
+
+/* 导入入口与关闭清理。 */
+function handleOpenDialog() {
+  if (props.disabled) return
+  visible.value = true
+}
+
+function resetData() {
+  importForm.files = []
+  loading.value = false
+  downloadLoading.value = false
+  dragUploadRef.value?.clearFiles()
+  importFormRef.value?.clearValidate()
+}
+
+/* 文件只在本地暂存，替换时保留最新选择的一个文件。 */
+function handleFileChange(file: UploadFile) {
+  if (!/\.xlsx?$/i.test(file.name)) {
+    importForm.files = []
+    dragUploadRef.value?.clearFiles()
+    MsgWarning('仅支持上传 XLS、XLSX 格式的文件')
+    return
+  }
+
+  importForm.files = [file]
+  nextTick(() => importFormRef.value?.validateField('files'))
+}
+
+function handleFileRemove() {
+  importForm.files = []
+  nextTick(() => importFormRef.value?.validateField('files'))
+}
+
+function requestDownloadTemplate(): Promise<unknown> | undefined {
+  // TODO：接入 props.api 的标签模板下载请求，复用请求层文件下载能力并返回 Promise。
+  return undefined
+}
+
+function handleDownloadTemplate() {
+  if (loading.value || downloadLoading.value) return
+  const request = requestDownloadTemplate()
+  if (!request) {
+    MsgWarning('标签模板下载接口尚未接入')
+    return
+  }
+
+  downloadLoading.value = true
+  return request.finally(() => {
+    downloadLoading.value = false
+  })
+}
+
+function requestImportTags(): Promise<unknown> | undefined {
+  // TODO：接入 props.api 的标签导入请求，传入 props.knowledgeId、importForm.files[0].raw 并返回 Promise。
+  // 成功关闭和刷新已处理，失败应 reject。
+  return undefined
+}
+
+function handleImport() {
+  if (loading.value || downloadLoading.value) return
+  importFormRef.value?.validate((valid) => {
+    if (!valid || loading.value || downloadLoading.value) return
+    const request = requestImportTags()
+    if (!request) {
+      MsgWarning('标签导入接口尚未接入，当前文件尚未上传')
+      return
+    }
+
+    loading.value = true
+    return request
+      .then(() => {
+        MsgSuccess('导入成功')
+        visible.value = false
+        emit('refresh')
+      })
+      .finally(() => {
+        loading.value = false
+      })
+  })
+}
+</script>
+
+<template>
+  <!-- 打开标签导入弹窗 -->
+  <el-button plain :disabled="disabled" @click="handleOpenDialog">
+    <MkIcon name="icon_import_outlined" />
+    <span>导入</span>
+  </el-button>
+  <MkDialog v-model="visible" title="导入标签" :show-close="!loading && !downloadLoading" @closed="resetData">
+    <el-form ref="importFormRef" v-loading="loading" :model="importForm" :rules="rules" label-position="top" @submit.prevent>
+      <el-form-item prop="files" :required="false">
+        <template #label>
+          <div class="flex-between w-full">
+            <span>
+              上传文件
+              <span class="ml-1 text-danger">*</span>
+            </span>
+            <!-- 下载标签导入模板 -->
+            <el-button link type="primary" :loading="downloadLoading" :disabled="loading" @click="handleDownloadTemplate">下载模板</el-button>
+          </div>
+        </template>
+        <MkDragUpload
+          ref="dragUploadRef"
+          v-model="importForm.files"
+          accept=".xls,.xlsx"
+          tip-text="支持格式：XLS、XLSX"
+          @change="handleFileChange"
+          @remove="handleFileRemove"
+        />
+      </el-form-item>
+    </el-form>
+    <template #footer>
+      <!-- 取消标签导入 -->
+      <el-button plain :disabled="loading || downloadLoading" @click="visible = false">取消</el-button>
+      <!-- 导入标签，接口待接入 -->
+      <el-button type="primary" :loading="loading" :disabled="!importForm.files.length || downloadLoading" @click="handleImport">导入</el-button>
+    </template>
+  </MkDialog>
+</template>
diff --git a/ui/src/views/knowledge-detail/library/tags/components/TagFormDialog.vue b/ui/src/views/knowledge-detail/library/tags/components/TagFormDialog.vue
new file mode 100644
index 00000000000..ba5df0cbeb0
--- /dev/null
+++ b/ui/src/views/knowledge-detail/library/tags/components/TagFormDialog.vue
@@ -0,0 +1,172 @@
+<script setup lang="ts">
+import { computed, reactive, ref } from 'vue'
+import { cloneDeep } from 'lodash'
+import type { FormInstance, FormItemRule } from 'element-plus'
+import type TagsApi from '@/api/admin/workspace/knowledge/tags'
+import type { KnowledgeTagGroup, KnowledgeTagPayload, KnowledgeTagUpdatePayload } from '@/api/types'
+import { MsgSuccess, MsgWarning } from '@/utils/message'
+
+defineOptions({ name: 'TagFormDialog' })
+
+const props = defineProps<{ knowledgeId: string; api: typeof TagsApi }>()
+const emit = defineEmits<{ refresh: [] }>()
+
+type TagFormOptions =
+  | { mode: 'create' }
+  | { mode: 'add-value'; key: string }
+  | { mode: 'edit-group'; group: KnowledgeTagGroup }
+  | { mode: 'edit-value'; tag: KnowledgeTagUpdatePayload }
+
+const visible = ref(false)
+const loading = ref(false)
+const formRef = ref<FormInstance>()
+const mode = ref<TagFormOptions['mode']>('create')
+const fixedTagKey = ref('')
+const editTagId = ref('')
+const originalTags = ref<KnowledgeTagUpdatePayload[]>([])
+const tagForm = reactive<{ tags: (KnowledgeTagPayload & { id?: string })[] }>({ tags: [] })
+const normalizedTags = computed(() => tagForm.tags.map((tag) => ({ ...tag, key: tag.key.trim(), value: tag.value.trim() })))
+const isEditing = computed(() => mode.value === 'edit-group' || mode.value === 'edit-value')
+const title = computed(() => (mode.value === 'edit-group' ? '编辑标签' : mode.value === 'edit-value' ? '编辑标签值' : '创建标签'))
+const defaultTag = computed(() => ({ key: mode.value === 'edit-group' ? (tagForm.tags[0]?.key ?? '') : fixedTagKey.value, value: '' }))
+
+// 整组编辑或编辑中增删行时，不能使用单值编辑接口。
+const requiresMultiEdit = computed(
+  () => mode.value === 'edit-group' || (mode.value === 'edit-value' && (tagForm.tags.length !== 1 || tagForm.tags[0]?.id !== editTagId.value)),
+)
+
+/* 回填表单：供标签管理和文档入口共同调用。 */
+function open(options: TagFormOptions = { mode: 'create' }) {
+  mode.value = options.mode
+  if (options.mode === 'create') {
+    tagForm.tags = [{ key: '', value: '' }]
+  } else if (options.mode === 'add-value') {
+    fixedTagKey.value = options.key
+    tagForm.tags = [{ key: options.key, value: '' }]
+  } else if (options.mode === 'edit-group') {
+    originalTags.value = options.group.values.map(({ id, value }) => ({ id, key: options.group.key, value }))
+    tagForm.tags = cloneDeep(originalTags.value)
+  } else {
+    fixedTagKey.value = options.tag.key
+    editTagId.value = options.tag.id
+    originalTags.value = [cloneDeep(options.tag)]
+    tagForm.tags = cloneDeep(originalTags.value)
+  }
+  visible.value = true
+}
+
+function handleTagKeyChange(key: string) {
+  if (mode.value === 'edit-group') {
+    tagForm.tags.forEach((tag) => (tag.key = key))
+  }
+}
+
+function getTagValueRules(index: number): FormItemRule[] {
+  return [
+    { required: true, whitespace: true, message: '请输入标签值', trigger: 'blur' },
+    {
+      validator: (_rule, _value, callback) => {
+        const tag = tagForm.tags[index]
+        const duplicate =
+          tag &&
+          tagForm.tags.some(
+            (other, otherIndex) => otherIndex !== index && other.key.trim() === tag.key.trim() && other.value.trim() === tag.value.trim(),
+          )
+        callback(duplicate ? new Error('相同标签下的标签值不能重复') : undefined)
+      },
+      trigger: 'blur',
+    },
+  ]
+}
+
+function handleRowsChange() {
+  formRef.value?.clearValidate()
+}
+
+function requestMultiEditTags(): Promise<unknown> | undefined {
+  // TODO：接入 V3 整组／多行编辑请求，按协议映射 props.knowledgeId、originalTags.value（原数据）、normalizedTags.value（新数据）。
+  // 返回真实请求 Promise；成功关闭和刷新已处理，失败应 reject。
+  return undefined
+}
+
+/* 各创建、编辑分支共用提交状态和成功处理。 */
+function handleSubmit() {
+  if (loading.value) return
+  formRef.value?.validate((valid) => {
+    if (!valid || loading.value) return
+    const tags = normalizedTags.value
+    const tag = tags[0]
+    if (!tag) return
+
+    let request: Promise<unknown> | undefined
+    if (requiresMultiEdit.value) {
+      request = requestMultiEditTags()
+    } else if (isEditing.value) {
+      request = props.api.putKnowledgeTag(props.knowledgeId, editTagId.value, { ...tag, id: editTagId.value })
+    } else {
+      request = props.api.postKnowledgeTags(props.knowledgeId, tags)
+    }
+    if (!request) {
+      MsgWarning('整组／多行编辑接口尚未接入，当前修改尚未保存')
+      return
+    }
+
+    loading.value = true
+    return request
+      .then(() => {
+        MsgSuccess(isEditing.value ? '保存成功' : '创建成功')
+        visible.value = false
+        emit('refresh')
+      })
+      .finally(() => {
+        loading.value = false
+      })
+  })
+}
+
+function resetData() {
+  tagForm.tags = []
+  mode.value = 'create'
+  fixedTagKey.value = ''
+  editTagId.value = ''
+  originalTags.value = []
+  loading.value = false
+  formRef.value?.clearValidate()
+}
+
+defineExpose({ open })
+</script>
+
+<template>
+  <MkDialog v-model="visible" :title="title" :show-close="!loading" @closed="resetData">
+    <el-form ref="formRef" v-loading="loading" :model="tagForm" label-position="top" @submit.prevent>
+      <MkFormList v-model="tagForm.tags" :default-item="defaultTag" @update:model-value="handleRowsChange">
+        <template #default="{ index, item: tag }">
+          <el-form-item
+            class="min-w-0 flex-1"
+            :label="index === 0 ? '标签' : ''"
+            :prop="`tags.${index}.key`"
+            :rules="{ required: true, whitespace: true, message: '请输入标签', trigger: 'blur' }"
+          >
+            <el-input
+              v-model="tag.key"
+              :disabled="mode === 'add-value' || mode === 'edit-value'"
+              :maxlength="64"
+              placeholder="请输入标签"
+              @input="handleTagKeyChange"
+            />
+          </el-form-item>
+          <el-form-item class="min-w-0 flex-1" :label="index === 0 ? '标签值' : ''" :prop="`tags.${index}.value`" :rules="getTagValueRules(index)">
+            <el-input v-model="tag.value" :maxlength="128" placeholder="请输入标签值" />
+          </el-form-item>
+        </template>
+      </MkFormList>
+    </el-form>
+    <template #footer>
+      <!-- 取消标签编辑 -->
+      <el-button plain :disabled="loading" @click="visible = false">取消</el-button>
+      <!-- 创建或保存标签 -->
+      <el-button type="primary" :loading="loading" @click="handleSubmit">{{ isEditing ? '保存' : '创建' }}</el-button>
+    </template>
+  </MkDialog>
+</template>
diff --git a/ui/src/views/knowledge-detail/library/tags/index.vue b/ui/src/views/knowledge-detail/library/tags/index.vue
index 1ae01041829..17c6503fb76 100644
--- a/ui/src/views/knowledge-detail/library/tags/index.vue
+++ b/ui/src/views/knowledge-detail/library/tags/index.vue
@@ -1,10 +1,253 @@
 <script setup lang="ts">
+import { computed, onMounted, ref } from 'vue'
+import { useRoute } from 'vue-router'
+import type { TableColumnCtx } from 'element-plus'
 import type { ResourceDetailPageProps } from '@/layout/ResourceDetailLayout.vue'
-defineOptions({ name: 'TagManagementView' })
+import TagsApi from '@/api/admin/workspace/knowledge/tags'
+import KnowledgeApi from '@/api/admin/workspace/knowledge/knowledge'
+import DocumentApi from '@/api/admin/workspace/knowledge/document'
+import type { KnowledgeTagGroup, KnowledgeTagUpdatePayload } from '@/api/types'
+import { MsgConfirm, MsgSuccess } from '@/utils/message'
+import TagFormDialog from './components/TagFormDialog.vue'
+import ButtonImportTags from './components/ButtonImportTags.vue'
+import TagDocumentDrawer from './TagDocumentDrawer.vue'
 
+defineOptions({ name: 'TagManagementView' })
 defineProps<ResourceDetailPageProps>()
+defineExpose({ customHeader: true })
+
+interface TagTableRow extends KnowledgeTagUpdatePayload {
+  doc_count?: number
+  rowspan: number
+}
+
+const route = useRoute()
+const knowledgeId = computed(() => String(route.params.knowledgeId ?? ''))
+const loading = ref(false)
+const operationLoading = ref(false)
+const tagGroups = ref<KnowledgeTagGroup[]>([])
+const searchText = ref('')
+const tagPage = ref({ currentPage: 1, pageSize: 10 })
+const tagTableRef = ref<{ clearSelection: () => void }>()
+const selectedTags = ref<TagTableRow[]>([])
+const hoveredTagKey = ref<string | null>(null)
+const selectedTagIds = computed(() => new Set(selectedTags.value.map(({ id }) => id)))
+
+/* 保留完整分组进行搜索和分页，避免同一标签跨页拆开。 */
+const filteredTagGroups = computed(() => {
+  const keyword = searchText.value.trim().toLocaleLowerCase()
+  return tagGroups.value.filter(
+    (group) =>
+      !keyword || group.key.toLocaleLowerCase().includes(keyword) || group.values.some(({ value }) => value.toLocaleLowerCase().includes(keyword)),
+  )
+})
+const paginationConfig = computed({
+  get: () => ({ ...tagPage.value, total: filteredTagGroups.value.length }),
+  set: ({ currentPage, pageSize }) => {
+    tagPage.value = { currentPage, pageSize }
+  },
+})
+const tagRows = computed<TagTableRow[]>(() => {
+  const start = (tagPage.value.currentPage - 1) * tagPage.value.pageSize
+  return filteredTagGroups.value
+    .slice(start, start + tagPage.value.pageSize)
+    .flatMap((group) => group.values.map((tag, index) => ({ ...tag, key: group.key, rowspan: index === 0 ? group.values.length : 0 })))
+})
+
+function clearSelection() {
+  tagTableRef.value?.clearSelection()
+  selectedTags.value = []
+  hoveredTagKey.value = null
+}
+
+function loadTags() {
+  clearSelection()
+  loading.value = true
+  return KnowledgeApi.getKnowledgeTags(knowledgeId.value)
+    .then((groups) => {
+      tagGroups.value = groups
+      const lastPage = Math.max(1, Math.ceil(filteredTagGroups.value.length / tagPage.value.pageSize))
+      tagPage.value.currentPage = Math.min(tagPage.value.currentPage, lastPage)
+    })
+    .finally(() => {
+      loading.value = false
+    })
+}
+
+function handleSearchChange() {
+  tagPage.value.currentPage = 1
+  clearSelection()
+}
+
+function handleSelectionChange(selection: unknown[]) {
+  selectedTags.value = selection as TagTableRow[]
+}
+
+// 与工作空间成员表格一致：仅合并单元格，不另外联动同组勾选。
+function spanMethod({ column, row }: { column: TableColumnCtx<TagTableRow>; row: TagTableRow }) {
+  if (column.type === 'selection' || column.property === 'key') return row.rowspan ? [row.rowspan, 1] : [0, 0]
+}
+
+function getCellClass({ row }: { row: TagTableRow }) {
+  if (selectedTagIds.value.has(row.id)) return 'bg-primary/10!'
+  return hoveredTagKey.value === row.key ? 'bg-N100!' : ''
+}
+
+function handleCellEnter(row: TagTableRow) {
+  hoveredTagKey.value = row.key
+}
+
+function handleCellLeave() {
+  hoveredTagKey.value = null
+}
+
+/* 共用创建、编辑弹窗和关联文档抽屉。 */
+const tagFormRef = ref<InstanceType<typeof TagFormDialog>>()
+const tagDocumentRef = ref<InstanceType<typeof TagDocumentDrawer>>()
+
+function handleOpenCreateTag() {
+  tagFormRef.value?.open()
+}
+
+function handleOpenAddTagValue(row: TagTableRow) {
+  tagFormRef.value?.open({ mode: 'add-value', key: row.key })
+}
+
+function handleOpenEditTag(row: TagTableRow) {
+  const group = tagGroups.value.find(({ key }) => key === row.key)
+  if (group) tagFormRef.value?.open({ mode: 'edit-group', group })
+}
+
+function handleOpenEditTagValue(row: TagTableRow) {
+  tagFormRef.value?.open({ mode: 'edit-value', tag: { id: row.id, key: row.key, value: row.value } })
+}
+
+function handleOpenTagDocuments(row: TagTableRow) {
+  tagDocumentRef.value?.open({ id: row.id, key: row.key, value: row.value })
+}
+
+/* 删除只在确认后提交，标签删除与文档取消关联使用不同接口。 */
+function handleDeleteTag(row: TagTableRow, type: 'key' | 'one') {
+  if (loading.value || operationLoading.value) return
+  const tagName = type === 'key' ? row.key : `${row.key}—${row.value}`
+  const tip =
+    type === 'key'
+      ? '删除后，使用该标签的文档将移除此标签及其全部标签值，文档本身不会删除，请谨慎操作！'
+      : '删除后，使用该标签值的文档将移除此标签值，文档本身不会删除，请谨慎操作！'
+  return MsgConfirm(`是否删除标签：${tagName}？`, tip).then(
+    () => {
+      operationLoading.value = true
+      return TagsApi.deleteKnowledgeTag(knowledgeId.value, row.id, type)
+        .then(() => {
+          MsgSuccess('删除成功')
+          return loadTags()
+        })
+        .finally(() => {
+          operationLoading.value = false
+        })
+    },
+    () => {},
+  )
+}
+
+function handleBatchDelete() {
+  if (loading.value || operationLoading.value || !selectedTags.value.length) return
+  const tagIds = selectedTags.value.map(({ id }) => id)
+  const groupCount = new Set(selectedTags.value.map(({ key }) => key)).size
+  return MsgConfirm(
+    `是否删除选中的 ${groupCount} 个标签？`,
+    '将删除选中记录所属的标签及其全部标签值，并移除文档上的对应标签；文档本身不会删除，请谨慎操作！',
+  ).then(
+    () => {
+      operationLoading.value = true
+      return TagsApi.putBatchDeleteKnowledgeTags(knowledgeId.value, tagIds)
+        .then(() => {
+          MsgSuccess('删除成功')
+          return loadTags()
+        })
+        .finally(() => {
+          operationLoading.value = false
+        })
+    },
+    () => {},
+  )
+}
+
+onMounted(() => {
+  loadTags()
+})
 </script>
 
 <template>
-  <div class="flex-center min-h-0 flex-1 text-N500">标签管理功能待接入</div>
+  <Teleport v-if="headerTarget" :to="headerTarget">
+    <div class="flex-between gap-4">
+      <h4>{{ title }}</h4>
+      <div class="flex-align-center">
+        <MkSearchInput v-model="searchText" class="w-60! mr-3" :disabled="loading || operationLoading" @input="handleSearchChange" />
+        <!-- 导入标签，成功后刷新列表 -->
+        <ButtonImportTags :api="TagsApi" :knowledge-id="knowledgeId" :disabled="loading || operationLoading" @refresh="loadTags" />
+        <!-- 创建标签 -->
+        <el-button type="primary" :disabled="loading || operationLoading" @click="handleOpenCreateTag">
+          <MkIcon name="icon_add_outlined" />
+          <span>创建</span>
+        </el-button>
+      </div>
+    </div>
+  </Teleport>
+  <MkTable
+    ref="tagTableRef"
+    v-model:pagination-config="paginationConfig"
+    v-loading="loading || operationLoading"
+    :data="tagRows"
+    :span-method="spanMethod"
+    :cell-class-name="getCellClass"
+    :max-table-height="210"
+    row-key="id"
+    row-class-name="group"
+    @selection-change="handleSelectionChange"
+    @current-change="clearSelection"
+    @size-change="clearSelection"
+    @cell-mouse-enter="handleCellEnter"
+    @cell-mouse-leave="handleCellLeave"
+  >
+    <el-table-column type="selection" width="40" />
+    <el-table-column prop="key" label="标签" min-width="240">
+      <template #default="{ row }: { row: TagTableRow }">
+        <div class="flex-align-center gap-1">
+          <span class="min-w-0 truncate" :title="row.key">{{ row.key }}</span>
+          <div class="flex-align-center shrink-0" :class="{ 'group-hover-visible': hoveredTagKey !== row.key }">
+            <!-- 新增标签值 -->
+            <MkAction display="button" label="新增标签值" icon="icon_add_outlined" @click="handleOpenAddTagValue(row)" />
+            <!-- 编辑标签 -->
+            <MkAction display="button" label="编辑标签" icon="icon_edit_outlined" @click="handleOpenEditTag(row)" />
+            <!-- 删除整个标签 -->
+            <MkAction display="button" label="删除标签" icon="icon_delete-trash_outlined" @click="handleDeleteTag(row, 'key')" />
+          </div>
+        </div>
+      </template>
+    </el-table-column>
+    <el-table-column prop="value" label="标签值" min-width="180" class-name="border-l!" show-overflow-tooltip />
+    <el-table-column prop="doc_count" label="已关联文档" min-width="140">
+      <template #default="{ row }: { row: TagTableRow }">
+        <!-- 查看标签关联文档 -->
+        <el-button type="primary" link class="mk-link" @click="handleOpenTagDocuments(row)">{{ row.doc_count ?? 0 }}</el-button>
+      </template>
+    </el-table-column>
+    <el-table-column label="操作" width="100" fixed="right">
+      <template #default="{ row }: { row: TagTableRow }">
+        <div class="flex-align-center">
+          <!-- 编辑标签值 -->
+          <MkAction display="button" label="编辑标签值" icon="icon_edit_outlined" @click="handleOpenEditTagValue(row)" />
+          <!-- 删除标签值 -->
+          <MkAction display="button" label="删除标签值" icon="icon_delete-trash_outlined" @click="handleDeleteTag(row, 'one')" />
+        </div>
+      </template>
+    </el-table-column>
+    <template #footer-batch-actions>
+      <!-- 批量删除标签 -->
+      <el-button type="danger" plain :loading="operationLoading" @click="handleBatchDelete">删除</el-button>
+    </template>
+  </MkTable>
+  <TagFormDialog ref="tagFormRef" :api="TagsApi" :knowledge-id="knowledgeId" @refresh="loadTags" />
+  <TagDocumentDrawer ref="tagDocumentRef" :api="DocumentApi" :knowledge-id="knowledgeId" @refresh="loadTags" />
 </template>