🎬 AI-Matrix-Clipper —— AI 智能切片引擎

中文

只需输入一个 长视频（本地文件 / B站链接 / YouTube 链接），AI-Matrix-Clipper 就能自动完成：

🧠 AI 找爆点 — 分析字幕情绪波峰，精准定位最有可能火的高潮片段
✂️ 自动剪辑 — 裁剪 + 爆款 Hook 片头拼接 + 字幕烧录，全自动
🎨 自动做封面 — 情绪色大字报封面，一键生成
📝 自动写标题 — Hook 金句 + 平台调性标题 + 标签，全套元数据
🚀 一键上传 — B站扫码登录，自动排期发布

零剪辑经验，让长视频变爆款切片，一行命令的事！

🖥️ 截图预览

📋 最近更新

✅ 2026-06-07: Prompt 降级兼容 — 开源版自动检测 prompt 结构，新/旧版本无缝切换
✅ 2026-06-07: 可选 AI provider 崩溃修复 — API Key 缺失时优雅降级，不再崩溃
✅ 2026-06-07: 全链路日志用户视角重写 — 每个步骤清晰解释在做什么、有什么进展
✅ 2026-06-07: macOS 自动硬件编码 — h264_videotoolbox 比软编快 5-10 倍
✅ 2026-06-06: config.json 自动化补丁 — enable_stage2_merge、B-Roll 空镜头配置块
✅ 2026-06-06: Whisper 自动适配 — 有 GPU 用 GPU，无 GPU 用 CPU，零配置
✅ 2026-06-05: Stage 2A+2B 合并开关 — 节约一次 LLM API 往返，成本降低 30%
✅ 2026-06-04: Hook Radar 前置引擎 — 物理情绪扫描 + AI 精选黄金开场时刻
✅ 2026-06-03: 字幕呼吸间隔切段 — 按标点智能分句，多段小字幕依次呈现
✅ 2026-06-02: 情绪彩色字幕 + 动画特效 — 关键词规则判定，零额外 AI 成本
✅ 2026-06-01: 繁简转换开关 — 自动繁体转简体，config.json 一键开关

✨ 功能亮点

✅ AI 找爆点 — 不是平均切，是根据情绪波峰、冲突、高潮找真正能火的那几段
✅ Hook 片头拼接 — 每个切片自动提炼黄金 Hook，拼接到片头提升留存
✅ 智能封面 — 五情绪色（冲突红/搞钱绿/认知青/危机橙/颠覆紫），大字报风格
✅ 字幕渲染 — 中英双语字幕，情绪彩色 + 动画特效，呼吸间隔智能分句
✅ 防封混淆 — 变速 + 微缩放 + 亮度对比度微调，降低搬运查重判定
✅ 违禁词消音 — 检测到敏感词自动哔声屏蔽，安全发布
✅ 纯文本模式 — 只看 AI 产出不渲染视频，快速验证
✅ 缓存复用 — 同一视频二次处理秒级完成，不重复烧钱
✅ macOS 硬件加速 — 自动启用 VideoToolbox 编码，比软编快 5-10 倍

📊 视频处理流程

长视频（本地 / B站 / YouTube）
        │
        ▼
  ┌─────────────────────┐
  │ ① 音频提取 + 语音识别 │  ← Whisper 转写，情绪节奏分析，视觉活跃度扫描
  └─────────┬───────────┘
            │
            ▼
  ┌─────────────────────┐
  │ ② AI 协同分析        │  ← DeepSeek 找情绪波峰 → 提炼 Hook 金句 → 合规检查
  └─────────┬───────────┘
            │
            ▼
  ┌─────────────────────┐
  │ ③ 智能剪辑          │  ← 裁剪 + Hook 片头拼接 + 防封混淆
  └─────────┬───────────┘
            │
            ▼
  ┌─────────────────────┐
  │ ④ 字幕烧录 + 封面    │  ← 双语字幕渲染 + 大字报封面生成
  └─────────┬───────────┘
            │
            ▼
  ┌─────────────────────┐
  │ ⑤ B站一键上传       │  ← 扫码登录，自动排期发布
  └─────────────────────┘

🎬 视频示例

B站

视频	说明
示例切片	长视频 → AI 自动切片效果

视频号

视频	说明
示例切片	长视频 → AI 自动切片效果

抖音

视频	说明
示例切片	长视频 → AI 自动切片效果

💡 提示：以上视频均由 AI 自动从长视频中找出爆点片段、自动剪辑、自动生成封面和标题。无需任何剪辑经验！

🚀 快速开始

前置环境依赖

Python 3.10+
ffmpeg

# macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt update && sudo apt install ffmpeg

# Windows
# 前往 https://ffmpeg.org 下载，将 bin 目录加入 PATH

验证安装：ffmpeg -version

第一步：克隆项目

git clone https://github.com/hrobrty/AI-Matrix-Clipper.git
cd AI-Matrix-Clipper

第二步：安装依赖

conda create -n video_clipper python=3.10 -y
conda activate video_clipper
pip install -r requirements.txt

启动时会自动检测 conda 环境和依赖版本，不一致会有提醒。

第三步：配置 API Key

cp .env.example .env

编辑 .env，填入 DeepSeek API Key（必填，也是唯一必需的 Key）：

DEEPSEEK_API_KEY=sk-你的key

去 platform.deepseek.com 注册，新用户送 500 万 token 免费额度。

第四步：跑起来

python video_clipper.py "你的视频.mp4"

跑完后在 videos/clips/bilibili/ 下查看成品。

💻 使用方法

切视频

# 切本地视频
python video_clipper.py "./长视频.mp4"

# 切 YouTube 视频（自动下载）
python video_clipper.py "https://www.youtube.com/watch?v=xxxxx"

