我們很高興宣布 GroupDocs.Redaction for Python v26.11 已於 2026 年 11 月 發佈。此版本將 GroupDocs.Redaction 引擎從 26.5 升級至 26.10,並嵌入 .NET runtime 10.0.15,將 System.Drawing 替換為 Aspose.Drawing 與 SkiaSharp,以支援跨平台光柵化與影像區域遮蔽——包括 Linux 與 macOS。新功能包括頁面預覽、Python 日誌支援、Python OCR 連接器整合、Word 文件的 OOXML 合規性控制、明確的檔案類型載入,以及授權狀態檢查。

此版本的新功能

  • [Feature] 新增對檔案和 io.BytesIO 的頁面預覽支援(PreviewOptions、generate_preview()) (REDACTIONPYTHONNET-23)
  • [Feature] 新增對 Python 日誌(ILogger)的支援 (REDACTIONPYTHONNET-24)
  • [Feature] 新增對 Python OCR 連接器(IOcrConnector)以在影像中遮蔽文字的支援 (REDACTIONPYTHONNET-25)
  • [Feature] 新增設定已儲存 Word 文件之 OOXML 合規等級(ooxml_compliance)的支援 (REDACTIONPYTHONNET-26)
  • [Feature] 新增以指定檔案類型開啟文件的支援(LoadOptions.file_type) (REDACTIONPYTHONNET-27)
  • [Feature] 新增檢查授權是否已套用(License.is_licensed)的支援 (REDACTIONPYTHONNET-28)
  • [Enhancement] 將 GroupDocs.Redaction 更新至 26.10,並將嵌入的執行環境升級至 .NET 10.0.15 (REDACTIONPYTHONNET-29)
  • [Enhancement] 將 groupdocs.pydrawing 類型取代為 groupdocs.redaction.options.drawing(Color、Point、Size、Rectangle、Font、FontStyle) (REDACTIONPYTHONNET-30)
  • [Enhancement] 在遮蔽回呼的描述中返回 RedactionType 與 RedactionActionType 列舉 (REDACTIONPYTHONNET-31)
  • [Enhancement] 當未知屬性被指派給 API 物件時拋出 AttributeError (REDACTIONPYTHONNET-32)
  • [Enhancement] 對無法套用的授權拋出 LicenseError,並從 groupdocs.redaction 匯出它與 GroupDocsRedactionException (REDACTIONPYTHONNET-33)
  • [Enhancement] 從共享的 groupdocs-shared-net 套件安裝 groupdocs.pydrawing 與 groupdocs.pycore (REDACTIONPYTHONNET-34)
  • [Fix] 修復 26.6.0 中的 CVE 問題:.NET runtime 10.0.0 → 10.0.15(另加 2 項) (REDACTIONPYTHONNET-12)
  • [Fix] 在 Linux 與 macOS 上,光柵化 PDF 輸出與影像區域遮蔽會拋出 PlatformNotSupportedException (REDACTIONPYTHONNET-35)
  • [Fix] 當文字包含制表符時,遮蔽回呼會因 JSONDecodeError 失敗 (REDACTIONPYTHONNET-36)
  • [Fix] RedactorSettings 在僅傳入遮蔽回呼作為唯一參數時拋出 TypeError (REDACTIONPYTHONNET-37)
  • [Fix] 在 Linux 與 macOS 上安裝 Wheels 時,嵌入的 .NET runtime 無法執行 (REDACTIONPYTHONNET-38)

公開 API 變更

升級者需要從 groupdocs.redaction.options.drawing 匯入顏色與幾何類型,並將遮蔽回呼的 redaction_type 與 action_type 與列舉成員進行比較。其他皆為新增項目。

新增類別與成員

  • groupdocs.redaction: CancellationToken, CancellationTokenSource, OperationCanceledError, LicenseError, LicenseWarning, GroupDocsRedactionException.
  • groupdocs.redaction.options: WordProcessingComplianceLevel, WordprocessingSaveOptions.
  • groupdocs.redaction.options.drawing: Color, Font, FontStyle, Point, Rectangle, Size.
  • FileType: DJVU, LOG, OTP, POTM, POTX, PPS, PPSM, PPSX, PPTM, TAB, WEBP, XLT, XLTM, XLTX.
  • License: is_licensed.
  • LoadOptions: file_type.
  • SaveOptions: wordprocessing_save_options.

