# 剪贴云

**Repository Path**: caodaimin/clip-cloud

## Basic Information

- **Project Name**: 剪贴云
- **Description**: 一款可以分组，登录账号云保存的剪贴板！ 复制粘贴。免费！开源。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-12
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 剪贴板, 粘贴板

## README

# 剪贴云

一个原生 Windows 剪贴板历史工具，默认按 `Ctrl + Shift + V` 弹出历史文本列表。

## 已实现

- 自动监听系统剪贴板，仅记录文本内容
- 默认保存最近 200 条历史
- 支持文本置顶，置顶项始终排在最上方
- 支持复制、删除、清空未置顶内容
- 托盘常驻运行，双击托盘图标也可打开
- 支持从托盘右键菜单自定义全局快捷键
- 面板会跟随当前鼠标光标所在位置弹出
- 支持把剪贴板历史同步保存到 FastAdmin

## 目录说明

- `ClipboardCloud`：Windows 桌面端
- `clip-cloud`：FastAdmin 后端

## 桌面端运行

```powershell
dotnet build .\ClipboardCloud.sln
dotnet run --project .\ClipboardCloud\ClipboardCloud.csproj
```

## FastAdmin 接入

### 1. 导入数据表

执行下面这个 SQL 文件：

- [clipboard_cloud.sql](d:\AI-EXE\剪贴云\clip-cloud\database\clipboard_cloud.sql)

### 2. 启动 FastAdmin

保证你的 FastAdmin 站点可以访问，例如：

- `http://127.0.0.1:8000`

### 3. 配置桌面端

桌面端首次启动后，会自动生成配置文件：

- `ClipboardCloud\bin\Debug\net8.0-windows\data\app-settings.json`

发布版则在 `exe` 同目录下的 `data\app-settings.json`。

默认 FastAdmin 配置如下：

```json
{
  "FastAdmin": {
    "Enabled": true,
    "BaseUrl": "http://127.0.0.1:8000",
    "ApiKey": "clipcloud-local-key",
    "TimeoutSeconds": 3
  }
}
```

### 4. 配置后端密钥

FastAdmin 端配置文件：

- [clipboard.php](d:\AI-EXE\剪贴云\clip-cloud\application\extra\clipboard.php)

默认密钥也是：

- `clipcloud-local-key`

桌面端和 FastAdmin 端的 `ApiKey` 必须一致。

## 当前同步方式

- 桌面端仍保留本地缓存 `data/clipboard-history.json`
- 每次数据变化时，先写本地缓存，再异步全量同步到 FastAdmin
- 启动时会优先尝试从 FastAdmin 拉取当前设备的数据
- 如果 FastAdmin 暂时不可用，桌面端仍可继续工作

## 已新增的 FastAdmin 文件

- [Clipboard.php](d:\AI-EXE\剪贴云\clip-cloud\application\api\controller\Clipboard.php)
- [ClipboardItem.php](d:\AI-EXE\剪贴云\clip-cloud\application\common\model\ClipboardItem.php)
- [clipboard.php](d:\AI-EXE\剪贴云\clip-cloud\application\extra\clipboard.php)
- [clipboard_cloud.sql](d:\AI-EXE\剪贴云\clip-cloud\database\clipboard_cloud.sql)