Reinvicta-Tech/beatrooter

Beat roots. Beat them all. Be a BeatRooter.

# BeatRooter Demo BeatRooter 是一个用于可视化组织网络安全调查的 PyQt6 桌面 demo。它提供了一个画布，可以将资产、观测结果、证据、笔记和工具输出映射为相互连接的节点，而不是散落在各种终端、文件和截图中。 本仓库为 demo 版本。实验性模块和未完成的产品线已从面向用户的工作流程中移除，以便应用程序专注于调查画布。 ## 包含内容 - 带有可拖拽节点和动态连线的可视化调查画布。 - 用于资产、观测结果、证据、发现、行动和笔记的原子节点库。 - 自定义节点模板，用于将画布适配到特定的实验室或工作流程。 - 用于对相关画布项目进行分组的 Stackers。 - 用于编辑节点数据和关系的详情面板。 - 用于操作笔记和文档的 BeatNote。 - CVSS v4 计算器。 - Gnarl 助手面板和可视化 UI 元素。 - 外部工具管理和面向命令的工具节点。 - 英语和葡萄牙语 UI 目录。 - 支持保存/打开/导出 `.brt` 和 JSON 工作流的项目。 - 对正在进行的调查支持自动备份和恢复。 ## 快速开始 ### Linux ``` make run ``` 或者： ``` ./scripts/run_linux.sh ``` ### Windows ``` scripts\run_windows.bat ``` 两个启动脚本都会创建 `.venv`，安装 `requirements.txt`，并启动 `main.py`。 ## 构建可执行文件 PyInstaller 构建必须在目标操作系统上创建。请在 Windows 上构建 Windows 可执行文件，在 Linux 上构建 Linux 二进制文件。 ### Linux ``` make build ``` 或者： ``` ./scripts/build_linux.sh ``` 输出： ``` dist/BeatRooter/ ``` ### Windows ``` scripts\build_windows.bat ``` 输出： ``` dist\BeatRooter\ ``` ## 手动开发设置 仅当您希望自己管理环境时使用此方法。 ### Linux/macOS Shell ``` python3 -m venv .venv source .venv/bin/activate python -m pip install --upgrade pip python -m pip install -r requirements.txt python main.py ``` ### Windows PowerShell ``` py -3 -m venv .venv .\.venv\Scripts\Activate.ps1 python -m pip install --upgrade pip python -m pip install -r requirements.txt python main.py ``` ## Make 目标 ``` make run create/update .venv and start the app make build create/update .venv and build a local executable make clean remove build outputs make help show available commands ``` ## 项目结构 ``` BeatRooter_Demo/ main.py # PyQt6 entry point Makefile # Linux developer/build shortcuts BeatRooter.spec # PyInstaller build spec requirements.txt # runtime dependencies requirements-build.txt # build dependencies RUNNING.md # short run/build notes scripts/ run_linux.sh build_linux.sh run_windows.bat build_windows.bat assets/ # logos, icons, fonts and UI media features/ app_shell/ # welcome windows, quick menu and app shell helpers beatroot_canvas/ # main canvas, graph, nodes, panels and project IO beatnote/ # operational notes cvss/ # CVSS v4 calculator gnarl/ # assistant UI and sprite handling language/ # English/Portuguese catalogs onboarding/ # first-run and first-investigation flows optimization/ # startup/runtime optimizations project_backup/ # auto-backup and recovery shared_ui/ # shared theme helpers tools/ # tool catalog, installers, contexts and parsers wordlists/ # wordlist support integrations/ # optional local integration helpers ui/ # compatibility import wrappers utils/ # paths, images, version and platform helpers ``` ## 主要依赖 - Python 3.10+ - PyQt6 - PyQt6-WebEngine - Pillow - reportlab - selenium - webdriver-manager - requests - beautifulsoup4 - docker - python-dateutil - certifi 构建依赖： - pyinstaller ## 基本工作流程 1. 开始新的调查或打开现有的 `.brt` 文件。 2. 为资产、观测结果、证据、发现、行动或笔记添加原子节点。 3. 连接节点以明确关系。 4. 使用详情面板丰富每个节点。 5. 使用 BeatNote 添加支持性笔记。 6. 在需要外部命令输出时运行工具节点。 7. 保存或导出项目。 ## 负责任的使用 BeatRooter 旨在用于教育、实验室、CTF、内部安全工作和明确授权的评估。某些集成的工具可能会产生攻击性流量或处理敏感工件。 仅限在您拥有的系统、实验室环境、CTF、攻防演练或授权审计中使用。未经许可，请勿使用 BeatRooter 攻击、测试或枚举第三方系统。 ## 故障排除 如果 PyQt6-WebEngine 在 Linux 上无法启动，请确保系统已安装常规的 Qt/WebEngine 运行时库。 如果构建缺少图标或媒体文件，请使用以下命令重新构建： ``` make clean make build ``` 如果软件包安装失败，请在环境中更新 pip： ``` .venv/bin/python -m pip install --upgrade pip ``` 在 Windows 上： ``` .venv\Scripts\python -m pip install --upgrade pip ``` ## License PolyForm Shield 1.0.0

标签：Mutation, PyQt6, 可视化, 安全调查, 桌面应用, 漏洞挖掘, 节点编辑器, 请求拦截, 逆向工具