爆款扫描

爆款扫描是一个面向内容创作者的开源工作台：集中跟踪抖音和小红书创作者，同步作品与互动数据，通过爆发倍数和破圈率识别现象级爆款、爆款与小爆款，并支持快速分析和深度归因。

主要能力

• 通过创作者主页链接建档，首次同步最近 40 条作品。
• 定时或手动并行更新抖音、小红书作品。
• 以创作者历史中位数计算爆发倍数，结合粉丝规模计算破圈率。
• 作品首次发现后按可配置节点复查互动数据，避免过早定级。
• 总览、信息流、创作者档案、爆款筛选与响应式移动端界面。
• 密钥可直接在系统设置页配置，由后端加密保存，不回显明文。

技术架构

• 前端：Vue 3、Vite、Pinia、Naive UI
• 后端：FastAPI、SQLite（WAL）
• 数据采集：TikHub
• 快速分析：DeepSeek
• 部署：Docker Compose、Caddy Basic Auth

本地开发

需要 Python 3.11+、Node.js 20+。

git clone <your-repository-url>
cd boom-scan

python3 -m venv .venv
source .venv/bin/activate
pip install -r backend/requirements.txt

cd frontend
npm install
npm run dev

新开一个终端启动后端：

source .venv/bin/activate
cd backend
uvicorn app.main:app --reload --host 127.0.0.1 --port 8000

访问 http://127.0.0.1:5173，进入“系统设置”配置所需密钥。

密钥配置

设置页支持配置：

• TikHub 社交平台采集密钥
• DeepSeek 快速分析密钥
• 阿里云语音识别密钥
• 深度分析工作节点令牌

页面不会读取或回显密钥。后端使用 Fernet 加密后存入 SQLite，加密主密钥保存在本地数据目录中。如果已在服务器环境变量中配置同名密钥，环境变量优先。

Docker 部署

cp .env.example .env
# 修改 APP_USER 和 APP_PASSWORD_HASH
docker compose up -d --build

默认访问 http://localhost:8080。公网部署时请将 Caddy 接入 HTTPS 域名，并保留访问认证。不要将后端端口直接暴露在公网。

测试

cd backend
python3 -m pytest tests -q

cd ../frontend
npm run build

数据与开源边界

仓库不包含任何真实账号数据、SQLite 数据库、原始 API 响应、媒体缓存、备份或密钥。这些文件都已由 .gitignore 排除。使用者需自行确保数据采集和使用方式符合平台条款与所在地法律。

许可证

MIT