Videome 是一款本地视频剪辑与批量混剪桌面工具,使用 React、Vite、Electron 和 FFmpeg/ffprobe。源素材、工程和渲染任务在本机处理。
当前版本:
1.0.0· 文档核对日期:2026-11-11
| 平台 | 目标与产物 | 验证状态 |
|---|---|---|
| macOS Apple Silicon | macOS 15.0+;.app、.dmg、App .zip |
本机 macOS 26 开发版及安装版已验证;macOS 15 云端构建与包内检查通过,实机人工验收待完成 |
| Windows x64 | NSIS 安装版 .exe、Portable 免安装 .exe |
Windows Server 2022 云端 73 项测试、打包及包内转码检查通过;Windows 11/10 人工验收待完成 |
目前交付内部测试包:Mac 使用 ad-hoc 本地签名,未做 Developer ID 签名或公证;Windows 未配置发行签名。Intel Mac、Windows ARM、32 位、商店发布和自动更新不在当前交付范围。具体证据见双平台实现与验收记录。
2026-11-05 的双平台成功构建 #6已上传安装包。历史构建可在运行页的 Artifacts 下载 Videome-win32-x64-6 或 Videome-darwin-arm64-6(需要登录 GitHub,保留 30 天);后续成功构建会自动出现在仓库的 Releases 中。
- 工程管理:无恢复记录时进入空白工程;项目菜单提供新建、打开、另存为和恢复切换前工程。工程位置可显示完整路径、复制路径并在 Finder / 文件夹中定位。
- 素材与时间线:导入视频、音频和图片,支持搜索、多选排序、拖放、裁切、分割、波纹删除、多轨叠加,以及视频原声联动。
- 本地预览:原片预览、缩略图和视频帧;Chromium 无法解码时,可按需生成 H.264 兼容代理。
- 字幕与配乐:手工字幕、SRT 导入导出及烧录;智能配乐工作台支持本地音乐分析、当前视频分析、最多 3 首推荐、临时试听、音量、循环铺满、淡入淡出和人声自动避让。
- 普通导出:H.264 / HEVC 高质量导出、FFV1 无损 MKV、VP9 / Opus WebM,以及符合条件的单片段原码流保留。
- 批量混剪:一个长视频自动切片、随机重组为独立 MP4;用户填写
1–1000条,支持固定种子、序列去重、受控并发、暂停、取消、失败重试和中断恢复。任意成功结果可重建为原始切片工程。 - 批量分段:一个视频按固定片段时长从头到尾顺序拆分为多个 MP4;自动保留短尾和原声,不添加背景音乐,支持进度、暂停、取消、预览和打开输出目录。
App 不附带海岛视频或音乐曲目。“项目 → 查看界面示例”只展示时间线布局,明确标注没有源文件。智能配音与字幕面板内的多语言语音识别均在 Apple Silicon Mac 本地运行;字幕 Whisper 模型可在字幕面板独立安装。智能配乐使用桌面端本地 FFmpeg/ffprobe 和轻量 JavaScript DSP 分析音乐与视频特征,不上传媒体、不接入在线曲库或云端语义模型;浏览器预览模式使用基础元数据和手动标签,详见功能与边界。
安装包用户可直接运行应用,无需安装 Node.js、FFmpeg 或 Homebrew。Mac 使用 DMG 安装或解压 App ZIP;Windows 安装版与 Portable 的操作步骤见人工验收指南。
- 从空白工程导入自己的素材,双击素材或拖入时间线。
- 在顶部修改项目名称,点击“保存”选择
.videome的位置;以后可从“工程位置”找到文件。 - 常规编辑从“导出成片”输出;批量任务从右上角“批量混剪”进入,填写数量并先分析再生成。
.videome 保存工程结构和素材路径,不复制源媒体。导入文件仍在原位置;本机恢复缓存、工程文件和成片输出目录各自独立。已有缓存会恢复上次内容,新建空白工程会保留素材库,并保留一份切换前工程快照。
原工程文件仅在点击“保存”、按 ⌘S 或“另存为”时更新。桌面版已关联工程每 10 秒备份到同目录的 <工程文件名>.autosave-时间戳.videome,每次使用新的时间戳并清理旧自动备份,只保留最近一份,不修改原文件;可通过“项目 → 打开工程”恢复备份。
使用 Node.js 24.x 和 npm,在 macOS arm64 或 Windows x64 执行:
npm ci
npm run media:prepare
npm run media:check
npm run desktop:devmedia:prepare 按版本及 SHA-256 清单准备当前平台 FFmpeg、ffprobe 和导出字体,需要联网。Mac 还需要 Xcode Command Line Tools 中的系统构建工具。桌面启动器使用 127.0.0.1:5173,退出时清理其子进程。
浏览器界面开发使用 npm run dev,地址为 http://127.0.0.1:4179。该模式只提供受限的本地媒体 API 和部分导出回退,不支持桌面工程文件操作或批量队列;浏览器与 Electron 的恢复缓存也不共用。
完整环境准备、资源导入和排错见开发与交付。
npm test
npm run build
npm run dist:mac
npm run verify:packageWindows 原生构建将 dist:mac 换为 dist:win。打包前先完成 media:prepare;dist:* 会检查并使用已有媒体资源,不自动重新下载。产物在 release/,Vite 静态资源在 dist/。
| 命令 | 用途 |
|---|---|
npm run media:prepare |
准备当前平台锁定的媒体工具与字体;bundle:media 是其别名 |
npm run media:check |
检查媒体架构、能力、字体摘要和 Mac 最低系统版本 |
npm run desktop:dev |
启动 Vite 与 Electron 开发桌面 |
npm run dev / npm start |
启动 4179 浏览器预览服务 |
npm run desktop |
仅启动 Electron;开发模式需先有 5173 服务 |
npm test |
运行领域、工程、媒体、队列和恢复测试;需要 FFmpeg/ffprobe |
npm run build |
生成 dist/ Web 资源 |
npm run dist:mac |
原生构建 arm64 App、DMG 和 ZIP |
npm run dist:win |
原生构建 x64 NSIS 和 Portable |
npm run verify:package |
验证包内模块、字体与实际转码,生成构建信息和摘要 |
npm run acceptance:fixtures |
生成供人工验收使用的 90 秒测试素材 |
npm run diagnostics |
收集本机环境及批次诊断到 output/diagnostics.json |
GitHub Actions 提供手动触发的 Desktop internal test packages 工作流,分别在 Mac 和 Windows runner 构建。两端构建和包内检查全部成功后,工作流会自动创建一个 GitHub 预发布版本,标签格式为 v<版本>-build.<运行号>(例如 v1.0.0-build.7),并附上 .dmg、.zip、Windows .exe 和 SHA256SUMS.txt。同一次运行重试时会更新同名 Release;构建过程仍会保留 Artifacts 作为诊断备份。工作流已提供不代表远程构建或人工验收已经通过。
src/ React 编辑器、批量面板、领域函数、工程会话恢复
main.jsx 编辑器入口与工程操作
BatchMixPanel.jsx 批量混剪配置、进度与结果
project-session.js 空白工程、恢复缓存与旧缓存读取
domain.js 时间线操作、音乐特征合并与推荐评分
electron/ 主进程、preload、工程/媒体/平台运行模块
batch/ 规划、媒体执行、队列、持久化与 IPC
music-analysis.cjs 本地音乐/视频特征分析、缓存与任务队列
music-analysis-ipc.cjs 音乐分析 IPC 和路径授权
scripts/ 开发启动、媒体准备、打包、诊断与验收脚本
resources/ 媒体锁文件、字体及第三方声明
.github/workflows/ 手动双平台构建工作流
docs/ 使用、架构、部署与验收文档
dist/ Web 构建产物(Git 忽略)
media-bin/ 当前平台媒体工具(Git 忽略)
release/ 桌面安装包与构建报告(Git 忽略)
output/ 下载缓存、测试素材、截图和验收结果(Git 忽略)
userData/music-analysis/ Electron 运行时的本机音乐/视频分析缓存(不在仓库)
| 文档 | 内容 |
|---|---|
| 功能说明 | 工程入口、素材、剪辑、字幕、导出及快捷键 |
| 批量混剪 | 参数、并发、去重、输出和恢复 |
| 批量分段 | 固定时长顺序分段、原声、输出和任务控制 |
| 开发与交付 | 环境、媒体依赖、构建、CI 与排错 |
| 架构与数据流 | 模块边界、IPC、工程会话和任务持久化 |
| 功能与操作说明 | 智能配乐工作台、本地分析、试听和曲库操作 |
| 本地智能配音计划 | 英文转中文的本地模型、编辑流程、入轨规则与验收标准 |
| 批量验收记录 | 两轮 200 条测试及性能限制 |
| 双平台实现与验收记录 | 已验证结果与待验收事项 |
| 双平台人工验收 | 安装包获取、逐步验收与诊断反馈 |
- 批量输出面向 SDR;检测到 HDR 会拒绝。完整 HDR / 10-bit 色彩管理尚未实现。
- 批量目录必须支持独占写入、硬链接及空间查询;本轮面向本地 APFS / NTFS。网络盘、UNC 和 exFAT 批量输出不在支持范围。
1–8路并发表示最大活动任务数,不保证 8 路最快;200 条是验收负载,不是固定生成数量。测试耗时不能直接推算其他素材或机器的性能。- 普通导出与批量导出的校验强度不同:批量会完整解码并核对帧数、时长和摘要;普通导出主要检查输出视频流。
- 当前仓库没有项目级
LICENSE。第三方声明位于 resources/THIRD-PARTY-NOTICES.txt,字体许可和媒体来源、版本及摘要随资源保存。正式发行还需完成发行签名、公证及目标环境验收。