ClipRay

跨平台开源剪贴板管理器，基于 Tauri 2.x（Rust + React）构建，面向开发者优化。

截图预览

主要特性

• 实时剪贴板监控 — 300ms 轮询检测，SHA256 内容去重
• 悬浮面板 — 全局快捷键唤起，系统托盘常驻
• 键盘导航 — 方向键选择，Enter 粘贴，Esc 关闭
• 即时搜索 — 模糊匹配，150ms 防抖
• 智能分类 — 自动识别文本、代码、链接、文件、图片类型
• 代码语法高亮 — 支持 15+ 种编程语言的自动检测与高亮
• 代码模板管理 — 保存常用代码片段，支持 {{变量}} 模板替换
• 悬浮详情面板 — 鼠标悬停查看完整内容、来源应用、代码语言
• 隐私过滤 — 自动忽略密码管理器（1Password、Bitwarden 等）的复制内容
• 图片剪贴板 — 记录和预览复制的图片
• 深色模式 — 浅色/深色/跟随系统
• 国际化 — 中文 / English
• 开机自启 — 系统登录时自动启动
• 自定义快捷键 — 动态配置全局快捷键
• 数据同步 — WebDAV 云同步 + 局域网 P2P 同步（端到端加密）
• 跨平台 — macOS / Windows / Linux

技术栈

层级	技术
前端	React 19, TypeScript, Tailwind CSS v4, shadcn/ui
后端	Rust, Tauri 2.x
数据库	SQLite (rusqlite, WAL 模式)
剪贴板	arboard (跨平台)
macOS API	objc2-app-kit (前台应用检测)
同步	WebDAV, mDNS + TCP P2P, AES-256-GCM 加密

快速开始

环境要求

• Node.js 18+
• Rust (最新稳定版)
• Tauri CLI

安装与运行

# 安装依赖
npm install

# 开发模式
npm run tauri dev

# 构建生产版本
npm run tauri build

快捷键

快捷键	功能
Cmd/Ctrl + Shift + V	唤起/隐藏面板（可自定义）
↑ / ↓	上下选择条目
Enter	粘贴选中条目
1 - 9	快速粘贴前 9 条
Esc	关闭面板
Cmd/Ctrl + ,	打开设置
Alt/Option + P	置顶/取消置顶
Backspace / Delete	删除选中条目

项目结构

ClipRay/
├── src/                      # 前端源码
│   ├── App.tsx               # 主界面（面板、列表、详情）
│   ├── components/
│   │   ├── Settings.tsx      # 设置页面
│   │   ├── Snippets.tsx      # 代码模板管理
│   │   ├── DragRegion.tsx    # 跨平台窗口拖拽
│   │   └── PromptDialog.tsx  # 自定义输入对话框
│   ├── hooks/
│   │   ├── useClips.ts       # 剪贴板数据管理
│   │   ├── useTheme.ts       # 主题切换
│   │   └── useLanguage.ts    # 语言切换
│   ├── i18n/                 # 国际化翻译
│   └── types/                # TypeScript 类型定义
├── src-tauri/                # Rust 后端
│   └── src/
│       ├── lib.rs            # 应用入口（插件、托盘、快捷键）
│       ├── clipboard.rs      # 剪贴板监控 + 语言检测
│       ├── commands.rs       # Tauri IPC 命令
│       ├── sync.rs           # WebDAV + LAN 同步
│       └── db.rs             # SQLite 数据库操作
├── assets/                   # 截图与资源
├── prd/                      # 产品需求文档
└── package.json

许可证

MIT