feat: 改进图片处理稳定性并添加富文本支持

[cyole]

Description

Linked Issues

Additional context

Summary by CodeRabbit

• New Features

  • Added HTML content support to clipboard synchronization between devices.

• Improvements

  • Enhanced image handling with size optimization and compression for better performance.
  • Improved error handling and logging for clipboard operations on all platforms.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

The changes add HTML content support to a clipboard synchronization system. The implementation includes new enum variants for HTML content, restructured clipboard monitoring with a unified task-based architecture, enhanced image handling with compression and size constraints, new Linux Wayland clipboard utilities, and centralized error handling with graceful fallbacks.

Changes

Cohort / File(s)	Summary
HTML Content Type Support src/modules/sync.rs, src/modules/clipboard.rs	Added Html variant to ClipboardContent enum with html and text fields; includes serde support for serialization/deserialization and hashing integration.
Clipboard Synchronization Architecture src/main.rs	Refactored clipboard monitoring from callback-based to unified event loop driven by local monitor signals; server now broadcasts ClipboardMessage with HTML content support; client extended to log and apply received HTML content; replaced separate handlers with consolidated task management.
Image Processing & Linux Clipboard Integration src/modules/clipboard.rs	Added image size constraints (MAX_IMAGE_SIZE 5 MB, MAX_IMAGE_DIMENSION 4096); implemented iterative PNG compression with aspect-ratio-preserving resize; enhanced image fallback handling with logging; added Linux Wayland utilities (wl_copy_html, wl_paste, wl_paste_image); centralized error logging in clipboard read/set operations.

Sequence Diagram

sequenceDiagram
    participant LM as Local Monitor
    participant Server
    participant Client
    participant CB as Local Clipboard

    Note over LM,Client: New Unified Clipboard Management Flow
    
    loop Periodic Monitoring
        LM->>LM: Signal via internal channel
        LM->>LM: Fetch current clipboard (Text/Image/Html)
    end
    
    alt Local Content Changed
        LM->>Server: Broadcast ClipboardMessage<br/>(Text | Image | Html)
        Server->>Server: Log content type & length
        Server->>Client: Forward ClipboardMessage
    end
    
    alt Client Receives Message
        Client->>Client: Detect content type
        Client->>Client: Log received content<br/>(Text/Image/Html)
        Client->>CB: Apply to local clipboard
    end

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~50 minutes

• Unified clipboard task architecture in src/main.rs: Review the new event loop structure, channel signaling, and task coordination with shutdown handling
• Image compression and dimension handling in src/modules/clipboard.rs: Validate iterative compression logic, aspect-ratio preservation, and size-based downscaling decisions
• Linux Wayland integration (wl_paste, wl_paste_image, wl_copy_html): Verify fallback paths and error handling for platform-specific clipboard operations
• Cross-file HTML variant consistency: Ensure HTML content flows correctly through enum definitions, serialization, hashing, and message broadcasting

Poem

🐰 HTML hops into the clipboard, no more just text!
From server to client, through channels of jest—
Wayland whispers, images shrink with care,
One unified task keeps the sync so fair! ✨

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/stable-image-and-richtext

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 28cf2d8 and bdc89cf.

📒 Files selected for processing (3)

• src/main.rs (5 hunks)
• src/modules/clipboard.rs (9 hunks)
• src/modules/sync.rs (1 hunks)

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}