PasteLite

English README

复制时少打断，粘贴时再选择。
被后续复制覆盖的内容，也还能从历史里找回。

为什么用 PasteLite

• 少切换：先连续复制，再统一切过去选择粘贴。
• 可找回：旧内容不会被新复制彻底冲掉，历史里还能搜到。
• 极简主义：不堆功能、不堆窗口、不堆设置，只保留最常用的那条路径。
• 极度轻量级：打开快、选择快、粘贴快，用完就走，不打断当前工作。

使用方式

默认快捷键：Option+V（可在 Settings 中修改）

以前：

复制 -> 切换 -> 粘贴 -> 复制 -> 切换 -> 粘贴

现在：

复制 -> 复制 -> 切换 -> 打开历史 -> 选择 -> 粘贴

如果旧内容后来被新的复制覆盖，也可以直接从历史里重新找到。

当前功能

• 全局快捷键呼出 Quick Paste
• 搜索最近剪贴板历史
• 单击或回车直接粘贴文本 / 图片
• 粘贴后自动关闭面板
• 设置页仅保留最小必要项：
  • 呼出快捷键，默认 Option+V
  • 历史最大条数，范围 1..300，默认 100
  • 开机启动
• 清理所有历史数据（带确认）
• 菜单栏常驻，Dock 图标隐藏

项目定位

PasteLite 是一个 macOS-only 的原生菜单栏剪贴板工具，当前实现为 Rust core + AppKit shell。

当前范围外能力

以下能力不属于当前版本范围：

• 主窗口
• collections / tabs / notes
• 表单模板、帮助引导、复杂设置
• Windows / Linux 支持

仓库结构

.
├── Cargo.toml
├── crates
│   ├── pastelite-core
│   │   └── src
│   └── pastelite-native-macos
│       ├── resources
│       └── src

• crates/pastelite-core 负责数据库、设置、剪贴板读写、历史捕获、历史裁剪、自动启动数据层。
• crates/pastelite-native-macos 负责 AppKit 菜单栏应用、Quick Paste 面板、Settings 面板、Carbon 全局热键和原生打包。

运行要求

• macOS 11.0+
• Rust stable
• Xcode Command Line Tools

打包脚本依赖系统自带工具：

• sips
• iconutil
• hdiutil

本地开发

检查：

cargo check --workspace --all-targets

核心层测试：

cargo test -p pastelite-core

运行原生应用：

cargo run -p pastelite-native-macos

生成 .app 与 .dmg：

bash crates/pastelite-native-macos/package.sh

运行时数据

PasteLite 的运行时数据不会写入仓库目录，默认写到当前用户目录：

• 数据库：~/Library/Application Support/app.pastelite/pastelite.db
• 图片缓存：~/Library/Application Support/app.pastelite/clipboard-images/
• 开机启动：~/Library/LaunchAgents/PasteLite.plist

也支持用环境变量覆盖数据目录：

• PASTELITE_APP_SUPPORT_DIR
• PASTELITE_DB_PATH

权限说明

如果要实现“写入剪贴板后自动触发粘贴”，需要在 macOS 中授予 PasteLite Accessibility（辅助功能） 权限。没有该权限时，应用会给出原生提示，不会静默失败。

隐私与公开源码发布

• 仓库不包含用户剪贴板数据库、图片缓存、启动项文件或任何本地助手状态目录内容。
• .gitignore 已忽略本地运行状态、构建产物和编辑器垃圾文件。
• 发布到 GitHub 前，只需要提交源码、资源文件和文档，不要提交 dist/、target/ 或任何用户数据。

许可证

本仓库使用自定义许可证，基于 CC BY-NC 并附加有限商业复用例外条款。详见 LICENSE。

这意味着仓库当前更准确地属于 source-available（源码可见），而不是 OSI-approved open source（OSI 批准的标准开源许可证）。