update

README.md

@@ -0,0 +1,117 @@
+# Quick Paste
+
+桌面悬浮的剪贴板工具：按分组管理常用句子，点一下就粘贴到当前正在输入的窗口。
+
+写代码、做客服、写文案时总有几句话要重复敲——问候、结束语、固定回复、常用代码片段。把它做成常驻桌面的悬浮窗，分组整理好，一键贴到任意正在输入的窗口。
+
+- 不抢焦点，点完继续干活
+- 不挑场景，浏览器、记事本、Office、微信、QQ、IDE 都能用
+
+## 快速开始
+
+需要 Node.js 18+。
+
+```bash
+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，应用照常运行——改用托盘图标唤出即可。要换快捷键改 `main.js` 的 `GLOBAL_TOGGLE_SHORTCUT`。
+
+**拖到副屏的窗口下次启动不见了？**
+不会丢。启动时会按窗口中心点找最近的显示器，把窗口整体夹回该显示器的工作区；副屏拔掉 / 分辨率改了也能正常恢复。
+
+**怎么完全退出？**
+关闭按钮只隐藏到托盘。真正退出请右键托盘图标 → 退出。
+
+## 项目结构
+
+```
+.
+├── 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