弧迹 (Huji)

智能视频剪辑：自动识别乒乓球、羽毛球比赛并剪辑精彩片段

English • 概述 • 主要功能 • 项目结构 • 快速开始 • 社区 • License

概述

弧迹是一个智能视频剪辑 Android 应用，它用于自动检测乒乓球、羽毛球比赛中的精彩回合，去除捡球等冗余片段，输出精简的比赛集锦。。

主要功能

• 比赛视频剪辑：已有视频剪辑 / 边拍边剪辑
• 自动剪辑配置与执行：云端或本地检测、上传、流式剪辑进度
• 边拍边剪辑：录制同时实时检测回合并生成剪辑
• 回合剪辑编辑：多片段预览、拖拽排序、增删改回合、导出清晰度与保存
• 回合选择弹窗：从检测结果中勾选要保留的回合
• 剪辑后编辑：对生成视频片段做基础编辑（简单的剪映功能）
• 视频列表：Feed/列表切换、筛选、入口到个人与设置
• 任务与记录：本地剪辑任务 Tab、视频记录 Tab、任务进度弹窗、跳转回合编辑
• 视频剪辑进度：单任务进度展示与覆盖层
• 视频记录详情：单条记录详情

已经支持的视频类型

• 乒乓球比赛视频
• 羽毛球比赛视频

剪辑速度

PC(4050):

• 算法侧：16分钟视频剪辑耗时：69.53s

Android(未统计):

项目结构

子项目	技术栈	说明
huji-app	Flutter	弧迹客户端，提供视频选择、智能剪辑、片段编辑、任务管理等功能
huji-algorithm	Python	算法服务（Git 子模块），负责乒乓球/羽毛球比赛检测与自动剪辑

huji-algorithm 以 Git 子模块方式引入，仓库地址：hhoao/huji-algorithm。

快速开始

克隆仓库

首次克隆需同时拉取子模块：

git clone --recurse-submodules https://github.com/hhoao/huji.git

若已克隆主仓库，可初始化子模块：

git submodule update --init --recursive

桌面 Linux 依赖

sudo apt-get install -y libasound2-dev libmpv-dev mpv

huji-app（客户端）

cd huji-app
flutter pub get
flutter run

huji-algorithm（Python 端）

进入子模块目录：cd huji-algorithm

本地快速剪辑（推荐）

Linux / macOS

./setup.sh
source .venv/bin/activate

python main.py --video-path videos/demo.mp4 --sport ping_pong
python main.py -v src/resources/video/examples/test.mp4 --sport badminton --match-type doubles

Windows（PowerShell）

.\setup.ps1
.venv\Scripts\activate

python main.py --video-path videos\demo.mp4 --sport ping_pong

需预先安装 FFmpeg 并加入 PATH。更多 Windows 说明见 huji-algorithm/README.md。

服务模式（Kafka + HTTP）

cd docker/dev && docker compose up -d
python main.py --serve

常用 CLI 参数：

参数	说明
--video-path / -v	本地视频文件路径
--sport	ping_pong 或 badminton
--match-type	羽毛球：singles（默认）/ doubles
--output-dir / -o	输出目录（覆盖配置）
--serve	启动 Kafka + HTTP 服务
--train	训练模型

更多说明见 huji-algorithm/README.md。

社区

• QQ 群：112856301
• Discord：加入群组

License

Apache License 2.0