# cyberpatrol

**Repository Path**: qingpendayu/cyberpatrol

## Basic Information

- **Project Name**: cyberpatrol
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-07
- **Last Updated**: 2026-04-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CyberPatrol - 网络犯罪线索监测系统

> 🚔 一款为网警设计的自动化网络犯罪线索发现与管理系统

---

## 📋 系统功能

### 模块一：自动采集引擎
- **多平台支持**：58同城、闲鱼、贴吧、微博、小红书、转转
- **关键词库**：内置30+犯罪类别关键词，支持动态增删
- **风险评级**：自动对线索进行极高/高/中/低四级风险评分
- **定时调度**：后台自动定时采集，可配置间隔时间
- **手动触发**：支持手动触发指定平台/关键词/地区采集

### 模块二：线索管理平台
- **线索列表**：支持多维度筛选（状态/风险/平台/地区/时间）
- **状态流转**：待处理 → 已确认 → 已处理 / 误报
- **批量操作**：支持批量确认/误报
- **线索详情**：查看完整内容、命中关键词、AI置信度
- **统计看板**：实时数据可视化（趋势图/饼图/排行榜）

---

## 🚀 快速启动

### 环境要求
- Python 3.9+
- Node.js 18+

### Windows 一键启动
```powershell
.\start.ps1
```

### 手动启动

**后端：**
```bash
cd backend
pip install -r requirements.txt
python run.py
```

**前端：**
```bash
cd frontend
npm install
npm run dev
```

访问：http://localhost:5173

---

## 📁 项目结构

```
cyberpatrol/
├── backend/
│   ├── app/
│   │   ├── api/          # REST API（线索/统计/关键词/采集/设置）
│   │   ├── models/       # 数据模型（SQLAlchemy）
│   │   ├── services/     # 采集引擎服务
│   │   └── config.py     # 配置管理
│   ├── run.py            # 启动入口
│   └── requirements.txt
├── frontend/
│   ├── src/
│   │   ├── api/          # API请求封装
│   │   ├── views/        # 页面组件
│   │   └── router/       # 路由配置
│   └── package.json
├── .env                  # 环境变量
└── start.ps1             # 一键启动脚本
```

---

## ⚙️ 配置说明

复制 `.env.example` 为 `.env` 并修改：

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| FLASK_PORT | 后端端口 | 5050 |
| CRAWLER_INTERVAL | 采集间隔（秒） | 60 |
| CRAWLER_MAX_PER_RUN | 单次最大采集数 | 20 |
| LLM_API_KEY | AI研判API Key（可选） | 空 |

---

## 🔌 生产环境爬虫对接

当前为**模拟采集模式**，替换 `backend/app/services/crawler_engine.py` 中的 `fetch_from_platform` 方法为真实爬虫逻辑：

```python
def fetch_from_platform(self, platform, keyword, region, max_count):
    if platform == "58同城":
        # 替换为真实Scrapy/Playwright爬虫
        return real_58_crawler(keyword, region, max_count)
    elif platform == "闲鱼":
        return real_xianyu_crawler(keyword, region, max_count)
    # ...
```

---

## ⚖️ 法律声明

**本系统仅供执法机关工作人员合法使用。**

- 遵守《网络安全法》《个人信息保护法》《数据安全法》
- 禁止侵犯公民隐私
- 所有采集行为须在授权范围内
- 敏感数据需加密存储，访问需审批留痕