diff --git a/ui/src/views/VIEW_README.md b/ui/src/views/VIEW_README.md
index 9308c4584de..41adc374b87 100644
--- a/ui/src/views/VIEW_README.md
+++ b/ui/src/views/VIEW_README.md
@@ -489,7 +489,7 @@ Dialog。新增或重命名文件时，应同步更新所有导入和页面功
 | `knowledge-detail/index.vue`                    | 知识库详情页面                                                       |
 | `knowledge-detail/library/tags/index.vue`       | 标签分组查询、创建、重命名、单值编辑、删除与关联文档管理             |
 | `knowledge-detail/workflow-transform/index.vue` | 非工作流知识库转换说明、确认与进入画布                               |
-| `document-detail/index.vue`          | 普通 Workspace 文档分段查询、目录定位、批量操作、新增、编辑与详情    |
+| `document-detail/index.vue`                     | 普通 Workspace 文档分段查询、目录定位、批量操作、新增、编辑与详情    |
 
 |
 | `knowledge-detail/setting/base/index.vue` | 知识库基本信息、来源配置与上传限制设置 |
@@ -739,7 +739,7 @@ Workspace API 内部通过 `getWorkspaceId()` 读取当前路由工作空间。
 `knowledge-detail/` 下的 `recall-test/`、`question/`、`dictionary/`、`chat-user/`、`external-retrieval/`。
 图片及这五个页面暂只展示占位内容。
 容器通过 `knowledge-detail/context.ts` 装配资源范围、知识库 ID、设置所需的完整业务 API 对象和返回列表路由，
-并提供只读详情与替换能力。详情入口与 setting 的 API 选择集中在该上下文；library 保持原有接口调用方式。
+并提供只读详情与替换能力。详情入口、setting 与 library 的 API 选择集中在该上下文。
 Action、Drawer、Dialog 继续通过 props 接收完整 API。设置页复用已加载详情，保存成功后
 更新容器数据，同步名称等展示。基本信息复用创建流程的 `KnowledgeBaseForm`，类型配置和校验留在
 `setting/base/index.vue` 中，通用知识库标题为“设置”，其他类型为“基础设置”。
@@ -840,16 +840,19 @@ Action 仍通过上层 `action-dropdown/index.ts` 导出，弹窗仅在目录内
 候选项使用 `tagsApi.getKnowledgeTags`，按返回顺序截取前 100 个标签组，然后由 `el-select filterable` 本地搜索；
 右侧显示所选组的全部标签值，切换标签名清空本行标签值，不增加远程搜索或自动扩展候选范围。
 单篇与批量均允许选择已关联标签值和重复选择，不为禁选查询文档已有标签，也不区分 `batch` 模式。
-表单复用 `MkFormList`，至少一行，保留必填与标签值归属校验；通过 `postAddDocumentTags` 提交所选 ID，由后台去重并追加关联。
-下拉 footer 复用模型选择器的创建入口，先收起下拉，再打开输入式 `tags/components/CreateTagDialog.vue`；
+表单复用 `MkFormList`，至少一行，字段只做必填校验；提交前检查标签值归属，失效时用 `MsgError` 提示“请重新选择标签值”并保留选择。
+通过 `postAddDocumentTags` 提交所选 ID，由后台去重并追加关联。
+下拉 footer 复用模型选择器的创建入口，直接打开输入式 `tags/components/CreateTagDialog.vue`；
 标签名入口调用 `open()`；标签值下拉始终可展开，未选标签时点击“创建标签值”也调用 `open()` 创建标签，
 已选标签时调用 `open(key)` 新增标签值，不合并两类弹窗的模式。
 弹窗每次打开都查询候选；内部创建成功后重载前 100 组候选，保留当前选择，不自动选中新数据。
+候选查询的 `queryLoading` 仅用于两个 `el-select` 的加载状态及下拉内创建入口禁用；表单遮罩、提交与取消只使用提交 `loading`。
 `BatchDocumentTagsAction.vue` 使用普通按钮外放在底部批量操作栏，内部按需挂载 `AddTagDialog`，打开时固定知识库和文档 ID，
-即使只勾选一篇，也按批量添加处理。添加成功关闭动画结束后通知刷新，再卸载弹窗。
+即使只勾选一篇，也按批量添加处理。添加成功后关闭并立即通知刷新；取消关闭时只通知卸载，不刷新。
 三个外层标签入口只通过 `refresh` 通知页面刷新，沿用文档列表原有轮询，不为标签浮层单独暂停。
-页面不持有标签浮层 Ref 或控制其挂载。标签入口与打开方法只限制 Workspace 共享只读范围，
-Workspace 普通资源、System 资源管理和 System 共享资源允许打开；System library 的文档与标签 API 仍待按范围接入，不能将入口可用视为接口已支持。
+页面不持有标签浮层 Ref 或控制其挂载。标签维护入口通过上下文的完整写接口控制，
+目前仅 Workspace 普通资源提供维护 API；Workspace 共享只读，System library 的文档与标签 API 尚未提供，
+不显示维护入口，也不回退 Workspace 请求。
 分词索引集中在 `document/action-dropdown/tokenize/`：`TokenizeDocumentAction` 接收单个 `document`，
 按运行状态调用单项分词或取消接口；`BatchTokenizeAction` 接收 `documentIds`，仅调用批量分词接口。
 两个 Action 均处理全部分段状态，通过 `v-model:loading` 共用页面操作状态，成功后通知页面刷新。
@@ -989,7 +992,8 @@ Workspace 普通与共享资源均使用 Workspace 模型选项接口，System 
 System 共享使用系统共享模型接口。
 四种范围的定时同步查询和日志均使用各自现有 Sync API；Workspace 普通和 System 两种范围支持保存，
 Workspace 共享只读，不发送保存请求，不回退 Workspace 接口。
-library 的接口调整已撤回，文档和标签沿用原有调用方式，System library API 适配尚未实施。
+library 通过 `useKnowledgeLibraryContext` 装配现有文档、标签 API；System 两种范围未提供对应模块，
+保持未接入状态，不回退 Workspace。Workspace 共享仅查询，普通 Workspace 提供已有维护接口。
 路由结构及来源配置见 `src/router/ROUTE_README.md`。
 
 ### 资料库标签管理
@@ -1009,7 +1013,8 @@ library 的接口调整已撤回，文档和标签沿用原有调用方式，Sys
 接收知识库 ID 与完整 Tags API，参考添加成员流程复用 `MkDialog`、`el-form` 和 `MkFormList`。
 创建允许多行标签名与值；新增值通过 `open(key)` 回填并锁定标签名，新增行沿用该名称。
 顶部创建标题为“创建标签”，传入标签名时标题为“添加标签值”。
-两个入口统一通过 `postKnowledgeTags` 提交标签数组，校验表单内重复组合。
+两个入口统一通过 `postKnowledgeTags` 提交标签数组，提交前检查表单内重复组合，沿用模型参数的 `MsgError` 消息提示并保留输入；
+与知识库已有标签重复的组合由后端跳过，接口错误由请求层统一提示。
 同目录 `EditTagDialog.vue` 共用标签重命名和单值编辑，通过 `open(tag, field)` 回填独立草稿。
 重命名只显示标签名；编辑值只显示一行并锁定标签名。两个入口均提交完整 `id`、`key`、`value`，
 请求路径 ID 与载荷 ID 一致，仅修改当前编辑字段，未编辑字段原样保留。
@@ -1035,7 +1040,7 @@ library 的接口调整已撤回，文档和标签沿用原有调用方式，Sys
 文档图标和时间格式沿用文档列表，状态使用 `MkStatusLabel`；批量操作放在顶部，不再显示页面批量底栏。
 搜索、分页和页签切换清空选择，关联变更后重新查询并通知标签页刷新数量，末页为空时回退。
 抽屉在 `closed` 重置标签、筛选、分页和选择，不新增权限判断或共享范围接口。
-文档页标签候选查询继续使用 Knowledge API，共享标签查询保持原接口；普通文档标签入口使用上述独立添加弹窗与抽屉。
+文档页标签候选查询通过资料库上下文选择当前范围 Tags API，共享标签查询保持原接口；普通文档标签入口使用上述独立添加弹窗与抽屉。
 
 `KnowledgeWorkflowView` 复用 `ButtonDefaultModelSetting`，从知识库详情读取默认模型配置，
 随工作流保存提交并将配置传入画布；支持应用到所有节点，保存失败回滚至已保存配置。
