我們很高興宣布 GroupDocs.Metadata for Python v26.5 已於 2026 年 5 月 發佈。此版本引入了 Python 3.14 支援，提供內嵌 .NET 執行環境的自包含 wheel，支援 Windows、Linux 與 macOS（Intel 與 Apple Silicon），並提供具備明確 .pyi 存根的現代型別化 Python API——消除執行時代理。它同時包含 AGENTS.md，以實現無縫的 AI 代理與 LLM 整合。

此版本的新功能

  • [Enhancement] 重新構建 Python 綁定——提供型別化、每個重載的 API，並捆綁 *.pyi 存根（無執行時 __getattr__ 代理） (METADATAPYTHON-33)
  • [Feature] 支援 Python 3.14（Requires-Python 現在為 >=3.5,<3.15） (METADATAPYTHON-34)
  • [Feature] 在套件內提供 AGENTS.md，以支援 AI 代理 / LLM 整合 (METADATAPYTHON-35)
  • [Enhancement] 更新至 GroupDocs.Metadata for .NET 26.5 引擎 (METADATAPYTHON-36)
  • [Enhancement] 提供內嵌 .NET 執行環境的自包含 wheel，支援 Windows、Linux 與 macOS（Intel 與 Apple Silicon） (METADATAPYTHON-37)

公共 API 變更

  • 每個類別、方法重載與列舉現在皆以型別提示與 *.pyi 存根明確產生。
  • 屬性搜尋使用純 Python 斷言——不再需要 Specification 物件。
  • 現有方法簽名沒有破壞性變更；API 對於從先前版本升級的使用者仍保持源碼相容。

新功能

  • 現代型別化的 Python API：透過 .pyi 存根提供精確的自動完成與靜態分析。範例用法：

    from groupdocs.metadata import Metadata

with Metadata("input.docx") as metadata:
    for prop in metadata.find_properties(lambda p: True):
        print(f"{prop.name} = {prop.value}")

  • 支援 Python 3.14：完整支援 Python 3.5 至 3.14（Requires-Python: >=3.5,<3.15），僅提供單一通用 wheel（py3-none-{platform}）。

  • AGENTS.md 整合：AI 助手（例如 Claude Code、Cursor、GitHub Copilot）現在可以透過已安裝 wheel 中的 groupdocs/metadata/AGENTS.md 自動發現 API 介面、匯入路徑與使用模式。

程式碼範例

使用斷言編輯 metadata——不需要 Specification 物件：

from datetime import datetime
from groupdocs.metadata import Metadata
from groupdocs.metadata.common import PropertyValue
from groupdocs.metadata.tagging import Tags

with Metadata("input.docx") as metadata:
    metadata.set_properties(
        lambda p: Tags.time.created in list(p.tags),
        PropertyValue(datetime.now()),
    )
    metadata.save("output.docx")

# Strip all detected properties in one call
with Metadata("input.pdf") as metadata:
    removed = metadata.sanitize()
    metadata.save("clean.pdf")

如何取得更新

PyPI

使用 pip 安裝或升級：

pip install --upgrade groupdocs-metadata-net

PyPI 上的套件名稱為 groupdocs-metadata-net。wheel 可用於 Windows、Linux 與 macOS。

直接下載

從 GroupDocs.Metadata for Python via .NET 26.5 頁面下載最新發佈版本。

資源