diff --git a/ui/src/views/VIEW_README.md b/ui/src/views/VIEW_README.md
index 0a35081bb31..e623a99f078 100644
--- a/ui/src/views/VIEW_README.md
+++ b/ui/src/views/VIEW_README.md
@@ -797,7 +797,7 @@ Web 来源地址与选择器仅在单项设置中编辑，批量设置不展示
 文档任务是否排队或执行中通过其中的 `isDocumentTaskRunning(document, taskType)` 判断，
 页面及 Action 不重复解析状态字符串；文档或任务状态缺失时返回 `false`。
 `EmbeddingDocumentAction` 负责单项向量化与取消向量化，`BatchEmbeddingAction` 负责批量向量化按钮，`GenerateQuestionsAction` 负责单项生成问题与取消生成，`BatchGenerateQuestionsAction` 负责批量生成问题，`SettingDocumentAction` 负责召回及来源设置，
-`MigrateDocumentAction` 选择目标知识库，`DocumentTagsAction` 添加已有标签和移除文档标签关联；
+`MigrateDocumentAction` 选择目标知识库；`setting-tags/DocumentTagsAction.vue` 暂仅提供“标签设置”入口按钮。
 生成问题复用公共配置弹窗，其余 Action 按下文维护各自专属弹窗。组件接收完整 Document API、知识库 ID、文档 ID 或文档数组及禁用状态，
 点击时快照本次操作对象，内部管理弹窗和请求，成功后通过 `refresh` 通知页面刷新，失败保留输入。
 迁移操作集中在 `document/action-dropdown/migrate/`，`MigrateDocumentAction.vue` 负责入口与弹窗按需挂载，
