前言¶
掃描試卷、歸檔合同、整理手機照片時，常見需求是把同一目錄下多張圖片合成一份 PDF。手工用預覽或在線工具逐張拖入，文件名順序容易亂；手機豎拍的照片還可能帶着 EXIF 方向，合併後頁面是歪的。自己寫腳本可以批量處理，但每次都要查庫、調參數，對「只想出一份 PDF」的場景來說成本偏高。
下面介紹 SkillHub 上的社區 Skill「本地圖片批量合併爲 PDF 文檔」，讓支持 Skills 的 Agent 按約定流程在本地完成合並，無需單獨配置 API Key。
這是什麼¶
本地圖片批量合併爲 PDF 文檔（座標 @user_c11cceac/img2pdf，版本 1.0.0）是 SkillHub community 來源、分類爲 office-efficiency 的技能，由發佈者 user_c11cceac 維護。
官方頁面將其定位爲：將本地圖片批量合併爲 PDF 文檔；並標明標籤 requires_api_key=false，即不依賴外部 API 密鑰。SkillHub 展示頁地址：
- https://www.skillhub.cn/skills/user_c11cceac/img2pdf
- API 入口：https://api.skillhub.cn/user_c11cceac/img2pdf
核心功能¶
以下能力均來自官方簡介，未在頁面單獨展開的實現細節不臆測：
- 批量合併：把多張本地圖片合成一個 PDF 文件。
- EXIF 方向修正：自動處理照片方向信息，減少豎拍圖在 PDF 裏橫倒的問題。
- 按文件名編號排序：合併順序依據文件名中的編號，適合
001.jpg、002.jpg這類命名。 - 大批量：官方說明支持 200+ 張圖片的一次性處理。
常用觸發表述（官方列出）：圖片轉 PDF、合併圖片爲 PDF、圖片合成 PDF、images to pdf、批量圖片 PDF、試卷圖片 PDF、照片轉 PDF、把圖片做成 PDF。
安裝與啓用¶
安裝方式以 SkillHub 頁面與安裝文檔爲準：先具備 skillhub CLI，再將技能裝到當前 Agent 能識別的 skills 目錄。
1. 檢查或安裝 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安裝，可按官方安裝文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
說明：在受限網絡環境中執行上述命令時，需允許訪問安裝腳本與對象存儲地址。
2. 安裝本 Skill¶
官方頁面寫明：請根據 https://skillhub.cn/install/skillhub.md 安裝 @user_c11cceac/img2pdf。
安裝技能時必須用 --dir 指向當前 Agent 的 skills 目錄；若裝到默認 ./skills/ 而 Agent 未配置該路徑，技能可能無法被加載。文檔給出的常見路徑示例：
| 環境 | skills 目錄（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
安裝命令形式（將 <skills 目錄> 替換爲上表對應路徑）：
skillhub install user_c11cceac/img2pdf --dir <skills 目錄>
座標寫法亦可與 SkillHub 頁面一致，使用 @user_c11cceac/img2pdf；具體以當前 skillhub install 支持的包名格式爲準。安裝後按你所用客戶端要求重啓或刷新 Agent，使 Skill 生效。
典型用法¶
本 Skill 面向對話式觸發：在 Agent 已加載該 Skill 的前提下，用自然語言說明圖片所在路徑與期望輸出的 PDF 路徑或文件名，並帶上官方觸發詞之一即可，例如：
- 「把
/path/to/scans裏的圖片按順序合併成 PDF，輸出到/path/to/output.pdf」 - 「批量圖片 PDF：合併這些試卷照片，修正手機拍攝方向」
Agent 會按 Skill 內定義的步驟在本地讀圖、排序、生成 PDF。頁面未公開固定 CLI 子命令或腳本名時，不宜自行假設底層調用方式；以 Agent 執行 Skill 指引後的實際操作爲準。
使用前建議：
- 圖片文件名帶可排序編號，以匹配「按文件名編號排序」能力。
- 單次任務圖片數量較大（如接近或超過 200 張）時，留意磁盤空間與生成耗時。
適用場景與注意¶
適合誰
- 需要把掃描件、截圖、照片文件夾快速打成一份 PDF 的辦公場景（試卷歸檔、資料遞交、本地備份）。
- 已在 Cursor、Claude Code、Codex 等支持 SkillHub 技能的客戶端中工作，希望用同一套對話完成轉換的用戶。
限制與注意
- 技能處理的是本地路徑上的圖片；遠程圖牀或未下載到本機的資源需先落到本地。
- 合併順序依賴文件名編號；若命名雜亂，輸出頁序可能與預期不符，應先整理文件名。
- 官方未在簡介中列出支持的圖片格式清單；若遇個別格式失敗，可換常見格式（如 JPEG、PNG）或查看 Skill 包內
SKILL.md（安裝後位於 skills 目錄對應子路徑）。 - SkillHub 頁面展示的統計（評分、下載、安裝次數）會隨時間變化；撰寫時頁面數據爲評分 100000、下載 2996、安裝 49，以你打開頁面時的數值爲準。
結尾¶
「本地圖片批量合併爲 PDF 文檔」把 EXIF 修正、按名排序和大批量合併寫進 Agent Skill，適合在本地、無 API Key 的前提下完成圖片轉 PDF。若你要從商店安裝或查看說明，可訪問：
https://www.skillhub.cn/skills/user_c11cceac/img2pdf
安裝指引：https://skillhub.cn/install/skillhub.md
