{"id":51026736,"url":"https://github.com/gitstq/smart-clipboard-manager","last_synced_at":"2026-06-21T20:02:16.535Z","repository":{"id":360813991,"uuid":"1251822475","full_name":"gitstq/smart-clipboard-manager","owner":"gitstq","description":"🚀 A powerful cross-platform clipboard manager with history, search, and smart categorization","archived":false,"fork":false,"pushed_at":"2026-05-28T00:18:52.000Z","size":27,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-28T02:18:51.021Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitstq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-28T00:17:00.000Z","updated_at":"2026-05-28T00:18:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/smart-clipboard-manager","commit_stats":null,"previous_names":["gitstq/smart-clipboard-manager"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/smart-clipboard-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsmart-clipboard-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsmart-clipboard-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsmart-clipboard-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsmart-clipboard-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/smart-clipboard-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsmart-clipboard-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34623906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-21T20:02:15.710Z","updated_at":"2026-06-21T20:02:16.529Z","avatar_url":"https://github.com/gitstq.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📋 Smart Clipboard Manager\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/version-1.0.0-blue.svg\" alt=\"Version\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-green.svg\" alt=\"License\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg\" alt=\"Platform\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#简体中文\"\u003e简体中文\u003c/a\u003e |\n  \u003ca href=\"#繁體中文\"\u003e繁體中文\u003c/a\u003e |\n  \u003ca href=\"#english\"\u003eEnglish\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003ca name=\"简体中文\"\u003e\u003c/a\u003e\n## 🎉 项目介绍\n\n**Smart Clipboard Manager** 是一款功能强大的跨平台剪贴板管理器，旨在解决日常工作和开发中剪贴板历史丢失、内容难以查找的痛点。\n\n### 💡 灵感来源\n\n在日常开发工作中，我们经常需要复制粘贴多个代码片段、URL、颜色值等内容。然而系统默认的剪贴板只能保存最后一次复制的内容，导致之前的重要信息丢失。本项目正是为了解决这一痛点而诞生。\n\n### ✨ 自研差异化亮点\n\n- **智能内容识别**：自动识别 URL、邮箱、代码、颜色值等多种内容类型\n- **隐私保护**：自动检测并排除密码、API Key 等敏感内容\n- **轻量级架构**：基于 Electron + TypeScript，内存占用低\n- **现代化 UI**：支持深色/浅色主题，界面简洁美观\n\n---\n\n## ✨ 核心特性\n\n| 特性 | 描述 |\n|------|------|\n| 📋 **剪贴板历史** | 自动保存最近 1000 条剪贴板记录 |\n| 🔍 **智能搜索** | 支持全文搜索和标签筛选 |\n| 🏷️ **自动分类** | 智能识别 URL、邮箱、代码、颜色等内容类型 |\n| ⭐ **收藏功能** | 重要内容可收藏，方便快速访问 |\n| 🔒 **隐私保护** | 自动排除密码、Token 等敏感信息 |\n| 🎯 **去重机制** | 相同内容不会重复存储 |\n| ⌨️ **全局快捷键** | `Ctrl+Shift+V` 快速呼出 |\n| 🌙 **主题切换** | 支持浅色/深色/跟随系统三种模式 |\n| 🌐 **多语言支持** | 简体中文、繁體中文、English |\n| 🧹 **自动清理** | 支持按天数自动清理旧记录 |\n\n---\n\n## 🚀 快速开始\n\n### 环境要求\n\n- **Node.js** \u003e= 18.0.0\n- **npm** \u003e= 9.0.0\n- **操作系统**: Windows 10+ / macOS 10.14+ / Linux (Ubuntu 18.04+)\n\n### 安装步骤\n\n```bash\n# 克隆仓库\ngit clone https://github.com/gitstq/smart-clipboard-manager.git\n\n# 进入项目目录\ncd smart-clipboard-manager\n\n# 安装依赖\nnpm install\n\n# 编译 TypeScript\nnpm run build\n\n# 启动应用\nnpm run dev\n```\n\n### 一键运行\n\n```bash\n# 开发模式\nnpm run dev\n\n# 生产构建\nnpm run dist\n\n# 全平台打包\nnpm run dist:all\n```\n\n---\n\n## 📖 详细使用指南\n\n### 基础操作\n\n1. **呼出应用**：按 `Ctrl+Shift+V`（可自定义）\n2. **复制内容**：点击任意历史记录即可复制到剪贴板\n3. **搜索内容**：在搜索框输入关键词，支持模糊匹配\n4. **收藏项目**：点击星标按钮将常用内容加入收藏夹\n\n### 内容类型识别\n\n应用会自动识别以下内容类型：\n\n| 类型 | 图标 | 示例 |\n|------|------|------|\n| 链接 | 🔗 | `https://github.com` |\n| 邮箱 | 📧 | `example@email.com` |\n| 代码 | 💻 | `function hello() {}` |\n| 颜色 | 🎨 | `#FF5733`, `rgb(255,0,0)` |\n| 文件路径 | 📁 | `/home/user/file.txt` |\n| 数字 | 🔢 | `12345` |\n\n### 设置选项\n\n点击侧边栏底部的「设置」按钮，可配置：\n\n- **最大历史记录数**：100 - 10000 条\n- **自动清理天数**：1 - 365 天\n- **全局快捷键**：自定义呼出快捷键\n- **主题模式**：浅色 / 深色 / 跟随系统\n- **语言**：简体中文 / 繁體中文 / English\n\n---\n\n## 💡 设计思路与迭代规划\n\n### 技术选型\n\n- **Electron**：跨平台桌面应用框架\n- **TypeScript**：类型安全，提升开发体验\n- **原生剪贴板 API**：高效监听系统剪贴板变化\n- **JSON 文件存储**：轻量级，无需额外数据库\n\n### 架构设计\n\n```\nsrc/\n├── main/           # 主进程\n│   ├── index.ts    # 应用入口\n│   ├── clipboard-store.ts  # 数据存储管理\n│   └── preload.ts  # 预加载脚本\n├── renderer/       # 渲染进程\n│   ├── index.html  # UI 界面\n│   ├── styles.css  # 样式\n│   └── app.js      # 前端逻辑\n└── shared/         # 共享模块\n    ├── types.ts    # 类型定义\n    └── utils.ts    # 工具函数\n```\n\n### 后续迭代计划\n\n- [ ] 云同步功能\n- [ ] 图片剪贴板支持\n- [ ] 自定义标签系统\n- [ ] 数据导出/导入\n- [ ] 插件扩展机制\n\n---\n\n## 📦 打包与部署\n\n### Windows\n\n```bash\nnpm run dist\n# 输出: release/Smart Clipboard Manager Setup 1.0.0.exe\n```\n\n### macOS\n\n```bash\nnpm run dist\n# 输出: release/Smart Clipboard Manager-1.0.0.dmg\n```\n\n### Linux\n\n```bash\nnpm run dist\n# 输出: release/Smart Clipboard Manager-1.0.0.AppImage\n```\n\n---\n\n## 🤝 贡献指南\n\n欢迎提交 Issue 和 Pull Request！\n\n1. Fork 本仓库\n2. 创建特性分支 (`git checkout -b feature/amazing-feature`)\n3. 提交更改 (`git commit -m 'feat: add amazing feature'`)\n4. 推送分支 (`git push origin feature/amazing-feature`)\n5. 创建 Pull Request\n\n请阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 了解详细信息。\n\n---\n\n## 📄 开源协议\n\n本项目基于 [MIT](LICENSE) 协议开源。\n\n---\n\n\u003ca name=\"繁體中文\"\u003e\u003c/a\u003e\n## 🎉 專案介紹\n\n**Smart Clipboard Manager** 是一款功能強大的跨平台剪貼簿管理器，旨在解決日常工作和開發中剪貼簿歷史遺失、內容難以查找的痛點。\n\n### 💡 靈感來源\n\n在日常開發工作中，我們經常需要複製貼上多個程式碼片段、URL、顏色值等內容。然而系統預設的剪貼簿只能儲存最後一次複製的內容，導致之前的重要資訊遺失。本專案正是為了解決這一痛點而誕生。\n\n### ✨ 自研差異化亮點\n\n- **智慧內容識別**：自動識別 URL、郵件、程式碼、顏色值等多種內容類型\n- **隱私保護**：自動偵測並排除密碼、API Key 等敏感內容\n- **輕量級架構**：基於 Electron + TypeScript，記憶體佔用低\n- **現代化 UI**：支援深色/淺色主題，介面簡潔美觀\n\n---\n\n## ✨ 核心特性\n\n| 特性 | 描述 |\n|------|------|\n| 📋 **剪貼簿歷史** | 自動儲存最近 1000 條剪貼簿記錄 |\n| 🔍 **智慧搜尋** | 支援全文搜尋和標籤篩選 |\n| 🏷️ **自動分類** | 智慧識別 URL、郵件、程式碼、顏色等內容類型 |\n| ⭐ **收藏功能** | 重要內容可收藏，方便快速存取 |\n| 🔒 **隱私保護** | 自動排除密碼、Token 等敏感資訊 |\n| 🎯 **去重機制** | 相同內容不會重複儲存 |\n| ⌨️ **全域快捷鍵** | `Ctrl+Shift+V` 快速呼叫 |\n| 🌙 **主題切換** | 支援淺色/深色/跟隨系統三種模式 |\n| 🌐 **多語言支援** | 簡體中文、繁體中文、English |\n| 🧹 **自動清理** | 支援按天數自動清理舊記錄 |\n\n---\n\n## 🚀 快速開始\n\n### 環境要求\n\n- **Node.js** \u003e= 18.0.0\n- **npm** \u003e= 9.0.0\n- **作業系統**: Windows 10+ / macOS 10.14+ / Linux (Ubuntu 18.04+)\n\n### 安裝步驟\n\n```bash\n# 克隆倉庫\ngit clone https://github.com/gitstq/smart-clipboard-manager.git\n\n# 進入專案目錄\ncd smart-clipboard-manager\n\n# 安裝依賴\nnpm install\n\n# 編譯 TypeScript\nnpm run build\n\n# 啟動應用\nnpm run dev\n```\n\n---\n\n## 📖 詳細使用指南\n\n### 基礎操作\n\n1. **呼叫應用**：按 `Ctrl+Shift+V`（可自訂）\n2. **複製內容**：點擊任意歷史記錄即可複製到剪貼簿\n3. **搜尋內容**：在搜尋框輸入關鍵詞，支援模糊匹配\n4. **收藏項目**：點擊星標按鈕將常用內容加入收藏夾\n\n---\n\n## 🤝 貢獻指南\n\n歡迎提交 Issue 和 Pull Request！請閱讀 [CONTRIBUTING.md](CONTRIBUTING.md) 了解詳細資訊。\n\n---\n\n## 📄 開源協議\n\n本專案基於 [MIT](LICENSE) 協議開源。\n\n---\n\n\u003ca name=\"english\"\u003e\u003c/a\u003e\n## 🎉 Project Introduction\n\n**Smart Clipboard Manager** is a powerful cross-platform clipboard manager designed to solve the pain points of clipboard history loss and difficult content retrieval in daily work and development.\n\n### 💡 Inspiration\n\nIn daily development work, we often need to copy and paste multiple code snippets, URLs, color values, and other content. However, the system default clipboard can only save the last copied content, causing important previous information to be lost. This project was born to solve this pain point.\n\n### ✨ Differentiation Highlights\n\n- **Smart Content Recognition**: Automatically identifies URLs, emails, code, color values, and more\n- **Privacy Protection**: Automatically detects and excludes passwords, API Keys, and other sensitive content\n- **Lightweight Architecture**: Based on Electron + TypeScript with low memory footprint\n- **Modern UI**: Supports dark/light themes with a clean and beautiful interface\n\n---\n\n## ✨ Core Features\n\n| Feature | Description |\n|---------|-------------|\n| 📋 **Clipboard History** | Automatically saves the last 1000 clipboard records |\n| 🔍 **Smart Search** | Full-text search and tag filtering support |\n| 🏷️ **Auto-Categorization** | Intelligently identifies content types like URLs, emails, code, colors |\n| ⭐ **Favorites** | Important content can be favorited for quick access |\n| 🔒 **Privacy Protection** | Automatically excludes passwords, tokens, and other sensitive information |\n| 🎯 **Deduplication** | Identical content won't be stored twice |\n| ⌨️ **Global Hotkey** | `Ctrl+Shift+V` for quick access |\n| 🌙 **Theme Switching** | Light / Dark / System theme support |\n| 🌐 **Multi-language** | 简体中文, 繁體中文, English |\n| 🧹 **Auto-Cleanup** | Automatic cleanup of old records by days |\n\n---\n\n## 🚀 Quick Start\n\n### Requirements\n\n- **Node.js** \u003e= 18.0.0\n- **npm** \u003e= 9.0.0\n- **OS**: Windows 10+ / macOS 10.14+ / Linux (Ubuntu 18.04+)\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/gitstq/smart-clipboard-manager.git\n\n# Enter project directory\ncd smart-clipboard-manager\n\n# Install dependencies\nnpm install\n\n# Build TypeScript\nnpm run build\n\n# Start the app\nnpm run dev\n```\n\n### One-Click Run\n\n```bash\n# Development mode\nnpm run dev\n\n# Production build\nnpm run dist\n\n# Build for all platforms\nnpm run dist:all\n```\n\n---\n\n## 📖 Detailed Usage Guide\n\n### Basic Operations\n\n1. **Open App**: Press `Ctrl+Shift+V` (customizable)\n2. **Copy Content**: Click any history item to copy to clipboard\n3. **Search Content**: Enter keywords in the search box with fuzzy matching\n4. **Favorite Items**: Click the star button to add frequently used content to favorites\n\n### Content Type Recognition\n\nThe app automatically recognizes the following content types:\n\n| Type | Icon | Example |\n|------|------|---------|\n| URL | 🔗 | `https://github.com` |\n| Email | 📧 | `example@email.com` |\n| Code | 💻 | `function hello() {}` |\n| Color | 🎨 | `#FF5733`, `rgb(255,0,0)` |\n| File Path | 📁 | `/home/user/file.txt` |\n| Number | 🔢 | `12345` |\n\n### Settings\n\nClick the \"Settings\" button at the bottom of the sidebar to configure:\n\n- **Max History Items**: 100 - 10000\n- **Auto Cleanup Days**: 1 - 365 days\n- **Global Hotkey**: Customize the shortcut to open the app\n- **Theme Mode**: Light / Dark / System\n- **Language**: 简体中文 / 繁體中文 / English\n\n---\n\n## 💡 Design Philosophy \u0026 Roadmap\n\n### Tech Stack\n\n- **Electron**: Cross-platform desktop app framework\n- **TypeScript**: Type-safe, enhanced development experience\n- **Native Clipboard API**: Efficiently monitor system clipboard changes\n- **JSON File Storage**: Lightweight, no additional database needed\n\n### Architecture\n\n```\nsrc/\n├── main/           # Main process\n│   ├── index.ts    # App entry\n│   ├── clipboard-store.ts  # Data storage management\n│   └── preload.ts  # Preload script\n├── renderer/       # Renderer process\n│   ├── index.html  # UI interface\n│   ├── styles.css  # Styles\n│   └── app.js      # Frontend logic\n└── shared/         # Shared modules\n    ├── types.ts    # Type definitions\n    └── utils.ts    # Utility functions\n```\n\n### Future Roadmap\n\n- [ ] Cloud sync functionality\n- [ ] Image clipboard support\n- [ ] Custom tag system\n- [ ] Data export/import\n- [ ] Plugin extension mechanism\n\n---\n\n## 📦 Packaging \u0026 Deployment\n\n### Windows\n\n```bash\nnpm run dist\n# Output: release/Smart Clipboard Manager Setup 1.0.0.exe\n```\n\n### macOS\n\n```bash\nnpm run dist\n# Output: release/Smart Clipboard Manager-1.0.0.dmg\n```\n\n### Linux\n\n```bash\nnpm run dist\n# Output: release/Smart Clipboard Manager-1.0.0.AppImage\n```\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit issues and pull requests.\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'feat: add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n---\n\n## 📄 License\n\nThis project is licensed under the [MIT](LICENSE) License.\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ❤️ by Smart Clipboard Team\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fsmart-clipboard-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fsmart-clipboard-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fsmart-clipboard-manager/lists"}