A Phoebe-themed, offline file converter that runs in your browser. / 一款由菲比陪你使用、可离线运行的文件格式转换工具，直接在浏览器里使用。
- 菲比主题界面：菲比会跟随上传、识别、批量、OCR、PDF、转换成功或失败切换动作；转换时会亲手操作转换机。
- 本地离线转换：使用 FFmpeg、LibreOffice、Poppler、Tesseract.js 和 AVS3 解码器；按本地模式运行时，文件只在你的电脑上处理。
- 静默后台转换：Windows 下启动 FFmpeg、Poppler、LibreOffice 和 AVS3 时隐藏命令行窗口，不在转换过程中弹出黑色控制台。
- 支持图片、文本、Word/WPS、Excel/WPS、PPT/WPS、PDF、音频、视频和 ZIP。
- NCM 解密与转码：支持来自
music.163.com对应网易云音乐客户端的常规 NCM，以及 Audio Vivid（AV3A）NCM。 - 操作记忆：按“源文件格式”分别记住上次选择的目标格式；重新修改后，新选择会成为该源格式的默认值。
- 中文/English 界面：首次打开跟随系统语言，手动选择后会记住设置。
- 批量转换：显示逐文件进度、结果和失败原因，并可单独保存或保存全部。
- 转换质量：HTML / Office 转 Markdown 保留标题、列表和代码块；CSV 支持 BOM、转义引号和字段内换行。
- PDF → Excel（智能表格提取）：支持电子文字坐标、扫描页 OCR、有框/无框表格、多表、跨页续接、合并单元格、低置信度批注与 Raw 回退。
- 资源保护：单图 50MP / 16384px、图片合并 PDF 总计 100MP、批量 2GB、PDF 500 页、OCR 100 页。
NCM 说明：仅保证支持
music.163.com对应客户端下载的音乐文件。其他网站或来源虽然扩展名也可能是.ncm，但内部格式不同，不属于本项目的兼容范围。
npm install
npm run setup:windows
npm start启动后会自动打开浏览器访问 http://127.0.0.1:5177 ；也可以手动在浏览器里打开这个地址。拖入文件，选择目标格式并开始转换即可。
- 服务只监听本机
127.0.0.1，不会开放到局域网。 - 目标格式、语言等偏好会保存在浏览器本地（localStorage），刷新后仍保留。
- 转换结果通过浏览器直接下载。
源码仓库不包含体积较大的 FFmpeg、Poppler 和 OCR 数据；首次运行
npm run setup:windows会按runtime-requirements.json下载、校验并安装项目内便携引擎。LibreOffice 可使用系统安装版或FLYINGMOUSE_LIBREOFFICE_PATH指定的soffice.com。完整环境要求见REQUIREMENTS.md。
运行测试：
npm test- Phoebe-themed UI with animated state changes for upload, detection, conversion, batch work, OCR, PDF work, success, and errors.
- Fully local conversion with FFmpeg, LibreOffice, Poppler, Tesseract.js, and an AVS3 decoder. In local mode, files never leave your computer.
- Silent background conversion on Windows: FFmpeg, Poppler, LibreOffice, and AVS3 run without opening console windows during a conversion.
- Converts images, text, Word/WPS, Excel/WPS, PPT/WPS, PDF, audio, video, and ZIP files.
- Decrypts and converts standard NCM plus Audio Vivid (AV3A) NCM from the NetEase Cloud Music client associated with
music.163.com. - Remembers the chosen target separately for each source extension. Changing it replaces that extension's default.
- Chinese and English UI. The first launch follows the system language; a manual choice is remembered.
- Batch conversion with per-file progress, results, error details, individual save, and Save All.
- Higher-quality text conversion: structural HTML/Office Markdown plus standards-compliant quoted and multiline CSV parsing.
- PDF → Excel smart table extraction for digital text and scanned pages, including multiple tables, continued pages, merged cells, confidence notes, and Raw fallback.
- Resource safeguards: 50 MP / 16384 px per image, 100 MP image-to-PDF decode budget, 2 GB batches, 500 PDF pages, and 100 OCR pages.
NCM scope: compatibility is guaranteed only for files downloaded by the NetEase Cloud Music client associated with
music.163.com. Files from other sites may use a different internal format despite sharing the.ncmextension.
npm install
npm run setup:windows
npm startYour browser opens http://127.0.0.1:5177 automatically (or open the address manually). Drop in files, choose a target, and convert.
- The server listens on
127.0.0.1only and is not exposed to your LAN. - Target-format and language preferences persist in the browser (localStorage) across refreshes.
- Converted files download straight from the browser.
The source repository excludes the large FFmpeg, Poppler, and OCR data bundles. On Windows,
npm run setup:windowsdownloads, verifies, and installs the pinned portable engines fromruntime-requirements.json. LibreOffice may be installed system-wide or selected withFLYINGMOUSE_LIBREOFFICE_PATH. SeeREQUIREMENTS.mdfor the complete runtime contract.
当前版本定位为 Windows 10/11 上的本地、单用户转换工具。服务固定监听 127.0.0.1，转换接口只接受本机页面来源，因此不能原样作为公网文件转换服务部署。
- 个人远程使用：建议让服务继续监听
127.0.0.1，通过 SSH 端口转发或可信 VPN 访问。 - 域名或公网部署：必须先增加 HTTPS、允许来源配置、身份认证、CSRF 防护、请求限流、转换并发控制、任务隔离和持久化存储，并同步更新隐私政策。
- Linux 服务器：通过系统安装 FFmpeg、LibreOffice 和 Poppler 后，部分功能具备适配基础；
npm run setup:windows不能用于 Linux，Audio Vivid（AV3A）NCM 解码目前仍仅支持 Windows。 - 公网服务会接收并处理用户上传的文件，此时不能再宣称文件“不离开用户电脑”。
The current release is designed as a local, single-user converter for Windows 10/11. It binds to 127.0.0.1 and accepts conversion requests only from the local web origin, so it is not ready to be exposed as a public conversion service without further work.
- For private remote access, keep the service on
127.0.0.1and use an SSH tunnel or trusted VPN. - A domain or public deployment requires HTTPS, configurable allowed origins, authentication, CSRF protection, rate limiting, conversion concurrency controls, job isolation, persistent storage, and an updated privacy policy.
- Linux can support part of the conversion stack when FFmpeg, LibreOffice, and Poppler are installed separately, but
npm run setup:windowsis Windows-only and Audio Vivid (AV3A) NCM decoding currently requires Windows.
| Category / 类别 | Input / 输入 | Output / 输出 |
|---|---|---|
| Images / 图片 | jpg, png, webp, avif, tiff, gif, bmp, heic, heif | png, jpg, webp, avif, tiff, gif (动图), pdf, txt (OCR), mp4, webm |
| Text / 文本 | txt, md, html, json, csv, log, xml, yaml | txt, md, html, json, csv, pdf, docx |
| Word/WPS | doc, docx, odt, rtf, wps, wpt, wpd | pdf, docx, odt, rtf, txt, html, md |
| Excel/WPS | xls, xlsx, xlsm, ods, csv, tsv, et, ett | pdf, xlsx, xls, ods, csv, html |
| PPT/WPS | ppt, pptx, odp, dps, dpt | pdf, pptx, odp, html, png, jpg (逐页转图 zip) |
| xlsx, docx, txt, html, png, jpg, split/解密 PDF | ||
| Audio / 音频 | ncm, mp3, wav, flac, m4a, aac, ogg, opus, wma | mp3, wav, flac, m4a, ogg, aac, opus, wma |
| Video / 视频 | mp4, mov, mkv, webm, avi, m4v, wmv, flv | mp4, webm, mkv, mov, gif, mp3, wav, flac, m4a, ogg, aac, opus, wma |
| ZIP / 压缩包 | zip | pdf (图片合并) |
| Any file / 任意文件 | any | zip |
- In the default local deployment, files are processed on the user's computer and are not uploaded to a cloud conversion service. / 默认本地部署下，文件只在用户自己的电脑上处理，不上传到云端转换服务。
- The server binds to
127.0.0.1only and validates the request origin; it is not exposed to the network. / 服务只监听本机127.0.0.1并校验请求来源，不开放到网络。 - Privacy policy / 隐私政策
本项目基于 FlyingMouse Format 进行二次开发。
原项目作者：LaoFeng
原项目采用 MIT License，原版权声明与许可证内容予以保留。
Phoebe Format 在原项目基础上重新设计了菲比主题界面、角色状态素材及转换动画，并整理了运行环境和项目结构。更完整的来源说明见 NOTICE.md。
This project is a derivative of FlyingMouse Format, originally created by LaoFeng and released under the MIT License. The original copyright notice and license terms are retained. See NOTICE.md for details.
Source code is released under the MIT License. Bundled third-party components retain their respective licenses. / 项目代码采用 MIT License，内置第三方组件遵循各自许可证。