# TrayClip

**Repository Path**: heyiki/TrayClip

## Basic Information

- **Project Name**: TrayClip
- **Description**: TrayClip 基于 Tauri v2 的纯本地跨平台剪贴板管理工具。支持剪贴板历史记录、分组管理、快捷面板呼出、自定义快捷键、亮暗主题切换，以及数据备份还原。所有数据仅存储在用户本机，不依赖任何线上服务，适用于 Windows、macOS 和 Linux
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://github.com/Heyiki/TrayClip
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-07
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 剪贴板, 本地化, 工具, 免费, 翻译

## README

# TrayClip

<div align="center">
  <img src="public/logo.png" alt="TrayClip" width="128" />
</div>

<p align="center">
  TrayClip 是一款纯本地剪贴板工具，专注于历史记录、分组、置顶、快捷键和快捷面板，不依赖任何线上接口。
</p>

---

<div align="center">

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

</div>

<div align="center">
  <img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-blue.svg" />
  <img alt="React 19" src="https://img.shields.io/badge/React-19-61dafb.svg?logo=react" />
  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5.6-3178c6.svg?logo=typescript" />
  <img alt="Rust" src="https://img.shields.io/badge/Rust-1.75-9978c6.svg?logo=rust" />
  <img alt="Tauri" src="https://img.shields.io/badge/Tauri-2.0-3018c6.svg?logo=tauri" />
</div>

---

## 示例
<div>
  <img src="example/light-theme.png" alt="TrayClip" width="128" />
  <img src="example/dark-theme.png" alt="TrayClip" width="128" />
  <img src="example/translate.png" alt="TrayClip" width="128" />
  <img src="example/ai-keyword.png" alt="TrayClip" width="128" />
  <img src="example/ai-keyword-result.png" alt="TrayClip" width="128" />
</div>

## 软件下载
[TrayClip下载](https://github.com/Heyiki/TrayClip/releases)

## 特性

- 纯本地存储，数据保留在用户本机，不依赖云端服务
- 剪贴板历史记录，支持纯文本、富文本、图片和文件路径
- 分组管理、置顶、按历史条数自动清理
- 快捷面板：独立浮窗，支持快捷键呼出、搜索和快速复制
- 主窗口、快捷面板、关于页、设置页、帮助文档都可独立使用
- 亮色 / 暗色主题切换，支持界面语言切换
- 托盘常驻，窗口关闭时可隐藏到托盘或直接退出
- 支持数据备份和恢复，便于迁移或重装
- 支持 Windows / macOS / Linux

## 设置项

- 历史记录保留条数：50 到 10000
- 暂停采集剪贴板
- 快捷粘贴（Windows）
- 链接提示
- 开机自动启动
- 关闭窗口行为：隐藏到托盘 / 直接退出 / 每次询问
- 快捷面板呼出位置：屏幕中间 / 跟随鼠标
- AI 增强：API 地址、API Key、模型名称、AI 翻译
- 快捷键：主窗口和快捷面板可自定义

## 快捷键

| 功能 | Windows / Linux | macOS |
| --- | --- | --- |
| 打开主窗口 | `Ctrl+Shift+Space` | `⌃+⇧+P` |
| 打开快捷面板 | `Ctrl+Shift+V` | `⌃+P` |

快捷键可以在设置页中重新录入。

## 开发环境

- Node.js 22+
- Rust 1.75+
- npm 10+

## 启动

```bash
npm install
npm run tauri:dev
```

## 构建

```bash
npm run build
npm run tauri:build
```

## 目录

- `src/` 前端界面（React + TypeScript）
- `src-tauri/` 桌面端后端（Rust + Tauri v2）

## 开源协议

[MIT](LICENSE)