透過 Connect 選擇一致性模式

界線。 設定一致性模式會接上對應標準要求的 catalog 與中繼資料連接。它讓引擎產出 意在符合該標準的輸出，但它並不會讓文件變成「合規」——一致性由驗證器（例如 veraPDF）裁定。請將本頁每一句「一致性」的陳述讀作「意在符合；由驗證器決定結果」。

概覽

一份文件只會帶有一個一致性辨別子：純文件、tagged/PDF-UA 模式或 PDF/A 模式。該辨別子決定 writer 會發出哪一套 catalog、結構與中繼資料連接。本範例會透過 Connect 傳輸層設定該辨別子。tagged 模式設定器屬於核心功能。PDF/A-4 模式設定器永久屬於 Premium 層級（ADR-011），且僅在 nextpdf/premium 與伺服器一併安裝時才會註冊。

同時呼叫兩個設定器會疊加兩套功能堆疊；但單值辨別子仍會收斂為後者覆蓋前者，並發出覆寫警告，讓工具能觀察到這次覆寫。

安裝

composer require nextpdf/server

請以一次 tools/list 呼叫確認 PDF/A 模式設定器存在。參見 /connect/tool-catalog/.

概念總覽

一致性標記宣告的是意在符合；實際的一致性由驗證器決定（PDF/A-4 §6.7.3）。一致性會依標準要求判定，而不是由產製軟體自行宣稱（PDF/A-4 §6.7.3）。tagged 模式會接上結構樹與 mark-info 的 catalog 條目（ISO 32000-2 §14.7）。

因此，切換模式是一項連接操作。它會讓文件準備好接受依標準進行的檢查，但本身並不是一致性結果。

API 介面

工具名稱會透過 tools/list 對執行中的登錄進行驗證。權威目錄為 /connect/tool-catalog/。本範例不會重述工具數量。請在第一次內容呼叫之前選定辨別子。writer 會在第一頁發出時凍結模式。

程式碼範例 — 快速開始

先建立一份文件，再將它切換為 tagged/PDF-UA 模式：

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "enable_tagged_pdf",
    "arguments": { "document_id": "<id>", "language": "en" }
  }
}

回應會回報目前啟用的模式判定條件（tagged/accessibility/archival）；writer 會在每一個發出點查閱這些條件。它也會回報自身加入的 catalog 連接。這些判定條件回報的是 writer 將會發出的內容；並不主張結果符合標準。

程式碼範例 — 生產環境

切換為 PDF/A-4（Premium 層級），然後進行檢查。請將非成功狀態視為需要檢視的正常結果：

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "enable_pdf_a",
    "arguments": { "document_id": "<id>", "version": "PdfA4" }
  }
}

若兩個設定器都被呼叫，辨別子會收斂為後者覆蓋前者，並發出覆寫警告。請對功能堆疊仍保持連接的每一個 flavour 執行標準檢查，因為單一辨別子雖然不會累加，連接本身卻會累加。

邊界情況與陷阱

在第一頁之後設定模式會被拒絕，並回報模式已凍結的錯誤。請在建立文件後立即設定模式。
未安裝 Premium 時呼叫 PDF/A 設定器會失敗——它永久屬於 Premium 層級（ADR-011）。純 PDF 2.0 文件不需要 PDF/A 模式。
未知的列舉項目會被拒絕。支援的歸檔項目是 PDF/A-4（舊版 PDF/A 設定檔已停用）。
歸檔模式所禁止的操作（例如內嵌 JavaScript）在歸檔判定條件啟用時會被拒絕。
檢查時 flavour 與模式不相符會傳回標記不合規的查核結果。請傳入與目前啟用模式相符的 flavour；若兩套堆疊都已連接，則兩者皆傳入。

效能

front-matter 中的預算是一個文件層級的上限。模式連接不會額外增加任何可量測的獨立階段。

安全性備註

除一般的 Connect 傳輸層指引外，並無其他適用事項。

一致性

主張	條款	reference_id
一致性標記宣告的是意在符合；由驗證器裁定	PDF/A-4 §6.7.3
一致性依標準要求判定，而非由產製方自行宣稱	PDF/A-4 §6.7.3
tagged 模式會接上結構樹與 mark-info 條目	ISO 32000-2 §14.7

選擇一致性模式會讓引擎產出意在符合的輸出。這並不是一致性認證；結果由驗證器決定。

商業脈絡

PDF/A-4 模式設定器永久屬於 Premium 層級（ADR-011），且僅在 nextpdf/premium 與伺服器一併安裝時才會註冊。tagged 模式設定器屬於核心功能。

Connect 專屬事項

傳輸層支援情況（MCP / REST / gRPC）

模式設定器與檢查無論在 MCP tools/call、REST 工具端點，或透過共用工具執行器的 gRPC 服務上，呼叫方式都完全相同。

HITL 風險層級

模式設定器屬於 caution 等級。檢查為唯讀。預設情況下沒有任何一項為 approval_required。操作者覆寫只能提高風險。參見 /connect/hitl-risk-tiers/.

確認關卡 JSON 封套

除非操作者覆寫將某項提升為 approval_required，否則這些工具並不會觸發該關卡。封套與一次性 token 契約記載於 /connect/hitl-risk-tiers/.

另請參閱

/cookbook/connect/compliance-check/ — 依目前啟用的標準進行驗證。
/cookbook/connect/tagged-pdf-tutorial/ — 端對端 tagged-PDF 完整教學。
/connect/tool-catalog/ — 各層級工具集的計算方式。
/connect/hitl-risk-tiers/ — 風險模型與關卡。