name: img2pdf display_name: 圖片轉 PDF description: 將一張或多張圖片合併為一個 PDF 檔案，支援 A4/A3/A5/Letter/Legal 頁面尺寸、邊距、方向、灰度、適配模式與排序。當用戶說"圖片轉pdf""把圖片合併成pdf""jpg轉pdf""png轉pdf""照片生成pdf""截圖匯出pdf""掃描件轉pdf"或需要把多張圖片打包成 PDF 時觸發。 version: "1.0" agent_created: true tags: - 圖片 - PDF - 轉換 - 工具 trigger_phrases: - 圖片轉pdf - 圖片轉 PDF - 把圖片合併成pdf - 多張圖片轉pdf - jpg轉pdf - png轉pdf - 照片生成pdf - 截圖匯出pdf - 掃描件轉pdf

圖片轉 PDF

概述

將本地的一張或多張圖片合併成一個 PDF 檔案。底層使用 Pillow 處理影像，支援 JPEG/PNG/WEBP/BMP/GIF/TIFF/ICO 等常見格式，自動按相機 EXIF 方向校正，透明背景自動填充白色，多幀 GIF 只取首幀。

何時使用

• 使用者給出圖片檔案、圖片目錄或 glob 模式，並希望生成 PDF
• 觸發詞示例："圖片轉pdf""把這幾張照片合併成pdf""截圖匯出pdf""掃描件合成pdf"
• 常見場景：證件掃描件歸檔、截圖文件化、照片列印冊、批次圖片打包傳送

前置條件

指令碼依賴 Pillow。每次使用前確認 Pillow 可被託管 Python 匯入；若不可用，先安裝：

<managed_python> -m pip install Pillow

<managed_python> 指本環境的託管 Python（如 C:\Users\DELL\.workbuddy\binaries\python\versions\3.13.12\python.exe）。若已配置獨立 venv，則在該 venv 中安裝。

快速開始

7w4.net小蔥技能站，你的AI助手技能庫。

1. 定位本技能目錄（即包含此 SKILL.md 的資料夾），記其路徑為 SKILL_DIR。
2. 解析使用者輸入，確認圖片來源（檔案列表 / 目錄 / glob）與期望的輸出路徑。
3. 執行打包指令碼：

<managed_python> "<SKILL_DIR>/scripts/img2pdf.py" <輸入> -o <輸出>.pdf [選項]

不指定 -o 時，預設輸出到第一張圖片所在目錄、檔名為該目錄名加 .pdf。

引數說明

頁面尺寸語義

• A4/A3/A5/LETTER/LEGAL：固定頁面，圖片在頁面內等比縮放並居中，-m 控制邊距（預設無邊距鋪滿）。
• FIT：頁面尺寸隨圖片長寬比變化，最長邊等於 A4 長邊，鋪滿、無白邊、不變形。
• IMAGE：頁面即圖片原始畫素尺寸（按 --dpi 換算為 PDF 點），適合需要 1:1 還原的場景。

典型工作流

1. 確認輸入範圍：若是目錄，詢問是否需要遞迴；若是多檔案，確認順序（預設按檔名自然序）。
2. 確認頁面規格：列印用選 A4 並適當留邊距；照片冊選 FIT；需原尺寸選 IMAGE。
3. 執行指令碼，打印出的日誌會顯示生成的頁面數。
4. 將生成的 PDF 路徑告知使用者，必要時用 present_files 展示結果。

常見場景示例

# 資料夾內全部圖片 -> A4 PDF（按檔名排序）
python img2pdf.py ./photos -o photos.pdf

# 指定多張圖 -> 鋪滿不變形的 PDF
python img2pdf.py a.png b.png -s FIT -o out.pdf

# 遞迴掃描 + 灰度 + A5 + 5mm 邊距
python img2pdf.py ./scans -r --grayscale -s A5 -m 5 -o scans.pdf

# 原尺寸 1:1 匯出（用於需要保真的掃描件）
python img2pdf.py scan.tif -s IMAGE --dpi 200 -o scan.pdf

注意事項與限制

• 透明 PNG 會填充白色背景後再入 PDF，不會保留透明。
• 動圖（GIF/WebP 多幀）僅取首幀。
• 超大圖片在固定頁面下會被等比縮小以適配頁面；IMAGE 模式則按原畫素輸出，檔案可能較大。
• 輸出為單 PDF 多頁；若使用者需要"一圖一 PDF"，對每個檔案分別呼叫一次即可。

檔案結構

• scripts/img2pdf.py — 轉換主指令碼（支援上述全部引數）

這是一款實用且文件完善的圖片轉 PDF 工具，觸發詞覆蓋全面，能應對證件掃描、截圖歸檔、照片列印等多種常見場景。功能設計考慮周全，支援多種頁面尺寸、邊距設定和排序方式，透明圖自動填白等細節處理到位。美中不足的是缺少快速測試用的示例圖片，且文件未提供常見問題的解決指引。總體質量良好，能滿足日常圖片轉 PDF 的需求。