通过 Connect 选择符合性模式

边界。 设置符合性模式会接好目标标准所期望的目录和元数据接线。它会让引擎产出 旨在符合 该标准的输出。它并不使该文档变得「符合」——符合性由验证器（例如 veraPDF）决定。请将本页上的每一处「符合性」陈述理解为「旨在符合；由验证器决定结果」。

一览

每个文档只携带一个符合性判别符：纯文档、标记/PDF-UA 模式，或 PDF/A 模式。该判别符决定写入器要输出哪些目录、结构和元数据接线。本指南通过 Connect 传输层设置该判别符。标记模式设置器属于核心功能。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）。标记模式会接好结构树和 mark-info 目录条目（ISO 32000-2 §14.7）。

因此，切换模式本质上是一次接线操作。它会让文档做好准备，以便依据标准进行检查。它本身并非符合性结果。

API 接口面

工具名称会通过 tools/list 依据运行中的注册表进行核验。权威目录为 /connect/tool-catalog/. 本指南不再重述工具数量。请在首次内容调用之前选择判别符。写入器会在首次页面输出时冻结该模式。

代码示例 — 快速上手

创建一个文档，然后将其切换到标记/PDF-UA 模式：

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

响应会报告写入器在每个输出点都会参考的活动模式谓词（标记 / 无障碍 / 归档）。它还会报告已添加的目录接线。这些谓词报告的是写入器将要输出的内容；它们并不断言结果符合标准。

代码示例 — 生产环境

切换到 PDF/A-4（Premium 层级），然后执行检查。将非成功状态视为需要检查的正常结果：

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

如果两个设置器都被调用，判别符会收敛为「后者获胜」，并发出覆盖警告。请针对每一个仍有功能栈处于接线状态的风味运行标准检查，因为接线会叠加，而单一判别符不会叠加。

边界情况与注意事项

在首页之后设置模式会因模式冻结错误而被拒绝。请在创建文档后立即设置模式。
无 Premium 时调用 PDF/A 设置器会失败——它永久属于 Premium 层级（ADR-011）。纯 PDF 2.0 文档不需要 PDF/A 模式。
未知的枚举情形会被拒绝。受支持的归档情形是 PDF/A-4（旧版 PDF/A 配置文件已停用）。
归档模式所禁止的操作（例如嵌入式 JavaScript）会在归档谓词处于活动状态时被拒绝。
检查时风味/模式不匹配会返回一项带有不符合性标记的发现。请传入与活动模式匹配的风味，或在两套栈都已接线时同时传入两者。

性能

前置元数据中的预算是文档层面的上限。模式接线不会增加任何可测量的独立阶段。

安全说明

除一般性的 Connect 传输层指引外，无其他事项。

符合性

声明	条款	reference_id
符合性标记声明的是旨在符合；结果由验证器决定	PDF/A-4 §6.7.3
符合性依据要求判定，而非由产出方断言	PDF/A-4 §6.7.3
标记模式接好结构树和 mark-info 条目	ISO 32000-2 §14.7

选择符合性模式会让引擎产出旨在符合的输出。它并非符合性认证。结果由验证器决定。

商业背景

PDF/A-4 模式设置器永久属于 Premium 层级（ADR-011），仅当 nextpdf/premium 与服务器一并安装时才会注册。标记模式设置器是一项核心能力。

Connect 特定事项

传输层可用性（MCP / REST / gRPC）

模式设置器和检查都通过共享的工具执行器执行，并在 MCP tools/call、REST 工具端点和 gRPC 服务上以完全相同的方式调用。

HITL 风险层级

模式设置器属于谨慎级别。检查为只读操作。默认情况下没有任何一项是 approval_required。操作员覆盖只能提高风险级别。参见 /connect/hitl-risk-tiers/.

确认门 JSON 信封

这些工具不会触发该门，除非操作员覆盖将其中之一提升为 approval_required。信封和一次性令牌契约见 /connect/hitl-risk-tiers/.

另请参阅

/cookbook/connect/compliance-check/ — 依据活动标准进行验证。
/cookbook/connect/tagged-pdf-tutorial/ — 端到端的标记 PDF 演练。
/connect/tool-catalog/ — 按层级的工具集计算。
/connect/hitl-risk-tiers/ — 风险模型和门控。