给廉价 MP4 / MP5 小播放器转片专用的视频格式转换器。AMV 一键转换，纯浏览器本地转码，文件不上传。
基于 ffmpeg.wasm（WebAssembly 版 FFmpeg），专门针对廉价 MP4 播放器的 AMV 格式做了完整的参数适配：拖入视频 → 选 AMV → 回车，出来的文件直接拷进播放器就能放。同时也支持 MP4 / WebM / MKV / MOV / AVI / GIF / MP3 / M4A / WAV 等常规格式，带分辨率、缩放、帧率、码率等高级参数。
提供 Windows 单文件 exe（约 150 MB，无需安装 Node.js，双击即用），也有源码运行方式。
- AMV 快速上手
- 下载与运行
- 单文件版（一个 exe，无需 Node.js）
- AMV 格式详解
- 设备屏幕适配
- 转出来的 AMV 播放器不认？排查清单
- 其它输出格式
- 高级参数
- 多线程加速
- 退出方式
- 输出体积说明
- 性能提示
- 常见问题 FAQ
- 开发与构建
- 发布到 GitHub
- 目录结构
给 MP4 小播放器转片，三步：
- 选格式：在「输出格式」里点 AMV，参数会自动锁定为播放器兼容的值（160×120 · 15fps · ADPCM 单声道 22050Hz）
- （可选）量屏幕：用尺子量出播放器屏幕的长和宽填进「设备屏幕适配」，自动推荐合适的分辨率，一键选横屏 / 竖屏
- 拖入视频，按
Ctrl + Enter，等进度走完，点结果里的下载链接，把文件拷到播放器即可
切换去其它格式时会自动恢复你之前的参数；刷新页面参数也不会丢（localStorage 自动记忆）。
从 Releases 下载 VideoForge.exe（约 150 MB），双击即用。不需要安装 Node.js，拷贝到任何 Windows 电脑上都能跑，也可以直接拷贝到播放器配套的电脑上离线使用。
双击 start.bat：优先启动 dist/VideoForge.exe，没有则回退到 Node.js 方式，并自动打开浏览器（默认 http://localhost:5173）。
npm start # 启动服务，手动打开 http://localhost:5173
node server.js --open # 启动并自动打开浏览器
node server.js --no-open 8888 # 不自动开浏览器，指定端口要求 Node.js 20+（单文件构建需要；仅跑源码 18+ 也可以）。
必须通过
http://访问，不能直接双击index.html。浏览器对file://下的 ES Module 与 Web Worker 有安全限制。
VideoForge.exe 把 Node 运行时 + 全部网页资源（index.html、assets/、vendor/，含约 62 MB 的 ffmpeg.wasm）打进了同一个文件：
- 使用 Node 20+ 内置的 **SEA（Single Executable Applications）**方案，不依赖 pkg / nexe 等第三方打包器
server.js检测sea.isSea()后直接从内嵌资源读取文件发给浏览器，不在磁盘释放任何临时文件build.js会自动探测当前 Node 版本的 SEA sentinel（不同 Node 构建该值可能不同，硬编码会失败），无需手工配置- 单文件版双击运行时默认自动打开浏览器（
--no-open可关闭），Ctrl+C / 关页面均可退出
npm install # 安装 devDependency：postject
npm run build # 产出 dist/VideoForge.exe（约 152 MB）想换程序名，改 build.js 里的 OUT_EXE；想换图标，可在构建后用 ResourceHacker 等工具处理。
| 参数 | 说明 |
|---|---|
--open |
启动后自动打开浏览器（单文件版默认开启） |
--no-open |
不自动打开浏览器 |
8888 |
指定端口（默认 5173，被占用时自动顺延，最多试 20 个） |
PORT=8888 node server.js |
也可以用环境变量指定端口 |
AMV 是廉价 MP4 / MP5 播放器（一两块钱到几十块钱那种小屏播放器）使用的一种动画格式：RIFF/AVI 变体容器，视频为 MJPEG 变体，音频为单声道 ADPCM。市面上绝大多数"只能放 AMV"的播放器，用普通转码软件很难直接输出合规的文件——这个工具就是把 FFmpeg 的 AMV 相关参数全部调好，让你不用记任何命令行。
- 各类廉价 MP4 / MP5 / MP6 小屏播放器（1.8" / 2.4" / 3" 屏常见）
- 屏幕以 320×240、160×120 为主，部分为 240×320 竖屏
- 说明书标注支持 "AMV" 或 "MTV" 格式的机型基本都能用
- 部分设备同时认 AVI(MJPEG)，本工具输出 AVI 时用 MPEG-4 + MP3，可作为备选
转 AMV 时应用会自动锁定并处理以下限制，不需要你操心：
| 参数 | 锁定值 | 原因 |
|---|---|---|
| 视频编码器 | amv |
不是普通 mjpeg，普通 mjpeg 大部分播放器不解 |
| 音频编码 | adpcm_ima_amv · 22050 Hz · 单声道 |
AMV 容器只支持这一种音频组合 |
| 音频块大小 | block_size = 22050 / 帧率 |
容器规定，所以帧率必须能整除 22050 |
| 可选帧率 | 10 / 14 / 15 / 18 / 21 / 25 / 30 fps（默认 15） | 只有这些值能整除 22050 |
| 高度对齐 | 120 不是 16 的倍数，自动加 -strict -1 |
否则编码器拒绝写出 |
| 默认分辨率 | 160×120 | 播放器兼容性最好的档位 |
- 默认 160×120：绝大多数廉价播放器流畅播放
- 不建议超过 224×176：更高分辨率部分设备直接无法解码或卡成幻灯片
- 屏幕是 320×240 的机型可以试 224×176，先拿 1 分钟短片试播确认
- 用「设备屏幕适配」功能量屏幕定比例，比手填更稳
给 MP3 / MP4 小屏播放器转视频时，先用尺子量出屏幕的宽和高（单位随意，两边一致即可）：
- 填入长宽 → 自动反推屏幕比例，误差 2.5% 内吸附到最接近的标准比例（4:3 / 16:9 / 3:2 …），否则按实测比例输出
- 按「长边像素」推荐偶数分辨率（默认 320，覆盖绝大多数廉价播放器；越高越清晰但文件越大）
- 点「横屏播放」或「竖屏播放」直接写入自定义尺寸，并自动跳到「分辨率 / 缩放」页；缩放方式保持用户自己的选择
说明书里标注了屏幕分辨率（如 320×240）时可勾选「已知设备分辨率」，比例校验一致后直接采用。输入格式为 AMV 时自动收敛到 160×120 以内的容器上限。
按出现频率排序，逐条检查：
- 分辨率超了：别超过 224×176，默认 160×120 最稳
- 帧率不对：只用 10 / 14 / 15 / 18 / 21 / 25 / 30 这几档（工具已限制，手填自定义时注意）
- 文件放错了位置：拷贝到播放器根目录，或设备说明书指定的文件夹（有些机器只扫一级目录）
- 文件名太长 / 中文名：部分老设备 FAT32 文件系统对长文件名支持差，改成简短的英文名试试
- 文件系统不兼容：个别老机器只认 FAT32，exFAT / NTFS 会读不到
- 先试短片：任何新参数先拿 1 分钟片段试播，确认能放再转整片
- 换个备选格式：机器认 AVI 的话，用 AVI(MPEG-4 + MP3) 输出对比试试
| 格式 | 编码组合 | 用途 |
|---|---|---|
| AMV | AMV(MJPEG) + ADPCM | 廉价 MP4 小播放器（本工具主打） |
| AVI | MPEG-4 + MP3 | 老设备 / AMV 不认时的备选 |
| MP4 | H.264 + AAC | 最通用 |
| WebM | VP8 + Vorbis | 网页嵌入 |
| MKV | H.264 + AAC | 多轨封装 |
| MOV | H.264 + AAC | 剪辑软件 |
| GIF | 256 色调色板 | 动图 |
| MP3 / M4A / WAV | 仅音频 | 提取音轨 |
- 分辨率：保持原始 / 4K / 2K / 1080p / 720p / 480p / 360p / 240p / AMV 160×120 / 自定义（支持只填宽或高，另一边按比例算）
- 设备屏幕适配：量屏幕、反推比例、推荐分辨率、一键横竖屏（详见上文）
- 缩放方式：适应留边（pad）、填满裁切（crop）、强制拉伸、仅限宽度、仅限高度、不缩放；可配置留边颜色与重采样算法（lanczos / bicubic / bilinear / nearest / area）
- 帧速率：保持原始 / 60 / 50 / 30 / 25 / 24 / 23.976 / 15 / 12 / 10 / 自定义；帧率模式支持 CFR / VFR / 透传
- 视频编码：编码器、CRF 恒定质量或目标码率、x264 速度预设、像素格式、GOP
- 音频编码：重新编码 / 直接复制 / 移除，编码器、码率、采样率、声道
- 其它：起止时间裁剪、faststart、移除元数据
- 实时命令预览（可复制）与运行日志
- 参数自动记忆：所有转换参数保存在浏览器 localStorage，刷新 / 重开自动恢复；隐私模式或存储被禁用时自动降级，不影响使用
- 暗色单一强调色设计，控件统一规格；结果列表跨任务保留，"清空"按钮单独清理
- AMV 预设透明化：参数区顶部显示锁定说明（160×120 · 15fps · ADPCM 单声道 22050Hz），切走时自动恢复之前的参数（刷新后直接进入 AMV 则重置为默认）
- "复制视频流"开启时，分辨率 / 帧率区显示"不生效"提示；GIF / AMV 下该开关禁用并说明原因（这两种格式必须重新编码）
- "恢复默认"需二次确认，点击后 2.6 秒内再次点击才生效，同时清除已保存的参数
- 起止时间、自定义尺寸实时校验，错误信息直接显示在对应输入框下方
- 快捷键
Ctrl + Enter开始转换；运行日志可折叠，引擎加载与转码开始时自动展开 - 转换结果提供下载链接，任务卡片显示结果数量
server.js 会发送 Cross-Origin-Opener-Policy: same-origin 与 Cross-Origin-Embedder-Policy: require-corp，让页面进入 cross-origin isolated 状态，从而启用 SharedArrayBuffer。
- 检测到隔离环境时自动加载
vendor/core-mt/（多线程构建），线程数固定为 4——这是运行时 pthread 池的上限，超过会死在等线程创建上 - 未检测到隔离（例如用
npx serve等第三方静态服务器打开）时，自动回退vendor/core/单线程构建 - 多线程运行时启动失败也会自动回退
- 实测：2 秒 720p H.264 转码从 9.1s（单线程）降到 3.9s（4 线程）；GIF 从 20s 降到 7s
| 方式 | 行为 |
|---|---|
| 关闭浏览器标签页 / 窗口 | 页面通过 /__events（SSE 长连接）与服务端保持连接，最后一个页面关闭 3 秒后服务端自动退出 |
| 刷新页面 | 不会误退出——旧连接断开后新连接秒建，3 秒宽限期足以覆盖 |
| Ctrl+C | 立即优雅退出（强制断开全部保活连接，1.5 秒兜底强退） |
访问 /__quit |
浏览器打开 http://localhost:5173/__quit 手动退出 |
多个标签页同时打开时，全部关闭才会退出；只关其中一个服务继续运行。
转码是按目标质量重新分配码率，不是"打包压缩"。源文件本身码率越低，越容易在重编码后变大：
- CRF 模式是画质优先：默认 CRF 23 接近"视觉无损"，如果源视频只有几百 kbps（长时间录屏、AI 生成短片常见），重编码会把这个画质水平重新"买"回来，输出通常是源文件的 2~4 倍
- GIF 没有码率概念：每帧独立压缩 + 256 色 + 抖动，体积只受分辨率和帧率影响，长视频转 GIF 必然暴涨
- AMV（MJPEG）压缩率有限：160×120 也要约 300 kbps，10 分钟以上就会超过大部分源文件
- WAV 是未压缩 PCM：约 10 MB/分钟（48kHz 立体声）
应用内的对应机制：
- 底栏与命令预览会显示预估输出体积（经验模型，误差 ±50%，用于判断"会不会比源文件还大"）
- 预计大于源文件时会给出体积提醒，并可一键切换到"体积优先"（CRF 27 · 音频 96k）
- MJPEG / MPEG-4 / AMV 使用 qscale 质量控制，映射曲线已按老编码器的压缩效率校准（CRF 15 → q12，而不是过去偏松的 q10）
- GIF 默认抖动已从
bayer_scale=5降为3，同画质下体积更小
想手动控制体积：提高 CRF（26~30）、切换"目标码率"模式、降低分辨率 / 帧率，或先用起止时间截短片段。
浏览器内转码受单线程 WebAssembly 限制，速度约为实时的 0.3～1 倍。1080p 以上、VP9、GIF 调色板生成都会明显变慢，建议先用短片段试跑。超大文件（> 512 MB）可能触发浏览器内存上限。
Q：转出来是给什么设备用的？ 各类廉价 MP4 / MP5 小屏播放器（说明书标注支持 AMV / MTV 格式的机型）。默认输出 160×120 · 15fps，绝大多数机器能直接放。
Q：转档是离线的吗？会上传文件吗？
全程在浏览器里用 WebAssembly 跑 FFmpeg，文件不经过任何服务器。唯一的网络请求是首次打开页面时从本地服务加载 32～33 MB 的 wasm 运行时（之后走浏览器缓存）；用 VideoForge.exe 时连这个请求也是本地的。
Q：为什么帧率只能选 10/14/15/18/21/25/30 这几个值？ AMV 容器规定音频块大小 = 22050 / 帧率，只有能整除 22050 的帧率才合法，其它值写出来的文件播放器不认。这是格式限制，不是工具偷懒。
Q：为什么关掉浏览器窗口后，服务还在跑？ 旧版本只能 Ctrl+C 退出。现在页面与服务端有一条保活长连接，最后一个标签页关闭 3 秒后服务端自动退出；多标签页时全部关闭才退。刷新页面不会误退出。
Q：exe 被杀毒软件报毒怎么办？
SEA 打包方式是改写官方 node.exe 的签名区注入数据，属于正常现象（同类工具 pkg / nexe 同样如此）。如有误报请添加信任。
Q：端口被占用？
默认 5173，被占用时自动往后顺延（最多试 20 个），启动日志里会显示实际地址。也可以用 node server.js 8888 或 VideoForge.exe 8888 手动指定。
Q：第一次打开白屏 / 引擎加载失败？
首次加载需要从本地服务拉取 32～33 MB 的 wasm，耐心等几秒；确认是通过 http://localhost:端口 访问而不是 file://。多线程加载失败会自动回退单线程，日志里有说明。
Q：转换结果存在哪里？ 结果只在浏览器内存里，通过下载链接保存。刷新或关闭页面前记得先下载，再拷进播放器。
Q：想命令行批量转换？ 本项目是 GUI 优先设计，暂无 CLI 批量模式。可以打开多个标签页并行处理不同文件。
npm install # 安装开发依赖（仅 postject，用于打包）
npm run dev # 开发模式：启动服务并自动打开浏览器
npm start # 启动服务（不自动开浏览器）
npm run build # 打包 dist/VideoForge.exe技术要点：
server.js零依赖（仅 Node 内置模块），同时是 SEA 单文件版的宿主：检测sea.isSea()后从内嵌资源读文件，否则读磁盘build.js收集index.html+assets/+vendor/白名单扩展名文件 → 生成sea-config.json→node --experimental-sea-config生成 blob → 复制node.exe→ postject 注入 → 输出dist/VideoForge.exe- 转码全程在 Web Worker 中执行，主线程不卡顿；日志按 150ms 批量写入 DOM，避免多线程下的高频日志拖死主线程
- 转码过程有看门狗：两分钟无进度会自动中止
ffmpeg.wasm运行时已本地化到vendor/，离线可用
仓库里不包含 dist/VideoForge.exe（超过 GitHub 100 MB 单文件限制，已在 .gitignore 中排除），发布方式：
# 1. 提交代码
git add .
git commit -m "release: v1.1.0"
git push
# 2. 打 tag 并创建 Release，把 exe 作为附件上传
gh release create v1.1.0 dist/VideoForge.exe --title "v1.1.0" --notes "首个单文件版"没有 gh 也可以在 GitHub 网页端操作：Releases → Draft a new release → 上传 dist/VideoForge.exe 作为附件。
根目录的测试视频（
.flv等）已被.gitignore排除，不会被提交，也不会打进 exe。
index.html 页面结构
start.bat Windows 一键启动（优先单文件版）
server.js 零依赖静态服务器（SEA 单文件版宿主）
build.js 单文件打包脚本（Node SEA）
assets/styles.css 样式
assets/js/app.js UI 与状态管理
assets/js/builder.js ffmpeg 参数与滤镜构建
assets/js/device-fit.js 设备屏幕适配：比例吸附 / 分辨率推荐
assets/js/engine.js ffmpeg.wasm 封装
assets/js/formats.js 格式 / 编码器 / 预设定义
assets/js/storage.js 参数持久化（localStorage）
vendor/ffmpeg/ ffmpeg.wasm 客户端（ESM）
vendor/core/ ffmpeg-core.js + wasm（单线程）
vendor/core-mt/ ffmpeg-core.js + wasm（多线程）
MIT