Skip to content

About

QuickPaste is a cross platform clipboard management tool that allows users to easily manage and access commonly used custom text fragments. It is hidden in the system taskbar and can be quickly selected and pasted by clicking on the pop-up shortcut menu.

Resources

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

QuickPaste

QuickPaste

常用的话,随手可得。

菜单栏里的快捷粘贴工具。唤起、搜索、粘贴,继续手头的事。

Native SwiftUI on macOS · Electron on Windows · Local-first

构建与测试 · Releases · 反馈问题

在你需要的地方出现

点击菜单栏/系统托盘图标,QuickPaste 就在图标附近展开。按下全局快捷键,浮层会出现在鼠标附近,并自动避开屏幕边缘。输入几个字,点击片段或按回车,把内容粘贴回刚才的应用。点外部或按 Esc 即可收起。

日常使用只需要这个轻量浮层。编辑、分组、备份和设置放在独立的「管理片段」界面。

macOS 原生快捷浮层 Windows 快捷浮层

左:macOS 原生浮层 · 右:Windows 客户端浮层(在 Mac 上运行 Electron 截图)

查看独立的片段管理界面

macOS 片段管理 Windows 客户端片段管理

能做什么

  • 快捷浮层:就近展开、即时搜索、方向键选择、回车粘贴、失焦收起。
  • 常用文本片段:保存回复、代码、地址、模板等纯文本;支持中文、Emoji 和多行内容。
  • 收藏与分组:收藏优先展示,可按标题、内容和分组搜索。
  • 系统集成:macOS 菜单栏、Windows 托盘、可切换的全局快捷键和可选登录启动。
  • 自动粘贴与仅复制:尝试恢复目标应用焦点后粘贴;缺少权限或无法恢复焦点时保留已复制内容并提示手动粘贴。
  • 本地数据:无需账号,不上传片段,不监控剪贴板历史。JSON 导入导出可在两端交换数据。
  • 旧版迁移:首次运行时自动读取旧的 store.json,保留原文件,并使用新的版本化格式保存。

两个平台,两套合适的实现

macOS Windows
界面 SwiftUI + AppKit,原生浮层与管理界面 Electron,独立浮层与管理界面
系统入口 NSStatusItem 菜单栏图标 系统托盘图标
自动粘贴 NSWorkspace + Quartz 键盘事件 Win32 焦点恢复 + SendInput
默认唤起快捷键 ⌘ ⇧ Space Ctrl Shift Space
系统要求 macOS 13+,Apple Silicon / Intel Windows 10 / 11,x64 / ARM64
数据交换 QuickPaste JSON v2 QuickPaste JSON v2

macOS 客户端不依赖 Electron 或 Node.js。Windows 原生操作由随应用分发的 PowerShell 桥接脚本实现,片段文本只写入剪贴板,不拼接到脚本或命令中。

开始使用

  1. 启动 QuickPaste,在菜单栏/托盘找到图标。
  2. 点击浮层右下角的「管理片段」,创建第一个片段。
  3. 回到要输入内容的应用,把光标放进输入框。
  4. 点击图标或按全局快捷键,搜索片段,点击或按 Enter 粘贴。

在管理界面的「偏好设置」中可以选择三组预设快捷键、启用登录启动,以及导入/导出 JSON。快捷键冲突时会提示并保留原设置;启动时注册失败也可继续使用图标入口。

macOS 自动粘贴需要在「系统设置 → 隐私与安全性 → 辅助功能」中允许 QuickPaste。可从应用设置中发起授权;仅复制无需此权限。更换应用路径、签名或版本后,系统可能要求重新授权。

Windows 自动粘贴受系统焦点规则和进程权限限制。管理员权限运行的目标应用、受保护输入框以及不接受标准粘贴快捷键的应用可能无法自动粘贴,此时请手动粘贴。企业策略禁止 PowerShell 时仍可使用仅复制功能。

快捷操作

操作 macOS Windows
唤起/收起浮层 默认 ⌘ ⇧ Space 默认 Ctrl Shift Space
选择片段 ↑ / ↓ ↑ / ↓
粘贴选中片段 Enter 或单击 Enter 或单击
仅复制(浮层) 右键片段 → 仅复制 右键片段或 Ctrl Shift C
收起浮层 Esc 或点外部 Esc 或点外部
新建片段(管理界面) ⌘ N Ctrl N
搜索(管理界面) ⌘ F Ctrl F
保存编辑 ⌘ Enter Ctrl Enter
仅复制(管理界面) ⌘ Shift C Ctrl Shift C

安装与构建

当前仓库是 2.0 重构源码。只有在 Releases 中实际发布的附件才是对应版本的安装包;GitHub Actions 生成的测试构建可以从运行记录的 Artifacts 下载。工作流不会自动创建 Release 或发布附件。

macOS 原生客户端

需要 Xcode 14.3+,或包含 Swift 5.8+ 和 macOS 13 SDK 的独立 Command Line Tools。无需安装 JavaScript 依赖。

git clone https://github.com/EvilGenius-dot/QuickPaste.git
cd QuickPaste
bash scripts/build-macos.sh arm64       # Apple Silicon
bash scripts/build-macos.sh x86_64      # Intel

