### [halfsize：把视频压到指定大小，再看看画质损失多少](https://www.appmiao.com/article/12099)

**Published:** 2026-11-06T06:04:18

**Author:** 阿喵#

**Excerpt:** halfsize 是免费开源的视频定容压缩工具，输入目标容量即可本地编码，并以 SSIM、VMAF 采样评估画…

## 阿喵前言

视频只比上传上限大了一点，就得反复改码率、导出、查看大小？更烦的是，好不容易压小了，却不知道画面糊了多少。halfsize 把这两件事放到一起：**输入想要的文件大小，本地压缩，再给出画质评分**。不用把私人视频传到陌生网站，不爱敲命令也能打开本地网页拖拽操作。

## 资源介绍

halfsize 是一款免费开源的视频压缩工具，适用于 Windows、macOS 和 Linux，需要 Node.js 18 或更高版本。它围绕“把视频压到指定容量”设计：自动计算码率、选择分辨率，用 FFmpeg 两遍编码，再通过 SSIM 和 VMAF 采样评估画质损失。

除了命令行，halfsize 也提供本地网页，可拖入视频、填写目标大小、选择 H.264 或 H.265，并下载压缩结果和分享卡。安装完成且相关依赖就绪后，视频处理在本机进行，无需账号或上传到云端。

### 截图

![halfsize本地网页的目标大小选择与画质评分界面](https://oss.amiao.app/website/2026/11/06060303/halfsize-ui-advmo-8df43fdba83d.webp)

本地网页界面，可设置目标容量并查看压缩结果。

![halfsize官方压缩结果分享卡](https://oss.amiao.app/website/2026/11/06060307/halfsize-card-advmo-608977b84dc6.webp)

项目提供的结果分享卡示例，图中数字为作者示例。

### 特色

-   **直接给容量：**支持 25mb、700k 等目标，不用自己换算码率。
-   **压完有反馈：**SSIM 与 VMAF 采样评分，配合画质变化描述。
-   **命令行或网页：**既能拖拽处理，也能批量执行并输出 JSON。
-   **文件不传云端：**本地 FFmpeg 编码，本地网页只监听 127.0.0.1。

### 注意

-   定容压缩并非无损；工具会预留容量余量，也可能降低分辨率。过小的目标、保留原分辨率等设置仍可能让结果偏离目标，发送前看一眼实际大小。
-   画质评分来自片段采样，不是整段视频逐帧保证；FFmpeg 构建缺少相关滤镜时，部分评分可能无法生成。首次安装需要联网获取程序和依赖。
-   HDR 转 SDR、硬件编码、字幕和多音轨透传仍在路线图中，处理重要素材时保留原文件。

## 使用教程

1.  安装 Node.js 18 或更高版本，然后打开终端。首次运行会获取 halfsize 和所需依赖；若 FFmpeg 下载失败，可安装系统版并运行 `npx halfsize@0.1.7 --doctor` 检查。
2.  把文件路径替换成自己的视频，执行下方命令。输出默认写入新的 MP4 文件，不必自己拼 FFmpeg 参数。

```
npx halfsize@0.1.7 video.mp4 --to 25mb
```

3.  不想用命令行处理视频，运行下面这条命令，在浏览器打开 `http://127.0.0.1:4174`，拖入视频并填写目标大小。

```
npx halfsize@0.1.7 --web
```

4.  压缩完成后检查输出容量、评分和实际播放效果，下载结果。也可以用 `--dry-run` 先看方案，或给出多个文件路径批量处理。内置平台预设会随版本变化，有明确限制时优先用 `--to` 手动指定。

## 资源获取

当前核实版本：**v0.1.7**，MIT 开源许可。[中文官网与教程](https://yklovepython.github.io/halfsize/zh/) · [GitHub 开源仓库](https://github.com/YKLovePython/halfsize) · [npm 安装入口](https://www.npmjs.com/package/halfsize)

**Tags:** FFmpeg, halfsize, Linux, macOS, VMAF, Windows, 命令行工具, 开源软件, 本地工具, 视频压缩

**Categories:** 开源项目

---