diff --git a/ui/src/views/knowledge-detail/library/document/action-dropdown/DocumentTagsAction.vue b/ui/src/views/knowledge-detail/library/document/action-dropdown/DocumentTagsAction.vue
deleted file mode 100644
index 0570101b4f3..00000000000
--- a/ui/src/views/knowledge-detail/library/document/action-dropdown/DocumentTagsAction.vue
+++ /dev/null
@@ -1,137 +0,0 @@
-<script setup lang="ts">
-import { computed, ref } from 'vue'
-import type { KnowledgeTagGroup } from '@/api/types'
-import type DocumentApi from '@/api/admin/workspace/knowledge/document'
-import KnowledgeApi from '@/api/admin/workspace/knowledge/knowledge'
-import { MsgSuccess } from '@/utils/message'
-
-defineOptions({ name: 'DocumentTagsAction' })
-const props = defineProps<{ api: typeof DocumentApi; knowledgeId: string; documentIds: string[]; manageTags?: boolean; disabled?: boolean }>()
-const emit = defineEmits<{ refresh: [] }>()
-const visible = ref(false)
-const loading = ref(false)
-const optionLoading = ref(false)
-const targetDocumentIds = ref<string[]>([])
-const manage = ref(false)
-const selectedTagIds = ref<string[]>([])
-const tagGroups = ref<KnowledgeTagGroup[]>([])
-const documentTagGroups = ref<KnowledgeTagGroup[]>([])
-const documentTags = computed(() => documentTagGroups.value.flatMap((group) => group.values.map((tag) => ({ ...tag, key: group.key }))))
-
-function handleOpenDialog() {
-  if (props.disabled || loading.value || optionLoading.value || !props.documentIds.length) return
-  const ids = props.documentIds
-  const manageTags = props.manageTags ?? false
-  targetDocumentIds.value = [...ids]
-  manage.value = manageTags
-  selectedTagIds.value = []
-  documentTagGroups.value = []
-  visible.value = true
-  optionLoading.value = true
-  Promise.all([
-    KnowledgeApi.getKnowledgeTags(props.knowledgeId),
-    manageTags && ids[0] ? props.api.getDocumentTags(props.knowledgeId, ids[0]) : Promise.resolve([]),
-  ])
-    .then(([groups, currentTags]) => {
-      tagGroups.value = groups
-      documentTagGroups.value = currentTags
-    })
-    .catch(() => {
-      // 请求层统一提示错误，保留当前输入。
-    })
-    .finally(() => {
-      optionLoading.value = false
-    })
-}
-
-function handleAddTags() {
-  if (loading.value || !selectedTagIds.value.length) return
-  loading.value = true
-  return props.api
-    .postAddDocumentTags(props.knowledgeId, targetDocumentIds.value, selectedTagIds.value)
-    .then(() => {
-      MsgSuccess('添加成功')
-      emit('refresh')
-      selectedTagIds.value = []
-      if (manage.value && targetDocumentIds.value[0]) {
-        return props.api.getDocumentTags(props.knowledgeId, targetDocumentIds.value[0]).then((groups) => {
-          documentTagGroups.value = groups
-        })
-      }
-      visible.value = false
-    })
-    .catch(() => {
-      // 请求层统一提示错误，保留当前输入。
-    })
-    .finally(() => {
-      loading.value = false
-    })
-}
-
-function handleDeleteTag(tagId: string) {
-  const documentId = targetDocumentIds.value[0]
-  if (loading.value || !documentId) return
-  loading.value = true
-  return props.api
-    .putDeleteDocumentTags(props.knowledgeId, documentId, [tagId])
-    .then(() => {
-      MsgSuccess('移除成功')
-      documentTagGroups.value = documentTagGroups.value.map((group) => ({ ...group, values: group.values.filter(({ id }) => id !== tagId) }))
-      emit('refresh')
-    })
-    .catch(() => {
-      // 请求层统一提示错误，保留当前输入。
-    })
-    .finally(() => {
-      loading.value = false
-    })
-}
-
-function handleClosed() {
-  targetDocumentIds.value = []
-  selectedTagIds.value = []
-  documentTagGroups.value = []
-  tagGroups.value = []
-}
-</script>
-
-<template>
-  <!-- 文档标签设置或批量添加入口 -->
-  <MkAction
-    :label="manageTags ? '标签设置' : '添加标签'"
-    icon="icon_tag"
-    :disabled="disabled || loading || !documentIds.length"
-    @click="handleOpenDialog"
-  />
-  <MkDialog v-model="visible" :title="manage ? '标签设置' : '添加标签'" @closed="handleClosed">
-    <el-form v-loading="loading || optionLoading" label-position="top" require-asterisk-position="right" @submit.prevent>
-      <el-form-item label="标签">
-        <el-select v-model="selectedTagIds" multiple filterable placeholder="请选择标签" :loading="optionLoading">
-          <template v-for="group in tagGroups" :key="group.key">
-            <el-option-group :label="group.key">
-              <template v-for="tag in group.values" :key="tag.id">
-                <el-option :label="`${group.key}: ${tag.value}`" :value="tag.id" :disabled="documentTags.some((current) => current.id === tag.id)" />
-              </template>
-            </el-option-group>
-          </template>
-        </el-select>
-      </el-form-item>
-    </el-form>
-    <el-table v-if="manage" :data="documentTags" v-loading="loading || optionLoading">
-      <el-table-column prop="key" label="标签名" />
-      <el-table-column prop="value" label="标签值" />
-      <el-table-column label="操作" width="80">
-        <template #default="{ row }">
-          <!-- 移除文档标签 -->
-          <MkAction display="button" label="移除" icon="icon_delete-trash_outlined" :disabled="loading" @click="handleDeleteTag(row.id)" />
-        </template>
-      </el-table-column>
-    </el-table>
-    <template #footer>
-      <!-- 关闭标签设置 -->
-      <el-button :disabled="loading || optionLoading" @click="visible = false">关闭</el-button>
-      <!-- 添加文档标签 -->
-      <el-button type="primary" :disabled="!selectedTagIds.length || optionLoading" :loading="loading" @click="handleAddTags">添加</el-button>
-    </template>
-  </MkDialog>
-</template>
diff --git a/ui/src/views/knowledge-detail/library/document/action-dropdown/index.ts b/ui/src/views/knowledge-detail/library/document/action-dropdown/index.ts
index 4c981687feb..49e2ab1e31d 100644
--- a/ui/src/views/knowledge-detail/library/document/action-dropdown/index.ts
+++ b/ui/src/views/knowledge-detail/library/document/action-dropdown/index.ts
@@ -1,7 +1,7 @@
 export { default as BatchEmbeddingAction } from './embedding/BatchEmbeddingAction.vue'
 export { default as BatchCancelTaskAction } from './BatchCancelTaskAction.vue'
 export { default as DeleteDocumentAction } from './DeleteDocumentAction.vue'
