剪贴板 / ZSClip

面向本地办公场景的 Windows 剪贴板增强工具。
把复制记录、常用短语、分组管理、VV 快速粘贴、文件拖出、图片贴图、超级邮件合并放进一个轻量窗口里。

下载

• GitHub 发布页: https://github.com/qiu7824/zsclip/releases/tag/0.8.4
• 蓝奏云下载: https://tcnzy.lanzout.com/b01887awxg
• 下载密码: 7dvb

项目定位

剪贴板 不只是“复制历史列表”。

它更像一个常驻的本地办公工具箱，重点解决这些高频动作：

• 文本、图片、文件的统一记录和快速回用
• 常用短语和模板内容的集中管理
• 分组整理与按场景切换
• 在输入框里直接触发的 VV 快速粘贴
• 文本、图片、文件拖出生成真实文件
• Excel + Word 场景下的超级邮件合并

适合这些使用方式：

• 日常聊天、客服、运营回复
• 反复整理文案、截图、文件素材
• 项目资料、客户资料分类管理
• 需要把图片、文本从列表直接拖到桌面或目标软件
• 需要从 Excel 批量向 Word 插字段或填表

核心特性

剪贴板记录

• 自动监听系统剪贴板
• 支持文本、图片、文件
• 主窗口区分 复制记录 和 常用短语
• 热键默认弹出 快速窗口，尽量不打断当前输入
• 托盘或普通打开进入完整主窗口
• 点击条目可按设置执行复制、粘贴或复制后粘贴
• 文件条目粘贴走 Windows 原生文件剪贴板，不是路径文本

内容管理

• 置顶
• 分组管理
• 分组筛选
• 常用短语独立管理
• 文本搜索与时间搜索
• SQLite 本地持久化

办公增强

• 快速搜索
• 悬停预览
• 图片贴图悬浮窗
• AI 清洗文本
• WebDAV 云同步
• 贴边自动隐藏
• 文本、图片、文件支持拖出生成文件
• 图片记录支持列表内缩略图预览

VV 模式

• 在设置里可单独开启 VV 模式
• 在输入状态下输入 vv，会在输入法候选区域附近弹出候选窗
• 再输入 1-9 可直接粘贴对应记录
• 支持设置 VV 来源 为 复制记录 或 常用短语
• 支持设置 VV 默认分组
• 弹窗内可继续切换分组

超级邮件合并

• 读取 Excel 文件
• 识别工作表、表头和数据行
• 向 Word 插入 MERGEFIELD
• 支持邮件合并模式和填表模式

系统集成

• 托盘常驻
• 开机自启
• 全局热键
• Win32 原生轻量窗口
• 多显示器与不同缩放环境适配

多语言

• 自动识别系统 UI 语言
• 当前内置中文、英文
• 翻译文件集中放在 locales/
• 新增语言时可直接参考 locales/en.json 复制出新的 <语言代码>.json

数据加载模型

当前版本已经不是旧的“整类数据一次性全读入内存”模式。

现在主列表使用的是更适合 Rust 的新方案：

• 分页加载
• 虚拟列表绘制
• 后台线程继续加载下一页
• 完整正文、文件路径、图片数据按需补全
• 小型缓存避免反复查库

这样做的目的：

• 数据量变大时，主界面不会一次性把所有记录都吃进内存
• 滚动只处理当前可见区域
• 搜索、分组、Tab 切换直接按查询条件重新分页

使用方式

1. 运行 zsclip.exe
2. 在任意软件里复制文本、图片或文件
3. 使用默认热键 Win + V 打开快速窗口
4. 点击列表项执行粘贴，或右键使用更多命令
5. 需要搜索、设置、批量整理时，可通过托盘或界面入口进入完整主窗口
6. 需要固定内容时可以移入 常用短语
7. 如果当前条目是 Excel 文件，可直接打开 超级邮件合并

常用快捷键

• Win + V：显示或隐藏快速窗口
• Ctrl + F：打开或关闭搜索
• Ctrl + C：复制当前项
• Ctrl + P：置顶或取消置顶当前项
• Delete：删除当前项
• Esc：关闭搜索、清空选择或收起界面

搜索说明

搜索框默认不显示提示文字，常用写法如下：

• 普通关键词：合同
• 日期搜索：日期:2026-3-26
• 时间搜索：时间:2026-3-26
• 应用搜索：应用:Word
• 带空格的应用名：应用:"Visual Studio Code"
• 组合搜索：日期:2026-3-26 应用:Word 合同

VV 模式说明

VV 模式适合“边输入边调用内容”的场景。

基本流程：

1. 在设置里开启 VV 模式
2. 选择 VV 来源
3. 可选设置 VV 默认分组
4. 在输入框中输入 vv
5. 候选窗出现后输入 1-9
6. 对应内容会直接粘贴到当前输入位置

补充说明：

• Esc 可取消候选
• 候选窗支持分组切换
• 适合 Word、微信、记事本、浏览器输入栏等场景

超级邮件合并说明

这是项目里非常适合办公场景的一块能力，重点面向 Word 模板填充和批量文档处理。

典型流程：

1. 选择 Excel 文件
2. 读取工作表、表头和数据行
3. 在 Word 中插入字段或填入当前行数据
4. 用于邮件合并模板或普通表单填充

说明：

• 依赖本机 Windows、Excel、Word 环境
• 当前实现优先面向本机 Office 自动化场景

数据目录

程序优先使用 exe 同级目录下的 data 文件夹。
如果安装在 C:\Program Files 等不可写目录，会自动回退到 %LOCALAPPDATA%\ZSClip\data。

常见文件：

• 配置文件：data/settings.json
• 数据库：data/clipboard.db
• 图片目录：data/images/
• 导出目录：data/exports/

如果使用的是程序同级 data，复制整个目录即可迁移配置和历史记录。

构建

建议在 Developer PowerShell for VS 2022 或等价的 MSVC 开发环境中执行。

开发运行：

cargo run

发布构建：

cargo build --release

项目结构

项目正在按“后续方便移植”的方向整理，主入口逐步收口到这几层：

• src/ui.rs：共享 UI 模型、主题、布局与列表逻辑
• src/win_system_ui.rs：Win32 窗口、绘制宿主、拖拽、原生交互适配
• src/win_system_params.rs：Win32 常量、控件 ID、平台参数
• src/app.rs：应用状态、业务流程、数据加载、命令分发
• locales/：界面翻译文件目录

当前 0.5.x 还额外做了两种窗口宿主：

• 完整主窗口：负责搜索、设置、编辑、分组、拖拽等完整能力
• 快速窗口：由热键弹出，优先服务快速粘贴和输入中场景

目标不是简单换一个壳，而是把：

• UI 逻辑
• Win32 平台逻辑
• 数据与业务流程

逐步拆清楚，方便后续继续演进或迁移。

开源地址

• GitHub: https://github.com/qiu7824/zsclip/

赞赏支持

如果这个项目对你有帮助，欢迎支持我继续打磨它。

许可证

本项目使用 GPL-3.0 许可证，详见 LICENSE。