# av-operator

**Repository Path**: clai/av-operator

## Basic Information

- **Project Name**: av-operator
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-08
- **Last Updated**: 2026-08-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AV Operator4 — Web 视频剪辑器

基于 Vue 3 的 Web 视频剪辑器，参考剪映 Web 网页版，实现素材导入、时间线编辑、预览播放、缩略图/波形、字幕与特效、项目持久化及视频导出。

## 技术栈

- Vue 3（`<script setup lang="ts">`）+ TypeScript + Vite
- Element Plus（浅色主题）
- Pinia + Vue Router
- Mediabunny（音视频解码 / 编码）
- Canvas 2D + Web Worker + OffscreenCanvas
- IndexedDB（项目持久化）
- Bun（包管理与运行时）

## 开发命令

```bash
bun run dev       # 启动开发服务（http://localhost:5173）
bun run lint      # golar 类型检查 + oxlint
bun run lint:fix  # oxlint 安全修复
bun run format    # oxfmt src/
bun run build     # lint -> format -> golar --build -> vite build
bun run preview   # 生产预览
bun test <file>   # 运行指定测试
```

## 架构概览

详细架构与代理规则见 [AGENTS.md](./AGENTS.md)。核心分层：

- `views/Editor.vue` — 编辑器总装配点
- `components/` — UI 组件（timeline / player / subtitle / effects / media / clip / export / layout）
- `services/` — 核心逻辑（timeline / effects / subtitle / player / media / audio / export / project）
- `commands/` — 可撤销命令与原子批处理
- `stores/` — Pinia 状态（三套时间线真相：媒体 clip / 独立特效段 / 独立字幕段）
- `composables/` — 拖拽、裁剪、键盘、Canvas 交互等会话层
- `workers/` — 缩略图、波形、导出 worker

### 三套时间线真相

项目存在三套独立但共享轨道布局的时间线实体：

1. **媒体 clip**（`timelineStore`）— 视频 / 音频 / 图片片段
2. **独立特效段**（`effectTimelineStore`）— `EffectInstance`，不存入 clips
3. **独立字幕段**（`subtitleTimelineStore`）— `SubtitleInstance`，不存入 clips

三者各自维护真相版本、增量索引、lane 容量与选择状态，正式增删改通过 command 进入历史栈。

## 环境要求

- Windows / PowerShell 或 Git Bash
- Bun
- 浏览器支持 OffscreenCanvas

## Mediabunny API 参考

使用 Mediabunny 前请查阅 `mediabunny-llm/llms-full.txt` 与 `mediabunny-llm/mediabunny.d.ts`。