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：官方安装包（一键安装）

1. 打开下载页 https://github.com/LaoFeng-mouse/flyingmouse-format/releases/latest，下载 FlyingMouse-Format-Setup-0.5.1-x64.exe（约 617 MB，Windows 10/11 标准版）；
2. 双击安装（SmartScreen 提示就点「更多信息 → 仍要运行」）；
3. 启动使用。

国内提示：GitHub 下载可能打不开，走下面「源码部署」路径。

路径 2：源码部署（国内推荐，实测走通）

步骤 1：clone 源码

git clone https://github.com/LaoFeng-mouse/flyingmouse-format.git
cd flyingmouse-format

步骤 2：配国内镜像 + 装依赖

npm config set registry https://registry.npmmirror.com
set ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
npm install

步骤 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：启动

npm run 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 逐个下载引擎并设环境变量。

七、功能验证（实测）

1. 源码启动成功，Web UI 正常；
2. 4 个引擎全部探测成功，无报错；
3. 转换功能实测可用。

八、总结

飞鼠格式是一款实用、免费、离线的万能格式转换工具。官方 exe 一键安装最简单，国内下载打不开就走源码部署（clone + 装依赖 + 配置 4 引擎）。部署好后，格式转换、OCR、音乐解密一个工具全搞定。

项目地址：[LaoFeng-mouse/flyingmouse-format] (https://github.com/LaoFeng-mouse/flyingmouse-format)

标签：飞鼠格式、格式转换、文件转换、Windows、源码部署、OCR、音乐解密