# ClipboardSync

**Repository Path**: yuxuebo/clipboard-sync

## Basic Information

- **Project Name**: ClipboardSync
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-04
- **Last Updated**: 2026-05-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# ClipboardSync

一个基于 WPF 的剪贴板同步工具，支持局域网设备发现与剪贴板历史记录管理。

## 功能特性

- 📋 **剪贴板监控** - 自动记录文本、图片和文件路径
- 🌐 **局域网设备发现** - 通过 UDP 广播自动发现同网络设备
- 📝 **历史记录** - 支持按类型筛选剪贴板历史，支持一键复制
- 🖌 **主题切换** - 支持浅色/深色主题一键切换
- 📥 **系统托盘** - 最小化到系统托盘运行
- 🪟 **无边框窗口** - 现代简约的自定义标题栏设计

## 技术栈

- .NET 8.0
- WPF (Windows Presentation Foundation)
- MVVM 架构 (CommunityToolkit.Mvvm)
- UDP 广播用于设备发现

## 快速开始

### 环境要求

- Windows 10/11
- .NET 8.0 SDK 或更高版本

### 构建运行

```bash
# 克隆项目
git clone https://gitee.com/yuxuebo/clipboard-sync.git
cd clipboard-sync

# 还原依赖
dotnet restore

# 构建项目
dotnet build

# 运行
dotnet run
```

或使用 Visual Studio 打开 `tiebahelper.slnx` 解决方案文件进行开发。

## 项目结构

```
ClipboardSync/
├── Models/                 # 数据模型
│   ├── ClipboardRecord.cs # 剪贴板记录
│   └── DeviceInfo.cs      # 设备信息
├── Services/              # 核心服务
│   ├── ClipboardWatcher.cs   # 剪贴板监控
│   ├── DiscoveryService.cs  # 局域网设备发现
│   └── ThemeService.cs      # 主题服务
├── ViewModels/            # 视图模型
│   ├── MainViewModel.cs     # 主窗口
│   ├── HomeViewModel.cs     # 首页
│   ├── HistoryViewModel.cs # 历史记录
│   └── SettingsViewModel.cs
├── Views/                 # 视图
│   ├── MainWindow.xaml     # 主窗口
│   ├── Home.xaml           # 首页
│   ├── History.xaml        # 历史记录
│   └── Settings.xaml       # 设置
├── Resources/             # 资源文件
│   ├── Themes/             # 主题定义
│   └── Styles.xaml          # 样式
└── App.xaml                # 应用程序入口
```

## 使用说明

### 主界面

程序启动后显示主界面，包含三个主要页面：
- **首页** - 显示在线设备和连接状态
- **历史** - 查看和管理剪贴板历史记录
- **设置** - 主题切换等配置

### 剪贴板监控

程序会自动监控系统剪贴板变化，支持：
- 📝 文本内容
- 🖼 图片数据
- 📎 文件路径

### 设备发现

通过 UDP 广播在局域网内自动发现其他运行本程序的设备，实现剪贴板数据同步。

### 系统托盘

关闭窗口时程序会最小化到系统托盘，右键托盘图标可选择退出程序。

## 配置说明

### 主题切换

在设置页面可切换浅色/深色主题，主题会即时生效。

### 历史记录数量

默认保留最近 100 条剪贴板记录，可在 `ClipboardWatcher` 中配置。

## 开源许可

本项目基于 MIT 许可证开源。