# Long Image Split

> 把竖长图（长截图、长笔记、海报长图等）按指定宽高比切成多张可独立阅读的小图，衔接处保留重叠缓冲区避免文字被切断。当用户要「切长图」「按 3:4 切分图片」「切手机长截图」「把竖图分成几张发朋友圈/小红书」时使用。不改原图，只生成切片。

- Skill: `hunchide/long-image-split` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx get-skill add hunchide/long-image-split`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hunchide/long-image-split/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Hunchide (https://skillmd.com/u/hunchide)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/hunchide/long-image-split

---


# 长图切片 long-image-split

把一张竖长图切分成若干张可独立阅读的小图，重点保证：
1. **目标比例**：每张切片宽:高 由 `--ratio` 指定，默认竖版 `3:4`。
2. **重叠缓冲区**：相邻切片保留 `--overlap` 像素（默认 100，约 2~3 行字）的重叠，衔接处不丢字、能拼回。
3. **切口对齐文字间隙**：在每个切分边界附近找「最亮（最白）」水平行下刀，避免拦腰切断文字。
4. **末尾单张锚定**：主体从上往下切；只有最后一张若不足比例，才把最后一张单独从底往上锚定成满比例（前面已切好的图不变），避免「末尾一张很矮」。注：此举会让最后两张的重叠区大于设定值，但衔接处绝不丢字。
5. **不改原图**：只生成新文件。

## 脚本

`split_long_image.py`（同目录）。依赖 Pillow。

## 用法

```bash
python3 split_long_image.py <图片路径> [--ratio 3:4] [--overlap 100] [--out 目录] [--quality 95]
```

示例：
- 默认竖版 3:4、重叠 100px：
  `python3 split_long_image.py 长.jpeg`
- 切竖屏 9:16（小红书/朋友圈友好）、重叠加大到 120：
  `python3 split_long_image.py 长.jpeg --ratio 9:16 --overlap 120`
- 指定输出目录：
  `python3 split_long_image.py 长.jpeg --out ~/Desktop/切片`

## 在各类 Agent 中使用

本 skill 遵循开放的 Agent Skills 标准，可被 WorkBuddy、Claude Code、OpenAI Codex、Trae 等支持该标准的 Agent 直接加载。把整个目录放进对应 Agent 的 skills 目录即可；各平台的具体路径与触发方式见 [README.md](./README.md)。也可以不依赖任何 Agent，直接当作独立 Python 脚本运行（见上方用法）。

## 执行流程（Agent 调用时）

1. **先问用户参数**：skill 一启用，立即用 AskUserQuestion 向用户确认可调项（不要上来就用默认值跑）：
   - **单张比例**：默认 3:4 竖版；可选 9:16（小红书/朋友圈）、4:3（横切）、或用户自定义 `宽:高`。
   - **重叠缓冲区**：默认 100px；文字密集/怕切到可加到 120~150。
   - **输出目录**：**必问项**（不要默认跳过）。用 AskUserQuestion 给出候选让用户选，例如：默认同目录 `<原图名>_切片`、桌面 `~/Desktop/long_切片`、当前工作区目录、原图所在目录平铺（不建子文件夹）等；用户也可在「其他」里填任意自定义路径。
   若用户在请求里已明确给出某项（如「按 9:16 切」「切到桌面」），该项不再重复问，只问缺失的。
2. 读尺寸（脚本自身会读，无需额外 `sips`）。
3. 带用户确认的参数跑脚本。
4. 报告切了几张、每张高度、输出目录；原图未改动，提示用户核对衔接处。
5. 如用户反馈某处文字被切，调大 `--overlap` 重跑。