-export { default as DocumentTagsAction } from './DocumentTagsAction.vue'
+export { default as DocumentTagsAction } from './setting-tags/DocumentTagsAction.vue'
 export { default as EmbeddingDocumentAction } from './embedding/EmbeddingDocumentAction.vue'
 export { default as GenerateQuestionsAction } from './generate-questions/GenerateQuestionsAction.vue'
 export { default as BatchGenerateQuestionsAction } from './generate-questions/BatchGenerateQuestionsAction.vue'
diff --git a/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/DocumentTagsAction.vue b/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/DocumentTagsAction.vue
new file mode 100644
index 00000000000..7b14cb061a6
--- /dev/null
+++ b/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/DocumentTagsAction.vue
@@ -0,0 +1,9 @@
+<script setup lang="ts">
+defineOptions({ name: 'DocumentTagsAction' })
+defineProps<{ label: string; icon?: string; disabled?: boolean }>()
+</script>
+
+<template>
+  <!-- 文档标签设置入口 -->
+  <MkAction :label="label" :icon="icon" :disabled="disabled" />
+</template>
diff --git a/ui/src/views/knowledge-detail/library/document/index.vue b/ui/src/views/knowledge-detail/library/document/index.vue
index b306958d610..302bd15ca96 100644
--- a/ui/src/views/knowledge-detail/library/document/index.vue
+++ b/ui/src/views/knowledge-detail/library/document/index.vue
@@ -32,6 +32,7 @@ import {
   BatchEmbeddingAction,
   BatchCancelTaskAction,
   DeleteDocumentAction,
+  DocumentTagsAction,
   EmbeddingDocumentAction,
   GenerateQuestionsAction,
   BatchGenerateQuestionsAction,
@@ -364,7 +365,7 @@ onBeforeUnmount(() => {
     v-loading="loading || operationLoading"
     :data="documentData"
     v-model:pagination-config="paginationConfig"
-    :max-table-height="210"
+    :max-table-height="240"
     @current-change="loadDocuments()"
     @size-change="loadDocuments()"
     @selection-change="handleSelectionChange"
@@ -514,15 +515,8 @@ onBeforeUnmount(() => {
                 :document="row"
                 @refresh="refreshAfterOperation"
               />
-              <!-- 设置文档标签 -->
-              <!-- <DocumentTagsAction
-                :api="DocumentApi"
-                :knowledge-id="knowledgeId"
-                :document-ids="[row.id]"
-                manage-tags
-                :disabled="operationLoading"
-                @refresh="refreshAfterOperation"
-              /> -->
+              <!-- TODO: 设置文档标签 -->
+              <DocumentTagsAction label="标签设置" icon="icon_tag" :disabled="operationLoading" />
               <!-- 同步 -->
               <SyncDocumentAction
                 v-if="
@@ -625,7 +619,7 @@ onBeforeUnmount(() => {
         @refresh="refreshAfterOperation"
       />
 
-      <!-- 批量添加标签 -->
+      <!-- // TODO 批量添加标签 -->
       <!-- <el-button>添加标签</el-button> -->
 
       <!-- 更多批量操作 -->