Multi Source Sync
返回首页

Local Transcription

视频转文字本地工具安装教程

视频转文字使用你电脑上的免费本地工具：whisper-cli 负责识别语音，FFmpeg 负责读取视频，Whisper 模型负责听懂内容。插件不内置这些工具；准备完成后，转写在本机运行，不需要登录小红书，不消耗 AI API 费用，也不会把视频上传到插件作者服务器。

1 先准备工具

Windows 下载 whisper.cpp、FFmpeg 和模型；Mac 用 Homebrew 安装工具后下载模型。

2 填入模型路径

模型路径必须指向具体的 .bin 文件，例如 ggml-small.bin。

3 回插件里检查

点击“检查本地工具”，通过后即可转写当前笔记或批量处理。

下载链接 Windows 教程 Mac 教程 插件检查 常见问题

Downloads

只需要准备三个东西。

Windows 用户准备 whisper-cli.exe、一个 .bin 模型文件和 ffmpeg.exe。Mac 用户推荐用 Homebrew 安装 whisper-cli 与 ffmpeg，再下载同一个 .bin 模型文件。Apple Silicon 和 Intel Mac 都可以使用。

whisper.cpp

真正负责转写的程序。Multi Source Sync 调用其中的 whisper-cli，不需要提前打开额外服务窗口。

Whisper 模型

识别语音用的文件。新手优先下载 ggml-small.bin；电脑比较慢可以先用 ggml-base.bin。

FFmpeg

负责把 mp4、mov、webm 等视频转成 Whisper 能识别的音频。Windows 复制 ffmpeg.exe；Mac 用 Homebrew 安装。

工具 推荐链接 备用链接 说明
Windows whisper.cpp GitHub 最新发布 whisper-bin-x64.zip SourceForge 镜像 SourceForge x64 包 Windows 普通电脑优先下载 whisper-bin-x64.zip，插件会使用里面的 whisper-cli.exe 和同目录依赖文件。
Whisper 模型 模型列表 ggml-small.bin ggml-base.bin HF Mirror small 镜像 base 镜像 small 平衡准确率和速度；低配电脑先试 base。中文小红书视频不要下载 .en 模型，文件名请保留官方英文名。
FFmpeg Windows essentials 官方入口 BtbN GitHub 让 whisper.cpp 能读取常见视频格式。Windows 只需要复制压缩包里 bin 文件夹中的 ffmpeg.exe。
Mac Homebrew Homebrew 官方入口 whisper-cpp formula ffmpeg formula Mac 推荐执行 brew install whisper-cpp ffmpeg，然后把模型放到 ~/tools/whisper/models/。

Windows Setup

Windows 用户按这个顺序准备。

最终样子

先看最终文件夹应该长什么样。

下面只是示例位置。最新版插件支持模型所在的父目录包含中文，但模型文件名本身请继续使用 ggml-small.bin、ggml-base.bin 这类官方英文名。还没有更新插件时，把整套工具迁移到 D:\tools\whisper 即可立即绕过中文模型路径问题。

D:\tools\whisper\
  • whisper-cli.exe 插件调用的转写程序
  • whisper.dll、ggml.dll、ggml-cpu-*.dll 等 程序依赖文件，必须和 whisper-cli.exe 同一层，并且来自同一个 whisper.cpp Release
  • ffmpeg.exe 放在同一层，负责读取视频
  • models\
    • ggml-small.bin 模型文件，也可以换成 ggml-base.bin

ggml-small.bin 和 ggml-base.bin 都是模型文件，下载后不用解压，也不要改成中文文件名。官方 ggml-base.bin 应为 147,951,465 字节，SHA-256 为 60ED5BC3DD14EEA856493D334349B405782DDCAF0028D4B5DF4088345FBA2EFE；大小或校验值不一致时请重新下载。

1

建一个固定文件夹

例如新建 D:\tools\whisper。后面所有文件都放在这里，路径更短，也更方便以后继续使用。

2

解压 whisper.cpp

把 whisper-bin-x64.zip 解压后，找到 whisper-cli.exe 和解压包 Release 文件夹里的所有 .dll 文件，一起复制到 D:\tools\whisper。不要混用不同 whisper.cpp Release 的 CLI 和 DLL。

3

放入模型文件

在 D:\tools\whisper 里新建 models 文件夹，把 ggml-small.bin 或 ggml-base.bin 放进去。

4

复制 ffmpeg.exe

解压 ffmpeg-release-essentials.zip，进入里面的 bin 文件夹，把 ffmpeg.exe 复制到 D:\tools\whisper。

5

复制三个路径

在插件里分别填写模型文件、whisper-cli.exe 和 ffmpeg.exe 的路径。模型路径要写到具体文件，例如 D:\tools\whisper\models\ggml-small.bin。

6

检查本地工具

回到 Obsidian 插件的“视频转文字”区域，点击“检查本地工具”。新版会生成一段很短的测试音频并实际加载模型；只有 FFmpeg、CLI 和模型初始化都成功才会通过，测试临时文件会自动清理。

macOS Setup

Mac 用户用 Homebrew 准备工具。

先别下错

Mac 不需要下载 Windows 压缩包。

Mac 用户不要下载 Windows 的 whisper-bin-x64.zip、ffmpeg.exe 或 xcframework.zip。插件会直接调用本机的 whisper-cli 和 ffmpeg；你只需要安装工具并准备一个模型文件。插件已按 Apple Silicon 的 /opt/homebrew 和 Intel Mac 的 /usr/local 路径做过模拟验证。

~/tools/whisper/
  • models/
    • ggml-small.bin 模型文件，也可以换成 ggml-base.bin

