导航：10 组 35 入口 · 内置插件：32 个 · 设置：11 分区

支持格式：MP4、AVI、MKV、WMV、MOV、FLV、WEBM、TS、MPEG、3GP

特殊能力：

• 流选择：可选择性保留/移除音视频流
• 编码兼容性校验：自动检测无损模式下的编码兼容性（如 H.265→FLV）
• 自动重命名：输出文件与输入同名时自动加 _1 后缀

支持格式：MP3、WAV、WMA、AAC、FLAC、OGG、M4A、AMR、OPUS

支持格式：JPG、PNG、BMP、GIF、TIFF、WEBP、ICO、TGA

支持格式：PDF、DOCX、DOC、WPS、XLSX、XLS、ET、CSV、PPTX、PPT、DPS、TXT、HTML、HTM、MD、EPUB、RTF、ODT、JPG、JPEG、PNG、BMP、TIFF、WEBP

168+ 种转换组合：

特殊能力：

• 格式检测：自动识别源文件格式并列出可转换目标
• Word转PDF：通过 Microsoft Word COM 自动化
• PPT转PDF：通过 Microsoft PowerPoint COM 自动化
• 格式兼容性实时提示：显示当前源/目标格式是否兼容

5种操作模式：

附加功能：

• 密码历史记录：保存最近10条密码，支持复用
• 密码显示/隐藏切换：点击眼睛图标切换

支持平台：B站、YouTube、微博、Instagram 等数百个平台（基于 yt-dlp）

从 Releases 页面下载最新版本，解压后双击 格式大师.exe 即可使用。

# 克隆仓库
git clone https://github.com/Gujh/FormatMaster.git
cd FormatMaster

# 安装依赖
pip install -r requirements.txt

# 运行应用
python main_qt.py

# 打包为exe
python build.py

• 界面: Python PySide6 + qfluentwidgets（Fluent Widgets，Prism 设计系统）
• 视频/音频: FFmpeg（自动下载或使用系统PATH）
• 图片: Pillow
• 文档: python-docx、openpyxl、python-pptx、pypdf、pdf2docx、reportlab、PyMuPDF
• Word转PDF: 调用本地 Microsoft Word COM 自动化
• PPT转PDF: 调用本地 Microsoft PowerPoint COM 自动化
• 视频下载: yt-dlp
• OCR: RapidOCR + RapidTable（onnx）
• 高级控件: QtPdf / QtWebEngine / QtMultimedia / QtDataVisualization（PySide6 内置）、pyqtgraph、superqt
• 图表: ECharts（本地离线资源）
• 文字转换: opencc（简繁词汇级转换）
• 打包: PyInstaller

FormatMaster/
├── main_qt.py           # 主程序入口（PySide6 界面）
├── build.py             # PyInstaller打包脚本
├── requirements.txt     # Python依赖
├── assets/
│   ├── icon.ico         # 应用图标
│   └── echarts/         # ECharts 本地离线资源（数据大屏）
├── gui_qt/              # PySide6 + Fluent Widgets 界面
│   ├── app.py           # MainWindow（FluentWindow + Mica）
│   ├── nav_registry.py  # 导航注册真源
│   ├── services.py      # QtServices 服务容器
│   ├── task_manager.py  # 任务队列（信号驱动，并行 1-8）
│   ├── pages/           # 首页/任务/历史/设置/关于
│   ├── panels/          # 功能面板（视频、音频、PDF、OCR 等）
│   └── components/      # 侧边栏、主题管理、设计系统、通用控件
├── plugins/             # 32 个内置插件（声明式 PLUGIN_INFO）
├── core/                # 业务逻辑（无 UI 依赖）
│   ├── video_converter.py   # 视频转换（FFmpeg）
│   ├── audio_converter.py   # 音频转换（FFmpeg）
│   ├── image_converter.py   # 图片转换（Pillow）
│   ├── doc_converter.py     # 文档转换（168+种组合）
│   ├── video_downloader.py  # 视频下载（yt-dlp）
│   ├── pdf_editor.py        # PDF编辑
│   ├── ocr_tool.py          # OCR识别（RapidOCR）
│   ├── auto_recover.py      # 失败自动恢复（修复/降级重试）
│   └── tools.py             # PDF合并/拆分/加密/压缩、图片压缩、批量重命名
├── utils/
│   ├── config.py            # 配置与格式定义
│   ├── ffmpeg_manager.py    # FFmpeg下载管理
│   ├── hardware_accel.py    # NVENC / QSV / AMF 硬件加速检测
│   └── format_helpers.py    # 格式辅助工具
└── app/
    ├── logger.py            # 线程安全轮转日志
    ├── exceptions.py        # EX_HINT 异常中文映射
    └── crash_report.py      # 全局异常钩子

