feat: implement clipboard image paste functionality

Added support for pasting images from clipboard as files through the
kTouchFile event system. The implementation centralizes image handling
logic in FileOperationsEventReceiver with new doTouchFileFromClipboard
method, replacing scattered implementations across different plugins.
All clipboard image operations now flow through the standard file
operations pipeline for consistency.

Key changes:
1. Added clipboard image detection in doTouchFilePremature
2. Created new doTouchFileFromClipboard method for centralized image
handling
3. Modified FileOperatorProxy and FileOperatorHelper to use new
kTouchFile mechanism
4. Added proper callbacks for post-operation file selection
5. Included undo/redo support for image operations
6. Added proper error handling and logging

Log: Added support for pasting clipboard images as files

Influence:
1. Test clipboard image paste in various directories
2. Verify filename generation with different formats
3. Test undo/redo functionality for image operations
4. Verify error handling when clipboard has no image data
5. Check performance with large clipboard images
6. Test paste operations with different image formats
7. Verify file selection after paste operation

feat: 实现剪贴板图片粘贴功能

新增通过kTouchFile事件系统将剪贴板中的图像作为文件粘贴的支持。
该实现将图像处理逻辑集中在FileOperationsEventReceiver新增的
doTouchFileFromClipboard方法中，取代了原先分散在不同插件中的实现。现在所
有剪贴板图像操作都通过标准的文件操作流程执行以提高一致性。

主要变更：
1. 在doTouchFilePremature中添加剪贴板图像检测
2. 创建新的doTouchFileFromClipboard方法进行集中式图像处理
3. 修改FileOperatorProxy和FileOperatorHelper使用新的kTouchFile机制
4. 添加适当的回调函数实现操作后的文件选择
5. 包含图像操作的撤销/重做支持
6. 添加完善的错误处理和日志记录

Log: 新增剪贴板图片粘贴文件的支持

Influence:
1. 测试在不同目录中粘贴剪贴板图片
2. 验证不同格式的文件名生成
3. 测试图像操作的撤销/重做功能
4. 验证剪贴板无图像数据时的错误处理
5. 检查处理大型剪贴板图像的性能表现
6. 测试不同图像格式的粘贴操作
7. 验证粘贴操作后的文件选择功能

Author: Johnson-zs

src/plugins/common/dfmplugin-fileoperations/fileoperationsevent/fileoperationseventreceiver.cpp

@@ -30,6 +30,11 @@
 
 #include <QFileDialog>
 #include <QDir>
+#include <QApplication>
+#include <QClipboard>
+#include <QMimeData>
+#include <QImage>
+#include <QDateTime>
 
 Q_DECLARE_METATYPE(QList<QUrl> *)
 Q_DECLARE_METATYPE(bool *)
