RetroHackLab/BlackMa1ny
GitHub: RetroHackLab/BlackMa1ny
BlackMa1ny 是一个开源教育性程序，伪装成复古游戏以模拟本地桌面恶作剧，用于安全测试和意识培训。
Stars: 0 | Forks: 0
# 🖤 BlackMa1ny - 开源恶作剧程序
⚠️ **重要免责声明与安全警告**
* **风险自负：** 开发者对任何造成的系统中断、临时无响应或本软件的滥用行为不承担任何责任。
* **仅限测试环境：** 本程序严格设计为在 **专用的测试环境（例如虚拟机或隔离的测试台）** 中执行。**切勿**在你的日常主力电脑、生产机器或任何活跃的个人工作空间上运行此程序。
* **纯源代码仓库：** 为确保基础设施的安全与合规，本仓库 **仅包含原始源代码**。不提供任何预编译的二进制文件（`.exe`）。你必须自行检查并编译二进制文件。
## 🎭 核心概念：PlayGames 伪装术（社会工程学技巧）
虽然此项目的真实身份是 **BlackMa1ny**（或被称为 **Chase Me**），但其编译自动化工程设计输出一个伪装成 **`PlayGames.exe`** 的独立二进制文件。
* 对于目标而言，它看起来像一个无害的轻量级复古游戏应用（邀请他们玩 **"VS BOT"**）。
* 一旦执行，它会解压出核心的 **BlackMa1ny** 架构（`Main.py` 窗口操控循环和嵌入的 `MEME.wav` 声音矩阵）来触发混乱模拟器。
## ⚠️ 基础设施与系统兼容性
* **当前支持：** 目标架构严格限于 **Windows 10 和 Windows 11**。
* **旧版系统：** Windows 7/8 的支持明确标注为 **即将到来** 🕒（需要模块化的降级编译工具）。
* **安全检查：** 它 **不** 包含任何恶意载荷、后门或系统绕过机制。它 **不会** 损坏、加密或永久修改任何操作系统文件。它纯粹是一个良性的、混乱的图形化实验。
## ✨ 功能特性
* **伪装部署：** 自动化设置，将资源绑定到伪装的游戏身份（`PlayGames.exe`）中。
* **边界物理效果：** 动态窗口循环（`CrazyWindow` 类），带有自定义的边界弹回物理效果。
* **拼接音频循环：** 使用原生 Windows 组件（`winsound`）实现异步音频循环，并直接嵌入到最终编译的独立进程中。
## 🛠️ 如何构建和运行（适用于 Windows 10 / 11）
1. 确保你的 Windows 10/11 开发机器上安装了 **Python 3.10 或更高版本**。
2. 克隆本仓库或将源文件下载到你本地的 `/MM/` 目录。
3. 打开终端并安装编译器依赖项：
```
pip install pyinstaller
```
```
if exist build rmdir /s /q build
if exist dist rmdir /s /q dist
if exist Main.spec del /q Main.spec
py -m PyInstaller --clean --onefile --noconsole --exclude pygame --add-data "MEME.wav;." Main.py
```
4. 编译后的二进制文件将生成在新创建的 `dist/` 文件夹中，名为 **`PlayGames.exe`**（其中隐藏了 BlackMa1ny 引擎）。
## 🚨 资源使用与紧急停止（安全第一）
由于此程序会持续生成窗口，它被设计为密集消耗 CPU 和 RAM 资源，模拟严重的桌面卡顿或本地系统延迟。**这是一种本地拒绝服务（DoS）玩笑，并非破坏性病毒。**
如果你的测试环境在演示期间开始出现卡顿或延迟，请不要惊慌！你不需要对机器进行硬重置。
### 如何安全地停止恶作剧程序：
1. **运行 `fix.cmd`：** 执行源文件中包含的紧急脚本 `fix.cmd`。它将立即终止后台进程循环并清理桌面。
2. **任务管理器：** 按下 `Ctrl + Shift + Esc`，找到 `PlayGames.exe`（如果运行原始脚本则为 `python`），然后单击 **结束任务**。
3. **紧急快捷键：** 或者，在关注任何活动的恶作剧窗口时，按下键盘上的 `Esc` 键，可以立即终止程序循环并停止循环播放的音频。
## ⚠️ 基础设施与系统兼容性
* **当前支持：** 目标架构严格限于 **Windows 10 和 Windows 11**。
* **旧版系统：** Windows 7/8 的支持明确标注为 **即将到来** 🕒（需要模块化的降级编译工具）。
* **安全检查：** 它 **不** 包含任何恶意载荷、后门或系统绕过机制。它 **不会** 损坏、加密或永久修改任何操作系统文件。它纯粹是一个良性的、混乱的图形化实验。
## ✨ 功能特性
* **伪装部署：** 自动化设置，将资源绑定到伪装的游戏身份（`PlayGames.exe`）中。
* **边界物理效果：** 动态窗口循环（`CrazyWindow` 类），带有自定义的边界弹回物理效果。
* **拼接音频循环：** 使用原生 Windows 组件（`winsound`）实现异步音频循环，并直接嵌入到最终编译的独立进程中。
## 🛠️ 如何构建和运行（适用于 Windows 10 / 11）
1. 确保你的 Windows 10/11 开发机器上安装了 **Python 3.10 或更高版本**。
2. 克隆本仓库或将源文件下载到你本地的 `/MM/` 目录。
3. 打开终端并安装编译器依赖项：
```
pip install pyinstaller
```
```
if exist build rmdir /s /q build
if exist dist rmdir /s /q dist
if exist Main.spec del /q Main.spec
py -m PyInstaller --clean --onefile --noconsole --exclude pygame --add-data "MEME.wav;." Main.py
```
4. 编译后的二进制文件将生成在新创建的 `dist/` 文件夹中，名为 **`PlayGames.exe`**（其中隐藏了 BlackMa1ny 引擎）。
## 🚨 资源使用与紧急停止（安全第一）
由于此程序会持续生成窗口，它被设计为密集消耗 CPU 和 RAM 资源，模拟严重的桌面卡顿或本地系统延迟。**这是一种本地拒绝服务（DoS）玩笑，并非破坏性病毒。**
如果你的测试环境在演示期间开始出现卡顿或延迟，请不要惊慌！你不需要对机器进行硬重置。
### 如何安全地停止恶作剧程序：
1. **运行 `fix.cmd`：** 执行源文件中包含的紧急脚本 `fix.cmd`。它将立即终止后台进程循环并清理桌面。
2. **任务管理器：** 按下 `Ctrl + Shift + Esc`，找到 `PlayGames.exe`（如果运行原始脚本则为 `python`），然后单击 **结束任务**。
3. **紧急快捷键：** 或者，在关注任何活动的恶作剧窗口时，按下键盘上的 `Esc` 键，可以立即终止程序循环并停止循环播放的音频。标签：DAST, DNS 解析, ESC8, Python编程, Windows系统, 伪装技术, 图形用户界面, 复古游戏, 安全测试, 恶作剧, 恶意软件分析, 恶意软件模拟, 搜索语句（dork）, 攻击性安全, 教育工具, 教育项目, 测试环境, 混沌模拟, 源代码, 漏洞挖掘, 生成式AI安全, 社会工程学, 系统兼容性, 网络安全, 虚拟机, 逆向工具, 隐私保护