GitHub 2.7k Star：飞鼠格式
从零部署完整教程 · 新手照着做就能跑起来 · 效率工具指南 · 原创教程
本文介绍飞鼠格式（FlyingMouse Format）在 Windows 环境下的部署教程。飞鼠格式是一款免费离线的万能文件格式转换工具，内置 FFmpeg/LibreOffice/Poppler/Tesseract 四大引擎，支持几十种格式互转、OCR 识别、网易云/QQ音乐/酷狗音乐解密。本文重点讲解源码部署方式（含 4 引擎下载配置）。
一、它能解决什么问题
| 你的痛点 | 怎么解决 |
|---|---|
| PDF 转 Word 排版全乱 | 内置 pdf2docx 引擎，还原排版 |
| 网易云歌曲 ncm 放不了 | 解密 NCM/mflac/mgg/kgma 转 mp3 |
| 扫描件想提取文字 | OCR 识别，图片转 txt |
| 图片/音视频格式不兼容 | 几十种格式互转 |
二、为什么值得用
- 本地离线：文件不上传云端，隐私安全、断网也能用；
- 完全免费：无广告、无会员、无按次收费；
- 功能全面：格式转换 + OCR + 音乐解密，一个工具搞定。
⚠️ 非商用许可：个人免费使用，禁止商业售卖、套壳换皮。
三、环境要求
| 项目 | 要求 |
|---|---|
| Node.js | ≥18（源码部署需要，实测 v24.14.0） |
| git | clone 源码用 |
| 4 个引擎 | FFmpeg / LibreOffice / Poppler / Tesseract |
四、部署步骤（两条路径）
路径 1：官方安装包（一键安装）
- 打开下载页 https://github.com/LaoFeng-mouse/flyingmouse-format/releases/latest，下载
FlyingMouse-Format-Setup-0.5.1-x64.exe（约 617 MB，Windows 10/11 标准版）； - 双击安装（SmartScreen 提示就点「更多信息 → 仍要运行」）；
- 启动使用。
国内提示：GitHub 下载可能打不开，走下面「源码部署」路径。
路径 2：源码部署（国内推荐，实测走通）
步骤 1：clone 源码
gitclone https://github.com/LaoFeng-mouse/flyingmouse-format.gitcdflyingmouse-format步骤 2：配国内镜像 + 装依赖
npmconfigsetregistry https://registry.npmmirror.comsetELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/npminstall步骤 3：准备 4 个转换引擎（关键）
源码仓库不含引擎，需自行下载并设环境变量关联：
| 引擎 | 下载方式（国内） | 环境变量 |
|---|---|---|
| FFmpeg | gyan.dev 下载解压 | FLYINGMOUSE_FFMPEG_PATH |
| Tesseract 语言包 | git clone gitcode 镜像 tessdata | FLYINGMOUSE_TESSDATA_PATH |
| LibreOffice | 官方 CDN 下载 .msi 安装 | FLYINGMOUSE_LIBREOFFICE_PATH |
| Poppler | git clone 二进制镜像仓库 | FLYINGMOUSE_PDFTOPPM_PATH |
设环境变量（示例，路径按实际改）：
setx FLYINGMOUSE_FFMPEG_PATH"C:\engines\ffmpeg\bin\ffmpeg.exe"setx FLYINGMOUSE_TESSDATA_PATH"C:\Users\用户名\tessdata"setx FLYINGMOUSE_LIBREOFFICE_PATH"C:\Program Files\LibreOffice\program\soffice.com"setx FLYINGMOUSE_PDFTOPPM_PATH"C:\Users\用户名\mirror-poppler2103w64\poppler-21.03.0\Library\bin\pdftoppm.exe"步骤 4：启动
npmrun desktop启动日志出现FlyingMouse Format started且不再报缺引擎，即成功。
五、怎么用（场景化）
- 图片格式转换：拖入图片（png/jpg/heic/RAW 等），选目标格式转换；
- Office 文档转换：docx/wps/xlsx 转 pdf/docx/odt，PDF 转 Word 还原排版；
- PDF 处理：PDF 转 Word/Excel/图片，扫描版自动 OCR；
- OCR 识别：含文字的图片转 txt；
- 音乐解密：网易云 ncm、QQ 音乐 mflac/mgg、酷狗 kgma 解密转 mp3/flac；
- 音视频转换：mp4/mov/mkv 互转，可选 H.264/H.265/AV1 编码。
六、踩坑与解决（实测）
⚠️ 坑 1：GitHub 网页/release 打不开，但 git clone 能通—— 优先 git clone 源码；下载二进制找 git 仓库里的二进制或国内镜像（gitcode gh_mirrors）。
❗ 坑 2：npm 配 electron 镜像报错——
npm config set electron_mirror报「not a valid option」，改用环境变量set ELECTRON_MIRROR=...。
⚠️ 坑 3：免费镜像/加速服务不稳定—— gitclone.com 502、清华镜像失效，多备渠道逐个试，gitcode gh_mirrors 更稳。
💡 坑 4：gitcode 镜像 release 下载仍跳 GitHub—— gitcode 只镜像源码，二进制在 git 仓库里的项目用 git clone 拿。
❗ 坑 5：Poppler 二进制只在 release—— 用 git clone「二进制放 git 仓库里」的镜像仓库（mirror-poppler2103w64）。
💡 坑 6：setx 环境变量当前窗口不生效—— 新开命令行窗口再启动。
❗ 坑 7：源码运行报缺引擎—— 按步骤 3 逐个下载引擎并设环境变量。
七、功能验证（实测）
- 源码启动成功，Web UI 正常；
- 4 个引擎全部探测成功，无报错；
- 转换功能实测可用。
八、总结
飞鼠格式是一款实用、免费、离线的万能格式转换工具。官方 exe 一键安装最简单，国内下载打不开就走源码部署（clone + 装依赖 + 配置 4 引擎）。部署好后，格式转换、OCR、音乐解密一个工具全搞定。
项目地址：[LaoFeng-mouse/flyingmouse-format] (https://github.com/LaoFeng-mouse/flyingmouse-format)
标签：飞鼠格式、格式转换、文件转换、Windows、源码部署、OCR、音乐解密