@@ -667,6 +672,15 @@ bool FileOperationsEventReceiver::doMkdir(const quint64 windowId, const QUrl &ur
 QString FileOperationsEventReceiver::doTouchFilePremature(const quint64 windowId, const QUrl &url, const CreateFileType fileType, const QString &suffix,
                                                           const QVariant &custom, AbstractJobHandler::OperatorCallback callbackImmediately)
 {
+    // Check if this is a clipboard image creation request
+    if (custom.isValid() && custom.canConvert<QVariantMap>()) {
+        QVariantMap customData = custom.toMap();
+        if (customData.contains("clipboardImage") && customData.value("clipboardImage").toBool()) {
+            fmInfo() << "Detected clipboard image creation request";
+            return doTouchFileFromClipboard(windowId, url, suffix, custom, callbackImmediately);
+        }
+    }
+
     const QString newPath = newDocmentName(url, suffix, fileType);
     if (newPath.isEmpty())
         return newPath;
@@ -736,6 +750,106 @@ QString FileOperationsEventReceiver::doTouchFilePremature(const quint64 windowId
     }
 }
 
+QString FileOperationsEventReceiver::doTouchFileFromClipboard(
+        const quint64 windowId,
+        const QUrl &url,
+        const QString &suffix,
+        const QVariant &custom,
+        AbstractJobHandler::OperatorCallback callbackImmediately)
+{
+    fmInfo() << "Creating file from clipboard image at:" << url;
+
+    // 1. Get clipboard image
+    const QMimeData *mimeData = QApplication::clipboard()->mimeData();
+    if (!mimeData || !mimeData->hasImage()) {
+        fmWarning() << "Clipboard does not contain image data";
+        if (callbackImmediately) {
+            AbstractJobHandler::CallbackArgus args(new QMap<AbstractJobHandler::CallbackKey, QVariant>);
+            args->insert(AbstractJobHandler::CallbackKey::kWindowId, QVariant::fromValue(windowId));
+            args->insert(AbstractJobHandler::CallbackKey::kSuccessed, false);
+            args->insert(AbstractJobHandler::CallbackKey::kCustom, custom);
+            callbackImmediately(args);
+        }
+        return QString();
+    }
+
+    QImage image = qvariant_cast<QImage>(mimeData->imageData());
+    if (image.isNull()) {
+        fmWarning() << "Failed to get valid image from clipboard";
+        if (callbackImmediately) {
+            AbstractJobHandler::CallbackArgus args(new QMap<AbstractJobHandler::CallbackKey, QVariant>);
+            args->insert(AbstractJobHandler::CallbackKey::kWindowId, QVariant::fromValue(windowId));
+            args->insert(AbstractJobHandler::CallbackKey::kSuccessed, false);
+            args->insert(AbstractJobHandler::CallbackKey::kCustom, custom);
+            callbackImmediately(args);
+        }
+        return QString();
+    }
+
+    // 2. Generate unique filename (reuse existing naming logic)
+    QDateTime now = QDateTime::currentDateTime();
+    QString timeStr = now.toString("yyyyMMdd_HHmmss_zzz");
+    QString baseName = QString("image_%1").arg(timeStr);
+    QString effectiveSuffix = suffix.isEmpty() ? "png" : suffix;
+
+    const QString newPath = newDocmentName(url, baseName, effectiveSuffix);
+    if (newPath.isEmpty()) {
+        fmWarning() << "Failed to generate file path for clipboard image";
+        if (callbackImmediately) {
+            AbstractJobHandler::CallbackArgus args(new QMap<AbstractJobHandler::CallbackKey, QVariant>);
+            args->insert(AbstractJobHandler::CallbackKey::kSuccessed, false);
+            callbackImmediately(args);
+        }
+        return QString();
+    }
+
+    QUrl targetUrl = QUrl::fromLocalFile(newPath);
+
+    // 3. Synchronously save image (typically fast, no need for async)
+    bool success = image.save(newPath, effectiveSuffix.toUpper().toUtf8().constData());
+
+    if (success) {
+        fmInfo() << "Clipboard image saved successfully:" << newPath;
+
+        // 4. Save operation record for undo/redo
+        saveFileOperation(
+                { targetUrl }, {},
+                GlobalEventType::kDeleteFiles,
+                { targetUrl }, {},
+                GlobalEventType::kTouchFile);
+
+        // 5. Publish result event
+        dpfSignalDispatcher->publish(
+                DFMBASE_NAMESPACE::GlobalEventType::kTouchFileResult,
+                windowId,
+                QList<QUrl>() << url,
+                true,
+                QString());
+    } else {
+        fmWarning() << "Failed to save clipboard image:" << newPath;
+
+        dpfSignalDispatcher->publish(
+                DFMBASE_NAMESPACE::GlobalEventType::kTouchFileResult,
+                windowId,
+                QList<QUrl>() << url,
+                false,
+                "Failed to save image");
+    }
+
+    // 6. Invoke callback after saving (with success status)
+    if (callbackImmediately) {
+        AbstractJobHandler::CallbackArgus args(new QMap<AbstractJobHandler::CallbackKey, QVariant>);
+        args->insert(AbstractJobHandler::CallbackKey::kWindowId, QVariant::fromValue(windowId));
+        args->insert(AbstractJobHandler::CallbackKey::kSourceUrls, QVariant::fromValue(QList<QUrl>() << url));
+        args->insert(AbstractJobHandler::CallbackKey::kTargets, QVariant::fromValue(QList<QUrl>() << targetUrl));
+        args->insert(AbstractJobHandler::CallbackKey::kSuccessed, success);
+        args->insert(AbstractJobHandler::CallbackKey::kCustom, custom);
+        callbackImmediately(args);
+    }
+
+    return success ? newPath : QString();
+}
+
 void FileOperationsEventReceiver::saveFileOperation(const QList<QUrl> &sourcesUrls,
                                                     const QList<QUrl> &targetUrls,
                                                     GlobalEventType type,

src/plugins/common/dfmplugin-fileoperations/fileoperationsevent/fileoperationseventreceiver.h

@@ -275,6 +275,9 @@ public slots:
                                  const QVariant &custom,
                                  DFMBASE_NAMESPACE::AbstractJobHandler::OperatorCallback callbackImmediately);
     bool doTouchFilePractically(const quint64 windowId, const QUrl &url, const QUrl &tempUrl = QUrl());
+    QString doTouchFileFromClipboard(const quint64 windowId, const QUrl &url,
+                                     const QString &suffix, const QVariant &custom,
+                                     DFMBASE_NAMESPACE::AbstractJobHandler::OperatorCallback callbackImmediately);
     void saveFileOperation(const QList<QUrl> &sourcesUrls, const QList<QUrl> &targetUrls,
                            DFMBASE_NAMESPACE::GlobalEventType type,
                            const QList<QUrl> &redoSourcesUrls, const QList<QUrl> &redoTargetUrls,

src/plugins/common/dfmplugin-menu/menuscene/clipboardmenuscene.cpp

@@ -17,6 +17,9 @@
 
 #include <QMenu>
 #include <QVariant>
+#include <QClipboard>
+#include <QMimeData>
+#include <QApplication>
 
 Q_DECLARE_METATYPE(QList<QUrl> *)
 
@@ -121,7 +124,13 @@ void ClipBoardMenuScene::updateState(QMenu *parent)
                 return;
 
             curDirInfo->refresh();
-            bool disabled = (ClipBoard::instance()->clipboardAction() == ClipBoard::kUnknownAction)
+
+            // 检查是否有传统的剪贴板action或者是否有图像数据
+            const QMimeData *mimeData = QApplication::clipboard()->mimeData();
+            bool hasValidClipboardData = (ClipBoard::instance()->clipboardAction() != ClipBoard::kUnknownAction)
+                                        || (mimeData && mimeData->hasImage());
+
+            bool disabled = !hasValidClipboardData
                     || !curDirInfo->isAttributes(OptInfoType::kIsWritable);
             paste->setDisabled(disabled);
         }

src/plugins/desktop/ddplugin-canvas/view/operator/fileoperatorproxy.cpp

@@ -13,6 +13,11 @@
 #include <dfm-base/dfm_event_defines.h>
 #include <dfm-base/utils/clipboard.h>
 #include <dfm-base/utils/fileutils.h>
+#include <QClipboard>
+#include <QMimeData>
+#include <QImage>
+#include <QDateTime>
+#include <QApplication>
 
 #include <dfm-framework/dpf.h>
 
@@ -261,7 +266,43 @@ void FileOperatorProxy::pasteFiles(const CanvasView *view, const QPoint pos)
     }
 
     if (urls.isEmpty()) {
-        fmDebug() << "No URLs in clipboard to paste";
+        // Check for clipboard image
+        const QMimeData *mimeData = QApplication::clipboard()->mimeData();
+        if (mimeData && mimeData->hasImage()) {
+            fmInfo() << "Detected clipboard image, creating file via kTouchFile event";
+
+            // Prepare custom data to identify this is a clipboard image
+            QVariantMap clipboardData;
+            clipboardData.insert("clipboardImage", true);
+
+            // Define callback to select newly created file
+            AbstractJobHandler::OperatorCallback callback = [this](const AbstractJobHandler::CallbackArgus args) {
+                if (args->value(AbstractJobHandler::CallbackKey::kSuccessed).toBool() != false) {
+                    auto targets = args->value(AbstractJobHandler::CallbackKey::kTargets)
+                                      .value<QList<QUrl>>();
+                    if (!targets.isEmpty()) {
+                        fmDebug() << "Canvas: Requesting selection for created image file:" << targets;
+                        // Add to pasteFileData to trigger selection via existing mechanism
+                        d->pasteFileData.insert(targets.first());
+                        emit filePastedCallback();
+                    }
+                }
+            };
+
+            // Publish kTouchFile event with png suffix
+            dpfSignalDispatcher->publish(
+                GlobalEventType::kTouchFile,
+                view->winId(),
+                view->model()->rootUrl(),
+                CreateFileType::kCreateFileTypeDefault,
+                QString("png"),  // Image suffix
+                QVariant::fromValue(clipboardData),
+                callback);
+
+            return;
+        }
+
+        fmDebug() << "No URLs or image data in clipboard to paste";
         return;
     }
 

