100 lines
3.3 KiB
Markdown
100 lines
3.3 KiB
Markdown
# 剪贴板
|
||
|
||
基于 Electron 的轻量剪贴板管理器，灵感来自 [Ditto](https://github.com/sabrogden/Ditto)。
|
||
|
||
## 快速开始
|
||
|
||
环境要求：Windows 10 / 11 · Node.js ≥ 18
|
||
|
||
```bash
|
||
npm install
|
||
npm start
|
||
```
|
||
|
||
启动后程序常驻系统托盘。复制任意文本或图片即自动记录；单击托盘图标唤出窗口，选中条目后双击或按回车写入系统剪贴板，再切到目标窗口 `Ctrl+V` 粘贴。
|
||
|
||
如安装时 `better-sqlite3` 编译失败，可安装 [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/) 后执行 `npm run rebuild`。
|
||
|
||
## 功能
|
||
|
||
- **自动记录**：默认每秒轮询系统剪贴板，文本和图片都自动入库
|
||
- **收藏**：独立 Tab 永久存放，源记录被删除后仍可复制，上限 1000 条
|
||
- **搜索**：实时过滤文本，支持中文子串
|
||
- **置顶**：点过「复制」的项自动置顶，避免被自动清理或「清空历史」误删
|
||
- **全局唤起**：默认 `Ctrl+Alt+V`，设置里可改或禁用
|
||
- **主题**：6 套主题 + 5 种强调色，支持跟随系统
|
||
- **开机自启动**、单实例、窗口置顶切换
|
||
|
||
## 快捷键
|
||
|
||
全局：默认 `Ctrl+Alt+V` 唤起或隐藏历史窗口（设置中可更改或禁用）。
|
||
|
||
主窗口内：
|
||
|
||
| 快捷键 | 行为 |
|
||
| --- | --- |
|
||
| `↑` `↓` | 上下选择 |
|
||
| `PageUp` `PageDown` | 翻页 |
|
||
| `Home` `End` | 跳到首项或末项 |
|
||
| `Enter` | 复制当前选中项 |
|
||
| `1` ~ `9` | 直接复制对应项 |
|
||
| `Ctrl+L` | 聚焦搜索框 |
|
||
| `F5` | 刷新列表 |
|
||
| `Esc` | 清空搜索或隐藏窗口 |
|
||
| `F12` | 开发者工具 |
|
||
|
||
设置窗口：`←` / `→` 切换标签页，`Esc` 关闭。
|
||
|
||
## 数据存储
|
||
|
||
默认存放在 `D:\Clipboard Data`，独立于项目目录：
|
||
|
||
```
|
||
D:\Clipboard Data\
|
||
├── config.json
|
||
├── history.db
|
||
└── favorites.db
|
||
```
|
||
|
||
- D 盘不可用时自动降级到 `%USERPROFILE%\Clipboard Data`
|
||
- 设置 → 「更改…」可迁到其他位置；「打开文件夹」直达目录
|
||
- 启动前设 `CLIPBOARD_APP_DATA_DIR=D:\some\dir` 可临时覆盖
|
||
- 首次启动会自动从 `%USERPROFILE%\.clipboard-app` 迁移历史数据
|
||
|
||
## 开发
|
||
|
||
```bash
|
||
npm test # 单元测试（自动发现 test/*.test.js）
|
||
npm run test:ui # UI 测试（需 Electron 窗口）
|
||
npm run test:all # 上面两套一起跑
|
||
npm run rebuild # 重新编译 better-sqlite3 到当前 Electron ABI
|
||
npm run build # 打包为 NSIS 安装包
|
||
npm run build:dir # 仅生成解压目录
|
||
```
|
||
|
||
测试由 `test/run.js` 自动发现，新增用例放入 `test/<name>.test.js` 即可。
|
||
|
||
## 常见问题
|
||
|
||
**点选条目后没有自动粘贴**
|
||
设计如此：只写入系统剪贴板，需手动 `Ctrl+V`。避免隐藏窗口导致的焦点闪烁。
|
||
|
||
**全局快捷键无效**
|
||
组合键被其他程序占用。在设置中更换档位，或释放占用方后重启。
|
||
|
||
**看不到托盘图标**
|
||
Windows 11 默认折叠托盘图标，需在「设置 → 系统 → 通知」中开启。
|
||
|
||
**数据库占用或损坏**
|
||
可直接删除 `D:\Clipboard Data` 下的 db 文件，重启后自动重建（配置和收藏数据除外）。
|
||
|
||
## 已知限制
|
||
|
||
- 不自动粘贴，必须手动 `Ctrl+V`
|
||
- 收藏上限 1000 条
|
||
|
||
## 致谢
|
||
|
||
- 灵感来自 [Ditto](https://github.com/sabrogden/Ditto)
|
||
- 开发者：[关济寰](https://www.guanjihuan.com/about)
|