@@ -1355,8 +1360,7 @@ Web 地址按行去空白、去重并校验 HTTP/HTTPS；空选择器提交 `bod
 
 知识库列表根据当前目录进入普通或 `workspace-shared-knowledge-detail` 共享详情路由。
 两者复用 `knowledge-detail/index.vue` 和文档页；详情容器通过上下文选择对应详情 API，
-文档页继续自行通过 `isWorkspaceSharedResource()` 选择 `workspace/knowledge/` 或
-`workspace/shared/knowledge/` 的完整 API 对象。
+文档页与标签页通过 `useKnowledgeLibraryContext` 选择普通或共享的现有完整 API 对象。
 共享详情已补齐与其他三种范围一致的菜单，设置与工作流接口接入暂缓。
 容器监听工作空间、知识库和资源范围变化重新加载；共享详情返回列表携带 `folderId: 'shared'`，
 普通详情继续恢复所属文件夹。文档创建者选项在共享范围使用 System `CommonApi`，普通范围使用
@@ -1470,10 +1474,28 @@ chat 装配函数通过 `disabled` 禁用输入框与附件。
 返回列表路由独立提供；不要在 setup 时解构 `resourceApi` 内的具体 API，以免固定为旧范围的对象。
 不根据 URL 猜测来源，不为补齐方法集合构造请求，不让缺失模块回退 Workspace。
 目前仅详情入口及 setting 下的基础设置、文档策略、定时同步页面采用上下文 API；
-library 下的文档、标签与迁移组件保留原有调用方式，不装配到上下文。
+library 下的文档、标签与迁移入口通过 `useKnowledgeLibraryContext` 读取现有 API，
+`resourceApi.document / tags` 是可选的查询模块；System 两种来源未提供时不发送请求。
+与 sync 一致，维护接口只通过 `requestSettingApi` 提供，内部使用完整的 `document / tags / workflow / knowledge` API；
+仅 Workspace 普通范围提供该维护入口，分别传给已有操作组件；不为共享或 System 补造写接口。共享标签页按现有无查询参数接口读取，
+在本地按标签名称筛选，不展示维护入口；关联文档数量仅作文本展示。
 同步日志通过完整 Sync API props 请求。展示组件不接收上下文 API。
 System 飞书专用保存方法尚未提供，基础设置沿该范围现有 `putKnowledge` 协议；Workspace 飞书保留专用方法。
 
 四套知识库详情菜单及来源导航已统一，`useKnowledgeNavigationContext` 仅维护路由名称与参数，
-不配置 API。各范围接口存在差异，API 模块保持原实现；本轮仅补齐 sync 的范围装配与消费，
+不配置 API。各范围接口存在差异，API 模块保持原实现；目前已补齐 sync 与 library 的现有接口装配与消费，
 其他模块后续按每套真实接口分别接入，不将菜单完整度视为接口接入完成。
+
+### 资料库上下文与只读范围
+
+`useKnowledgeLibraryContext` 复用详情数据、知识库 ID 和响应式资源范围，文档及标签查询通过
+`resourceApi.document / tags` 访问当前范围完整 API。缺失模块保持 undefined，页面展示未接入空态，
+不轮询或发送 Workspace 请求。文档页切换知识库、工作空间或范围时清空筛选、分页和选择；标签页同时重置标签组。
+Workspace 共享文档保留查询和标签展示，标签页保留标签组查询；只支持共享接口现有的方法。
+创建标签弹窗必须由入口传入完整 Tags API，不再默认使用普通 Workspace；文档标签添加及迁移的
+候选查询同样通过资料库上下文选择。图片页保持占位，不配置不存在的接口。
+
+资料库所有消费方沿用 Sync 的双入口结构，包括文档页、标签页、文档标签添加弹窗、标签创建入口、
+文档迁移弹窗以及传入 Action / Drawer 的 API：查询模块通过响应式 `resourceApi` getter 读取，
+维护模块通过单个 `requestSettingApi` 读取，不再为各模块暴露独立 computed 入口。
+方法内部选定完整业务 API 时继续使用局部变量 `requestApi`，它不属于新的上下文入口。
diff --git a/ui/src/views/knowledge-detail/context.ts b/ui/src/views/knowledge-detail/context.ts
index 9abbc89d0c7..ddcb25a52ce 100644
--- a/ui/src/views/knowledge-detail/context.ts
+++ b/ui/src/views/knowledge-detail/context.ts
@@ -5,6 +5,11 @@ import KnowledgeApi from '@/api/admin/workspace/knowledge/knowledge'
 import SharedKnowledgeApi from '@/api/admin/workspace/shared/knowledge/knowledge'
 import SystemResourceKnowledgeApi from '@/api/admin/system/resource-management/knowledge/knowledge'
 import SystemSharedKnowledgeApi from '@/api/admin/system/shared-resources/knowledge/knowledge'
+import DocumentApi from '@/api/admin/workspace/knowledge/document'
+import SharedDocumentApi from '@/api/admin/workspace/shared/knowledge/document'
+import TagsApi from '@/api/admin/workspace/knowledge/tags'
+import SharedTagsApi from '@/api/admin/workspace/shared/knowledge/tags'
+import WorkflowApi from '@/api/admin/workspace/knowledge/workflow'
 import SyncApi from '@/api/admin/workspace/knowledge/sync'
 import SharedSyncApi from '@/api/admin/workspace/shared/knowledge/sync'
 import SystemResourceSyncApi from '@/api/admin/system/resource-management/knowledge/sync'
@@ -13,6 +18,9 @@ import type { KnowledgeDetail } from '@/api/types'
 import type { ResourceScope } from '@/router/admin/types'
 
 interface KnowledgeResourceApi {
+  readonly workflow?: typeof WorkflowApi
+  readonly document?: typeof DocumentApi | typeof SharedDocumentApi
+  readonly tags?: typeof TagsApi | typeof SharedTagsApi
   readonly knowledge: typeof KnowledgeApi | typeof SharedKnowledgeApi | typeof SystemResourceKnowledgeApi | typeof SystemSharedKnowledgeApi
   readonly sync: typeof SyncApi | typeof SharedSyncApi | typeof SystemResourceSyncApi | typeof SystemSharedSyncApi
 }
@@ -25,11 +33,11 @@ interface KnowledgeResourceConfig {
 /** 仅配置真实存在的完整 API 对象；缺失模块不回退到 Workspace。 */
 const resourceConfigs = {
   workspace: {
-    resourceApi: { knowledge: KnowledgeApi, sync: SyncApi },
+    resourceApi: { knowledge: KnowledgeApi, sync: SyncApi, document: DocumentApi, tags: TagsApi, workflow: WorkflowApi },
     listRouteName: 'workspace-knowledge-list',
   },
   'workspace-shared': {
-    resourceApi: { knowledge: SharedKnowledgeApi, sync: SharedSyncApi },
+    resourceApi: { knowledge: SharedKnowledgeApi, sync: SharedSyncApi, document: SharedDocumentApi, tags: SharedTagsApi },
     listRouteName: 'workspace-knowledge-list',
   },
   'system-resource': {
@@ -64,6 +72,15 @@ function createKnowledgeDetailContext(state: KnowledgeDetailState): KnowledgeDet
   })
   // 保持接口入口稳定，通过 getter 在路由范围变化时读取当前配置。
   const resourceApi = reactive({
+    get workflow() {
+      return resourceConfig.value.resourceApi.workflow
+    },
+    get document() {
+      return resourceConfig.value.resourceApi.document
+    },
+    get tags() {
+      return resourceConfig.value.resourceApi.tags
+    },
     get knowledge() {
       return resourceConfig.value.resourceApi.knowledge
     },
@@ -94,6 +111,16 @@ export function useKnowledgeDetailContext() {
   return context
 }
 
+/** 资料库保留现有查询差异，维护接口仅来自已支持写入的 Workspace 普通范围。 */
+export function useKnowledgeLibraryContext() {
+  const context = useKnowledgeDetailContext()
+  const requestSettingApi = computed(() => {
+    if (context.resourceScope.value !== 'workspace') return undefined
+    return resourceConfigs.workspace.resourceApi
+  })
+  return { ...context, requestSettingApi }
+}
+
 /** 同步查询使用当前范围，保存仅提供给现有 API 支持写入的三个范围。 */
 export function useKnowledgeSyncContext() {
   const context = useKnowledgeDetailContext()
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
index 9cf03ec608e..c03ea1663de 100644
--- 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
@@ -2,13 +2,14 @@
 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 { useKnowledgeLibraryContext } from '../../../../context'
 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 { requestSettingApi } = useKnowledgeLibraryContext()
 const visible = ref(false)
 const loading = defineModel<boolean>('loading', { default: false })
 const optionLoading = ref(false)
@@ -23,11 +24,13 @@ const targetDocumentIds = ref<string[]>([])
 
 // 打开迁移弹窗，固定本次文档并查询目标知识库。
 function open(documentIds: string[]) {
-  if (loading.value || optionLoading.value || !documentIds.length) return
+  const requestApi = requestSettingApi.value?.knowledge
+  if (!requestApi || loading.value || optionLoading.value || !documentIds.length) return
   targetDocumentIds.value = [...documentIds]
   visible.value = true
   optionLoading.value = true
-  KnowledgeApi.getAllKnowledge()
+  requestApi
+    .getAllKnowledge()
     .then((knowledge) => {
       knowledgeOptions.value = knowledge.filter(({ id }) => id !== props.knowledgeId)
     })
diff --git a/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/AddTagDialog.vue b/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/AddTagDialog.vue
index 0e90c437698..0822ccd1629 100644
--- a/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/AddTagDialog.vue
+++ b/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/AddTagDialog.vue
@@ -1,10 +1,10 @@
 <script setup lang="ts">
-import { computed, nextTick, reactive, ref, type ComponentPublicInstance } from 'vue'
-import type { FormInstance, FormItemRule, SelectInstance } from 'element-plus'
+import { nextTick, reactive, ref } from 'vue'
+import type { FormInstance } from 'element-plus'
 import type DocumentApi from '@/api/admin/workspace/knowledge/document'
-import tagsApi from '@/api/admin/workspace/knowledge/tags'
+import { useKnowledgeLibraryContext } from '../../../../context'
 import type { KnowledgeTagGroup } from '@/api/types'
-import { MsgSuccess } from '@/utils/message'
+import { MsgError, MsgSuccess } from '@/utils/message'
 import CreateTagDialog from '../../../tags/components/CreateTagDialog.vue'
 
 defineOptions({ name: 'AddTagDialog' })
@@ -20,41 +20,42 @@ interface TagSelection {
   tagId: string
 }
 
+const { requestSettingApi } = useKnowledgeLibraryContext()
 const visible = ref(false)
 const queryLoading = ref(false)
-const optionsReady = ref(false)
 const targetKnowledgeId = ref('')
 const targetDocumentIds = ref<string[]>([])
 const tagGroups = ref<KnowledgeTagGroup[]>([])
 const tagForm = reactive<{ tags: TagSelection[] }>({ tags: [{ key: '', tagId: '' }] })
 const formRef = ref<FormInstance>()
-const keySelectRefs: Record<number, SelectInstance | null> = {}
-const valueSelectRefs: Record<number, SelectInstance | null> = {}
 const createTagRef = ref<InstanceType<typeof CreateTagDialog>>()
 const createTagMounted = ref(false)
-const busy = computed(() => loading.value || queryLoading.value || createTagMounted.value)
-let added = false
 
 // 候选项只保留接口返回的前 100 个标签组，搜索交给 el-select 的 filterable。
 function loadTagOptions() {
-  return tagsApi.getKnowledgeTags(targetKnowledgeId.value).then((groups) => {
-    tagGroups.value = groups.slice(0, 100)
-  })
+  const requestApi = requestSettingApi.value?.tags
+  if (!requestApi) return
+  queryLoading.value = true
+  return requestApi
+    .getKnowledgeTags(targetKnowledgeId.value)
+    .then((groups) => {
+      tagGroups.value = groups.slice(0, 100)
+    })
+    .catch(() => {
+      // 查询失败时清空候选，避免提交已失效的标签值。
+      tagGroups.value = []
+    })
+    .finally(() => {
+      queryLoading.value = false
+    })
 }
 
 function open(documentIds: string[]) {
-  if (visible.value || busy.value || !documentIds.length) return
+  if (!requestSettingApi.value?.tags || visible.value || loading.value || !documentIds.length) return
   targetKnowledgeId.value = props.knowledgeId
   targetDocumentIds.value = [...documentIds]
   visible.value = true
-  queryLoading.value = true
   return loadTagOptions()
-    .then(() => {
-      optionsReady.value = true
-    })
-    .finally(() => {
-      queryLoading.value = false
-    })
 }
 
 function getTagValues(key: string) {
@@ -70,56 +71,31 @@ function handleRowsChange() {
   formRef.value?.clearValidate()
 }
 
-function getTagValueRules(index: number): FormItemRule[] {
-  return [
-    { required: true, message: '请选择标签值', trigger: 'change' },
-    {
-      validator: (_rule, value: string, callback) => {
-        const tag = tagForm.tags[index]
-        if (value && (!tag || !getTagValues(tag.key).some(({ id }) => id === value))) {
-          return callback(new Error('请重新选择标签值'))
-        }
-        callback()
-      },
-      trigger: 'change',
-    },
-  ]
-}
-
 function handleOpenCreateTag(index: number, field: 'key' | 'value') {
-  if (busy.value || !optionsReady.value) return
+  if (loading.value || createTagMounted.value) return
   const key = tagForm.tags[index]?.key
-  const selectRefs = field === 'key' ? keySelectRefs : valueSelectRefs
-  selectRefs[index]?.blur()
   createTagMounted.value = true
   return nextTick(() => createTagRef.value?.open(field === 'value' && key ? key : undefined))
 }
 
-function handleTagsCreated() {
-  // 创建成功后刷新当前弹窗的候选项。
-  queryLoading.value = true
-  optionsReady.value = false
-  return loadTagOptions()
-    .then(() => {
-      optionsReady.value = true
-    })
-    .finally(() => {
-      queryLoading.value = false
-    })
-}
-
+// 添加成功后关闭并通知页面刷新。
 function handleSubmit() {
-  if (busy.value || !optionsReady.value) return
+  if (loading.value || createTagMounted.value) return
   return formRef.value?.validate((valid) => {
-    if (!valid || busy.value || !tagForm.tags.length) return
+    if (!valid || loading.value || createTagMounted.value || !tagForm.tags.length) return
+    const invalidTag = tagForm.tags.some((tag) => !getTagValues(tag.key).some(({ id }) => id === tag.tagId))
+    if (invalidTag) {
+      MsgError('标签值已存在')
+      return
+    }
     const tagIds = tagForm.tags.map(({ tagId }) => tagId)
     loading.value = true
     return props.api
       .postAddDocumentTags(targetKnowledgeId.value, targetDocumentIds.value, tagIds)
       .then(() => {
         MsgSuccess('添加成功')
-        added = true
         visible.value = false
+        emit('refresh')
       })
       .finally(() => {
         loading.value = false
@@ -127,22 +103,12 @@ function handleSubmit() {
   })
 }
 
-function handleBeforeClose(done: () => void) {
-  if (!busy.value) done()
-}
-
-function handleClosed() {
-  // 等关闭动画结束再刷新，避免批量勾选清空时提前卸载弹窗。
-  if (added) emit('refresh')
-  emit('closed')
-}
-
 defineExpose({ open })
 </script>
 
 <template>
-  <MkDialog v-model="visible" title="添加标签" :before-close="handleBeforeClose" @closed="handleClosed">
-    <el-form ref="formRef" v-loading="queryLoading || loading" :model="tagForm" label-position="top" @submit.prevent>
+  <MkDialog v-model="visible" title="添加标签" @closed="emit('closed')">
+    <el-form ref="formRef" v-loading="loading" :model="tagForm" label-position="top" @submit.prevent>
       <MkFormList v-model="tagForm.tags" :default-item="{ key: '', tagId: '' }" @update:model-value="handleRowsChange">
         <template #default="{ index, item: tag }">
           <el-form-item
@@ -151,36 +117,28 @@ defineExpose({ open })
             :prop="`tags.${index}.key`"
             :rules="{ required: true, message: '请选择标签', trigger: 'change' }"
           >
-            <el-select
-              :ref="(select: Element | ComponentPublicInstance | null) => (keySelectRefs[index] = select as SelectInstance | null)"
-              v-model="tag.key"
-              filterable
-              clearable
-              placeholder="请选择标签"
-              @change="handleTagKeyChange(index)"
-            >
+            <el-select v-model="tag.key" :loading="queryLoading" filterable clearable placeholder="请选择标签" @change="handleTagKeyChange(index)">
               <el-option v-for="group in tagGroups" :key="group.key" :label="group.key" :value="group.key" />
               <template #footer>
                 <!-- 创建新标签 -->
-                <el-button type="primary" link :disabled="busy || !optionsReady" @click.stop="handleOpenCreateTag(index, 'key')">
+                <el-button type="primary" link :disabled="queryLoading" @click.stop="handleOpenCreateTag(index, 'key')">
                   <MkIcon name="icon_add_outlined" />
                   <span>创建标签</span>
                 </el-button>
               </template>
             </el-select>
           </el-form-item>
-          <el-form-item class="min-w-0 flex-1" :label="index === 0 ? '标签值' : ''" :prop="`tags.${index}.tagId`" :rules="getTagValueRules(index)">
-            <el-select
-              :ref="(select: Element | ComponentPublicInstance | null) => (valueSelectRefs[index] = select as SelectInstance | null)"
-              v-model="tag.tagId"
-              filterable
-              clearable
-              placeholder="请选择标签值"
-            >
+          <el-form-item
+            class="min-w-0 flex-1"
+            :label="index === 0 ? '标签值' : ''"
+            :prop="`tags.${index}.tagId`"
+            :rules="{ required: true, message: '请选择标签值', trigger: 'change' }"
+          >
+            <el-select v-model="tag.tagId" :loading="queryLoading" filterable clearable placeholder="请选择标签值">
               <el-option v-for="value in getTagValues(tag.key)" :key="value.id" :label="value.value" :value="value.id" />
               <template #footer>
                 <!-- 已选标签时新增值，未选标签时创建标签 -->
-                <el-button type="primary" link :disabled="busy || !optionsReady" @click.stop="handleOpenCreateTag(index, 'value')">
+                <el-button type="primary" link :disabled="queryLoading" @click.stop="handleOpenCreateTag(index, 'value')">
                   <MkIcon name="icon_add_outlined" />
                   <span>创建标签值</span>
                 </el-button>
@@ -192,18 +150,17 @@ defineExpose({ open })
     </el-form>
     <template #footer>
       <!-- 取消添加 -->
-      <el-button plain :disabled="busy" @click="visible = false">取消</el-button>
+      <el-button plain :disabled="loading" @click="visible = false">取消</el-button>
       <!-- 添加所选标签到目标文档 -->
-      <el-button type="primary" :loading="loading" :disabled="queryLoading || createTagMounted || !optionsReady" @click="handleSubmit">
-        添加
-      </el-button>
+      <el-button type="primary" :loading="loading" @click="handleSubmit">添加</el-button>
     </template>
   </MkDialog>
   <CreateTagDialog
-    v-if="createTagMounted"
+    v-if="createTagMounted && requestSettingApi"
     ref="createTagRef"
     :knowledge-id="targetKnowledgeId"
-    @refresh="handleTagsCreated"
+    :api="requestSettingApi.tags"
+    @refresh="loadTagOptions"
     @closed="createTagMounted = false"
   />
 </template>
diff --git a/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/BatchDocumentTagsAction.vue b/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/BatchDocumentTagsAction.vue
index dfa7e929945..0e175fb3486 100644
--- a/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/BatchDocumentTagsAction.vue
+++ b/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/BatchDocumentTagsAction.vue
@@ -19,7 +19,7 @@ const addTagRef = useTemplateRef<InstanceType<typeof AddTagDialog>>('addTagRef')
 const targetKnowledgeId = ref('')
 
 function handleOpenDialog() {
-  if (props.disabled || loading.value || dialogMounted.value || !props.documentIds.length) return
+  if (props.disabled || loading.value || dialogMounted.value) return
   targetKnowledgeId.value = props.knowledgeId
   const documentIds = [...props.documentIds]
   dialogMounted.value = true
diff --git a/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/DocumentTagsDrawer.vue b/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/DocumentTagsDrawer.vue
index 80997c7372f..d1f2142aa35 100644
--- a/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/DocumentTagsDrawer.vue
+++ b/ui/src/views/knowledge-detail/library/document/action-dropdown/setting-tags/DocumentTagsDrawer.vue
@@ -77,7 +77,6 @@ function spanMethod({ column, row }: { column: TableColumnCtx<DocumentTagRow>; r
 }
 
 function handleOpenAddTag() {
-  if (loading.value || operationLoading.value || addTagMounted.value) return
   addTagMounted.value = true
   return nextTick(() => addTagRef.value?.open([targetDocumentId.value]))
 }
@@ -88,11 +87,10 @@ function handleTagsChanged() {
 }
 
 function handleDeleteTags(tags: DocumentTagRow[]) {
-  if (loading.value || operationLoading.value || confirming.value || !tags.length) return
   const tagIds = tags.map(({ id }) => id)
-  const title = tags.length === 1 ? `是否移除标签：${tags[0]!.key}—${tags[0]!.value}？` : `是否移除选中的 ${tagIds.length} 个标签值？`
+  const title = tags.length === 1 ? `是否移除标签：${tags[0]!.key}—${tags[0]!.value}？` : `是否移除选中的 ${tagIds.length} 个标签？`
   confirming.value = true
-  return MsgConfirm(title, '仅移除当前文档与所选标签值的关联，不删除知识库标签，也不影响其他文档。')
+  return MsgConfirm(title, '删除后，使用该标签的资源将会删除该标签，请谨慎操作！')
     .then(
       () => {
         operationLoading.value = true
@@ -113,18 +111,14 @@ function handleDeleteTags(tags: DocumentTagRow[]) {
     })
 }
 
-function handleBeforeClose(done: () => void) {
-  if (!loading.value && !operationLoading.value && !addTagMounted.value && !confirming.value) done()
-}
-
 defineExpose({ open })
 </script>
 
 <template>
-  <MkDrawer v-model="visible" title="标签设置" content-class="h-full flex-column gap-4" :before-close="handleBeforeClose" @closed="emit('closed')">
-    <div class="flex-between gap-4">
+  <MkDrawer v-model="visible" title="标签设置" @closed="emit('closed')">
+    <div class="flex-between gap-4 mb-4">
       <!-- 为当前文档添加标签 -->
-      <el-button type="primary" :disabled="loading || operationLoading" @click="handleOpenAddTag">
+      <el-button type="primary" @click="handleOpenAddTag">
         <MkIcon name="icon_add_outlined" />
         <span>添加标签</span>
       </el-button>
diff --git a/ui/src/views/knowledge-detail/library/document/components/DocumentTags.vue b/ui/src/views/knowledge-detail/library/document/components/DocumentTags.vue
index 738b83fbc0d..3d43ff8f41c 100644
--- a/ui/src/views/knowledge-detail/library/document/components/DocumentTags.vue
+++ b/ui/src/views/knowledge-detail/library/document/components/DocumentTags.vue
@@ -6,7 +6,7 @@ import type { DocumentItem } from '@/api/types'
 import AddTagDialog from '../action-dropdown/setting-tags/AddTagDialog.vue'
 
 defineOptions({ name: 'DocumentTags' })
-const props = defineProps<{ api: typeof DocumentApi; knowledgeId: string; document: DocumentItem; disabled?: boolean }>()
+const props = defineProps<{ api?: typeof DocumentApi; knowledgeId: string; document: DocumentItem; disabled?: boolean }>()
 const loading = defineModel<boolean>('loading', { default: false })
 const emit = defineEmits<{ refresh: [] }>()
 
@@ -18,7 +18,7 @@ const addTagRef = useTemplateRef<InstanceType<typeof AddTagDialog>>('addTagRef')
 const targetKnowledgeId = ref('')
 
 function handleOpenDialog() {
-  if (props.disabled || loading.value || dialogMounted.value) return
+  if (!props.api || props.disabled || loading.value || dialogMounted.value) return
   targetKnowledgeId.value = props.knowledgeId
   const documentId = props.document.id
   dialogMounted.value = true
@@ -51,13 +51,13 @@ function handleDialogClosed() {
       </div>
     </el-popover>
     <!-- 添加文档标签 -->
-    <el-button class="mk-add-tag-button" plain :disabled="disabled || loading" @click.stop="handleOpenDialog">
+    <el-button class="mk-add-tag-button" plain :disabled="!api || disabled || loading" @click.stop="handleOpenDialog">
       <MkIcon name="icon_add_outlined" size="14" />
       <span>标签</span>
     </el-button>
   </div>
   <AddTagDialog
-    v-if="dialogMounted"
+    v-if="dialogMounted && api"
     ref="addTagRef"
     v-model:loading="loading"
     :api="api"
diff --git a/ui/src/views/knowledge-detail/library/document/index.vue b/ui/src/views/knowledge-detail/library/document/index.vue
index 6893ce5f362..67466d73219 100644
--- a/ui/src/views/knowledge-detail/library/document/index.vue
+++ b/ui/src/views/knowledge-detail/library/document/index.vue
@@ -1,16 +1,11 @@
 <script setup lang="ts">
 import { useKnowledgeNavigationContext } from '@/views/knowledge-detail/context'
-import { computed, onBeforeUnmount, onMounted, ref } from 'vue'
+import { computed, onBeforeUnmount, watch, ref } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
 import type { CascaderOption, TableColumnCtx } from 'element-plus'
 import type MkQuickCreate from '@/components/global/mk-table/MkQuickCreate.vue'
 import MkEditName from '@/components/mk-edit-name/index.vue'
 import type { ResourceDetailPageProps } from '@/layout/ResourceDetailLayout.vue'
-import DocumentApi from '@/api/admin/workspace/knowledge/document'
-import SharedDocumentApi from '@/api/admin/workspace/shared/knowledge/document'
-import WorkflowApi from '@/api/admin/workspace/knowledge/workflow'
-import TagsApi from '@/api/admin/workspace/knowledge/tags'
-import SharedTagsApi from '@/api/admin/workspace/shared/knowledge/tags'
 import CommonApi from '@/api/admin/workspace/common'
 import CommonSystemApi from '@/api/admin/system/common'
 import { DOCUMENT_TASK_TYPE } from '@/api/enums'
@@ -19,14 +14,13 @@ import { DOCUMENT_HIT_HANDLING_LABELS } from '@/constants/document'
 import { DOCUMENT_STATUS_FILTER_OPTIONS } from './status'
 import type { Dict, DocumentHitHandling, DocumentItem, OptionItem } from '@/api/types'
 import { datetimeFormat } from '@/utils/time'
-import { isWorkspaceSharedResource } from '@/utils/resource-context'
 import { numberFormat } from '@/utils/number'
 import { MsgSuccess } from '@/utils/message'
 import { getFileIconUrl } from '@/utils/icon'
 import ButtonUploadDocument from './upload-document/ButtonUploadDocument.vue'
 import ButtonImportDocument from './import-document/ButtonImportDocument.vue'
 import ButtonExecutionRecord from './components/ButtonExecutionRecord.vue'
-import { useKnowledgeDetailContext } from '../../context'
+import { useKnowledgeLibraryContext } from '../../context'
 import DocumentStatus from './components/DocumentStatus.vue'
 import DocumentTags from './components/DocumentTags.vue'
 import {
@@ -61,7 +55,7 @@ const route = useRoute()
 const router = useRouter()
 const knowledgeId = computed(() => String(route.params.knowledgeId ?? ''))
 const knowledgeType = computed(() => String(route.params.type ?? ''))
-const { knowledge } = useKnowledgeDetailContext()
+const { knowledge, resourceApi, resourceScope, requestSettingApi } = useKnowledgeLibraryContext()
 
 /* 文档分段入口：选择列与行内操作继续处理自身交互。 */
 function handleOpenParagraph(document: DocumentItem, column?: TableColumnCtx<DocumentItem> | null) {
@@ -74,12 +68,15 @@ function handleOpenParagraph(document: DocumentItem, column?: TableColumnCtx<Doc
 }
 
 /* 快速创建 */
-const showQuickCreate = computed(() => knowledgeType.value === KNOWLEDGE_TYPE_KEY.BASE && !isWorkspaceSharedResource())
+const showQuickCreate = computed(() => knowledgeType.value === KNOWLEDGE_TYPE_KEY.BASE && !!requestSettingApi.value?.document)
 const quickCreateRef = ref<InstanceType<typeof MkQuickCreate>>()
 
 function handleCreateDocument(name: string) {
+  const requestApi = requestSettingApi.value?.document
+  if (!requestApi) return
   loading.value = true
-  return DocumentApi.putBatchCreateDocuments(knowledgeId.value, [{ name }])
+  return requestApi
+    .putBatchCreateDocuments(knowledgeId.value, [{ name }])
     .then(() => {
       // 创建成功即清理草稿，后续刷新失败不恢复为可重复提交的输入。
       quickCreateRef.value?.close()
@@ -104,7 +101,9 @@ function validateDocumentName(name: string): string | undefined {
 }
 
 function saveDocumentName(documentId: string, name: string): Promise<string> {
-  return DocumentApi.putDocument(knowledgeId.value, documentId, { name }).then((document) => {
+  const requestApi = requestSettingApi.value?.document
+  if (!requestApi) return Promise.resolve(documentData.value.find(({ id }) => id === documentId)?.name ?? '')
+  return requestApi.putDocument(knowledgeId.value, documentId, { name }).then((document) => {
     // 轮询可能已替换行对象，按 ID 更新当前列表中的名称与更新时间。
     const currentDocument = documentData.value.find(({ id }) => id === documentId)
     if (currentDocument) {
@@ -127,7 +126,7 @@ const searchFields = computed(() => [
 ])
 
 function loadCreatorOptions(keyword: string) {
-  const requestCommonApi = isWorkspaceSharedResource() ? CommonSystemApi : CommonApi
+  const requestCommonApi = resourceScope.value === 'workspace' ? CommonApi : CommonSystemApi
   return requestCommonApi.getAllUsers(keyword ? { nick_name: keyword } : undefined).then((users) => {
     creatorOptions.value = users.map(({ id, nick_name }) => ({ label: nick_name, value: id }))
   })
@@ -155,9 +154,9 @@ const documentTagOptions = ref<CascaderOption[]>([])
 const documentTagLoading = ref(false)
 
 function loadDocumentTagOptions() {
-  if (documentTagLoading.value) return
+  const requestApi = resourceApi.tags
+  if (!requestApi || documentTagLoading.value) return
   documentTagLoading.value = true
-  const requestApi = isWorkspaceSharedResource() ? SharedTagsApi : TagsApi
   return requestApi
     .getKnowledgeTags(knowledgeId.value)
     .then((groups) => {
@@ -192,7 +191,7 @@ function stopPolling() {
 
 function schedulePolling() {
   stopPolling()
-  if (!pollingActive) return
+  if (!pollingActive || !resourceApi.document) return
   pollingTimer = setTimeout(() => {
     if (loading.value || operationLoading.value) {
       schedulePolling()
@@ -206,8 +205,9 @@ function schedulePolling() {
 
 function loadDocuments(showLoading = true): Promise<void> {
   stopPolling()
+  const requestApi = resourceApi.document
+  if (!requestApi) return Promise.resolve()
   if (showLoading) loading.value = true
-  const requestApi = isWorkspaceSharedResource() ? SharedDocumentApi : DocumentApi
   return requestApi
     .getDocumentPage(knowledgeId.value, paginationConfig.value, {
       ...documentQuery.value,
@@ -271,9 +271,11 @@ const operationLoading = ref(false)
 
 // 文档启停由服务端结果与列表刷新回显，避免开关提前修改状态。
 function handleChangeActive(document: DocumentItem) {
-  if (operationLoading.value) return false
+  const requestApi = requestSettingApi.value?.document
+  if (!requestApi || operationLoading.value) return false
   operationLoading.value = true
-  return DocumentApi.putDocument(knowledgeId.value, document.id, { is_active: !document.is_active })
+  return requestApi
+    .putDocument(knowledgeId.value, document.id, { is_active: !document.is_active })
     .then(() => {
       MsgSuccess('操作成功')
       return refreshAfterOperation().then(() => false)
@@ -292,10 +294,25 @@ function refreshAfterOperation() {
   return loadDocuments()
 }
 
-onMounted(() => {
-  pollingActive = true
-  loadDocuments()
-})
+watch(
+  [() => route.params.workspaceId, knowledgeId, resourceScope],
+  () => {
+    stopPolling()
+    pollingActive = true
+    clearDocumentSelection()
+    documentData.value = []
+    creatorOptions.value = []
+    documentTagOptions.value = []
+    documentQuery.value = {}
+    selectedDocumentStatus.value = null
+    selectedDocumentActive.value = null
+    selectedDocumentHitHandling.value = null
+    selectedDocumentTags.value = []
+    paginationConfig.value = { currentPage: 1, pageSize: 20, total: 0 }
+    void loadDocuments().catch(() => {})
+  },
+  { immediate: true },
+)
 
 onBeforeUnmount(() => {
   pollingActive = false
@@ -310,12 +327,16 @@ onBeforeUnmount(() => {
       <div class="flex-align-center gap-3">
         <MkComplexSearch :fields="searchFields" @change="handleSearchChange" />
         <!-- 查看工作流执行记录 -->
-        <ButtonExecutionRecord v-if="knowledgeType === KNOWLEDGE_TYPE_KEY.WORKFLOW" :api="WorkflowApi" :knowledge-id="knowledgeId" />
+        <ButtonExecutionRecord
+          v-if="requestSettingApi && knowledgeType === KNOWLEDGE_TYPE_KEY.WORKFLOW"
+          :api="requestSettingApi.workflow"
+          :knowledge-id="knowledgeId"
+        />
 
         <!-- 导入 Web、飞书或工作流文档 -->
         <ButtonImportDocument
-          v-if="!showQuickCreate && !isWorkspaceSharedResource()"
-          :api="DocumentApi"
+          v-if="!showQuickCreate && requestSettingApi"
+          :api="requestSettingApi.document"
           :knowledge-id="knowledgeId"
           :knowledge-type="knowledgeType"
           :folder-token="String(knowledge?.meta?.folder_token ?? '')"
@@ -324,8 +345,8 @@ onBeforeUnmount(() => {
         />
         <!-- 上传文档 -->
         <ButtonUploadDocument
-          v-if="showQuickCreate"
-          :api="DocumentApi"
+          v-if="showQuickCreate && requestSettingApi"
+          :api="requestSettingApi.document"
           :knowledge-id="knowledgeId"
           :file-count-limit="knowledge?.file_count_limit"
           :file-size-limit="knowledge?.file_size_limit"
@@ -334,7 +355,9 @@ onBeforeUnmount(() => {
       </div>
     </div>
   </Teleport>
+  <MkEmpty v-if="!resourceApi.document" description="暂不支持查看此知识库的文档" />
   <MkTable
+    v-else
     ref="documentTableRef"
     v-loading="loading || operationLoading"
     :data="documentData"
@@ -352,7 +375,7 @@ onBeforeUnmount(() => {
       <MkQuickCreate ref="quickCreateRef" text="快速创建空白文档" placeholder="请输入文档名称" @create="handleCreateDocument" />
     </template>
 
-    <el-table-column v-if="!isWorkspaceSharedResource()" type="selection" width="40" reserve-selection />
+    <el-table-column v-if="requestSettingApi" type="selection" width="40" reserve-selection />
 
     <el-table-column prop="name" label="文档名称" min-width="220" show-overflow-tooltip>
       <template #default="{ row }: { row: DocumentItem }">
@@ -360,7 +383,7 @@ onBeforeUnmount(() => {
         <MkEditName
           :key="row.id"
           v-model="row.name"
-          :disabled="isWorkspaceSharedResource()"
+          :disabled="!requestSettingApi"
           :maxlength="128"
           :validate="validateDocumentName"
           :save="(name) => saveDocumentName(row.id, name)"
@@ -423,10 +446,10 @@ onBeforeUnmount(() => {
       </template>
       <template #default="{ row }: { row: DocumentItem }">
         <DocumentTags
-          :api="DocumentApi"
+          :api="requestSettingApi?.document"
           :knowledge-id="knowledgeId"
           :document="row"
-          :disabled="isWorkspaceSharedResource()"
+          :disabled="!requestSettingApi"
           v-model:loading="operationLoading"
           @refresh="refreshAfterOperation"
         />
@@ -462,7 +485,7 @@ onBeforeUnmount(() => {
     <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">
+    <el-table-column v-if="requestSettingApi" label="操作" width="160" fixed="right">
       <template #default="{ row }: { row: DocumentItem }">
         <div class="flex-align-center" @click.stop>
           <!-- 启用或禁用文档 -->
@@ -473,7 +496,7 @@ onBeforeUnmount(() => {
           <div class="flex">
             <!-- 向量化或取消向量化 -->
             <EmbeddingDocumentAction
-              :api="DocumentApi"
+              :api="requestSettingApi.document"
               :knowledge-id="knowledgeId"
               :document="row"
               v-model:loading="operationLoading"
@@ -481,7 +504,7 @@ onBeforeUnmount(() => {
             />
             <!-- 分词索引或取消分词索引 -->
             <TokenizeDocumentAction
-              :api="DocumentApi"
+              :api="requestSettingApi.document"
               :knowledge-id="knowledgeId"
               v-model:loading="operationLoading"
               :document="row"
@@ -491,7 +514,7 @@ onBeforeUnmount(() => {
             <MkTableMoreDropdown>
               <!-- 生成或取消生成问题 -->
               <GenerateQuestionsAction
-                :api="DocumentApi"
+                :api="requestSettingApi.document"
                 v-model:loading="operationLoading"
                 :knowledge-id="knowledgeId"
                 :document="row"
@@ -501,7 +524,7 @@ onBeforeUnmount(() => {
               <DocumentTagsAction
                 label="标签设置"
                 icon="icon_tag"
-                :api="DocumentApi"
+                :api="requestSettingApi.document"
                 :knowledge-id="knowledgeId"
                 :document="row"
                 v-model:loading="operationLoading"
@@ -515,7 +538,7 @@ onBeforeUnmount(() => {
                   (knowledgeType === KNOWLEDGE_TYPE_KEY.WORKFLOW && row.meta?.source_type === 'web')
                 "
                 label="同步"
-                :api="DocumentApi"
+                :api="requestSettingApi.document"
                 :knowledge-id="knowledgeId"
                 :document="row"
                 v-model:loading="operationLoading"
@@ -526,7 +549,7 @@ onBeforeUnmount(() => {
               <SettingDocumentAction
                 label="设置"
                 icon="icon_setting"
-                :api="DocumentApi"
+                :api="requestSettingApi.document"
                 :knowledge-id="knowledgeId"
                 :document="row"
                 v-model:loading="operationLoading"
@@ -537,21 +560,26 @@ onBeforeUnmount(() => {
               <MigrateDocumentAction
                 label="迁移"
                 icon="icon_move2_outlined"
-                :api="DocumentApi"
+                :api="requestSettingApi.document"
                 :knowledge-id="knowledgeId"
                 :document-ids="[row.id]"
                 :disabled="operationLoading"
                 @refresh="refreshAfterOperation"
               />
               <!-- 导出文档 -->
-              <ExportDocumentAction label="导出" :api="DocumentApi" v-model:loading="operationLoading" :document="row" />
+              <ExportDocumentAction label="导出" :api="requestSettingApi.document" v-model:loading="operationLoading" :document="row" />
 
               <template v-if="knowledgeType === KNOWLEDGE_TYPE_KEY.BASE || knowledgeType === KNOWLEDGE_TYPE_KEY.WORKFLOW">
                 <!-- 下载原文档 -->
-                <DownloadDocumentAction :api="DocumentApi" :knowledge-id="knowledgeId" v-model:loading="operationLoading" :document="row" />
+                <DownloadDocumentAction
+                  :api="requestSettingApi.document"
+                  :knowledge-id="knowledgeId"
+                  v-model:loading="operationLoading"
+                  :document="row"
+                />
                 <!-- 替换原文档 -->
                 <ReplaceDocumentAction
-                  :api="DocumentApi"
+                  :api="requestSettingApi.document"
                   :knowledge-id="knowledgeId"
                   v-model:loading="operationLoading"
                   :document="row"
@@ -562,7 +590,7 @@ onBeforeUnmount(() => {
               <DeleteDocumentAction
                 divided
                 icon="icon_delete-trash_outlined"
-                :api="DocumentApi"
+                :api="requestSettingApi.document"
                 :knowledge-id="knowledgeId"
                 v-model:loading="operationLoading"
                 :document="row"
@@ -573,10 +601,10 @@ onBeforeUnmount(() => {
         </div>
       </template>
     </el-table-column>
-    <template v-if="!isWorkspaceSharedResource()" #footer-batch-actions>
+    <template v-if="requestSettingApi" #footer-batch-actions>
       <!-- 批量向量化 -->
       <BatchEmbeddingAction
-        :api="DocumentApi"
+        :api="requestSettingApi.document"
         :knowledge-id="knowledgeId"
         :document-ids="selectedDocumentIds"
         v-model:loading="operationLoading"
@@ -584,7 +612,7 @@ onBeforeUnmount(() => {
       />
       <!-- 批量分词索引 -->
       <BatchTokenizeAction
-        :api="DocumentApi"
+        :api="requestSettingApi.document"
         :knowledge-id="knowledgeId"
         v-model:loading="operationLoading"
         :document-ids="selectedDocumentIds"
@@ -592,7 +620,7 @@ onBeforeUnmount(() => {
       />
       <!-- 批量生成问题 -->
       <BatchGenerateQuestionsAction
-        :api="DocumentApi"
+        :api="requestSettingApi.document"
         v-model:loading="operationLoading"
         :knowledge-id="knowledgeId"
         :document-ids="selectedDocumentIds"
@@ -602,7 +630,7 @@ onBeforeUnmount(() => {
       <!-- 批量文档设置 -->
       <BatchSettingDocumentAction
         label="设置"
-        :api="DocumentApi"
+        :api="requestSettingApi.document"
         :knowledge-id="knowledgeId"
         :document-ids="selectedDocumentIds"
         v-model:loading="operationLoading"
@@ -611,7 +639,7 @@ onBeforeUnmount(() => {
       <!-- 为选中文档批量添加标签 -->
       <BatchDocumentTagsAction
         label="标签设置"
-        :api="DocumentApi"
+        :api="requestSettingApi.document"
         :knowledge-id="knowledgeId"
         :document-ids="selectedDocumentIds"
         v-model:loading="operationLoading"
@@ -630,7 +658,7 @@ onBeforeUnmount(() => {
             <BatchSyncDocumentAction
               v-if="knowledgeType === KNOWLEDGE_TYPE_KEY.WEB || knowledgeType === KNOWLEDGE_TYPE_KEY.LARK"
               label="同步"
-              :api="DocumentApi"
+              :api="requestSettingApi.document"
               :knowledge-id="knowledgeId"
               v-model:loading="operationLoading"
               :document-ids="selectedDocumentIds"
@@ -639,7 +667,7 @@ onBeforeUnmount(() => {
             <!-- 批量迁移文档 -->
             <MigrateDocumentAction
               label="迁移至"
-              :api="DocumentApi"
+              :api="requestSettingApi.document"
               :knowledge-id="knowledgeId"
               :document-ids="selectedDocumentIds"
               :disabled="operationLoading"
@@ -647,10 +675,15 @@ onBeforeUnmount(() => {
             />
 
             <!-- 批量导出文档 -->
-            <BatchExportDocumentAction label="导出" :api="DocumentApi" v-model:loading="operationLoading" :document-ids="selectedDocumentIds" />
+            <BatchExportDocumentAction
+              label="导出"
+              :api="requestSettingApi.document"
+              v-model:loading="operationLoading"
+              :document-ids="selectedDocumentIds"
+            />
             <!-- 批量取消向量化 -->
             <BatchCancelTaskAction
-              :api="DocumentApi"
+              :api="requestSettingApi.document"
               :knowledge-id="knowledgeId"
               v-model:loading="operationLoading"
               :document-ids="selectedDocumentIds"
@@ -661,7 +694,7 @@ onBeforeUnmount(() => {
             />
             <!-- 批量取消生成问题 -->
             <BatchCancelTaskAction
-              :api="DocumentApi"
+              :api="requestSettingApi.document"
               :knowledge-id="knowledgeId"
               v-model:loading="operationLoading"
               :document-ids="selectedDocumentIds"
@@ -671,7 +704,7 @@ onBeforeUnmount(() => {
             />
             <!-- 批量删除文档 -->
             <DeleteDocumentAction
-              :api="DocumentApi"
+              :api="requestSettingApi.document"
               :knowledge-id="knowledgeId"
               v-model:loading="operationLoading"
               :document-ids="selectedDocumentIds"
diff --git a/ui/src/views/knowledge-detail/library/tags/components/ButtonImportTags.vue b/ui/src/views/knowledge-detail/library/tags/components/ButtonImportTags.vue
index 1e9d1f3cb45..89a6c97b2f8 100644
--- a/ui/src/views/knowledge-detail/library/tags/components/ButtonImportTags.vue
+++ b/ui/src/views/knowledge-detail/library/tags/components/ButtonImportTags.vue
@@ -96,14 +96,19 @@ function handleImport() {
     <span>导入</span>
   </el-button>
   <MkDialog v-model="visible" title="导入标签" @closed="resetData">
-    <el-form ref="importFormRef" v-loading="loading" :model="importForm" :rules="rules" label-position="top" @submit.prevent>
-      <el-form-item prop="files" :required="false">
+    <el-form
+      ref="importFormRef"
+      v-loading="loading"
+      :model="importForm"
+      :rules="rules"
+      label-position="top"
+      require-asterisk-position="right"
+      @submit.prevent
+    >
+      <el-form-item prop="files" class="mk-hide-asterisk">
         <template #label>
           <div class="flex-between w-full">
-            <span>
-              上传文件
-              <span class="ml-1 text-danger">*</span>
-            </span>
+            <span class="mk-required">上传文件</span>
             <!-- 下载标签导入模板 -->
             <el-button link type="primary" :loading="downloadLoading" :disabled="loading" @click="handleDownloadTemplate">下载模板</el-button>
           </div>
@@ -120,9 +125,9 @@ function handleImport() {
     </el-form>
     <template #footer>
       <!-- 取消标签导入 -->
-      <el-button plain :disabled="loading || downloadLoading" @click="visible = false">取消</el-button>
+      <el-button plain :disabled="loading" @click="visible = false">取消</el-button>
       <!-- 导入标签 -->
-      <el-button type="primary" :loading="loading" :disabled="!importForm.files.length || downloadLoading" @click="handleImport">导入</el-button>
+      <el-button type="primary" :loading="loading" :disabled="!importForm.files.length" @click="handleImport">导入</el-button>
     </template>
   </MkDialog>
 </template>
diff --git a/ui/src/views/knowledge-detail/library/tags/components/CreateTagDialog.vue b/ui/src/views/knowledge-detail/library/tags/components/CreateTagDialog.vue
index a27202100d8..aa0bdd81a6f 100644
--- a/ui/src/views/knowledge-detail/library/tags/components/CreateTagDialog.vue
+++ b/ui/src/views/knowledge-detail/library/tags/components/CreateTagDialog.vue
@@ -1,15 +1,13 @@
 <script setup lang="ts">
 import { computed, reactive, ref } from 'vue'
-import type { FormInstance, FormItemRule } from 'element-plus'
-import TagsApi from '@/api/admin/workspace/knowledge/tags'
+import type { FormInstance } from 'element-plus'
+import type TagsApi from '@/api/admin/workspace/knowledge/tags'
 import type { KnowledgeTagPayload } from '@/api/types'
-import { MsgSuccess } from '@/utils/message'
+import { MsgError, MsgSuccess } from '@/utils/message'
 
 defineOptions({ name: 'CreateTagDialog' })
 
-const props = withDefaults(defineProps<{ knowledgeId: string; api?: typeof TagsApi }>(), {
-  api: () => TagsApi,
-})
+const props = defineProps<{ knowledgeId: string; api: typeof TagsApi }>()
 const emit = defineEmits<{ refresh: [] }>()
 
 const visible = ref(false)
@@ -29,24 +27,6 @@ function open(key?: string) {
   visible.value = true
 }
 
-function getTagValueRules(index: number): FormItemRule[] {
-  return [
-    { required: true, whitespace: true, message: '请输入标签值', trigger: 'blur' },
-    {
-      validator: (_rule, _value, callback) => {
-        const tag = tagForm.tags[index]
-        const duplicate =
-          tag &&
-          tagForm.tags.some(
-            (other, otherIndex) => otherIndex !== index && other.key.trim() === tag.key.trim() && other.value.trim() === tag.value.trim(),
-          )
-        callback(duplicate ? new Error('相同标签下的标签值不能重复') : undefined)
-      },
-      trigger: 'blur',
-    },
-  ]
-}
-
 function handleRowsChange() {
   formRef.value?.clearValidate()
 }
@@ -57,6 +37,13 @@ function handleSubmit() {
   return formRef.value?.validate((valid) => {
     if (!valid || loading.value || !tagForm.tags.length) return
     const tags = tagForm.tags.map((tag) => ({ key: fixedTagKey.value || tag.key.trim(), value: tag.value.trim() }))
+    const duplicateTag = tags.find((tag, index) =>
+      tags.some((other, otherIndex) => otherIndex !== index && other.key === tag.key && other.value === tag.value),
+    )
+    if (duplicateTag) {
+      MsgError(`标签已存在`)
+      return
+    }
 
     loading.value = true
     return props.api
@@ -72,10 +59,6 @@ function handleSubmit() {
   })
 }
 
-function handleBeforeClose(done: () => void) {
-  if (!loading.value) done()
-}
-
 function resetData() {
   tagForm.tags = [{ key: '', value: '' }]
   fixedTagKey.value = ''
@@ -87,7 +70,7 @@ defineExpose({ open })
 </script>
 
 <template>
-  <MkDialog v-model="visible" :title="title" :before-close="handleBeforeClose" @closed="resetData">
+  <MkDialog v-model="visible" :title="title" @closed="resetData">
     <el-form ref="formRef" v-loading="loading" :model="tagForm" label-position="top" @submit.prevent>
       <MkFormList v-model="tagForm.tags" :default-item="defaultTag" @update:model-value="handleRowsChange">
         <template #default="{ index, item: tag }">
@@ -99,7 +82,12 @@ defineExpose({ open })
           >
             <el-input v-model="tag.key" :disabled="!!fixedTagKey" :maxlength="64" placeholder="请输入标签" />
           </el-form-item>
-          <el-form-item class="min-w-0 flex-1" :label="index === 0 ? '标签值' : ''" :prop="`tags.${index}.value`" :rules="getTagValueRules(index)">
+          <el-form-item
+            class="min-w-0 flex-1"
+            :label="index === 0 ? '标签值' : ''"
+            :prop="`tags.${index}.value`"
+            :rules="{ required: true, whitespace: true, message: '请输入标签值', trigger: 'blur' }"
+          >
             <el-input v-model="tag.value" :maxlength="128" placeholder="请输入标签值" />
           </el-form-item>
         </template>
diff --git a/ui/src/views/knowledge-detail/library/tags/index.vue b/ui/src/views/knowledge-detail/library/tags/index.vue
index 9220bb62143..01a3f292fdb 100644
--- a/ui/src/views/knowledge-detail/library/tags/index.vue
+++ b/ui/src/views/knowledge-detail/library/tags/index.vue
@@ -1,10 +1,9 @@
 <script setup lang="ts">
-import { computed, onMounted, ref } from 'vue'
+import { computed, watch, ref } from 'vue'
 import { useRoute } from 'vue-router'
 import type { TableColumnCtx } from 'element-plus'
 import type { ResourceDetailPageProps } from '@/layout/ResourceDetailLayout.vue'
-import TagsApi from '@/api/admin/workspace/knowledge/tags'
-import DocumentApi from '@/api/admin/workspace/knowledge/document'
+import { useKnowledgeLibraryContext } from '../../context'
 import type { KnowledgeTagGroup, KnowledgeTagUpdatePayload } from '@/api/types'
 import { MsgConfirm, MsgSuccess } from '@/utils/message'
 import CreateTagDialog from './components/CreateTagDialog.vue'
@@ -21,6 +20,7 @@ interface TagTableRow extends KnowledgeTagUpdatePayload {
   rowspan: number
 }
 
+const { resourceApi, resourceScope, requestSettingApi } = useKnowledgeLibraryContext()
 const route = useRoute()
 const knowledgeId = computed(() => String(route.params.knowledgeId ?? ''))
 const loading = ref(false)
@@ -53,11 +53,17 @@ function clearSelection() {
 
 function loadTags() {
   clearSelection()
+  const requestApi = resourceApi.tags
+  if (!requestApi) return Promise.resolve()
   loading.value = true
-  return TagsApi.getKnowledgeTags(knowledgeId.value, { name: searchText.value.trim() || undefined })
+  const keyword = searchText.value.trim()
+  const tagsRequest = requestSettingApi.value?.tags
+    ? requestSettingApi.value?.tags.getKnowledgeTags(knowledgeId.value, { name: keyword || undefined })
+    : requestApi.getKnowledgeTags(knowledgeId.value)
+  return tagsRequest
     .then((groups) => {
-      tagGroups.value = groups
-      const lastPage = Math.max(1, Math.ceil(groups.length / tagPage.value.pageSize))
+      tagGroups.value = keyword ? groups.filter((group) => group.key.includes(keyword)) : groups
+      const lastPage = Math.max(1, Math.ceil(tagGroups.value.length / tagPage.value.pageSize))
       tagPage.value.currentPage = Math.min(tagPage.value.currentPage, lastPage)
     })
     .finally(() => {
@@ -114,16 +120,15 @@ function handleOpenTagDocuments(row: TagTableRow) {
 
 /* 删除只在确认后提交，标签删除与文档取消关联使用不同接口。 */
 function handleDeleteTag(row: TagTableRow, type: 'key' | 'one') {
-  if (loading.value || operationLoading.value) return
+  const requestApi = requestSettingApi.value?.tags
+  if (!requestApi || loading.value || operationLoading.value) return
   const tagName = type === 'key' ? row.key : `${row.key}—${row.value}`
-  const tip =
-    type === 'key'
-      ? '删除后，使用该标签的文档将移除此标签及其全部标签值，文档本身不会删除，请谨慎操作！'
-      : '删除后，使用该标签值的文档将移除此标签值，文档本身不会删除，请谨慎操作！'
+  const tip = type === 'key' ? '删除后使用该标签的资源将会删除该标签，请谨慎操作!' : '删除后使用该标签的资源将会删除该标签，请谨慎操作!'
   return MsgConfirm(`是否删除标签：${tagName}？`, tip).then(
     () => {
       operationLoading.value = true
-      return TagsApi.deleteKnowledgeTag(knowledgeId.value, row.id, type)
+      return requestApi
+        .deleteKnowledgeTag(knowledgeId.value, row.id, type)
         .then(() => {
           MsgSuccess('删除成功')
           return loadTags()
@@ -137,16 +142,14 @@ function handleDeleteTag(row: TagTableRow, type: 'key' | 'one') {
 }
 
 function handleBatchDelete() {
-  if (loading.value || operationLoading.value || !selectedTags.value.length) return
+  const requestApi = requestSettingApi.value?.tags
+  if (!requestApi || loading.value || operationLoading.value || !selectedTags.value.length) return
   const tagIds = selectedTags.value.map(({ id }) => id)
-  const groupCount = new Set(selectedTags.value.map(({ key }) => key)).size
-  return MsgConfirm(
-    `是否删除选中的 ${tagIds.length} 个标签值（涉及 ${groupCount} 个标签）？`,
-    '将删除选中记录所属的标签及其全部标签值，并移除文档上的对应标签；文档本身不会删除，请谨慎操作！',
-  ).then(
+  return MsgConfirm(`是否删除选中的 ${tagIds.length} 个标签？`, '删除后，使用该标签的资源将会删除该标签，请谨慎操作！').then(
     () => {
       operationLoading.value = true
-      return TagsApi.putBatchDeleteKnowledgeTags(knowledgeId.value, tagIds)
+      return requestApi
+        .putBatchDeleteKnowledgeTags(knowledgeId.value, tagIds)
         .then(() => {
           MsgSuccess('删除成功')
           return loadTags()
@@ -159,9 +162,17 @@ function handleBatchDelete() {
   )
 }
 
-onMounted(() => {
-  loadTags()
-})
+watch(
+  [() => route.params.workspaceId, knowledgeId, resourceScope],
+  () => {
+    clearSelection()
+    tagGroups.value = []
+    searchText.value = ''
+    tagPage.value = { currentPage: 1, pageSize: 10 }
+    void loadTags().catch(() => {})
+  },
+  { immediate: true },
+)
 </script>
 
 <template>
@@ -171,9 +182,15 @@ onMounted(() => {
       <div class="flex-align-center">
         <MkSearchInput v-model="searchText" class="mr-3 w-60!" @change="handleSearchChange" />
         <!-- 导入标签，成功后刷新列表 -->
-        <ButtonImportTags :api="TagsApi" :knowledge-id="knowledgeId" :disabled="loading || operationLoading" @refresh="loadTags" />
+        <ButtonImportTags
+          v-if="requestSettingApi"
+          :api="requestSettingApi.tags"
+          :knowledge-id="knowledgeId"
+          :disabled="loading || operationLoading"
+          @refresh="loadTags"
+        />
         <!-- 创建标签 -->
-        <el-button type="primary" :disabled="loading || operationLoading" @click="handleOpenCreateTag">
+        <el-button v-if="requestSettingApi" type="primary" :disabled="loading || operationLoading" @click="handleOpenCreateTag">
           <MkIcon name="icon_add_outlined" />
           <span>创建</span>
         </el-button>
@@ -194,12 +211,12 @@ onMounted(() => {
     @cell-mouse-enter="handleCellEnter"
     @cell-mouse-leave="handleCellLeave"
   >
-    <el-table-column type="selection" width="40" />
+    <el-table-column v-if="requestSettingApi" type="selection" width="40" />
     <el-table-column prop="key" label="标签" min-width="240">
       <template #default="{ row }: { row: TagTableRow }">
         <div class="flex-align-center gap-1">
           <span class="min-w-0 truncate" :title="row.key">{{ row.key }}</span>
-          <div class="flex-align-center shrink-0" :class="{ 'group-hover-visible': hoveredTagKey !== row.key }">
+          <div v-if="requestSettingApi" class="flex-align-center shrink-0" :class="{ 'group-hover-visible': hoveredTagKey !== row.key }">
             <!-- 添加标签值 -->
             <MkTooltip content="添加标签值" placement="top">
               <el-button type="primary" text @click="handleOpenAddTagValue(row)">
@@ -226,10 +243,13 @@ onMounted(() => {
     <el-table-column prop="doc_count" label="已关联文档" min-width="140">
       <template #default="{ row }: { row: TagTableRow }">
         <!-- 查看标签关联文档 -->
-        <el-button type="primary" link class="mk-link" @click="handleOpenTagDocuments(row)">{{ row.doc_count ?? 0 }}</el-button>
+        <el-button v-if="requestSettingApi" type="primary" link class="mk-link" @click="handleOpenTagDocuments(row)">
+          {{ row.doc_count ?? 0 }}
+        </el-button>
+        <span v-else>{{ row.doc_count ?? 0 }}</span>
       </template>
     </el-table-column>
-    <el-table-column label="操作" width="100" fixed="right">
+    <el-table-column v-if="requestSettingApi" label="操作" width="100" fixed="right">
       <template #default="{ row }: { row: TagTableRow }">
         <div class="flex-align-center">
           <!-- 编辑标签值 -->
@@ -247,12 +267,18 @@ onMounted(() => {
         </div>
       </template>
     </el-table-column>
-    <template #footer-batch-actions>
+    <template v-if="requestSettingApi" #footer-batch-actions>
       <!-- 批量删除标签 -->
       <el-button type="danger" plain :loading="operationLoading" @click="handleBatchDelete">删除</el-button>
     </template>
   </MkTable>
-  <CreateTagDialog ref="createTagRef" :api="TagsApi" :knowledge-id="knowledgeId" @refresh="loadTags" />
-  <EditTagDialog ref="editTagRef" :api="TagsApi" :knowledge-id="knowledgeId" @refresh="loadTags" />
-  <TagDocumentDrawer ref="tagDocumentRef" :api="DocumentApi" :knowledge-id="knowledgeId" @refresh="loadTags" />
+  <CreateTagDialog v-if="requestSettingApi" ref="createTagRef" :api="requestSettingApi.tags" :knowledge-id="knowledgeId" @refresh="loadTags" />
+  <EditTagDialog v-if="requestSettingApi" ref="editTagRef" :api="requestSettingApi.tags" :knowledge-id="knowledgeId" @refresh="loadTags" />
+  <TagDocumentDrawer
+    v-if="requestSettingApi"
+    ref="tagDocumentRef"
+    :api="requestSettingApi.document"
+    :knowledge-id="knowledgeId"
+    @refresh="loadTags"
+  />
 </template>
diff --git a/ui/src/views/system/chat-management/users/import-users/ImportUsersDialog.vue b/ui/src/views/system/chat-management/users/import-users/ImportUsersDialog.vue
index a02c2c81a49..88ea4584f0e 100644
--- a/ui/src/views/system/chat-management/users/import-users/ImportUsersDialog.vue
+++ b/ui/src/views/system/chat-management/users/import-users/ImportUsersDialog.vue
@@ -149,7 +149,7 @@ defineExpose({ open })
 
 <template>
   <MkDialog v-model="dialogVisible" title="导入用户" @closed="resetData">
-    <template #subtitle> 从已配置的用户来源同步对话用户，已存在的用户名或姓名不会重复导入。 </template>
+    <template #subtitle>从已配置的用户来源同步对话用户，已存在的用户名或姓名不会重复导入。</template>
 
     <el-form
       ref="importUsersFormRef"
@@ -170,10 +170,10 @@ defineExpose({ open })
         </el-select>
       </el-form-item>
 
-      <el-form-item v-if="isLocalFileSource" prop="files" :required="false">
+      <el-form-item v-if="isLocalFileSource" prop="files" class="mk-hide-asterisk">
         <template #label>
           <div class="flex-between w-full">
-            <span>上传文件<span class="ml-1 text-danger">*</span></span>
+            <span class="mk-required">上传文件</span>
             <el-button link type="primary" @click="handleDownloadTemplate">下载模板</el-button>
           </div>
         </template>
diff --git a/ui/src/views/system/identity/users/import-users/ButtonImportUsers.vue b/ui/src/views/system/identity/users/import-users/ButtonImportUsers.vue
index 0b828a61210..e02e52e1d33 100644
--- a/ui/src/views/system/identity/users/import-users/ButtonImportUsers.vue
+++ b/ui/src/views/system/identity/users/import-users/ButtonImportUsers.vue
@@ -13,7 +13,7 @@ function handleOpenDialog() {
 </script>
 
 <template>
-  <el-button plain class="ml-3" @click="handleOpenDialog">
+  <el-button plain @click="handleOpenDialog">
     <MkIcon name="icon_import_outlined" />
     <span>导入用户</span>
   </el-button>
diff --git a/ui/src/views/system/identity/users/import-users/ImportUsersDialog.vue b/ui/src/views/system/identity/users/import-users/ImportUsersDialog.vue
index 861b187d0cd..a0243a1ac3b 100644
--- a/ui/src/views/system/identity/users/import-users/ImportUsersDialog.vue
+++ b/ui/src/views/system/identity/users/import-users/ImportUsersDialog.vue
@@ -261,13 +261,10 @@ defineExpose({ open })
         </el-select>
       </el-form-item>
 
-      <el-form-item v-if="isLocalFileSource" prop="files" :required="false">
+      <el-form-item v-if="isLocalFileSource" prop="files" class="mk-hide-asterisk">
         <template #label>
           <div class="flex-between w-full">
-            <span>
-              上传文件
-              <span class="ml-1 text-danger">*</span>
-            </span>
+            <span class="mk-required">上传文件</span>
             <el-button link type="primary" @click="handleDownloadTemplate">下载模板</el-button>
           </div>
         </template>
diff --git a/ui/src/views/system/identity/users/index.vue b/ui/src/views/system/identity/users/index.vue
index 4a0083d311f..e33ab0a7767 100644
--- a/ui/src/views/system/identity/users/index.vue
+++ b/ui/src/views/system/identity/users/index.vue
@@ -135,10 +135,13 @@ onMounted(() => loadSystemUsers())
     <template #default="{ title, Header }">
       <component :is="Header">
         <h4>{{ title }}</h4>
-        <div class="flex-align-center">
+        <div class="flex-align-center gap-3">
           <MkComplexSearch :fields="searchFields" @change="handleSearchChange" />
           <!-- 导入用户 -->
-          <ButtonImportUsers v-if="perm.system.user.import()" @refresh="loadSystemUsers()" />
+          <span>
+            <ButtonImportUsers v-if="perm.system.user.import()" @refresh="loadSystemUsers()" />
+          </span>
+
           <!-- 创建用户 -->
           <el-button v-if="perm.system.user.create()" type="primary" @click="handleOpenUserFormDrawer()">
             <MkIcon name="icon_add_outlined" />
diff --git a/ui/src/views/trigger/trigger-form/task-execution/components/TaskParameterForm.vue b/ui/src/views/trigger/trigger-form/task-execution/components/TaskParameterForm.vue
index 87272a00926..27c5fc8ee2a 100644
--- a/ui/src/views/trigger/trigger-form/task-execution/components/TaskParameterForm.vue
+++ b/ui/src/views/trigger/trigger-form/task-execution/components/TaskParameterForm.vue
@@ -155,17 +155,28 @@ defineExpose({ validate })
 </script>
 
 <template>
-  <el-form class="space-y-2!" ref="formRef" :model="parameters" :disabled="disabled" label-position="top" hide-required-asterisk @submit.prevent>
+  <el-form
+    class="space-y-2!"
+    ref="formRef"
+    :model="parameters"
+    :disabled="disabled"
+    label-position="top"
+    require-asterisk-position="right"
+    @submit.prevent
+  >
     <el-form-item
       v-for="field in fields"
       :key="JSON.stringify(field.path)"
       :prop="[...field.path, 'value']"
       :label="field.label"
       :rules="getParameterRules(field)"
+      class="mk-hide-asterisk"
     >
       <template #label>
         <div class="flex-between w-full">
-          <span>{{ field.label }}<span v-if="field.required" class="ml-1 text-danger">*</span></span>
+          <span :class="field.required ? 'mk-required' : ''">
+            {{ field.label }}
+          </span>
           <el-select
             v-if="showSource"
             v-model="getTaskParameter(parameters, field).source"