arch-video-cut

基于自学习偏好的自动建筑视频剪辑工作流

描述

自动完成完整的建筑视频剪辑流程：多视频合并、语音转文字字幕、背景音乐生成与混合，以及双版本输出（横屏 + 竖屏）。内置自学习系统，可记忆您的剪辑偏好。

核心功能：

• 🎬 自动合并多个视频并压缩时长
• 🎙️ 语音识别生成字幕或手动编辑自定义字幕
• 🎵 智能生成背景音乐并进行混合
• 📱 双版本输出：横屏（16:9）与竖屏（3:4）
• 🧠 自进化偏好系统

使用方法

快速开始

cd ~/.openclaw/workspace/skills/arch-video-cut
python3 scripts/full_workflow.py

前置条件

1. 安装依赖：

brew install ffmpeg-full  # 用于支持 libass 字幕
pip3 install faster-whisper  # 可选：用于语音识别

1. 准备素材：

• 音频文件：~/Desktop/新录音 XX.m4a（旁白配音）
• 视频文件夹：data/m1/（待合并的建筑视频片段）

1. 配置偏好（可选）：

python3 scripts/manage_preferences.py set

命令

配置

偏好设置

编辑 config/user_preferences.json 文件，或运行 manage_preferences.py set：

{
  "video": {
    "target_duration": 20.0,      // 目标时长（秒）
    "vertical_format": "3:4",     // 竖屏比例
    "vertical_resolution": "1080x1440"
  },
  "subtitles": {
    "horizontal_font_size": 14,   // 横屏字体大小（像素）
    "vertical_font_size": 10,     // 竖屏字体大小（像素）
    "font_name": "STHeiti",       // 字体名称
    "auto_wrap": true,            // 自动换行
    "margin_v": 30                // 底部边距（像素）
  },
  "audio": {
    "background_music_volume": 0.15,  // 背景音乐音量（0-1）
    "fade_in_duration": 2,            // 淡入时长（秒）
    "fade_out_duration": 2            // 淡出时长（秒）
  }
}

自定义字幕

修改 transcribe_audio() 函数中的 subtitles_text 数组：

subtitles_text = [
    "这六项改造项目源自废弃学校",
    "历史建筑、红砖房、瓦屋顶房屋、单层厂房及乡村自建房",
    "通过极简设计手法与低成本改造策略",
    "让老建筑焕发新生",
    "同时兼顾现代审美与市场需求"
]

输出结果

输出路径： data/ 文件夹

示例输出：

✅ 全部完成！
📁 输出路径：data/edited_video_final_with_subtitles.mp4
📊 文件大小：16.0MB
🎬 视频时长：20.04 秒

工作流程

1. 合并视频 → 压缩至目标时长
2. 生成字幕 → 根据音频时长分配时间轴
3. 生成背景音乐 → 钢琴和弦 + 淡入淡出
4. 混合音频 → 旁白 + 背景音乐
5. 嵌入字幕 → 生成横屏与竖屏两个版本

总处理时间： 约 2-3 分钟（取决于视频数量与长度）

自学习功能

内置偏好学习系统，自动记录您的剪辑习惯：

• 📝 每次编辑后保存配置
• 📊 保留最近 20 次调整记录
• 🔄 下次运行时自动应用偏好
• 🎛️ 可随时通过 manage_preferences.py 修改

查看学习历史：

python3 scripts/manage_preferences.py show

示例

示例 1：快速剪辑

# 将 5 个视频片段放入 data/m1/
# 将旁白音频放置于 ~/Desktop/新录音 74.m4a
cd ~/.openclaw/workspace/skills/arch-video-cut
python3 scripts/full_workflow.py

示例 2：调整字体大小

# 交互式修改
python3 scripts/manage_preferences.py set
# 输入：横屏字体大小 18px

# 重新剪辑，新字体自动生效
python3 scripts/full_workflow.py

示例 3：制作 30 秒版本

# 修改偏好
python3 scripts/manage_preferences.py set
# 输入：目标时长 30 秒

# 执行剪辑
python3 scripts/full_workflow.py

故障排查

❌ 找不到 ffmpeg-full

brew install ffmpeg-full  # 用于支持 libass 字幕

❌ 字幕未显示

请确认已安装 ffmpeg-full（系统自带 ffmpeg 不支持 libass）

❌ 语音识别失败

pip3 install faster-whisper
# 或跳过识别，直接在脚本中编辑字幕文本

❌ 视频比例错误

修改 config/user_preferences.json 中的 vertical_format 设置

文件结构

arch-video-cut/
├── SKILL.md                    # 本文件
├── SELF_LEARNING_GUIDE.md      # 自学习详细指南
├── README.md                   # 快速入门指南
├── config/
│   └── user_preferences.json   # 用户偏好配置
├── scripts/
│   ├── full_workflow.py        # 主剪辑脚本
│   ├── preference_learner.py   # 偏好学习模块
│   └── manage_preferences.py   # 偏好管理工具
└── data/
    ├── m1/                     # 输入视频文件夹
    ├── temp_edit/              # 临时文件目录
    └── *.mp4                   # 输出视频文件

版本信息

v1.0.0 - 2026-03-18

• ✅ 多视频合并 + 时长压缩
• ✅ 自定义字幕文本
• ✅ 背景音乐生成与混合
• ✅ 横屏 + 竖屏双版本输出
• ✅ 自进化偏好系统

作者

WildUrban Architect - 林望明

网站： http://www.ual-studio.com/

Arch Video Cut

让工具适应你，而不是你去适应工具。🧠

简介

Arch Video Cut 是一个用于视频剪辑的 AI 工具，支持快速裁剪、分割和导出视频片段。适用于需要高效处理视频内容的用户，如内容创作者、教育工作者和媒体编辑。

功能特性

• 支持多种视频格式输入（MP4, MOV, AVI, MKV）
• 智能时间轴定位与自动剪辑建议
• 一键裁剪指定时间段的视频
• 支持批量处理多个视频文件
• 导出为常见格式（MP4, WebM, GIF）
• 可自定义输出分辨率与码率

使用方法

安装依赖

pip install -r requirements.txt

启动服务

python app.py

API 调用示例

{
  "method": "POST",
  "url": "http://localhost:5000/api/v1/cut",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  "body": {
    "input_file": "/path/to/video.mp4",
    "start_time": "00:01:30",
    "end_time": "00:02:45",
    "output_format": "mp4",
    "resolution": "1280x720",
    "bitrate": "1500k"
  }
}

配置说明

常见问题

如何获取 API Key？

在配置文件中设置 API_KEY 字段，或通过环境变量 ARCH_VIDEO_CUT_API_KEY 传入。

支持哪些时间格式？

支持以下格式：

• HH:MM:SS
• MM:SS
• SS

是否支持中文路径？

是，支持包含中文字符的文件路径。

版权与许可

本项目采用 MIT 许可证，允许自由使用、修改和分发。

*Made with ❤️ by skillppc*