把「在剪映里一个个点导出」变成一条命令。
草稿躺在剪映的工程目录里，导出却只能手动点、逐个等 —— HDraft 直接读取草稿工程， 自动解密、收集素材、上传云端并发渲染，成片回写到草稿所在目录。
剪映很适合做片，但不适合批量出片：
| 你现在怎么做 | 用 HDraft |
|---|---|
| 打开剪映 → 打开草稿 → 导出 → 等 → 下一个 | 写好草稿路径，一条命令全部跑完 |
| 一次只能导出一个，人得守着 | 多个草稿并发处理，跑完自动退出 |
| 导出吃满本机 CPU / 显卡，机器干不了别的 | 渲染在云端，本地只做打包上传，老机器也能跑 |
| 批量 / 定时 / 接进自己的系统几乎不可能 | 命令行 + HTTP 接口，天然可脚本化、可编排 |
典型场景：矩阵号日更（几十条同类草稿一次导出）、模板化混剪量产、 把出片接进自己的自动化流水线、在没有剪映的服务器 / 云主机上出片。
到 Releases 下载对应平台的压缩包，解压即可用（无需安装）：
| 平台 | 文件 |
|---|---|
| Windows x64 | HDraft_win-x64.zip |
| macOS Intel | HDraft_osx-x64.zip |
| macOS Apple Silicon | HDraft_osx-arm64.zip |
打开 https://htwmedia.dpdns.org/Home/GetApiKey，填入邮箱，Key 会发到邮箱。 AuthKey 只是一个防滥用的准入闸口，新用户注册即送 1 个月免费额度。
编辑 exe 同目录的 config.ini：
(!此行别删) 草稿路径：C:\Users\你\AppData\Local\JianyingPro\User Data\Projects\com.lveditor.draft\2月9日\draft_content.json
authKey:你的密钥- 多个草稿用竖线
|分隔； - 也可以直接填文件夹路径，工具会自动扫描子目录下的所有草稿；
- 第一行前面的
(!此行别删)是格式标记，请保留。
不想改配置文件？直接运行
HDraft，按提示输入 AuthKey 和草稿路径也一样能跑。
HDraft # 开始处理
HDraft --help # 查看帮助处理过程中每一步都有提示，方便追踪；成片保存在草稿所在目录，文件名形如 生成视频_20260209_153012.mp4。
草稿工程目录
│ ① 读取 draft_content.json（加密的自动解密）
│ ② 解析草稿引用的素材，收集视频 / 图片 / 音频
│ ③ GIF 自动转 PNG 首帧
▼
上传素材到云端（本地只做打包上传，并发 4）
▼
④ 云端渲染：建任务 → 轮询进度
▼
⑤ 下载成片 → 写回草稿所在目录 → 清理临时文件
几个你可能会关心的细节：
- 加密草稿自动解密：剪映 5.9 之后草稿是加密的，工具会自动处理，你不用管；
- 草稿不一定要来自剪映：用代码生成
draft_content.json（见下）同样能渲染； - 本机几乎不烧资源：渲染在云端，上传完就可以关掉窗口等结果；
- 素材用完即清理：渲染完成后云端临时素材会被删除，不做留存。
Windows 默认在：
C:\Users\<你>\AppData\Local\JianyingPro\User Data\Projects\com.lveditor.draft\<草稿名>\draft_content.json
不确定路径？在剪映里右键草稿 → 「打开草稿文件夹」即可。
本仓库自带一个轻量的 C# 草稿生成库（ScriptFile.cs、VideoSegment.cs、AudioSegment.cs …），
可以不打开剪映、直接用代码拼出一条片子。
仓库已包含 JyDraft.csproj，clone 后直接编译：
dotnet build # 产出 JyDraft.dll，依赖已配好：Newtonsoft.Json / Microsoft.Extensions.Logging / MediaInfo.Wrapper.Corevar script = new ScriptFile(1920, 1080); // 画布尺寸
script.Content["id"] = draftId;
script.AddTrack(TrackTypeName.audio)
.AddTrack(TrackTypeName.video)
.AddTrack(TrackTypeName.text);
var audioSegment = new AudioSegment(
new AudioMaterial(@"D:\assets\audio.mp3"),
TimeUtil.Trange(0, "5s"),
volume: 0.6f);
audioSegment.AddFade("1s", 0); // 淡入
var videoSegment = new VideoSegment(
new VideoMaterial(@"D:\assets\video.mp4"),
TimeUtil.Trange(0, "4.2s"));
videoSegment.AddAnimation(IntroType.斜切); // 入场动画
videoSegment.AddTransition(TransitionType.信号故障); // 转场
var textSegment = new TextSegment(
"据说 HDraft 效果还不错？",
videoSegment.TargetTimerange,
font: FontType.文轩体,
style: new TextStyle(color: new[] { 1.0f, 1.0f, 0.0f }),
clipSettings: new ClipSettings(transformY: -0.8f));
script.AddSegment(audioSegment)
.AddSegment(videoSegment)
.AddSegment(textSegment);
var json = script.Dumps(); // 落盘即为 draft_content.json支持的能力：音视频 / 图片 / GIF / 文本轨道与片段、关键帧、转场、动画、
字幕气泡、背景填充、滤镜与特效（meta/ 目录下是各类效果的元数据）。
手里只有一个剪映加密的 draft_content.json，想看看里面写了什么 / 想改改再渲染，
用 DecryptDraft 接口（见下方「接进自己的系统」）解成明文 JSON。
CLI 已经能覆盖大部分场景；如果你要把出片能力嵌进自己的平台、做定时任务或 SaaS，
可以直接调 HTTP 接口。所有请求带请求头 AuthKey: <你的 Key>（X-API-KEY 亦可）。
适合草稿包不大、想最少代码跑通的场景。
| 步骤 | 接口 | 说明 |
|---|---|---|
| 1 | POST /Home/UploadDraftPackage |
multipart/form-data 上传 ZIP（含 draft_content.json + 全部素材） |
| 2 | POST /Home/StartRender?draftId={id} |
启动渲染，返回 taskId |
| 3 | GET /Home/GetStatus?taskId={id} |
轮询 Status / Progress / DownloadUrl |
ZIP 结构（素材路径需与 JSON 中的引用一致）：
my_draft.zip
├── draft_content.json
├── video.mp4
├── audio.mp3
└── image.png
适合大文件、需要秒传 / 断点续传 / 自己控制素材的场景。
POST /Home/CreateAssetUpload { md5, size, crc32, filename, file_type } → upload_id / space_id / token
↓ 直传字节流到云存储
POST /Home/CommitAssetUpload { upload_id, space_id, md5, filename, size } → asset_id
↓ （所有素材重复上面两步）
POST /Home/SaveDraft { draftJson, title, packageAssets } → draftId
POST /Home/RenderDraft { draftId } → taskId
GET /Home/GetStatus?taskId=… → Status / Progress / DownloadUrl
GetStatus 返回示例：
{ "Status": "completed", "Progress": 100, "DownloadUrl": "https://..." }| 接口 | 方法 | 说明 |
|---|---|---|
/Home/GetApiKey |
GET | 网页申请 AuthKey（推荐） |
/auth/applykey?email= |
POST | 接口申请 AuthKey（邮件发送） |
/Home/DecryptDraft |
POST | multipart/form-data 上传加密草稿 JSON，返回明文 draft_content |
接口会持续演进，字段以实际返回为准；有疑问欢迎开 Issue。
需要安装剪映吗？
不需要。HDraft 读的是剪映的草稿工程文件，渲染在云端完成， 所以可以在没装剪映的机器、甚至服务器上跑。
草稿路径怎么找？
剪映里右键草稿 → 「打开草稿文件夹」，里面的 draft_content.json 就是。
也可以直接把文件夹路径填进 config.ini，工具会扫描子目录。
提示素材找不到 / 渲染出来缺素材？
草稿引用的素材必须还在原位置、可访问。挪过素材或换过机器就容易出问题； 建议在剪映里打开一次草稿确认能正常预览，再交给 HDraft。
一次能并发多少？要跑多久？
默认 4 路并发。单条成片的耗时主要看云端队列和片长， 批量场景下整体通常远快于「人工逐个点导出」。
成片在哪？
在草稿所在目录下，文件名形如 生成视频_时间戳.mp4。
我的素材会被留存吗？
不会。素材仅在渲染期间临时使用，任务结束（成功或失败）即删除，本地临时文件也会清理。
| 码 | 含义 | 怎么办 |
|---|---|---|
| 401 | AuthKey 缺失或无效 | 重新获取并填入 |
| 402 | 免费额度已用完 | 到平台充值后重试 |
| 400 | 请求参数有误 | 检查草稿包结构与字段 |
| 500 | 服务端内部错误 | 重试；持续出现请开 Issue |
- HTWMedia/HTWClient —— 开源桌面客户端， 覆盖选题 → 创作 → 剪辑 → 多平台发布的完整链路。只想批量导出草稿用 HDraft， 要完整工作台就用 HTWClient。
Issue 和 PR 都欢迎。本仓库的草稿生成库源码在根目录，
如果你发现了新的草稿字段、新的效果参数，欢迎补充进 meta/。
对剪映 / CapCut 草稿结构、加解密原理、自动化渲染流程感兴趣，欢迎进群聊：
仅用于技术交流与经验分享，请勿发布广告。
仅用于学习与技术研究，请勿用于任何违反剪映 / CapCut 用户协议或相关法律法规的用途。