# 检查违规

**Repository Path**: zouzhou4747/detecting-violations

## Basic Information

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

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-19
- **Last Updated**: 2026-07-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 主播违规检测助手

桌面端辅助工具，帮助抖音直播公会运营人员排查主播小号。

## 技术栈

| 层 | 技术 |
|---|------|
| 桌面壳 | Electron + bun |
| 前端 | React + TypeScript + Vite + Mantine v7 |
| 后端 | Python FastAPI + uv |
| 搜索/抓取 | Firecrawl API |
| AI 分析 | DeepSeek V3 |
| 数据库 | SQLite |

## 快速开始

### 前置条件

- Python 3.11+ + [uv](https://docs.astral.sh/uv/)
- [bun](https://bun.sh/)
- Firecrawl API Key（注册 https://firecrawl.dev）
- DeepSeek API Key

### 安装

```bash
# 1. 克隆项目
git clone https://gitee.com/zouzhou4747/detecting-violations.git
cd detecting-violations

# 2. 安装后端依赖
cd backend && uv sync && cd ..

# 3. 安装前端依赖
cd frontend && bun install && cd ..

# 4. 安装 Electron
bun install

# 5. 配置 API Key（在 backend/.env）
echo "DEEPSEEK_API_KEY=你的key" > backend/.env
echo "FIRECRAWL_API_KEY=你的key" >> backend/.env
```

### 启动

```bash
# 终端 1：启动后端
cd backend && uv run uvicorn main:app --host 127.0.0.1 --port 18080

# 终端 2：启动前端
cd frontend && bun run dev

# 终端 3（可选）：启动桌面应用
bun run start
```

## 功能

- **一键排查** — 输入抖音链接/昵称 → 自动抓取画像 + 搜索候选 + AI 逐项比对 → 输出报告
- **比对历史** — 查看历史排查记录，修改判定结果
- **报告导出** — CSV 表格 + HTML 网页报告

## 项目结构

```
├── backend/              # Python FastAPI 后端
│   ├── main.py           # API 路由
│   ├── firecrawl_utils.py # Firecrawl 搜索+抓取+提取
│   ├── crawler.py        # MediaCrawler 子进程（fallback）
│   ├── llm.py            # DeepSeek 对比分析
│   ├── database.py       # SQLite 数据层
│   ├── models.py         # Pydantic 模型
│   └── tests/            # 单元测试
├── frontend/             # React 前端
│   └── src/pages/        # 页面组件
│       ├── Investigate.tsx  # 一键排查
│       └── History.tsx      # 比对历史
├── electron/             # Electron 桌面壳
├── docs/                 # 设计文档
└── documentation/        # 系统文档
```

## API 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/api/resolve` | 解析输入（链接/ID/昵称） |
| GET | `/api/investigate?url=...` | SSE 一键排查流水线 |
| POST | `/api/investigate/{id}/export` | 导出 CSV/HTML 报告 |
| GET | `/api/investigations` | 排查历史列表 |
| GET | `/api/investigate/{id}/results` | 排查结果详情 |
| PATCH | `/api/investigation-results/{id}` | 修改判定 |
| POST | `/api/compare` | 手动 LLM 比对 |
| GET | `/api/comparisons` | 比对历史 |

## 运行测试

```bash
cd backend && uv run pytest tests/ -v
```