Z4nzu/hackingtool：hackingtool 是一个面向安全研究人员的 Python 命令行工具，提供 185+ 安全工具的集中管理界面，通过交互式菜单、智能搜索与场本页整理它解决什么问题、适用场景、安装方式和使用方法。
hackingtool 是一个面向安全研究人员的 Python 命令行工具，提供 185+ 安全工具的集中管理界面，通过交互式菜单、智能搜索与场景推荐，简化工具发现、安装与使用流程，支持跨平台运行与 Docker 部署。
hackingtool 是一个 All-in-One 的黑客工具集，专为安全研究人员和渗透测试人员设计，旨在提供一个统一的平台来管理、发现和使用大量安全工具。项目集成了 185+ 个工具，覆盖 20 个类别（如信息收集、Web 攻击、SQL 注入、无线攻击等），通过交互式终端界面实现高效操作。用户可以在一个界面中浏览、搜索、安装和运行各类安全工具，无需记忆复杂命令或手动处理依赖。主要用途包括渗透测试、安全评估、漏洞研究和红队演练，适用于需要频繁使用多种安全工具的专业人士和爱好者。
hackingtool 解决了安全工具生态中的几个核心问题：一是工具分散，安全人员需从多个来源查找和获取工具；二是安装流程繁琐，不同工具有不同依赖和安装步骤；三是跨平台兼容性差，部分工具仅限特定操作系统。通过集中化管理界面，hackingtool 将工具分类展示，提供一键安装和状态检测；利用 OS-aware 菜单自动隐藏不兼容工具；并引入智能搜索（按 / 键）、标签过滤（按 t 键）和场景推荐（按 r 键）功能，帮助用户快速找到合适工具。此外，工具安装到用户目录避免权限问题，Docker 支持进一步简化环境配置。
主要目标用户包括渗透测试人员、安全研究人员、红队成员和网络安全爱好者。适用场景涵盖：1) 渗透测试 engagements 中快速调用扫描、枚举、漏洞利用和后期 exploitation 工具；2) 安全研究时按特定目标（如云环境、移动应用）筛选工具集；3) 批量安装和更新大量工具，节省环境搭建时间；4) 在受限或隔离环境中通过 Docker 运行工具，避免污染主机；5) 学习和实验安全工具，通过交互式界面降低入门门槛。项目支持 Linux、Kali、Parrot 和 macOS，满足不同工作环境需求。
hackingtool 的安装方式多样：首选一键安装脚本，在终端执行 curl -sSL https://raw.githubusercontent.com/Z4nzu/hackingtool/master/install.sh | sudo bash，脚本会自动检查系统依赖并安装必要组件；支持 Docker 部署，使用 Dockerfile 或 docker-compose.yml 构建本地镜像，避免使用未验证的外部镜像；也可手动克隆仓库后运行 hackingtool.py，但需确保 Python 3.10+ 环境并安装 rich 库（pip install -r requirements.txt）。工具默认安装到用户目录 ~/.hackingtool/tools/，无需 root 权限。系统依赖如 boxes、lolcat 等需通过 apt 或 brew 单独安装，具体列表见 install.py。
运行 hackingtool.py 启动交互式主菜单，通过键盘快捷键操作：按 / 键打开搜索框，输入关键词可匹配工具名称、描述或标签；按 t 键进入标签过滤，从 19 个标签（如 osint、web、c2、cloud、mobile）中选择；按 r 键输入自然语言描述（如“我想扫描网络”）获取推荐工具列表；在分类菜单中按 97 批量安装该类别所有工具；按 99 返回上级菜单，? 显示帮助，q 退出程序。每个工具旁显示安装状态（✔/✘），并可选择“Open folder”直接进入工具目录。所有操作均通过 rich 库提供彩色输出和表格展示，体验统一。
项目采用模块化架构：core.py 定义 HackingTool（工具元数据）和 HackingToolsCollection（分类集合）类；hackingtool.py 作为主入口，聚合所有工具集合并实现菜单循环；tools/ 目录包含 15 个模块，每个模块定义具体工具实例并注册到集合；tool_manager.py 处理工具安装、状态检测和更新逻辑（自动识别 git pull、pip upgrade 或 go install）；os_detect.py 负责操作系统检测以过滤不兼容工具。README 由 generate_readme.py 动态生成，基于 README_template.md 和工具集合结构。整体设计注重可维护性，如修复了 os.chdir() 导致的安装路径错误，并移除所有 Python 2 代码以确保现代 Python 环境兼容。
hackingtool 是一个 All-in-One 的黑客工具集，为安全研究人员提供 185+ 安全工具的集中管理界面。主要功能包括交互式菜单浏览、实时搜索（按 / 键）、标签过滤（按 t 键）、场景推荐（按 r 键）、批量安装（按 97 键）、安装状态显示和 Docker 支持，旨在简化工具发现、安装与使用流程。
推荐使用一键安装脚本：在终端执行 curl -sSL https://raw.githubusercontent.com/Z4nzu/hackingtool/master/install.sh | sudo bash，脚本会自动处理系统依赖和工具安装。 alternatively，可使用 Docker 构建本地镜像（基于 Dockerfile 或 docker-compose.yml），或手动克隆仓库后确保 Python 3.10+ 环境并安装 rich 库（pip install -r requirements.txt）后运行 hackingtool.py。
项目支持 Linux、Kali、Parrot 和 macOS。具备 OS-aware 菜单功能，会自动检测当前操作系统并隐藏不兼容工具（例如 Linux 专属工具在 macOS 上不会显示），确保用户体验一致。工具默认安装到用户目录 ~/.hackingtool/tools/，无需 root 权限，减少系统权限问题。
在主菜单按 / 键打开搜索框，输入关键词可匹配工具名称、描述或标签；按 t 键进入标签过滤界面，从 19 个预设标签（如 osint、web、cloud、mobile）中选择感兴趣的方向；按 r 键输入自然语言描述（如“我想扫描网络”或“需要云安全评估”），系统会推荐相关工具列表。这些功能结合使用可大幅提高工具查找效率。
每个工具在菜单中显示安装状态（✔ 表示已安装，✘ 表示未安装）。选择工具后可执行“Install”进行安装，或“Update”进行更新——更新逻辑智能识别工具类型（git pull、pip upgrade 或 go install）。在任意分类菜单中按 97 可批量安装该类别所有未安装工具。所有工具均安装在 ~/.hackingtool/tools/ 目录下，用户可直接选择“Open folder”进入工具目录进行手动检查或操作。