AutoClip: AI-powered video clipping and highlight generation · 一款智能高光提取与剪辑的二次创作工具
AutoClip: AI-powered video clipping and highlight generation · 一款智能高光提取与剪辑的二次创作工具
支持YouTube/B站视频下载、自动切片、智能合集生成
语言: English | 中文
联系邮箱: [email protected]
AutoClip是一个基于AI的智能视频切片处理系统，能够自动从YouTube、B站等平台下载视频，通过AI分析提取精彩片段，并智能生成合集。系统采用现代化的前后端分离架构，提供直观的Web界面和强大的后端处理能力。
联系方式: [email protected]
autoclip run video.mp4 --provider ollama 一条命令出片；内置 MCP server 与 Agent skill，Cursor / Claude 可直接调用（文档）graph TB
A[用户界面] --> B[FastAPI后端]
B --> C[Celery任务队列]
B --> D[Redis缓存]
B --> E[SQLite数据库]
C --> F[AI处理引擎]
F --> G[视频处理]
F --> H[字幕分析]
F --> I[内容理解]
B --> J[文件存储]
K[YouTube API] --> B
L[B站API] --> B
# 克隆项目
git clone https://github.com/zhouxiaoka/autoclip.git
cd autoclip
# Docker一键启动
./docker-start.sh
# 开发环境启动
./docker-start.sh dev
# 停止服务
./docker-stop.sh
# 检查服务状态
./docker-status.sh
# 克隆项目
git clone https://github.com/zhouxiaoka/autoclip.git
cd autoclip
# 一键启动（推荐，包含完整检查和监控）
./start_autoclip.sh
# 快速启动（开发环境，跳过详细检查）
./quick_start.sh
# 检查系统状态
./status_autoclip.sh
# 停止系统
./stop_autoclip.sh
pip install -r requirements.txt && pip install -e .
autoclip doctor # 检查 ffmpeg / Whisper / 模型
autoclip run talk.mp4 --provider ollama # 本地 Ollama，无需 key；产物与桌面应用共用
autoclip run talk.mp4 --srt talk.srt --json # 给脚本 / agent 用的 JSON 输出
autoclip mcp # MCP server（stdio），配到 Cursor / Claude 即可调用
Cursor ~/.cursor/mcp.json：{"mcpServers": {"autoclip": {"command": "/path/to/venv/bin/autoclip", "args": ["mcp"]}}}。
详见 docs/CLI_AND_MCP.md，Agent skill 在 skills/autoclip/SKILL.md。
…
视频下载与处理
AI智能分析
视频切片与合集
实时进度监控
B站上传功能【开发中】
字幕编辑功能【开发中】
系统会自动执行以下步骤：
创建 .env 文件：
# 数据库配置
DATABASE_URL=sqlite:///./data/autoclip.db
# Redis配置
REDIS_URL=redis://localhost:6379/0
# AI API配置
API_DASHSCOPE_API_KEY=your_dashscope_api_key
API_MODEL_NAME=qwen-plus
# 日志配置
LOG_LEVEL=INFO
ENVIRONMENT=development
DEBUG=true
# 文件存储
UPLOAD_DIR=./data/uploads
PROJECT_DIR=./data/projects
…
启动系统后访问以下地址查看API文档：
/api/v1/projects
GET
获取项目列表
/api/v1/projects
POST
创建新项目
/api/v1/projects/{id}
GET
获取项目详情
/api/v1/youtube/parse
POST
解析YouTube视频信息
/api/v1/youtube/download
POST
下载YouTube视频
/api/v1/bilibili/download
POST
下载B站视频
/api/v1/projects/{id}/process
POST
开始处理项目
/api/v1/projects/{id}/status
GET
获取处理状态
# 检查端口占用
lsof -i :8000 # 后端端口
lsof -i :3000 # 前端端口
# 停止占用进程
kill -9 <PID>
# 检查Redis状态
redis-cli ping
# 启动Redis服务
brew services start redis # macOS
systemctl start redis # Linux
pip install --upgrade yt-dlp# 查看所有日志
tail -f logs/*.log
# 查看特定服务日志
tail -f logs/backend.log # 后端日志
tail -f logs/frontend.log # 前端日志
tail -f logs/celery.log # 任务队列日志
# 详细状态检查
./status_autoclip.sh
# 手动检查服务
curl http://localhost:8000/api/v1/health/ # 后端健康检查
curl http://localhost:3000/ # 前端访问测试
redis-cli ping # Redis连接测试
# 激活虚拟环境
source venv/bin/activate
# 设置Python路径
export PYTHONPATH="${PWD}:${PYTHONPATH}"
# 启动后端开发服务器
python -m uvicorn backend.main:app --reload --port 8000
# 进入前端目录
cd frontend
# 启动开发服务器
npm run dev
# 启动Worker
celery -A backend.core.celery_app worker --loglevel=info
# 启动Beat调度器
celery -A backend.core.celery_app beat --loglevel=info
# 启动Flower监控
celery -A backend.core.celery_app flower --port=5555
数据库优化
Redis优化
Celery优化
环境变量
网络安全
数据安全
# 克隆项目
git clone https://github.com/zhouxiaoka/autoclip.git
cd autoclip
# 配置环境变量
cp env.example .env
# 编辑 .env 文件，填入必要的配置
# 启动所有服务
docker-compose up -d
# 查看服务状态
docker-compose ps
# 使用开发环境配置
docker-compose -f docker-compose.dev.yml up -d
# 实时查看日志
docker-compose -f docker-compose.dev.yml logs -f
完整的Docker部署指南请参考 DOCKER.md 文档。
# 创建systemd服务文件
sudo nano /etc/systemd/system/autoclip.service
[Unit]
Description=AutoClip Video Processing System
After=network.target redis.service
[Service]
Type=forking
User=autoclip
WorkingDirectory=/opt/autoclip
ExecStart=/opt/autoclip/start_autoclip.sh
ExecStop=/opt/autoclip/stop_autoclip.sh
Restart=always
[Install]
WantedBy=multi-user.target
我们欢迎所有形式的贡献！无论是代码贡献、文档改进、问题报告还是功能建议。
Fork 项目到您的GitHub账户
克隆您的Fork到本地：
git clone https://github.com/zhouxiaoka/autoclip.git
cd autoclip
创建功能分支：
git checkout -b feature/amazing-feature
进行开发和测试
提交更改：
git add .
git commit -m 'feat: add amazing feature'
推送分支：
git push origin feature/amazing-feature
在GitHub上创建 Pull Request
<type>(<scope>): <description>
[optional body]
[optional footer(s)]
示例：
feat(api): add video download endpointfix(ui): resolve upload modal display issuedocs(readme): update installation instructions本项目采用 MIT License 许可证。
Q: 启动时提示端口被占用怎么办？ A: 使用以下命令检查并停止占用端口的进程：
# 检查端口占用
lsof -i :8000 # 后端端口
lsof -i :3000 # 前端端口
# 停止进程
kill -9 <PID>
Q: Redis连接失败怎么办？ A: 确保Redis服务正在运行：
# 检查Redis状态
redis-cli ping
# 启动Redis服务
brew services start redis # macOS
sudo systemctl start redis-server # Linux
Q: 前端依赖安装失败怎么办？ A: 尝试清理缓存后重新安装：
cd frontend
rm -rf node_modules package-lock.json
npm cache clean --force
npm install
Q: YouTube视频下载失败怎么办？ A:
pip install --upgrade yt-dlpQ: B站视频下载失败怎么办？ A:
Q: AI处理速度慢怎么办？ A:
Q: B站上传功能什么时候可以使用？ A: B站上传功能正在开发中，预计在下一个版本中发布。该功能将支持：
Q: 字幕编辑功能什么时候可以使用？ A: 字幕编辑功能正在开发中，预计在下一个版本中发布。该功能将支持：
Q: 如何提高处理速度？ A:
Q: 如何减少存储空间占用？ A:
如有问题或建议，请通过以下方式联系：
感谢以下开源项目和服务的支持：
暂无开放 Issues，或尚未同步最近议题。