diff --git a/ui/src/views/VIEW_README.md b/ui/src/views/VIEW_README.md
index c651badf755..80d50966388 100644
--- a/ui/src/views/VIEW_README.md
+++ b/ui/src/views/VIEW_README.md
@@ -23,7 +23,8 @@
 - `action-dropdown/` 目录目前只优先用于 `application`、`knowledge`、`model`、`tool` 四类特殊
   资源，用于维护跨 Workspace、System 资源管理或 System 共享资源复用的卡片 Action。其他业务
   暂不主动创建这类目录，操作入口和配套流程优先留在所属页面或组件中；出现明确的跨范围共享需求
-  后再评估是否采用相同结构。
+  后再评估是否采用相同结构。按明确需求，文档页使用 `knowledge-detail/document/action-dropdown/`
+  集中维护行操作、批量操作及其专属弹窗；不因此扩展其他普通页面的目录规则。
 - 仅供一个页面使用的代码放在该页面功能目录；同一功能下多个页面复用的代码放在它们最近的
   共同功能目录中。
 - 不要为了复用一个页面内部实现而提前移动到 `src/components`。
@@ -322,8 +323,9 @@ Workspace 的自定义工具和工作流工具菜单
 维护逐方法接口类型；`ApplyStoreToolDialog` 内聚商店应用请求，提交时通过
 `isSystemSharedResource()` 选择 System 共享资源或 Workspace 的 Tool API 和 Tool Store API，
 覆盖工作流模板及商店工具两个分支；历史内置工具由 ToolStore 提供，不再从数据库加载。
-工具启用状态属于固定的卡片内交互，由 `ToolStatusSwitch`
-使用卡片传入的 Tool API 更新，并通过 `update` 事件通知页面替换列表数据。工具批量选择状态、
+工具启用状态由 Workspace 工具页和 System 共享工具页通过 `ToolCard` 的 `actions` 插槽组合
+`ToolStatusSwitch`，页面直接传入对应 Tool API 和操作 loading，并通过 `update` 事件替换列表数据。
+`ToolCard` 不再接收 Tool API，仅提供操作插槽；版本更新仍通过卡片的 loading 和 update 通道处理。工具批量选择状态、
 批量移动和批量删除流程由 `ToolView` 管理；`MoveToolAction` 复用公共 `MoveToDialog` 完成单个工具移动，
 在具体目录中通过 `delete` 通知页面局部移除卡片，在“全部工具”中保留卡片。`ToolCard` 只把选择模式与选中状态传给 `MkSourceCard`。
 工具商店列表由 `ToolView` 统一加载并经 `ToolCard` 传给 `ButtonUpdateVersion`，卡片和更新按钮
@@ -677,12 +679,25 @@ Workspace API 内部通过 `getWorkspaceId()` 读取当前路由工作空间。
 选中后通过 `footer-batch-actions` 展示批量操作。右侧固定操作列提供启停、向量化、分词索引和更多菜单，
 运行或排队中的任务切换为取消入口。Web、飞书提供同步，普通与工作流文档提供原文下载和替换。
 单项与批量操作共用页面请求状态，删除和同步先确认，成功后清空选择并刷新，导出和下载保留选择。
-文档操作入口与专属弹窗合并放在 `document/components/`：`ButtonDocumentTask` 负责向量化分段范围与生成问题配置，
-`ButtonDocumentSetting` 负责召回及来源设置，`ButtonMigrateDocument` 选择目标知识库，
-`ButtonDocumentTags` 添加已有标签和移除文档标签关联。组件接收知识库 ID、文档 ID 或文档数组及禁用状态，
+文档操作统一放在 `document/action-dropdown/`，通过该目录 `index.ts` 导出，页面显式组合各 Action。
+`EmbeddingDocumentAction` 负责向量化分段范围与取消向量化，`GenerateDocumentQuestionsAction` 负责生成问题配置，`SettingDocumentAction` 负责召回及来源设置，
+`MigrateDocumentAction` 选择目标知识库，`DocumentTagsAction` 添加已有标签和移除文档标签关联；
+这些 Action 继续将操作入口与专属弹窗放在同一组件内。组件接收完整 Document API、知识库 ID、文档 ID 或文档数组及禁用状态，
 点击时快照本次操作对象，内部管理弹窗和请求，成功后通过 `refresh` 通知页面刷新，失败保留输入。
-任务组件通过 `action` 区分向量化与生成问题，通过 `batch` 切换批量按钮；行内入口使用 `display` 区分菜单与图标按钮。
+向量化和生成问题使用独立 Action，通过 `batch` 切换批量按钮；行内入口使用 `display` 区分菜单与图标按钮。
+单项向量化传入 `document`，由 `EmbeddingDocumentAction` 内部判断排队或执行状态并切换取消入口，
+取消请求通过 `v-model:loading` 共用页面操作状态；页面不再拆分向量化和取消向量化两个入口。
 设置组件通过 `batch` 区分单项与批量，标签组件通过 `manageTags` 区分标签管理与批量添加。
+`CancelDocumentTaskAction`、`TokenizeDocumentAction`、`SyncDocumentAction`、
+`ExportDocumentAction`、`DownloadDocumentAction`、`ReplaceDocumentAction` 和 `DeleteDocumentAction`
+分别负责任务取消、分词、同步、导出、下载、替换与删除，单项和批量入口复用对应组件。
+直接请求的 Action 通过 `v-model:loading` 共用页面操作状态，各 Action 自行管理请求、
+防重复提交、成功提示与失败处理，不额外抽取统一请求封装；需要刷新时发出 `refresh`，导出与下载不发出。
+删除后分页总数和页码回退由页面重新查询服务端处理，不在 Action 中维护分页数据。
+启停开关直接使用页面内的 `el-switch`，由页面 `handleChangeActive` 管理请求，
+接口成功后刷新列表回显，不在请求前切换状态，不单独封装 Action。
+页面保留列表、多选、任务状态展示判断与刷新方法，不维护各 Action 的请求流程。
+`DocumentStatus`、`DocumentTags` 等纯展示组件继续留在 `document/components/`。
 页面不再维护这些弹窗 Ref 和打开方法；承载入口的 `MkTableMoreDropdown` 使用 `persistent`，避免菜单收起时卸载弹窗。
 不新增前端权限判断；共享文档不展示选择列及操作入口。
 文档分页接口维护在 `workspace/knowledge/document.ts`，页面管理 loading。文件状态表头使用
diff --git a/ui/src/views/knowledge-detail/document/action-dropdown/CancelDocumentTaskAction.vue b/ui/src/views/knowledge-detail/document/action-dropdown/CancelDocumentTaskAction.vue
new file mode 100644
index 00000000000..09a2a6f1dff
--- /dev/null
+++ b/ui/src/views/knowledge-detail/document/action-dropdown/CancelDocumentTaskAction.vue
@@ -0,0 +1,47 @@
+<script setup lang="ts">
+import { MsgSuccess } from '@/utils/message'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
+import type { DocumentTaskType } from '@/api/types'
+
+defineOptions({ name: 'CancelDocumentTaskAction' })
+const props = defineProps<{
+  api: typeof DocumentApi
+  knowledgeId: string
+  documentIds: string[]
+  taskType: DocumentTaskType
+  label: string
+  display?: 'menu' | 'button'
+  divided?: boolean
+}>()
+const loading = defineModel<boolean>('loading', { default: false })
+const emit = defineEmits<{ refresh: [] }>()
+
+// 取消单个或选中文档的指定任务。
+function handleCancelTask() {
+  const ids = [...props.documentIds]
+  if (!ids.length || loading.value) return
+  loading.value = true
+  return props.api
+    .putBatchCancelDocumentTask(props.knowledgeId, ids, props.taskType)
+    .then(() => {
+      MsgSuccess('操作成功')
+      emit('refresh')
+    })
+    .catch(() => {})
+    .finally(() => {
+      loading.value = false
+    })
+}
+</script>
+
+<template>
+  <!-- 取消文档任务 -->
+  <MkAction
+    :label="label"
+    icon="icon_close_outlined"
+    :display="display"
+    :divided="divided"
+    :disabled="loading || !documentIds.length"
+    @click="handleCancelTask"
+  />
+</template>
diff --git a/ui/src/views/knowledge-detail/document/action-dropdown/DeleteDocumentAction.vue b/ui/src/views/knowledge-detail/document/action-dropdown/DeleteDocumentAction.vue
new file mode 100644
index 00000000000..0f59b7561fc
--- /dev/null
+++ b/ui/src/views/knowledge-detail/document/action-dropdown/DeleteDocumentAction.vue
@@ -0,0 +1,38 @@
+<script setup lang="ts">
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
+import { MsgConfirm, MsgSuccess } from '@/utils/message'
+
+defineOptions({ name: 'DeleteDocumentAction' })
+const props = defineProps<{ api: typeof DocumentApi; knowledgeId: string; documentIds: string[]; batch?: boolean }>()
+const loading = defineModel<boolean>('loading', { default: false })
+const emit = defineEmits<{ refresh: [] }>()
+
+// 确认后删除单个或选中文档；刷新后的分页总数以服务端为准。
+function handleDelete() {
+  if (!props.documentIds.length || loading.value) return
+  const ids = [...props.documentIds]
+  const documentId = ids[0]!
+  return MsgConfirm(`删除 ${ids.length} 个文档`, '删除后无法恢复，是否继续？')
+    .then(() => {
+      if (loading.value) return
+      loading.value = true
+      const request = props.batch
+        ? props.api.putBatchDeleteDocuments(props.knowledgeId, ids)
+        : props.api.deleteDocument(props.knowledgeId, documentId)
+      return request
+        .then(() => {
+          MsgSuccess('操作成功')
+          emit('refresh')
+        })
+        .finally(() => {
+          loading.value = false
+        })
+    })
+    .catch(() => {})
+}
+</script>
+
+<template>
+  <!-- 删除单个或选中文档 -->
+  <MkAction label="删除" icon="icon_delete-trash_outlined" divided :disabled="loading || !documentIds.length" @click="handleDelete" />
+</template>
diff --git a/ui/src/views/knowledge-detail/document/components/ButtonDocumentTags.vue b/ui/src/views/knowledge-detail/document/action-dropdown/DocumentTagsAction.vue
similarity index 87%
rename from ui/src/views/knowledge-detail/document/components/ButtonDocumentTags.vue
rename to ui/src/views/knowledge-detail/document/action-dropdown/DocumentTagsAction.vue
index 35c34cb1fb0..68a916d8b4a 100644
--- a/ui/src/views/knowledge-detail/document/components/ButtonDocumentTags.vue
+++ b/ui/src/views/knowledge-detail/document/action-dropdown/DocumentTagsAction.vue
@@ -1,12 +1,12 @@
 <script setup lang="ts">
 import { computed, ref } from 'vue'
 import type { KnowledgeTagGroup } from '@/api/types'
