剪映素材库助手

自动拦截剪映的文件选择对话框，使用自定义素材库快速导入素材。

问题

剪映每次选择素材都需要手动搜索素材，远端文件需手动筛选、下载、替换，效率低下。

解决方案

1. 检测剪映文件选择对话框（OCR识别）
2. 弹出自定义的素材库选择素材（案例展示仅弹出普通文件选择器）
3. 自动注入选中的文件路径到剪映

安装

# 安装依赖
pip3 install -r requirements.txt

# 赋予辅助功能权限
# 系统设置 → 隐私与安全性 → 辅助功能 → 添加终端/Python

使用

cd src
python3 main.py

工作流程：

1. 启动脚本后，在剪映中点击"替换素材"
2. 当剪映弹出文件选择框时，脚本自动检测
3. 自定义素材库弹出（案例展示仅弹出普通文件选择器）
4. 选择文件后，自动注入到剪映

配置

修改默认素材目录：

# src/main.py:86
material_dir = os.path.expanduser("~/Movies")  # 改成你的路径

技术实现

检测原理

使用 macOS Vision 框架对窗口截图进行 OCR，查找特征文本"请选择媒体资源"。

# src/utils/dialog_detector.py
WindowOCR.find_text_in_window(window_id, "请选择媒体资源")

路径注入

使用 AppleScript 模拟键盘操作：

keystroke "g" using {command down, shift down}  # Cmd+Shift+G
keystroke "{file_path}"                          # 输入路径
keystroke return                                 # 前往
keystroke return                                 # 打开

系统要求

• macOS 10.15+
• Python 3.8+
• 辅助功能权限

依赖

• pyobjc-framework-Cocoa - macOS API 绑定
• pyobjc-framework-Quartz - 窗口管理
• pyobjc-framework-Vision - OCR 识别

限制

1. 仅支持剪映专业版（macOS）
2. 需要辅助功能权限（模拟键盘输入）
3. 依赖OCR识别（界面语言变化可能导致失效）

故障排查

未检测到对话框：

• 确认剪映界面语言为简体中文
• 检查是否显示"请选择媒体资源"文本

路径注入失败：

• 确认已授予辅助功能权限
• 手动测试：在对话框按 Cmd+Shift+G 是否能打开"前往"功能

文件未打开：

• 检查输入的是完整文件路径（非目录）
• 确认文件格式为剪映支持的格式

技术交流

QQ群：523219063

欢迎加群讨论技术问题、分享使用经验。 不定期更新作品，敬请关注。

许可

MIT