点击菜单栏/系统托盘图标,QuickPaste 就在图标附近展开。按下全局快捷键,浮层会出现在鼠标附近,并自动避开屏幕边缘。输入几个字,点击片段或按回车,把内容粘贴回刚才的应用。点外部或按 Esc 即可收起。
日常使用只需要这个轻量浮层。编辑、分组、备份和设置放在独立的「管理片段」界面。
左:macOS 原生浮层 · 右:Windows 客户端浮层(在 Mac 上运行 Electron 截图)
- 快捷浮层:就近展开、即时搜索、方向键选择、回车粘贴、失焦收起。
- 常用文本片段:保存回复、代码、地址、模板等纯文本;支持中文、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 桥接脚本实现,片段文本只写入剪贴板,不拼接到脚本或命令中。
- 启动 QuickPaste,在菜单栏/托盘找到图标。
- 点击浮层右下角的「管理片段」,创建第一个片段。
- 回到要输入内容的应用,把光标放进输入框。
- 点击图标或按全局快捷键,搜索片段,点击或按
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 或发布附件。
需要 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 同样是未公证的测试构建。
需要 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 # 原生数据测试,需要完整 Xcodetest: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 命令。
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.



