读懂Concat架构从文档到像素一张图看懂Rust视频引擎的完整地图【免费下载链接】ConcatThe truly free, and open-source cross-platform CapCut replacement (supports MCPs).项目地址: https://gitcode.com/gh_mirrors/wo/ConcatConcat 是一款免费、开源的跨平台视频编辑器也是 CapCut 的开源替代品整个引擎用 Rust 编写没有界面依赖、没有垃圾回收从时间线文档到最终像素全部跑在本地。本文以官方架构文档 ARCHITECTURE.md 为线索带你一张图看懂这个 Rust 视频引擎的完整地图——13 个模块各管什么、一帧画面如何从 JSON 文档走到 GPU 合成器以及新手应该从哪份文件开始读。️ Concat 是什么全本地的开源视频编辑器在讲架构之前先说清楚这个引擎为谁服务。Concat 覆盖人们打开 CapCut 的真实需求自动字幕本地 Whisper、文字转语音、背景抠除、关键帧动画、170 种 GPU 实时效果、多轨道剪辑、4K 导出——且无水印、无账号、无订阅素材永不离开你的磁盘。支撑这一切的是一套分层清晰的 Rust 引擎外加一个 Slint 界面、一个命令行工具和一个 socket 服务它们共用同一套 API。用官方文档的话说One document format, one command set, one renderer, three ways in. 一个文档格式一套命令集一个渲染器三种入口。️ 一张地图看懂13 个模块的职责分工Concat 的引擎是src/crates/下的一组 crate。依赖箭头只朝一个方向指底层的 crate 不知道上层存在引擎核心甚至不知道 FFmpeg 存在。模块一句话职责concat-core时间、竞技场arena、时间线、帧、着色器类型——所有模块共用的词汇表仅依赖 stdconcat-project文档本身模型、命令Command、撤销栈、concat.json读写concat-media像素和采样率的进出——唯一链接 FFmpeg 的 crate探测、解码、编码、硬件加速concat-effects效果包目录清单 WGSL 着色器解析与校验concat-render把「时间线 时间戳」变成一帧成品FramePlan、CPU/GPU 双合成器concat-export文档 → 引擎时间线逐帧渲染循环concat-host窗口需要的「非剪辑」部分会话、项目、播放、代理、任务调度concat-speech/concat-vision/concat-text字幕whisper、语音合成、抠像与画笔、标题栅格化concat-api→concat-server→concat-cli唯一的 JSON 分发器 → socket 服务JSON-RPC / gRPC→ 命令行concat你启动的那个 Slint 编辑器窗口concat-perf性能预算表两条值得记住的硬规则详见 src/README.md如果你发现想让core依赖media说明某个东西放错了 crateconcat-core、concat-project、concat-render等可以编译到wasm32跑在浏览器里FFmpeg 边界只被concat-media一个 crate 承担。 从文档到像素一帧画面诞生的 5 个阶段这是整个架构最精彩的部分。一个片段在到达屏幕之前要经历三种形态每次形态转换都对应「一个文件里的一个函数」文档src/crates/concat-project/src/model.rs人编辑的、被保存的东西。时间是秒、ID 是字符串、每个关键帧是片段时长的分数。每次修改都走一条Commandsrc/crates/concat-project/src/commands/撤销栈深度 200一次手势算一步。展平与解析src/crates/concat-export/src/flatten.rs、resolve.rs文档 →VecExportClip→ 引擎的Timeline。时间换成分数秒Rational并量化到帧网格——这样浮点比较就是精确的。帧计划 FramePlansrc/crates/concat-render/src/plan.rs纯函数不碰文件不碰像素只回答「t 时刻屏幕上有什么、在哪里」。填充导出层把解码出的画面、该时刻解析好的效果、叠加的处理填进计划交给合成器。双合成器一份描述CPU 版是「参考答案」GPU 版必须与它一致——一致性测试用结构相似度 SSIM 0.99 来把关几何变换与混合权重都在计划里算好一次两个合成器无从「各走各路」。最后交给concat-media的编码器落盘或作为纹理直接送到窗口的 GPU 设备上。✨ 170 效果如何做到 GPU 实时渲染每个效果就是 src/crates/concat-effects/packages/ 下的一个文件夹一份effect.toml清单声明旋钮 一个effect.wgsl着色器声明Params结构和fn effect(uv) 音频滤镜链模板。安全边界做得很严加载时用 naga 解析校验拒绝任何宿主未声明的绑定、无 break 的死循环、超过 65×65 的查找表用户自带的效果包安装前还会在 GPU 上对 512 像素画面试跑一次3 秒超时即淘汰。运行时 GPU 走 uniform buffer 传参CPU 回退路径则用kernels.rs里为已知效果逐个实现的核函数——同一条效果两条腿走路。⚡ 解码、缓存与调度4K 时间线顺滑拖动的秘密交互式操作全部走「线程池 调度器」而不是随手起线程源缓存按键(文件, 解码级别, 帧号)存放裁剪、适配、效果链在缓存图上出口处再应用并单独存一份更小的二级缓存——所以拧一个效果旋钮每帧只多花一次滤镜的钱回拖已覆盖的区域只是一次查表调度器每进程一个播放头附近的帧 轨道缩略图 素材库封面 代理2–4 个线程且永远留一个线程不被后台工作占用导入 20 个文件不会同时起 20 个解码器硬件解码src/crates/concat-media/src/hardware.rsmacOS 走 VideoToolbox、Windows 走 D3D11VA、Android 走 MediaCodec任何失败只回退软件解码并记录一次日志代理超过 HD 的素材自动转四分之一尺寸 H.264 存入缓存保证时间线缩略图永远流畅。️ 窗口层Slint 界面如何与 Rust 引擎对话窗口是一棵由 Rust 发布的 Slint 树。控制器是Studiosrc/crates/concat/src/studio.rs每个面板媒体库、时间线、监视器、导出、字幕……都是「状态 消息 update data」四件套只能被自己的消息修改。几个聪明的设计行数据通过sync差量比对再发布轨道只发布与可见窗口相交外加左右各一屏的片段时间线再长也不卡预览监视器直接画在窗口自己的 wgpu 设备上一帧就是一块纹理Slint 直接采样零回读——解码在 worker 线程绘制只发生在事件循环线程。 三种入口一套引擎同一个concat-api分发器三种走法完整参考在 docs/README.md入口形态说明图形界面Slint 窗口内置会话Remote 页面甚至能内嵌一个服务命令行concat-cliprobe、render、apistdin/stdout、serveSocketconcat-serverJSON-RPC 行协议TCP / Unix socket、gRPCfeature 开关令牌鉴权一个反直觉的细节窗口并不是自家 API 的客户端——它的 Remote 页面内嵌了一个独立会话的服务两者只共享「同时只允许一个导出」的锁和「已打开项目文件夹」登记表。edit.apply携带的就是窗口自己的编辑命令界面上能做的每个编辑脚本都能做。 架构如何保持不腐化测试与性能预算测试套件守住什么单元测试全 workspace算术、命令、读取器、帧计划导出端到端src/crates/concat-host/tests/export.rs人能做的每个编辑都能真实导出故意崩掉也要崩得响亮GPU 一致性GPU 对 CPU 参考实现SSIM 0.99每个特性一个计划恶意效果包死循环、多余绑定、超大查找表必须被拒绝性能预算concat-perf规划、撤销、解码、合成、导出各有预算--check超预算即失败CI 每次推送都跑 想深入阅读从这三份文档开始你想了解打开引擎全景与「文档到像素」流程ARCHITECTURE.md各 crate 布局、构建与性能测量src/README.mdAPI 方法、编辑命令与三种传输docs/README.md、docs/api/methods.md片段能是什么样子src/crates/concat-project/src/model.rs一帧如何被规划src/crates/concat-render/src/plan.rs某个效果src/crates/concat-effects/packages/ 下的对应文件夹一句话总结Concat 的架构地图其实只有一条主线——一个文档格式、一套命令集、一个渲染器、三种入口。抓住core → project → media/export/render → host → api/server → 窗口这条单向依赖链再顺着「文档 → 展平 → 帧计划 → 双合成器 → 编码器」这五步走一遍整个 Rust 视频引擎就装进你的脑子里了。【免费下载链接】ConcatThe truly free, and open-source cross-platform CapCut replacement (supports MCPs).项目地址: https://gitcode.com/gh_mirrors/wo/Concat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考