File2LongImage - 文件转长图工具

一个强大的文件转换工具，可将 PDF、Word、Excel、PPT 等多种格式文件转换为高质量长图。

🎬 演示

🚀 并行处理版本

支持多文件并行转换，独立进度控制，实时状态显示

✨ 功能特点

• 📄 多格式支持：PDF、Word、Excel、PPT、TXT、RTF 等
• 🖼️ 智能合并：自动将多页文档合并为一张长图
• ⚡ 并行处理：多文件同时转换，独立进度控制
• 🎨 质量可调：自定义 DPI 设置，平衡质量与文件大小
• 🌐 Web 界面：基于 Streamlit 的现代化操作界面
• 🖥️ 桌面版本：原生 macOS 应用和跨平台 Tkinter 版本
• 📊 实时反馈：转换进度、速度、用时实时显示
• 🔍 错误诊断：专业级错误日志和智能问题分析

🚀 快速开始

系统要求

• Python 3.8+
• macOS / Windows / Linux

安装步骤

1. 克隆项目

git clone https://github.com/你的用户名/File2LongImage.git
cd File2LongImage

2. 安装系统依赖

📱 macOS

# 安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Poppler（PDF 处理）
brew install poppler

# 安装 LibreOffice（可选，用于 Office 文件转换）
brew install --cask libreoffice

注意：

• Poppler 会自动安装到 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel）
• LibreOffice 会安装到 /Applications/LibreOffice.app
• 配置文件已自动适配 macOS 路径，无需手动修改

🪟 Windows

1. 安装 Poppler

   • 下载 Poppler for Windows
   • 解压到项目目录下的 poppler 文件夹
   • 或添加到系统环境变量 PATH

2. 安装 LibreOffice（可选）

   • 下载 LibreOffice
   • 安装到默认位置或自定义路径

🐧 Linux

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install poppler-utils
sudo apt-get install libreoffice  # 可选

# CentOS/RHEL/Fedora
sudo yum install poppler-utils
sudo yum install libreoffice  # 可选

3. 安装 Python 依赖

pip install -r requirements.txt

📖 使用方法

Web 界面版本

# 启动应用
streamlit run main.py

# 或使用便捷脚本
python run_app.py

浏览器将自动打开 http://localhost:8501

桌面界面版本

python TKGUI.py

macOS 原生应用 🆕

# 标准版（串行处理）
python mac_app.py

# 并行处理版（推荐）
python mac_app_parallel.py

# 一键构建 .app 包
chmod +x build_mac.sh
./build_mac.sh

并行版本特性：

• 🚀 多文件同时处理，效率提升 N 倍
• 📊 独立进度条和状态显示
• ⏸️ 支持暂停/继续/取消单个任务
• 📁 右键菜单快速操作
• 🔍 详细错误日志和问题诊断

详见 macOS 应用文档

使用流程

1. 选择要转换的文件
2. 设置 DPI（默认 200，范围 72-600）
3. 选择输出格式（PNG/JPG）
4. 点击转换，等待处理完成
5. 在 output 文件夹查看结果

⚙️ 配置说明

配置文件 config.py 已针对不同系统自动适配：

• macOS：自动检测 Homebrew 安装路径
• Windows：支持本地 poppler 文件夹或环境变量
• Linux：使用系统标准路径

通常无需手动修改配置文件。

📁 项目结构

File2LongImage/
├── main.py             # Streamlit Web 应用主程序
├── TKGUI.py           # Tkinter 桌面版程序
├── mac_app.py         # macOS 原生应用（标准版）
├── mac_app_parallel.py # macOS 原生应用（并行处理版）
├── error_logger.py    # 专业错误日志系统
├── config.py          # 自动适配的配置文件
├── run_app.py         # 快捷启动脚本
├── requirements.txt   # Python 依赖列表
├── assets/            # 演示图片和资源
├── logs/              # 错误日志目录
├── output/            # 转换结果输出目录
└── README.md          # 项目说明文档

🔧 故障排除

macOS 常见问题

Q: 提示找不到 Poppler

# 验证安装
brew list poppler
# 重新安装
brew reinstall poppler

Q: LibreOffice 无法转换文件

# 检查是否已安装
ls /Applications/LibreOffice.app
# 如未安装
brew install --cask libreoffice

Q: 权限问题

# 首次运行 LibreOffice 可能需要授权
open /Applications/LibreOffice.app
# 在系统设置中允许运行

Windows 常见问题

Q: PDF 转换失败

• 确保 poppler/poppler-24.07.0/Library/bin 存在
• 或将 Poppler bin 目录添加到系统 PATH

通用问题

Q: 依赖安装失败

# 使用国内镜像
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

💡 使用建议

• DPI 设置：

  • 屏幕查看：150-200 DPI
  • 打印质量：300 DPI
  • 高清输出：400-600 DPI

• 格式选择：

  • PNG：无损压缩，适合文字内容
  • JPG：有损压缩，文件更小，适合图片内容

• 性能优化：

  • 大文件建议分批处理
  • 降低 DPI 可加快处理速度

📦 预编译版本

不熟悉命令行？可下载预编译版本：

• 夸克网盘
• 百度网盘 提取码：69hi

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

本项目基于 MIT License 开源。

🙏 致谢

• Streamlit - Web 应用框架
• pdf2image - PDF 转图片
• Pillow - 图像处理
• Poppler - PDF 渲染引擎

---

如有问题或建议，请提交 Issue