长图切片 long-image-split
把一张竖长图切分成若干张可独立阅读的小图,重点保证:
- 目标比例:每张切片宽:高 由
--ratio指定,默认竖版3:4。 - 重叠缓冲区:相邻切片保留
--overlap像素(默认 100,约 2~3 行字)的重叠,衔接处不丢字、能拼回。 - 切口对齐文字间隙:在每个切分边界附近找「最亮(最白)」水平行下刀,避免拦腰切断文字。
- 末尾单张锚定:主体从上往下切;只有最后一张若不足比例,才把最后一张单独从底往上锚定成满比例(前面已切好的图不变),避免「末尾一张很矮」。注:此举会让最后两张的重叠区大于设定值,但衔接处绝不丢字。
- 不改原图:只生成新文件。
脚本
split_long_image.py(同目录)。依赖 Pillow。
用法
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。也可以不依赖任何 Agent,直接当作独立 Python 脚本运行(见上方用法)。
执行流程(Agent 调用时)
- 先问用户参数:skill 一启用,立即用 AskUserQuestion 向用户确认可调项(不要上来就用默认值跑):
- 单张比例:默认 3:4 竖版;可选 9:16(小红书/朋友圈)、4:3(横切)、或用户自定义
宽:高。 - 重叠缓冲区:默认 100px;文字密集/怕切到可加到 120~150。
- 输出目录:必问项(不要默认跳过)。用 AskUserQuestion 给出候选让用户选,例如:默认同目录
<原图名>_切片、桌面~/Desktop/long_切片、当前工作区目录、原图所在目录平铺(不建子文件夹)等;用户也可在「其他」里填任意自定义路径。 若用户在请求里已明确给出某项(如「按 9:16 切」「切到桌面」),该项不再重复问,只问缺失的。
- 单张比例:默认 3:4 竖版;可选 9:16(小红书/朋友圈)、4:3(横切)、或用户自定义
- 读尺寸(脚本自身会读,无需额外
sips)。 - 带用户确认的参数跑脚本。
- 报告切了几张、每张高度、输出目录;原图未改动,提示用户核对衔接处。
- 如用户反馈某处文字被切,调大
--overlap重跑。