# xc

**Repository Path**: dravin/xc

## Basic Information

- **Project Name**: xc
- **Description**: 粘贴板同步器
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-20
- **Last Updated**: 2026-01-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 剪贴板同步 (Clipboard Sync)

一个基于 Electron 的跨平台剪贴板同步应用，支持 Windows 和 Mac。实现多台机器之间的剪贴板内容实时互通。

## 功能特性

- 实时同步剪贴板内容到多台远程机器
- TCP Socket 通信，无需云服务器
- 简洁友好的图形界面
- 自动重连机制
- 支持连接多台机器同时同步
- 本地存储远程机器配置

## 安装

```bash
# 安装依赖
npm install
```

## 运行

```bash
# 开发模式运行
npm run dev

# 正常运行
npm start
```

## 使用方法

1. **启动服务器**
   - 在"服务器设置"中设置监听端口（默认 9999）
   - 点击"启动服务器"按钮
   - 记住显示的本机 IP 地址和端口

2. **添加远程机器**
   - 在另一台机器上启动应用
   - 在"添加远程机器"区域填写：
     - 名称：如"办公电脑"
     - IP 地址：对方机器的 IP 地址
     - 端口：对方机器的监听端口（默认 9999）
   - 点击"添加"按钮

3. **双向同步**
   - 每台机器都需要添加对方为远程机器
   - 建议两台机器都添加对方，实现双向同步

4. **剪贴板同步**
   - 复制任何文本内容后，会自动同步到所有已连接的机器
   - 可以在"同步日志"中查看同步记录
   - 可以在"当前剪贴板"中查看和复制内容

## 打包发布

```bash
# 打包 Windows 版本
npm run build:win

# 打包 Mac 版本
npm run build:mac
```

打包后的文件在 `dist` 目录中。

## 技术栈

- Electron: 跨平台桌面应用框架
- Node.js: 后端逻辑
- TCP Socket: 网络通信
- HTML/CSS/JavaScript: 前端界面

## 注意事项

1. 确保所有机器在同一局域网内
2. 确保防火墙允许所选端口的通信
3. 应用需要保持运行状态才能持续同步
4. 建议使用 1024-65535 之间的端口号

## 文件结构

```
clipboard-sync/
├── main.js              # 主进程
├── preload.js           # 预加载脚本
├── clipboard-server.js  # TCP 服务器
├── clipboard-client.js  # TCP 客户端
├── index.html           # 主界面
├── renderer.js          # 渲染进程
├── styles.css           # 样式文件
├── package.json         # 项目配置
└── assets/              # 资源文件
```

## 许可证

MIT