图片布局打印机

将图片自动拼接成白色容器，生成可直接双击打开的独立 HTML 页面和 PDF 文件（图片默认 WebP 压缩后 base64 嵌入，自包含、无需服务器）。

支持三种模式，并自动判定页面方向（横版/竖版）：

模式对比

方向自动判定：脚本读取每张图实际宽高，横版图占比大 → 整篇横版 PDF；否则竖版（主方向统一）。横版时一律每页一张。

输入

用户可提供：

1. 文件夹路径 - 包含图片的文件夹（脚本按文件名自然排序）
2. 图片文件列表 - 用 --files 指定，按给定顺序排版（文件名无序号时由你排好顺序传入）

支持的图片格式：jpg, jpeg, png, gif, webp

工作流程

步骤 1: 收集图片并确定顺序

排序策略（关键）：

• 文件名带序号（1.png 2.png ... 10.png）：直接传文件夹，脚本按自然排序（数值序，不会变成 1, 10, 2）。
• 文件名无序号（封面.png 目录.png 第二章.png 或随机文件名）：脚本无法判断语义，由当前 Agent 评估顺序：
  1. 先看文件名语义——章节词、步骤词、时间词、"一二三"等中文序词
  2. 文件名也无语义时，用当前 Agent 的图片查看能力逐张看图，按内容逻辑排序（漫画分镜、操作步骤、故事时间线、目录页码）
  3. 排好后用 --files <有序列表> 传给脚本，脚本严格按给定顺序、不重排
  4. 顺序不确定时，简要说明排序依据并询问用户确认

步骤 2: 生成 HTML 与 PDF

SCRIPT="<skill-root>/scripts/generate_html.py"

# 竖版图集（默认）：自动拼成3:4容器
python3 $SCRIPT <图片文件夹> [输出名]

# 横版图集：自动检测，横版 PDF 每页一张（4:3 或 16:9 自动判定）
python3 $SCRIPT <横版图片文件夹>

# 文件名无序号：你评估好顺序后用 --files（--files 会吞掉后续位置参数，输出名用 --output）
python3 $SCRIPT --output <输出名> --files 封面.png 01.png 02.png 结尾.png

# 强制页面方向
python3 $SCRIPT <文件夹> --orientation landscape   # 强制横版
python3 $SCRIPT <文件夹> --orientation portrait     # 强制竖版

# 已有3:4图片，每张独占完整容器
python3 $SCRIPT <文件夹> --mode full

# 仅生成 HTML，不生成 PDF
python3 $SCRIPT <文件夹> --no-pdf

执行前把 <skill-root> 替换为当前加载的 image-to-pages Skill 绝对目录，不要假设它固定安装在 Claude、Codex 或其他 Agent 的某个家目录下。

自动模式检测：竖版图集若超 70% 接近 3:4，自动从 auto 升级到 full（每张独占一页）。

横版比例自动 snap：取横版图 宽/高 中位数，< 1.5 → 4:3（200mm×150mm），≥ 1.5 → 16:9（267mm×150mm）。竖版固定 3:4（150mm×200mm）。

输出文件名规则：不传输出名时自动用 <文件夹名>_layout；显式传 输出名 或 --output 时用原名（不加 _layout 后缀）。

输出的 HTML 文件可直接双击打开，打印和下载功能完全正常，无需启动任何服务器。

参数说明

模式说明

auto（竖版默认）：每容器最多2张各占50%高度，单张时占满整个容器高度，object-fit: contain。

full（竖版）：每张图独占一个完整容器；接近3:4用 contain，偏离较大用 cover 避免白边。

landscape（横版，自动）：每张图独占一页（一页一张），object-fit: contain 不裁切；页面比例按横版图中位数自动 snap 到 4:3 或 16:9。竖版图集里少数横版图会 contain 放入竖版页（左右留白），反之同理。

输出文件

PDF 生成需要系统安装 Chrome、Chromium、Edge 或 Arc 之一。脚本用 headless 模式渲染，会读取 HTML 里的 @page 尺寸，所以横版 HTML 自动产出横版 PDF。如未安装浏览器，仍可通过 HTML 的「打印/导出PDF」按钮手动生成。

注意事项

1. 文件体积: 图片默认压成 WebP 后再 base64 嵌入，HTML 体积约为原图总和的 1/5～1/7（需 Pillow，无则自动退回原图）；--no-compress 可关压缩回到原图 1.33 倍
2. 排序: 文件夹模式按自然排序（1,2,3...10）；--files 模式严格按传入顺序，不重排
3. 横版一页一张: 横版图固定每张独占一页（横版拼2张无意义）；竖版才支持 auto 拼2张
4. 混合方向: 一个 PDF 内只能统一一个方向（Chrome headless 的 @page 是文档级约束）。脚本按主方向统一，少数派图用 contain 放入（会留白）
5. PDF 生成: 自动调用 Chrome headless，无需手动操作。Chrome 出图后默认用 Ghostscript（若已安装）二次压缩到约 1/5；源图的 WebP 压缩只缩 HTML 不缩 PDF（Chrome 会按原像素重栅格化），故 PDF 体积由 --pdf-quality 控制，与 --quality 无关

示例

示例 1: 竖版图集拼成 3:4

用户："/path/to/images 帮我做成打印页面"

python3 $SCRIPT /path/to/images
# → /path/to/images_layout.html + .pdf

示例 2: 横版图集（PPT 截图、宽屏图）

用户："/path/to/slides 这些横版图拼成 PDF"

python3 $SCRIPT /path/to/slides
# 自动检测横版，按主比例出 16:9 横版 PDF，每页一张

示例 3: 文件名无序号，自己排顺序

用户："/path/to/comic 这套漫画文件名没序号，按剧情顺序拼"

1. Read 逐张看图，排出剧情顺序：[封面, 第1话, 第2话, 结尾]
2. 用 --files 按顺序传入：

python3 $SCRIPT --output comic --files \
  /path/to/comic/封面.png \
  /path/to/comic/第1话.png \
  /path/to/comic/第2话.png \
  /path/to/comic/结尾.png
# → /path/to/comic/comic.html + .pdf