Skip to content
Back to search

livestream-clip-editor

把直播录屏剪成约1分钟、提速、精华拼接(jump-cut)、以双逼单收尾的带货短视频;不加字幕不加BGM。当用户给出直播录频/录屏原片要求做切片带货、高光拼接、精华剪辑、按参考成品重剪、或要求钩子开头+双逼单结尾的短视频时使用。内置FFmpeg工业级去重与x264比特流SEI脱敏。也用于反推参考成品的剪辑参数(语速/切点/响度)。触发词:直播录屏、切片、带货、精华拼接、高光、逼单、双逼单、jump-cut、重剪、约1分钟。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/avisii1680769-cell--livestream-clip-editor/badge.svg)](/listings/avisii1680769-cell--livestream-clip-editor)

HTML

<a href="/listings/avisii1680769-cell--livestream-clip-editor"><img src="/api/listings/avisii1680769-cell--livestream-clip-editor/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 50 lines
  1. ---
  2. name: livestream-clip-editor
  3. description: 把直播录屏剪成约1分钟、提速、精华拼接(jump-cut)、以双逼单收尾的带货短视频;不加字幕不加BGM。当用户给出直播录频/录屏原片要求做切片带货、高光拼接、精华剪辑、按参考成品重剪、或要求钩子开头+双逼单结尾的短视频时使用。内置FFmpeg工业级去重与x264比特流SEI脱敏。也用于反推参考成品的剪辑参数(语速/切点/响度)。触发词:直播录屏、切片、带货、精华拼接、高光、逼单、双逼单、jump-cut、重剪、约1分钟。
  4. ---
  5. # 直播切片精华拼接剪辑器
  6. 把冗长直播录屏剪成 ~60s、节奏明快、**钩子开头 → 卖点精华 → 双逼单收尾**的带货短视频。
  7. 手法 = 切片拼接(句间硬切去气口)+ 整体提速(默认 1.25x,不变调)+ 响度归一/限幅 + 比特流SEI脱敏。**不加字幕、不加 BGM**。
  8. ## 何时用
  9. - 用户给直播录屏原片,要切片带货 / 高光 / 精华拼接 / 约1分钟短视频。
  10. - 用户给一个「参考成品」要求按它的风格重剪原片。
  11. - 用户明确要求逼单收尾、双逼单、提速、不要字幕/BGM。
  12. ## 流程(按序执行,细节见 references/editing-recipe.md)
  13. 1. **确认需求**:目标时长(默认 55–75s)、提速倍率(默认 1.25)、是否字幕/BGM(默认都不加)、
  14. 收尾必须逼单且末帧为强 CTA 画面、输出目录/文件名。缺这些信息才问,否则用默认值直接做。
  15. 2. **勘察**:`scripts/probe_media.py <片>` 拿时长/气口/说话占比/响度;有参考片也 probe 它反推参数。
  16. `scripts/contact_sheet.py <片> sheet.jpg --interval 10` 生成联系表,用 Read 看,标记钩子/卖点/逼单/好姿态段落。
  17. 3. **转写**:`scripts/transcribe.py <原片> transcript --model small --outdir .` 得句级时间戳 json+txt 与字/秒语速。
  18. 4. **选句写 EDL**(人工判断,最关键):读 transcript.txt,按 钩子→卖点→双逼单收尾 挑完整句子块,
  19. 去废话/气口/跑题;结尾建议安排【双逼单环节】(环节1价格库存催促 + 环节2立即抢拍压轴);把正脸直视镜头/手持产品的强CTA逼单句放 EDL 末尾。存 `edl.json`。
  20. 总原始时长 ≈ 目标 × 倍率。
  21. 5. **渲染**:`scripts/render_edit.py --src <原片> --edl edl.json --out 成品.mp4 --speed 1.25 --crf 19 [--dedup] [--jitter]`。
  22. 内部:trim/atrim 每块 → concat 硬拼 → PTS强制重映射 → setpts/atempo 提速 → [可选 --dedup 深度去重链:2%微裁切放大+直方图微扰+服饰保真锐化+时域动态微噪点(alls=2)+三段人声EQ] → loudnorm+alimiter → 边缘淡入淡出 → x264 SEI物理剥离 + stream级encoder脱敏 + brand mp42 容器伪装。
  23. 6. **校验**:`scripts/verify_output.py 成品.mp4 --target-min 55 --target-max 75 --sheet fin_sheet.jpg`。
  24. 全 PASS 才交付(内置底层二进制扫描 SEI/Lavf/Lavc,任何指纹残留即判定 FAIL);用 Read 看 fin_sheet.jpg 确认末帧是逼单强 CTA 正脸。末帧弱 → 回第 4 步挪块重渲染。
  25. 7. **交付**:成品放用户指定目录;按需附 edl.json / transcript.txt / 联系表 / 一句话清单。
  26. ## 脚本(scripts/,均 argparse、简洁 stdout、出错打印 ERROR 不抛栈)
  27. - `probe_media.py <video> [--silence-db -32] [--silence-d 0.35] [--scene 0.12]` → JSON:时长/编码/气口/说话占比/切点/响度。
  28. - `transcribe.py <media> <tag> [--model small] [--outdir .]` → `<tag>.json/.txt` + 字/秒;内置 Windows/中国网络修复。
  29. - `contact_sheet.py <video> <out.jpg> [--interval 10] [--cols 7] [--cell-w 156]` → 带 mm:ss 标签联系表。
  30. - `render_edit.py --src --edl --out [--speed 1.25] [--crf 19] [--dedup] [--jitter]` → 拼接提速+工业级防同质化去重+矩阵随机微抖动+bitexact元数据清洗。
  31. - `verify_output.py <video> [--target-min 55] [--target-max 75] [--sheet out.jpg] [--sheet-interval 6]` → 逐项 PASS/FAIL。
  32. ## 参考(references/)
  33. - `editing-recipe.md`:完整配方、filter_complex 链路、选句原则、本案例 17 块实际 EDL 表。
  34. - `dedup-algorithm-guide.md`:防搬运/防同质化算法级去重实操指南(剪映8步手工映射为FFmpeg代码链路)。
  35. - `windows-cn-pitfalls.md`:依赖镜像、代理/HF/av/CUDA/线程/路径/削波/GBK/别名等 11 类坑与修复。
  36. ## 环境要求
  37. ffmpeg+ffprobe 在 PATH;Python 带 `faster-whisper pillow numpy`(清华镜像安装);纯 CPU 即可(int8)。
  38. 运行 python 设 `PYTHONIOENCODING=utf-8`;传给 ffmpeg 的路径用 `C:/...` 正斜杠形式。
