https://github.com/notsleeply/clawboard
🧠 AI驱动的本地剪贴板管理器 - 智能记录、语义搜索、永久收藏
https://github.com/notsleeply/clawboard
ai clipboard electron local-first ollama open-source productivity sqlite windows
Last synced: 2 months ago
JSON representation
🧠 AI驱动的本地剪贴板管理器 - 智能记录、语义搜索、永久收藏
- Host: GitHub
- URL: https://github.com/notsleeply/clawboard
- Owner: NotSleeply
- License: mit
- Created: 2026-04-02T04:21:16.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-09T20:13:28.000Z (2 months ago)
- Last Synced: 2026-04-09T22:13:14.326Z (2 months ago)
- Topics: ai, clipboard, electron, local-first, ollama, open-source, productivity, sqlite, windows
- Language: JavaScript
- Size: 121 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 🦞 ClawBoard
> AI驱动的本地剪贴板管理器 — 智能记录、语义搜索、永久收藏
[](https://github.com/NotSleeply/ClawBoard)
[](./LICENSE)
[](https://github.com/NotSleeply/ClawBoard)
---
## ✨ 功能特点
- 🌡️ **全程监控** — 记录复制的一切：文字、代码、图片、文件路径
- 🧠 **本地 AI** — 基于 Ollama 自动分析内容、生成摘要、打标签
- 🔍 **自然语言搜索** — 用日常语言搜索剪贴板历史，例如 "上周那个 API 地址"
- 📌 **永久收藏** — 标记重要内容，永不丢失
- ⚡ **代码片段库** — 自动识别代码，高亮保存，随时取用
- 🔒 **隐私优先** — 所有数据存储在本地，同步数据端到端加密
- 🔄 **跨设备同步** — 多设备实时同步，支持离线缓存
- ⚡ **快速响应** — 即开即用，内存占用极低
---
## 🚀 快速开始
### 环境要求
- **Windows** 10/11
- [Node.js](https://nodejs.org/) 18+
- [Ollama](https://ollama.com/)（可选，用于 AI 摘要功能）
### 安装
```bash
# 克隆仓库
git clone https://github.com/NotSleeply/ClawBoard.git
cd ClawBoard
# 安装依赖
npm install
# 运行
npm start
```
### Ollama 配置（可选）
```bash
# 安装 Ollama
# 下载地址: https://ollama.com/download
# 拉取模型
ollama pull nomic-embed-text
ollama pull qwen2.5:3b
```
---
## 🗂️ 项目结构
```
ClawBoard/
├── src/
│ ├── main.js # Electron 主进程
│ ├── preload.js # 预加载脚本（安全桥接）
│ ├── clipboard.js # 剪贴板监控核心
│ ├── database.js # SQLite 数据库
│ ├── ai.js # Ollama AI 集成
│ ├── ocr.js # Tesseract.js OCR 服务 (v0.17.0)
│ ├── sync.js # 跨设备同步服务 (v0.18.0)
│ └── renderer/
│ ├── index.html # 主界面
│ ├── styles.css # 样式
│ └── app.js # 渲染进程逻辑
├── assets/ # 图标等资源
├── docs/ # 文档
├── package.json
├── README.md
└── LICENSE
```
---
## 🛠️ 技术栈
| 层级 | 技术 |
|------|------|
| 框架 | Electron |
| 数据库 | SQLite (better-sqlite3) |
| AI | Ollama (本地 LLM) |
| 前端 | 原生 HTML/CSS/JS |
| 构建 | electron-builder |
---
## 📝 更新日志
### v0.34.0 (2026-04-15)
- ✅ **批量导出 JSON** - 完整备份（标签、备注、加密状态等）
- ✅ **批量导出 CSV** - 文本内容，适合数据分析
- ✅ **从备份恢复** - 支持合并或替换模式
### v0.33.0 (2026-04-15) (2026-04-15)
- ✅ **快捷键模板系统** - 为常用内容绑定全局快捷键 Ctrl+Shift+1~9，一键粘贴
- ✅ **模板变量支持** - `{{date}}` `{{time}}` `{{datetime}}` `{{clipboard}}` 动态渲染
- ✅ **快捷键管理面板** - 设置页「⚡ 快捷模板」标签页，可视化管理 9 个槽位
- ✅ **持久化绑定** - 快捷键配置存储到 SQLite，重启后自动恢复
- ✅ **触发反馈** - 快捷键触发时显示 Toast 通知，确认内容已写入剪贴板
### v0.31.0 (2026-04-14)
- ✅ **智能粘贴** - 支持多种粘贴格式转换（纯文本、Markdown、代码块、大小写转换等）
- ✅ **URL 清理** - 自动移除跟踪参数（utm_source、fbclid 等）
- ✅ **JSON 格式化** - 粘贴时自动美化 JSON
- ✅ **手机号脱敏** - 自动隐藏手机号中间四位
- ✅ **忽略规则** - 按来源应用忽略（密码管理器等）
- ✅ **内容过滤** - 按正则表达式、长度限制过滤
- ✅ **敏感信息检测** - 自动检测信用卡号、身份证号、API 密钥
### v0.29.0 (2026-04-13)
- ✅ **剪贴板捕获通知** - 复制内容时显示系统通知（可开关）
- ✅ **声音反馈** - 捕获内容时播放提示音
- ✅ **通知内容预览** - 可选择是否在通知中显示内容预览
- ✅ **大文本过滤** - 超过设定阈值的内容不显示通知，避免打扰
- ✅ **点击通知跳转** - 点击通知可快速打开主窗口
### v0.31.1 (2026-04-14)
- ✅ **自动过期清理** - 按天自动删除过期剪贴板记录
- ✅ **数据管理面板** - 配置保留天数、收藏例外
- ✅ **过期统计** - 查看可清理条目数量
- ✅ **手动清理** - 一键清理过期条目
### v0.30.0 (2026-04-13)
- ✅ **剪贴板条目备注** - 为每条记录添加自定义备注
- ✅ **内联编辑** - 点击图标快速编辑备注
- ✅ **详情面板备注** - 底部备注输入区
- ✅ **备注搜索** - 搜索时同时匹配备注内容
### v0.28.0 (2026-04-11)
- ✅ **云端同步** - WebDAV 协议支持（NextCloud、坚果云等）
- ✅ **端到端加密** - AES-256-GCM 加密数据后再上传
- ✅ **同步状态指示** - 显示配置状态和上次同步时间
- ✅ **手动同步** - 支持手动上传/下载同步
- ✅ **仅同步收藏** - 可设置仅同步置顶的剪贴板记录
### v0.27.0 (2026-04-11)
- ✅ **置顶项目管理面板** - 独立管理所有收藏的剪贴板内容
- ✅ **统计概览** - 显示置顶总数、本周新增、已标签数量
- ✅ **搜索筛选** - 支持关键词搜索和类型/标签筛选
- ✅ **批量操作** - 支持批量取消置顶、批量删除
### v0.26.0 (2026-04-10)
- ✅ **运行时健康监控** - 实时显示系统资源使用（记录数、数据库大小、配置信息）
- ✅ **运行状态面板** - 点击标题栏 💓 按钮查看详细运行状态
- ✅ **数据库大小显示** - 显示数据库文件大小和路径
### v0.25.0 (2026-04-09)
- ✅ **统计报告导出** - 导出完整统计数据为 JSON/CSV
- ✅ **记录导出** - 导出剪贴板历史记录（JSON/CSV）
- ✅ **筛选导出** - 按类型、收藏状态筛选导出
- ✅ **导出入口** - 统计面板添加导出按钮
### v0.24.0 (2026-04-09)
- ✅ **分组管理** - 创建、编辑、删除自定义分组
- ✅ **拖拽排序** - 拖拽调整记录顺序
- ✅ **移动到分组** - 拖拽记录到分组侧边栏
- ✅ **分组图标颜色** - 自定义分组图标和颜色
- ✅ **批量移动** - 批量选择记录并移动到分组
### v0.23.0 (2026-04-08)
- ✅ **内容合并** - 多选合并多条记录，支持自定义分隔符
- ✅ **标签继承** - 合并后自动继承所有原始记录标签
- ✅ **合并标识** - 合并记录显示特殊标识，便于识别
### v0.22.0 (2026-04-07)
- ✅ **智能去重** - 扫描重复内容并一键清理
- ✅ **相似度检测** - 基于编辑距离计算文本相似度
- ✅ **重复清理** - 保留最新记录，保护收藏和锁定
### v0.21.0 (2026-04-07)
- ✅ **标签系统** - 🏷️标签按钮打开管理面板
- ✅ **标签管理** - 添加/删除标签，点击筛选
- ✅ **标签筛选** - 按标签快速筛选记录
- ✅ **记录标签** - 卡片显示标签徽章
### v0.20.0 (2026-04-07)
- ✅ **来源追踪（数据层）** - 数据库支持来源应用字段
- ✅ **来源筛选** - 按来源应用筛选剪贴板记录
- ✅ **来源列表** - 获取 Top 20 来源应用及记录数
### v0.19.0 (2026-04-07)
- ✅ **统计面板** - 📊按钮打开详细使用统计
- ✅ **核心指标** - 今日/本周/本月/日均记录数
- ✅ **7天趋势** - 近7天记录数趋势图
- ✅ **类型分布** - 文字/代码/文件/图片占比
- ✅ **活跃时段** - 记录最频繁的小时段分析
### v0.18.0 (2026-04-07)
- ✅ **跨设备同步** - 端到端加密的多设备剪贴板同步
- ✅ **设备配对** - 二维码扫描快速配对设备
- ✅ **离线队列** - 离线自动缓存，联网后批量同步
- ✅ **云备份** - 支持自建服务器中继，数据全程加密
### v0.17.0 (2026-04-06)
- ✅ **图片 OCR 识别** - 自动识别剪贴板图片中的文字
- ✅ **Tesseract.js 集成** - 本地 OCR，无需联网
- ✅ **OCR 搜索支持** - 搜索图片中的文字内容
- ✅ **一键复制 OCR 结果** - 快速复制识别的文字
### v0.16.0 (2026-04-06)
- ✅ **加密存储** - AES-256 加密敏感剪贴板内容
- ✅ **密码保护** - 设置主密码，查看加密内容需验证
- ✅ **锁定/解锁** - 随时锁定加密密钥
- ✅ **加密标识** - 列表中显示🔒标识，搜索自动排除
### v0.15.0 (2026-04-05)
- ✅ **快捷键管理面板** - 设置中新增快捷键标签页
- ✅ **快捷键自定义** - 点击输入框录制新快捷键
- ✅ **重置默认** - 一键恢复默认快捷键
### v0.14.0 (2026-04-05)
- ✅ **时间线视图** - 按时间自动分组展示（今天/昨天/本周/本月/更早）
- ✅ **视图切换** - 列表视图和时间线视图自由切换
- ✅ **分组折叠** - 支持分组折叠/展开，显示记录数量
### v0.13.0 (2026-04-04)
- ✅ **多选批量操作** - 多选模式下批量删除、收藏、导出
- ✅ **全选/取消全选** - 快速选择当前列表所有记录
- ✅ **批量导出 JSON** - 导出选中记录为 JSON 文件
### v0.12.0 (2026-04-03)
- ✅ **内容预览面板** - 详情面板支持原文/预览模式切换
- ✅ **Markdown 渲染** - 自动识别 Markdown 内容，支持 GFM 语法渲染（标题、列表、代码块、表格、引用、任务列表等）
- ✅ **预览样式** - 适配深色/浅色主题
### v0.11.0 (2026-04-02)
- ✅ **快捷键自定义** - 设置中可修改全局快捷键
### v0.10.0 (2026-04-02)
- ✅ **文件拖拽** - 拖拽文件到窗口自动复制路径
- ✅ **键盘快捷键** - Delete/Enter/Esc 快速操作
### v0.9.0 (2026-04-02)
- ✅ **窗口置顶** - 托盘菜单切换窗口始终在最前
- ✅ **记录锁定** - 锁定记录不被自动清理
### v0.8.0 (2026-04-02)
- ✅ **快捷短语模板** - 模板列表管理，一键复制
- ✅ **自动清理** - 超出上限自动删除旧记录
### v0.7.0 (2026-04-02)
- ✅ **主题切换** - 支持浅色/深色模式
### v0.6.0 (2026-04-02)
- ✅ **开机自启动** - 开机自动运行，可设置开关
### v0.5.0 (2026-04-02)
- ✅ **全局快捷键** - Ctrl+Shift+V 快速调出/隐藏窗口
- ✅ **数据导出导入** - 支持 JSON/CSV 格式备份与恢复
- ✅ **历史记录去重** - 自动跳过连续重复内容
### v0.4.0 (2026-04-02)
- ✅ **代码片段库** - 自动识别编程语言，highlight.js 高亮显示
- ✅ **托盘图标优化** - 自定义托盘图标（非空白）
- ✅ **自然语言搜索** - 支持语义搜索
### v0.3.0 (2026-04-02)
- ✅ **自然语言搜索** - 支持语义搜索
### v0.2.0 (2026-04-02)
- ✅ **AI 摘要功能** - 自动调用 Ollama 生成智能摘要
### v0.1.0 (2026-04-02)
- ✅ 完成基础项目框架搭建
---
## 🤝 贡献
欢迎提交 Issue 和 Pull Request！
---
## 📄 许可证
本项目采用 [MIT License](./LICENSE) 开源。