src/plugins/filemanager/dfmplugin-workspace/utils/fileoperatorhelper.cpp

@@ -19,6 +19,12 @@
 
 #include <dfm-framework/dpf.h>
 
+#include <QClipboard>
+#include <QMimeData>
+#include <QImage>
+#include <QDateTime>
+#include <QApplication>
+
 Q_DECLARE_METATYPE(QList<QUrl> *)
 
 DFMGLOBAL_USE_NAMESPACE
@@ -252,16 +258,32 @@ void FileOperatorHelper::cutFiles(const FileView *view)
 void FileOperatorHelper::pasteFiles(const FileView *view)
 {
     fmInfo() << "Paste file by clipboard and current dir: " << view->rootUrl();
-    auto action = ClipBoard::instance()->clipboardAction();
-    // trash dir can't paste files for copy
+
+    // Check if target directory is trash
     if (FileUtils::isTrashFile(view->rootUrl())) {
         fmDebug() << "Paste operation blocked - target is trash directory";
         return;
     }
 
+    // Try traditional file paste
+    if (pasteTraditionalFiles(view)) {
+        return;
+    }
+
+    // Try clipboard image paste
+    pasteClipboardImage(view);
+}
+
+bool FileOperatorHelper::pasteTraditionalFiles(const FileView *view)
+{
+    auto action = ClipBoard::instance()->clipboardAction();
     auto sourceUrls = ClipBoard::instance()->clipboardFileUrlList();
     auto windowId = WorkspaceHelper::instance()->windowId(view);
 
+    if (action == ClipBoard::kUnknownAction || sourceUrls.isEmpty()) {
+        return false;
+    }
+
     if (ClipBoard::kCopyAction == action) {
         fmDebug() << "Executing copy action";
         dpfSignalDispatcher->publish(GlobalEventType::kCopy,
@@ -270,7 +292,6 @@ void FileOperatorHelper::pasteFiles(const FileView *view)
                                      view->rootUrl(),
                                      AbstractJobHandler::JobFlag::kNoHint, nullptr);
     } else if (ClipBoard::kCutAction == action) {
-
         if (ClipBoard::supportCut()) {
             fmDebug() << "Executing cut action and clearing clipboard";
             dpfSignalDispatcher->publish(GlobalEventType::kCutFile,
@@ -294,8 +315,49 @@ void FileOperatorHelper::pasteFiles(const FileView *view)
                                      AbstractJobHandler::JobFlag::kCopyRemote,
                                      nullptr);
     } else {
-        fmWarning() << "Unknown clipboard past action:" << action << " urls:" << sourceUrls;
+        return false;
     }
+
+    return true;
+}
+
+void FileOperatorHelper::pasteClipboardImage(const FileView *view)
+{
+    const QMimeData *mimeData = QApplication::clipboard()->mimeData();
+    if (!mimeData || !mimeData->hasImage()) {
+        fmDebug() << "No image data in clipboard to paste";
+        return;
+    }
+
+    fmInfo() << "Detected clipboard image, creating file via kTouchFile event";
+
+    // Prepare custom data
+    QVariantMap clipboardData;
+    clipboardData.insert("clipboardImage", true);
+
+    // Define callback to select newly created file
+    AbstractJobHandler::OperatorCallback callback = [](const AbstractJobHandler::CallbackArgus args) {
+        if (args->value(AbstractJobHandler::CallbackKey::kSuccessed).toBool() != false) {
+            auto targets = args->value(AbstractJobHandler::CallbackKey::kTargets)
+                              .value<QList<QUrl>>();
+            if (!targets.isEmpty()) {
+                fmDebug() << "Requesting selection for created image file:" << targets;
+                WorkspaceHelper::instance()->laterRequestSelectFiles(targets);
+            }
+        }
+    };
+
+    auto windowId = WorkspaceHelper::instance()->windowId(view);
+
+    // Publish kTouchFile event
+    dpfSignalDispatcher->publish(
+        GlobalEventType::kTouchFile,
+        windowId,
+        view->rootUrl(),
+        CreateFileType::kCreateFileTypeDefault,
+        QString("png"),
+        QVariant::fromValue(clipboardData),
+        callback);
 }
 
 void FileOperatorHelper::undoFiles(const FileView *view)

src/plugins/filemanager/dfmplugin-workspace/utils/fileoperatorhelper.h

@@ -48,6 +48,8 @@ class FileOperatorHelper : public QObject
 private:
     explicit FileOperatorHelper(QObject *parent = nullptr);
     void callBackFunction(const DFMBASE_NAMESPACE::AbstractJobHandler::CallbackArgus args);
+    bool pasteTraditionalFiles(const FileView *view);
+    void pasteClipboardImage(const FileView *view);
     void undoCallBackFunction(QSharedPointer<DFMBASE_NAMESPACE::AbstractJobHandler> handler);
 
     DFMBASE_NAMESPACE::AbstractJobHandler::OperatorCallback callBack;