# clipnest

**Repository Path**: GitFay/clipnest

## Basic Information

- **Project Name**: clipnest
- **Description**: 历史剪切板工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-13
- **Last Updated**: 2026-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ClipNest · 跨平台历史剪切板工具

一款常驻**任务栏/菜单栏**的极简历史剪切板工具，支持 **macOS / Windows / Linux**，
通过**全局快捷键**一键唤出历史列表。键盘优先、本地优先、干净美观。

## 交付物

| 文件 | 内容 |
| --- | --- |
| [`design-spec.md`](./design-spec.md) | 完整设计文档：定位、技术选型、架构、数据模型、交互、UI 系统、功能优先级、隐私、平台适配、工程落地 |
| [`prototype/index.html`](./prototype/index.html) | **可直接打开体验**的 UI 原型（搜索 / 筛选 / 置顶 / 删除 / 键盘导航 / 复制到剪切板 / 从剪切板捕获演示） |
| [`tauri-app/`](./tauri-app/) | **可运行的 Tauri 2 跨平台工程**：托盘 + 全局快捷键 + 剪切板监听线程 + 事件下发 |

## 30 秒上手

1. **看设计**：打开 `design-spec.md`。
2. **体验 UI**：用浏览器打开 `prototype/index.html`，试试 `↑/↓` 选择、`Enter` 复制、`⌘/Ctrl+K` 搜索、点右上「+」从真实剪切板捕获一条。
3. **跑工程**：进入 `tauri-app/` 按 README 安装 Rust + Tauri CLI，把 `prototype/index.html` 作为 `dist/index.html` 嵌入即可编译三端安装包。

## 核心交互

- 快捷键 `⌘/Ctrl + Shift + V` 唤出 / 隐藏悬浮面板
- `↑ / ↓` 选择，`Enter` 复制，`⌫` 删除，`Esc` 隐藏
- 面板失焦自动隐藏（"唤出即搜、松手即隐"）

## 技术栈

- **Tauri 2**（Rust + 系统 WebView）：安装包 < 15MB、内存占用低、原生托盘与全局快捷键
- 前端：原生 HTML/CSS/JS（零运行时依赖），毛玻璃面板、键盘优先、深色为主附浅色
- 剪切板：`arboard` 跨平台读取，后台线程轮询去重，经 IPC 推给前端