From be7a6e982f1dc576b1626236ac2bb6da18a64383 Mon Sep 17 00:00:00 2001
From: wangdan-fit2cloud <dan.wang@fit2cloud.com>
Date: Wed, 30 Sep 2026 16:11:21 +0800
Subject: [PATCH] feat: document

---
 .../api/admin/workspace/knowledge/document.ts |  6 +-
 .../GenerateQuestionsDialog.vue               |  2 +-
 .../items/knowledge/Knowledge.vue             |  4 +-
 ui/src/views/VIEW_README.md                   | 14 ++-
 .../action-dropdown/DocumentTagsAction.vue    |  2 +-
 .../action-dropdown/MigrateDocumentAction.vue | 82 ----------------
 .../library/document/action-dropdown/index.ts |  5 +-
 .../migrate/DocumentMigrateDialog.vue         | 93 +++++++++++++++++++
 .../migrate/MigrateDocumentAction.vue         | 38 ++++++++
 .../setting/BatchSettingDocumentAction.vue    | 55 +++++++++++
 .../DocumentSettingDialog.vue}                | 59 ++++--------
 .../setting/SettingDocumentAction.vue         | 63 +++++++++++++
 .../library/document/index.vue                | 53 +++++++----
 .../views/knowledge-detail/setting/index.vue  | 14 +--
 14 files changed, 329 insertions(+), 161 deletions(-)
 delete mode 100644 ui/src/views/knowledge-detail/library/document/action-dropdown/MigrateDocumentAction.vue
 create mode 100644 ui/src/views/knowledge-detail/library/document/action-dropdown/migrate/DocumentMigrateDialog.vue
 create mode 100644 ui/src/views/knowledge-detail/library/document/action-dropdown/migrate/MigrateDocumentAction.vue
 create mode 100644 ui/src/views/knowledge-detail/library/document/action-dropdown/setting/BatchSettingDocumentAction.vue
 rename ui/src/views/knowledge-detail/library/document/action-dropdown/{SettingDocumentAction.vue => setting/DocumentSettingDialog.vue} (62%)
 create mode 100644 ui/src/views/knowledge-detail/library/document/action-dropdown/setting/SettingDocumentAction.vue

diff --git a/ui/src/api/admin/workspace/knowledge/document.ts b/ui/src/api/admin/workspace/knowledge/document.ts
index 42f19550dac..ae7b263784d 100644
--- a/ui/src/api/admin/workspace/knowledge/document.ts
+++ b/ui/src/api/admin/workspace/knowledge/document.ts
@@ -75,15 +75,15 @@ const putLarkDocumentSync = (knowledgeId: string, documentId: string) =>
 const putMulLarkSyncDocument = (knowledgeId: string, documentIds: string[]) =>
   put<{ id_list: string[] }, boolean>(`/workspace/${getWorkspaceId()}/knowledge/lark/${knowledgeId}/_batch`, { id_list: documentIds })
 
-/** 保存单个文档的召回及来源设置。 */
+/** 单个文档设置。 */
 const putDocumentSetting = (knowledgeId: string, documentId: string, data: DocumentSettingPayload) =>
   put(`${getPrefix(knowledgeId)}/${documentId}`, data)
 
-/** 批量保存文档召回设置。 */
+/** 批量文档设置。 */
 const putBatchDocumentSetting = (knowledgeId: string, documentIds: string[], data: DocumentSettingPayload) =>
   put(`${getPrefix(knowledgeId)}/batch_hit_handling`, { ...data, id_list: documentIds })
 
-/** 将选中文档迁移至目标知识库。 */
+/** 批量/单个迁移至目标知识库。 */
 const putMigrateDocuments = (knowledgeId: string, targetKnowledgeId: string, documentIds: string[]) =>
   put(`${getPrefix(knowledgeId)}/migrate/${targetKnowledgeId}`, documentIds)
 
diff --git a/ui/src/components/business/generate-questions/GenerateQuestionsDialog.vue b/ui/src/components/business/generate-questions/GenerateQuestionsDialog.vue
index bcc7f9012df..c18a8ce06b4 100644
--- a/ui/src/components/business/generate-questions/GenerateQuestionsDialog.vue
+++ b/ui/src/components/business/generate-questions/GenerateQuestionsDialog.vue
@@ -95,7 +95,7 @@ defineExpose({ open, close })
 
 <template>
   <MkDialog v-model="visible" title="生成问题" @closed="emit('closed')">
-    <el-form ref="formRef" :model="form" label-position="top" v-loading="loading || modelLoading" @submit.prevent>
+    <el-form ref="formRef" :model="form" label-position="top" require-asterisk-position="right" v-loading="loading || modelLoading" @submit.prevent>
       <el-alert :closable="false" :title="promptTip" type="primary" class="mb-4! items-start! whitespace-pre-line" show-icon>
         <template #icon><MkIcon name="icon_info_filled" class="mt-2" /></template>
       </el-alert>
