Clipin

快速搜索、连续粘贴、键盘优先的 macOS 剪贴板管理器
_{A keyboard-first clipboard manager for macOS, built with Rust + SwiftUI.}

下载 · 快捷键 · 路线图 · English

---

TODO: Add screenshot / GIF

---

功能亮点

🔍 即时搜索 — 中英文全文检索（FTS5 trigram），输入即高亮匹配

⌨️ 键盘优先 — 方向键导航、回车粘贴、⌘1-9 快速粘贴前 9 条

📌 连续粘贴 — ⌘⇧L 开启 Stay 模式，跨应用点击输入框后面板自动夺回焦点，连续选择并粘贴

🎯 动作面板 — ⌘K 打开命令面板，键入即筛选，空态下也可用

🔒 隐私优先 — 数据全部本地 SQLite 存储，自动跳过密码管理器等敏感剪贴板内容

☁️ 自动备份 — 可备份到 iCloud Drive 或任意文件夹，支持剪贴板变化 / 日 / 周 / 月频率

🌐 双语界面 — 内建简体中文 / English，兼顾中文搜索与界面切换

📁 多文件感知 — Finder 多选复制完整保留，粘贴和 Reveal 都按整组处理

♾️ 长期存储 — 支持 7 天到永久保留，条目上限最高 50K 或不限

⚡ Rust 驱动 — Rust + SQLite + FTS5 存储引擎，毫秒级响应，Swift 6 strict concurrency

安装

直接下载

1. 前往 Releases 下载最新 Clipin-vX.X.X-macOS.zip
2. 解压得到 Clipin.app，拖入 /Applications
3. 首次打开如果被系统拦截，右键点"打开"完成确认
4. 授予「辅助功能」权限后即可使用

源码构建

需要：Rust stable、Xcode 16+、xcodegen

git clone https://github.com/ccfco/Clipin.git
cd Clipin

# 构建 Rust core + 生成 Swift bindings
./scripts/build-rust.sh

# 生成 Xcode 项目
xcodegen generate

# 构建并部署到 /Applications（含稳定签名，辅助功能权限不丢失）
./scripts/deploy.sh

快捷键

快捷键	功能
⌘⇧V	打开/关闭剪贴板面板
↑ ↓	上下导航
↵	粘贴选中项
⇧↵	以纯文本粘贴
⌘1–⌘9	快速粘贴前 9 条
⌘C	复制到剪贴板（不粘贴）
⌘⇧P	固定/取消固定
⌘⌫	删除条目
⌘O	打开 URL / 在 Finder 中显示文件
⌘K	打开动作面板
Tab / ⇧Tab	切换类型筛选
⌘⇧L	开启/关闭 Stay 模式
⌘,	打开设置
Esc	先清除搜索/筛选，再关闭面板

路线图

计划中：

• iCloud 同步
• 浮动笔记模式

已完成：

• 连续粘贴（Stay 模式）
• 长期/永久历史保留
• FTS5 全文搜索
• 动作面板 + 键入筛选
• 隐私感知采集
• 自动备份到 iCloud Drive / 本地文件夹
• 多主题支持
• 多语言（i18n）

架构

┌─────────────────────────────────────────┐
│              SwiftUI Frontend            │
│  MainPanel · SearchBar · PreviewPane    │
├─────────────────────────────────────────┤
│           UniFFI Bridge (auto-gen)       │
├─────────────────────────────────────────┤
│              Rust Core                   │
│  SQLite + FTS5 · Search · Data Model    │
└─────────────────────────────────────────┘

• Rust — 存储、搜索、数据完整性，通过 SQLite + FTS5 实现
• SwiftUI — Raycast 风格双栏布局，原生 macOS 体验
• UniFFI — 自动生成 Swift ↔ Rust 绑定

项目结构

Clipin/
├── rust/src/          # Rust core（存储、模型、搜索）
├── Clipin/
│   ├── App/           # AppDelegate，入口
│   ├── Views/         # SwiftUI 视图
│   ├── ViewModels/    # ClipboardViewModel
│   ├── Services/      # 剪贴板监控、粘贴服务、热键
│   └── Generated/     # UniFFI 自动生成（gitignored）
├── scripts/
│   ├── build-rust.sh  # 构建 Rust + 生成绑定
│   └── deploy.sh      # 部署到 /Applications（含稳定签名）
└── project.yml        # xcodegen 配置

---

English

What is Clipin?

A keyboard-first clipboard manager for macOS, built with Rust + SwiftUI.

Highlights:

• Instant full-text search (FTS5 trigram) with Chinese & English support
• Keyboard-driven: arrow keys, Enter to paste, ⌘1-9 quick paste
• Stay mode (⌘⇧L): continuous paste across apps without extra hotkey presses
• Action palette (⌘K): type to filter commands
• Privacy-first: all data stored locally, sensitive clipboard content auto-skipped
• Long-term storage: keep history forever with configurable retention
• Rust-powered: SQLite + FTS5 engine, millisecond response times

Install

Download the latest .zip from Releases, unzip, drag to /Applications, and grant Accessibility permission on first launch.

Or build from source:

git clone https://github.com/ccfco/Clipin.git && cd Clipin
./scripts/build-rust.sh && xcodegen generate && ./scripts/deploy.sh

License

MIT