Quick Paste
桌面悬浮的剪贴板工具：按分组管理常用句子，点一下就粘贴到当前正在输入的窗口。
写代码、做客服、写文案时总有几句话要重复敲——问候、结束语、固定回复、常用代码片段。把它做成常驻桌面的悬浮窗，分组整理好，一键贴到任意正在输入的窗口。
- 不抢焦点，点完继续干活
- 不挑场景，浏览器、记事本、Office、微信、QQ、IDE 都能用
快速开始
需要 Node.js 18+。
npm install
npm start # 启动
npm run dist # 打包 NSIS 安装包到 dist/
npm start 走的是 scripts/start.js 而不是直接 electron：Git Bash 等终端会把 ELECTRON_RUN_AS_NODE=1 注入子进程，让 Electron 退化成普通 Node.js 卡住。启动脚本会先清掉这个变量再 spawn。
主要功能
- 悬浮窗无边框、可拖拽；标题栏一键切换「始终置顶」
- 分组管理：右键重命名 / 删除 / 清空，分组与短语都可拖动重排，把短语拖到左侧分组即可换组
- 一键粘贴：点击 → 写剪贴板 → 自动 Ctrl+V
- 收藏 / 最近 / 使用计数；「最近」列表与使用计数都能在设置面板一键清空
- 实时模糊搜索，命中片段高亮
- 占位符：
{date}{time}{datetime}{weekday}{clipboard}，编辑时实时预览；\{xxx}反斜杠保留字面量 - 明暗主题、窗口透明度（60–100%）、粘贴时是否隐藏悬浮窗
- 侧栏可折叠（
Ctrl+B） - JSON 导入导出：整库替换 或按 ID 合并
- 单实例锁
快捷键
弹窗打开时只响应 Esc / Ctrl+Enter；焦点在输入框时只响应 Ctrl / Alt 组合键和 Esc，普通字符不会触发。
| 类别 | 快捷键 | 作用 |
|---|---|---|
| 全局 | Ctrl+Shift+V |
唤出 / 收起悬浮窗 |
| 列表 | ↑ / ↓ |
上下移动选中项 |
| 列表 | 1 ~ 9 |
粘贴当前可见顺序的前 9 条 |
| 列表 | Enter |
粘贴选中的短语 |
| 列表 | Alt+↑ / Alt+↓ |
调整顺序 |
| 过滤 | g / f / r |
切换 全部 / 收藏 / 最近 |
| 过滤 | / 或 Ctrl+F |
聚焦搜索框 |
| 过滤 | Esc |
清空搜索 / 关闭弹窗 / 隐藏窗口 |
| 操作 | Ctrl+N / Ctrl+G |
新建短语 / 新建分组 |
| 操作 | Ctrl+B |
折叠 / 展开分组栏 |
| 操作 | Ctrl+, |
打开设置 |
| 操作 | Ctrl+Enter |
保存短语编辑 |
占位符
| 标签 | 展开为 |
|---|---|
{date} |
当前日期，如 2026-09-11 |
{time} |
当前时间，如 14:32 |
{datetime} |
日期 + 时间，如 2026-09-11 14:32 |
{weekday} |
中文星期，如 周四 |
{clipboard} |
当前剪贴板内容 |
含 {clipboard} 的短语粘贴时会先快照原剪贴板再覆盖，避免读到自身写出去的内容。
想教别人用占位符时，写成 \{date} 会保留成字面量 {date}，不会被展开。
数据存储
| 系统 | 路径 |
|---|---|
| Windows | %APPDATA%\quick-paste\data.json |
| macOS | ~/Library/Application Support/quick-paste/data.json |
| Linux | ~/.config/quick-paste/data.json |
设置面板 → 数据 → 「打开」一键定位。写盘采用「先写临时文件再 rename」的原子化策略，畸形 JSON 会自动尝试修复。
常见问题
粘贴后窗口消失了？
默认不会。走「隐藏 → 粘贴 → 重新显示」兜底有三种：识别不到目标窗口、开了「粘贴时隐藏悬浮窗」、目标窗口拒绝被拉到前台。200ms 后会自动回来，嫌慢改 main.js 的 PASTE_RESTORE_DELAY_MS。
某些应用粘贴不上？ 部分 Electron / Chrome 内核应用为安全考虑忽略 SendKeys。普通应用都没问题。
Ctrl+Shift+V 不起作用？
可能被其它程序占用了。注册失败时主进程只会在终端打一行 warn，应用照常运行——改用托盘图标唤出即可。要换快捷键：设置面板 → 快捷键 → 录制。
拖到副屏的窗口下次启动不见了？ 不会丢。启动时会按窗口中心点找最近的显示器，把窗口整体夹回该显示器的工作区；副屏拔掉 / 分辨率改了也能正常恢复。
怎么完全退出？ 关闭按钮只隐藏到托盘。真正退出请右键托盘图标 → 退出。
项目结构
.
├── package.json
├── main.js # 主进程：窗口 / 托盘 / 模拟粘贴 / 单实例锁 / IPC
├── preload.js # contextBridge 暴露 window.api
├── renderer/
│ ├── index.html
│ ├── styles.css
│ └── renderer.js
├── scripts/
│ └── start.js # 清掉 ELECTRON_RUN_AS_NODE 后启动 Electron
├── icon.ico # 托盘 / 标题栏 / 安装包共用
├── .gitignore # 忽略 node_modules/ 与 dist/
└── README.md
npm run dist 会用 electron-builder 走 NSIS 打包，产物落在 dist/ 下（快速粘贴 Setup x.y.z.exe 安装包 + win-unpacked/ 免安装目录），仓库已通过 .gitignore 忽略。
许可证
MIT