我们很高兴宣布 GroupDocs.Redaction for Python v26.11 已于 2026年11月 发布。此版本将 GroupDocs.Redaction 引擎从 26.5 升级至 26.10,并嵌入 .NET 运行时 10.0.15,使用 Aspose.Drawing 和 SkiaSharp 替代 System.Drawing,实现跨平台光栅化和图像区域脱敏——包括 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 运行时 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 运行时版本无法运行 (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 中的颜色在 26.6 中被重新导出;请改为从 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 中,该 Python 函数会因 TypeError 被拒绝。

Python 日志记录器

RedactorSettings(logger=...) 接受一个具有 error(message)、warning(message) 和 trace(message) 方法的对象,引擎通过它进行报告。26.6.0 中该 Python 日志记录器会因 TypeError 被拒绝。

Python OCR 连接器

GroupDocs.Redaction 不附带 OCR 引擎。RedactorSettings(ocr_connector=...) 接受一个具有 recognize(image_stream) 方法的对象,该方法返回 OCR 引擎识别的内容:包含 TextLine 的 RecognizedImage,每个 TextLine 包含 TextFragment,并带有文本和矩形。引擎随后在图像中查找这些短语并进行遮盖。将每行文本报告为一个 TextFragment。在 26.6.0 中,该 Python 连接器会因 TypeError 被拒绝。

已保存 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:

资源