convez.ai
Skill
esncy

videocut-use

esncy/videocut-use

Ver no GitHub
InicialPluginScore · de 0 a 100

增强版口播视频剪辑 Claude Code Skill — 基于 Ceeon/videocut-skills,新增波形显示、字幕叠加、FunASR本地转录、深色模式

Instalação

$npx convez-ai esncy/videocut-use

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Videocut Use

基于 Ceeon/videocut-skills 的增强版 Claude Code Skill,专为口播视频设计。

主要功能

1. 剪口播 — 口播视频智能剪辑

AI 自动识别口误、重复、停顿、语气词,增强版审核页面人工确认后一键剪辑。

  • 增强版审核页:视频字幕叠加 + 音频波形 + 深色模式 + 项目切换
  • 支持火山引擎云端 / FunASR 本地两种转录模式
  • 支持 .mp4 / .mkv / .mov 等多种格式

2. 导入字幕 — 一键生成剪映草稿

AI 转录 + 校对,默认直接生成剪映草稿(带花字效果 + 入场动画),也可导出 SRT。

3. 高清化 — 专业级导出

2-pass 编码 + 锐化,匹配原片参数的 1.2x 码率输出,肉眼无损。

4. 自进化 — AI 越用越准

用户纠错后自动更新规则文件,记住你的偏好(静音阈值、语气词处理等)。

审核页面增强(相比原版)

原版审核页只有纯文字列表,本版增加了专业级可视化:

功能说明
视频字幕叠加播放时视频底部实时显示当前字幕,待删除字幕显示红色删除线
音频波形图专业编辑器风格(深灰背景 + 绿色波形),选中区域红色高亮,播放头绿色发光跟踪
波形交互点击波形跳转,拖动框选时间段自动选中对应字幕
字幕-波形联动文字列表选中 → 波形同步变红,双向实时同步
可拖动分栏左右面板默认 50/50,拖动中间分隔线调整宽度,双击重置
深色模式一键切换暗/亮主题,偏好自动保存到 localStorage
项目管理头部下拉框列出所有已有项目,点击切换
末尾静音检测自动检测最后一词到视频结尾的空白(原版不处理)
剪辑完成弹窗替代原版 alert,新增「📂 打开目录」按钮直接打开输出目录

其他优化

火山引擎 API 修复

原作者脚本使用的 API 端点已过时,本版修复为官方最新接口:

项目原作者本版修复
端点/api/v1/vc/submit/api/v3/auc/bigmodel/submit
认证x-api-key: appid:tokenx-api-key: {UUID key}
配置需要 APPID + Token + Cluster只需一个 API Key

FunASR 本地转录

新增离线转录能力,无需网络和 API Key:

  • 使用阿里 FunASR paraformer-zh 模型,支持字级别时间戳
  • .env 中一行切换:TRANSCRIPTION_MODE=funasr
  • 首次运行自动下载模型(约 1GB),之后完全本地运行

兼容性修复

问题修复
MKV 文件支持ffprobe/ffmpeg 命令兼容 .mkv 等多种容器格式
ffprobe 尾部逗号macOS 上输出带逗号导致编码失败,已修复
cut_video.sh 参数错误码率/像素格式解析失败导致剪辑报错,已修复
中文路径用 Python 处理中文路径,避免 shell 编码问题

快速开始

1. 安装

git clone https://github.com/esncy/videocut-use.git ~/.claude/skills/videocut-use

2. 配置

cd ~/.claude/skills/videocut-use
cp .env.example .env
# 编辑 .env,至少配置以下之一:
#   VOLCENGINE_API_KEY=xxx  (火山引擎云端转录)
#   TRANSCRIPTION_MODE=funasr  (本地转录,无需 key)

3. 依赖

依赖用途安装
Node.js 18+运行脚本brew install node
FFmpeg视频剪辑brew install ffmpeg
Claude CodeAI Agenthttps://claude.ai/code
FunASR(可选)本地转录pip install funasr modelscope

4. 使用

/videocut-use:剪口播 视频.mp4

完整流程

视频文件 (.mp4/.mkv/.mov)
  ↓
提取音频 → 转录(火山引擎云端 / FunASR 本地)
  ↓
AI 多 Agent 并行分析(静音/口误/重复/语气词)
  ↓
增强版审核页面
  ├── 视频 + 字幕叠加预览
  ├── 音频波形(可点击/框选)
  ├── 深色模式 / 项目切换
  └── 可拖动左右分栏
  ↓
人工确认 → FFmpeg 剪辑 → 输出目录
  ↓(可选)
导入字幕 → 剪映草稿(带花字+动画)
  ↓(可选)
高清化 → 2-pass + 锐化 → 最终输出

目录结构

videocut-use/
├── SKILL.md                # Claude Code skill 入口
├── LICENSE                 # MIT License
├── .env.example            # 配置模板
├── 剪口播/                 # 核心:转录 + 审核 + 剪辑
│   └── scripts/
│       ├── transcribe.sh          # 统一转录路由
│       ├── funasr_transcribe.py   # FunASR 本地转录
│       ├── volcengine_transcribe.sh  # 火山引擎 v3 API
│       ├── generate_subtitles.js
│       ├── generate_review.js     # 增强版审核页
│       ├── review_server.js       # 审核服务器
│       └── cut_video.sh           # FFmpeg 剪辑
├── 导入字幕/               # 字幕导入剪映
├── 高清化/                 # 2-pass + 锐化导出
├── 自进化/                 # AI 自学习偏好
└── 字幕/词典.txt           # 专业术语词典

致谢

基于 Ceeon/videocut-skills 开发,遵循 MIT License。

License

MIT

Ver o original no GitHub

Bom para

Relacionados