diff --git a/ui/src/components/mk-dynamics-form/items/knowledge/Knowledge.vue b/ui/src/components/mk-dynamics-form/items/knowledge/Knowledge.vue
index 2359e206c82..8ee485f4b71 100644
--- a/ui/src/components/mk-dynamics-form/items/knowledge/Knowledge.vue
+++ b/ui/src/components/mk-dynamics-form/items/knowledge/Knowledge.vue
@@ -35,8 +35,8 @@ const selectedKnowledgeIds = computed({
         </div>
       </el-option>
       <template #label="{ label, value }">
-        <span class="inline-flex max-w-full items-center gap-2">
-          <KnowledgeIcon :type="knowledgeById.get(value)?.type" :size="14" class="shrink-0" style="--el-avatar-border-radius: 4px" />
+        <span class="flex-align-center gap-2">
+          <KnowledgeIcon :type="knowledgeById.get(value)?.type" :size="16" class="shrink-0 small" />
           <span class="truncate" :title="label">{{ label }}</span>
         </span>
       </template>
diff --git a/ui/src/views/VIEW_README.md b/ui/src/views/VIEW_README.md
index 04fb7e72599..9f720782948 100644
--- a/ui/src/views/VIEW_README.md
+++ b/ui/src/views/VIEW_README.md
@@ -717,6 +717,10 @@ Web 来源地址与选择器仅在单项设置中编辑，批量设置不展示
 `MigrateDocumentAction` 选择目标知识库，`DocumentTagsAction` 添加已有标签和移除文档标签关联；
 生成问题复用公共配置弹窗，其余 Action 按下文维护各自专属弹窗。组件接收完整 Document API、知识库 ID、文档 ID 或文档数组及禁用状态，
 点击时快照本次操作对象，内部管理弹窗和请求，成功后通过 `refresh` 通知页面刷新，失败保留输入。
+迁移操作集中在 `document/action-dropdown/migrate/`，`MigrateDocumentAction.vue` 负责入口与弹窗按需挂载，
+`DocumentMigrateDialog.vue` 负责目标知识库查询、选择及迁移请求；关闭动画结束后卸载，失败保留输入。
+Action 继续通过上层 `action-dropdown/index.ts` 导出，单项与批量入口共用；入口文案由必填 `label` 传入，
+图标由可选 `icon` 传入，不传时不显示图标。
 单项向量化仅传 `document`，内部判断排队或执行状态，固定展示行内图标按钮，分别调用单项向量化和取消接口。
 批量向量化仅传 `document-ids`，使用独立的 `BatchEmbeddingAction` 普通按钮；
 批量取消向量化继续使用 `BatchCancelTaskAction` 菜单项，单项和批量请求均通过 `v-model:loading` 共用页面操作状态。
@@ -730,7 +734,15 @@ Action 仍通过上层 `action-dropdown/index.ts` 导出，弹窗仅在目录内
 提交同一文档批量接口并通过 `refresh` 刷新状态；通过 `v-model:loading` 复用页面操作状态。
 公共弹窗按需挂载、关闭后卸载，不负责选择提交接口。当前尚无段落页，后续段落入口复用公共
 弹窗时关闭 `showParagraphScope`，由段落 Action 提交段落接口，不扩展公共弹窗的接口分支。
-设置组件通过 `batch` 区分单项与批量，标签组件通过 `manageTags` 区分标签管理与批量添加。
+设置操作集中在 `document/action-dropdown/setting/`，通过上层 `index.ts` 导出两个入口。
+`SettingDocumentAction` 接收单个 `document`，展示菜单项；`BatchSettingDocumentAction` 接收
+`documentIds`，展示批量设置按钮。入口文案由 `label` 传入，单项图标由可选 `icon` 传入。
+两个入口通过 `v-model:loading` 共用页面操作状态，打开时固定操作目标，分别调用单项和批量设置接口。
+共用的 `DocumentSettingDialog.vue` 负责表单回填、校验和提交数据，按需挂载、关闭动画结束后卸载；
+弹窗通过 `batch` 参数区分批量模式，批量入口显式传入；文档地址和选择器仅在 `!batch` 且为 Web 知识库时显示。
+单项保留文档原有 `meta`，批量使用默认配置并将 `allow_download`
+放在顶层。请求与成功关闭由 Action 负责，成功通知页面刷新，失败保留表单。
+标签组件通过 `manageTags` 区分标签管理与批量添加。
 分词索引集中在 `document/action-dropdown/tokenize/`：`TokenizeDocumentAction` 接收单个 `document`，
 按运行状态调用单项分词或取消接口；`BatchTokenizeAction` 接收 `documentIds`，仅调用批量分词接口。
 两个 Action 均处理全部分段状态，通过 `v-model:loading` 共用页面操作状态，成功后通知页面刷新。
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
index 68a916d8b4a..5dfb3bf4bdb 100644
--- a/ui/src/views/knowledge-detail/library/document/action-dropdown/DocumentTagsAction.vue
+++ b/ui/src/views/knowledge-detail/library/document/action-dropdown/DocumentTagsAction.vue
@@ -104,7 +104,7 @@ function handleClosed() {
     @click="handleOpenDialog"
   />
   <MkDialog v-model="visible" :title="manage ? '标签设置' : '添加标签'" :show-close="!loading && !optionLoading" @closed="handleClosed">
-    <el-form label-position="top" @submit.prevent>
+    <el-form label-position="top" require-asterisk-position="right" @submit.prevent>
       <el-form-item label="标签">
         <el-select
           v-model="selectedTagIds"
diff --git a/ui/src/views/knowledge-detail/library/document/action-dropdown/MigrateDocumentAction.vue b/ui/src/views/knowledge-detail/library/document/action-dropdown/MigrateDocumentAction.vue
deleted file mode 100644
index 324e9c82b21..00000000000
--- a/ui/src/views/knowledge-detail/library/document/action-dropdown/MigrateDocumentAction.vue
+++ /dev/null
@@ -1,82 +0,0 @@
-<script setup lang="ts">
-import { ref } from 'vue'
-import type { KnowledgeItem } from '@/api/types'
-import KnowledgeApi from '@/api/admin/workspace/knowledge/knowledge'
-import type DocumentApi from '@/api/admin/workspace/knowledge/document'
-import { MsgSuccess } from '@/utils/message'
-
-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)
-const optionLoading = ref(false)
-const knowledgeOptions = ref<KnowledgeItem[]>([])
-const targetKnowledgeId = ref('')
-const targetDocumentIds = ref<string[]>([])
-
-function handleOpenDialog() {
-  if (props.disabled || loading.value || optionLoading.value || !props.documentIds.length) return
-  const ids = props.documentIds
-  targetDocumentIds.value = [...ids]
-  targetKnowledgeId.value = ''
-  visible.value = true
-  optionLoading.value = true
-  KnowledgeApi.getAllKnowledge()
-    .then((knowledge) => {
-      knowledgeOptions.value = knowledge.filter(({ id }) => id !== props.knowledgeId)
-    })
-    .catch(() => {
-      // 请求层统一提示错误，保留当前输入。
-    })
-    .finally(() => {
-      optionLoading.value = false
-    })
-}
-
-function handleSubmit() {
-  if (!targetKnowledgeId.value || loading.value) return
-  loading.value = true
-  return props.api
-    .putMigrateDocuments(props.knowledgeId, targetKnowledgeId.value, targetDocumentIds.value)
-    .then(() => {
-      MsgSuccess('迁移成功')
-      visible.value = false
-      emit('refresh')
-    })
-    .catch(() => {
-      // 请求层统一提示错误，保留当前输入。
-    })
-    .finally(() => {
-      loading.value = false
-    })
-}
-
-function handleClosed() {
-  targetKnowledgeId.value = ''
-  targetDocumentIds.value = []
-  knowledgeOptions.value = []
-}
-</script>
-
-<template>
-  <!-- 文档迁移入口 -->
-  <MkAction label="迁移" icon="icon_move2_outlined" :disabled="disabled || loading || !documentIds.length" @click="handleOpenDialog" />
-  <MkDialog v-model="visible" title="迁移文档" :show-close="!loading && !optionLoading" @closed="handleClosed">
-    <el-form label-position="top" @submit.prevent>
-      <el-form-item label="目标知识库" required>
-        <el-select v-model="targetKnowledgeId" filterable placeholder="请选择知识库" :loading="optionLoading" :disabled="loading">
-          <template v-for="target in knowledgeOptions" :key="target.id">
-            <el-option :label="target.name" :value="target.id" />
-          </template>
-        </el-select>
-      </el-form-item>
-    </el-form>
-    <template #footer>
-      <!-- 取消文档迁移 -->
-      <el-button :disabled="loading || optionLoading" @click="visible = false">取消</el-button>
-      <!-- 确认迁移文档 -->
-      <el-button type="primary" :loading="loading" :disabled="!targetKnowledgeId || optionLoading" @click="handleSubmit">确认</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 111c587865c..4c981687feb 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
@@ -8,9 +8,10 @@ export { default as BatchGenerateQuestionsAction } from './generate-questions/Ba
 export { default as DownloadDocumentAction } from './DownloadDocumentAction.vue'
 export { default as ExportDocumentAction } from './export/ExportDocumentAction.vue'
 export { default as BatchExportDocumentAction } from './export/BatchExportDocumentAction.vue'
-export { default as MigrateDocumentAction } from './MigrateDocumentAction.vue'
+export { default as MigrateDocumentAction } from './migrate/MigrateDocumentAction.vue'
 export { default as ReplaceDocumentAction } from './ReplaceDocumentAction.vue'
-export { default as SettingDocumentAction } from './SettingDocumentAction.vue'
+export { default as SettingDocumentAction } from './setting/SettingDocumentAction.vue'
+export { default as BatchSettingDocumentAction } from './setting/BatchSettingDocumentAction.vue'
 export { default as SyncDocumentAction } from './sync/SyncDocumentAction.vue'
 export { default as BatchSyncDocumentAction } from './sync/BatchSyncDocumentAction.vue'
 export { default as TokenizeDocumentAction } from './tokenize/TokenizeDocumentAction.vue'
diff --git a/ui/src/views/knowledge-detail/library/document/action-dropdown/migrate/DocumentMigrateDialog.vue b/ui/src/views/knowledge-detail/library/document/action-dropdown/migrate/DocumentMigrateDialog.vue
new file mode 100644
index 00000000000..0d9507aa05e
--- /dev/null
+++ b/ui/src/views/knowledge-detail/library/document/action-dropdown/migrate/DocumentMigrateDialog.vue
@@ -0,0 +1,93 @@
+<script setup lang="ts">
+import { computed, reactive, ref, useTemplateRef } from 'vue'
+import type { FormInstance, FormRules } from 'element-plus'
+import type { KnowledgeItem } from '@/api/types'
+import KnowledgeApi from '@/api/admin/workspace/knowledge/knowledge'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
+import { MsgSuccess } from '@/utils/message'
+
+defineOptions({ name: 'DocumentMigrateDialog' })
+const props = defineProps<{ api: typeof DocumentApi; knowledgeId: string }>()
+const emit = defineEmits<{ refresh: []; closed: [] }>()
+const visible = ref(false)
+const loading = defineModel<boolean>('loading', { default: false })
+const optionLoading = ref(false)
+const knowledgeOptions = ref<KnowledgeItem[]>([])
+const knowledgeById = computed(() => new Map(knowledgeOptions.value.map((knowledge) => [knowledge.id, knowledge])))
+const migrateFormRef = useTemplateRef<FormInstance>('migrateFormRef')
+const migrateForm = reactive({ targetKnowledgeId: '' })
+const migrateRules: FormRules<typeof migrateForm> = {
+  targetKnowledgeId: [{ required: true, message: '请选择知识库', trigger: 'change' }],
+}
+const targetDocumentIds = ref<string[]>([])
+
+// 打开迁移弹窗，固定本次文档并查询目标知识库。
+function open(documentIds: string[]) {
+  if (loading.value || optionLoading.value || !documentIds.length) return
+  targetDocumentIds.value = [...documentIds]
+  visible.value = true
+  optionLoading.value = true
+  KnowledgeApi.getAllKnowledge()
+    .then((knowledge) => {
+      knowledgeOptions.value = knowledge.filter(({ id }) => id !== props.knowledgeId)
+    })
+    .catch(() => {
+      // 请求层统一提示错误，保留当前输入。
+    })
+    .finally(() => {
+      optionLoading.value = false
+    })
+}
+
+// 迁移成功后关闭并通知页面刷新，失败保留选择。
+async function handleSubmit() {
+  if (loading.value || optionLoading.value || !(await migrateFormRef.value?.validate().catch(() => false))) return
+  loading.value = true
+  return props.api
+    .putMigrateDocuments(props.knowledgeId, migrateForm.targetKnowledgeId, targetDocumentIds.value)
+    .then(() => {
+      MsgSuccess('迁移成功')
+      visible.value = false
+      emit('refresh')
+    })
+    .catch(() => {
+      // 请求层统一提示错误，保留当前输入。
+    })
+    .finally(() => {
+      loading.value = false
+    })
+}
+
+defineExpose({ open })
+</script>
+
+<template>
+  <MkDialog v-model="visible" title="文档迁移到" @closed="emit('closed')">
+    <el-form ref="migrateFormRef" :model="migrateForm" :rules="migrateRules" label-position="top" require-asterisk-position="right" @submit.prevent>
+      <el-form-item label="选择知识库" prop="targetKnowledgeId">
+        <el-select v-model="migrateForm.targetKnowledgeId" fit-input-width filterable placeholder="请选择知识库" :loading="optionLoading">
+          <template v-for="target in knowledgeOptions" :key="target.id">
+            <el-option :label="target.name" :value="target.id">
+              <div class="flex-align-center min-w-0 gap-2">
+                <KnowledgeIcon :type="target.type" :size="20" class="shrink-0" />
+                <span class="truncate" :title="target.name">{{ target.name }}</span>
+              </div>
+            </el-option>
+          </template>
+          <template #label="{ label, value }">
+            <span class="flex-align-center gap-2">
+              <KnowledgeIcon :type="knowledgeById.get(value)?.type" :size="20" class="shrink-0" />
+              <span class="truncate" :title="label">{{ label }}</span>
+            </span>
+          </template>
+        </el-select>
+      </el-form-item>
+    </el-form>
+    <template #footer>
+      <!-- 取消文档迁移 -->
+      <el-button plain :disabled="loading || optionLoading" @click="visible = false">取消</el-button>
+      <!-- 确认迁移文档 -->
+      <el-button type="primary" :loading="loading" :disabled="optionLoading" @click="handleSubmit">确认</el-button>
+    </template>
+  </MkDialog>
+</template>
diff --git a/ui/src/views/knowledge-detail/library/document/action-dropdown/migrate/MigrateDocumentAction.vue b/ui/src/views/knowledge-detail/library/document/action-dropdown/migrate/MigrateDocumentAction.vue
new file mode 100644
index 00000000000..a35e0bf96c2
--- /dev/null
+++ b/ui/src/views/knowledge-detail/library/document/action-dropdown/migrate/MigrateDocumentAction.vue
@@ -0,0 +1,38 @@
+<script setup lang="ts">
+import { nextTick, ref, useTemplateRef } from 'vue'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
+import DocumentMigrateDialog from './DocumentMigrateDialog.vue'
+
+defineOptions({ name: 'MigrateDocumentAction' })
+const props = defineProps<{ api: typeof DocumentApi; knowledgeId: string; documentIds: string[]; label: string; icon?: string; disabled?: boolean }>()
+const emit = defineEmits<{ refresh: [] }>()
+const loading = ref(false)
+
+// 迁移弹窗按需挂载，关闭动画结束后卸载。
+const dialogMounted = ref(false)
+const migrateDialogRef = useTemplateRef<InstanceType<typeof DocumentMigrateDialog>>('migrateDialogRef')
+
+function handleOpenDialog() {
+  const documentIds = [...props.documentIds]
+  dialogMounted.value = true
+  return nextTick(() => migrateDialogRef.value?.open(documentIds))
+}
+
+function handleDialogClosed() {
+  dialogMounted.value = false
+}
+</script>
+
+<template>
+  <!-- 文档迁移入口 -->
+  <MkAction :label="label" :icon="icon" :disabled="disabled || loading" @click="handleOpenDialog" />
+  <DocumentMigrateDialog
+    v-if="dialogMounted"
+    ref="migrateDialogRef"
+    v-model:loading="loading"
+    :api="api"
+    :knowledge-id="knowledgeId"
+    @refresh="emit('refresh')"
+    @closed="handleDialogClosed"
+  />
+</template>
diff --git a/ui/src/views/knowledge-detail/library/document/action-dropdown/setting/BatchSettingDocumentAction.vue b/ui/src/views/knowledge-detail/library/document/action-dropdown/setting/BatchSettingDocumentAction.vue
new file mode 100644
index 00000000000..72ea2ab2bec
--- /dev/null
+++ b/ui/src/views/knowledge-detail/library/document/action-dropdown/setting/BatchSettingDocumentAction.vue
@@ -0,0 +1,55 @@
+<script setup lang="ts">
+import { nextTick, ref, useTemplateRef } from 'vue'
+import type { DocumentSettingPayload } from '@/api/types'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
+import { MsgSuccess } from '@/utils/message'
+import DocumentSettingDialog from './DocumentSettingDialog.vue'
+
+defineOptions({ name: 'BatchSettingDocumentAction' })
+const props = defineProps<{ api: typeof DocumentApi; knowledgeId: string; documentIds: string[]; label: string; disabled?: boolean }>()
+const loading = defineModel<boolean>('loading', { default: false })
+const emit = defineEmits<{ refresh: [] }>()
+
+// 打开设置时固定操作对象，弹窗关闭后卸载。
+const dialogMounted = ref(false)
+const settingDialogRef = useTemplateRef<InstanceType<typeof DocumentSettingDialog>>('settingDialogRef')
+const targetKnowledgeId = ref('')
+const targetDocumentIds = ref<string[]>([])
+
+function handleOpenDialog() {
+  if (props.disabled || loading.value || dialogMounted.value || !props.documentIds.length) return
+  targetKnowledgeId.value = props.knowledgeId
+  targetDocumentIds.value = [...props.documentIds]
+  dialogMounted.value = true
+  return nextTick(() => settingDialogRef.value?.open())
+}
+
+// 设置成功后关闭弹窗并刷新列表，失败保留表单。
+function handleSubmit(data: DocumentSettingPayload) {
+  if (loading.value) return
+  loading.value = true
+  return props.api
+    .putBatchDocumentSetting(targetKnowledgeId.value, targetDocumentIds.value, data)
+    .then(() => {
+      MsgSuccess('设置成功')
+      settingDialogRef.value?.close()
+      emit('refresh')
+    })
+    .catch(() => {
+      // 请求层统一提示错误，保留当前输入。
+    })
+    .finally(() => {
+      loading.value = false
+    })
+}
+
+function handleDialogClosed() {
+  dialogMounted.value = false
+}
+</script>
+
+<template>
+  <!-- 批量文档设置 -->
+  <el-button plain :disabled="disabled || loading" @click="handleOpenDialog">{{ label }}</el-button>
+  <DocumentSettingDialog v-if="dialogMounted" ref="settingDialogRef" batch :loading="loading" @submit="handleSubmit" @closed="handleDialogClosed" />
+</template>
diff --git a/ui/src/views/knowledge-detail/library/document/action-dropdown/SettingDocumentAction.vue b/ui/src/views/knowledge-detail/library/document/action-dropdown/setting/DocumentSettingDialog.vue
similarity index 62%
rename from ui/src/views/knowledge-detail/library/document/action-dropdown/SettingDocumentAction.vue
rename to ui/src/views/knowledge-detail/library/document/action-dropdown/setting/DocumentSettingDialog.vue
index 9a2448e0f95..329eaee61c0 100644
--- a/ui/src/views/knowledge-detail/library/document/action-dropdown/SettingDocumentAction.vue
+++ b/ui/src/views/knowledge-detail/library/document/action-dropdown/setting/DocumentSettingDialog.vue
@@ -4,21 +4,18 @@ import { useRoute } from 'vue-router'
 import type { FormInstance } from 'element-plus'
 import { DOCUMENT_HIT_HANDLING } from '@/api/enums'
 import type { DocumentItem, DocumentSettingPayload } from '@/api/types'
-import type DocumentApi from '@/api/admin/workspace/knowledge/document'
 import { KNOWLEDGE_TYPE_KEY } from '@/constants/knowledge'
 import { DOCUMENT_HIT_HANDLING_LABELS } from '@/constants/document'
-import { MsgSuccess } from '@/utils/message'
+import { cloneDeep } from 'lodash'
 
-defineOptions({ name: 'SettingDocumentAction' })
-const props = defineProps<{ api: typeof DocumentApi; knowledgeId: string; documents: DocumentItem[]; batch?: boolean; disabled?: boolean }>()
-const emit = defineEmits<{ refresh: [] }>()
+defineOptions({ name: 'DocumentSettingDialog' })
+const props = defineProps<{ loading: boolean; batch?: boolean }>()
+const emit = defineEmits<{ submit: [data: DocumentSettingPayload]; closed: [] }>()
 const route = useRoute()
 const knowledgeType = computed(() => route.params.type)
 const visible = ref(false)
-const loading = ref(false)
 const formRef = ref<FormInstance>()
 const document = ref<DocumentItem>()
-const targetDocumentIds = ref<string[]>([])
 const form = ref({
   hit_handling_method: DOCUMENT_HIT_HANDLING.OPTIMIZATION as DocumentSettingPayload['hit_handling_method'],
   directly_return_similarity: 0.9,
@@ -27,13 +24,9 @@ const form = ref({
   allow_download: true,
 })
 
-function handleOpenDialog() {
-  if (props.disabled || loading.value || !props.documents.length) return
-  const documents = props.documents
-  const batch = props.batch
-  document.value = batch ? undefined : documents[0]
-  targetDocumentIds.value = documents.map(({ id }) => id)
-  const current = document.value
+// 单项设置回填文档，批量设置使用默认值。
+function open(current?: DocumentItem) {
+  document.value = current ? cloneDeep(current) : undefined
   form.value = {
     hit_handling_method: current?.hit_handling_method ?? DOCUMENT_HIT_HANDLING.OPTIMIZATION,
     directly_return_similarity: current?.directly_return_similarity ?? 0.9,
@@ -45,54 +38,38 @@ function handleOpenDialog() {
 }
 
 async function handleSubmit() {
-  if (loading.value || !(await formRef.value?.validate().catch(() => false))) return
-  loading.value = true
+  if (props.loading || !(await formRef.value?.validate().catch(() => false))) return
   const data: DocumentSettingPayload = {
     hit_handling_method: form.value.hit_handling_method,
     directly_return_similarity: form.value.directly_return_similarity,
   }
-  let request: Promise<unknown>
   if (document.value) {
     data.meta = { ...document.value.meta, allow_download: form.value.allow_download }
     if (knowledgeType.value === KNOWLEDGE_TYPE_KEY.WEB) {
       data.meta.source_url = form.value.source_url.trim()
       data.meta.selector = form.value.selector
     }
-    request = props.api.putDocumentSetting(props.knowledgeId, document.value.id, data)
   } else {
-    request = props.api.putBatchDocumentSetting(props.knowledgeId, targetDocumentIds.value, { ...data, allow_download: form.value.allow_download })
+    data.allow_download = form.value.allow_download
   }
-  return request
-    .then(() => {
-      MsgSuccess('设置成功')
-      visible.value = false
-      emit('refresh')
-    })
-    .catch(() => {
-      // 请求层统一提示错误，保留当前输入。
-    })
-    .finally(() => {
-      loading.value = false
-    })
+  emit('submit', data)
 }
 
-function handleClosed() {
-  document.value = undefined
-  targetDocumentIds.value = []
-  formRef.value?.clearValidate()
+function close() {
+  visible.value = false
 }
+
+defineExpose({ open, close })
 </script>
 
 <template>
-  <!-- 文档设置入口 -->
-  <MkAction label="设置" icon="icon_setting" :disabled="disabled || loading || !documents.length" @click="handleOpenDialog" />
-  <MkDialog v-model="visible" title="文档设置" :show-close="!loading" @closed="handleClosed">
-    <el-form ref="formRef" :model="form" label-position="top" :disabled="loading" @submit.prevent>
-      <template v-if="document && knowledgeType === KNOWLEDGE_TYPE_KEY.WEB">
+  <MkDialog v-model="visible" title="文档设置" @closed="emit('closed')">
+    <el-form ref="formRef" :model="form" label-position="top" require-asterisk-position="right" @submit.prevent>
+      <template v-if="!batch && knowledgeType === KNOWLEDGE_TYPE_KEY.WEB">
         <el-form-item label="文档地址" prop="source_url" :rules="[{ required: true, whitespace: true, message: '请输入文档地址', trigger: 'blur' }]">
           <el-input v-model="form.source_url" />
         </el-form-item>
-        <el-form-item label="选择器"><el-input v-model="form.selector" /></el-form-item>
+        <el-form-item label="选择器"><el-input v-model="form.selector" placeholder="默认为 body，可输入 .classname/#idname/tagname"/></el-form-item>
       </template>
       <el-form-item label="召回处理">
         <el-radio-group v-model="form.hit_handling_method">
diff --git a/ui/src/views/knowledge-detail/library/document/action-dropdown/setting/SettingDocumentAction.vue b/ui/src/views/knowledge-detail/library/document/action-dropdown/setting/SettingDocumentAction.vue
new file mode 100644
index 00000000000..6b83c55ea4f
--- /dev/null
+++ b/ui/src/views/knowledge-detail/library/document/action-dropdown/setting/SettingDocumentAction.vue
@@ -0,0 +1,63 @@
+<script setup lang="ts">
+import { nextTick, ref, useTemplateRef } from 'vue'
+import type { DocumentItem, DocumentSettingPayload } from '@/api/types'
+import type DocumentApi from '@/api/admin/workspace/knowledge/document'
+import { MsgSuccess } from '@/utils/message'
+import DocumentSettingDialog from './DocumentSettingDialog.vue'
+
+defineOptions({ name: 'SettingDocumentAction' })
+const props = defineProps<{
+  api: typeof DocumentApi
+  knowledgeId: string
+  document: DocumentItem
+  label: string
+  icon?: string
+  disabled?: boolean
+}>()
+const loading = defineModel<boolean>('loading', { default: false })
+const emit = defineEmits<{ refresh: [] }>()
+
+// 打开设置时固定操作对象，弹窗关闭后卸载。
+const dialogMounted = ref(false)
+const settingDialogRef = useTemplateRef<InstanceType<typeof DocumentSettingDialog>>('settingDialogRef')
+const targetKnowledgeId = ref('')
+const targetDocumentId = ref('')
+
+function handleOpenDialog() {
+  if (props.disabled || loading.value || dialogMounted.value) return
+  targetKnowledgeId.value = props.knowledgeId
+  targetDocumentId.value = props.document.id
+  const document = props.document
+  dialogMounted.value = true
+  return nextTick(() => settingDialogRef.value?.open(document))
+}
+
+// 设置成功后关闭弹窗并刷新列表，失败保留表单。
+function handleSubmit(data: DocumentSettingPayload) {
+  if (loading.value) return
+  loading.value = true
+  return props.api
+    .putDocumentSetting(targetKnowledgeId.value, targetDocumentId.value, data)
+    .then(() => {
+      MsgSuccess('设置成功')
+      settingDialogRef.value?.close()
+      emit('refresh')
+    })
+    .catch(() => {
+      // 请求层统一提示错误，保留当前输入。
+    })
+    .finally(() => {
+      loading.value = false
+    })
+}
+
+function handleDialogClosed() {
+  dialogMounted.value = false
+}
+</script>
+
+<template>
+  <!-- 文档设置入口 -->
+  <MkAction :label="label" :icon="icon" :disabled="disabled || loading" @click="handleOpenDialog" />
+  <DocumentSettingDialog v-if="dialogMounted" ref="settingDialogRef" :loading="loading" @submit="handleSubmit" @closed="handleDialogClosed" />
+</template>
diff --git a/ui/src/views/knowledge-detail/library/document/index.vue b/ui/src/views/knowledge-detail/library/document/index.vue
index 0d9eb0d0ed5..10ac0c79c50 100644
--- a/ui/src/views/knowledge-detail/library/document/index.vue
+++ b/ui/src/views/knowledge-detail/library/document/index.vue
@@ -35,6 +35,7 @@ import {
   MigrateDocumentAction,
   ReplaceDocumentAction,
   SettingDocumentAction,
+  BatchSettingDocumentAction,
   SyncDocumentAction,
   BatchSyncDocumentAction,
   TokenizeDocumentAction,
@@ -386,16 +387,6 @@ onBeforeUnmount(() => {
             />
             <!-- 更多文档操作 -->
             <MkTableMoreDropdown>
-              <!-- 同步 -->
-              <SyncDocumentAction
-                v-if="knowledgeType === KNOWLEDGE_TYPE_KEY.WEB || knowledgeType === KNOWLEDGE_TYPE_KEY.LARK"
-                label="同步"
-                :api="DocumentApi"
-                :knowledge-id="knowledgeId"
-                :document="row"
-                v-model:loading="operationLoading"
-                @refresh="refreshAfterOperation"
-              />
               <!-- 生成或取消生成问题 -->
               <GenerateQuestionsAction
                 :api="DocumentApi"
@@ -404,14 +395,6 @@ onBeforeUnmount(() => {
                 :document="row"
                 @refresh="refreshAfterOperation"
               />
-              <!-- 文档设置 -->
-              <SettingDocumentAction
-                :api="DocumentApi"
-                :knowledge-id="knowledgeId"
-                :documents="[row]"
-                :disabled="operationLoading"
-                @refresh="refreshAfterOperation"
-              />
               <!-- 设置文档标签 -->
               <DocumentTagsAction
                 :api="DocumentApi"
@@ -421,8 +404,32 @@ onBeforeUnmount(() => {
                 :disabled="operationLoading"
                 @refresh="refreshAfterOperation"
               />
+              <!-- 同步 -->
+              <SyncDocumentAction
+                v-if="knowledgeType === KNOWLEDGE_TYPE_KEY.WEB || knowledgeType === KNOWLEDGE_TYPE_KEY.LARK"
+                label="同步"
+                :api="DocumentApi"
+                :knowledge-id="knowledgeId"
+                :document="row"
+                v-model:loading="operationLoading"
+                @refresh="refreshAfterOperation"
+              />
+
+              <!-- 文档设置 -->
+              <SettingDocumentAction
+                label="设置"
+                icon="icon_setting"
+                :api="DocumentApi"
+                :knowledge-id="knowledgeId"
+                :document="row"
+                v-model:loading="operationLoading"
+                @refresh="refreshAfterOperation"
+              />
+
               <!-- 迁移文档 -->
               <MigrateDocumentAction
+                label="迁移"
+                icon="icon_move2_outlined"
                 :api="DocumentApi"
                 :knowledge-id="knowledgeId"
                 :document-ids="[row.id]"
@@ -486,7 +493,14 @@ onBeforeUnmount(() => {
         @refresh="refreshAfterOperation"
       />
       <!-- 批量文档设置 -->
-      <el-button>设置</el-button>
+      <BatchSettingDocumentAction
+        label="设置"
+        :api="DocumentApi"
+        :knowledge-id="knowledgeId"
+        :document-ids="selectedDocumentIds"
+        v-model:loading="operationLoading"
+        @refresh="refreshAfterOperation"
+      />
 
       <!-- 批量添加标签 -->
       <el-button>添加标签</el-button>
@@ -511,6 +525,7 @@ onBeforeUnmount(() => {
             />
             <!-- 批量迁移文档 -->
             <MigrateDocumentAction
+              label="迁移"
               :api="DocumentApi"
               :knowledge-id="knowledgeId"
               :document-ids="selectedDocumentIds"
diff --git a/ui/src/views/knowledge-detail/setting/index.vue b/ui/src/views/knowledge-detail/setting/index.vue
index 49fedcbc185..f78baa40ff0 100644
--- a/ui/src/views/knowledge-detail/setting/index.vue
+++ b/ui/src/views/knowledge-detail/setting/index.vue
@@ -101,8 +101,8 @@ function handleSave() {
 
       const embeddingModelChanged = originalEmbeddingModelId.value !== payload.embedding_model_id
       const confirmation = embeddingModelChanged
-        ? MsgConfirm('更换向量模型', '更换向量模型后，需要对知识库中的文档重新向量化，是否继续？', {
-            confirmButtonText: '保存并重新向量化',
+        ? MsgConfirm('提示', '修改知识库向量模型后，需要对知识库向量化，是否继续保存？', {
+            confirmButtonText: '向量化',
             confirmButtonType: 'primary',
           })
         : Promise.resolve()
@@ -154,17 +154,13 @@ defineProps<ResourceDetailPageProps>()
         </el-card>
       </el-form-item>
       <template v-if="knowledge.type === KNOWLEDGE_TYPE.WEB">
-        <el-form-item label="Web 站点 URL" prop="source_url">
-          <el-input
-            v-model="settingForm.source_url"
-            placeholder="请输入 Web 站点 URL"
-            @blur="settingForm.source_url = settingForm.source_url.trim()"
-          />
+        <el-form-item label="Web 根地址" prop="source_url">
+          <el-input v-model="settingForm.source_url" placeholder="请输入 Web 根地址" @blur="settingForm.source_url = settingForm.source_url.trim()" />
         </el-form-item>
         <el-form-item label="选择器" prop="selector">
           <el-input
             v-model="settingForm.selector"
-            placeholder="请输入 CSS 选择器，默认 body"
+            placeholder="默认为 body，可输入 .classname/#idname/tagname"
             @blur="settingForm.selector = settingForm.selector.trim()"
           />
         </el-form-item>