groupdocs.redaction.options.drawing 是新模組。GroupDocsRedactionException 仍然由 groupdocs.redaction.exceptions 匯出。

已移除

groupdocs.pydrawing 所重新匯出的顏色已被移除;請改從 groupdocs.redaction.options.drawing 匯入 Color:

  • groupdocs.redaction.Color
  • groupdocs.redaction.redactions.Color

已變更

  • 所有接受或返回顏色、點、尺寸或矩形的成員皆使用 groupdocs.redaction.options.drawing 類型。groupdocs.pydrawing 的值會拋出 TypeError(無匹配的重載)。
  • RedactionDescription.redaction_type 與 action_type(遮蔽回呼會讀取)為 RedactionType 與 RedactionActionType 成員。
  • 引擎的過時別名仍然存在:ReplacementOptions.box_fill_color、RegionReplacementOptions.area_fill_color 與 area_size、ImageAreaRedaction.top_left_position、PageAreaFilter.area_rectangle 與 TextFragment.bounding_rectangle。請使用 box_color、fill_color、size、top_left 與 rectangle。

新功能

頁面預覽

Redactor.generate_preview() 會將文件頁面渲染為影像。PreviewOptions 接受一個函式,為每頁返回一個串流、開啟的二進位檔案或 io.BytesIO,並可選擇第二個函式以釋放每頁的串流。設定 width、height 與 page_numbers。26.6.0 會因 TypeError 拒絕此 Python 函式。

Python 日誌

RedactorSettings(logger=...) 接受一個具備 error(message)、warning(message) 與 trace(message) 方法的物件,並由引擎透過它回報。26.6.0 會因 TypeError 拒絕此 Python 日誌。

Python OCR 連接器

GroupDocs.Redaction 不隨附 OCR 引擎。RedactorSettings(ocr_connector=...) 接受一個具備 recognize(image_stream) 方法的物件,該方法返回 OCR 引擎偵測到的結果:包含 TextLine 的 RecognizedImage,每個 TextLine 包含 TextFragment,其文字與矩形。引擎會在影像中尋找相應片語並覆蓋。將每行文字報告為一個 TextFragment。26.6.0 會因 TypeError 拒絕此 Python 連接器。

已儲存 Word 文件的 OOXML 合規等級

SaveOptions.wordprocessing_save_options.ooxml_compliance 設定已儲存 Word 文件的 OOXML 合規等級:WordProcessingComplianceLevel.ECMA、TRANSITIONAL 或 STRICT。若未設定,文件將保留原有等級。26.6.0 並未提供此功能。

以指定檔案類型開啟文件

LoadOptions(file_type) 會將串流或檔名未指示格式的檔案,以指定的 FileType 開啟。26.6.0 並未提供此功能。

檢查授權是否已套用

一旦授權已套用(使用 License().set_license() 或透過 GROUPDOCS_LIC_PATH 環境變數),License().is_licensed 會返回 True。

程式碼範例

import io
from groupdocs.redaction import Redactor
from groupdocs.redaction.options import PreviewOptions, PreviewFormats

pages = {}

def create_page_stream(page_number):
    pages[page_number] = io.BytesIO()
    return pages[page_number]

with Redactor("document.pdf") as redactor:
    options = PreviewOptions(create_page_stream)
    options.width, options.height = 300, 400
    options.page_numbers = [1]
    options.preview_format = PreviewFormats.PNG
    redactor.generate_preview(options)

print(len(pages[1].getvalue()), "bytes of PNG")

如何取得更新

PyPI

透過 PyPI 升級:

安裝指令:

pip install groupdocs-redaction-net==26.11.0

直接下載

從以下位置下載適用於您平台的 wheel:

資源