{"id":51026955,"url":"https://github.com/gitstq/clipmind","last_synced_at":"2026-06-21T20:02:47.218Z","repository":{"id":358167656,"uuid":"1240318173","full_name":"gitstq/clipmind","owner":"gitstq","description":"🧠 ClipMind - Lightweight Intelligent Clipboard Memory Engine | 轻量级智能剪贴板记忆引擎","archived":false,"fork":false,"pushed_at":"2026-05-16T02:14:21.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-16T04:35:06.391Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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":null,"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-16T02:12:41.000Z","updated_at":"2026-05-16T02:14:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/clipmind","commit_stats":null,"previous_names":["gitstq/clipmind"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/clipmind","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fclipmind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fclipmind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fclipmind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fclipmind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/clipmind/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fclipmind/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:47.159Z","updated_at":"2026-06-21T20:02:47.210Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🧠 ClipMind\n\n**Intelligent Terminal Clipboard History Manager**\n\n[![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://python.org)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)]()\n[![Zero Dependencies](https://img.shields.io/badge/Dependencies-Zero-orange.svg)]()\n\n[English](#english) | [简体中文](#simplified-chinese) | [繁體中文](#traditional-chinese)\n\n\u003c/div\u003e\n\n---\n\n\u003ca name=\"english\"\u003e\u003c/a\u003e\n## 🇺🇸 English\n\n### 🎉 Project Introduction\n\n**ClipMind** is an intelligent terminal clipboard history manager designed for developers and power users. It automatically tracks your clipboard history, intelligently categorizes content types, and provides a beautiful TUI interface for quick search and retrieval.\n\n**Core Value Proposition:**\n- 🚀 **Never lose clipboard content again** - Automatic persistent storage\n- 🧠 **Smart categorization** - Auto-detect URLs, code, JSON, emails, file paths\n- ⚡ **Lightning-fast fuzzy search** - Find anything in milliseconds\n- 🎯 **Zero dependencies** - Pure Python standard library, no bloat\n- 💻 **Developer-first** - Vim-style keybindings, terminal-native workflow\n\n**Differentiation from existing tools:**\nUnlike GUI clipboard managers that require mouse interaction, ClipMind is entirely keyboard-driven and terminal-native. Unlike simple clipboard history tools, ClipMind provides intelligent content classification and persistent storage with JSON-based data format.\n\n---\n\n### ✨ Core Features\n\n| Feature | Description |\n|---------|-------------|\n| 📋 **Auto Capture** | Monitor clipboard changes in real-time |\n| 🏷️ **Smart Classification** | Auto-detect text/code/URL/JSON/email/path |\n| 🔍 **Fuzzy Search** | Lightning-fast content search with scoring |\n| 🖥️ **Beautiful TUI** | Terminal UI with color-coded type icons |\n| ⌨️ **Vim Bindings** | `j/k` navigation, `g/G` jump, `/` search |\n| 💾 **Persistent Storage** | JSON-based history with configurable limits |\n| 🌍 **Cross-Platform** | Windows, macOS, Linux native support |\n| 🚫 **Zero Dependencies** | Only Python standard library |\n\n---\n\n### 🚀 Quick Start\n\n#### Requirements\n- Python 3.8 or higher\n- Terminal with ANSI color support\n\n#### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/gitstq/ClipMind.git\ncd ClipMind\n\n# Install\npip install .\n\n# Or install in development mode\npip install -e .\n```\n\n#### Usage\n\n```bash\n# Launch interactive TUI\nclipmind\n\n# Or use short alias\ncm\n```\n\n**Keyboard Shortcuts:**\n| Key | Action |\n|-----|--------|\n| `↑/k` | Move up |\n| `↓/j` | Move down |\n| `Enter` | Copy selected to clipboard |\n| `/` | Search mode |\n| `d` | Delete selected entry |\n| `g` | Go to top |\n| `G` | Go to bottom |\n| `c` | Clear all history |\n| `q` | Quit |\n\n---\n\n### 📖 Detailed Usage Guide\n\n#### CLI Commands\n\n```bash\n# Add text to history\nclipmind --add \"Hello World\"\n\n# List recent entries\nclipmind --list --limit 20\n\n# Search history\nclipmind --search \"keyword\"\n\n# Filter by type\nclipmind --list --type code\n\n# Copy entry by index\nclipmind --copy 0\n\n# Delete entry by index\nclipmind --delete 0\n\n# Show statistics\nclipmind --stats\n\n# Monitor clipboard in background\nclipmind --monitor\n\n# Clear all history\nclipmind --clear\n```\n\n#### Content Type Detection\n\nClipMind automatically classifies clipboard content:\n\n| Icon | Type | Detection Pattern |\n|------|------|-------------------|\n| 📄 | Text | Default type |\n| 💻 | Code | `def`, `class`, `import`, `function` |\n| 🔗 | URL | `http://`, `https://`, `ftp://` |\n| 📁 | Path | Existing file paths |\n| 📋 | JSON | Valid JSON format |\n| 📧 | Email | `user@domain.com` pattern |\n\n---\n\n### 💡 Design Philosophy \u0026 Roadmap\n\n**Design Principles:**\n1. **Terminal-native** - No GUI dependencies, works over SSH\n2. **Zero dependencies** - Reduce supply chain attack surface\n3. **Keyboard-first** - Optimize for developer workflow speed\n4. **Intelligent defaults** - Auto-classify without configuration\n\n**Roadmap:**\n- [ ] Regex-based custom type rules\n- [ ] Export/import history\n- [ ] Encrypted storage option\n- [ ] Plugin system for custom processors\n- [ ] Integration with popular terminal multiplexers\n\n---\n\n### 📦 Packaging \u0026 Deployment\n\n#### Build from Source\n\n```bash\n# Clean build\nmake clean\n\n# Build distribution\nmake build\n\n# Run tests\nmake test\n```\n\n#### Manual Installation\n\n```bash\n# Direct execution without installation\npython -m clipmind\n```\n\n---\n\n### 🤝 Contributing\n\nWe welcome contributions! Please follow these guidelines:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit with conventional commits (`feat:`, `fix:`, `docs:`)\n4. Push to your fork\n5. Open a Pull Request\n\n**Issue Reporting:**\n- Use GitHub Issues for bug reports\n- Include Python version and OS information\n- Provide steps to reproduce\n\n---\n\n### 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003ca name=\"simplified-chinese\"\u003e\u003c/a\u003e\n## 🇨🇳 简体中文\n\n### 🎉 项目介绍\n\n**ClipMind** 是一款专为开发者和高级用户设计的智能终端剪贴板历史管理器。它自动追踪剪贴板历史，智能分类内容类型，并提供精美的 TUI 界面实现快速搜索和检索。\n\n**核心价值主张：**\n- 🚀 **再也不丢失剪贴板内容** - 自动持久化存储\n- 🧠 **智能分类** - 自动识别 URL、代码、JSON、邮箱、文件路径\n- ⚡ **闪电般模糊搜索** - 毫秒级内容查找\n- 🎯 **零依赖** - 纯 Python 标准库，无臃肿依赖\n- 💻 **开发者优先** - Vim 风格快捷键，终端原生工作流\n\n**与现有工具的差异化：**\n与需要鼠标操作的 GUI 剪贴板管理器不同，ClipMind 完全基于键盘驱动且原生适配终端。与简单的剪贴板历史工具不同，ClipMind 提供智能内容分类和基于 JSON 的持久化存储。\n\n---\n\n### ✨ 核心特性\n\n| 特性 | 描述 |\n|------|------|\n| 📋 **自动捕获** | 实时监控剪贴板变化 |\n| 🏷️ **智能分类** | 自动识别文本/代码/URL/JSON/邮箱/路径 |\n| 🔍 **模糊搜索** | 带评分的闪电般内容搜索 |\n| 🖥️ **精美 TUI** | 带彩色类型图标的终端界面 |\n| ⌨️ **Vim 快捷键** | `j/k` 导航、`g/G` 跳转、`/` 搜索 |\n| 💾 **持久化存储** | 基于 JSON 的历史记录，可配置上限 |\n| 🌍 **跨平台** | Windows、macOS、Linux 原生支持 |\n| 🚫 **零依赖** | 仅使用 Python 标准库 |\n\n---\n\n### 🚀 快速开始\n\n#### 环境要求\n- Python 3.8 或更高版本\n- 支持 ANSI 颜色的终端\n\n#### 安装\n\n```bash\n# 克隆仓库\ngit clone https://github.com/gitstq/ClipMind.git\ncd ClipMind\n\n# 安装\npip install .\n\n# 或开发模式安装\npip install -e .\n```\n\n#### 使用\n\n```bash\n# 启动交互式 TUI\nclipmind\n\n# 或使用短别名\ncm\n```\n\n**键盘快捷键：**\n| 按键 | 操作 |\n|------|------|\n| `↑/k` | 向上移动 |\n| `↓/j` | 向下移动 |\n| `Enter` | 复制选中项到剪贴板 |\n| `/` | 搜索模式 |\n| `d` | 删除选中项 |\n| `g` | 跳到顶部 |\n| `G` | 跳到底部 |\n| `c` | 清空所有历史 |\n| `q` | 退出 |\n\n---\n\n### 📖 详细使用指南\n\n#### CLI 命令\n\n```bash\n# 添加文本到历史\nclipmind --add \"Hello World\"\n\n# 列出最近条目\nclipmind --list --limit 20\n\n# 搜索历史\nclipmind --search \"关键词\"\n\n# 按类型筛选\nclipmind --list --type code\n\n# 按索引复制\nclipmind --copy 0\n\n# 按索引删除\nclipmind --delete 0\n\n# 显示统计\nclipmind --stats\n\n# 后台监控剪贴板\nclipmind --monitor\n\n# 清空所有历史\nclipmind --clear\n```\n\n#### 内容类型检测\n\nClipMind 自动分类剪贴板内容：\n\n| 图标 | 类型 | 检测规则 |\n|------|------|----------|\n| 📄 | 文本 | 默认类型 |\n| 💻 | 代码 | `def`、`class`、`import`、`function` |\n| 🔗 | 链接 | `http://`、`https://`、`ftp://` |\n| 📁 | 路径 | 存在的文件路径 |\n| 📋 | JSON | 有效 JSON 格式 |\n| 📧 | 邮箱 | `user@domain.com` 格式 |\n\n---\n\n### 💡 设计思路与迭代规划\n\n**设计理念：**\n1. **终端原生** - 无 GUI 依赖，支持 SSH 远程使用\n2. **零依赖** - 降低供应链攻击风险\n3. **键盘优先** - 优化开发者工作流速度\n4. **智能默认** - 无需配置即可自动分类\n\n**迭代计划：**\n- [ ] 基于正则的自定义类型规则\n- [ ] 历史记录导出/导入\n- [ ] 加密存储选项\n- [ ] 自定义处理器插件系统\n- [ ] 与主流终端复用器集成\n\n---\n\n### 📦 打包与部署指南\n\n#### 从源码构建\n\n```bash\n# 清理构建\nmake clean\n\n# 构建分发包\nmake build\n\n# 运行测试\nmake test\n```\n\n#### 手动安装\n\n```bash\n# 无需安装直接运行\npython -m clipmind\n```\n\n---\n\n### 🤝 贡献指南\n\n欢迎贡献！请遵循以下规范：\n\n1. Fork 本仓库\n2. 创建特性分支 (`git checkout -b feature/amazing-feature`)\n3. 使用约定式提交 (`feat:`、`fix:`、`docs:`)\n4. 推送到你的 Fork\n5. 提交 Pull Request\n\n**Issue 反馈：**\n- 使用 GitHub Issues 提交 Bug 报告\n- 包含 Python 版本和操作系统信息\n- 提供复现步骤\n\n---\n\n### 📄 开源协议\n\n本项目基于 MIT 协议开源 - 详见 [LICENSE](LICENSE) 文件。\n\n---\n\n\u003ca name=\"traditional-chinese\"\u003e\u003c/a\u003e\n## 🇹🇼 繁體中文\n\n### 🎉 專案介紹\n\n**ClipMind** 是一款為開發者與進階使用者設計的智慧終端機剪貼簿歷史管理器。它自動追蹤剪貼簿歷史，智慧分類內容類型，並提供美觀的 TUI 介面實現快速搜尋與檢索。\n\n**核心價值主張：**\n- 🚀 **再也不會遺失剪貼簿內容** - 自動持久化儲存\n- 🧠 **智慧分類** - 自動偵測 URL、程式碼、JSON、郵件、檔案路徑\n- ⚡ **閃電級模糊搜尋** - 毫秒級內容查找\n- 🎯 **零依賴** - 純 Python 標準函式庫，沒有臃腫依賴\n- 💻 **開發者優先** - Vim 風格快捷鍵，終端機原生工作流程\n\n**與現有工具的差異化：**\n不同於需要滑鼠操作的 GUI 剪貼簿管理器，ClipMind 完全以鍵盤驅動且原生適配終端機。不同於簡單的剪貼簿歷史工具，ClipMind 提供智慧內容分類與基於 JSON 的持久化儲存。\n\n---\n\n### ✨ 核心特性\n\n| 特性 | 說明 |\n|------|------|\n| 📋 **自動捕獲** | 即時監控剪貼簿變化 |\n| 🏷️ **智慧分類** | 自動偵測文字/程式碼/URL/JSON/郵件/路徑 |\n| 🔍 **模糊搜尋** | 帶評分的閃電級內容搜尋 |\n| 🖥️ **美觀 TUI** | 帶彩色類型圖示的終端機介面 |\n| ⌨️ **Vim 快捷鍵** | `j/k` 導航、`g/G` 跳轉、`/` 搜尋 |\n| 💾 **持久化儲存** | 基於 JSON 的歷史記錄，可配置上限 |\n| 🌍 **跨平台** | Windows、macOS、Linux 原生支援 |\n| 🚫 **零依賴** | 僅使用 Python 標準函式庫 |\n\n---\n\n### 🚀 快速開始\n\n#### 環境需求\n- Python 3.8 或更高版本\n- 支援 ANSI 顏色的終端機\n\n#### 安裝\n\n```bash\n# 複製倉庫\ngit clone https://github.com/gitstq/ClipMind.git\ncd ClipMind\n\n# 安裝\npip install .\n\n# 或開發模式安裝\npip install -e .\n```\n\n#### 使用\n\n```bash\n# 啟動互動式 TUI\nclipmind\n\n# 或使用短別名\ncm\n```\n\n**鍵盤快捷鍵：**\n| 按鍵 | 動作 |\n|------|------|\n| `↑/k` | 向上移動 |\n| `↓/j` | 向下移動 |\n| `Enter` | 複製選中項目到剪貼簿 |\n| `/` | 搜尋模式 |\n| `d` | 刪除選中項目 |\n| `g` | 跳到頂部 |\n| `G` | 跳到底部 |\n| `c` | 清空所有歷史 |\n| `q` | 退出 |\n\n---\n\n### 📖 詳細使用指南\n\n#### CLI 指令\n\n```bash\n# 新增文字到歷史\nclipmind --add \"Hello World\"\n\n# 列出最近項目\nclipmind --list --limit 20\n\n# 搜尋歷史\nclipmind --search \"關鍵字\"\n\n# 依類型過濾\nclipmind --list --type code\n\n# 依索引複製\nclipmind --copy 0\n\n# 依索引刪除\nclipmind --delete 0\n\n# 顯示統計\nclipmind --stats\n\n# 背景監控剪貼簿\nclipmind --monitor\n\n# 清空所有歷史\nclipmind --clear\n```\n\n#### 內容類型偵測\n\nClipMind 自動分類剪貼簿內容：\n\n| 圖示 | 類型 | 偵測規則 |\n|------|------|----------|\n| 📄 | 文字 | 預設類型 |\n| 💻 | 程式碼 | `def`、`class`、`import`、`function` |\n| 🔗 | 連結 | `http://`、`https://`、`ftp://` |\n| 📁 | 路徑 | 存在的檔案路徑 |\n| 📋 | JSON | 有效 JSON 格式 |\n| 📧 | 郵件 | `user@domain.com` 格式 |\n\n---\n\n### 💡 設計理念與迭代規劃\n\n**設計理念：**\n1. **終端機原生** - 無 GUI 依賴，支援 SSH 遠端使用\n2. **零依賴** - 降低供應鏈攻擊風險\n3. **鍵盤優先** - 優化開發者工作流程速度\n4. **智慧預設** - 不需設定即可自動分類\n\n**迭代計劃：**\n- [ ] 基於正規表示式的自訂類型規則\n- [ ] 歷史記錄匯出/匯入\n- [ ] 加密儲存選項\n- [ ] 自訂處理器外掛系統\n- [ ] 與主流終端機複用器整合\n\n---\n\n### 📦 打包與部署指南\n\n#### 從原始碼建構\n\n```bash\n# 清理建構\nmake clean\n\n# 建構分發套件\nmake build\n\n# 執行測試\nmake test\n```\n\n#### 手動安裝\n\n```bash\n# 不需安裝直接執行\npython -m clipmind\n```\n\n---\n\n### 🤝 貢獻指南\n\n歡迎貢獻！請遵循以下規範：\n\n1. Fork 本倉庫\n2. 建立特性分支 (`git checkout -b feature/amazing-feature`)\n3. 使用約定式提交 (`feat:`、`fix:`、`docs:`)\n4. 推送到你的 Fork\n5. 提交 Pull Request\n\n**Issue 回報：**\n- 使用 GitHub Issues 提交 Bug 報告\n- 包含 Python 版本和作業系統資訊\n- 提供重現步驟\n\n---\n\n### 📄 開源授權\n\n本專案基於 MIT 授權開源 - 詳見 [LICENSE](LICENSE) 檔案。\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fclipmind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fclipmind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fclipmind/lists"}