代码剪辑台 - 免费用 MoviePy 风格的中文脚本拼接图片/视频（其它工具）

这个工具解决什么问题

做短视频最常见的活儿其实很固定：几张图、几段实拍，按顺序排好，每段配一句话字幕，中间加个转场，再来一条背景音乐，最后出一条 1080×1920 的成片。这种活儿用专业剪辑软件做，要建工程、拖轨道、对齐、加字幕、调音量，一套下来十分钟；素材一多（比如一次做十几条商品展示视频），光重复操作就够烦的。会写脚本的人更难受——明明就是「素材 A 三秒、素材 B 五秒、中间淡入淡出」这么简单的逻辑，却找不到一个能直接用文字描述的剪辑工具。

• 原来的做法：打开剪辑软件，新建工程，逐个导入素材，拖到轨道上对齐时间轴，逐条加字幕并调字号位置，再挂背景音乐调音量，最后选参数导出
• 用这个工具：把素材路径写进一份中文脚本（或直接把文件拖进时间轴表格），点一次「开始导出 MP4」，软件自动完成铺满裁剪、字幕烧录、转场拼接、混音，直接出片
• 省下来的：一条 10 秒的拼接视频从十分钟左右的手工操作变成改几行文字 + 一次点击；批量做同款结构视频时尤其明显

技术实现

软件本体只负责「把你的意图变成 ffmpeg 命令」：界面提供时间轴表格和一份 MoviePy 风格的中文脚本，两者是同一份数据的两种写法，可互相转换；导出时按「先归一化、后合成」两阶段编排 ffmpeg 子进程——第一阶段把每个素材压成统一画布、统一帧率的中间片（顺带完成等比铺满裁剪、推近/拉远动效、drawtext 字幕烧录），第二阶段用 xfade 滤镜串接转场、把背景音乐按音量混入并做结尾淡出，一次写成 H.264 + AAC 的 MP4（faststart，适合手机端播放）。ffmpeg 组件首次使用时自动下载解压到用户目录，已装过的机器可直接复用。

• 两阶段渲染管线：归一化阶段每个素材单独跑一次 ffmpeg（图片用 -loop 1 -t 时长，视频用 -t 截断），滤镜链 scale(force_original_aspect_ratio=increase)+crop 铺满画布，动效用 scale(eval=frame) 的分数倍缩放实现推近/拉远；合成阶段用 xfade 串接，转场时长自动夹紧为 min(前段,后段)-0.2 防止时间轴越界，offset 按已累积时长回推。
• 滤镜脚本文件绕开命令行转义：中文字幕、Windows 路径里的冒号反斜杠塞进命令行必炸。实测后改用 -filter_script:v / -filter_complex_script 把滤镜图写成 UTF-8 无 BOM 文件，字幕文字另存文本文件交给 drawtext 的 textfile，并把 ffmpeg 的 WorkingDirectory 设为工作目录，用相对路径引用，彻底绕开转义问题。
• drawtext 字体路径的坑：fontfile 里盘符冒号必须写成 C\:/Windows/Fonts/msyh.ttc（双反斜杠），单反斜杠会报 No option name near。软件按 msyh/黑体/宋体等顺序探测本机中文字体，找不到时退回 fontconfig 名字。
• 中文脚本 DSL 双向解析：自写一套「素材(...).时长(3).字幕(...).转场(黑场,0.4)」语法的生成器与解析器（CutScript.Generate/Parse），支持引号转义、括号深度、键值参数（音量=0.35），解析错误逐条报人话（括号不配对、未知属性、第几行）。脚本与时间轴表格是同一份 ClipItem 列表的两种视图。
• 时间轴表格用手工填充而非数据绑定：DataGridView 的 DataPropertyName 绑定是字符串属性名反射，SmartAssembly 混淆改名后实测整表清空（行数在、单元格全空）。改成手工 FillRow/ReadBackRow 往返填充，只依赖自己的列名，混淆保护不打折。
• ffmpeg 组件自动安装：首次导出时检测 %APPDATA%\zyffmpeg，没有就解析组件包直链并带进度下载（68MB）、整体平铺解压后跑一次 ffmpeg -version 冒烟校验（组件包是 DLL 共享版，光看文件存在不够），失败自动清掉坏包可重试；解析出的直链必须以 302 Location 为准，自动跟随反而会落到验证页。

技术栈：C# / .NET Framework 4.8、WinForms 窗体、ffmpeg 外部进程编排、SmartAssembly 混淆

