WinPaste

---

✨ 功能特性

轻量模式（仅记录）。 托盘一键切换：关闭并释放主界面与 WebView，进程以零窗口在后台持续记录剪贴板；需要时随时恢复面板。

极速搜索。 按 Ctrl+F 或 / 聚焦搜索框。支持按内容、类型、标签筛选。输入即搜，零延迟。

智能光标追踪。 通过 Windows UIAutomation 接口精准获取光标位置，即使在 Chrome、VS Code、Electron 等传统 API 失效的自绘引擎应用中也准确定位。面板始终出现在你需要的地方。

多格式捕获。 纯文本、富文本 HTML、图片、文件路径、GIF 动图——全部捕获并标注来源应用。图片直接持久化入库，缩略图异步加载，再多图片也流畅不卡；复制文件条目后可直接在记事本、终端等纯文本窗口粘贴为路径列表。

失效条目管理。 源文件被移动或删除的图片、文件记录会自动标记「已删除或移动」，不再显示破图；清理历史时可一键「清除全部」或仅清除已失效的记录。

隐私保护。 自动检测并脱敏手机号、身份证、邮箱和密码。支持自定义正则规则。敏感数据 AES 加密存储。

全键盘操作。 方向键导航，回车 粘贴，Ctrl+Shift+0-9 快速粘贴最近 10 条——无需鼠标。

顺序粘贴模式。 多条内容加入队列，一键逐条粘贴。适合填表、批量结构化数据场景。

置顶与贴图。 常用条目一键置顶。可将任意内容独立悬浮，切换应用时始终可见。

Fluent Design 主题。 深色、浅色或跟随系统。Windows 11 Mica 毛玻璃、Win10 亚克力效果。字体大小、紧凑模式、边框均可自定义。

多语言。 简体中文 · English · 繁體中文

🎯 使用方式

1. 复制 — WinPaste 在后台静默记录每次剪贴板变化。
2. 呼出 — 按 Win+V（或自定义快捷键），面板跟随光标弹出，不抢焦点。
3. 粘贴 — 方向键导航，输入即搜，回车 粘贴。

📦 安装

从 Releases 下载最新版本：

需要 Windows 10 或 11，x64。安装包支持按当前用户或所有用户安装。

🛠 开发

# 前置：Node.js 20.19+（或 22.12+）、Rust、Tauri CLI

npm install
npm run tauri:dev      # 开发模式，热重载 (Vite 端口 1422)
npm run tauri:build    # 一键构建：安装版 + 单文件版
npm run build:installer # 仅构建 NSIS 安装包
npm run build:portable # 仅构建便携单文件 exe (zip + exe)

# 一键构建产物：
# artifacts/release/WinPaste_<版本>_x64-setup.exe    安装版
# artifacts/release/WinPaste_<版本>_x64-portable.exe 单文件版

# 仅检查
npx tsc --noEmit       # TypeScript 类型检查
cargo check            # Rust 检查 (在 src-tauri/ 下)
npm run test:e2e       # Playwright e2e 测试

🏗 架构

层	技术栈
前端	React 19 + TypeScript + Vite
状态管理	Zustand（3 个 Store：history、settings、UI）
样式	Tailwind CSS + 自定义 Fluent 主题
后端	Tauri v2（Rust）
数据库	SQLite（WAL 模式）
加密	Windows DPAPI + AES
输入	WH_KEYBOARD_LL / WH_MOUSE_LL 底层钩子
光标定位	UIAutomation 接口（兼容 Chrome、VSCode、Electron）
打包	NSIS 安装包 + 便携单文件 exe

关键架构决策：

• WS_EX_NOACTIVATE 窗口样式——面板弹出不抢焦点
• SSOT 单一事实源状态机（Rust）——彻底消除竞态，不再有修饰键卡死
• 非阻塞钩子——回调即发即忘，繁重任务移交异步 Tokio Worker
• 零遥测、零注册、零冗余

📄 协议

GNU General Public License。灵感来源于 Tiez。

---