pyJianYingDraft 是一个用于程序化创建剪映草稿的 Python 库，让你可以通过代码自动生成剪映项目文件。

你的剪映草稿路径: E:\JianyingPro Drafts

✅ 已验证: 此路径存在且可用

素材库路径: E:\JianyingPro Drafts\素材库

✅ 已创建: 素材库文件夹结构已建立，包含：

• 📁 音频/ - 存放背景音乐、音效等
• 📁 视频/ - 存放视频素材、片段等 (已有290个文件，1.4GB)
• 📁 图片/ - 存放图片、贴纸、背景等
• 📁 字体/ - 存放自定义字体文件

❌ 当前不需要: 本项目目前不需要配置大模型 API Key

💡 未来扩展: 如需集成 AI 功能，可在 .env 文件中配置：

# 示例配置（暂不需要）
OPENAI_API_KEY=your_api_key_here
CLAUDE_API_KEY=your_api_key_here

# 运行基础示例
python demo.py

# 运行实际使用示例
python 实际使用示例.py

选择操作：

• 1 - 创建简单草稿（文本+音频）
• 2 - 创建高级草稿（多轨道复杂项目）
• 3 - 检查素材文件夹

# 运行素材管理工具
python 素材管理示例.py

功能选项：

• 1 - 创建素材库文件夹结构
• 2 - 扫描现有素材
• 3 - 整理指定文件夹的素材
• 4 - 创建包含素材的草稿示例

CatMeMe/
├── pyJianYingDraft/           # 核心库文件
├── demo.py                    # 基础功能演示
├── 实际使用示例.py             # 实际项目创建示例
├── 素材管理示例.py             # 素材管理工具
├── 配置指南.md                # 详细配置说明
├── 项目使用指南.md             # 本文件
└── test_installation.py       # 安装测试脚本

• MP3, WAV, AAC, M4A, FLAC

• MP4, AVI, MOV, MKV, WMV, FLV

• JPG, JPEG, PNG, GIF, BMP, WEBP

• TTF, OTF, WOFF, WOFF2

import pyJianYingDraft as draft

# 1. 创建草稿文件夹对象
draft_folder = draft.DraftFolder("E:\\JianyingPro Drafts")

# 2. 创建新草稿
script = draft_folder.create_draft("我的项目", width=1920, height=1080)

# 3. 添加轨道（为每个轨道指定唯一名称）
script.add_track(draft.TrackType.text, "主标题")
script.add_track(draft.TrackType.audio, "背景音乐")
script.add_track(draft.TrackType.video, "主视频")

# 4. 添加内容
title = draft.TextSegment(
    text="欢迎使用 pyJianYingDraft",
    timerange=draft.trange("0s", "5s")
)
script.add_segment(title, "主标题")

# 5. 保存草稿
script.save()

# 多种时间格式支持
draft.trange("0s", "10s")           # 秒
draft.trange("0:00", "0:10")        # 分:秒
draft.trange("0:00:00", "0:00:10")  # 时:分:秒

1. 按项目分类: 为每个项目创建专门的素材文件夹
2. 命名规范: 使用有意义的文件名，避免中文特殊字符
3. 定期清理: 删除不再使用的素材文件
4. 备份重要素材: 对重要素材进行备份

如果遇到中文编码问题，确保文件头包含：

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

• 使用绝对路径而非相对路径
• Windows 路径使用双反斜杠 \\ 或正斜杠 /
• 确保路径存在且有读写权限

• 为每个轨道指定唯一名称
• 添加段落时明确指定轨道名称

• 确保素材文件格式受支持
• 检查文件是否损坏
• 验证文件路径正确性

• 基础库安装和配置
• 草稿创建和管理
• 多轨道支持（文本、音频、视频、贴纸）
• 时间范围设置
• 素材库管理
• 实际项目集成
• 完整示例和文档

• 库状态: ✅ 完全可用
• 草稿路径: ✅ 已配置 (E:\JianyingPro Drafts)
• 素材库: ✅ 已创建并包含290个视频文件
• API配置: ❌ 暂不需要
• 测试状态: ✅ 所有功能正常

1. 开始创建项目: 使用 实际使用示例.py 创建你的第一个草稿
2. 整理现有素材: 使用 素材管理示例.py 整理你的素材文件
3. 学习高级功能: 研究 demo.py 中的各种功能示例
4. 自定义开发: 基于现有示例开发符合你需求的自动化脚本

如果遇到问题，请检查：

1. 路径配置: 确认剪映草稿路径正确
2. 文件权限: 确保有读写权限
3. 素材格式: 确认素材文件格式受支持
4. 代码语法: 检查 Python 语法错误

🎉 恭喜！pyJianYingDraft 已完全配置完成，可以开始创建精彩的剪映项目了！