GroupDocs.Conversion for Python v26.3 現已推出。此版本加入了逐頁轉換、記憶體串流輸出、Python 3.14 支援、AI‑agent 整合檔案、增強的格式中繼資料，以及多項優化。

本次發行的新功能

Key Category Summary
CONVERSIONPYTHON-65 Feature 透過 convert_by_page(output_dir, convert_options) 進行逐頁轉換
CONVERSIONPYTHON-66 Feature 透過 convert_to_stream(convert_options) 進行記憶體內轉換
CONVERSIONPYTHON-62 Feature 支援 Python 3.14
CONVERSIONPYTHON-64 Feature 在套件內提供 AGENTS.md 以支援 AI Agent 整合
CONVERSIONPYTHON-67 Enhancement 格式物件公開 .extension、.file_format、.description 屬性
CONVERSIONPYTHON-68 Enhancement 在 PyPI 中明確加入 macOS classifier

公開 API 變更

新功能方法 – 這些方法在 25.12 版已宣告但拋出 NotImplementedError，現在已可使用：

Method Returns Description
Converter.convert_by_page(output_dir, convert_options) None 將文件拆分為每頁一個檔案，存放於指定目錄
Converter.convert_to_stream(convert_options) bytes 轉換文件並以記憶體位元組返回結果

尚未可用的方法 – 以下方法目前僅作為 Converter 類別的屬性代理存在，尚未在 Python 綁定中實作。呼叫時會拋出例外：

Method Status Workaround
convert_by_page(file_path, page_number, convert_options) TypeError — 未公開 3 參數重載 使用 convert_options.page_number + convert_options.pages_count = 1 搭配 convert(file_path, options)
convert_by_page(stream, page_number, convert_options) TypeError — 未公開 3 參數重載 先轉換為檔案，再以 io.BytesIO 讀取
convert_multiple(folder_path, convert_options) MissingMethodException 使用 convert(file_path, options) 取得壓縮檔的單一合併輸出

新功能

逐頁轉換 – convert_by_page
Converter.convert_by_page(output_dir, convert_options) 方法現在已完整實作。它會將多頁文件拆分為單獨的輸出檔案——每頁一個——並儲存至指定目錄。頁面檔案名稱為 page_1.ext、page_2.ext，依此類推。此方法適用於所有支援頁面輸出的 ConvertOptions 類別，例如 ImageConvertOptions、PdfConvertOptions、WordProcessingConvertOptions、PresentationConvertOptions 等。

記憶體內轉換 – convert_to_stream
Converter.convert_to_stream(convert_options) 方法現在會回傳轉換後的文件為 Python bytes 物件，讓您能在不寫入磁碟的情況下完成記憶體內的轉換流程。此功能對雲端函式、Web 應用程式以及限制或不希望使用檔案系統的串流架構特別有用。

Python 3.14 支援
支援的 Python 版本範圍從 3.5–3.13（25.12）擴展至 3.5–3.14。Requires-Python 中繼資料現在為 >=3.5,<3.15，且 PyPI 頁面明確列出 Python 3.8 至 3.14 的 classifier。

AGENTS.md – AI Agent 與 LLM 整合
groupdocs-conversion pip 套件現在在 wheel 內的 groupdocs/conversion/AGENTS.md 路徑中提供 AGENTS.md 檔案。掃描已安裝套件的 AI 程式碼助理（如 Claude Code、Cursor、GitHub Copilot）可自動發現 API、使用模式、匯入路徑與故障排除提示，無需手動說明。

格式物件屬性
由 get_possible_conversions() 與 get_all_possible_conversions() 回傳的格式物件現在公開以下可讀屬性：

  • .extension – 例如 'pdf'
  • .file_format – 例如 'Portable Document Format'
  • .description – 例如 'Portable Document Format File (pdf)'

先前這些物件會顯示為不透明的 <NetObject handle=NNN>；現在在 repr() 中會呈現為 <NetObject pdf>，並可透過上述屬性取得乾淨的字串值。

程式碼範例

import os
from groupdocs.conversion import Converter
from groupdocs.conversion.filetypes import ImageFileType
from groupdocs.conversion.options.convert import ImageConvertOptions

output_dir = "./converted-pages"
os.makedirs(output_dir, exist_ok=True)

with Converter("./presentation.pptx") as converter:
    options = ImageConvertOptions()
    options.format = ImageFileType.PNG
    converter.convert_by_page(output_dir, options)
    # 產生: page_1.png, page_2.png, ...

如何取得更新

PyPI

pip install --upgrade groupdocs-conversion

資源