输出示例:

dist/macos/arm64/QuickPaste.app
dist/macos/QuickPaste-2.0.0-macOS-arm64.zip

把 .app 放进「应用程序」后运行。开发阶段也可以在 Xcode 中打开 macos/Package.swift。

如系统默认指向尚未完成首次配置的 Xcode,而你已安装独立命令行工具,可以显式选择后者:

DEVELOPER_DIR=/Library/Developer/CommandLineTools bash scripts/build-macos.sh arm64

本地脚本默认采用临时签名;它不等于 Developer ID 签名或 Apple 公证。公开分发前应设置 MAC_SIGN_IDENTITY 使用自己的 Developer ID 签名,并通过 Apple 的 notarization 流程公证和装订票据。CI 的 ZIP 同样是未公证的测试构建。

Windows 客户端

需要 Node.js 22.12+ 和 pnpm 10.8.1。在 Windows 上执行:

corepack enable
pnpm install --frozen-lockfile
pnpm exec install-electron
pnpm start

构建 x64 与 ARM64 安装程序:

pnpm dist:win

输出位于 dist/windows/,包含架构标记的 NSIS 安装程序。Windows 签名证书未配置时构建产物未签名;公开发行时请配置自己的代码签名证书。

pnpm start 始终运行 Electron 客户端。在 Mac 上运行此命令仅用于 Windows 界面开发预览,不提供 macOS 自动粘贴;Mac 用户请构建原生客户端。

数据、备份与迁移

平台 默认目录
macOS ~/Library/Application Support/quickpaste/
Windows %APPDATA%\quickpaste\

也可以从偏好设置打开实际数据目录。

  • snippets.json:当前数据。
  • snippets.json.bak:上一次成功写入前的内容;每次修改都会更新,不是完整版本历史。
  • store.json:旧版数据。仅在没有 snippets.json 时迁移,原文件不删除。
  • 导入采用追加方式;重复 ID 会重新分配,重复导入同一备份会产生额外片段。
  • 文件损坏时停止写入并保留原文件。恢复前退出应用,备份当前目录,再把可信备份复制为 snippets.json 后启动。
  • 旧版目录名称若不同,可直接在应用中导入原来的 store.json。

导出的 JSON 是未加密的纯文本。应用不会上传数据,也不提供云同步或加密保险库;请妥善保存包含敏感信息的备份。使用片段会替换当前剪贴板内容,不会在粘贴后恢复旧剪贴板。

格式示例(完整可导入样例见 shared/example.json):

{
  "version": 2,
  "items": [{
    "id": "a-unique-id",
    "title": "简短回复",
    "content": "收到,谢谢!",
    "group": "日常沟通",
    "favorite": true,
    "createdAt": 1735689600000,
    "updatedAt": 1735689600000
  }]
}

时间字段为 Unix 毫秒整数。标题上限 120、分组上限 40、内容上限 1,000,000 个 UTF-16 代码单元;最多 10,000 个片段,JSON 文件最大 20 MB。建议在导入大批量内容前保留导出备份。

开发与验证

pnpm check             # JavaScript 语法检查
pnpm test              # 数据层测试
pnpm test:ui           # 启动 Electron,使用临时数据完成界面测试
swift test --package-path macos  # 原生数据测试,需要完整 Xcode

test:ui 覆盖浮层尺寸与搜索、管理界面 CRUD、收藏、键盘选择、剪贴板、JSON 导入导出和存储;截图只使用公开示例。真实应用的焦点恢复、权限、输入法、登录启动与多显示器定位仍需在目标系统人工验证。

GitHub Actions 在 Windows 上测试并构建安装包,在 macOS 上运行 Swift 测试并构建两种架构。详见 构建工作流。

macos/
  Sources/QuickPaste/       SwiftUI 界面、AppKit 浮层、系统集成和存储
  Tests/QuickPasteTests/    原生数据测试
src/
  main.js                  Windows 应用生命周期、窗口与 IPC
  preload.js               受限界面 API
  platform/                Windows 原生操作桥接
  renderer/                快捷浮层与管理界面
  store/                   数据校验、迁移和原子写入
shared/example.json        两端共用的可导入示例
scripts/                   构建、图标与界面测试

Windows 界面使用沙箱、上下文隔离、严格 CSP 和来源校验。用户片段始终作为纯文本显示,不执行 HTML、JavaScript 或 Shell 命令。

English

QuickPaste keeps reusable text one shortcut away. Click the menu bar / tray icon to open a small nearby palette, or use the global shortcut to open it beside your pointer. Search, select, and paste back into your previous application. A separate library handles editing, groups, favorites, settings, and JSON backups.

The macOS client is native SwiftUI/AppKit; the Windows client uses Electron with a Win32 bridge. Both use the same portable JSON format. No account, telemetry, clipboard-history monitoring, or cloud service is required.

About

QuickPaste is a cross platform clipboard management tool that allows users to easily manage and access commonly used custom text fragments. It is hidden in the system taskbar and can be quickly selected and pasted by clicking on the pop-up shortcut menu.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages