剪映小助手

【开源剪映小助手】架构设计本项目“capcut-mate”是一个面向剪映（CapCut）的自动化辅助系统，提供草稿管理、媒体素材处理、特效与字幕集成、以及视频导出能力。系统采用前后端分离策略：后端为基于 FastAPI 的 Web API，前端为 Electron 桌面应用，二者通过 IPC 和 HTTP 协议进行交互；同时系统支持容器化部署，便于在云渲染场景中运行。

【开源剪映小助手】技术栈概览本项目为 CapCut Mate（剪映小助手），旨在提供一套完整的视频草稿自动化处理能力，包括草稿下载、素材管理、草稿生成与导出、以及桌面客户端交互。技术栈围绕 Python 后端（FastAPI + Uvicorn）、前端（React + Vite + Electron）、以及自动化控制（uiautomation）构建，同时提供容器化部署能力。

【剪映小助手】音频处理接口本文档介绍音频处理接口，聚焦以下两个核心能力：文档提供最佳实践建议，包括音频同步、多轨混合与音频效果处理策略，并给出常见问题排查方法。

【剪映小助手】图片处理接口本文档介绍剪映草稿图片处理接口，重点说明 /v1/add_images 接口的图片添加功能。该接口用于向现有剪映草稿中添加图片素材，支持透明度、缩放和位置调整。图片可用于增强视频视觉效果，如背景图、水印、装饰图等。

【剪映小助手】贴纸处理接口本文档介绍贴纸处理接口，重点覆盖两个接口：文档说明请求参数、时间线定位机制、缩放与位置配置、层级关系与渲染顺序、透明度与动画效果的应用方式，并提供贴纸 ID 获取、贴纸预览与效果配置的示例与最佳实践。

【剪映小助手】音频处理工具接口音频处理工具接口是一个基于FastAPI构建的RESTful API服务，专门用于获取音频文件的时长信息。该接口支持多种音频格式，包括MP3、WAV、M4A等常见音频格式，为视频制作流程提供精确的音频时长数据。

【剪映小助手】贴纸搜索接口贴纸搜索接口是 CapCut Mate 视频编辑工具的重要组成部分，用于根据用户提供的关键词搜索相关的贴纸素材。该接口支持在视频制作流程中快速定位和应用合适的贴纸效果，提升视频创作效率。

【剪映小助手】字幕信息生成接口字幕信息生成接口（/caption_infos）是CapCut Mate项目中的一个核心API端点，专门用于根据文本内容和时间线生成字幕信息。该接口支持多种字幕样式配置、关键词高亮、入场出场动画以及转场效果设置。

【剪映小助手】音频信息生成接口音频信息生成接口（/audio_infos）是CapCut Mate项目中的一个核心API端点，用于根据音频URL和时间线配置生成音频信息。该接口支持批量音频处理、音效设置和音量控制，为视频编辑流程提供完整的音频管理能力。

【开源剪映小助手】媒体信息生成接口本文件为媒体信息生成接口的完整 API 文档，覆盖以下六个核心接口：文档详细说明各接口的请求参数、响应结构、生成规则与业务逻辑，并提供错误处理策略、性能建议与使用示例。

【开源剪映小助手】字幕接口字幕处理接口是 CapCut Mate 项目的核心功能模块，提供完整的字幕管理解决方案。该接口支持批量添加字幕、样式配置、信息生成等功能，涵盖文本格式、时间轴定位、字体样式、颜色配置和动画效果等方面。

【开源剪映小助手】视频生成接口视频生成接口是 Capcut Mate 项目的核心功能模块，提供完整的云端视频渲染服务。该接口支持异步视频生成、实时状态查询和结果获取，适用于各种视频创作场景。

【开源剪映小助手】项目介绍CapCut Mate API 是一个完全开源免费的剪映自动化助手，基于 FastAPI 构建，支持独立部署。该项目专注于为大模型赋能基础视频编辑能力，提供开箱即用的视频编辑技能，并已完全自动化了剪映核心功能工作流。它可以直接连接大模型，实现多样化的智能视频编辑，让普通用户能够快速制作专业级的视频作品。

【开源剪映小助手】视频生成流程本项目提供了一个完整的云端视频生成解决方案，基于剪映专业版的自动化控制实现。系统支持草稿创建、素材添加、视频生成、状态查询和结果下载等全流程功能。通过异步任务队列管理和剪映自动化控制，实现了稳定的云端渲染服务。

【开源剪映小助手】媒体处理功能CapCut Mate 是一个基于剪映（CapCut）的专业视频编辑辅助工具，提供完整的媒体处理功能。该系统支持视频、音频、图片和字幕的添加、处理和管理，具备强大的时间线管理和同步机制。

【开源剪映小助手】云渲染环境搭建本指南面向需要搭建云渲染环境的开发者与运维人员，基于仓库中的代码实现，提供从技术架构到部署配置的完整说明。重点涵盖以下方面：

【开源剪映小助手-客户端】桌面客户端本文件面向 capcut-mate 桌面客户端的使用者与开发者，系统性阐述基于 Electron 的桌面应用架构、主进程与渲染进程职责、功能模块与交互流程、安装部署与构建打包、配置管理、日志与故障排查，以及扩展与定制化建议。该应用的核心能力是解析剪映草稿分享链接，批量下载草稿资源并组织到本地目录，同时提供历史记录与配置中心。

【开源剪映小助手】配置与部署本文件面向运维与开发人员，系统性梳理 capcut-mate 的全局配置、环境变量、运行时参数与部署流程，覆盖本地与容器化部署、云渲染环境准备、腾讯云 COS 对象存储集成以及监控告警建议。文档同时给出生产环境最佳实践、性能优化与安全配置要点，帮助快速、稳定地上线与维护该服务。

【开源剪映小助手-客户端】目录扫描功能目录扫描功能是 CapCut Mate 项目中的核心特性之一，主要用于实现剪映草稿文件的自动发现和管理。该功能通过模拟文件系统变更事件，使剪映应用程序能够自动检测到新下载的草稿文件，而无需重启应用程序。

【剪映小助手-客户端】构建与部署本指南面向 capcut-mate 桌面客户端的构建与部署，覆盖 Electron 应用的构建流程、打包配置、发布策略、版本管理、自动更新机制与签名验证流程，并提供开发环境配置、调试工具使用与生产环境部署的最佳实践。文档同时涵盖跨平台兼容性处理、安装包优化与分发渠道管理的实操建议。