前言¶
扫描试卷、归档合同、整理手机照片时，常见需求是把同一目录下多张图片合成一份 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
