From 357489d444a5d286d07cf446ee8bf03c9974fa8a Mon Sep 17 00:00:00 2001
From: yyh <yuanyouhuilyz@gmail.com>
Date: Tue, 20 Jan 2026 15:23:37 +0800
Subject: [PATCH] feat: multi select for file tree & clipboard support

---
 .../workflow/skill/file-tree/index.tsx        | 13 ++--
 .../workflow/skill/file-tree/menu-item.tsx    |  7 +-
 .../workflow/skill/file-tree/node-menu.tsx    | 61 +++++++++++++++++
 .../workflow/skill/file-tree/tree-node.tsx    |  4 +-
 .../skill/hooks/use-skill-shortcuts.ts        | 66 +++++++++++++++++++
 .../hooks/use-sync-tree-with-active-tab.ts    |  4 +-
 .../skill/hooks/use-tree-node-handlers.ts     | 20 +++---
 .../workflow/skill-editor/clipboard-slice.ts  | 38 +++++++++++
 .../workflow/skill-editor/file-tree-slice.ts  | 16 +++++
 .../store/workflow/skill-editor/index.ts      |  5 ++
 .../store/workflow/skill-editor/types.ts      | 20 ++++++
 web/i18n/en-US/workflow.json                  |  3 +
 web/i18n/zh-Hans/workflow.json                |  3 +
 13 files changed, 236 insertions(+), 24 deletions(-)
 create mode 100644 web/app/components/workflow/skill/hooks/use-skill-shortcuts.ts
 create mode 100644 web/app/components/workflow/store/workflow/skill-editor/clipboard-slice.ts

diff --git a/web/app/components/workflow/skill/file-tree/index.tsx b/web/app/components/workflow/skill/file-tree/index.tsx
index 5e41e7802b..5e24ff19de 100644
--- a/web/app/components/workflow/skill/file-tree/index.tsx
+++ b/web/app/components/workflow/skill/file-tree/index.tsx
@@ -19,6 +19,7 @@ import { CONTEXT_MENU_TYPE, ROOT_ID } from '../constants'
 import { useInlineCreateNode } from '../hooks/use-inline-create-node'
 import { useRootFileDrop } from '../hooks/use-root-file-drop'
 import { useSkillAssetTreeData } from '../hooks/use-skill-asset-tree'
+import { useSkillShortcuts } from '../hooks/use-skill-shortcuts'
 import { useSyncTreeWithActiveTab } from '../hooks/use-sync-tree-with-active-tab'
 import ArtifactsSection from './artifacts-section'
 import DragActionTooltip from './drag-action-tooltip'
@@ -62,7 +63,6 @@ const FileTree: React.FC<FileTreeProps> = ({ className }) => {
 
   const expandedFolderIds = useStore(s => s.expandedFolderIds)
   const activeTabId = useStore(s => s.activeTabId)
-  const selectedTreeNodeId = useStore(s => s.selectedTreeNodeId)
   const dragOverFolderId = useStore(s => s.dragOverFolderId)
   const searchTerm = useStore(s => s.fileTreeSearchTerm)
   const storeApi = useWorkflowStore()
@@ -123,18 +123,16 @@ const FileTree: React.FC<FileTreeProps> = ({ className }) => {
   }, [storeApi])
 
   const handleSelect = useCallback((nodes: NodeApi<TreeNodeData>[]) => {
-    const selectedId = nodes[0]?.id ?? null
-    storeApi.getState().setSelectedTreeNodeId(selectedId)
+    storeApi.getState().setSelectedNodeIds(nodes.map(n => n.id))
   }, [storeApi])
 
