使用 NextPDF Connect（Pro）检查结构无障碍

概览

在 NextPDF Connect 中执行结构无障碍分析。此工具为 check_accessibility，已通过 Pro 工具提供者重新验证；该提供者会以协议名称 check_accessibility 注册 new CheckAccessibilityTool()。此工具自身的描述界定了其范围：它分析 PDF 的结构无障碍——标题、表格、图片，以及阅读顺序指标。它会呈现指标与补救提示。它并不会认证 PDF/UA 或 WCAG 符合性。该判定来自符合性检查器——例如 veraPDF 或 PDF/UA 测试工具——而非来自此工具。check_accessibility 是 Pro 层级的工具。 NextPDF 会在启动时以 class_exists() 探测它，且仅在已安装 Pro 软件包时才注册。

安装

composer require nextpdf/server
composer require nextpdf/pro

绑定一个传输。通过 diagnostic.capabilities 确认此工具可用。

概念总览

无障碍结构建立在两项基础上：由结构元素组成的逻辑结构树（ISO 32000-2 §14.7），以及已声明的文件语言，并通过目录的 Lang 条目设置（ISO 32000-2 §14.9；PDF/UA-2 §8.4.4）。check_accessibility 会检查这些结构指标，并返回一份发现项报告，每项都附带严重程度与补救指引。报告中的任何数值分数或 pass/fail 都是指标摘要，而非认证——请将其作为分诊信号来解读。

API 接口

工具	层级	角色	风险层级
`create_pdf`, `add_text`	Core	创建要检查的内容	Safe / Caution
`check_accessibility`	Pro	结构无障碍分析	Safe
`output_pdf`	Core	渲染并返回该 PDF	Approval Required / Review（base64）

工具名称就是注册表中的协议名称。工具目录是正式记载的目录。哪些工具可用取决于已安装的层级。

代码示例——快速开始

create_pdf → 使用 add_text 添加内容。
使用该 document_id 执行 check_accessibility。
阅读各项发现：严重程度、指标、受影响的页面，以及补救提示。
可选地执行 output_pdf（base64），以便连同报告一起进行人工审查。

代码示例——生产环境

请将报告视为分诊的输入依据，而非最终裁定。请将每项发现映射到具体补救措施：启用标记化输出、设置文件语言、添加标题结构。如果要用作符合性把关，请运行外部检查器，并以其裁定——而非此工具的分数——为准。请在带有 destroy: true 的 output_pdf 之前执行检查，否则此工具将看不到该文件。

边界案例与陷阱

没有内容。 空白文档会产生一项「无内容」发现，而非认证。
大型文件。 分析受超时限制；请切分大型输入或限定范围。
已销毁的会话。 请在输出并销毁会话之前执行检查。
已加密的来源。 请提供密码。
缺少 Pro。 如果仅安装 Core，check_accessibility 不会被注册。

性能

预算中的超时设置会限制分析范围。配置为 semantic：报告是结构分析的输出，因此合理比较应针对各项发现，而非字节输出。

安全性说明

报告描述的是结构，而非内容机密。被分析的文件仍可能属于敏感内容，因此请将其保留在你的信任边界内。分析路径不会向文件系统写入任何内容。

符合性

陈述	规格	条款
逻辑结构是由结构元素组成的树。	ISO 32000-2	§14.7
文件语言通过 `Lang` 条目声明。	ISO 32000-2	§14.9
无障碍编写必须指定自然语言。	PDF/UA-2	§8.4.4

check_accessibility 会报告支持无障碍编写的结构指标。它并不主张 PDF/UA 或 WCAG 符合性——那由独立的检查器来判定。

商业场景

check_accessibility 是 Pro 层级的工具，仅在服务器启动时成功解析 Pro 软件包后才会注册。

PDF/UA-2 映射

此工具检查的结构指标与 PDF/UA-2 的编写需求一致：一棵标记化的结构树（ISO 32000-2 §14.7），以及已声明的文件语言（PDF/UA-2 §8.4.4）。此工具会报告这些指标是否存在或缺失。PDF/UA-2 符合性由 PDF/UA 检查器判定，而非由此工具的报告判定。

标签 → ISO 32000-2 §14 交叉引用

标题与表格的发现映射到 ISO 32000-2 §14.7 结构树中的逻辑结构元素。语言的发现映射到 §14.9 的 Lang 条目。此工具会展示这些结构锚点是否存在。它并不会验证每一条 §14 标签规则——那是检查器的工作。

WCAG 2.2 映射

关于对比与阅读顺序的发现，与对比和有意义的顺序等 WCAG 成功准则相关。此工具会报告指标值，例如测量到的对比度。如要主张 WCAG 符合性，需要完整的 WCAG 评估；此工具既不会执行，也不会主张这一点。

传输可用性

传输	可用	备注
MCP (stdio)	是（Pro）	报告即一条工具结果。
REST	是（Pro）	报告即响应主体。
gRPC	是（Pro）	一元调用；报告位于响应消息中。

HITL 风险层级

check_accessibility 属于 Safe（只读分析），且绝不会把关。将 output_pdf 输出到文件属于 Approval Required，base64 模式属于 Review（HITL 风险层级）。

确认把关 JSON 封套

此分析绝不会把关：

{ "allowed": true }