TPDF

一个图形界面的 PDF 工具

• 图片 → PDF：把文件夹里的图片合成 PDF
  • 可单向或双向统一高度 / 宽度
  • 可按纸张比例（A3 / A4 / A5 / B4 / B5 等）或自定义比例（例 297/210、1.414）居中填充背景
  • 纸张比例下自带 DPI 输入，绝对像素自动按 毫米 × DPI / 25.4 计算
  • 填充色支持 固定颜色（自选）或 自适应黑白（按每张图片边缘亮度自动选择黑或白）
• PDF → 图片：从 PDF 提取嵌入的原始图片（无损），或把每一页按指定 DPI 渲染为 PNG
• PDF 编辑：合并 / 拆分 / 删除 / 重排 / 交换页面，一次性处理一个或多个 PDF
  • 缩略图网格；单击 / Ctrl+点击 / Shift+点击 支持单选、多选、范围选
  • 支持按住鼠标拖拽重排；拖拽时显示蓝色插入线
  • 大文件友好：可用页码表达式批量选择，如 1-5, 7, 10-12 / all / odd / even
  • 多种导出模式：合并为一个 PDF、仅导出选中页、按切分点拆分、每 N 页拆分
  • 导出使用 PyMuPDF 的 insert_pdf，原始质量完整保留

在 release 中下载对应平台的可执行文件，直接运行即可

uv 是一个快速、零配置的 Python 包管理器，替代 conda / pip / venv

# Windows (PowerShell)
irm https://astral.sh/uv/install.ps1 | iex

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# 或：brew install uv / pipx install uv

uv run python TPDF.py

第一次运行时 uv 会自动

• 根据 pyproject.toml 里的 requires-python = ">=3.10" 下载合适的 Python 版本；
• 在项目目录下创建 .venv/ 并安装 pillow、pymupdf；
• 用这个虚拟环境启动程序

uv run --extra build python build.py

或清理后重建

uv run --extra build python build.py --clean

产物

TPDF.spec 内部按平台自动分支：Windows/Linux 走 onefile，macOS 走 onedir + BUNDLE（.app 本质是目录，不能与 onefile 共存）

打包脚本已在 build.py 中做了跨平台处理，脚本本身只是对 uv sync + uv run pyinstaller TPDF.spec 的薄封装；如果您想手工控制，也可以直接这两行

uv sync --extra build
uv run pyinstaller --noconfirm TPDF.spec

如果需要给 .app 签名以便在其他 Mac 上直接运行

codesign --force --deep --sign - dist/TPDF.app

后续如果需要公证（notarize）发布到非开发模式的 Mac，请配合 Apple Developer 证书

仓库自带两个脚本，配合 GitHub CLI 一键完成发布

• release_build.py：自动识别当前 OS + 架构，构建并把产物规范命名为 TPDF-v{version}-{os}-{arch}.{ext}，同时生成 .sha256
• release_publish.py：自动打 tag、推送、gh release create（或已存在时 gh release upload --clobber）

⚠️ PyInstaller 不支持真正的跨平台编译。release_build.py 需要在每个目标 OS 上各跑一次，产物都会落到 dist/release/ 下；收齐后再跑一次 release_publish.py 一次性全部上传

版本号由 pyproject.toml 的 version 字段单一来源，TPDF.spec（macOS bundle 版本）和两个脚本都会读它：

# pyproject.toml
version = "0.1.0"

在 Windows / macOS / Linux 各自执行

uv run --extra build python release_build.py --clean

产物（以 v0.1.0 为例）

每个产物旁都会有一份 *.sha256 校验文件

安装 gh 并登录

# Windows
winget install --id GitHub.cli
# macOS
brew install gh
# 之后
gh auth login

发布使用

python release_publish.py

此时，脚本会

1. 从 pyproject.toml 读取版本，构建 tag（如 v0.1.0）；
2. 校验工作区是否干净（可加 --allow-dirty 跳过校验）；
3. 本地无 tag 则会创建 tag 并推送到 origin；
4. 没有 release 则会使用 gh release create --generate-notes 并上传所有产物；
5. 已有 release（比如先发了 Windows，后补 macOS）则会使用 gh release upload --clobber

常用参数

python release_publish.py --draft            # 发布为草稿
python release_publish.py --prerelease       # 标记预发布
python release_publish.py --notes-file NOTES.md
python release_publish.py --no-sha256        # 不上传校验文件
python release_publish.py -y                 # 跳过交互确认

TPDF.py 本身仅依赖 pillow 和 pymupdf，任何 Python ≥ 3.10 的环境下都可以运行

pip install pillow pymupdf pyinstaller
python TPDF.py
pyinstaller --noconfirm TPDF.spec

图标通过编辑 icon/generate_icon.py 的 draw_icon()，再 uv run python icon/generate_icon.py 即可覆盖所有尺寸

TPDF.py              # 主程序（单文件）
TPDF.spec            # PyInstaller 打包脚本（按平台分支，版本号读 pyproject.toml）
pyproject.toml       # uv / pip 依赖声明，版本号单一来源
build.py             # 跨平台打包脚本（本地开发用）
release_build.py     # 发布构建：自动按 OS/arch/版本号命名产物到 dist/release/
release_publish.py   # 一键发布到 GitHub Release（基于 gh CLI）
readme.md            # 本文件
icon/                # 应用图标
├── generate_icon.py # 图标生成器（可重跑）
├── TPDF.ico         # Windows 多尺寸图标（用于 exe 和窗口）
├── TPDF.icns        # macOS 图标（用于 .app bundle）
├── TPDF.png         # 256 px 通用 PNG
└── TPDF_{16,32,48,64,128,256,512}.png   # 供 Tk iconphoto 使用的多尺寸 PNG
legacy/              # 历史版本：旧的 CLI 脚本与上一版 GUI

• 2025：本项目手动搭建而成
• 2026-今：本项目使用 AIGC 辅助开发