抖音视频违规检测桌面应用

面向 Windows 的本地视频违规检测工具。用户上传单个本地视频后，应用会在本机完成字幕提取、音频转写、分段覆盖帧、场景变化帧与关键帧抽取，再调用云端大模型分别审核字幕和画面，最终生成详细风险报告并支持导出 PDF。

当前状态

已完成检测工作台、独立配置中心、报告页、PDF 导出和历史数据清理。

已支持多供应商大模型配置：OpenAI 兼容、硅基流动、通义、火山方舟、DeepSeek。

API Key 会加密保存到本地配置文件。

未配置大模型时，仍可执行本地规则检测、视频信息读取和抽帧。

规则维护入口位于 rules/library/，视频检测实际读取生成后的 rules/compliance-rules.json。

核心流程

上传 mp4、mov、m4v 视频。

优先读取视频内置字幕；没有字幕时调用云端语音识别。

抽取分段覆盖帧、场景变化帧和关键帧，并过滤相似画面。

字幕文本交给大模型判断违规风险。

从证据帧中精选代表画面交给多模态大模型判断画面风险。

生成包含风险等级、证据片段、风险截图、时间点、模型理由和整改建议的报告。

配置中心

配置页入口：应用右上角“配置”。

基础配置：

当前供应商

API Key

测试连接

本地保存目录

高级配置：

供应商名称

供应商类型

Base URL

字幕审核模型

画面审核模型

语音识别模型

一键清理历史视频、抽帧、字幕和报告

开发运行

npm install
npm run desktop

浏览器调试：

npm start

服务会优先使用 8080，如果被占用会自动尝试 8081-8099。

常用命令：

npm run rules:build # 手动生成检测用规则 JSON
npm test # 运行测试
npm run pack:win # 生成 Windows 免安装包

规则库

规则采用“Markdown 维护、JSON 检测”的方式：

rules/library/：本地规则库，每条规则一个 Markdown 文件，方便后续新增和维护。

rules/library/_template.md：新增规则模板。

rules/library/_sources.md：规则来源说明。

rules/compliance-rules.json：构建生成的检测用规则文件，视频检测时读取它。

新增规则流程：

复制 rules/library/_template.md。

填写规则 ID、分类、风险等级、关键词、正则规则、排除关键词、画面风险信号和整改建议。

执行规则构建命令。

构建通过后，启动项目或上传视频检测即可使用新规则。

npm run rules:build

规则能力：

支持普通关键词命中。

支持 JavaScript 正则规则。

支持排除关键词，避免误报。

支持 minKeywordMatches，可要求多个关键词同时命中。

支持画面风险信号，供多模态审核参考。

规则缺字段、ID 重复、风险等级错误或正则无效时，会阻止生成，避免错误规则进入检测流程。项目启动和 Windows 打包前都会自动生成并校验规则。

规则格式示例见 docs/规则文件格式示例.md，规则口径说明见 docs/违规检测规则.md。

部署与发布

完整部署教程见 docs/部署教程.md，覆盖运行环境、浏览器部署、Windows 桌面端打包、模型配置、验收检查和常见问题。

Windows 打包

打包前先准备内置 FFmpeg：

推荐版本：FFmpeg 8.0.1 essentials build for Windows x64

下载地址：https://www.gyan.dev/ffmpeg/builds/packages/ffmpeg-8.0.1-essentials_build.zip

解压后复制以下两个文件到项目目录：

vendor/ffmpeg/win-x64/bin/ffmpeg.exe
vendor/ffmpeg/win-x64/bin/ffprobe.exe

生成 Windows 免安装绿色版：

npm run pack:win

打包产物会输出到 release/：

release/win-unpacked/：免安装绿色版目录

release/抖音视频违规检测-0.1.0-win-x64.zip：可直接分发的压缩包

交付给其他 Windows x64 电脑时，发送 zip 或整个 win-unpacked 目录即可。目标电脑解压后运行目录中的 抖音视频违规检测.exe，不需要单独安装 Node.js、Electron、ffmpeg 或 ffprobe。