# 快速验证（只切前 N 段）
python video_clipper.py "./长视频.mp4" --test 1

# 纯文本模式（不渲染视频，快速看 AI 产出）
python video_clipper.py "./长视频.mp4" --only-txt

生成封面

python generate_covers.py --dir videos/clips/bilibili

上传到 B站

# 首次使用需扫码登录，后续自动复用
python bili_uploader.py

输出文件说明

videos/clips/bilibili/
├── 01_标题_加片头.mp4    # 最终成片（裁剪 + Hook片头 + 字幕）
├── 01_标题.jpg           # 封面图
├── titles.txt            # AI 生成的标题、标签、简介
└── analysis.json         # 完整 AI 分析结果（可二次处理）

⚙️ 配置说明

.env（环境变量）

变量	说明	默认值
`DEEPSEEK_API_KEY`	DeepSeek API Key（必填）	—
`ENABLE_ANTI_BAN`	防封混淆开关	`true`
`ONLY_TXT_METADATA`	纯文本模式（不渲染视频）	`false`
`CACHE_EXPIRATION_DAYS`	缓存清理天数	`14`
`VIDEO_ENCODER`	视频编码器	Mac 自动 `h264_videotoolbox`

config.json（高级配置）

配置项	说明
`whisper`	语音转文字模型参数（model/device/compute_type）
`platform_configs.bilibili`	切片时长、Hook 时长、变速倍率
`subtitle_profiles.bilibili`	字幕字体、字号、中英双语/纯中文/纯英文
`enable_anti_ban`	防封混淆总开关
`enable_stage2_merge`	Stage 2A+2B 合并，节约一次 API 调用
`subtitle_emotion_color`	情绪彩色字幕
`subtitle_animations`	动画特效字幕
`simplify_chinese`	繁体自动转简体
`b_roll`	B-Roll 空镜头注入（需 PEXELS_API_KEY）

❓ 常见问题

Q: 只需要配 DeepSeek 一个 Key 就能跑吗？

是的。 DeepSeek 单模型即可跑通全流程：找爆点 → 写 Hook → 合规检查 → 生成封面文案。新用户有免费额度。

Q: 切一个 1 小时的视频要多久？花多少钱？

以 1 小时视频切出 3 条切片为例：

阶段	耗时	说明
语音识别	1-3 分钟	Whisper small 模型，Mac 用 CPU，NVIDIA 用 GPU
AI 分析	2-5 分钟	DeepSeek 单模型全链路
视频渲染	3-8 分钟	Mac 硬件编码快 5-10 倍
总计	6-16 分钟	约消耗 DeepSeek ￥0.8-1.5

Q: 视频存在哪？

原始视频放在 videos/ 下，切片输出在 videos/clips/bilibili/ 下。

Q: Mac 上好慢怎么办？

确认 config.json 中 video_encoder 为 h264_videotoolbox（硬件编码，比 libx264 软编快 5-10 倍）。启动时会自动检测并设置。

Q: 支持 Windows 吗？

完全支持。核心功能（切片、封面、AI 分析）跨平台兼容。B站上传器需额外安装 Playwright：

pip install playwright
python -m playwright install chromium

Q: 怎么调整封面风格？

编辑 prompts/bilibili/ 目录下的模板文件，改完即生效，不用改代码。

Q: 怎么控制切片时长和数量？

编辑 config.json 中的 platform_configs.bilibili：

seg_min / seg_max — 切片最短/最长时长（秒）
hook_min / hook_max — 片头 Hook 最短/最长时长（秒）

🤝 参考项目

本项目完全从零构建，无参考其他开源项目。

💬 社区交流

微信群 — 扫码加入
Discord — 加入 Discord 社区

📢 反馈与支持

🐛 遇到问题 → 提交 Issue
💡 功能建议 → 提交 Feature Request
⭐ 如果觉得好用 → 点个 Star 支持一下

📝 许可证

🔒 OmniMatrix-Pro 完整版

此仓库为 AI-Matrix-Clipper 开源版（命令行工具，B站，DeepSeek 单模型）。

如需以下能力，请使用完整版 OmniMatrix-Pro：

功能	开源版	Pro 完整版
B站切片 + 上传	✅	✅
抖音切片 + 上传	❌	✅
视频号切片 + 上传	❌	✅
AI 模型	DeepSeek 单模型	DeepSeek + Qwen + Poe/Claude + GPT-4o
封面	截图大字报	五情绪色 × 四版式 × AI 生图
播放数据拉取	❌	✅ 三平台数据飞轮
A/B 测试优化	❌	✅ MVT 多变量正交测试
声纹去重	❌	✅
Gradio GUI	❌	✅
云端策略	❌	✅ 话题极化 + 焦点品类自动同步
安全盾	❌	✅ RSA 签名 + 设备锁 + 防篡改
运营等级	Tier 1 固定	Tier 1/2/3 一键切换

👉 Pro 完整版获取方式：GitHub Releases

⭐ Star History

_{Built with ❤️ by hrobrty}

Name		Name	Last commit message	Last commit date
analytics		analytics
core		core
docs		docs
fonts		fonts
llm		llm
prompts		prompts
rendering		rendering
resources		resources
utils		utils
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
add_hooks_to_clips.py		add_hooks_to_clips.py
bili_fetch_analytics.py		bili_fetch_analytics.py
bili_uploader.py		bili_uploader.py
config.json		config.json
fetch_scheduler.py		fetch_scheduler.py
generate_covers.py		generate_covers.py
healing_report.py		healing_report.py
mkdocs.yml		mkdocs.yml
requirements.txt		requirements.txt
video_clipper.py		video_clipper.py

Latest commit

History

Folders and files

Repository files navigation