• 🛠 工具更新文件改存软件 bin 目录（不再与 C 盘双份占用），历史副本自动清理
• 📌 侧边栏展开/折叠状态与上次停留页面记忆，重启自动恢复
• 💾 偏好落盘全面加固：退出统一收尾 + fsync 物理落盘，断电/强杀进程不丢配置
• 🔐 补全 PDF 密码历史（最近 10 条一键复用）
• 🧹 应用自更新与 FFmpeg 下载中断残留自动清理
• ⚡ 修复页面切换动画信号重复连接泄漏、面板参数自动保存失效（Fluent 控件）
• 🪟 新增「毛玻璃效果」开关（设置 → 外观），性能敏感场景可关闭 Win11 Mica
• 🛡 坏配置容错：配置损坏不再导致启动崩溃

• 📖 新增应用内预览三件套：PDF 预览（QtPdf）、HTML 预览（QtWebEngine）、视频预览（QtMultimedia）
• 🎵 新增音频波形预览（pyqtgraph）与 GIF 双滑块选段（superqt，与游标双向同步）
• 🖼 证件照升级：A6 相纸排版（1寸16张/2寸9张）
• 📊 历史页新增 ECharts 数据大屏（30 天趋势 + 类型分布）
• 💻 插件中心新增「编辑源码」（语法高亮）；全量补全插件能力
• 🧭 侧边栏导航精简 41→35：删除冗余入口，抽帧与缩略图墙合并双模式
• 🎛 图片压缩分段切换、设置页面包屑、历史清空二次确认、M3U8 添加链接自动解析画质
• ⚡ 明暗主题切换提速 2.6s→60ms、全局滚轮流畅度优化、FFmpeg/yt-dlp 更新体验增强
• 🐛 修复 SpinBox 微调箭头灰块、转换失败误报、任务状态卡重复刷新等
• 🛡 QA 加固：配置损坏容错、ffprobe 时长清洗、Image.open 句柄管理、失败自动恢复落日志

• 🎭 新增幻影坦克：一张图片白底显示一张、黑底显示另一张（制作 / 解密，numpy 透明通道编码）
• 🎬 新增视频反挤压：修复画面被压扁拉长（自动按 DAR 修 SAR 流复制 / 手动目标比例重编码）
• 📊 新增媒体信息：容器 / 编码器 / 分辨率 / 帧率 / 码率 / 音视频流详情（MediaInfo 风格）
• ⚡ 新增场景化转换：8 个使用场景（抖音 / 微信 / 邮件 / 公众号 / B站 / 网课 / 存档 / 极速）一键自动匹配参数
• 📋 剪贴板监视增强：独立目标类型与格式选择 + 截图动作（仅保存 / OCR 识别 / 保存并 OCR）
• 🐛 修复转换失败通知误报：跨面板不再误弹通知、批量完成只统计本次失败（历史失败任务不再误报）
• 🐛 修复剪贴板监视输出目录浏览不显示、无音轨视频变速失败等问题

