# zsclip **Repository Path**: qiu7824/zsclip ## Basic Information - **Project Name**: zsclip - **Description**: 剪贴板 / ZSClip 面向本地办公场景的 Windows 剪贴板增强工具。 把复制记录、常用短语、分组管理、VV 快速粘贴、文件拖出、图片贴图、超级邮件合并放进一个轻量窗口里。 - **Primary Language**: Rust - **License**: GPL-3.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-03-19 - **Last Updated**: 2026-03-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 剪贴板 / ZSClip > 面向本地办公场景的 Windows 剪贴板增强工具。 > 把复制记录、常用短语、分组管理、VV 快速粘贴、文件拖出、图片贴图、超级邮件合并放进一个轻量窗口里。 ## 下载 - GitHub 发布页: - 蓝奏云下载: - 下载密码: `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`：关闭搜索、清空选择或收起界面 ## 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 开发环境中执行。 开发运行： ```powershell cargo run ``` 发布构建： ```powershell 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: ## 赞赏支持 如果这个项目对你有帮助，欢迎支持我继续打磨它。 ![赞赏支持](docs/images/donate.png) ## 许可证 本项目使用 GPL-3.0 许可证，详见 `LICENSE`。