Pull Request: Clipboard Image Paste Support

PR Title

feat(cli): Add clipboard image paste via /paste-image and Alt+V

PR Description

Problem

Currently, sharing visual content (screenshots, diagrams, error messages) with Qwen Code requires:

1. Manually saving the image to a file
2. Navigating to the correct directory
3. Using the @path/to/image.png syntax to reference it

This friction discourages users from sharing visual context, reducing the AI's ability to help with UI bugs, error screenshots, and design feedback.

Solution

This PR introduces native clipboard image pasting - a seamless way to share images directly from the system clipboard.

Features

User Experience

> /paste-image

📎 Clipboard image loaded
• Path: .qwen-clipboard/clipboard-1768697710562.png
• Type: image/png
• Size: 60.3 KB
• Hash: 9ca7f144…3dfa
• Auto-delete: 5 minutes

📌 To reference this image, type: @.qwen-clipboard/clipboard-1768697710562.png

The image reference is automatically inserted into the input field, ready for the user to add their question.

Implementation Details

Architecture

┌─────────────────────────────────────────────────────────────┐
│                     User Interaction                        │
│              /paste-image  OR  Alt+V shortcut               │
└─────────────────────────┬───────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│                  pasteImageCommand.ts                       │
│           Slash command handler & orchestration             │
└─────────────────────────┬───────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│                   clipboardUtils.ts                         │
│              Cross-platform clipboard access                │
├─────────────────┬─────────────────┬─────────────────────────┤
│     Windows     │      macOS      │         Linux           │
│   PowerShell +  │   AppleScript   │  xclip / xsel /         │
│  System.Windows │   (osascript)   │  wl-paste (Wayland)     │
│     .Forms      │                 │                         │
└─────────────────┴─────────────────┴─────────────────────────┘

Files Changed

Platform-Specific Implementation

Windows:

• Uses System.Windows.Forms.Clipboard (more reliable than PresentationCore)
• Runs PowerShell with -sta flag for COM compatibility
• Saves directly as PNG using System.Drawing.Imaging

macOS:

• Uses AppleScript to access clipboard data
• Supports multiple formats: PNG, JPEG, TIFF, GIF
• Falls back through formats if primary fails

Linux:

• Supports both X11 (xclip, xsel) and Wayland (wl-paste)
• Auto-detects available clipboard tool
• Graceful fallback chain

Testing

Automated

• npm run preflight passes (build, lint, type-check, tests)
• Unit tests for clipboard utilities

Manual

• Windows 11 (PowerShell): verified
• macOS / Linux: designed and implemented, pending manual verification

Security Considerations

• No external network requests - All clipboard operations are local
• Short TTL - Auto-delete duration is currently fixed at 5 minutes and can be made configurable in a follow-up PR if desired.
• Project-scoped - Images saved within project directory (.qwen-clipboard/)
• No sensitive data logging - Only logs file metadata, not image contents

Documentation

Full user documentation added at docs/clipboard-paste-feature.md including:

• Usage instructions for both methods
• Platform requirements (Linux packages)
• Troubleshooting guide
• Example workflow

Breaking Changes

None. This is a purely additive feature.

Checklist

• Code follows project style guidelines
• Self-reviewed the code
• Added documentation
• Added tests
• All existing tests pass
• No new warnings

Demo