KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

zsclip

★ 194 Open GitHub ↗

面向系统ui 的轻量级 Rust 剪贴板管理器

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 剪贴板 / ZSClip

面向本地办公场景的 Windows 剪贴板增强工具。

把复制记录、常用短语、分组管理、VV 快速粘贴、文件拖出、图片贴图、超级邮件合并放进一个轻量窗口里。

[![Version](https://img.shields.io/github/v/release/qiu7824/zsclip?label=version)](https://github.com/qiu7824/zsclip/releases)
[![License](https://img.shields.io/github/license/qiu7824/zsclip)](https://raw.githubusercontent.com/qiu7824/zsclip/main/LICENSE)
![Platform](https://img.shields.io/badge/platform-Windows%2010%2F11-blue)
![Rust](https://img.shields.io/badge/core-Rust-orange)

**简体中文** | [English](README.en.md)

</div>

## 下载

- GitHub 发布页: <https://github.com/qiu7824/zsclip/releases/tag/0.9.9.7>
- 包管理器分发规划: [docs/package-managers.md](docs/package-managers.md)

## 项目定位

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

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

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

适合这些使用方式：

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

## 核心特性

### 剪贴板记录

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

### 内容管理

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

### 办公增强

- 快速搜索
- 悬停预览
- 图片贴图悬浮窗
- AI 清洗文本
- WPS 任务窗格 MVP：在 WPS 侧边栏搜索本地文本记录并插入当前文档，说明见 [docs/wps-taskpane.md](docs/wps-taskpane.md)
- 多端同步入口：WebDAV 与局域网二选一，局域网支持扫码绑定设备
- 局域网剪贴板同步（默认关闭，信任设备后自动双向同步）
- 多端同步设计文档：[docs/multi-sync.md](docs/multi-sync.md)
- 贴边自动隐藏
- 文本、图片、文件支持拖出生成文件
- 图片记录支持列表内缩略图预览

### VV 模式

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

### 超级邮件合并

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

### 系统集成

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

### 多端同步 / 局域网同步

- `设置 -> 多端同步` 通过 `同步方案` 在 `关闭 / WebDAV / 局域网` 之间单选；WebDAV 与局域网不会同时开启
- WebDAV 同步会先读取云端 `zsSyncClipboard.json`，把新的文本或图片清单导入本地记录；图片按 `dataName` 从云端 `file/` 目录下载
- Android 客户端可按当前选择的同步方案手动检查、拉取最新文本、用选中文本菜单/通知栏快捷开关推送文本，并在 App 内查看图片和文件历史；WebDAV 方案写入云端 `zsSyncClipboard.json`，局域网方案直连已配对 Windows
- 局域网传输默认关闭，并作为多端同步里的一个可选方案；选择局域网后才启动 UDP 发现和 TCP API，关闭或选择 WebDAV 后释放后台线程与 socket
- 开启后才启动 UDP 发现和 TCP API，关闭后释放后台线程与 socket
- Windows 多设备可自动发现，也可手动输入 IP 配对
- 配对在 `设置 -> 多端同步` 内完成：发现设备后点配对，另一端在同一个列表选中 `[待允许]` 后点允许
- `设置 -> 多端同步 -> 打开扫码绑定页` 会生成 Android 配对二维码和 iOS/浏览器入口二维码
- 文本、小于 10MB 的图片和小文件可自动同步；远端内容可选择只进入记录或直接覆盖系统剪贴板
- iOS 快捷指令和 Android 最小客户端说明见 `docs/lan-sync.md` 与 `docs/ios-shortcuts.md`

### 多语言

- 自动识别系统 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 开发环境中执行。

开发运行：

```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: <https://github.com/qiu7824/zsclip/>

## 赞赏支持

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

![赞赏支持](https://raw.githubusercontent.com/qiu7824/zsclip/main/docs/images/donate.png)

## 许可证

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

zsclip

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README