• 🌐 全站中英双语：导航/面板/按钮/下拉选项/任务提示 400+ 文案双语化
• 💾 任务队列持久化：应用退出后自动恢复中断任务，任务中心可一键重试
• 🔁 失败任务一键重试：任务中心新增重试按钮（失败/取消任务直接重新入队）
• 🖼 新增视频抽帧：按固定间隔批量截取关键帧（封面、预览、场景截图）
• 🚫 新增视频去水印：FFmpeg delogo 滤镜，区域自动钳制防止越界
• ⚡ 并发任务数按 CPU 核数自适应推荐（≥8 核推荐 4）
• 📦 打包瘦身：排除 onnxruntime 可选子模块（transformers/quantization/tools）

• 🏗 架构重构：16 个功能面板 DI 化迁移至独立模块，main.py 瘦身
• 🔧 接入 app.exceptions/app.theme/utils.format_helpers 公共模块，消除内联重复
• 🐛 修复批量重命名大小写转换误改扩展名问题（photo.jpg → PHOTO.JPG → PHOTO.jpg）
• 🧪 新增 pytest 单元测试套件（72 测试覆盖纯函数与 _fmt_n 回归）
• ⚡ 新增硬件加速支持（NVIDIA NVENC / Intel QSV / AMD AMF）
• 🔧 FFmpeg 下载失败增强 UX（重试 + 错误详情 + 手动选择 + 下载页）
• 📦 PyInstaller 打包配置增强（onedir + collect-all fitz/PIL/rapidocr）

• 📥 新增视频下载功能（基于yt-dlp，支持数百个平台）
• 🎬 新增视频快速预设（一键应用常用配置组合）
• 🔒 新增PDF密码历史记录（保存最近10条密码，支持一键复用）
• 🔍 格式检测新增文件头魔数识别（通过二进制头判断真实格式，不受扩展名误导）
• 📄 文档格式兼容性实时提示（自动判断源/目标格式是否可转换）
• 🖼 文件属性预览（选中文件后异步显示时长、分辨率、编码信息）
• 🔒 新增PDF加密/解密功能（AES-256/AES-128）
• 🗜 新增PDF压缩功能（DPI + 质量控制）
• 🔄 启动自动更新检查（后台检测GitHub最新版本，发现新版本顶部横幅通知）
• 🖼 新增图像预设裁剪功能（社交媒体尺寸）
• 🐛 修复输出文件与输入同名时自动重命名（加 _1 后缀避免覆盖）

• 🔊 新增音频音量调节功能（20%-200%）
• 🏷 新增图片水印添加功能（支持5种位置）
• 📊 新增底部状态流面板（实时进度日志、自动滚动、错误标红）
• 🔍 新增格式检测功能（批量扫描文件夹，按格式自动分类）
• 📋 新增关于窗口（包含GitHub链接和免责声明）
• 🐛 修复拖拽功能、进度条卡顿等已知问题

• 🎉 首次发布
• 视频/音频/图片/文档格式转换
• 提取音频、视频压缩、视频转GIF
• PDF合并/拆分、图片压缩、批量重命名
• 内置REST API接口
• 白色主题UI + DPI高分屏适配

## English

Navigation: 10 groups / 35 entries · Built-in plugins: 32 · Settings: 11 sections

Supported formats: MP4, AVI, MKV, WMV, MOV, FLV, WEBM, TS, MPEG, 3GP

Special capabilities:

• Stream selection: Choose which audio/video streams to keep
• Codec compatibility check: Auto-detects incompatible codec+container combos (e.g. H.265→FLV)
• Auto-rename: Output file automatically gets _1 suffix if name conflicts with input

Supported formats: MP3, WAV, WMA, AAC, FLAC, OGG, M4A, AMR, OPUS

Supported formats: JPG, PNG, BMP, GIF, TIFF, WEBP, ICO, TGA

Supported formats: PDF, DOCX, DOC, WPS, XLSX, XLS, ET, CSV, PPTX, PPT, DPS, TXT, HTML, HTM, MD, EPUB, RTF, ODT, JPG, JPEG, PNG, BMP, TIFF, WEBP

