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

5.0 KiB Raw Permalink Blame History Unescape Escape