# shearTool

**Repository Path**: chenlin2436/shear-tool

## Basic Information

- **Project Name**: shearTool
- **Description**: 剪切板工具
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-08
- **Last Updated**: 2026-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ShearTool

ShearTool 是一个基于 **Tauri + Vue 3 + Rust + SQLite** 的 Windows 桌面剪贴板工具，用于本地记录、检索和管理剪贴板历史。

## 项目简介

这个项目主要解决桌面端剪贴板内容不易追溯、文件复制不稳定、图片历史难管理的问题，当前支持文本、图片、文件、视频等内容的本地持久化管理。

## 界面预览

### 主界面

![ShearTool 主界面](docs/screenshots/main-view.png)

### 设置页

![ShearTool 设置页](docs/screenshots/settings-view.png)

## 功能特性

- 监听系统剪贴板变化并自动入库
- 保存文本、图片、文件、视频等历史记录
- 支持搜索、分类筛选、固定置顶、单条删除、清空未固定内容
- 支持点击历史记录快速复制回系统剪贴板
- 支持全局快捷键唤起或隐藏窗口
- 支持自定义存储目录、容量限制、窗口尺寸
- 针对 Windows 文件复制与截图场景提供 PowerShell 兼容兜底

## 技术栈

- 前端：Vue 3、Vue Router、Vite、Tailwind CSS
- 桌面端：Tauri 2
- 后端：Rust、rusqlite、clipboard-master、arboard
- 数据存储：SQLite

## 运行环境

- Windows 10 / Windows 11
- Node.js 18+
- Rust 工具链
- Microsoft WebView2 Runtime

## 项目结构

```text
.
├─ docs/screenshots/    # README 使用的界面截图
├─ src/                 # 前端页面与路由
├─ src-tauri/           # Tauri 与 Rust 后端
├─ work/                # 运行时数据目录（已忽略）
└─ README.md
```

## 开发运行

### 1. 安装前端依赖

```bash
npm install
```

### 2. 启动桌面应用开发环境

```bash
npm run tauri
```

### 3. 仅启动前端开发服务

```bash
npm run dev
```

### 4. 构建前端资源

```bash
npm run build
```

## 使用说明

1. 启动应用后，程序会在后台监听系统剪贴板。
2. 复制文本、图片、文件或视频后，内容会自动出现在主界面。
3. 点击某条历史记录可再次复制该内容。
4. 可通过顶部分类与搜索框快速定位需要的历史内容。
5. 可将重要内容固定，固定项不会被“清空全部”删除。
6. 可在设置页中修改快捷键、存储路径、容量限制和窗口尺寸。

## 数据说明

应用运行后会在项目根目录下生成 `work/` 目录，用于保存：

- `work/clipboard.db`：剪贴板历史数据库
- `work/images/`：图片缓存与拷贝文件

这些运行时文件不会提交到 Git。

## Git 忽略说明

当前仓库已忽略以下本地或构建产物：

- `node_modules/`
- `dist/`
- `src-tauri/target/`
- `src-tauri/gen/`
- `work/`
- `.idea/`
- `.claude/`
- `memory/`
- `config/`
- `index/`
- `src/views/*_script_only.vue`

## 说明

当前实现重点面向 Windows 桌面场景，部分剪贴板兼容逻辑依赖 PowerShell。