168+ conversion combinations:

Special capabilities:

• Format detection: Auto-identify source format and list convertible targets
• Word→PDF: Via Microsoft Word COM automation
• PPT→PDF: Via Microsoft PowerPoint COM automation
• Real-time compatibility hints: Shows if current source/target pair is supported

5 operation modes:

Additional features:

• Password history: Saves last 10 passwords for reuse
• Password show/hide toggle: Click eye icon to reveal

Supported platforms: Bilibili, YouTube, Weibo, Instagram, and hundreds more (via yt-dlp)

Download the latest release from Releases page — no installation required, just double-click 格式大师.exe.

# Clone the repository
git clone https://github.com/Gujh/FormatMaster.git
cd FormatMaster

# Install dependencies
pip install -r requirements.txt

# Run the application
python main_qt.py

# Build executable
python build.py

已移除：旧的 Flask REST API（api_server.py）已随 v1.3.x 的 PySide6 迁移删除（Flask 依赖已不在 requirements 中）。

• GUI: PySide6 + qfluentwidgets (Fluent Widgets, Prism design system)
• Video/Audio: FFmpeg (auto-download or system PATH)
• Image: Pillow
• Document: python-docx, openpyxl, python-pptx, pypdf, pdf2docx, reportlab, PyMuPDF
• Word → PDF: Microsoft Word COM automation
• PPT → PDF: Microsoft PowerPoint COM automation
• Video Download: yt-dlp
• OCR: RapidOCR + RapidTable (onnx)
• Advanced widgets: QtPdf / QtWebEngine / QtMultimedia / QtDataVisualization (PySide6 built-in), pyqtgraph, superqt
• Charts: ECharts (local offline assets)
• Text conversion: opencc (traditional/simplified, vocabulary-level)
• Packaging: PyInstaller

FormatMaster/
├── main_qt.py           # Application entry point (PySide6 GUI)
├── build.py             # PyInstaller build script
├── requirements.txt     # Python dependencies
├── assets/
│   ├── icon.ico         # Application icon
│   └── echarts/         # Offline ECharts assets (dashboard)
├── gui_qt/              # PySide6 + Fluent Widgets UI
│   ├── app.py           # MainWindow (FluentWindow + Mica)
│   ├── nav_registry.py  # Navigation registry (single source of truth)
│   ├── services.py      # QtServices container
│   ├── task_manager.py  # Task queue (signal-driven, FIFO, 1-8 parallel)
│   ├── pages/           # Home / Tasks / History / Settings / About
│   ├── panels/          # Feature panels (video, audio, pdf, ocr, ...)
│   └── components/      # Sidebar, theme manager, design system, widgets
├── plugins/             # 32 built-in plugins (declarative PLUGIN_INFO)
├── core/                # Business logic, no UI dependency
│   ├── video_converter.py   # Video conversion (FFmpeg)
│   ├── audio_converter.py   # Audio conversion (FFmpeg)
│   ├── image_converter.py   # Image conversion (Pillow)
│   ├── doc_converter.py     # Document conversion (168+ combos)
│   ├── video_downloader.py  # Video download (yt-dlp)
│   ├── pdf_editor.py        # PDF editing
│   ├── ocr_tool.py          # OCR via RapidOCR
│   ├── auto_recover.py      # Failure auto-recovery (repair / fallback retry)
│   └── tools.py             # PDF merge/split/encrypt/compress, image compress, batch rename
├── utils/
│   ├── config.py            # Configuration & format definitions
│   ├── ffmpeg_manager.py    # FFmpeg download & management
│   ├── hardware_accel.py    # NVENC / QSV / AMF detection
│   └── format_helpers.py    # Format helpers
└── app/
    ├── logger.py            # Thread-safe rotating logger
    ├── exceptions.py        # EX_HINT Chinese error mapping
    └── crash_report.py      # Global exception hooks