-import DocumentApi from '@/api/admin/workspace/knowledge/document'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
 import KnowledgeApi from '@/api/admin/workspace/knowledge/knowledge'
 import { MsgSuccess } from '@/utils/message'
 
-defineOptions({ name: 'ButtonDocumentTags' })
-const props = defineProps<{ knowledgeId: string; documentIds: string[]; manageTags?: boolean; disabled?: boolean }>()
+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)
@@ -30,7 +30,7 @@ function handleOpenDialog() {
   optionLoading.value = true
   Promise.all([
     KnowledgeApi.getKnowledgeTags(props.knowledgeId),
-    manageTags && ids[0] ? DocumentApi.getDocumentTags(props.knowledgeId, ids[0]) : Promise.resolve([]),
+    manageTags && ids[0] ? props.api.getDocumentTags(props.knowledgeId, ids[0]) : Promise.resolve([]),
   ])
     .then(([groups, currentTags]) => {
       tagGroups.value = groups
@@ -47,13 +47,14 @@ function handleOpenDialog() {
 function handleAddTags() {
   if (loading.value || !selectedTagIds.value.length) return
   loading.value = true
-  return DocumentApi.postAddDocumentTags(props.knowledgeId, targetDocumentIds.value, selectedTagIds.value)
+  return props.api
+    .postAddDocumentTags(props.knowledgeId, targetDocumentIds.value, selectedTagIds.value)
     .then(() => {
       MsgSuccess('添加成功')
       emit('refresh')
       selectedTagIds.value = []
       if (manage.value && targetDocumentIds.value[0]) {
-        return DocumentApi.getDocumentTags(props.knowledgeId, targetDocumentIds.value[0]).then((groups) => {
+        return props.api.getDocumentTags(props.knowledgeId, targetDocumentIds.value[0]).then((groups) => {
           documentTagGroups.value = groups
         })
       }
@@ -71,7 +72,8 @@ function handleDeleteTag(tagId: string) {
   const documentId = targetDocumentIds.value[0]
   if (loading.value || !documentId) return
   loading.value = true
-  return DocumentApi.putDeleteDocumentTags(props.knowledgeId, documentId, [tagId])
+  return props.api
+    .putDeleteDocumentTags(props.knowledgeId, documentId, [tagId])
     .then(() => {
       MsgSuccess('移除成功')
       documentTagGroups.value = documentTagGroups.value.map((group) => ({ ...group, values: group.values.filter(({ id }) => id !== tagId) }))
diff --git a/ui/src/views/knowledge-detail/document/action-dropdown/DownloadDocumentAction.vue b/ui/src/views/knowledge-detail/document/action-dropdown/DownloadDocumentAction.vue
new file mode 100644
index 00000000000..1dfc68da0f0
--- /dev/null
+++ b/ui/src/views/knowledge-detail/document/action-dropdown/DownloadDocumentAction.vue
@@ -0,0 +1,29 @@
+<script setup lang="ts">
+import { MsgSuccess } from '@/utils/message'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
+import type { DocumentItem } from '@/api/types'
+
+defineOptions({ name: 'DownloadDocumentAction' })
+const props = defineProps<{ api: typeof DocumentApi; knowledgeId: string; document: DocumentItem }>()
+const loading = defineModel<boolean>('loading', { default: false })
+
+// 下载原始文件，不清空勾选或刷新列表。
+function handleDownload() {
+  if (loading.value) return
+  loading.value = true
+  return props.api
+    .downloadDocumentSource(props.knowledgeId, props.document)
+    .then(() => {
+      MsgSuccess('操作成功')
+    })
+    .catch(() => {})
+    .finally(() => {
+      loading.value = false
+    })
+}
+</script>
+
+<template>
+  <!-- 下载原文档 -->
+  <MkAction label="下载原文档" icon="icon_download_outlined" :disabled="loading" @click="handleDownload" />
+</template>
diff --git a/ui/src/views/knowledge-detail/document/action-dropdown/EmbeddingDocumentAction.vue b/ui/src/views/knowledge-detail/document/action-dropdown/EmbeddingDocumentAction.vue
new file mode 100644
index 00000000000..71ce37cef75
--- /dev/null
+++ b/ui/src/views/knowledge-detail/document/action-dropdown/EmbeddingDocumentAction.vue
@@ -0,0 +1,104 @@
+<script setup lang="ts">
+import { computed, ref } from 'vue'
+import { DOCUMENT_TASK_STATE, DOCUMENT_TASK_TYPE } from '@/api/enums'
+import type { DocumentItem } from '@/api/types'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
+import { MsgSuccess } from '@/utils/message'
+
+defineOptions({ name: 'EmbeddingDocumentAction' })
+const props = defineProps<{
+  api: typeof DocumentApi
+  knowledgeId: string
+  documentIds: string[]
+  document?: DocumentItem
+  batch?: boolean
+  display?: 'menu' | 'button'
+}>()
+const operationLoading = defineModel<boolean>('loading', { default: false })
+const emit = defineEmits<{ refresh: [] }>()
+const visible = ref(false)
+const loading = ref(false)
+const targetDocumentIds = ref<string[]>([])
+const scope = ref<'error' | 'all'>('error')
+
+// 单项向量化根据任务状态切换为取消入口，批量入口始终打开向量化配置。
+const running = computed(() => {
+  if (props.batch) return false
+  const state = props.document?.status?.at(-DOCUMENT_TASK_TYPE.EMBEDDING)
+  return state === DOCUMENT_TASK_STATE.PENDING || state === DOCUMENT_TASK_STATE.STARTED
+})
+
+function handleEmbedding() {
+  if (!running.value) {
+    targetDocumentIds.value = [...props.documentIds]
+    scope.value = 'error'
+    visible.value = true
+    return
+  }
+  // 正在排队或执行时，直接提交取消向量化请求。
+  operationLoading.value = true
+  return props.api
+    .putBatchCancelDocumentTask(props.knowledgeId, [...props.documentIds], DOCUMENT_TASK_TYPE.EMBEDDING)
+    .then(() => {
+      MsgSuccess('操作成功')
+      emit('refresh')
+    })
+    .catch(() => {})
+    .finally(() => {
+      operationLoading.value = false
+    })
+}
+
+// 根据选定的分段范围提交向量化，失败时保留配置。
+function handleSubmit() {
+  if (loading.value) return
+  loading.value = true
+  const stateList = Object.values(DOCUMENT_TASK_STATE).filter((state) => scope.value === 'all' || state !== DOCUMENT_TASK_STATE.SUCCESS)
+  return props.api
+    .putBatchRefreshDocuments(props.knowledgeId, targetDocumentIds.value, stateList)
+    .then(() => {
+      MsgSuccess('任务已提交')
+      visible.value = false
+      emit('refresh')
+    })
+    .catch(() => {})
+    .finally(() => {
+      loading.value = false
+    })
+}
+
+function handleClosed() {
+  targetDocumentIds.value = []
+  scope.value = 'error'
+}
+</script>
+
+<template>
+  <!-- 批量向量化 -->
+  <el-button v-if="batch" :disabled="operationLoading || loading || !documentIds.length" @click="handleEmbedding">向量化</el-button>
+  <!-- 向量化或取消向量化 -->
+  <MkAction
+    v-else
+    :display="display ?? 'menu'"
+    :label="running ? '取消向量化' : '向量化'"
+    :icon="running ? 'icon_close_outlined' : 'icon_refresh_outlined'"
+    :disabled="operationLoading || loading || !documentIds.length"
+    @click="handleEmbedding"
+  />
+  <MkDialog v-model="visible" title="向量化" @closed="handleClosed">
+    <el-form label-position="top" @submit.prevent>
+      <el-form-item label="选择分段">
+        <el-radio-group v-model="scope">
+          <el-radio value="error">未成功的分段</el-radio>
+          <el-radio value="all">全部分段</el-radio>
+        </el-radio-group>
+      </el-form-item>
+    </el-form>
+    <template #footer>
+      <!-- 取消向量化配置 -->
+      <el-button :disabled="loading" @click="visible = false">取消</el-button>
+      <!-- 提交向量化 -->
+      <el-button type="primary" :loading="loading" @click="handleSubmit">确认</el-button>
+    </template>
+  </MkDialog>
+</template>
diff --git a/ui/src/views/knowledge-detail/document/action-dropdown/ExportDocumentAction.vue b/ui/src/views/knowledge-detail/document/action-dropdown/ExportDocumentAction.vue
new file mode 100644
index 00000000000..01ee58cda43
--- /dev/null
+++ b/ui/src/views/knowledge-detail/document/action-dropdown/ExportDocumentAction.vue
@@ -0,0 +1,34 @@
+<script setup lang="ts">
+import { MsgSuccess } from '@/utils/message'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
+
+defineOptions({ name: 'ExportDocumentAction' })
+const props = defineProps<{ api: typeof DocumentApi; knowledgeId: string; documentIds: string[]; format: 'excel' | 'zip' }>()
+const loading = defineModel<boolean>('loading', { default: false })
+
+// 导出单个或选中文档，保留列表和勾选状态。
+function handleExport() {
+  const ids = [...props.documentIds]
+  if (!ids.length || loading.value) return
+  loading.value = true
+  return props.api
+    .exportDocuments(props.knowledgeId, ids, props.format)
+    .then(() => {
+      MsgSuccess('操作成功')
+    })
+    .catch(() => {})
+    .finally(() => {
+      loading.value = false
+    })
+}
+</script>
+
+<template>
+  <!-- 导出文档 -->
+  <MkAction
+    :label="format === 'excel' ? '导出 Excel' : '导出 Zip'"
+    icon="icon_export_outlined"
+    :disabled="loading || !documentIds.length"
+    @click="handleExport"
+  />
+</template>
diff --git a/ui/src/views/knowledge-detail/document/components/ButtonDocumentTask.vue b/ui/src/views/knowledge-detail/document/action-dropdown/GenerateDocumentQuestionsAction.vue
similarity index 53%
rename from ui/src/views/knowledge-detail/document/components/ButtonDocumentTask.vue
rename to ui/src/views/knowledge-detail/document/action-dropdown/GenerateDocumentQuestionsAction.vue
index 545c554b8ba..d7362b23b0c 100644
--- a/ui/src/views/knowledge-detail/document/components/ButtonDocumentTask.vue
+++ b/ui/src/views/knowledge-detail/document/action-dropdown/GenerateDocumentQuestionsAction.vue
@@ -3,17 +3,17 @@ import { ref } from 'vue'
 import type { FormInstance } from 'element-plus'
 import { DOCUMENT_TASK_STATE } from '@/api/enums'
 import type { ModelItem, ModelProviderItem } from '@/api/types'
-import DocumentApi from '@/api/admin/workspace/knowledge/document'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
 import ModelApi from '@/api/admin/workspace/model'
 import ModelProviderApi from '@/api/admin/model-provider'
 import SelectModel from '@/components/business/select-model/index.vue'
 import { MsgSuccess } from '@/utils/message'
 
-defineOptions({ name: 'ButtonDocumentTask' })
+defineOptions({ name: 'GenerateDocumentQuestionsAction' })
 const props = defineProps<{
+  api: typeof DocumentApi
   knowledgeId: string
   documentIds: string[]
-  action: 'embedding' | 'generate'
   batch?: boolean
   display?: 'menu' | 'button'
   disabled?: boolean
@@ -22,7 +22,6 @@ const emit = defineEmits<{ refresh: [] }>()
 const visible = ref(false)
 const loading = ref(false)
 const optionLoading = ref(false)
-const task = ref<'embedding' | 'generate'>('embedding')
 const targetDocumentIds = ref<string[]>([])
 const scope = ref<'error' | 'all'>('error')
 const formRef = ref<FormInstance>()
@@ -33,9 +32,7 @@ const providerOptions = ref<ModelProviderItem[]>([])
 function handleOpenDialog() {
   if (props.disabled || loading.value || optionLoading.value || !props.documentIds.length) return
   const ids = props.documentIds
-  const action = props.action
   targetDocumentIds.value = [...ids]
-  task.value = action
   scope.value = 'error'
   form.value = {
     model_id: '',
@@ -43,35 +40,30 @@ function handleOpenDialog() {
     prompt: '请根据以下内容生成相关问题，每个问题使用 <question></question> 标签包裹。只输出问题。\n内容：{data}',
   }
   visible.value = true
-  if (action === 'generate') {
-    optionLoading.value = true
-    Promise.all([ModelApi.getModelListWithShared({ model_type: 'LLM' }), ModelProviderApi.getProviderListByModelType('LLM')])
-      .then(([models, providers]) => {
-        modelOptions.value = models
-        providerOptions.value = providers
-      })
-      .catch(() => {
-        // 请求层统一提示错误，保留当前输入。
-      })
-      .finally(() => {
-        optionLoading.value = false
-      })
-  }
+  optionLoading.value = true
+  Promise.all([ModelApi.getModelListWithShared({ model_type: 'LLM' }), ModelProviderApi.getProviderListByModelType('LLM')])
+    .then(([models, providers]) => {
+      modelOptions.value = models
+      providerOptions.value = providers
+    })
+    .catch(() => {
+      // 请求层统一提示错误，保留当前输入。
+    })
+    .finally(() => {
+      optionLoading.value = false
+    })
 }
 
 async function handleSubmit() {
   if (loading.value || optionLoading.value) return
-  if (task.value === 'generate' && !(await formRef.value?.validate().catch(() => false))) return
+  if (!(await formRef.value?.validate().catch(() => false))) return
   loading.value = true
   const stateList = Object.values(DOCUMENT_TASK_STATE).filter((state) => scope.value === 'all' || state !== DOCUMENT_TASK_STATE.SUCCESS)
-  const request =
-    task.value === 'embedding'
-      ? DocumentApi.putBatchRefreshDocuments(props.knowledgeId, targetDocumentIds.value, stateList)
-      : DocumentApi.putGenerateDocumentQuestions(props.knowledgeId, {
-          ...form.value,
-          document_id_list: targetDocumentIds.value,
-          state_list: stateList,
-        })
+  const request = props.api.putGenerateDocumentQuestions(props.knowledgeId, {
+    ...form.value,
+    document_id_list: targetDocumentIds.value,
+    state_list: stateList,
+  })
   return request
     .then(() => {
       MsgSuccess('任务已提交')
@@ -93,43 +85,39 @@ function handleClosed() {
 </script>
 
 <template>
-  <!-- 文档向量化或生成问题入口 -->
-  <el-button v-if="batch" :disabled="disabled || loading || !documentIds.length" @click="handleOpenDialog">
-    {{ action === 'embedding' ? '向量化' : '生成问题' }}
-  </el-button>
+  <!-- 生成问题入口 -->
+  <el-button v-if="batch" :disabled="disabled || loading || !documentIds.length" @click="handleOpenDialog">生成问题</el-button>
   <MkAction
     v-else
     :display="display ?? 'menu'"
-    :label="action === 'embedding' ? '向量化' : '生成问题'"
-    :icon="action === 'embedding' ? 'icon_refresh_outlined' : 'icon_new-chat_outlined'"
+    label="生成问题"
+    icon="icon_new-chat_outlined"
     :disabled="disabled || loading || !documentIds.length"
     @click="handleOpenDialog"
   />
-  <MkDialog v-model="visible" :title="task === 'embedding' ? '向量化' : '生成问题'" :show-close="!loading && !optionLoading" @closed="handleClosed">
+  <MkDialog v-model="visible" title="生成问题" :show-close="!loading && !optionLoading" @closed="handleClosed">
     <el-form ref="formRef" :model="form" label-position="top" :disabled="loading || optionLoading" @submit.prevent>
-      <template v-if="task === 'generate'">
-        <p class="mb-4 text-N600">提示词使用 {data} 引用分段内容，生成的问题需使用 &lt;question&gt;&lt;/question&gt; 标签包裹。</p>
-        <el-form-item label="AI 模型" prop="model_id" :rules="[{ required: true, message: '请选择 AI 模型', trigger: 'change' }]">
-          <SelectModel
-            v-model="form.model_id"
-            v-model:model-params="form.model_params_setting"
-            :options="modelOptions"
-            :provider-options="providerOptions"
-            can-edit-params
-            :disabled="loading || optionLoading"
-          />
-        </el-form-item>
-        <el-form-item
-          label="提示词"
-          prop="prompt"
-          :rules="[
-            { required: true, message: '请输入提示词', trigger: 'blur' },
-            { whitespace: true, message: '提示词不能为空白', trigger: 'blur' },
-          ]"
-        >
-          <el-input v-model="form.prompt" type="textarea" :rows="7" />
-        </el-form-item>
-      </template>
+      <p class="mb-4 text-N600">提示词使用 {data} 引用分段内容，生成的问题需使用 &lt;question&gt;&lt;/question&gt; 标签包裹。</p>
+      <el-form-item label="AI 模型" prop="model_id" :rules="[{ required: true, message: '请选择 AI 模型', trigger: 'change' }]">
+        <SelectModel
+          v-model="form.model_id"
+          v-model:model-params="form.model_params_setting"
+          :options="modelOptions"
+          :provider-options="providerOptions"
+          can-edit-params
+          :disabled="loading || optionLoading"
+        />
+      </el-form-item>
+      <el-form-item
+        label="提示词"
+        prop="prompt"
+        :rules="[
+          { required: true, message: '请输入提示词', trigger: 'blur' },
+          { whitespace: true, message: '提示词不能为空白', trigger: 'blur' },
+        ]"
+      >
+        <el-input v-model="form.prompt" type="textarea" :rows="7" />
+      </el-form-item>
       <el-form-item label="选择分段">
         <el-radio-group v-model="scope">
           <el-radio value="error">未成功的分段</el-radio>
diff --git a/ui/src/views/knowledge-detail/document/components/ButtonMigrateDocument.vue b/ui/src/views/knowledge-detail/document/action-dropdown/MigrateDocumentAction.vue
similarity index 88%
rename from ui/src/views/knowledge-detail/document/components/ButtonMigrateDocument.vue
rename to ui/src/views/knowledge-detail/document/action-dropdown/MigrateDocumentAction.vue
index dce3835cb09..324e9c82b21 100644
--- a/ui/src/views/knowledge-detail/document/components/ButtonMigrateDocument.vue
+++ b/ui/src/views/knowledge-detail/document/action-dropdown/MigrateDocumentAction.vue
@@ -2,11 +2,11 @@
 import { ref } from 'vue'
 import type { KnowledgeItem } from '@/api/types'
 import KnowledgeApi from '@/api/admin/workspace/knowledge/knowledge'
-import DocumentApi from '@/api/admin/workspace/knowledge/document'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
 import { MsgSuccess } from '@/utils/message'
 
-defineOptions({ name: 'ButtonMigrateDocument' })
-const props = defineProps<{ knowledgeId: string; documentIds: string[]; disabled?: boolean }>()
+defineOptions({ name: 'MigrateDocumentAction' })
+const props = defineProps<{ api: typeof DocumentApi; knowledgeId: string; documentIds: string[]; disabled?: boolean }>()
 const emit = defineEmits<{ refresh: [] }>()
 const visible = ref(false)
 const loading = ref(false)
@@ -37,7 +37,8 @@ function handleOpenDialog() {
 function handleSubmit() {
   if (!targetKnowledgeId.value || loading.value) return
   loading.value = true
-  return DocumentApi.putMigrateDocuments(props.knowledgeId, targetKnowledgeId.value, targetDocumentIds.value)
+  return props.api
+    .putMigrateDocuments(props.knowledgeId, targetKnowledgeId.value, targetDocumentIds.value)
     .then(() => {
       MsgSuccess('迁移成功')
       visible.value = false
diff --git a/ui/src/views/knowledge-detail/document/action-dropdown/ReplaceDocumentAction.vue b/ui/src/views/knowledge-detail/document/action-dropdown/ReplaceDocumentAction.vue
new file mode 100644
index 00000000000..deada9f3910
--- /dev/null
+++ b/ui/src/views/knowledge-detail/document/action-dropdown/ReplaceDocumentAction.vue
@@ -0,0 +1,37 @@
+<script setup lang="ts">
+import { MsgSuccess } from '@/utils/message'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
+import type { UploadFile } from 'element-plus'
+import type { DocumentItem } from '@/api/types'
+
+defineOptions({ name: 'ReplaceDocumentAction' })
+const props = defineProps<{ api: typeof DocumentApi; knowledgeId: string; document: DocumentItem }>()
+const loading = defineModel<boolean>('loading', { default: false })
+const emit = defineEmits<{ refresh: [] }>()
+
+// 上传本地文件替换原文档，成功后通知页面刷新。
+function handleReplace(file: UploadFile) {
+  if (!file.raw || loading.value) return
+  loading.value = true
+  return props.api
+    .postReplaceDocumentSource(props.knowledgeId, props.document.id, file.raw)
+    .then(() => {
+      MsgSuccess('操作成功')
+      emit('refresh')
+    })
+    .catch(() => {})
+    .finally(() => {
+      loading.value = false
+    })
+}
+</script>
+
+<template>
+  <!-- 替换原文档 -->
+  <el-upload action="#" :auto-upload="false" :show-file-list="false" :file-list="[]" :disabled="loading" :on-change="handleReplace">
+    <MkDropdownItem :disabled="loading">
+      <template #icon><MkIcon name="icon_upload_outlined" /></template>
+      替换原文档
+    </MkDropdownItem>
+  </el-upload>
+</template>
diff --git a/ui/src/views/knowledge-detail/document/components/ButtonDocumentSetting.vue b/ui/src/views/knowledge-detail/document/action-dropdown/SettingDocumentAction.vue
similarity index 90%
rename from ui/src/views/knowledge-detail/document/components/ButtonDocumentSetting.vue
rename to ui/src/views/knowledge-detail/document/action-dropdown/SettingDocumentAction.vue
index 4df3b4fc2d5..7e8fe868914 100644
--- a/ui/src/views/knowledge-detail/document/components/ButtonDocumentSetting.vue
+++ b/ui/src/views/knowledge-detail/document/action-dropdown/SettingDocumentAction.vue
@@ -3,12 +3,12 @@ import { ref } from 'vue'
 import type { FormInstance } from 'element-plus'
 import { DOCUMENT_HIT_HANDLING, KNOWLEDGE_TYPE } from '@/api/enums'
 import type { DocumentItem, DocumentSettingPayload } from '@/api/types'
-import DocumentApi from '@/api/admin/workspace/knowledge/document'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
 import { DOCUMENT_HIT_HANDLING_LABELS } from '@/constants/document'
 import { MsgSuccess } from '@/utils/message'
 
-defineOptions({ name: 'ButtonDocumentSetting' })
-const props = defineProps<{ knowledgeId: string; documents: DocumentItem[]; batch?: boolean; disabled?: boolean }>()
+defineOptions({ name: 'SettingDocumentAction' })
+const props = defineProps<{ api: typeof DocumentApi; knowledgeId: string; documents: DocumentItem[]; batch?: boolean; disabled?: boolean }>()
 const emit = defineEmits<{ refresh: [] }>()
 const visible = ref(false)
 const loading = ref(false)
@@ -54,9 +54,9 @@ async function handleSubmit() {
       data.meta.source_url = form.value.source_url.trim()
       data.meta.selector = form.value.selector
     }
-    request = DocumentApi.putDocumentSetting(props.knowledgeId, document.value.id, data)
+    request = props.api.putDocumentSetting(props.knowledgeId, document.value.id, data)
   } else {
-    request = DocumentApi.putBatchDocumentSetting(props.knowledgeId, targetDocumentIds.value, { ...data, allow_download: form.value.allow_download })
+    request = props.api.putBatchDocumentSetting(props.knowledgeId, targetDocumentIds.value, { ...data, allow_download: form.value.allow_download })
   }
   return request
     .then(() => {
diff --git a/ui/src/views/knowledge-detail/document/action-dropdown/SyncDocumentAction.vue b/ui/src/views/knowledge-detail/document/action-dropdown/SyncDocumentAction.vue
new file mode 100644
index 00000000000..8f1f164a9f6
--- /dev/null
+++ b/ui/src/views/knowledge-detail/document/action-dropdown/SyncDocumentAction.vue
@@ -0,0 +1,57 @@
+<script setup lang="ts">
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
+import { KNOWLEDGE_TYPE } from '@/api/enums'
+import type { DocumentItem, KnowledgeType } from '@/api/types'
+import { MsgConfirm, MsgInfo, MsgSuccess } from '@/utils/message'
+
+defineOptions({ name: 'SyncDocumentAction' })
+const props = defineProps<{
+  api: typeof DocumentApi
+  knowledgeId: string
+  documents: DocumentItem[]
+  knowledgeType?: KnowledgeType
+  batch?: boolean
+}>()
+const loading = defineModel<boolean>('loading', { default: false })
+const emit = defineEmits<{ refresh: [] }>()
+
+// 单项 Web 同步校验来源地址，确认覆盖后按知识库类型调用同步接口。
+function handleSync() {
+  if (!props.documents.length || loading.value) return
+  const document = props.batch ? undefined : props.documents[0]
+  if (document?.type === KNOWLEDGE_TYPE.WEB && !document.meta?.source_url) {
+    MsgInfo('文档没有来源地址，请先在设置中填写文档地址')
+    return
+  }
+  const ids = props.documents.map(({ id }) => id)
+  return MsgConfirm('同步文档', '同步后将覆盖现有文档内容，是否继续？', { confirmButtonText: '同步' })
+    .then(() => {
+      if (loading.value) return
+      loading.value = true
+      const request =
+        props.knowledgeType === KNOWLEDGE_TYPE.LARK
+          ? props.api.putSyncLarkDocuments(props.knowledgeId, ids)
+          : props.api.putSyncDocuments(props.knowledgeId, ids)
+      return request
+        .then(() => {
+          MsgSuccess('操作成功')
+          emit('refresh')
+        })
+        .finally(() => {
+          loading.value = false
+        })
+    })
+    .catch(() => {})
+}
+</script>
+
+<template>
+  <!-- 同步单个或选中文档 -->
+  <MkAction
+    v-if="knowledgeType === KNOWLEDGE_TYPE.WEB || knowledgeType === KNOWLEDGE_TYPE.LARK"
+    :label="batch ? '同步文档' : '同步'"
+    icon="icon_refresh_outlined"
+    :disabled="loading || !documents.length"
+    @click="handleSync"
+  />
+</template>
diff --git a/ui/src/views/knowledge-detail/document/action-dropdown/TokenizeDocumentAction.vue b/ui/src/views/knowledge-detail/document/action-dropdown/TokenizeDocumentAction.vue
new file mode 100644
index 00000000000..46c421f6dbd
--- /dev/null
+++ b/ui/src/views/knowledge-detail/document/action-dropdown/TokenizeDocumentAction.vue
@@ -0,0 +1,49 @@
+<script setup lang="ts">
+import { MsgSuccess } from '@/utils/message'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
+import { computed } from 'vue'
+import { DOCUMENT_TASK_STATE, DOCUMENT_TASK_TYPE } from '@/api/enums'
+import type { DocumentItem } from '@/api/types'
+
+defineOptions({ name: 'TokenizeDocumentAction' })
+const props = defineProps<{ api: typeof DocumentApi; knowledgeId: string; documentIds: string[]; document?: DocumentItem; batch?: boolean }>()
+const loading = defineModel<boolean>('loading', { default: false })
+const emit = defineEmits<{ refresh: [] }>()
+
+// 行操作根据任务状态切换为取消；批量操作始终提交分词索引。
+const running = computed(() => {
+  const state = props.document?.status?.at(-DOCUMENT_TASK_TYPE.TOKENIZE)
+  return state === DOCUMENT_TASK_STATE.PENDING || state === DOCUMENT_TASK_STATE.STARTED
+})
+function handleTokenize() {
+  const ids = [...props.documentIds]
+  if (!ids.length || loading.value) return
+  loading.value = true
+  const request = running.value
+    ? props.api.putBatchCancelDocumentTask(props.knowledgeId, ids, DOCUMENT_TASK_TYPE.TOKENIZE)
+    : props.api.putBatchTokenizeDocuments(props.knowledgeId, ids, Object.values(DOCUMENT_TASK_STATE))
+  return request
+    .then(() => {
+      MsgSuccess('操作成功')
+      emit('refresh')
+    })
+    .catch(() => {})
+    .finally(() => {
+      loading.value = false
+    })
+}
+</script>
+
+<template>
+  <!-- 批量分词索引 -->
+  <el-button v-if="batch" :disabled="loading || !documentIds.length" @click="handleTokenize">分词索引</el-button>
+  <!-- 分词索引或取消分词索引 -->
+  <MkAction
+    v-else
+    display="button"
+    :label="running ? '取消分词索引' : '分词索引'"
+    :icon="running ? 'icon_close_outlined' : 'icon_add-dictionary_outlined'"
+    :disabled="loading"
+    @click="handleTokenize"
+  />
+</template>
diff --git a/ui/src/views/knowledge-detail/document/action-dropdown/index.ts b/ui/src/views/knowledge-detail/document/action-dropdown/index.ts
new file mode 100644
index 00000000000..762332ed242
--- /dev/null
+++ b/ui/src/views/knowledge-detail/document/action-dropdown/index.ts
@@ -0,0 +1,12 @@
+export { default as CancelDocumentTaskAction } from './CancelDocumentTaskAction.vue'
+export { default as DeleteDocumentAction } from './DeleteDocumentAction.vue'
+export { default as DocumentTagsAction } from './DocumentTagsAction.vue'
+export { default as EmbeddingDocumentAction } from './EmbeddingDocumentAction.vue'
+export { default as GenerateDocumentQuestionsAction } from './GenerateDocumentQuestionsAction.vue'
+export { default as DownloadDocumentAction } from './DownloadDocumentAction.vue'
+export { default as ExportDocumentAction } from './ExportDocumentAction.vue'
+export { default as MigrateDocumentAction } from './MigrateDocumentAction.vue'
+export { default as ReplaceDocumentAction } from './ReplaceDocumentAction.vue'
+export { default as SettingDocumentAction } from './SettingDocumentAction.vue'
+export { default as SyncDocumentAction } from './SyncDocumentAction.vue'
+export { default as TokenizeDocumentAction } from './TokenizeDocumentAction.vue'
diff --git a/ui/src/views/knowledge-detail/document/index.vue b/ui/src/views/knowledge-detail/document/index.vue
index 7143193fa76..4e7dfab4fc2 100644
--- a/ui/src/views/knowledge-detail/document/index.vue
+++ b/ui/src/views/knowledge-detail/document/index.vue
@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { computed, onMounted, ref } from 'vue'
 import { useRoute } from 'vue-router'
-import type { CascaderOption, UploadFile } from 'element-plus'
+import type { CascaderOption } from 'element-plus'
 import type MkQuickCreate from '@/components/global/mk-table/MkQuickCreate.vue'
 import type { ResourceDetailPageProps } from '@/layout/ResourceDetailLayout.vue'
 import DocumentApi from '@/api/admin/workspace/knowledge/document'
@@ -17,13 +17,23 @@ import type { Dict, DocumentHitHandling, DocumentItem, DocumentTaskType, OptionI
 import { datetimeFormat } from '@/utils/time'
 import { isWorkspaceSharedResource } from '@/utils/resource-context'
 import { numberFormat } from '@/utils/number'
-import { MsgConfirm, MsgInfo, MsgSuccess } from '@/utils/message'
+import { MsgSuccess } from '@/utils/message'
 import DocumentStatus from './components/DocumentStatus.vue'
 import DocumentTags from './components/DocumentTags.vue'
-import ButtonDocumentTask from './components/ButtonDocumentTask.vue'
-import ButtonDocumentSetting from './components/ButtonDocumentSetting.vue'
-import ButtonMigrateDocument from './components/ButtonMigrateDocument.vue'
-import ButtonDocumentTags from './components/ButtonDocumentTags.vue'
+import {
+  CancelDocumentTaskAction,
+  DeleteDocumentAction,
+  DocumentTagsAction,
+  EmbeddingDocumentAction,
+  GenerateDocumentQuestionsAction,
+  DownloadDocumentAction,
+  ExportDocumentAction,
+  MigrateDocumentAction,
+  ReplaceDocumentAction,
+  SettingDocumentAction,
+  SyncDocumentAction,
+  TokenizeDocumentAction,
+} from './action-dropdown'
 import { useKnowledgeDetailContext } from '../context'
 
 defineOptions({ name: 'DocumentListView' })
@@ -34,121 +44,6 @@ const route = useRoute()
 const knowledgeId = computed(() => String(route.params.knowledgeId ?? ''))
 const { knowledge } = useKnowledgeDetailContext()
 
-/* 文档多选：翻页保留选择，查询条件变化时清空。 */
-const documentTableRef = ref<{ clearSelection: () => void }>()
-const selectedDocuments = ref<DocumentItem[]>([])
-const selectedDocumentIds = computed(() => selectedDocuments.value.map(({ id }) => id))
-
-function handleSelectionChange(documents: unknown[]) {
-  selectedDocuments.value = documents as DocumentItem[]
-}
-
-function clearDocumentSelection() {
-  documentTableRef.value?.clearSelection()
-  selectedDocuments.value = []
-}
-
-/* 单项与批量文档操作 */
-const operationLoading = ref(false)
-const canSyncDocuments = computed(() => knowledge.value?.type === KNOWLEDGE_TYPE.WEB || knowledge.value?.type === KNOWLEDGE_TYPE.LARK)
-
-function getSelectedDocuments(document?: DocumentItem) {
-  return document ? [document] : selectedDocuments.value
-}
-
-function isTaskRunning(document: DocumentItem, taskType: DocumentTaskType) {
-  const state = document.status?.at(-taskType)
-  return state === DOCUMENT_TASK_STATE.PENDING || state === DOCUMENT_TASK_STATE.STARTED
-}
-
-function refreshAfterOperation() {
-  clearDocumentSelection()
-  return loadDocuments()
-}
-
-function runDocumentOperation(request: () => Promise<unknown>, refresh = true) {
-  if (operationLoading.value) return Promise.resolve()
-  operationLoading.value = true
-  return request()
-    .then(() => {
-      MsgSuccess('操作成功')
-      if (refresh) return refreshAfterOperation()
-    })
-    .catch(() => {
-      // 请求层统一提示错误，失败保留选择以便重试。
-    })
-    .finally(() => {
-      operationLoading.value = false
-    })
-}
-
-function handleCancelTask(taskType: DocumentTaskType, document?: DocumentItem) {
-  const ids = getSelectedDocuments(document).map(({ id }) => id)
-  if (ids.length) return runDocumentOperation(() => DocumentApi.putBatchCancelDocumentTask(knowledgeId.value, ids, taskType))
-}
-
-function handleTokenize(document?: DocumentItem) {
-  const ids = getSelectedDocuments(document).map(({ id }) => id)
-  if (ids.length) return runDocumentOperation(() => DocumentApi.putBatchTokenizeDocuments(knowledgeId.value, ids, Object.values(DOCUMENT_TASK_STATE)))
-}
-
-function handleChangeActive(document: DocumentItem) {
-  return runDocumentOperation(() => DocumentApi.putDocumentActive(knowledgeId.value, document.id, !document.is_active))
-}
-
-function handleExport(format: 'excel' | 'zip', document?: DocumentItem) {
-  const ids = getSelectedDocuments(document).map(({ id }) => id)
-  if (ids.length) return runDocumentOperation(() => DocumentApi.exportDocuments(knowledgeId.value, ids, format), false)
-}
-
-function handleDownload(document: DocumentItem) {
-  return runDocumentOperation(() => DocumentApi.downloadDocumentSource(knowledgeId.value, document), false)
-}
-
-function handleReplace(file: UploadFile, document: DocumentItem) {
-  if (file.raw) {
-    const sourceFile = file.raw
-    return runDocumentOperation(() => DocumentApi.postReplaceDocumentSource(knowledgeId.value, document.id, sourceFile))
-  }
-}
-
-function handleSync(document?: DocumentItem) {
-  const documents = getSelectedDocuments(document)
-  if (!documents.length || operationLoading.value) return
-  if (document?.type === KNOWLEDGE_TYPE.WEB && !document.meta?.source_url) {
-    MsgInfo('文档没有来源地址，请先在设置中填写文档地址')
-    return
-  }
-  const ids = documents.map(({ id }) => id)
-  return MsgConfirm('同步文档', '同步后将覆盖现有文档内容，是否继续？', { confirmButtonText: '同步' })
-    .then(() => {
-      return runDocumentOperation(() =>
-        knowledge.value?.type === KNOWLEDGE_TYPE.LARK
-          ? DocumentApi.putSyncLarkDocuments(knowledgeId.value, ids)
-          : DocumentApi.putSyncDocuments(knowledgeId.value, ids),
-      )
-    })
-    .catch(() => {})
-}
-
-function handleDelete(document?: DocumentItem) {
-  const documents = getSelectedDocuments(document)
-  if (!documents.length || operationLoading.value) return
-  const ids = documents.map(({ id }) => id)
-  return MsgConfirm(`删除 ${ids.length} 个文档`, '删除后无法恢复，是否继续？')
-    .then(() => {
-      return runDocumentOperation(() => {
-        const request = document
-          ? DocumentApi.deleteDocument(knowledgeId.value, document.id)
-          : DocumentApi.putBatchDeleteDocuments(knowledgeId.value, ids)
-        return request.then(() => {
-          paginationConfig.value.total = Math.max(0, paginationConfig.value.total - ids.length)
-        })
-      })
-    })
-    .catch(() => {})
-}
-
 /* 快速创建 */
 const showQuickCreate = computed(() => knowledge.value?.type === KNOWLEDGE_TYPE.BASE && !isWorkspaceSharedResource())
 const quickCreateRef = ref<InstanceType<typeof MkQuickCreate>>()
@@ -301,6 +196,51 @@ function handleSearchChange(query?: Dict<unknown>) {
   return loadDocuments()
 }
 
+/* 批量操作 */
+const documentTableRef = ref<{ clearSelection: () => void }>()
+const selectedDocuments = ref<DocumentItem[]>([])
+const selectedDocumentIds = computed(() => selectedDocuments.value.map(({ id }) => id))
+
+function handleSelectionChange(documents: unknown[]) {
+  selectedDocuments.value = documents as DocumentItem[]
+}
+
+function clearDocumentSelection() {
+  documentTableRef.value?.clearSelection()
+  selectedDocuments.value = []
+}
+
+/* 单项与批量文档操作 */
+// 共用操作状态，防止重复提交。
+const operationLoading = ref(false)
+
+// 文档启停由服务端结果与列表刷新回显，避免开关提前修改状态。
+function handleChangeActive(document: DocumentItem) {
+  if (operationLoading.value) return false
+  operationLoading.value = true
+  return DocumentApi.putDocumentActive(knowledgeId.value, document.id, !document.is_active)
+    .then(() => {
+      MsgSuccess('操作成功')
+      return refreshAfterOperation().then(() => false)
+    })
+    .catch(() => false)
+    .finally(() => {
+      operationLoading.value = false
+    })
+}
+
+// 按状态字符串中从右起的任务位置，判断任务是否排队或执行中。
+function isTaskRunning(document: DocumentItem, taskType: DocumentTaskType) {
+  const state = document.status?.at(-taskType)
+  return state === DOCUMENT_TASK_STATE.PENDING || state === DOCUMENT_TASK_STATE.STARTED
+}
+
+// 操作成功后清空勾选并刷新文档列表。
+function refreshAfterOperation() {
+  clearDocumentSelection()
+  return loadDocuments()
+}
+
 onMounted(() => {
   loadDocuments()
 })
@@ -415,6 +355,243 @@ onMounted(() => {
     <el-table-column label="创建时间" width="180">
       <template #default="{ row }">{{ datetimeFormat(row.create_time) }}</template>
     </el-table-column>
-
+    <el-table-column v-if="!isWorkspaceSharedResource()" label="操作" width="160" fixed="right">
+      <template #default="{ row }: { row: DocumentItem }">
+        <div class="flex-align-center" @click.stop>
+          <!-- 启用或禁用文档 -->
+          <el-switch :model-value="row.is_active" size="small" :disabled="operationLoading" :before-change="() => handleChangeActive(row)" />
+
+          <el-divider direction="vertical" class="ml-3! mr-2!" />
+
+          <div class="flex">
+            <!-- 向量化或取消向量化 -->
+            <EmbeddingDocumentAction
+              :api="DocumentApi"
+              display="button"
+              :knowledge-id="knowledgeId"
+              :document="row"
+              :document-ids="[row.id]"
+              v-model:loading="operationLoading"
+              @refresh="refreshAfterOperation"
+            />
+            <!-- 分词索引或取消分词索引 -->
+            <TokenizeDocumentAction
+              :api="DocumentApi"
+              :knowledge-id="knowledgeId"
+              v-model:loading="operationLoading"
+              :document="row"
+              :document-ids="[row.id]"
+              @refresh="refreshAfterOperation"
+            />
+            <!-- 更多文档操作 -->
+            <MkTableMoreDropdown persistent>
+              <!-- 文档设置 -->
+              <SettingDocumentAction
+                :api="DocumentApi"
+                :knowledge-id="knowledgeId"
+                :documents="[row]"
+                :disabled="operationLoading"
+                @refresh="refreshAfterOperation"
+              />
+              <!-- 同步文档 -->
+              <SyncDocumentAction
+                :api="DocumentApi"
+                :knowledge-id="knowledgeId"
+                v-model:loading="operationLoading"
+                :documents="[row]"
+                :knowledge-type="knowledge?.type"
+                @refresh="refreshAfterOperation"
+              />
+              <!-- 取消生成问题 -->
+              <CancelDocumentTaskAction
+                :api="DocumentApi"
+                :knowledge-id="knowledgeId"
+                v-model:loading="operationLoading"
+                :document-ids="[row.id]"
+                :task-type="DOCUMENT_TASK_TYPE.GENERATE_PROBLEM"
+                label="取消生成问题"
+                v-if="isTaskRunning(row, DOCUMENT_TASK_TYPE.GENERATE_PROBLEM)"
+                @refresh="refreshAfterOperation"
+              />
+              <!-- 生成问题 -->
+              <GenerateDocumentQuestionsAction
+                :api="DocumentApi"
+                v-else
+                :knowledge-id="knowledgeId"
+                :document-ids="[row.id]"
+                :disabled="operationLoading"
+                @refresh="refreshAfterOperation"
+              />
+              <!-- 设置文档标签 -->
+              <DocumentTagsAction
+                :api="DocumentApi"
+                :knowledge-id="knowledgeId"
+                :document-ids="[row.id]"
+                manage-tags
+                :disabled="operationLoading"
+                @refresh="refreshAfterOperation"
+              />
+              <!-- 迁移文档 -->
+              <MigrateDocumentAction
+                :api="DocumentApi"
+                :knowledge-id="knowledgeId"
+                :document-ids="[row.id]"
+                :disabled="operationLoading"
+                @refresh="refreshAfterOperation"
+              />
+              <!-- 导出文档 Excel -->
+              <ExportDocumentAction
+                :api="DocumentApi"
+                :knowledge-id="knowledgeId"
+                v-model:loading="operationLoading"
+                :document-ids="[row.id]"
+                format="excel"
+              />
+              <!-- 导出文档 ZIP -->
+              <ExportDocumentAction
+                :api="DocumentApi"
+                :knowledge-id="knowledgeId"
+                v-model:loading="operationLoading"
+                :document-ids="[row.id]"
+                format="zip"
+              />
+              <template v-if="knowledge?.type === KNOWLEDGE_TYPE.BASE || knowledge?.type === KNOWLEDGE_TYPE.WORKFLOW">
+                <!-- 下载原文档 -->
+                <DownloadDocumentAction :api="DocumentApi" :knowledge-id="knowledgeId" v-model:loading="operationLoading" :document="row" />
+                <!-- 替换原文档 -->
+                <ReplaceDocumentAction
+                  :api="DocumentApi"
+                  :knowledge-id="knowledgeId"
+                  v-model:loading="operationLoading"
+                  :document="row"
+                  @refresh="refreshAfterOperation"
+                />
+              </template>
+              <!-- 删除文档 -->
+              <DeleteDocumentAction
+                :api="DocumentApi"
+                :knowledge-id="knowledgeId"
+                v-model:loading="operationLoading"
+                :document-ids="[row.id]"
+                @refresh="refreshAfterOperation"
+              />
+            </MkTableMoreDropdown>
+          </div>
+        </div>
+      </template>
+    </el-table-column>
+    <template v-if="!isWorkspaceSharedResource()" #footer-batch-actions>
+      <!-- 批量向量化 -->
+      <EmbeddingDocumentAction
+        :api="DocumentApi"
+        batch
+        :knowledge-id="knowledgeId"
+        :document-ids="selectedDocumentIds"
+        :disabled="operationLoading"
+        @refresh="refreshAfterOperation"
+      />
+      <!-- 批量分词索引 -->
+      <TokenizeDocumentAction
+        :api="DocumentApi"
+        :knowledge-id="knowledgeId"
+        v-model:loading="operationLoading"
+        :document-ids="selectedDocumentIds"
+        batch
+        @refresh="refreshAfterOperation"
+      />
+      <!-- 批量生成问题 -->
+      <GenerateDocumentQuestionsAction
+        :api="DocumentApi"
+        batch
+        :knowledge-id="knowledgeId"
+        :document-ids="selectedDocumentIds"
+        :disabled="operationLoading"
+        @refresh="refreshAfterOperation"
+      />
+      <!-- 更多批量操作 -->
+      <MkTableMoreDropdown persistent>
+        <!-- 批量文档设置 -->
+        <SettingDocumentAction
+          :api="DocumentApi"
+          :knowledge-id="knowledgeId"
+          :documents="selectedDocuments"
+          batch
+          :disabled="operationLoading"
+          @refresh="refreshAfterOperation"
+        />
+        <!-- 批量迁移文档 -->
+        <MigrateDocumentAction
+          :api="DocumentApi"
+          :knowledge-id="knowledgeId"
+          :document-ids="selectedDocumentIds"
+          :disabled="operationLoading"
+          @refresh="refreshAfterOperation"
+        />
+        <!-- 批量添加标签 -->
+        <DocumentTagsAction
+          :api="DocumentApi"
+          :knowledge-id="knowledgeId"
+          :document-ids="selectedDocumentIds"
+          :disabled="operationLoading"
+          @refresh="refreshAfterOperation"
+        />
+        <!-- 批量同步文档 -->
+        <SyncDocumentAction
+          :api="DocumentApi"
+          :knowledge-id="knowledgeId"
+          v-model:loading="operationLoading"
+          :documents="selectedDocuments"
+          :knowledge-type="knowledge?.type"
+          batch
+          @refresh="refreshAfterOperation"
+        />
+        <!-- 批量导出 Excel -->
+        <ExportDocumentAction
+          :api="DocumentApi"
+          :knowledge-id="knowledgeId"
+          v-model:loading="operationLoading"
+          :document-ids="selectedDocumentIds"
+          format="excel"
+        />
+        <!-- 批量导出 ZIP -->
+        <ExportDocumentAction
+          :api="DocumentApi"
+          :knowledge-id="knowledgeId"
+          v-model:loading="operationLoading"
+          :document-ids="selectedDocumentIds"
+          format="zip"
+        />
+        <!-- 批量取消向量化 -->
+        <CancelDocumentTaskAction
+          :api="DocumentApi"
+          :knowledge-id="knowledgeId"
+          v-model:loading="operationLoading"
+          :document-ids="selectedDocumentIds"
+          :task-type="DOCUMENT_TASK_TYPE.EMBEDDING"
+          label="取消向量化"
+          divided
+          @refresh="refreshAfterOperation"
+        />
+        <!-- 批量取消生成问题 -->
+        <CancelDocumentTaskAction
+          :api="DocumentApi"
+          :knowledge-id="knowledgeId"
+          v-model:loading="operationLoading"
+          :document-ids="selectedDocumentIds"
+          :task-type="DOCUMENT_TASK_TYPE.GENERATE_PROBLEM"
+          label="取消生成问题"
+          @refresh="refreshAfterOperation"
+        />
+        <!-- 批量删除文档 -->
+        <DeleteDocumentAction
+          :api="DocumentApi"
+          :knowledge-id="knowledgeId"
+          v-model:loading="operationLoading"
+          :document-ids="selectedDocumentIds"
+          batch
+          @refresh="refreshAfterOperation"
+        />
+      </MkTableMoreDropdown>
+    </template>
   </MkTable>
 </template>
diff --git a/ui/src/views/system/chat-management/users/index.vue b/ui/src/views/system/chat-management/users/index.vue
index aa41575faaa..e45d0ad09d2 100644
--- a/ui/src/views/system/chat-management/users/index.vue
+++ b/ui/src/views/system/chat-management/users/index.vue
@@ -207,7 +207,7 @@ onMounted(() => loadChatUsers())
         </el-table-column>
         <el-table-column label="操作" width="160" fixed="right">
           <template #default="{ row }">
-            <div class="flex-align-center gap-3">
+            <div class="flex-align-center">
               <!-- 修改状态 -->
               <el-switch
                 v-model="row.is_active"
@@ -215,8 +215,7 @@ onMounted(() => loadChatUsers())
                 :disabled="!perm.system.chatUser.edit()"
                 :before-change="() => handleChangeStatus(row)"
               />
-
-              <el-divider direction="vertical" />
+              <el-divider direction="vertical" class="ml-3! mr-2!" />
 
               <div class="flex">
                 <!-- 编辑 -->
diff --git a/ui/src/views/system/identity/users/index.vue b/ui/src/views/system/identity/users/index.vue
index 97c94e11ff0..494aae3e360 100644
--- a/ui/src/views/system/identity/users/index.vue
+++ b/ui/src/views/system/identity/users/index.vue
@@ -215,7 +215,7 @@ onMounted(() => loadSystemUsers())
         </el-table-column>
         <el-table-column label="操作" width="160" fixed="right">
           <template #default="{ row }">
-            <div class="flex-align-center gap-3">
+            <div class="flex-align-center">
               <!-- 修改状态 -->
               <el-switch
                 v-model="row.is_active"
@@ -223,7 +223,7 @@ onMounted(() => loadSystemUsers())
                 :before-change="() => handleChangeStatus(row)"
                 size="small"
               />
-              <el-divider direction="vertical" />
+              <el-divider direction="vertical" class="ml-3! mr-2!" />
 
               <div class="flex">
                 <!-- 编辑 -->
diff --git a/ui/src/views/system/resource-management/model/index.vue b/ui/src/views/system/resource-management/model/index.vue
index 66d6c412180..3d319e9c2a2 100644
--- a/ui/src/views/system/resource-management/model/index.vue
+++ b/ui/src/views/system/resource-management/model/index.vue
@@ -150,7 +150,7 @@ onMounted(() => {
         </el-table-column>
         <el-table-column label="操作" width="120" fixed="right">
           <template #default="{ row }">
-            <div class="flex-align-center gap-1">
+            <div class="flex-align-center">
               <!-- 编辑模型 -->
               <EditModelAction
                 display="button"
diff --git a/ui/src/views/system/resource-management/tool/index.vue b/ui/src/views/system/resource-management/tool/index.vue
index 9f97dc2b4c8..74820ffe766 100644
--- a/ui/src/views/system/resource-management/tool/index.vue
+++ b/ui/src/views/system/resource-management/tool/index.vue
@@ -175,9 +175,10 @@ onMounted(() => {
         </el-table-column>
         <el-table-column label="操作" width="140" fixed="right">
           <template #default="{ row }">
-            <div class="flex-align-center gap-1">
+            <div class="flex-align-center">
               <!-- 启用或禁用工具 -->
-              <ToolStatusSwitch class="mr-1!" v-model:loading="operationLoading" :api="SystemToolApi" :tool="row" @update="handleToolUpdate" />
+              <ToolStatusSwitch v-model:loading="operationLoading" :api="SystemToolApi" :tool="row" @update="handleToolUpdate" />
+              <el-divider direction="vertical" class="ml-3! mr-2!" />
               <!-- 编辑工具配置 -->
               <EditToolAction display="button" label="编辑" :api="SystemToolApi" :tool="row" @update="handleToolUpdate" />
               <!-- 更多工具操作 -->
diff --git a/ui/src/views/system/shared-resources/tool/index.vue b/ui/src/views/system/shared-resources/tool/index.vue
index 7ccc2f423c2..3f02f2fb632 100644
--- a/ui/src/views/system/shared-resources/tool/index.vue
+++ b/ui/src/views/system/shared-resources/tool/index.vue
@@ -10,6 +10,7 @@ import type { Dict, OptionItem, ToolItem, ToolType } from '@/api/types'
 import { TOOL_TYPE } from '@/api/enums'
 import { TOOL_TYPE_OPTIONS } from '@/constants'
 import ToolCard from '@/views/tool/tool-card/ToolCard.vue'
+import ToolStatusSwitch from '@/views/tool/tool-card/ToolStatusSwitch.vue'
 import ButtonCreateTool from '@/views/tool/components/ButtonCreateTool.vue'
 import {
   RelatedResourcesToolAction,
@@ -111,13 +112,17 @@ function handleOpenWorkflow(tool: ToolItem, event: MouseEvent) {
             <template v-for="tool in toolsData" :key="tool.id">
               <ToolCard
                 v-model:loading="toolOperationLoading"
-                :api="SystemSharedToolApi"
                 :tool="tool"
                 :shared="true"
                 :store-tools="[]"
                 @click="handleOpenTool(tool, $event)"
                 @update="handleToolUpdate"
               >
+                <template #actions>
+                  <!-- 修改工具状态 -->
+                  <ToolStatusSwitch v-model:loading="toolOperationLoading" :api="SystemSharedToolApi" :tool="tool" @update="handleToolUpdate" />
+                  <el-divider direction="vertical" class="ml-1!" />
+                </template>
                 <template #action-dropdown>
                   <!-- 编辑共享工具 -->
                   <EditToolAction
diff --git a/ui/src/views/tool/index.vue b/ui/src/views/tool/index.vue
index 70d1d326077..d661ffab904 100644
--- a/ui/src/views/tool/index.vue
+++ b/ui/src/views/tool/index.vue
@@ -16,6 +16,7 @@ import FolderTree from '@/components/business/folder-tree/index.vue'
 import MoveToDialog from '@/components/business/folder-tree/MoveToDialog.vue'
 import { MsgConfirm, MsgSuccess } from '@/utils/message'
 import ToolCard from './tool-card/ToolCard.vue'
+import ToolStatusSwitch from './tool-card/ToolStatusSwitch.vue'
 import {
   AuthorizeToolAction,
   RelatedResourcesToolAction,
@@ -214,7 +215,7 @@ onMounted(() => {
         </MkTooltip>
       </component>
 
-      <FolderTree ref="folderTreeRef" :source="RESOURCE_TYPE.TOOL" @select="handleFolderSelect" draggable> </FolderTree>
+      <FolderTree ref="folderTreeRef" :source="RESOURCE_TYPE.TOOL" @select="handleFolderSelect" draggable></FolderTree>
     </template>
 
     <template #default="{ Footer, Header }">
@@ -252,7 +253,6 @@ onMounted(() => {
             <template v-for="tool in toolsData" :key="tool.id">
               <ToolCard
                 v-model:loading="toolOperationLoading"
-                :api="ToolApi"
                 :disabled="isShared"
                 :selectable="batchSelectionMode"
                 :selected="selectedToolIds.includes(tool.id)"
@@ -263,6 +263,11 @@ onMounted(() => {
                 @selected="handleToolSelect(tool.id, $event)"
                 @update="handleToolUpdate"
               >
+                <template #actions>
+                  <!-- 修改工具状态 -->
+                  <ToolStatusSwitch v-model:loading="toolOperationLoading" :api="ToolApi" :tool="tool" @update="handleToolUpdate" />
+                  <el-divider direction="vertical" class="ml-1!"/>
+                </template>
                 <template #action-dropdown>
                   <!-- 编辑工具 -->
                   <EditToolAction
diff --git a/ui/src/views/tool/tool-card/ToolCard.vue b/ui/src/views/tool/tool-card/ToolCard.vue
index b32642e404c..041982d9d5e 100644
--- a/ui/src/views/tool/tool-card/ToolCard.vue
+++ b/ui/src/views/tool/tool-card/ToolCard.vue
@@ -1,14 +1,10 @@
 <script setup lang="ts">
-import type ToolApi from '@/api/admin/workspace/tool/tool'
-import type SystemSharedToolApi from '@/api/admin/system/shared-resources/tool/tool'
 import type { ToolItem, ToolStoreResponse } from '@/api/types'
-import ToolStatusSwitch from './ToolStatusSwitch.vue'
 import ButtonUpdateVersion from './ButtonUpdateVersion.vue'
 
 defineOptions({ name: 'ToolCard' })
 
 const props = defineProps<{
-  api: typeof ToolApi | typeof SystemSharedToolApi
   disabled?: boolean
   selectable?: boolean
   selected?: boolean
@@ -66,8 +62,7 @@ function handleClick(event: MouseEvent) {
     <template #footer="{ Action, ActionDropdown }">
       <MkStatusLabel :active="tool.is_active" class="text-N600!" />
       <component :is="Action" v-if="!disabled">
-        <!-- 修改工具状态 -->
-        <ToolStatusSwitch v-model:loading="loading" :api="api" :tool="tool" @update="emit('update', $event)" />
+        <slot name="actions" />
         <component :is="ActionDropdown">
           <slot name="action-dropdown" />
         </component>
diff --git a/ui/src/views/tool/tool-card/ToolStatusSwitch.vue b/ui/src/views/tool/tool-card/ToolStatusSwitch.vue
index 93bb60933ac..af5ef79e42e 100644
--- a/ui/src/views/tool/tool-card/ToolStatusSwitch.vue
+++ b/ui/src/views/tool/tool-card/ToolStatusSwitch.vue
@@ -73,10 +73,7 @@ function updateToolStatus(active: boolean) {
 </script>
 
 <template>
-  <div class="flex-align-center" v-bind="$attrs">
-    <el-switch :disabled="loading" :model-value="tool.is_active" class="mr-3" size="small" :before-change="handleToolStatusChange" />
-    <el-divider direction="vertical" />
-  </div>
+  <el-switch :disabled="loading" :model-value="tool.is_active" size="small" :before-change="handleToolStatusChange" v-bind="$attrs" />
 
   <InitParamDialog ref="initParamDialogRef" :api="api" @update="emit('update', $event)" />
 </template>
diff --git a/ui/src/views/trigger/index.vue b/ui/src/views/trigger/index.vue
index 5e00f53c290..eac5609f82b 100644
--- a/ui/src/views/trigger/index.vue
+++ b/ui/src/views/trigger/index.vue
@@ -201,11 +201,11 @@ onMounted(() => loadTriggers())
         </el-table-column>
         <el-table-column label="操作" width="160" fixed="right">
           <template #default="{ row }">
-            <div class="flex-align-center gap-3">
+            <div class="flex-align-center">
               <!-- 修改触发器状态 -->
 
               <el-switch v-model="row.is_active" :disabled="!perm.trigger.edit()" :before-change="() => handleChangeStatus(row)" size="small" />
-              <el-divider direction="vertical" />
+              <el-divider direction="vertical" class="ml-3! mr-2!" />
 
               <div class="flex">
                 <!-- 编辑当前触发器 -->