这里的 ~ 表示你的 Mac 个人文件夹。模型 .bin 文件下载后不用解压；插件里可以填写 ~/tools/whisper/models/ggml-small.bin 这种路径，插件会自动识别到你的个人文件夹。

1

安装 Homebrew

如果 Mac 已经有 Homebrew，可以跳过这一步。没有的话，先去 Homebrew 官网按提示安装。

2

安装 whisper-cli 和 FFmpeg

打开 Mac 的“终端”，复制下面命令并回车。安装完成后，插件通常可以自动找到这两个工具。

brew install whisper-cpp ffmpeg
3

新建模型文件夹

继续在终端里复制下面命令并回车，用来创建 ~/tools/whisper/models 文件夹。

mkdir -p ~/tools/whisper/models
4

放入模型文件

把下载好的 ggml-small.bin 或 ggml-base.bin 放到 ~/tools/whisper/models 里。可以在 Finder 里按 Command + Shift + G，输入这个路径打开。

插件里检查

回到 Multi Source Sync，检查本地工具。

进入“视频转文字”区域，模型路径填写 ~/tools/whisper/models/ggml-small.bin 或你实际放置的模型文件，然后点击“检查本地工具”。

工具路径通常留空

Homebrew 安装后，插件会依次尝试 /opt/homebrew/bin/whisper-cli、/usr/local/bin/whisper-cli、whisper-cli，FFmpeg 也是类似逻辑。检查失败时再手动填写路径。

模型名可以换

如果你下载的是 ggml-base.bin，模型路径就填 ~/tools/whisper/models/ggml-base.bin。中文小红书视频不要下载 .en 模型。

不用保持终端打开

插件会按需启动转写命令，转写结束会自动清理临时文件。终端只在安装工具和创建模型文件夹时使用。本地保存的 mp4、mov、m4v、webm 等视频都可以进入转写流程。

Plugin Flow

回到插件里测试和转写。

  1. 使用这个功能前，先去发货网盘下载最新版插件，只覆盖 main.js、manifest.json 和 styles.css。不要删除 data.json、已同步 Markdown、媒体目录、账号目录或授权数据。
  2. 在 Multi Source Sync 里开启 视频本地化，并重新同步包含视频的小红书笔记。只有已经保存到本地的视频才能转写。
  3. 进入插件设置页的 视频转文字 区域。
  4. 填写 Whisper 模型路径。路径必须到具体 ggml-small.bin 或 ggml-base.bin 文件，不要只填 models 文件夹，也不要把模型文件本身改成中文名。
  5. Windows 用户建议同时填写 whisper-cli 路径 和 FFmpeg 路径；Mac 用户用 Homebrew 安装后通常可以留空。
  6. 点击 检查本地工具。它会实际加载一次模型；通过后，再点击 转写当前笔记视频 或 转写未处理视频。
  7. 插件会把结果写回原笔记的 视频转文字 章节；已有转写默认跳过。

Requirements

电脑配置和网络要求。

8GB 内存

可以先用 base 或 small 模型。长视频会慢，建议先转写短视频测试。

16GB 以上

更适合使用 small 或更大的模型，中文口播准确率会更稳。

网络只影响首次下载

转写过程不需要联网。首次下载 GitHub、Hugging Face 文件，或安装 Homebrew 工具时，如果网络不稳定，可以换网络后重试。

只支持桌面端

本地工具需要电脑运行，Obsidian 手机端暂不支持执行视频转文字。

FAQ

常见问题。

这个功能会产生按次费用吗？

不会。本地工具和模型本身免费。永久版解锁的是插件里的一键调用、批量处理和写回 Obsidian 笔记能力。

提示找不到本地视频怎么办？

通常是笔记里还是远程视频链接。请先在“同步内容”里开启“视频本地化”，重新同步对应视频，确认视频已经保存到本地媒体目录后，再回来转写。

检查本地工具失败怎么办？

新版“检查本地工具”会真实加载模型，不再只确认命令能否启动。先按错误提示检查 whisper-cli、ffmpeg 和模型文件；Windows 还要确认 CLI 与同目录 DLL 来自同一个 whisper.cpp Release。Mac 如果用 Homebrew，通常是 /opt/homebrew/bin/whisper-cli 或 /usr/local/bin/whisper-cli。

命令提示找不到模型文件怎么办？

检查模型路径里是否真的有 ggml-small.bin。Windows 常见位置是 D:\tools\whisper\models\，Mac 常见位置是 ~/tools/whisper/models/。如果你下载的是 ggml-base.bin，插件里的模型路径也要改成 ggml-base.bin。

Windows 提示 failed to initialize whisper context 怎么办？

这表示模型没有正确初始化。若仍在使用旧版插件，并且模型路径含中文，请先把整套工具迁移到 D:\tools\whisper；最新版已经支持中文父目录，但模型文件名本身仍要使用官方英文名。随后确认模型不是网页、Git LFS 指针或残缺文件；官方 ggml-base.bin 应为 147,951,465 字节，SHA-256 为 60ED5BC3DD14EEA856493D334349B405782DDCAF0028D4B5DF4088345FBA2EFE。最后确认 whisper-cli.exe 与全部 DLL 来自同一个 whisper.cpp Release。

Mac 只用 brew install whisper-cpp ffmpeg 够吗？

还需要下载一个 Whisper 模型文件。Homebrew 负责安装 whisper-cli 和 ffmpeg；模型建议放到 ~/tools/whisper/models/，然后在插件里填写具体模型路径。

为什么下载链接打不开？

GitHub 和 Hugging Face 在国内网络下可能慢或不稳定。可以换网络，或尝试表格里的 SourceForge、HF Mirror 备用链接。