README.md · README · 181 lines
  1. <div align="center">
  2. # 🎬 livestream-clip-editor
  3. ### 电商直播切片短视频 · 本地剪辑引擎 & AI Agent Skill
  4. **句级拼接 · 1.25x 提速 · EDL 人工选段 · 可选画面/音频微调 · 本地质检**
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  6. [![Python](https://img.shields.io/badge/Python-3.10%2B-green.svg)](https://www.python.org/)
  7. [![FFmpeg](https://img.shields.io/badge/FFmpeg-4.4%2B-red.svg)](https://ffmpeg.org/)
  8. [![Claude Code](https://img.shields.io/badge/Claude%20Code-Skill%20Ready-purple.svg)](https://claude.ai/code)
  9. [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)]()
  10. [English Documentation](README_EN.md) · [报告 Bug / 提交建议](https://github.com/avisii1680769-cell/livestream-clip-editor/issues)
  11. <p align="center">
  12. <img src="assets/demo.gif" width="260" alt="Livestream Clip Editor Demo" /><br>
  13. <sub>本地视频处理 · 句级拼接 · 1.25x 原声变速 · EDL 人工选段 · 输出技术质检</sub>
  14. </p>
  15. </div>
  16. ---
  17. ## 💡 为什么需要本项目?
  18. 在抖音、快手、视频号等短视频平台进行**直播切片带货**时,传统剪辑面临四大核心痛点:
  19. 1. **极其耗时**:剪映手动抽帧、微调位置、加画中画、去气口,制作一条 1 分钟切片耗费 20~30 分钟;
  20. 2. **色差客诉**:去重教程盲目套用复古/滤镜,导致服饰/美妆产品严重偏色,买家收到实物差评退款;
  21. 3. **素材流程分散**:探测、转写、选段、渲染与检查往往需要在多个工具和命令之间切换;
  22. 4. **成片质量依赖人工复核**:剪辑点、商品颜色、话术准确性和片尾画面都需要回看确认。
  23. `livestream-clip-editor` 将这些步骤整理为本地 CLI 流程,并提供本地 Gradio 工作台,减少重复操作。选句和最终画面仍由操作者决定。
  24. ---
  25. ## 🌟 核心特性
  26. | 模块 | 核心功能 | 解决痛点 |
  27. | :--- | :--- | :--- |
  28. | ✂️ **跳剪拼接 (Jump-Cut)** | 参考 faster-whisper 句级时间戳编排所选区间,按 EDL 顺序硬切拼接 | 减少片段间不需要的内容 |
  29. | ⚡ **明快节奏 (1.25x不变调)** | `setpts` 与 `atempo` 协同变速,语速紧凑有力,人声音调绝对保真 | 说话无感染力、语速慢 |
  30. | 🎯 **EDL 片段编排** | 按用户指定顺序拼接片段;操作者可将促单段落放在结尾 | 减少重复命令与手工拼接 |
  31. | 🎨 **可选画面/音频微调 (`--dedup`)** | 微裁切缩放、轻度 EQ、锐化与动态噪点;会改变画面和声音 | 为剪辑提供额外处理选项,结果需人工检查 |
  32. | 🧾 **部分元数据清理** | 清理部分容器/流级标签并设置 MP4 brand | 便于管理导出文件的元数据;不代表匿名或平台审核保证 |
  33. | 🔍 **技术质检** | 检查时长、编码、黑帧、音频峰值及若干元数据/字串 | 快速发现脚本覆盖的技术问题;内容仍需人工复核 |
  34. ---
  35. ## 🔄 自动化处理全流程
  36. ```
  37. [直播录屏原片 (1~4小时)]
  38. │
  39. ▼ 步骤 1:原片勘察 (probe_media.py & contact_sheet.py)
  40. [说话占比 / 切点分析 / 视觉联系表 (mm:ss网格图)]
  41. │
  42. ▼ 步骤 2:中文智能转写 (transcribe.py - Whisper int8)
  43. [句级带标点时间戳 JSON / TXT]
  44. │
  45. ▼ 步骤 3:高转化选句 (EDL 决策表)
  46. [钩子 (0-10s) ➔ 卖点精华 (10-45s) ➔ 双逼单压轴 (45-65s)]
  47. │
  48. ▼ 步骤 4:工业级渲染引擎 (render_edit.py --dedup --jitter)
  49. ┌────────────────────────────────────────────────────────┐
  50. │ 视频链: PTS强制重映射 ➔ 1.25x ➔ 2%微裁切 ➔ eq直方图微扰 │
  51. │ ➔ 面料锐化 ➔ 时域动态微噪点 ➔ 边缘淡入淡出 │
  52. │ 音频链: PTS重映射 ➔ atempo ➔ 三段EQ ➔ 响度归一化 │
  53. │ ➔ alimiter防削波 ➔ 边缘音频淡出 │
  54. │ 脱敏链: -x264-params info=0 ➔ -bsf remove_types=6 │
  55. │ ➔ stream encoder清除 ➔ -brand mp42 伪装 │
  56. └────────────────────────────────────────────────────────┘
  57. │
  58. ▼ 步骤 5:技术质检 (verify_output.py)
  59. [时长/编码/黑帧/峰值/指定元数据字串检查] ➔ 人工复核内容与画面
  60. ```
  61. ---
  62. ## 🚀 极速上手
  63. ### 1. 环境准备
  64. - 确保系统安装了 `ffmpeg` 和 `ffprobe` 并位于 PATH 路径中。
  65. - 安装 Python 依赖(推荐清华镜像):
  66. ```bash
  67. pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt
  68. ```
  69. ### 2. 启动本地 WebUI(Windows)
  70. 双击项目根目录的 `start_webui.bat`。首次运行会创建 `.venv` 并安装依赖,之后会在本机打开 `http://127.0.0.1:7860`。
  71. 也可以手动启动:
  72. ```bash
  73. python -m venv .venv
  74. .venv/Scripts/python -m pip install -r requirements.txt
  75. .venv/Scripts/python app.py
  76. ```
  77. WebUI 只绑定本机地址,不开启 Gradio 公开分享。处理大文件时推荐填写本机视频路径;文件选择模式会将文件通过 localhost 传给本机界面进程并写入临时缓存。首次转写会下载所选 Whisper 模型。使用前需先安装 `ffmpeg` 和 `ffprobe` 并加入 PATH。
  78. ### 3. 命令行五步剪出成品
  79. #### ① 勘察素材
  80. ```bash
  81. python scripts/probe_media.py input.mp4
  82. python scripts/contact_sheet.py input.mp4 sheet.jpg --interval 10
  83. ```
  84. #### ② 语音转写
  85. ```bash
  86. python scripts/transcribe.py input.mp4 trans --model small --outdir .
  87. ```
  88. #### ③ 制定 EDL 剪辑决策表 (`edl.json`)
  89. 参考 `examples/sample_edl.json`:
  90. ```json
  91. {
  92. "name": "带货切片_双逼单模板",
  93. "speed": 1.25,
  94. "dedup": true,
  95. "edl": [
  96. [108.76, 118.02],
  97. [129.28, 142.37],
  98. [296.34, 300.34],
  99. [379.17, 382.17]
  100. ]
  101. }
  102. ```
  103. #### ④ 一键工业级渲染
  104. ```bash
  105. python scripts/render_edit.py \
  106. --src input.mp4 \
  107. --edl edl.json \
  108. --out output.mp4 \
  109. --speed 1.25 \
  110. --crf 19 \
  111. --dedup \
  112. --jitter
  113. ```
  114. #### ⑤ 自动化质检验收
  115. ```bash
  116. python scripts/verify_output.py output.mp4 --target-min 55 --target-max 75 --sheet verify_sheet.jpg
  117. ```
  118. 全部技术检查通过后,仍需人工复核话术、商品呈色和末尾画面,并确认素材授权及平台规则。该脚本只检查列出的媒体属性与部分元数据,不保证平台审核或推荐结果。
  119. ---
  120. ## 🤖 在 AI Agent 中作为 Skill 调用
  121. 本仓库天然遵循 Agent Skill 规范,开箱即用:
  122. - **Claude Code**: 将本仓库直接放入项目的 `.claude/skills/livestream-clip-editor/` 目录下;
  123. - **Qoder**: 放入 `~/.qoder-cn/skills/livestream-clip-editor/`;
  124. - **Trae**: 放入 `.trae/skills/livestream-clip-editor/`。
  125. 在对话框描述素材和剪辑目标,AI Agent 可按 Skill 指引运行探测、转写和渲染流程;EDL 选句及成片复核仍由操作者完成。
  126. ---
  127. ## 💬 交流探讨与定制开发
  128. 如果您对本套 **直播切片自动化、短视频矩阵防同质化、音视频底层算法工程** 感兴趣,或有更复杂的短视频/电商自动化、AI Agent 工作流、工具链定制需求,欢迎添加作者微信交流合作!
  129. - 🤝 **技术交流**:短视频防搬运去重算法、FFmpeg 工业级滤镜管线、Whisper ASR 调优与落地经验探讨;
  130. - 🛠️ **定制开发**:承接各类短视频全自动剪辑分发系统、电商矩阵带货工具、私域获客自动化、数据跑批与各类定制化工具开发。
  131. <div align="center">
  132. <img src="assets/wechat_contact.jpg" width="240" alt="WeChat Contact: Gabor Lu" />
  133. <p><b>微信扫码添加作者(Gabor Lu · 广东东莞)</b><br><sub>添加时请备注:技术交流 / 工具定制</sub></p>
  134. </div>
  135. ---
  136. ## 📄 开源协议
  137. 本项目采用 [MIT License](LICENSE) 免费开源开放。欢迎 Star、Fork 并集成到您的商业业务中!

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.