已知局限：定位是「素材拼接类」短视频：转场只有 10 种预设、动效只有推近/拉远、字幕为整段静态文字（不支持逐字动画）；导出参数固定为 H.264 + AAC（CRF 21 / veryfast），不暴露码率等高级选项；素材里的音频不保留（成片音轨只有背景音乐）。首次使用需联网下载约 68MB 组件包。

操作教程

1. 下载并解压
   点文章里的下载按钮，解压到任意目录
   预期结果：得到 代码剪辑台.exe 与 使用说明.txt
2. 首次导出前的组件准备
   第一次点「开始导出 MP4」时，软件会自动下载 ffmpeg 组件（约 68MB，只下载一次），下载完成自动解压并校验
   预期结果：运行日志出现「ffmpeg 组件就绪」，之后不再联网
3. 添加素材
   点「添加图片」「添加视频」多选文件，或把文件直接拖进时间轴表格
   预期结果：表格出现对应行，类型列自动识别图片/视频，默认时长 3 秒
4. 调整每段的时长/字幕/转场
   直接在单元格里改：时长(秒)、字幕文字、字号、字幕位置、动效、转场、转场(秒)；用上移/下移调顺序
   预期结果：左侧脚本框实时同步；字幕为空则该段不烧字幕
5. 设置输出与音乐
   右侧选画布（默认竖屏 1080×1920）、帧率（默认 30），点「浏览」选背景音乐与输出路径，调音量与结尾淡出
   预期结果：所有设置即时生效，无需保存
6. 开始导出
   点「开始导出 MP4」，进度条与运行日志实时显示每段处理进度
   预期结果：完成后自动打开输出目录并选中成片，MP4 可直接发手机/平台

常见问题

技术实现与后续维护

技术构成为 C#/.NET Framework 4.8 + WinForms 界面 + ffmpeg 外部进程编排 + SmartAssembly 混淆发布。运行环境：Windows 10/11 64 位，.NET Framework 4.8（Win10 及以上系统自带）。首次导出需联网下载 ffmpeg 组件（之后完全离线）。可扩展方向：转场/动效预设扩充、水印叠加、输出参数开放、素材原声混入。

技术构成：

• src/Program.cs —— 入口：窗口标题拼接（含百业软件站信息）、--selftest 自检钩子
• src/Core/ClipItem.cs —— 片段数据模型与常量表（10 种转场 / 3 种动效 / 3 种字幕位置）
• src/Core/CutProject.cs —— 工程模型 + 中文脚本 DSL 的生成与解析（CutScript）
• src/Core/RenderService.cs —— 两阶段 ffmpeg 渲染编排：归一化 → xfade 合成 → 混音导出
• src/Core/FfmpegRuntime.cs —— ffmpeg 查找 / 自动下载安装 / 冒烟校验 / 中文字体探测
• src/Core/DirectLinkResolver.cs —— 组件包直链解析（acw_sc__v2 反爬 → downprocess → 302 Location）
• src/Core/HeadlessRunner.cs —— --run 脚本直跑与 --install-ffmpeg 安装验收钩子
• src/Core/SelfTest.cs —— 17 项无界面自检（DSL 往返 / 字体 / 窗体尺寸 / 直链 / 迷你渲染）
• src/UI/BodyForm.cs —— 主界面：时间轴表格（手工填充）、脚本双向转换、导出控制
• src/UI/MainForm.cs —— 框架主窗体壳，承载 BodyForm

运行环境：

工程是 .NET Framework 4.8 WinForms，依赖同目录的框架公共库（my.common/my.antd.ui/my.download）。日常开发用 build.bat 走框架构建脚本；独立编译可用 Visual Studio 打开 src/by.codecut.sln 生成。

可扩展方向：

• 加转场：在 Core/ClipItem.cs 的 TransitionSet 里加名字，RenderService.Compose 的 xfade 映射表里补对应 transition 名即可
• 加动效：EffectSet 里加名字，NormalizeOne 的动效分支里补一条滤镜链
• 换输出参数：RenderService.Compose 里的 libx264/crf/preset 是常量，可改成从脚本读取
• 保留素材原声：Compose 的音轨分支现在是「只混 BGM」，可按段追加音轨 input 后 amix

本工具免费提供使用，但不对外分发源码。如果你需要在本工具基础上做功能调整、对接内部系统或长期维护，可以联系我们做二次开发，源码与工程文档可在定制合作中一并交付。

使用说明与免责声明

• 本程序只在执行任务时访问你自己填写的地址，不向任何第三方服务器上传数据，结果只保存在本机。
• 涉及文件改写的功能，请在使用前备份原始文件。
• 软件完全免费，可自由使用与转发，请勿用于倒卖。
• 因误操作造成的数据问题请自行承担。