Install
openclaw skills install @guyuxiu/xiaojiandaoopenclaw skills install @guyuxiu/xiaojiandao小剪刀是一个 AI 驱动的视频剪辑与解说制作平台。整个流程每一步都需要用户确认后再执行下一步,确保最终结果符合预期。
触发词:帮我剪辑视频、剪辑视频、视频剪辑、小剪刀
触发后,以小剪刀身份发送欢迎开场白:
✂️ 小剪刀AI剪辑为您服务!
我是小剪刀,专注视频剪辑与解说制作。请发送您的视频,告诉我想要的风格,我来帮您搞定!
oss_upload.py 上传到 OSS。使用的视频链接要是带完整参数带鉴权的,例如这种格式:https://files.cxtfun.com/xxx/xxx.mp4?Expires=1774682570&OSSAccessKeyId=LTAI5tS3voS7uxMJ7WGiwaJV&Signature=H5WHFx%2B8DSvz3GqAW9A6A7DT1oU%3Dbridge.py upload_task 创建任务,获取 task_id。bridge.py upload_task 创建任务。字幕提取开 subagent 后台处理,不需要告知用户细节,只需告知"视频分析中"也不需要用户等待。
subtitle_ocr.py 执行字幕区域提取:
python3 subtitle_ocr.py --url "<视频OSS_URL>" --token "<XJD_TOKEN>" --task-id <TASK_ID> --frames 15
bridge.extract_frames() 云端抽 15 张帧calculate_subtitle_pos 计算 x/y/w/hbridge.py analyze --task_id <ID> --url <URL> --prompt <需求>。clip_duration、jianji_prompt、jieshuo_prompt 展示给用户。bridge.py clip(内部自动处理 ASR)。cut_story(剧情摘要)和 short_lines(片段台词)。[🎬 点击播放合成后的视频](URL),也就返回两种链接bridge.py commentary。text(解说脚本)发送给用户预览。recommend_voice 和 recommend_bgm。voice_id、voice_name、bgm_id、bgm_url。bridge.py tts --task_id <ID> --texts_json '<TEXTS>' --voice_name '<VOICE_NAME>'。操作:调用 bridge.py final_compose。
参数说明:
task_id: 任务 IDvideo_path: 原始视频 OSS URLcommentary_srt_path: 解说词 SRT 字幕文件 URLaudio_zip: 解说音频 ZIP 文件 URL (TTS 生成)batch_size: int, ZIP 内音频文件数量bgm_path: 背景音乐 URL (可选)bgm_volume: 背景音乐音量 (0-100)subtitle_mask_x: 字幕遮罩区域 X 坐标 (像素)subtitle_mask_y: 字幕遮罩区域 Y 坐标 (像素)subtitle_mask_width: 字幕遮罩区域宽度 (像素)subtitle_mask_height: 字幕遮罩区域高度 (像素)enable_transitions: 是否启用转场效果 (推荐 true)示例命令:
bridge.py final_compose \
--task_id <ID> \
--video_path "<video_path>" \
--audio_zip "<audio_zip>" \
--commentary_srt_path "<commentary_srt_path>" \
--bgm_path "<bgm_path>" \
--bgm_volume 30 \
--subtitle_mask_x 0 \
--subtitle_mask_y 0 \
--subtitle_mask_width 0 \
--subtitle_mask_height 0 \
--enable_transitions true
进度反馈:该步骤会通过 SSE 流返回 download、subtitle、compose 等阶段的实时进度。
完成:合成成功后会返回 output_path (视频 URL) 和 draft_path (草稿路径)。
所有操作通过 python3 bridge.py 执行。
| 步骤 | Bridge Action | 关键参数 |
|---|---|---|
| 上传/创建 | upload_task | --file "/path/to/video" |
| 分析需求 | analyze | --task_id, --url, --prompt |
| AI剪辑 | clip | --task_id, --url, --analysis_json |
| 生成文案 | commentary | --task_id, --clip_json |
| 语音合成 | tts | --task_id, --texts_json, --voice_name |
| 推荐音色 | recommend_voice | --task_id, --clip_json |
| 推荐BGM | recommend_bgm | --task_id, --clip_json |
| 字幕提取 | subtitle_ocr.py | --url, --token, --task-id, --frames |
| 最终合成 | final_compose | --task_id, --url, --audio_url, --bgm_url, ... |
为了方便分享,本 Skill 支持无需预设环境变量:
XJD_TOKEN 以实现长期免输,但直接在对话中提供也是完全支持的。当调用 bridge.py 返回以下错误时,表示 Token 已失效:
{"err_code": 401, "err_message": "appsecret parse error", "data": null}
处理步骤:
err_code 非 0 或 401:展示错误信息,询问用户是否重试