# lesson-cut

**Repository Path**: cmw/lesson-cut

## Basic Information

- **Project Name**: lesson-cut
- **Description**: 录课快剪 - OBS智能录课助手软件
| 适用范围 | OBS Studio 28.0 及以上版本 | 核心场景 | 网课定时录制、首尾及静音冗余裁剪、品牌片头片尾合成、版权水印叠加、硬件加速课件体积压缩 |
| 目标用户 | 在线教育讲师、知识付费创作者、教育机构运营人员。
解决痛点：时长管控难、后期处理繁、文件体积大、工具切换杂

- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-15
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 录课快剪 (LessonCut)

面向在线教育讲师与内容创作者的 **OBS 智能录课助手 Windows 桌面应用**。
一站式集成「定时录制管控、智能静音与首尾裁剪、片头片尾合成、版权水印、硬件加速压缩」五大能力，
通过 **单次滤镜链 (Single-Pass Filtergraph)** 动态指令合并技术，实现「录课即成品」的自动化流水线。

- 版本：V1.2 (架构优化版)
- 平台：Windows 10 (1809+) / 11 x64
- 前端：pywebview + Edge WebView2 + 原生 HTML5/CSS3/ES Modules
- 后端：Python 3.11 + obs-websocket v5 客户端 + FFmpeg
- 打包：PyInstaller onedir + Inno Setup

## 目录概览

```
lesson-cut/
├── app/                # Python 后端与桥接层
├── web/                # WebView 内嵌的前端资源
├── resources/          # 图标、默认提示音、字体等
├── vendor/ffmpeg/bin/  # 打包前放置 ffmpeg.exe / ffprobe.exe（不入库）
├── installer/          # Inno Setup 脚本
├── scripts/            # 构建 / 环境检测 / 抓取 FFmpeg 脚本
├── requirements.txt
├── pyproject.toml
└── README.md
```

## 开发者快速开始

1. 安装 Python 3.11 x64。
2. 建议使用虚拟环境：
   ```powershell
   python -m venv .venv
   .\.venv\Scripts\Activate.ps1
   pip install -r requirements.txt
   ```
3. 放置 FFmpeg 二进制到 `vendor/ffmpeg/bin/`（`ffmpeg.exe`、`ffprobe.exe`）。
   可运行 `scripts/fetch_ffmpeg.ps1` 从 gyan.dev 自动抓取指定版本 static 构建。
4. 启动 OBS（≥ 28.0），在 `工具 → obs-websocket 设置` 中启用服务，默认 `ws://127.0.0.1:4455`。
5. 运行开发模式：
   ```powershell
   .\scripts\run_dev.bat
   ```

## 运行单测

```powershell
pytest -q
```

## 构建安装包

```powershell
.\scripts\build_app.bat        # PyInstaller onedir
.\scripts\build_installer.bat  # Inno Setup 生成 LessonCut-Setup-x64.exe
```

## 分阶段交付

- 阶段 1：基础设施（配置 / 日志 / OBS 客户端 / FFmpeg 检测 / pywebview 骨架）
- 阶段 2：定时录制管控
- 阶段 3：FFmpeg 单次渲染引擎
- 阶段 4：全局设置 + 打包 + E2E 收敛