我们很高兴宣布 GroupDocs.Merger for Python v26.6 已于 2026 年 6 月 正式发布。此重大版本将 Python 绑定重构为现代类型化 API，新增对 Python 3.14 的支持以及 AI 代理集成，支持页面预览渲染和基于流的拆分，并提供适用于 Windows、Linux 和 macOS 的自包含 wheel 包。

本次发布的新功能

  • [Enhancement] 重构了 Python 绑定——提供带有捆绑 *.pyi 存根的类型化、按重载划分的 API（MERGERPYTHON-30）
  • [Feature] 支持 Python 3.14（Requires-Python 现为 >=3.5,<3.15）（MERGERPYTHON-31）
  • [Feature] 页面预览渲染（generate_preview）和基于流的 split 现在可通过页面流回调从 Python 调用（MERGERPYTHON-32）
  • [Feature] 在包内提供 AGENTS.md，用于 AI 代理 / LLM 集成（MERGERPYTHON-33）

公共 API 变更

  • 每个类、方法重载和枚举均显式导出类型提示和 .pyi 存根。
  • Merger 现在支持上下文管理器用法（with 语句）。
  • generate_preview 接受普通的 Python 回调，用于创建页面流。
  • split、extract_pages、remove_pages、swap_pages、move_page、rotate、change_orientation 以及与密码相关的方法均返回 IMerger（以便链式调用）。
  • 新增从 groupdocs.merger.domain.options 导入的类型：SplitOptions、ExtractOptions、RotateOptions、RotateMode、PreviewOptions、PreviewMode。

新特性

  • 现代化、类型化的 Python API，具备完整的静态类型检查，运行时不再使用动态属性代理。
  • 通过回调流模型实现的 Python 页面预览渲染。
  • 在所有平台上支持 Python 3.14（wheel 为 py3-none-{platform}）。
  • 在包内提供 AGENTS.md，以便集成 AI 代理和 LLM（例如 GitHub Copilot、Claude Code、Cursor）。

代码示例

from groupdocs.merger import Merger
from groupdocs.merger.domain.options import (
    SplitOptions, ExtractOptions, RotateOptions, RotateMode,
)

with Merger("input.pdf") as merger:
    # 保留第 1‑3 页，旋转第 2 页，然后保存
    merger.extract_pages(ExtractOptions([1, 2, 3]))
    merger.rotate(RotateOptions(RotateMode.ROTATE90, [2]))
    merger.save("reordered.pdf")

# 将文档拆分为每页一个文件
with Merger("input.pdf") as merger:
    merger.split(SplitOptions("page_{0}.pdf", [1, 2, 3]))

页面预览渲染示例：

from groupdocs.merger import Merger
from groupdocs.merger.domain.options import PreviewOptions, PreviewMode

def create_page_stream(page_number):
    return open(f"page-{page_number}.png", "wb")

with Merger("input.pdf") as merger:
    merger.generate_preview(PreviewOptions(create_page_stream, PreviewMode.PNG, [1, 2]))

如何获取更新

PyPI

通过 pip 升级：

pip install groupdocs-merger-net

直接下载

从 GroupDocs.Merger for Python via .NET 26.6 页面下载最新的 wheel 包。

资源