diegosouzapw WhoDis Network Scanner Skill
是一個類似 GlassWire 的 Windows 應用程式，結合了網絡掃描與本地 AI 分析功能。
📂 專案結構 (Project Structure)
src/
├── app.py # FastAPI 網頁伺服器主程式
├── scanner.py # 網路掃描（ARP + Port 掃描 + 主機名稱解析）
├── analyzer.py # AI 分析模組（Ollama 串流）
├── database.py # SQLite 掃描歷史存儲
└── static/ # 前端頁面（HTML/CSS/JS）
核心模組
src/scanner.py:- ARP 協定掃描區域網絡
- TCP Port 掃描（深度掃描模式）
- DNS 反查 + NetBIOS 主機名稱解析
- MAC Address 廠商識別
src/analyzer.py:- 介接本地 Ollama AI 模型
- 串流模式 (SSE) 回傳分析結果
- 繁體中文風險評估報告
src/database.py:- SQLite 資料庫管理
- 掃描歷史 CRUD 操作
src/app.py:- FastAPI 網頁伺服器
- RESTful API 端點
- 自動開啟瀏覽器
🚀 使用指令 (Usage)
# 請確保終端機具有管理員權限
conda activate whodis
python src/app.py
瀏覽器自動開啟 http://localhost:8000
🔌 API 端點
| 端點 | 方法 | 說明 |
|---|---|---|
/ |
GET | 首頁 |
/api/scan |
POST | 執行掃描 ({deep_scan: bool}) |
/api/analyze |
POST | AI 分析 (SSE 串流) |
/api/history |
GET | 掃描歷史 |
⚠️ 疑難排解 (Troubleshooting)
- Scapy/Permission Error: 確認是否已安裝 Npcap 並以管理員身分執行
- AI 無回應: 檢查 Ollama 是否在
http://localhost:11434正常運作 - Port 8000 被佔用: 修改
app.py中的 port 參數