Roysaab0786/CYBER_SHARK

# 🦈 CYBER SHARK - Kali Linux 版 支持语音控制的 AI 驱动网络安全助手 **B.Tech IT 毕业设计项目 — GNDEC Ludhiana** ## 功能特性 - 6 大类别，集成 13 款安全工具 - 通过 OpenRouter 使用 Llama 3.3 70B 进行智能命令解析与分析 - 用于渗透测试分析的红队 AI 角色 - 语音命令输入（Google Speech Recognition） - 文本转语音输出（gTTS + pygame） - 意图分类 — 区分提问与扫描命令 - 执行前进行目标验证 - TF-IDF + 模糊匹配 FAQ 系统 - 自动将安全报告保存至 `~/cyber-shark-reports/` ## 安全工具 | 类别 | 工具 | |----------|-------| | 网络扫描 | nmap | | 网络分析 | netstat | | 网络测试 | ping | | Web 扫描 | nikto, sqlmap, dirb | | OSINT | whois, dig, nslookup, theHarvester | | 密码破解 | john, hydra | | Web 测试 | curl | ## 环境要求 - Kali Linux（推荐） - Python 3.10–3.12（避免使用 3.13 — 存在 numpy 兼容性问题） - 麦克风（用于语音输入） - 网络连接（用于 gTTS + OpenRouter AI） - OpenRouter API 密钥 — 请在 https://openrouter.ai 免费获取 ## 安装说明 ``` # 安装系统依赖 sudo apt update sudo apt install -y portaudio19-dev python3-dev python3-pip \ python3-venv python3-pyaudio espeak nmap nikto sqlmap \ dirb whois dnsutils theharvester john hydra curl # 解压 rockyou 字典（hydra/john 所需） sudo gunzip /usr/share/wordlists/rockyou.txt.gz # Clone / 进入项目目录 cd ~/Desktop/cyber-shark # 创建 virtual environment python3 -m venv venv source venv/bin/activate # 安装 Python 包 pip install -r requirements.txt # 将系统 PyAudio 复制到 venv 中（避免 build 问题） cp -r /usr/lib/python3/dist-packages/pyaudio* venv/lib/python3.*/site-packages/ # 下载 NLTK 数据 python3 -c "import nltk; nltk.download('punkt')" # 配置 API key cp .env.example .env nano .env # 添加：OPENROUTER_API_KEY=your-key-here # 使 run 脚本可执行（仅需一次） chmod +x run.sh # 运行 Cyber Shark ./run.sh ``` ## .env 文件 在项目根目录下创建一个 `.env` 文件： ``` OPENROUTER_API_KEY=your-openrouter-api-key-here ``` ## 示例命令 **安全扫描** ``` scan 192.168.1.1 nmap google.com whois gndec.ac.in dirb gndec.ac.in check localhost for vulnerabilities dig google.com show network connections ping google.com ``` **信息查询**（交由 AI 处理，不执行任何工具） ``` what is nmap how does sqlmap work explain hydra what is a port scan ``` **系统命令** ``` open browser open terminal open youtube search kali linux tools close firefox ``` **退出** ``` exit / quit / bye / goodbye / shutdown ``` ## 工作原理 ``` User Input (voice or keyboard) │ ▼ handle_command() │ ├── System command? → open/close apps, search web │ ├── Security keyword detected? │ │ │ ├── classify_intent() → "info" → get_answer() → FAQ / AI Q&A │ └── classify_intent() → "action" → execute_security_task() │ │ │ is_valid_target()? │ │ │ run_security_tool() │ │ │ analyze_results_with_claude() │ │ │ save_report() │ └── No keyword → get_answer() → TF-IDF + Fuzzy FAQ match → AI fallback ``` ## 项目结构 ``` cyber-shark/ ├── cyber_shark_kali.py # Main application ├── run.sh # Launch script ├── requirements.txt # Python dependencies ├── faqs.json # FAQ database (auto-created) ├── .env # API key (not committed to git) ├── README.md └── ~/cyber-shark-reports/ # Auto-generated scan reports ``` ## 故障排除 | 问题 | 解决方案 | |-------|-----| | Python 3.13 上的 `numpy` 导入错误 | 使用 Python 3.11/3.12 或执行 `pip install --upgrade numpy` | | 语音输入无效 | 检查 `listen()` 中的麦克风 `device_index` | | gTTS 语音播放延迟 | 语音在后台线程中运行 — 属正常现象 | | 找不到 `rockyou.txt` | 执行 `sudo gunzip /usr/share/wordlists/rockyou.txt.gz` | | AI 无响应 | 检查 `.env` 中的 `OPENROUTER_API_KEY` | | `run.sh` 丢失权限 | 执行一次 `chmod +x run.sh`，或使用 `bash run.sh` | ## 作者 **Sumit Kumar** B.Tech IT — 毕业设计项目 GNDEC Ludhiana [LinkedIn](https://www.linkedin.com/in/roysaab0786) | Instagram: @roysaab0786

标签：Python, 人工智能, 实时处理, 密码管理, 插件系统, 无后门, 用户模式Hook绕过, 红队评估, 语音助手, 逆向工具