我們很高興宣布 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。

資源