Add supplementary documents and optimize the upload interface

ctrlz526 · ctrlz526 · commit 2d0a86c8041a · 2025-07-22T15:04:08.000+08:00
diff --git a/docSite/assets/imgs/plugins/entry.png b/docSite/assets/imgs/plugins/entry.png
diff --git a/docSite/assets/imgs/plugins/file.png b/docSite/assets/imgs/plugins/file.png
diff --git a/docSite/content/zh-cn/docs/guide/plugins/google_search_plugin_guide.md b/docSite/content/zh-cn/docs/guide/plugins/google_search_plugin_guide.md
@@ -4,7 +4,7 @@ description: "FastGPT Google 搜索插件配置指南"
 icon: "google_search"
 draft: false
 toc: true
-weight: 304
+weight: 305
 ---
 
 1. # 创建Google Custom Search Engine
diff --git a/docSite/content/zh-cn/docs/guide/plugins/searxng_plugin_guide.md b/docSite/content/zh-cn/docs/guide/plugins/searxng_plugin_guide.md
@@ -4,7 +4,7 @@ description: "FastGPT SearXNG 搜索插件配置指南"
 icon: "search"
 draft: false
 toc: true
-weight: 303
+weight: 304
 ---
 
 [SearXNG](https://github.com/searxng/searxng)是一款免费的互联网元搜索引擎，它汇总了来自各种搜索服务和数据库的结果。它不会跟踪或分析用户。用户可以自行部署它进行使用。本文介绍 Searxng 的部署以及接入 FastGPT 插件。
diff --git a/docSite/content/zh-cn/docs/guide/plugins/upload_system_tool.md b/docSite/content/zh-cn/docs/guide/plugins/upload_system_tool.md
@@ -0,0 +1,129 @@
+---
+title: "如何在线上传系统工具"
+description: "FastGPT 系统工具在线上传指南"
+icon: "cloud_upload"
+draft: false
+toc: true
+weight: 303
+---
+
+## 介绍
+
+从 FastGPT 4.10.0 版本开始，系统管理员可以通过 Web 界面直接上传和更新系统工具，无需重新部署服务。本文档将指导您如何使用在线上传功能来管理系统工具。
+
+## 权限要求
+
+⚠️ **重要提示**：只有 **root 用户** 才能使用在线上传系统工具功能。
+
+- 确保您已使用 `root` 账户登录 FastGPT
+- 普通用户无法看到"导入/更新"按钮和删除功能
+
+## 支持的文件格式
+
+- **文件类型**：`.js` 文件
+- **文件大小**：最大 10MB
+- **文件数量**：每次只能上传一个文件
+
+## 上传步骤
+
+### 1. 进入系统工具页面
+
+1. 登录 FastGPT 管理后台
+2. 导航到：**工作台** → **系统工具**
+3. 确认页面右上角显示"导入/更新"按钮（只有 root 用户可见）
+
+![](/imgs/plugins/entry.png)
+
+### 2. 准备工具文件
+
+在上传之前，请确保您的 `.js` 文件是从 fastgpt-plugin 项目中通过 `bun run build` 命令打包后的 dist/tools/built-in 文件夹下得到的
+
+![](/imgs/plugins/file.png)
+
+### 3. 执行上传
+
+1. 点击 **"导入/更新"** 按钮
+2. 在弹出的对话框中，点击文件选择区域
+3. 选择您准备好的 `.js` 工具文件
+4. 确认文件信息无误后，点击 **"确认导入"**
+
+### 4. 上传过程
+
+- 上传成功后会显示成功提示
+- 页面自动刷新，新工具会出现在工具列表中
+
+## 功能特点
+
+### 工具管理
+
+- **查看工具**：所有用户都可以查看已安装的系统工具
+- **上传工具**：仅 root 用户可以上传新工具或更新现有工具
+- **删除工具**：仅 root 用户可以删除已上传的工具
+
+### 工具类型识别
+
+系统会根据工具的配置自动识别工具类型：
+
+- 🔧 **工具 (tools)**
+- 🔍 **搜索 (search)**  
+- 🎨 **多模态 (multimodal)**
+- 💬 **通讯 (communication)**
+- 📦 **其他 (other)**
+
+## 常见问题
+
+### Q: 上传失败，提示"文件内容存在错误"
+
+**可能原因：**
+- fastgpt-plugin 项目不是最新的，导致打包的 `.js` 文件缺少正确的内容
+- 工具配置格式不正确
+
+**解决方案：**
+1. 拉取最新的 fastgpt-plugin 项目重新进行 `bun run build` 获得打包后的 `.js` 文件
+2. 检查本地插件运行是否成功
+
+### Q: 无法看到"导入/更新"按钮
+
+**原因：** 当前用户不是 root 用户
+
+**解决方案：** 使用 root 账户重新登录
+
+### Q: 文件上传超时
+
+**可能原因：**
+- 文件过大（超过 10MB）
+- 网络连接不稳定
+
+**解决方案：**
+1. 确认文件大小在限制范围内
+2. 检查网络连接
+3. 尝试重新上传
+
+## 最佳实践
+
+### 上传前检查
+
+1. **代码测试**：在本地环境测试工具功能
+2. **格式验证**：确保符合 FastGPT 工具规范
+3. **文件大小**：保持文件在合理大小范围内
+
+### 版本管理
+
+- 建议为工具添加版本号注释
+- 更新工具时，先备份原有版本
+- 记录更新日志和功能变更
+
+### 安全考虑
+
+- 仅上传来源可信的工具文件
+- 避免包含敏感信息或凭据
+- 定期审查已安装的工具
+
+### 存储方式
+
+- 工具文件存储在 MinIO 中
+- 工具元数据保存在 MongoDB 中
+
+---
+
+通过在线上传功能，您可以快速部署和管理系统工具，提高 FastGPT 的扩展性和灵活性。如遇到问题，请参考上述常见问题或联系技术支持。 
diff --git a/packages/service/common/file/plugin/controller.ts b/packages/service/common/file/plugin/controller.ts
@@ -41,32 +41,12 @@ export const generateDownloadUrl = (objectName: string, config: UploadFileConfig
   return `${config.bucket}/${encodedObjectName}`;
 };
 
-const validatePresignedInput = (input: PresignedUrlInput, config: UploadFileConfig): void => {
-  if (!input.filename) {
-    throw new Error('Filename is required');
-  }
-
-  const maxSize = input.maxSize || config.maxFileSize;
-  if (maxSize > config.maxFileSize) {
-    throw new Error(`Max size exceeds limit of ${config.maxFileSize} bytes`);
-  }
-
-  const ext = path.extname(input.filename).toLowerCase();
-  if (config.allowedExtensions && !config.allowedExtensions.includes(ext)) {
-    throw new Error(
-      `File extension ${ext} is not allowed. Supported extensions: ${config.allowedExtensions.join(', ')}`
-    );
-  }
-};
-
 //Generate a pre-signed URL for direct file upload
 export const generatePresignedUrl = async (
   input: PresignedUrlInput
 ): Promise<PresignedUrlResponse> => {
   const currentConfig = { ...globalConfig };
 
-  validatePresignedInput(input, currentConfig);
-
   const fileId = generateFileId();
   const pluginType = input.pluginType || PluginTypeEnum.tool;
   const pluginPath = PLUGIN_TYPE_TO_PATH_MAP[pluginType];
@@ -76,13 +56,11 @@ export const generatePresignedUrl = async (
 
   try {
     const policy = connectionMinio.newPostPolicy();
+
     policy.setBucket(currentConfig.bucket);
     policy.setKey(objectName);
-
     policy.setContentType(contentType);
-
     policy.setContentLengthRange(1, maxSize);
-
     policy.setExpires(new Date(Date.now() + 10 * 60 * 1000));
 
     const metadata = {
@@ -102,8 +80,6 @@ export const generatePresignedUrl = async (
       formData
     };
 
-    console.log('Generated presigned URL successfully', response);
-
     return response;
   } catch (error) {
     addLog.error('Failed to generate presigned URL', error);
@@ -119,6 +95,7 @@ export const confirmPresignedUpload = async (objectName: string, size: string):
     const stat = await connectionMinio.statObject(currentConfig.bucket, objectName);
 
     if (stat.size !== Number(size)) {
+      addLog.error(`File size mismatch. Expected: ${size}, Actual: ${stat.size}`);
       return Promise.reject(`File size mismatch. Expected: ${size}, Actual: ${stat.size}`);
     }
 
@@ -134,7 +111,6 @@ export const confirmPresignedUpload = async (objectName: string, size: string):
     return result.url;
   } catch (error) {
     addLog.error('Failed to confirm presigned upload', error);
-    const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-    return Promise.reject(`Failed to confirm presigned upload: ${errorMessage}`);
+    return Promise.reject(`Failed to confirm presigned upload: ${error}`);
   }
 };
diff --git a/packages/service/common/minio/init.ts b/packages/service/common/minio/init.ts
@@ -6,9 +6,6 @@ export const initMinio = async () => {
   try {
     addLog.info('Connecting to MinIO...');
 
-    // Test connection by listing buckets
-    await connectionMinio.listBuckets();
-
     addLog.info('MinIO connected successfully');
     return true;
   } catch (error) {
@@ -52,13 +49,3 @@ export const ensureBucket = async (bucketName: string, isPublic: boolean = false
     }
   }, 3);
 };
-
-export const listBuckets = async () => {
-  try {
-    const buckets = await connectionMinio.listBuckets();
-    return buckets;
-  } catch (error) {
-    addLog.error('Failed to list buckets:', error);
-    throw error;
-  }
-};
diff --git a/packages/service/core/app/plugin/controller.ts b/packages/service/core/app/plugin/controller.ts
@@ -443,7 +443,7 @@ export const getSystemPlugins = async (): Promise<SystemPluginTemplateItemType[]
         ...item,
         isFolder: tools.some((tool) => tool.parentId === item.id),
         showStatus: true,
-        toolSource: (item.toolSource as 'uploaded' | 'built-in') || 'built-in',
+        toolSource: item.toolSource || 'built-in',
 
         workflow: {
           nodes: [],
diff --git a/packages/web/i18n/en/common.json b/packages/web/i18n/en/common.json
@@ -1202,6 +1202,7 @@
   "support.wallet.usage.Total points": "AI Points Consumption",
   "support.wallet.usage.Usage Detail": "Usage Details",
   "support.wallet.usage.Whisper": "Voice Input",
+  "sure_delete_tool_cannot_undo": "Are you sure to delete the tool? \nThis operation cannot be withdrawn",
   "sync_link": "Sync Link",
   "sync_success": "Synced Successfully",
   "system.Concat us": "Contact Us",
diff --git a/packages/web/i18n/en/file.json b/packages/web/i18n/en/file.json
@@ -13,11 +13,13 @@
   "Only_support_uploading_one_image": "Only support uploading one image",
   "Please select the image to upload": "Please select the image to upload",
   "Please wait for all files to upload": "Please wait for all files to be uploaded to complete",
+  "Upload_system_tools": "Upload system tools",
   "bucket_chat": "Conversation Files",
   "bucket_file": "Dataset Documents",
   "click_to_view_raw_source": "Click to View Original Source",
   "common.Some images failed to process": "Some images failed to process",
   "common.dataset_data_input_image_support_format": "Support .jpg, .jpeg, .png, .gif, .webp formats",
+  "common.import_update": "Import/Update",
   "count.core.dataset.collection.Create Success": "{{count}} picture successfully imported",
   "delete_image": "Delete pictures",
   "file_name": "Filename",
diff --git a/packages/web/i18n/zh-CN/common.json b/packages/web/i18n/zh-CN/common.json
@@ -1203,6 +1203,7 @@
   "support.wallet.usage.Total points": "AI 积分消耗",
   "support.wallet.usage.Usage Detail": "使用详情",
   "support.wallet.usage.Whisper": "语音输入",
+  "sure_delete_tool_cannot_undo": "是否确认删除该工具？该操作无法撤回",
   "sync_link": "同步链接",
   "sync_success": "同步成功",
   "system.Concat us": "联系我们",
diff --git a/packages/web/i18n/zh-CN/file.json b/packages/web/i18n/zh-CN/file.json
@@ -13,11 +13,13 @@
   "Only_support_uploading_one_image": "仅支持上传一张图片",
   "Please select the image to upload": "请选择要上传的图片",
   "Please wait for all files to upload": "请等待所有文件上传完成",
+  "Upload_system_tools": "上传系统工具",
   "bucket_chat": "对话文件",
   "bucket_file": "知识库文件",
   "click_to_view_raw_source": "点击查看来源",
   "common.Some images failed to process": "部分图片处理失败",
   "common.dataset_data_input_image_support_format": "支持 .jpg, .jpeg, .png, .gif, .webp 格式",
+  "common.import_update": "导入/更新",
   "count.core.dataset.collection.Create Success": "成功导入 {{count}} 张图片",
   "delete_image": "删除图片",
   "file_name": "文件名",
diff --git a/packages/web/i18n/zh-Hant/common.json b/packages/web/i18n/zh-Hant/common.json
@@ -1202,6 +1202,7 @@
   "support.wallet.usage.Total points": "AI 點數消耗",
   "support.wallet.usage.Usage Detail": "使用詳細資訊",
   "support.wallet.usage.Whisper": "語音輸入",
+  "sure_delete_tool_cannot_undo": "是否確認刪除該工具？\n該操作無法撤回",
   "sync_link": "同步連結",
   "sync_success": "同步成功",
   "system.Concat us": "聯絡我們",
diff --git a/packages/web/i18n/zh-Hant/file.json b/packages/web/i18n/zh-Hant/file.json
@@ -13,11 +13,13 @@
   "Only_support_uploading_one_image": "僅支持上傳一張圖片",
   "Please select the image to upload": "請選擇要上傳的圖片",
   "Please wait for all files to upload": "請等待所有文件上傳完成",
+  "Upload_system_tools": "上傳系統工具",
   "bucket_chat": "對話檔案",
   "bucket_file": "知識庫檔案",
   "click_to_view_raw_source": "點選檢視原始來源",
   "common.Some images failed to process": "部分圖片處理失敗",
   "common.dataset_data_input_image_support_format": "支持 .jpg, .jpeg, .png, .gif, .webp 格式",
+  "common.import_update": "導入/更新",
   "count.core.dataset.collection.Create Success": "成功導入 {{count}} 張圖片",
   "delete_image": "刪除圖片",
   "file_name": "檔案名稱",
diff --git a/projects/app/src/pageComponents/dashboard/SystemPlugin/ToolCard.tsx b/projects/app/src/pageComponents/dashboard/SystemPlugin/ToolCard.tsx
@@ -6,6 +6,7 @@ import React, { useState } from 'react';
 import { useTranslation } from 'next-i18next';
 import MyIcon from '@fastgpt/web/components/common/Icon';
 import MyIconButton from '@fastgpt/web/components/common/Icon/button';
+import { useConfirm } from '@fastgpt/web/hooks/useConfirm';
 import { type NodeTemplateListItemType } from '@fastgpt/global/core/workflow/type/node';
 import { type PluginGroupSchemaType } from '@fastgpt/service/core/app/plugin/type';
 import UseGuideModal from '@/components/common/Modal/UseGuideModal';
@@ -17,26 +18,34 @@ const PluginCard = ({
 }: {
   item: NodeTemplateListItemType;
   groups: PluginGroupSchemaType[];
-  onDelete?: (pluginId: string) => void;
+  onDelete?: (pluginId: string) => Promise<void>;
 }) => {
   const { t } = useTranslation();
   const { feConfigs } = useSystemStore();
   const [isHovered, setIsHovered] = useState(false);
 
+  const { openConfirm, ConfirmModal } = useConfirm({
+    type: 'delete',
+    content: t('common:sure_delete_tool_cannot_undo')
+  });
+
   const type = groups.reduce<string | undefined>((acc, group) => {
     const foundType = group.groupTypes.find((type) => type.typeId === item.templateType);
     return foundType ? foundType.typeName : acc;
   }, undefined);
 
   const isUploadedPlugin = item.toolSource === 'uploaded';
 
-  const handleDelete = (e: React.MouseEvent) => {
-    e.stopPropagation();
+  const handleDelete = async () => {
     if (onDelete && item.id) {
-      onDelete(item.id);
+      await onDelete(item.id);
     }
   };
 
+  const handleDeleteClick = () => {
+    openConfirm(handleDelete)();
+  };
+
   return (
     <MyBox
       key={item.id}
@@ -59,20 +68,24 @@ const PluginCard = ({
         boxShadow: '1.5'
       }}
     >
-      {/* Delete button - show when hovering over the entire component */}
-      {isUploadedPlugin && isHovered && (
+      {/* Delete button with centered confirmation modal */}
+      {isUploadedPlugin && (
         <MyIconButton
           icon="delete"
           position="absolute"
           bottom={3}
           right={4}
           color="blue.500"
-          onClick={handleDelete}
           aria-label={t('common:Delete')}
           zIndex={1}
+          opacity={isHovered ? 1 : 0}
+          pointerEvents={isHovered ? 'auto' : 'none'}
+          onClick={handleDeleteClick}
         />
       )}
 
+      <ConfirmModal />
+
       <HStack>
         <Avatar src={item.avatar} borderRadius={'sm'} w={'1.5rem'} h={'1.5rem'} />
         <Box flex={'1 0 0'} color={'myGray.900'} fontWeight={500}>
diff --git a/projects/app/src/pages/api/plugin/upload.ts b/projects/app/src/pages/api/plugin/upload.ts
diff --git a/projects/app/src/pages/dashboard/[pluginGroupId]/index.tsx b/projects/app/src/pages/dashboard/[pluginGroupId]/index.tsx
