From 219fa566ef770f3b7b0330c842eef1a5f617da86 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=99=88=E5=AD=90=E9=BB=98?= <925456043@qq.com>
Date: Wed, 11 Mar 2026 20:30:36 +0800
Subject: [PATCH] =?UTF-8?q?perf:=20=E5=8D=A1=E7=89=87=E5=85=A5=E5=8F=A3?=
 =?UTF-8?q?=E8=A7=86=E8=A7=89=E6=95=88=E6=9E=9C=E9=87=8D=E5=81=9A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../app/src/components/page/CardList.vue      | 420 +++++++++++++-----
 .../app/src/views/ai/bots/index.vue           |  41 +-
 .../documentCollection/DocumentCollection.vue |  81 ++--
 .../src/views/ai/plugin/AddPluginModal.vue    |  92 +++-
 .../app/src/views/ai/plugin/Plugin.vue        |  67 ++-
 .../src/views/ai/workflow/WorkflowList.vue    |  65 ++-
 6 files changed, 507 insertions(+), 259 deletions(-)

diff --git a/easyflow-ui-admin/app/src/components/page/CardList.vue b/easyflow-ui-admin/app/src/components/page/CardList.vue
index e09d1de..0e97ef4 100644
--- a/easyflow-ui-admin/app/src/components/page/CardList.vue
+++ b/easyflow-ui-admin/app/src/components/page/CardList.vue
@@ -8,7 +8,6 @@ import {
   ElAvatar,
   ElButton,
   ElCard,
-  ElDivider,
   ElDropdown,
   ElDropdownItem,
   ElDropdownMenu,
@@ -17,14 +16,31 @@ import {
   ElText,
 } from 'element-plus';
 
+export type ActionPlacement = 'inline' | 'menu';
+export type ActionTone = 'danger' | 'default';
+
 export interface ActionButton {
-  icon: any;
+  icon?: any;
   text: string;
-  className: string;
-  permission: string;
+  className?: string;
+  permission?: string;
+  placement?: ActionPlacement;
+  tone?: ActionTone;
   onClick: (row: any) => void;
 }
 
+export interface CardPrimaryAction {
+  icon?: any;
+  text: string;
+  permission?: string;
+  onClick: (row: any) => void;
+}
+
+interface ResolvedActionButton extends ActionButton {
+  placement: ActionPlacement;
+  tone: ActionTone;
+}
+
 export interface CardListProps {
   iconField?: string;
   titleField?: string;
@@ -32,125 +48,185 @@ export interface CardListProps {
   actions?: ActionButton[];
   defaultIcon: any;
   data: any[];
+  primaryAction?: CardPrimaryAction;
   tagField?: string;
   tagMap?: Record<string, string>;
 }
+
 const props = withDefaults(defineProps<CardListProps>(), {
   iconField: 'icon',
   titleField: 'title',
   descField: 'description',
   actions: () => [],
+  primaryAction: undefined,
   tagField: '',
   tagMap: () => ({}),
 });
+
 const { hasAccessByCodes } = useAccess();
-const filterActions = computed(() => {
-  return props.actions.filter((action) => {
-    return hasAccessByCodes([action.permission]);
-  });
+
+function hasPermission(permission?: string) {
+  return !permission || hasAccessByCodes([permission]);
+}
+
+const resolvedPrimaryAction = computed(() => {
+  if (!props.primaryAction || !hasPermission(props.primaryAction.permission)) {
+    return undefined;
+  }
+  return props.primaryAction;
 });
-const visibleActions = computed(() => {
-  return filterActions.value.length <= 3
-    ? filterActions.value
-    : filterActions.value.slice(0, 3);
+
+const resolvedActions = computed<ResolvedActionButton[]>(() => {
+  return props.actions
+    .filter((action) => hasPermission(action.permission))
+    .map((action, index) => ({
+      ...action,
+      placement:
+        action.placement ||
+        (resolvedPrimaryAction.value ? 'menu' : index < 3 ? 'inline' : 'menu'),
+      tone:
+        action.tone ||
+        (action.className?.includes('danger') ? 'danger' : 'default'),
+    }));
 });
-const hiddenActions = computed(() => {
-  return filterActions.value.length > 3 ? filterActions.value.slice(3) : [];
+
+const inlineActions = computed(() => {
+  return resolvedActions.value.filter((action) => action.placement === 'inline');
 });
+
+const menuActions = computed(() => {
+  return resolvedActions.value.filter((action) => action.placement === 'menu');
+});
+
+const showFooter = computed(() => {
+  return Boolean(
+    resolvedPrimaryAction.value ||
+      inlineActions.value.length ||
+      menuActions.value.length,
+  );
+});
+
+function handlePrimaryAction(item: any) {
+  resolvedPrimaryAction.value?.onClick(item);
+}
+
+function handleActionClick(event: Event, action: ActionButton, item: any) {
+  event.stopPropagation();
+  action.onClick(item);
+}
 </script>
 
 <template>
   <div class="card-grid">
     <ElCard
       v-for="(item, index) in props.data"
-      :key="index"
-      shadow="hover"
-      footer-class="foot-c"
-      :style="{
-        '--el-box-shadow-light': '0px 2px 12px 0px rgb(100 121 153 10%)',
-      }"
+      :key="item.id ?? index"
+      shadow="never"
+      :class="['card-item', { 'card-item--interactive': resolvedPrimaryAction }]"
+      :role="resolvedPrimaryAction ? 'button' : undefined"
+      :tabindex="resolvedPrimaryAction ? 0 : undefined"
+      @click="handlePrimaryAction(item)"
+      @keydown.enter.prevent="handlePrimaryAction(item)"
+      @keydown.space.prevent="handlePrimaryAction(item)"
     >
-      <div class="flex flex-col gap-3">
-        <div class="flex items-center gap-3">
+      <div class="card-content">
+        <div class="card-header">
           <ElAvatar
-            class="shrink-0"
+            class="card-avatar shrink-0"
             :src="item[iconField] || defaultIcon"
-            :size="36"
+            :size="44"
           />
-          <div class="title-row">
-            <ElText truncated size="large" class="font-medium">
-              {{ item[titleField] }}
+          <div class="card-meta">
+            <div class="title-row">
+              <ElText truncated size="large" class="card-title">
+                {{ item[titleField] }}
+              </ElText>
+              <ElTag
+                v-if="tagField && item[tagField]"
+                size="small"
+                effect="plain"
+                type="info"
+              >
+                {{ tagMap[item[tagField]] || item[tagField] }}
+              </ElTag>
+            </div>
+            <ElText line-clamp="2" class="item-desc w-full">
+              {{ item[descField] }}
             </ElText>
-            <ElTag
-              v-if="tagField && item[tagField]"
-              size="small"
-              effect="plain"
-              type="info"
-            >
-              {{ tagMap[item[tagField]] || item[tagField] }}
-            </ElTag>
           </div>
         </div>
-        <ElText line-clamp="2" class="item-desc w-full">
-          {{ item[descField] }}
-        </ElText>
       </div>
-      <template #footer>
-        <div :class="visibleActions.length > 2 ? 'footer-div' : ''">
-          <template v-for="(action, idx) in visibleActions" :key="idx">
+
+      <template v-if="showFooter" #footer>
+        <div class="card-footer">
+          <div v-if="resolvedPrimaryAction" class="card-primary-hint">
+            <div class="primary-label">
+              <ElIcon v-if="resolvedPrimaryAction.icon" class="primary-icon">
+                <IconifyIcon
+                  v-if="typeof resolvedPrimaryAction.icon === 'string'"
+                  :icon="resolvedPrimaryAction.icon"
+                />
+                <component v-else :is="resolvedPrimaryAction.icon" />
+              </ElIcon>
+              <span class="primary-text">{{ resolvedPrimaryAction.text }}</span>
+            </div>
+          </div>
+
+          <div
+            v-if="inlineActions.length || menuActions.length"
+            class="card-actions"
+            @click.stop
+          >
             <ElButton
+              v-for="action in inlineActions"
+              :key="action.text"
               :icon="typeof action.icon === 'string' ? undefined : action.icon"
               size="small"
-              :style="{
-                '--el-button-text-color': 'hsl(220deg 9.68% 63.53%)',
-                '--el-button-font-weight': 400,
-              }"
+              class="card-action-btn"
+              :class="{ 'card-action-btn--danger': action.tone === 'danger' }"
               link
-              @click="action.onClick(item)"
+              @click.stop="handleActionClick($event, action, item)"
             >
               <template v-if="typeof action.icon === 'string'" #icon>
                 <IconifyIcon :icon="action.icon" />
               </template>
               {{ action.text }}
             </ElButton>
-            <ElDivider
-              v-if="
-                filterActions.length <= 3
-                  ? idx < filterActions.length - 1
-                  : true
-              "
-              direction="vertical"
-            />
-          </template>
 
-          <ElDropdown v-if="hiddenActions.length > 0" trigger="click">
-            <ElButton
-              :style="{
-                '--el-button-text-color': 'hsl(220deg 9.68% 63.53%)',
-                '--el-button-font-weight': 400,
-              }"
-              :icon="MoreFilled"
-              link
-            />
-            <template #dropdown>
-              <ElDropdownMenu>
-                <ElDropdownItem
-                  v-for="(action, idx) in hiddenActions"
-                  :key="idx"
-                  @click="action.onClick(item)"
-                >
-                  <template #default>
-                    <div :class="`${action.className} handle-div`">
+            <ElDropdown
+              v-if="menuActions.length > 0"
+              trigger="click"
+              placement="bottom-end"
+            >
+              <ElButton
+                class="card-action-btn card-action-btn--menu"
+                :icon="MoreFilled"
+                link
+                @click.stop
+              />
+              <template #dropdown>
+                <ElDropdownMenu>
+                  <ElDropdownItem
+                    v-for="action in menuActions"
+                    :key="action.text"
+                    :class="{ 'card-menu-item--danger': action.tone === 'danger' }"
+                    @click="action.onClick(item)"
+                  >
+                    <div class="menu-action-content">
                       <ElIcon v-if="action.icon">
-                        <component :is="action.icon" />
+                        <IconifyIcon
+                          v-if="typeof action.icon === 'string'"
+                          :icon="action.icon"
+                        />
+                        <component v-else :is="action.icon" />
                       </ElIcon>
-                      {{ action.text }}
+                      <span>{{ action.text }}</span>
                     </div>
-                  </template>
-                </ElDropdownItem>
-              </ElDropdownMenu>
-            </template>
-          </ElDropdown>
+                  </ElDropdownItem>
+                </ElDropdownMenu>
+              </template>
+            </ElDropdown>
+          </div>
         </div>
       </template>
     </ElCard>
@@ -158,68 +234,184 @@ const hiddenActions = computed(() => {
 </template>
 
 <style scoped>
-/* 响应式调整 */
 @media (max-width: 1024px) {
   .card-grid {
-    grid-template-columns: repeat(auto-fill, minmax(250px, 1fr));
+    grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
   }
 }
 
 @media (max-width: 768px) {
   .card-grid {
-    grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
+    grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
+    min-width: 100%;
   }
 }
 
 @media (max-width: 480px) {
   .card-grid {
-    grid-template-columns: repeat(auto-fill, minmax(150px, 1fr));
+    grid-template-columns: minmax(0, 1fr);
   }
 }
 
-:deep(.el-card__footer) {
-  border-top: none;
-}
-
-.footer-div {
-  display: flex;
-  justify-content: space-between;
-  padding: 8px 20px;
-  background-color: hsl(var(--background-deep));
-  border-radius: 8px;
-}
-
-.handle-div {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  margin-bottom: 0;
-}
-
 .card-grid {
   display: grid;
-  grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
+  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
   gap: 20px;
-  min-width: max(100%, 600px); /* 确保至少显示2个卡片 */
+  min-width: max(100%, 600px);
 }
 
-.item-desc {
-  height: 40px;
-  font-size: clamp(8px, 1vw, 14px);
-  line-height: 20px;
-  color: #75808d;
+.card-item {
+  background: hsl(var(--card));
+  border: 1px solid hsl(var(--border));
+  border-radius: 18px;
+  transition:
+    transform 0.18s ease,
+    box-shadow 0.18s ease,
+    border-color 0.18s ease,
+    background-color 0.18s ease;
 }
 
-.item-danger {
-  color: var(--el-color-danger);
+.card-item--interactive {
+  cursor: pointer;
+}
+
+.card-item--interactive:hover {
+  border-color: hsl(var(--primary) / 20%);
+  box-shadow: var(--shadow-subtle);
+  transform: translateY(-2px);
+}
+
+.card-item--interactive:focus-visible {
+  outline: none;
+  border-color: hsl(var(--primary) / 32%);
+  box-shadow:
+    0 0 0 4px hsl(var(--primary) / 12%),
+    var(--shadow-subtle);
+}
+
+:deep(.el-card__body) {
+  padding: 18px;
+}
+
+:deep(.el-card__footer) {
+  padding: 0 18px 18px;
+  border-top: none;
+}
+
+.card-content {
+  display: flex;
+  min-height: 116px;
+}
+
+.card-header {
+  display: flex;
+  gap: 14px;
+  align-items: flex-start;
+  width: 100%;
+}
+
+.card-avatar {
+  background: hsl(var(--surface-subtle));
+  border: 1px solid hsl(var(--line-subtle));
+}
+
+.card-meta {
+  display: flex;
+  flex: 1;
+  flex-direction: column;
+  gap: 10px;
+  min-width: 0;
 }
 
 .title-row {
   display: flex;
-  flex: 1;
+  flex-wrap: wrap;
   gap: 8px;
   align-items: center;
-  justify-content: space-between;
   min-width: 0;
 }
+
+.card-title {
+  font-weight: 600;
+  color: hsl(var(--text-strong));
+}
+
+.item-desc {
+  min-height: 44px;
+  font-size: 13px;
+  line-height: 22px;
+  color: hsl(var(--text-muted));
+}
+
+.card-footer {
+  display: flex;
+  gap: 12px;
+  align-items: center;
+  justify-content: space-between;
+  padding-top: 14px;
+  border-top: 1px solid hsl(var(--divider-faint) / 85%);
+}
+
+.card-primary-hint {
+  display: flex;
+  flex: 1;
+  min-width: 0;
+}
+
+.primary-label {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+  min-width: 0;
+}
+
+.primary-icon {
+  color: hsl(var(--primary));
+}
+
+.primary-text {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  font-size: 13px;
+  font-weight: 500;
+  color: hsl(var(--text-strong));
+  white-space: nowrap;
+}
+
+.card-actions {
+  display: flex;
+  flex-shrink: 0;
+  gap: 4px;
+  align-items: center;
+  margin-left: auto;
+}
+
+.card-action-btn {
+  --el-button-font-weight: 500;
+  --el-button-text-color: hsl(var(--text-muted));
+  --el-button-hover-text-color: hsl(var(--text-strong));
+  --el-button-active-text-color: hsl(var(--text-strong));
+
+  padding: 0 4px;
+}
+
+.card-action-btn--danger {
+  --el-button-text-color: hsl(var(--destructive));
+  --el-button-hover-text-color: hsl(var(--destructive));
+  --el-button-active-text-color: hsl(var(--destructive));
+}
+
+.card-action-btn--menu {
+  padding: 0;
+}
+
+.menu-action-content {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+}
+
+:deep(.card-menu-item--danger) {
+  color: hsl(var(--destructive));
+}
 </style>
diff --git a/easyflow-ui-admin/app/src/views/ai/bots/index.vue b/easyflow-ui-admin/app/src/views/ai/bots/index.vue
index 57f61a0..10c11d5 100644
--- a/easyflow-ui-admin/app/src/views/ai/bots/index.vue
+++ b/easyflow-ui-admin/app/src/views/ai/bots/index.vue
@@ -3,7 +3,10 @@ import type { FormInstance } from 'element-plus';
 
 import type { BotInfo } from '@easyflow/types';
 
-import type { ActionButton } from '#/components/page/CardList.vue';
+import type {
+  ActionButton,
+  CardPrimaryAction,
+} from '#/components/page/CardList.vue';
 
 import { computed, markRaw, onMounted, ref } from 'vue';
 import { useRouter } from 'vue-router';
@@ -70,36 +73,35 @@ const headerButtons = [
 function resolveNavTitle(row: BotInfo) {
   return (row as Record<string, any>)?.title || row?.name || '';
 }
+const primaryAction: CardPrimaryAction = {
+  icon: Setting,
+  text: $t('button.setting'),
+  onClick(row: BotInfo) {
+    router.push({
+      path: `/ai/bots/setting/${row.id}`,
+      query: {
+        pageKey: '/ai/bots',
+        navTitle: resolveNavTitle(row),
+      },
+    });
+  },
+};
+
 const actions: ActionButton[] = [
   {
     icon: Edit,
     text: $t('button.edit'),
-    className: '',
-    permission: '',
+    placement: 'inline',
     onClick(row: BotInfo) {
       modalRef.value?.open('edit', row);
     },
   },
-  {
-    icon: Setting,
-    text: $t('button.setting'),
-    className: '',
-    permission: '',
-    onClick(row: BotInfo) {
-      router.push({
-        path: '/ai/bots/setting/' + row.id,
-        query: {
-          pageKey: '/ai/bots',
-          navTitle: resolveNavTitle(row),
-        },
-      });
-    },
-  },
   {
     icon: Delete,
     text: $t('button.delete'),
-    className: 'item-danger',
+    tone: 'danger',
     permission: '/api/v1/bot/remove',
+    placement: 'inline',
     onClick(row: BotInfo) {
       removeBot(row);
     },
@@ -298,6 +300,7 @@ const getSideList = async () => {
             <CardList
               :default-icon="defaultAvatar"
               :data="pageList"
+              :primary-action="primaryAction"
               :actions="actions"
             />
           </template>
diff --git a/easyflow-ui-admin/app/src/views/ai/documentCollection/DocumentCollection.vue b/easyflow-ui-admin/app/src/views/ai/documentCollection/DocumentCollection.vue
index d868773..5322df5 100644
--- a/easyflow-ui-admin/app/src/views/ai/documentCollection/DocumentCollection.vue
+++ b/easyflow-ui-admin/app/src/views/ai/documentCollection/DocumentCollection.vue
@@ -1,29 +1,22 @@
 <script setup lang="ts">
-import type { FormInstance } from 'element-plus';
+import type {FormInstance} from 'element-plus';
+import {ElForm, ElFormItem, ElInput, ElInputNumber, ElMessage, ElMessageBox,} from 'element-plus';
 
-import type { ActionButton } from '#/components/page/CardList.vue';
+import type {ActionButton, CardPrimaryAction,} from '#/components/page/CardList.vue';
+import CardPage from '#/components/page/CardList.vue';
 
-import { computed, onMounted, ref } from 'vue';
-import { useRouter } from 'vue-router';
+import {computed, onMounted, ref} from 'vue';
+import {useRouter} from 'vue-router';
 
-import { EasyFlowFormModal } from '@easyflow/common-ui';
-import { $t } from '@easyflow/locales';
+import {EasyFlowFormModal} from '@easyflow/common-ui';
+import {$t} from '@easyflow/locales';
 
-import { Delete, Edit, Notebook, Plus, Search } from '@element-plus/icons-vue';
-import {
-  ElForm,
-  ElFormItem,
-  ElInput,
-  ElInputNumber,
-  ElMessage,
-  ElMessageBox,
-} from 'element-plus';
-import { tryit } from 'radash';
+import {Delete, Edit, Notebook, Plus, Search} from '@element-plus/icons-vue';
+import {tryit} from 'radash';
 
-import { api } from '#/api/request';
+import {api} from '#/api/request';
 import defaultIcon from '#/assets/ai/knowledge/book.svg';
 import HeaderSearch from '#/components/headerSearch/HeaderSearch.vue';
-import CardPage from '#/components/page/CardList.vue';
 import PageData from '#/components/page/PageData.vue';
 import PageSide from '#/components/page/PageSide.vue';
 import DocumentCollectionModal from '#/views/ai/documentCollection/DocumentCollectionModal.vue';
@@ -37,6 +30,17 @@ const collectionTypeLabelMap = {
 function resolveNavTitle(row: Record<string, any>) {
   return row?.title || row?.name || '';
 }
+
+function openKnowledgeDetail(row: { id: string; name?: string; title?: string }) {
+  router.push({
+    path: '/ai/documentCollection/document',
+    query: {
+      id: row.id,
+      pageKey: '/ai/documentCollection',
+      navTitle: resolveNavTitle(row),
+    },
+  });
+}
 interface FieldDefinition {
   // 字段名称
   prop: string;
@@ -49,38 +53,29 @@ interface FieldDefinition {
   // 占位符
   placeholder?: string;
 }
-// 操作按钮配置
+const primaryAction: CardPrimaryAction = {
+  icon: Notebook,
+  text: $t('documentCollection.actions.knowledge'),
+  permission: '/api/v1/documentCollection/save',
+  onClick(row) {
+    openKnowledgeDetail(row);
+  },
+};
+
 const actions: ActionButton[] = [
   {
     icon: Edit,
     text: $t('button.edit'),
-    className: '',
     permission: '/api/v1/documentCollection/save',
+    placement: 'inline',
     onClick(row) {
       aiKnowledgeModalRef.value.openDialog(row);
     },
   },
-  {
-    icon: Notebook,
-    text: $t('documentCollection.actions.knowledge'),
-    className: '',
-    permission: '/api/v1/documentCollection/save',
-    onClick(row) {
-      router.push({
-        path: '/ai/documentCollection/document',
-        query: {
-          id: row.id,
-          pageKey: '/ai/documentCollection',
-          navTitle: resolveNavTitle(row),
-        },
-      });
-    },
-  },
   {
     icon: Search,
     text: $t('documentCollection.actions.retrieve'),
-    className: '',
-    permission: '',
+    placement: 'inline',
     onClick(row) {
       router.push({
         path: '/ai/documentCollection/document',
@@ -96,8 +91,9 @@ const actions: ActionButton[] = [
   {
     text: $t('button.delete'),
     icon: Delete,
-    className: 'item-danger',
+    tone: 'danger',
     permission: '/api/v1/documentCollection/remove',
+    placement: 'inline',
     onClick(row) {
       handleDelete(row);
     },
@@ -314,10 +310,11 @@ function changeCategory(category: any) {
           <template #default="{ pageList }">
             <CardPage
               :default-icon="defaultIcon"
-              title-key="title"
-              avatar-key="icon"
-              description-key="description"
+              title-field="title"
+              icon-field="icon"
+              desc-field="description"
               :data="pageList"
+              :primary-action="primaryAction"
               :actions="actions"
               tag-field="collectionType"
               :tag-map="collectionTypeLabelMap"
diff --git a/easyflow-ui-admin/app/src/views/ai/plugin/AddPluginModal.vue b/easyflow-ui-admin/app/src/views/ai/plugin/AddPluginModal.vue
index d2d82e6..22cde51 100644
--- a/easyflow-ui-admin/app/src/views/ai/plugin/AddPluginModal.vue
+++ b/easyflow-ui-admin/app/src/views/ai/plugin/AddPluginModal.vue
@@ -1,11 +1,5 @@
 <script setup lang="ts">
-import type { FormInstance } from 'element-plus';
-
-import { onMounted, ref } from 'vue';
-
-import { EasyFlowFormModal } from '@easyflow/common-ui';
-
-import { Plus, Remove } from '@element-plus/icons-vue';
+import type {FormInstance} from 'element-plus';
 import {
   ElForm,
   ElFormItem,
@@ -18,13 +12,20 @@ import {
   ElSelect,
 } from 'element-plus';
 
-import { api } from '#/api/request';
+import {onMounted, ref} from 'vue';
+
+import {EasyFlowFormModal} from '@easyflow/common-ui';
+
+import {Plus, Remove} from '@element-plus/icons-vue';
+
+import {api} from '#/api/request';
 import UploadAvatar from '#/components/upload/UploadAvatar.vue';
-import { $t } from '#/locales';
+import {$t} from '#/locales';
 
 const emit = defineEmits(['reload']);
 const embeddingLlmList = ref<any>([]);
 const rerankerLlmList = ref<any>([]);
+const categoryList = ref<any[]>([]);
 interface headersType {
   label: string;
   value: string;
@@ -46,6 +47,11 @@ onMounted(() => {
   api.get('/api/v1/model/list?supportRerankerLlmList=true').then((res) => {
     rerankerLlmList.value = res.data;
   });
+  api.get('/api/v1/pluginCategory/list').then((res) => {
+    if (res.errorCode === 0) {
+      categoryList.value = res.data;
+    }
+  });
 });
 defineExpose({
   openDialog,
@@ -57,6 +63,7 @@ const isAdd = ref(true);
 const tempAddHeaders = ref<headersType[]>([]);
 const entity = ref<any>({
   alias: '',
+  categoryIds: [],
   deptId: '',
   icon: '',
   title: '',
@@ -91,6 +98,7 @@ const rules = ref({
 
 // functions
 function openDialog(row: any) {
+  tempAddHeaders.value = [];
   if (row.id) {
     isAdd.value = false;
     if (row.headers) {
@@ -100,26 +108,62 @@ function openDialog(row: any) {
   entity.value = {
     ...row,
     authType: row.authType || 'none',
+    categoryIds: row.categoryIds?.map((item: any) => item.id) || [],
   };
   dialogVisible.value = true;
 }
+
+async function syncPluginCategories(pluginId: string, categoryIds: string[]) {
+  if (!pluginId) {
+    return;
+  }
+  const relationRes = await api.post(
+    '/api/v1/pluginCategoryMapping/updateRelation',
+    {
+      pluginId,
+      categoryIds,
+    },
+  );
+  if (relationRes.errorCode !== 0) {
+    throw new Error(relationRes.message || 'sync categories failed');
+  }
+}
+
 function save() {
   saveForm.value?.validate((valid) => {
     if (valid) {
+      btnLoading.value = true;
       const plainEntity = { ...entity.value };
       const plainHeaders = [...tempAddHeaders.value];
+      const categoryIds = [...(plainEntity.categoryIds || [])];
+      delete plainEntity.categoryIds;
       if (isAdd.value) {
         api
           .post('/api/v1/plugin/plugin/save', {
             ...plainEntity,
             headers: plainHeaders,
           })
-          .then((res) => {
+          .then(async (res) => {
             if (res.errorCode === 0) {
+              const pluginId =
+                res.data?.id ||
+                res.data ||
+                plainEntity.id ||
+                entity.value.id ||
+                '';
+              await syncPluginCategories(pluginId, categoryIds);
               dialogVisible.value = false;
               ElMessage.success($t('message.saveOkMessage'));
               emit('reload');
+            } else {
+              ElMessage.error(res.message);
             }
+          })
+          .catch((error) => {
+            ElMessage.error(error?.message || $t('message.saveFailMessage'));
+          })
+          .finally(() => {
+            btnLoading.value = false;
           });
       } else {
         api
@@ -127,12 +171,21 @@ function save() {
             ...plainEntity,
             headers: plainHeaders,
           })
-          .then((res) => {
+          .then(async (res) => {
             if (res.errorCode === 0) {
+              await syncPluginCategories(entity.value.id, categoryIds);
               dialogVisible.value = false;
               ElMessage.success($t('message.updateOkMessage'));
               emit('reload');
+            } else {
+              ElMessage.error(res.message);
             }
+          })
+          .catch((error) => {
+            ElMessage.error(error?.message || $t('message.saveFailMessage'));
+          })
+          .finally(() => {
+            btnLoading.value = false;
           });
       }
     }
@@ -141,6 +194,7 @@ function save() {
 function closeDialog() {
   saveForm.value?.resetFields();
   isAdd.value = true;
+  tempAddHeaders.value = [];
   entity.value = {};
   dialogVisible.value = false;
 }
@@ -199,6 +253,22 @@ function removeHeader(index: number) {
           :placeholder="$t('plugin.placeholder.description')"
         />
       </ElFormItem>
+      <ElFormItem prop="categoryIds" :label="$t('plugin.category')">
+        <ElSelect
+          v-model="entity.categoryIds"
+          multiple
+          collapse-tags
+          collapse-tags-tooltip
+          :max-collapse-tags="3"
+        >
+          <ElOption
+            v-for="item in categoryList"
+            :key="item.id"
+            :label="item.name"
+            :value="item.id"
+          />
+        </ElSelect>
+      </ElFormItem>
       <ElFormItem prop="Headers" label="Headers">
         <div
           class="headers-container-reduce flex flex-row gap-4"
diff --git a/easyflow-ui-admin/app/src/views/ai/plugin/Plugin.vue b/easyflow-ui-admin/app/src/views/ai/plugin/Plugin.vue
index 73795f2..b6e738a 100644
--- a/easyflow-ui-admin/app/src/views/ai/plugin/Plugin.vue
+++ b/easyflow-ui-admin/app/src/views/ai/plugin/Plugin.vue
@@ -1,5 +1,8 @@
 <script setup lang="ts">
-import type { ActionButton } from '#/components/page/CardList.vue';
+import type {
+  ActionButton,
+  CardPrimaryAction,
+} from '#/components/page/CardList.vue';
 
 import { onMounted, ref } from 'vue';
 import { useRouter } from 'vue-router';
@@ -19,13 +22,11 @@ import {
 import { api } from '#/api/request';
 import defaultPluginIcon from '#/assets/ai/plugin/defaultPluginIcon.png';
 import HeaderSearch from '#/components/headerSearch/HeaderSearch.vue';
-import CategorizeIcon from '#/components/icons/CategorizeIcon.vue';
 import PluginToolIcon from '#/components/icons/PluginToolIcon.vue';
 import CardPage from '#/components/page/CardList.vue';
 import PageData from '#/components/page/PageData.vue';
 import PageSide from '#/components/page/PageSide.vue';
 import AddPluginModal from '#/views/ai/plugin/AddPluginModal.vue';
-import CategoryPluginModal from '#/views/ai/plugin/CategoryPluginModal.vue';
 
 const router = useRouter();
 
@@ -52,47 +53,42 @@ function resolveNavTitle(item: PluginRecord) {
   return (item.title as string) || (item.name as string) || '';
 }
 
-// 操作按钮配置
+function openPluginTools(item: PluginRecord) {
+  router.push({
+    path: '/ai/plugin/tools',
+    query: {
+      id: item.id,
+      pageKey: '/ai/plugin',
+      navTitle: resolveNavTitle(item),
+    },
+  });
+}
+
+const primaryAction: CardPrimaryAction = {
+  icon: PluginToolIcon,
+  text: $t('plugin.button.tools'),
+  permission: '/api/v1/plugin/save',
+  onClick(item) {
+    openPluginTools(item);
+  },
+};
+
 const actions: ActionButton[] = [
   {
     icon: Edit,
     text: $t('button.edit'),
-    className: '',
     permission: '/api/v1/plugin/save',
+    placement: 'inline',
     onClick(item) {
       aiPluginModalRef.value.openDialog(item);
     },
   },
-  {
-    icon: PluginToolIcon,
-    text: $t('plugin.button.tools'),
-    className: '',
-    permission: '/api/v1/plugin/save',
-    onClick(item) {
-      router.push({
-        path: '/ai/plugin/tools',
-        query: {
-          id: item.id,
-          pageKey: '/ai/plugin',
-          navTitle: resolveNavTitle(item),
-        },
-      });
-    },
-  },
-  {
-    icon: CategorizeIcon,
-    text: $t('plugin.button.categorize'),
-    className: '',
-    permission: '/api/v1/plugin/save',
-    onClick(item) {
-      categoryCategoryModal.value.openDialog(item);
-    },
-  },
   {
     icon: Delete,
     text: $t('button.delete'),
-    className: 'item-danger',
+    tone: 'danger',
     permission: '/api/v1/plugin/remove',
+    placement: 'inline',
     onClick(item) {
       handleDelete(item);
     },
@@ -162,7 +158,6 @@ const handleDelete = (item: PluginRecord) => {
 
 const pageDataRef = ref();
 const aiPluginModalRef = ref();
-const categoryCategoryModal = ref();
 const headerButtons = [
   {
     key: 'add',
@@ -267,10 +262,11 @@ const handleClickCategory = (item: PluginCategory) => {
         >
           <template #default="{ pageList }">
             <CardPage
-              title-key="title"
-              avatar-key="icon"
-              description-key="description"
+              title-field="title"
+              icon-field="icon"
+              desc-field="description"
               :data="pageList"
+              :primary-action="primaryAction"
               :actions="actions"
               :default-icon="defaultPluginIcon"
             />
@@ -279,7 +275,6 @@ const handleClickCategory = (item: PluginCategory) => {
       </div>
     </div>
     <AddPluginModal ref="aiPluginModalRef" @reload="handleSearch" />
-    <CategoryPluginModal ref="categoryCategoryModal" @reload="handleSearch" />
     <EasyFlowFormModal
       :title="isEdit ? `${$t('button.edit')}` : `${$t('button.add')}`"
       v-model:open="dialogVisible"
diff --git a/easyflow-ui-admin/app/src/views/ai/workflow/WorkflowList.vue b/easyflow-ui-admin/app/src/views/ai/workflow/WorkflowList.vue
index 439ff0f..35606f9 100644
--- a/easyflow-ui-admin/app/src/views/ai/workflow/WorkflowList.vue
+++ b/easyflow-ui-admin/app/src/views/ai/workflow/WorkflowList.vue
@@ -1,11 +1,13 @@
 <script setup lang="ts">
-import type { FormInstance } from 'element-plus';
+import type {FormInstance} from 'element-plus';
+import {ElForm, ElFormItem, ElInput, ElInputNumber, ElMessage, ElMessageBox,} from 'element-plus';
 
-import type { ActionButton } from '#/components/page/CardList.vue';
+import type {ActionButton, CardPrimaryAction,} from '#/components/page/CardList.vue';
+import CardList from '#/components/page/CardList.vue';
 
-import { computed, markRaw, onMounted, ref } from 'vue';
+import {computed, markRaw, onMounted, ref} from 'vue';
 
-import { EasyFlowFormModal } from '@easyflow/common-ui';
+import {EasyFlowFormModal} from '@easyflow/common-ui';
 
 import {
   CopyDocument,
@@ -17,27 +19,18 @@ import {
   Upload,
   VideoPlay,
 } from '@element-plus/icons-vue';
-import {
-  ElForm,
-  ElFormItem,
-  ElInput,
-  ElInputNumber,
-  ElMessage,
-  ElMessageBox,
-} from 'element-plus';
-import { tryit } from 'radash';
+import {tryit} from 'radash';
 
-import { api } from '#/api/request';
+import {api} from '#/api/request';
 import workflowIcon from '#/assets/ai/workflow/workflowIcon.png';
 // import workflowSvg from '#/assets/workflow.svg';
 import HeaderSearch from '#/components/headerSearch/HeaderSearch.vue';
 import DesignIcon from '#/components/icons/DesignIcon.vue';
-import CardList from '#/components/page/CardList.vue';
 import PageData from '#/components/page/PageData.vue';
 import PageSide from '#/components/page/PageSide.vue';
-import { $t } from '#/locales';
-import { router } from '#/router';
-import { useDictStore } from '#/store';
+import {$t} from '#/locales';
+import {router} from '#/router';
+import {useDictStore} from '#/store';
 
 import WorkflowModal from './WorkflowModal.vue';
 
@@ -54,30 +47,29 @@ interface FieldDefinition {
   placeholder?: string;
 }
 
+const primaryAction: CardPrimaryAction = {
+  icon: DesignIcon,
+  text: $t('button.design'),
+  permission: '/api/v1/workflow/save',
+  onClick: (row: any) => {
+    toDesignPage(row);
+  },
+};
+
 const actions: ActionButton[] = [
   {
     icon: Edit,
     text: $t('button.edit'),
-    className: '',
     permission: '/api/v1/workflow/save',
+    placement: 'inline',
     onClick: (row: any) => {
       showDialog(row);
     },
   },
-  {
-    icon: DesignIcon,
-    text: $t('button.design'),
-    className: '',
-    permission: '/api/v1/workflow/save',
-    onClick: (row: any) => {
-      toDesignPage(row);
-    },
-  },
   {
     icon: VideoPlay,
     text: $t('button.run'),
-    className: '',
-    permission: '',
+    placement: 'inline',
     onClick: (row: any) => {
       router.push({
         name: 'RunPage',
@@ -90,8 +82,8 @@ const actions: ActionButton[] = [
   {
     icon: Tickets,
     text: $t('aiWorkflowExecRecord.moduleName'),
-    className: '',
     permission: '/api/v1/workflow/save',
+    placement: 'menu',
     onClick: (row: any) => {
       router.push({
         name: 'ExecRecord',
@@ -104,8 +96,7 @@ const actions: ActionButton[] = [
   {
     icon: Download,
     text: $t('button.export'),
-    className: '',
-    permission: '',
+    placement: 'menu',
     onClick: (row: any) => {
       exportJson(row);
     },
@@ -113,8 +104,7 @@ const actions: ActionButton[] = [
   {
     icon: CopyDocument,
     text: $t('button.copy'),
-    className: '',
-    permission: '',
+    placement: 'menu',
     onClick: (row: any) => {
       showDialog({
         title: `${row.title}Copy`,
@@ -125,8 +115,8 @@ const actions: ActionButton[] = [
   {
     icon: Delete,
     text: $t('button.delete'),
-    className: 'item-danger',
-    permission: '',
+    tone: 'danger',
+    placement: 'inline',
     onClick: (row: any) => {
       remove(row);
     },
@@ -402,6 +392,7 @@ function handleHeaderButtonClick(data: any) {
             <CardList
               :default-icon="workflowIcon"
               :data="pageList"
+              :primary-action="primaryAction"
               :actions="actions"
             />
           </template>