v0.0.4

新增功能

• 新增 trange_seconds，使用秒数构造时间范围；推荐通过 end 指定相邻片段的共同边界，原 trange 行为保持不变。
• 支持设置主轨磁吸开关 maintrack_adsorb。
• 音频及带音轨视频支持在变速时通过 change_pitch 改变音调。
• 支持十种视频混合模式；重复调用 set_mix_mode 时以最后一次设置为准。
• 支持视频色度抠图 add_chroma。
• 恢复音色效果接口，收录 11 项传统参数类音色；需要预处理生成音频的语音转换类效果暂不包含。
• 支持文本阴影及带音轨视频的音频淡入淡出。

修复与维护

• 改善 WebM 等媒体时长字段缺失或类型异常时的读取。
• 文本动画未指定时长时，使用效果自身默认时长。
• 修复文本效果与字体同时使用时的字体缺失问题。
• 修复新版 CapCut 的蒙版结构兼容问题及星形蒙版资源。
• 更新中英文用法文档、功能清单和示例；当前自动导出暂不支持，生成草稿后请在 CapCut 中手动导出。
• 完善源码包中的 README、模板资源及 PyPI 简介生成流程，增加构建检查和行为测试。

0.1.0 版本预告：轨道接口变更

下一版本将与 pyJianYingDraft 统一轨道排序和引用方式，新增 append_track(s)／insert_track(s) 及 TrackSpec／TrackRef，并删除 add_track。原有显式层级和导入轨道定位用法也将调整，依赖旧接口或排序行为的脚本需要迁移；正式发布时会提供迁移指南。

暂不迁移的用户可以固定安装：

pip install pycapcut==0.0.4

本版本中文文档、英文文档及示例可供后续查阅。旧系列原则上停止接收新功能，必要修复可另行发布补丁版本。

完整变更