-  // Clicking blank area clears selection for root-level creation
   const handleBlankAreaClick = useCallback(() => {
-    storeApi.getState().setSelectedTreeNodeId(null)
+    storeApi.getState().clearSelection()
   }, [storeApi])
 
   const handleBlankAreaContextMenu = useCallback((e: React.MouseEvent) => {
     e.preventDefault()
-    storeApi.getState().setSelectedTreeNodeId(null)
+    storeApi.getState().clearSelection()
     storeApi.getState().setContextMenu({
       top: e.clientY,
       left: e.clientX,
@@ -147,6 +145,8 @@ const FileTree: React.FC<FileTreeProps> = ({ className }) => {
     activeTabId,
   })
 
+  useSkillShortcuts({ treeRef })
+
   if (isLoading) {
     return (
       <div className={cn('flex min-h-0 flex-1 items-center justify-center', className)}>
@@ -239,7 +239,6 @@ const FileTree: React.FC<FileTreeProps> = ({ className }) => {
             indent={20}
             overscanCount={5}
             openByDefault={false}
-            selection={selectedTreeNodeId ?? undefined}
             initialOpenState={initialOpensObject}
             onToggle={handleToggle}
             onSelect={handleSelect}
diff --git a/web/app/components/workflow/skill/file-tree/menu-item.tsx b/web/app/components/workflow/skill/file-tree/menu-item.tsx
index 3af2799292..d3458e41f3 100644
--- a/web/app/components/workflow/skill/file-tree/menu-item.tsx
+++ b/web/app/components/workflow/skill/file-tree/menu-item.tsx
@@ -4,6 +4,7 @@ import type { VariantProps } from 'class-variance-authority'
 import type { FC } from 'react'
 import { cva } from 'class-variance-authority'
 import * as React from 'react'
+import ShortcutsName from '@/app/components/workflow/shortcuts-name'
 import { cn } from '@/utils/classnames'
 
 const menuItemVariants = cva(
@@ -52,11 +53,12 @@ const labelVariants = cva('system-sm-regular text-text-secondary', {
 export type MenuItemProps = {
   icon: React.ElementType
   label: string
+  kbd?: string[]
   onClick: React.MouseEventHandler<HTMLButtonElement>
   disabled?: boolean
 } & VariantProps<typeof menuItemVariants>
 
-const MenuItem: FC<MenuItemProps> = ({ icon: Icon, label, onClick, disabled, variant }) => {
+const MenuItem: FC<MenuItemProps> = ({ icon: Icon, label, kbd, onClick, disabled, variant }) => {
   const handleClick = React.useCallback((event: React.MouseEvent<HTMLButtonElement>) => {
     event.stopPropagation()
     onClick(event)
@@ -70,7 +72,8 @@ const MenuItem: FC<MenuItemProps> = ({ icon: Icon, label, onClick, disabled, var
       className={cn(menuItemVariants({ variant }))}
     >
       <Icon className={cn(iconVariants({ variant }))} aria-hidden="true" />
-      <span className={cn(labelVariants({ variant }))}>{label}</span>
+      <span className={cn(labelVariants({ variant }), 'flex-1 text-left')}>{label}</span>
+      {kbd && kbd.length > 0 && <ShortcutsName keys={kbd} textColor="secondary" />}
     </button>
   )
 }
diff --git a/web/app/components/workflow/skill/file-tree/node-menu.tsx b/web/app/components/workflow/skill/file-tree/node-menu.tsx
index 786e9b34ef..911c9b566e 100644
--- a/web/app/components/workflow/skill/file-tree/node-menu.tsx
+++ b/web/app/components/workflow/skill/file-tree/node-menu.tsx
@@ -5,17 +5,22 @@ import type { NodeApi, TreeApi } from 'react-arborist'
 import type { NodeMenuType } from '../constants'
 import type { TreeNodeData } from '../type'
 import {
+  RiClipboardLine,
   RiDeleteBinLine,
   RiEdit2Line,
   RiFileAddLine,
+  RiFileCopyLine,
   RiFolderAddLine,
   RiFolderUploadLine,
+  RiScissorsLine,
   RiUploadLine,
 } from '@remixicon/react'
 import * as React from 'react'
+import { useCallback } from 'react'
 import { useTranslation } from 'react-i18next'
 import Confirm from '@/app/components/base/confirm'
 import { Download02 } from '@/app/components/base/icons/src/vender/solid/general'
+import { useStore, useWorkflowStore } from '@/app/components/workflow/store'
 import { cn } from '@/utils/classnames'
 import { NODE_MENU_TYPE } from '../constants'
 import { useFileOperations } from '../hooks/use-file-operations'
@@ -44,6 +49,9 @@ const NodeMenu: FC<NodeMenuProps> = ({
   node,
 }) => {
   const { t } = useTranslation('workflow')
+  const storeApi = useWorkflowStore()
+  const selectedNodeIds = useStore(s => s.selectedNodeIds)
+  const hasClipboard = useStore(s => s.hasClipboard())
   const isRoot = type === NODE_MENU_TYPE.ROOT
   const isFolder = type === NODE_MENU_TYPE.FOLDER || isRoot
 
@@ -64,6 +72,29 @@ const NodeMenu: FC<NodeMenuProps> = ({
     handleDeleteCancel,
   } = useFileOperations({ nodeId, onClose, treeRef, node })
 
+  const currentNodeId = node?.data.id ?? nodeId
+
+  const handleCopy = useCallback(() => {
+    const ids = selectedNodeIds.size > 0 ? [...selectedNodeIds] : (currentNodeId ? [currentNodeId] : [])
+    if (ids.length > 0) {
+      storeApi.getState().copyNodes(ids)
+      onClose()
+    }
+  }, [currentNodeId, onClose, selectedNodeIds, storeApi])
+
+  const handleCut = useCallback(() => {
+    const ids = selectedNodeIds.size > 0 ? [...selectedNodeIds] : (currentNodeId ? [currentNodeId] : [])
+    if (ids.length > 0) {
+      storeApi.getState().cutNodes(ids)
+      onClose()
+    }
+  }, [currentNodeId, onClose, selectedNodeIds, storeApi])
+
+  const handlePaste = useCallback(() => {
+    window.dispatchEvent(new CustomEvent('skill:paste'))
+    onClose()
+  }, [onClose])
+
   const showRenameDelete = isFolder ? !isRoot : true
   const deleteConfirmTitle = isFolder
     ? t('skillSidebar.menu.deleteConfirmTitle')
@@ -140,8 +171,38 @@ const NodeMenu: FC<NodeMenuProps> = ({
         </>
       )}
 
+      {!isRoot && (
+        <>
+          <MenuItem
+            icon={RiFileCopyLine}
+            label={t('skillSidebar.menu.copy')}
+            kbd={['ctrl', 'c']}
+            onClick={handleCopy}
+            disabled={isLoading}
+          />
+          <MenuItem
+            icon={RiScissorsLine}
+            label={t('skillSidebar.menu.cut')}
+            kbd={['ctrl', 'x']}
+            onClick={handleCut}
+            disabled={isLoading}
+          />
+        </>
+      )}
+
+      {isFolder && (
+        <MenuItem
+          icon={RiClipboardLine}
+          label={t('skillSidebar.menu.paste')}
+          kbd={['ctrl', 'v']}
+          onClick={handlePaste}
+          disabled={isLoading || !hasClipboard}
+        />
+      )}
+
       {showRenameDelete && (
         <>
+          <div className="my-1 h-px bg-divider-subtle" />
           <MenuItem
             icon={RiEdit2Line}
             label={t('skillSidebar.menu.rename')}
diff --git a/web/app/components/workflow/skill/file-tree/tree-node.tsx b/web/app/components/workflow/skill/file-tree/tree-node.tsx
index 351324b0b0..fc61d8906b 100644
--- a/web/app/components/workflow/skill/file-tree/tree-node.tsx
+++ b/web/app/components/workflow/skill/file-tree/tree-node.tsx
@@ -25,6 +25,7 @@ const TreeNode = ({ node, style, dragHandle }: NodeRendererProps<TreeNodeData>)
   const isFolder = node.data.node_type === 'folder'
   const isSelected = node.isSelected
   const isDirty = useStore(s => s.dirtyContents.has(node.data.id))
+  const isCut = useStore(s => s.isCutNode(node.data.id))
   const contextMenuNodeId = useStore(s => s.contextMenu?.nodeId)
   const hasContextMenu = contextMenuNodeId === node.data.id
 
@@ -59,10 +60,9 @@ const TreeNode = ({ node, style, dragHandle }: NodeRendererProps<TreeNodeData>)
         'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-components-input-border-active',
         isSelected && 'bg-state-base-active',
         hasContextMenu && !isSelected && 'bg-state-base-hover',
-        // Drag over highlight for folders
         isDragOver && 'bg-state-accent-hover ring-1 ring-inset ring-state-accent-solid',
-        // Blink animation when about to auto-expand (VSCode-style)
         isBlinking && 'animate-drag-blink',
+        isCut && 'opacity-50',
       )}
       onKeyDown={handleKeyDown}
       onContextMenu={handleContextMenu}
diff --git a/web/app/components/workflow/skill/hooks/use-skill-shortcuts.ts b/web/app/components/workflow/skill/hooks/use-skill-shortcuts.ts
new file mode 100644
index 0000000000..9c5f83ea4c
--- /dev/null
+++ b/web/app/components/workflow/skill/hooks/use-skill-shortcuts.ts
@@ -0,0 +1,66 @@
+'use client'
+
+import type { RefObject } from 'react'
+import type { TreeApi } from 'react-arborist'
+import type { TreeNodeData } from '../type'
+import { useKeyPress } from 'ahooks'
+import { useCallback, useEffect, useRef } from 'react'
+import { useWorkflowStore } from '@/app/components/workflow/store'
+import {
+  getKeyboardKeyCodeBySystem,
+  isEventTargetInputArea,
+} from '@/app/components/workflow/utils/common'
+
+type UseSkillShortcutsOptions = {
+  treeRef: RefObject<TreeApi<TreeNodeData> | null>
+  enabled?: boolean
+}
+
+export function useSkillShortcuts({
+  treeRef,
+  enabled = true,
+}: UseSkillShortcutsOptions): void {
+  const storeApi = useWorkflowStore()
+  const enabledRef = useRef(enabled)
+  useEffect(() => { enabledRef.current = enabled }, [enabled])
+
+  const shouldHandle = useCallback((e: KeyboardEvent) => {
+    if (!enabledRef.current)
+      return false
+    return !isEventTargetInputArea(e.target as HTMLElement)
+  }, [])
+
+  const getSelectedNodeIds = useCallback(() => {
+    const tree = treeRef.current
+    if (!tree)
+      return []
+    return tree.selectedNodes.map(n => n.id)
+  }, [treeRef])
+
+  useKeyPress(`${getKeyboardKeyCodeBySystem('ctrl')}.c`, (e) => {
+    if (shouldHandle(e)) {
+      const nodeIds = getSelectedNodeIds()
+      if (nodeIds.length > 0) {
+        e.preventDefault()
+        storeApi.getState().copyNodes(nodeIds)
+      }
+    }
+  }, { exactMatch: true, useCapture: true })
+
+  useKeyPress(`${getKeyboardKeyCodeBySystem('ctrl')}.x`, (e) => {
+    if (shouldHandle(e)) {
+      const nodeIds = getSelectedNodeIds()
+      if (nodeIds.length > 0) {
+        e.preventDefault()
+        storeApi.getState().cutNodes(nodeIds)
+      }
+    }
+  }, { exactMatch: true, useCapture: true })
+
+  useKeyPress(`${getKeyboardKeyCodeBySystem('ctrl')}.v`, (e) => {
+    if (shouldHandle(e) && storeApi.getState().hasClipboard()) {
+      e.preventDefault()
+      window.dispatchEvent(new CustomEvent('skill:paste'))
+    }
+  }, { exactMatch: true, useCapture: true })
+}
diff --git a/web/app/components/workflow/skill/hooks/use-sync-tree-with-active-tab.ts b/web/app/components/workflow/skill/hooks/use-sync-tree-with-active-tab.ts
index 66127fd2d7..75d5dbc8f4 100644
--- a/web/app/components/workflow/skill/hooks/use-sync-tree-with-active-tab.ts
+++ b/web/app/components/workflow/skill/hooks/use-sync-tree-with-active-tab.ts
@@ -27,8 +27,6 @@ export function useSyncTreeWithActiveTab({
     if (!activeTabId)
       return
 
-    storeApi.getState().setSelectedTreeNodeId(activeTabId)
-
     const tree = treeRef.current
     if (!tree)
       return
@@ -38,7 +36,6 @@ export function useSyncTreeWithActiveTab({
       if (!node)
         return
 
-      // Traverse parent chain to collect ancestor folder IDs
       const ancestors: string[] = []
       let current = node.parent
       while (current && !current.isRoot) {
@@ -50,6 +47,7 @@ export function useSyncTreeWithActiveTab({
         storeApi.getState().revealFile(ancestors)
 
       tree.openParents(node)
+      tree.select(activeTabId)
       tree.scrollTo(activeTabId)
     })
   }, [activeTabId, treeRef, storeApi])
diff --git a/web/app/components/workflow/skill/hooks/use-tree-node-handlers.ts b/web/app/components/workflow/skill/hooks/use-tree-node-handlers.ts
index 437cd4cc3c..602bb5d857 100644
--- a/web/app/components/workflow/skill/hooks/use-tree-node-handlers.ts
+++ b/web/app/components/workflow/skill/hooks/use-tree-node-handlers.ts
@@ -19,10 +19,6 @@ type UseTreeNodeHandlersReturn = {
   handleKeyDown: (e: React.KeyboardEvent) => void
 }
 
-/**
- * Hook that encapsulates all tree node interaction handlers.
- * Handles click, double-click, toggle, context menu, and keyboard events.
- */
 export function useTreeNodeHandlers({
   node,
 }: UseTreeNodeHandlersOptions): UseTreeNodeHandlersReturn {
@@ -49,10 +45,16 @@ export function useTreeNodeHandlers({
 
   const handleClick = useCallback((e: React.MouseEvent) => {
     e.stopPropagation()
-    node.select() // This triggers Tree's onSelect → setSelectedTreeNodeId
+    if (e.shiftKey)
+      node.selectContiguous()
+    else if (e.metaKey || e.ctrlKey)
+      node.selectMulti()
+    else
+      node.select()
+
     if (isFolder)
       throttledToggle()
-    else
+    else if (!e.metaKey && !e.ctrlKey && !e.shiftKey)
       handleFileClick()
   }, [handleFileClick, isFolder, node, throttledToggle])
 
@@ -72,9 +74,7 @@ export function useTreeNodeHandlers({
   const handleContextMenu = useCallback((e: React.MouseEvent) => {
     e.preventDefault()
     e.stopPropagation()
-
-    // Select the node for highlight + creation target
-    storeApi.getState().setSelectedTreeNodeId(node.data.id)
+    node.select()
     storeApi.getState().setContextMenu({
       top: e.clientY,
       left: e.clientX,
@@ -82,7 +82,7 @@ export function useTreeNodeHandlers({
       nodeId: node.data.id,
       isFolder,
     })
-  }, [isFolder, node.data.id, storeApi])
+  }, [isFolder, node, storeApi])
 
   const handleKeyDown = useCallback((e: React.KeyboardEvent) => {
     if (e.key === 'Enter' || e.key === ' ') {
diff --git a/web/app/components/workflow/store/workflow/skill-editor/clipboard-slice.ts b/web/app/components/workflow/store/workflow/skill-editor/clipboard-slice.ts
new file mode 100644
index 0000000000..c1a95a154a
--- /dev/null
+++ b/web/app/components/workflow/store/workflow/skill-editor/clipboard-slice.ts
@@ -0,0 +1,38 @@
+import type { StateCreator } from 'zustand'
+import type { ClipboardSliceShape, SkillEditorSliceShape } from './types'
+
+export type { ClipboardSliceShape } from './types'
+
+export const createClipboardSlice: StateCreator<
+  SkillEditorSliceShape,
+  [],
+  [],
+  ClipboardSliceShape
+> = (set, get) => ({
+  clipboard: null,
+
+  copyNodes: (nodeIds) => {
+    if (nodeIds.length === 0)
+      return
+    set({ clipboard: { operation: 'copy', nodeIds: new Set(nodeIds) } })
+  },
+
+  cutNodes: (nodeIds) => {
+    if (nodeIds.length === 0)
+      return
+    set({ clipboard: { operation: 'cut', nodeIds: new Set(nodeIds) } })
+  },
+
+  clearClipboard: () => {
+    set({ clipboard: null })
+  },
+
+  isCutNode: (nodeId) => {
+    const { clipboard } = get()
+    return clipboard?.operation === 'cut' && clipboard.nodeIds.has(nodeId)
+  },
+
+  hasClipboard: () => {
+    return get().clipboard !== null
+  },
+})
diff --git a/web/app/components/workflow/store/workflow/skill-editor/file-tree-slice.ts b/web/app/components/workflow/store/workflow/skill-editor/file-tree-slice.ts
index e4cdc24331..cfe3ec4c84 100644
--- a/web/app/components/workflow/store/workflow/skill-editor/file-tree-slice.ts
+++ b/web/app/components/workflow/store/workflow/skill-editor/file-tree-slice.ts
@@ -17,6 +17,7 @@ export const createFileTreeSlice: StateCreator<
 > = (set, get) => ({
   expandedFolderIds: new Set<string>(),
   selectedTreeNodeId: null,
+  selectedNodeIds: new Set<string>(),
   pendingCreateNode: null,
 
   setExpandedFolderIds: (ids: Set<string>) => {
@@ -61,6 +62,21 @@ export const createFileTreeSlice: StateCreator<
     set({ selectedTreeNodeId: nodeId })
   },
 
+  setSelectedNodeIds: (nodeIds) => {
+    const lastId = nodeIds.length > 0 ? nodeIds[nodeIds.length - 1] : null
+    set({
+      selectedNodeIds: new Set(nodeIds),
+      selectedTreeNodeId: lastId,
+    })
+  },
+
+  clearSelection: () => {
+    set({
+      selectedNodeIds: new Set<string>(),
+      selectedTreeNodeId: null,
+    })
+  },
+
   startCreateNode: (nodeType, parentId) => {
     set({
       pendingCreateNode: {
diff --git a/web/app/components/workflow/store/workflow/skill-editor/index.ts b/web/app/components/workflow/store/workflow/skill-editor/index.ts
index 8b4649f9c0..ddae1bfc8f 100644
--- a/web/app/components/workflow/store/workflow/skill-editor/index.ts
+++ b/web/app/components/workflow/store/workflow/skill-editor/index.ts
@@ -1,11 +1,13 @@
 import type { StateCreator } from 'zustand'
 import type { SkillEditorSliceShape } from './types'
+import { createClipboardSlice } from './clipboard-slice'
 import { createDirtySlice } from './dirty-slice'
 import { createFileOperationsMenuSlice } from './file-operations-menu-slice'
 import { createFileTreeSlice } from './file-tree-slice'
 import { createMetadataSlice } from './metadata-slice'
 import { createTabSlice } from './tab-slice'
 
+export type { ClipboardSliceShape } from './clipboard-slice'
 export type { DirtySliceShape } from './dirty-slice'
 export type { FileOperationsMenuSliceShape } from './file-operations-menu-slice'
 export type { FileTreeSliceShape } from './file-tree-slice'
@@ -16,6 +18,7 @@ export type { SkillEditorSliceShape } from './types'
 export const createSkillEditorSlice: StateCreator<SkillEditorSliceShape> = (...args) => ({
   ...createTabSlice(...args),
   ...createFileTreeSlice(...args),
+  ...createClipboardSlice(...args),
   ...createDirtySlice(...args),
   ...createMetadataSlice(...args),
   ...createFileOperationsMenuSlice(...args),
@@ -28,7 +31,9 @@ export const createSkillEditorSlice: StateCreator<SkillEditorSliceShape> = (...a
       previewTabId: null,
       expandedFolderIds: new Set<string>(),
       selectedTreeNodeId: null,
+      selectedNodeIds: new Set<string>(),
       pendingCreateNode: null,
+      clipboard: null,
       dirtyContents: new Map<string, string>(),
       fileMetadata: new Map<string, Record<string, unknown>>(),
       dirtyMetadataIds: new Set<string>(),
diff --git a/web/app/components/workflow/store/workflow/skill-editor/types.ts b/web/app/components/workflow/store/workflow/skill-editor/types.ts
index 891a9b2f66..89a47905cc 100644
--- a/web/app/components/workflow/store/workflow/skill-editor/types.ts
+++ b/web/app/components/workflow/store/workflow/skill-editor/types.ts
@@ -32,6 +32,9 @@ export type FileTreeSliceShape = {
   getOpensObject: () => OpensObject
   selectedTreeNodeId: string | null
   setSelectedTreeNodeId: (nodeId: string | null) => void
+  selectedNodeIds: Set<string>
+  setSelectedNodeIds: (nodeIds: string[]) => void
+  clearSelection: () => void
   pendingCreateNode: PendingCreateNode | null
   startCreateNode: (nodeType: PendingCreateNode['nodeType'], parentId: PendingCreateNode['parentId']) => void
   clearCreateNode: () => void
@@ -41,6 +44,22 @@ export type FileTreeSliceShape = {
   setFileTreeSearchTerm: (term: string) => void
 }
 
+export type ClipboardOperation = 'copy' | 'cut'
+
+export type ClipboardItem = {
+  operation: ClipboardOperation
+  nodeIds: Set<string>
+}
+
+export type ClipboardSliceShape = {
+  clipboard: ClipboardItem | null
+  copyNodes: (nodeIds: string[]) => void
+  cutNodes: (nodeIds: string[]) => void
+  clearClipboard: () => void
+  isCutNode: (nodeId: string) => boolean
+  hasClipboard: () => boolean
+}
+
 export type DirtySliceShape = {
   dirtyContents: Map<string, string>
   setDraftContent: (fileId: string, content: string) => void
@@ -76,6 +95,7 @@ export type FileOperationsMenuSliceShape = {
 export type SkillEditorSliceShape
   = TabSliceShape
     & FileTreeSliceShape
+    & ClipboardSliceShape
     & DirtySliceShape
     & MetadataSliceShape
     & FileOperationsMenuSliceShape
diff --git a/web/i18n/en-US/workflow.json b/web/i18n/en-US/workflow.json
index edeedeb5e4..57e71ebaba 100644
--- a/web/i18n/en-US/workflow.json
+++ b/web/i18n/en-US/workflow.json
@@ -1023,7 +1023,9 @@
   "skillSidebar.folderName": "Folder name",
   "skillSidebar.folderNamePlaceholder": "Folder name",
   "skillSidebar.loadError": "Failed to load files",
+  "skillSidebar.menu.copy": "Copy",
   "skillSidebar.menu.createError": "Failed to create item",
+  "skillSidebar.menu.cut": "Cut",
   "skillSidebar.menu.delete": "Delete",
   "skillSidebar.menu.deleteConfirmContent": "This will permanently delete the folder and all its contents. Any open files from this folder will be closed.",
   "skillSidebar.menu.deleteConfirmTitle": "Delete folder?",
@@ -1045,6 +1047,7 @@
   "skillSidebar.menu.newFilePrompt": "Enter file name (with extension, e.g., script.py):",
   "skillSidebar.menu.newFolder": "New Folder",
   "skillSidebar.menu.newFolderPrompt": "Enter folder name:",
+  "skillSidebar.menu.paste": "Paste",
   "skillSidebar.menu.rename": "Rename",
   "skillSidebar.menu.renameError": "Failed to rename",
   "skillSidebar.menu.renamed": "Renamed successfully",
diff --git a/web/i18n/zh-Hans/workflow.json b/web/i18n/zh-Hans/workflow.json
index 01056786e2..468e36df19 100644
--- a/web/i18n/zh-Hans/workflow.json
+++ b/web/i18n/zh-Hans/workflow.json
@@ -1015,7 +1015,9 @@
   "skillSidebar.folderName": "文件夹名称",
   "skillSidebar.folderNamePlaceholder": "文件夹名称",
   "skillSidebar.loadError": "加载文件失败",
+  "skillSidebar.menu.copy": "复制",
   "skillSidebar.menu.createError": "创建失败",
+  "skillSidebar.menu.cut": "剪切",
   "skillSidebar.menu.delete": "删除",
   "skillSidebar.menu.deleteConfirmContent": "这将永久删除该文件夹及其所有内容。该文件夹中已打开的文件标签将被关闭。",
   "skillSidebar.menu.deleteConfirmTitle": "删除文件夹？",
@@ -1036,6 +1038,7 @@
   "skillSidebar.menu.newFilePrompt": "请输入文件名（包含扩展名，如 script.py）：",
   "skillSidebar.menu.newFolder": "新建文件夹",
   "skillSidebar.menu.newFolderPrompt": "请输入文件夹名称：",
+  "skillSidebar.menu.paste": "粘贴",
   "skillSidebar.menu.rename": "重命名",
   "skillSidebar.menu.renameError": "重命名失败",
   "skillSidebar.menu.renamed": "重命名成功",